@tpsdev-ai/agent 0.5.4 → 0.6.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/bin.js +47 -2
- package/dist/bin.js.map +1 -1
- package/dist/config.d.ts +2 -1
- package/dist/config.d.ts.map +1 -1
- package/dist/config.js +8 -0
- package/dist/config.js.map +1 -1
- package/dist/index.d.ts +4 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +4 -0
- package/dist/index.js.map +1 -1
- package/dist/io/flair.d.ts +43 -0
- package/dist/io/flair.d.ts.map +1 -0
- package/dist/io/flair.js +143 -0
- package/dist/io/flair.js.map +1 -0
- package/dist/io/mail.d.ts +24 -2
- package/dist/io/mail.d.ts.map +1 -1
- package/dist/io/mail.js +168 -15
- package/dist/io/mail.js.map +1 -1
- package/dist/lib/signEnvelope.d.ts +67 -0
- package/dist/lib/signEnvelope.d.ts.map +1 -0
- package/dist/lib/signEnvelope.js +244 -0
- package/dist/lib/signEnvelope.js.map +1 -0
- package/dist/llm/provider.d.ts +19 -1
- package/dist/llm/provider.d.ts.map +1 -1
- package/dist/llm/provider.js +362 -18
- package/dist/llm/provider.js.map +1 -1
- package/dist/runtime/agent.d.ts +2 -0
- package/dist/runtime/agent.d.ts.map +1 -1
- package/dist/runtime/agent.js +50 -3
- package/dist/runtime/agent.js.map +1 -1
- package/dist/runtime/event-loop.d.ts +36 -5
- package/dist/runtime/event-loop.d.ts.map +1 -1
- package/dist/runtime/event-loop.js +235 -32
- package/dist/runtime/event-loop.js.map +1 -1
- package/dist/runtime/types.d.ts +16 -1
- package/dist/runtime/types.d.ts.map +1 -1
- package/dist/telemetry/events.d.ts +57 -0
- package/dist/telemetry/events.d.ts.map +1 -0
- package/dist/telemetry/events.js +37 -0
- package/dist/telemetry/events.js.map +1 -0
- package/dist/tools/edit.d.ts.map +1 -1
- package/dist/tools/edit.js +94 -16
- package/dist/tools/edit.js.map +1 -1
- package/package.json +10 -2
- package/src/bin.ts +56 -3
- package/src/config.ts +10 -1
- package/src/index.ts +8 -0
- package/src/io/flair.ts +183 -0
- package/src/io/mail.ts +184 -19
- package/src/lib/signEnvelope.ts +332 -0
- package/src/llm/provider.ts +391 -17
- package/src/runtime/agent.ts +55 -3
- package/src/runtime/event-loop.ts +233 -15
- package/src/runtime/types.ts +20 -1
- package/src/telemetry/events.ts +101 -0
- package/src/tools/edit.ts +108 -17
- package/test/bin-launch-id.test.ts +104 -0
- package/test/core-loop.test.ts +240 -0
- package/test/events.test.ts +33 -0
- package/test/flair-context.test.ts +102 -0
- package/test/governance.test.ts +103 -2
- package/test/io.test.ts +8 -8
- package/test/provider.test.ts +43 -0
package/dist/bin.js
CHANGED
|
@@ -1,11 +1,16 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
2
|
import { AgentRuntime } from "./runtime/agent.js";
|
|
3
3
|
import { loadAgentConfig } from "./config.js";
|
|
4
|
+
/** cli#352 r — the launch-id charset/traversal rule, same shape as cli#351 r5's. */
|
|
5
|
+
const LAUNCH_ID_RE = /^[a-zA-Z0-9._-]{1,64}$/;
|
|
4
6
|
function usage() {
|
|
5
7
|
console.error("Usage:");
|
|
6
8
|
console.error(" tps-agent run --config <agent.yaml> --message <text>");
|
|
7
9
|
console.error(" tps-agent start --config <agent.yaml>");
|
|
8
10
|
console.error(" tps-agent health --config <agent.yaml>");
|
|
11
|
+
console.error(" tps-agent check --id <roster-id> --config <agent.yaml>");
|
|
12
|
+
console.error("Options:");
|
|
13
|
+
console.error(" --id <roster-id> launch id from the supervisor's roster entry (cli#352 r)");
|
|
9
14
|
process.exit(1);
|
|
10
15
|
}
|
|
11
16
|
function parseArg(name, args) {
|
|
@@ -17,16 +22,56 @@ function parseArg(name, args) {
|
|
|
17
22
|
function parseConfig(args) {
|
|
18
23
|
const command = args[0];
|
|
19
24
|
const configPath = parseArg("--config", args);
|
|
20
|
-
|
|
25
|
+
const launchId = parseArg("--id", args);
|
|
26
|
+
return { command, configPath, launchId };
|
|
27
|
+
}
|
|
28
|
+
/**
|
|
29
|
+
* cli#352 r — the supervisor's launch path (`nono run … -- tps-agent start`)
|
|
30
|
+
* bypassed the validated-id rule cli#351 r5 put on the CLI path: the agent's
|
|
31
|
+
* writable config could name ANY id, and the runtime would derive its identity
|
|
32
|
+
* key from it. The launch id must come from the supervisor's own roster entry.
|
|
33
|
+
* Mirrors tps agent start's rule exactly: charset + no traversal, and the
|
|
34
|
+
* config must agree (a config that disagrees is tampered or misbuilt).
|
|
35
|
+
*/
|
|
36
|
+
function validateLaunchId(id, source) {
|
|
37
|
+
if (!LAUNCH_ID_RE.test(id) || id.includes("..")) {
|
|
38
|
+
console.error(`Invalid agent id (${source}): ${id} — must match ^[a-zA-Z0-9._-]{1,64}$ and contain no traversal`);
|
|
39
|
+
process.exit(1);
|
|
40
|
+
}
|
|
41
|
+
}
|
|
42
|
+
function assertConfigAgrees(launchId, configAgentId) {
|
|
43
|
+
if (configAgentId !== launchId) {
|
|
44
|
+
console.error(`❌ agent.yaml agentId '${configAgentId}' does not match the launch id '${launchId}' — refusing to launch (cli#352 r)`);
|
|
45
|
+
process.exit(1);
|
|
46
|
+
}
|
|
21
47
|
}
|
|
22
48
|
async function main() {
|
|
23
49
|
const args = process.argv.slice(2);
|
|
24
|
-
const { command, configPath } = parseConfig(args);
|
|
50
|
+
const { command, configPath, launchId } = parseConfig(args);
|
|
25
51
|
if (!command || command === "--help" || command === "-h")
|
|
26
52
|
usage();
|
|
27
53
|
if (!configPath)
|
|
28
54
|
usage();
|
|
55
|
+
if (command === "check" && !launchId)
|
|
56
|
+
usage();
|
|
57
|
+
if (launchId !== undefined)
|
|
58
|
+
validateLaunchId(launchId, "--id");
|
|
29
59
|
const config = loadAgentConfig(configPath);
|
|
60
|
+
// cli#352 r — `check` is the supervisor's pre-flight: refuse BEFORE anything
|
|
61
|
+
// is launched, so a refusal cannot leave a partial team running. It is the
|
|
62
|
+
// same rule the launch itself applies below, so the two cannot disagree.
|
|
63
|
+
if (command === "check") {
|
|
64
|
+
if (!launchId)
|
|
65
|
+
usage();
|
|
66
|
+
assertConfigAgrees(launchId, config.agentId);
|
|
67
|
+
return;
|
|
68
|
+
}
|
|
69
|
+
if (launchId !== undefined) {
|
|
70
|
+
// The runtime derives its identity key from config.agentId; agreeing with
|
|
71
|
+
// the roster id is what makes that derivation safe (cli#352 r).
|
|
72
|
+
assertConfigAgrees(launchId, config.agentId);
|
|
73
|
+
config.agentId = launchId;
|
|
74
|
+
}
|
|
30
75
|
const runtime = new AgentRuntime(config);
|
|
31
76
|
switch (command) {
|
|
32
77
|
case "run": {
|
package/dist/bin.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"bin.js","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C,SAAS,KAAK;IACZ,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACxB,OAAO,CAAC,KAAK,CAAC,wDAAwD,CAAC,CAAC;IACxE,OAAO,CAAC,KAAK,CAAC,yCAAyC,CAAC,CAAC;IACzD,OAAO,CAAC,KAAK,CAAC,0CAA0C,CAAC,CAAC;IAC1D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,SAAS,QAAQ,CAAC,IAAY,EAAE,IAAc;IAC5C,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,IAAI,GAAG,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;IAC5D,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,WAAW,CAAC,IAAc;IACjC,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACxB,MAAM,UAAU,GAAG,QAAQ,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;IAC9C,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC;
|
|
1
|
+
{"version":3,"file":"bin.js","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":"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"}
|
package/dist/config.d.ts
CHANGED
|
@@ -7,8 +7,9 @@ export interface AgentRuntimeConfig {
|
|
|
7
7
|
workspace: string;
|
|
8
8
|
systemPrompt?: string;
|
|
9
9
|
llm: {
|
|
10
|
-
provider: "anthropic" | "google" | "openai" | "ollama";
|
|
10
|
+
provider: "anthropic" | "claude-oauth" | "google" | "openai" | "ollama";
|
|
11
11
|
model: string;
|
|
12
|
+
auth?: "oauth" | "api-key";
|
|
12
13
|
apiKey?: string;
|
|
13
14
|
baseUrl?: string;
|
|
14
15
|
};
|
package/dist/config.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,GAAG,EAAE;QACH,QAAQ,EAAE,WAAW,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;
|
|
1
|
+
{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,GAAG,EAAE;QACH,QAAQ,EAAE,WAAW,GAAG,cAAc,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;QACxE,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;QAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC,CAAC;IAC3D,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAgCD,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAoCzD;AAED,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAG3D;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,kBAAkB,CAKxE"}
|
package/dist/config.js
CHANGED
|
@@ -43,11 +43,19 @@ export function loadAgentConfig(path) {
|
|
|
43
43
|
maxTokens: parsed.maxTokens ? Number(parsed.maxTokens) : 1024,
|
|
44
44
|
tools: parsed.tools ?? ["read", "write", "edit", "exec", "mail"],
|
|
45
45
|
execAllowlist: parsed.execAllowlist,
|
|
46
|
+
flair: parsed.flair ? {
|
|
47
|
+
url: parsed.flair.url ? String(parsed.flair.url) : undefined,
|
|
48
|
+
keyPath: parsed.flair.keyPath ? String(parsed.flair.keyPath) : undefined,
|
|
49
|
+
} : undefined,
|
|
50
|
+
role: parsed.role ? String(parsed.role) : undefined,
|
|
51
|
+
roleConfig: parsed.roleConfig ? parsed.roleConfig : undefined,
|
|
46
52
|
llm: {
|
|
47
53
|
provider: parsed.llm?.provider || parsed.provider || "openai",
|
|
48
54
|
model: parsed.llm?.model || parsed.model || "gpt-4o-mini",
|
|
55
|
+
auth: parsed.llm?.auth || parsed.auth || "api-key",
|
|
49
56
|
apiKey: parsed.llm?.apiKey || parsed.apiKey,
|
|
50
57
|
baseUrl: parsed.llm?.baseUrl || parsed.baseUrl,
|
|
58
|
+
proxyUrl: parsed.llm?.proxyUrl || parsed.llm?.baseUrl || parsed.baseUrl,
|
|
51
59
|
},
|
|
52
60
|
};
|
|
53
61
|
return agent;
|
package/dist/config.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,IAAI,MAAM,SAAS,CAAC;AAC3B,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;
|
|
1
|
+
{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,IAAI,MAAM,SAAS,CAAC;AAC3B,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAuBzC,SAAS,sBAAsB,CAAC,GAAW;IACzC,OAAO,GAAG,CAAC,OAAO,CAAC,qBAAqB,EAAE,CAAC,MAAM,EAAE,OAAe,EAAE,EAAE;QACpE,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACtC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CAAC,iCAAiC,OAAO,EAAE,CAAC,CAAC;QAC9D,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,kBAAkB,CAAI,KAAQ;IACrC,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,sBAAsB,CAAC,KAAK,CAAM,CAAC;IAC5C,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAM,CAAC;IAC5D,CAAC;IAED,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACvC,MAAM,GAAG,GAA4B,EAAE,CAAC;QACxC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAgC,CAAC,EAAE,CAAC;YACtE,GAAG,CAAC,CAAC,CAAC,GAAG,kBAAkB,CAAC,CAAC,CAAC,CAAC;QACjC,CAAC;QACD,OAAO,GAAQ,CAAC;IAClB,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACxC,MAAM,SAAS,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAwB,CAAC;IAChE,MAAM,MAAM,GAAG,kBAAkB,CAAC,SAAS,CAAC,CAAC;IAE7C,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,SAAS,IAAI,MAAM,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IAC3E,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,IAAI,GAAG,SAAS,+BAA+B,CAAC;IAEpF,MAAM,KAAK,GAAgB;QACzB,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,EAAE,IAAI,OAAO,CAAC;QACvD,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,OAAO,IAAI,OAAO,CAAC;QACtD,SAAS;QACT,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,IAAI,GAAG,SAAS,OAAO,CAAC;QACtD,UAAU,EAAE,MAAM,CAAC,UAAU,CAAC;QAC9B,YAAY,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,SAAS;QAC3E,mBAAmB,EAAE,MAAM,CAAC,mBAAmB,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,IAAI;QAC3F,SAAS,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI;QAC7D,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;QAChE,aAAa,EAAE,MAAM,CAAC,aAAa;QACnC,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YACpB,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS;YAC5D,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS;SACzE,CAAC,CAAC,CAAC,SAAS;QACb,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAQ,CAAC,CAAC,CAAC,SAAS;QAC1D,UAAU,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,UAAqC,CAAC,CAAC,CAAC,SAAS;QACxF,GAAG,EAAE;YACH,QAAQ,EAAE,MAAM,CAAC,GAAG,EAAE,QAAQ,IAAI,MAAM,CAAC,QAAQ,IAAI,QAAQ;YAC7D,KAAK,EAAE,MAAM,CAAC,GAAG,EAAE,KAAK,IAAI,MAAM,CAAC,KAAK,IAAI,aAAa;YACzD,IAAI,EAAE,MAAM,CAAC,GAAG,EAAE,IAAI,IAAI,MAAM,CAAC,IAAI,IAAI,SAAS;YAClD,MAAM,EAAE,MAAM,CAAC,GAAG,EAAE,MAAM,IAAI,MAAM,CAAC,MAAM;YAC3C,OAAO,EAAE,MAAM,CAAC,GAAG,EAAE,OAAO,IAAI,MAAM,CAAC,OAAO;YAC9C,QAAQ,EAAE,MAAM,CAAC,GAAG,EAAE,QAAQ,IAAI,MAAM,CAAC,GAAG,EAAE,OAAO,IAAI,MAAM,CAAC,OAAO;SACxE;KACF,CAAC;IAEF,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,SAAiB;IACjD,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC9E,OAAO,GAAG,SAAS,qBAAqB,MAAM,QAAQ,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,KAAc;IAClD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,EAAE,CAAC;QACxC,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;IAC1C,CAAC;IACD,OAAO,KAA2B,CAAC;AACrC,CAAC"}
|
package/dist/index.d.ts
CHANGED
|
@@ -13,4 +13,8 @@ export { createDefaultToolset } from "./tools/index.js";
|
|
|
13
13
|
export { BoundaryManager } from "./governance/boundary.js";
|
|
14
14
|
export { ReviewGate } from "./governance/review-gate.js";
|
|
15
15
|
export { loadAgentConfig } from "./config.js";
|
|
16
|
+
export { FlairContextProvider } from "./io/flair.js";
|
|
17
|
+
export type { FlairConfig } from "./runtime/types.js";
|
|
18
|
+
export { signEnvelope, verifyEnvelope } from "./lib/signEnvelope.js";
|
|
19
|
+
export type { Envelope, ChainEntry, FlairClient, VerifyOk, VerifyReject } from "./lib/signEnvelope.js";
|
|
16
20
|
//# sourceMappingURL=index.d.ts.map
|
package/dist/index.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,YAAY,EACV,WAAW,EACX,SAAS,EACT,UAAU,EACV,iBAAiB,EACjB,kBAAkB,EAClB,QAAQ,EACR,QAAQ,EACR,UAAU,EACV,UAAU,GACX,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,YAAY,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,YAAY,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAGjD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGpD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,YAAY,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAGxD,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAGzD,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC"}
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,YAAY,EACV,WAAW,EACX,SAAS,EACT,UAAU,EACV,iBAAiB,EACjB,kBAAkB,EAClB,QAAQ,EACR,QAAQ,EACR,UAAU,EACV,UAAU,GACX,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,YAAY,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,YAAY,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAGjD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGpD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,YAAY,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAGxD,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAGzD,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAG9C,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,YAAY,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGtD,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACrE,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,WAAW,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC"}
|
package/dist/index.js
CHANGED
|
@@ -16,4 +16,8 @@ export { BoundaryManager } from "./governance/boundary.js";
|
|
|
16
16
|
export { ReviewGate } from "./governance/review-gate.js";
|
|
17
17
|
// Config
|
|
18
18
|
export { loadAgentConfig } from "./config.js";
|
|
19
|
+
// Flair integration
|
|
20
|
+
export { FlairContextProvider } from "./io/flair.js";
|
|
21
|
+
// Signing
|
|
22
|
+
export { signEnvelope, verifyEnvelope } from "./lib/signEnvelope.js";
|
|
19
23
|
//# sourceMappingURL=index.js.map
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,kCAAkC;AAElC,UAAU;AACV,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAapD,MAAM;AACN,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEjD,MAAM;AACN,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,QAAQ;AACR,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAExD,aAAa;AACb,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAEzD,SAAS;AACT,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC"}
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,kCAAkC;AAElC,UAAU;AACV,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAapD,MAAM;AACN,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEjD,MAAM;AACN,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,QAAQ;AACR,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAExD,aAAa;AACb,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAEzD,SAAS;AACT,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C,oBAAoB;AACpB,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAGrD,UAAU;AACV,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC"}
|
|
@@ -0,0 +1,43 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Flair context provider for the agent package.
|
|
3
|
+
*
|
|
4
|
+
* Provides Flair-backed system prompt bootstrapping and memory writes.
|
|
5
|
+
* Uses the same TPS-Ed25519 signing scheme as the CLI FlairClient.
|
|
6
|
+
*/
|
|
7
|
+
import type { FlairConfig } from "../runtime/types.js";
|
|
8
|
+
export interface FlairAgent {
|
|
9
|
+
id: string;
|
|
10
|
+
name: string;
|
|
11
|
+
publicKey: string;
|
|
12
|
+
}
|
|
13
|
+
export interface FlairMemory {
|
|
14
|
+
id: string;
|
|
15
|
+
agentId: string;
|
|
16
|
+
content: string;
|
|
17
|
+
type?: string;
|
|
18
|
+
score?: number;
|
|
19
|
+
}
|
|
20
|
+
export interface FlairSoulEntry {
|
|
21
|
+
key: string;
|
|
22
|
+
value: string;
|
|
23
|
+
}
|
|
24
|
+
export declare class FlairContextProvider {
|
|
25
|
+
private readonly url;
|
|
26
|
+
private readonly agentId;
|
|
27
|
+
private readonly keyPath;
|
|
28
|
+
constructor(agentId: string, config?: FlairConfig);
|
|
29
|
+
private sign;
|
|
30
|
+
private req;
|
|
31
|
+
ping(): Promise<boolean>;
|
|
32
|
+
getAgent(name: string): Promise<FlairAgent | null>;
|
|
33
|
+
getSoul(): Promise<FlairSoulEntry[]>;
|
|
34
|
+
searchMemories(query: string, limit?: number): Promise<FlairMemory[]>;
|
|
35
|
+
listRecentMemories(days?: number): Promise<FlairMemory[]>;
|
|
36
|
+
writeMemory(id: string, content: string, type?: string): Promise<void>;
|
|
37
|
+
/**
|
|
38
|
+
* Build a system prompt supplement from Flair — soul + recent context.
|
|
39
|
+
* Returns empty string if Flair is offline (graceful degradation).
|
|
40
|
+
*/
|
|
41
|
+
buildContextBlock(query?: string): Promise<string>;
|
|
42
|
+
}
|
|
43
|
+
//# sourceMappingURL=flair.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"flair.d.ts","sourceRoot":"","sources":["../../src/io/flair.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACf;AAED,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,OAAO,EAAE,MAAM,EAAE,MAAM,GAAE,WAAgB;IAUrD,OAAO,CAAC,IAAI;YAoBE,GAAG;IAmBX,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC;IASxB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAQlD,OAAO,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAQpC,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAOhE,kBAAkB,CAAC,IAAI,SAAI,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAOpD,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,SAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBpF;;;OAGG;IACG,iBAAiB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAoCzD"}
|
package/dist/io/flair.js
ADDED
|
@@ -0,0 +1,143 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Flair context provider for the agent package.
|
|
3
|
+
*
|
|
4
|
+
* Provides Flair-backed system prompt bootstrapping and memory writes.
|
|
5
|
+
* Uses the same TPS-Ed25519 signing scheme as the CLI FlairClient.
|
|
6
|
+
*/
|
|
7
|
+
import crypto from "node:crypto";
|
|
8
|
+
import { readFileSync, existsSync } from "node:fs";
|
|
9
|
+
import { homedir } from "node:os";
|
|
10
|
+
import { join } from "node:path";
|
|
11
|
+
export class FlairContextProvider {
|
|
12
|
+
url;
|
|
13
|
+
agentId;
|
|
14
|
+
keyPath;
|
|
15
|
+
constructor(agentId, config = {}) {
|
|
16
|
+
this.url = (config.url ?? process.env.FLAIR_URL ?? "http://127.0.0.1:9926").replace(/\/$/, "");
|
|
17
|
+
this.agentId = agentId;
|
|
18
|
+
this.keyPath =
|
|
19
|
+
config.keyPath ??
|
|
20
|
+
join(homedir(), ".tps", "identity", `${agentId}.key`);
|
|
21
|
+
}
|
|
22
|
+
// ─── Auth ──────────────────────────────────────────────────────────────────
|
|
23
|
+
sign(method, path) {
|
|
24
|
+
const ts = Date.now().toString();
|
|
25
|
+
const nonce = crypto.randomUUID();
|
|
26
|
+
const payload = `${this.agentId}:${ts}:${nonce}:${method}:${path}`;
|
|
27
|
+
if (!existsSync(this.keyPath)) {
|
|
28
|
+
throw new Error(`Flair key not found at ${this.keyPath}. Run: tps agent create --id ${this.agentId}`);
|
|
29
|
+
}
|
|
30
|
+
const raw = readFileSync(this.keyPath, "utf-8").trim();
|
|
31
|
+
let key;
|
|
32
|
+
if (raw.startsWith("-----")) {
|
|
33
|
+
key = crypto.createPrivateKey(raw);
|
|
34
|
+
}
|
|
35
|
+
else {
|
|
36
|
+
key = crypto.createPrivateKey({ key: Buffer.from(raw, "base64"), format: "der", type: "pkcs8" });
|
|
37
|
+
}
|
|
38
|
+
const sig = crypto.sign(null, Buffer.from(payload), key);
|
|
39
|
+
return `TPS-Ed25519 ${this.agentId}:${ts}:${nonce}:${sig.toString("base64")}`;
|
|
40
|
+
}
|
|
41
|
+
async req(method, path, body) {
|
|
42
|
+
const res = await fetch(`${this.url}${path}`, {
|
|
43
|
+
method,
|
|
44
|
+
headers: {
|
|
45
|
+
"Content-Type": "application/json",
|
|
46
|
+
Authorization: this.sign(method, path),
|
|
47
|
+
},
|
|
48
|
+
body: body !== undefined ? JSON.stringify(body) : undefined,
|
|
49
|
+
});
|
|
50
|
+
if (!res.ok) {
|
|
51
|
+
const txt = await res.text().catch(() => "");
|
|
52
|
+
throw new Error(`Flair ${method} ${path} → ${res.status}: ${txt}`);
|
|
53
|
+
}
|
|
54
|
+
if (res.status === 204)
|
|
55
|
+
return undefined;
|
|
56
|
+
return res.json();
|
|
57
|
+
}
|
|
58
|
+
// ─── Public API ────────────────────────────────────────────────────────────
|
|
59
|
+
async ping() {
|
|
60
|
+
try {
|
|
61
|
+
const res = await fetch(`${this.url}/Health`, { signal: AbortSignal.timeout(3000) });
|
|
62
|
+
return res.ok;
|
|
63
|
+
}
|
|
64
|
+
catch {
|
|
65
|
+
return false;
|
|
66
|
+
}
|
|
67
|
+
}
|
|
68
|
+
async getAgent(name) {
|
|
69
|
+
try {
|
|
70
|
+
return await this.req("GET", `/Agent/${name}`);
|
|
71
|
+
}
|
|
72
|
+
catch {
|
|
73
|
+
return null;
|
|
74
|
+
}
|
|
75
|
+
}
|
|
76
|
+
async getSoul() {
|
|
77
|
+
const entries = await this.req("GET", `/Soul?agentId=${encodeURIComponent(this.agentId)}`);
|
|
78
|
+
return entries;
|
|
79
|
+
}
|
|
80
|
+
async searchMemories(query, limit = 5) {
|
|
81
|
+
return this.req("GET", `/MemorySearch?agentId=${encodeURIComponent(this.agentId)}&q=${encodeURIComponent(query)}&limit=${limit}`);
|
|
82
|
+
}
|
|
83
|
+
async listRecentMemories(days = 3) {
|
|
84
|
+
return this.req("GET", `/Memory?agentId=${encodeURIComponent(this.agentId)}&limit=${days * 3}`);
|
|
85
|
+
}
|
|
86
|
+
async writeMemory(id, content, type = "conversation") {
|
|
87
|
+
const existing = await this.req("GET", `/Memory/${id}`).catch(() => null);
|
|
88
|
+
const payload = {
|
|
89
|
+
id,
|
|
90
|
+
agentId: this.agentId,
|
|
91
|
+
content,
|
|
92
|
+
type,
|
|
93
|
+
durability: "standard",
|
|
94
|
+
updatedAt: new Date().toISOString(),
|
|
95
|
+
};
|
|
96
|
+
if (existing) {
|
|
97
|
+
await this.req("PUT", `/Memory/${id}`, payload);
|
|
98
|
+
}
|
|
99
|
+
else {
|
|
100
|
+
await this.req("POST", "/Memory", { ...payload, createdAt: new Date().toISOString() });
|
|
101
|
+
}
|
|
102
|
+
}
|
|
103
|
+
/**
|
|
104
|
+
* Build a system prompt supplement from Flair — soul + recent context.
|
|
105
|
+
* Returns empty string if Flair is offline (graceful degradation).
|
|
106
|
+
*/
|
|
107
|
+
async buildContextBlock(query) {
|
|
108
|
+
if (!(await this.ping()))
|
|
109
|
+
return "";
|
|
110
|
+
const parts = [];
|
|
111
|
+
// Soul entries → identity block
|
|
112
|
+
try {
|
|
113
|
+
const soul = await this.getSoul();
|
|
114
|
+
if (soul.length > 0) {
|
|
115
|
+
parts.push("## Agent Identity (from Flair)");
|
|
116
|
+
for (const entry of soul) {
|
|
117
|
+
parts.push(`${entry.key}: ${entry.value}`);
|
|
118
|
+
}
|
|
119
|
+
}
|
|
120
|
+
}
|
|
121
|
+
catch {
|
|
122
|
+
// non-fatal
|
|
123
|
+
}
|
|
124
|
+
// Semantic search if query provided
|
|
125
|
+
if (query) {
|
|
126
|
+
try {
|
|
127
|
+
const results = await this.searchMemories(query, 5);
|
|
128
|
+
if (results.length > 0) {
|
|
129
|
+
parts.push("\n## Relevant Memory");
|
|
130
|
+
for (const r of results) {
|
|
131
|
+
const score = r.score ? ` [${r.score.toFixed(3)}]` : "";
|
|
132
|
+
parts.push(`${score} ${r.id}: ${r.content.slice(0, 500)}`);
|
|
133
|
+
}
|
|
134
|
+
}
|
|
135
|
+
}
|
|
136
|
+
catch {
|
|
137
|
+
// non-fatal
|
|
138
|
+
}
|
|
139
|
+
}
|
|
140
|
+
return parts.join("\n");
|
|
141
|
+
}
|
|
142
|
+
}
|
|
143
|
+
//# sourceMappingURL=flair.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"flair.js","sourceRoot":"","sources":["../../src/io/flair.ts"],"names":[],"mappings":"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"}
|
package/dist/io/mail.d.ts
CHANGED
|
@@ -1,7 +1,13 @@
|
|
|
1
|
+
import type { EventLogger } from "../telemetry/events.js";
|
|
2
|
+
import { type FlairClient } from "../lib/signEnvelope.js";
|
|
1
3
|
export interface MailMessage {
|
|
2
4
|
filename: string;
|
|
3
5
|
body: string;
|
|
4
6
|
receivedAt: Date;
|
|
7
|
+
/** Trust/routing headers from bridge envelope */
|
|
8
|
+
headers: Record<string, string>;
|
|
9
|
+
/** Sender agent ID */
|
|
10
|
+
from: string;
|
|
5
11
|
}
|
|
6
12
|
/**
|
|
7
13
|
* Maildir-compatible mail client.
|
|
@@ -10,13 +16,29 @@ export interface MailMessage {
|
|
|
10
16
|
*/
|
|
11
17
|
export declare class MailClient {
|
|
12
18
|
readonly mailDir: string;
|
|
19
|
+
private readonly events?;
|
|
20
|
+
private readonly agentId;
|
|
21
|
+
private readonly flairClient?;
|
|
13
22
|
private inboxNew;
|
|
14
23
|
private inboxCur;
|
|
24
|
+
private inboxDlq;
|
|
15
25
|
private outboxNew;
|
|
16
|
-
constructor(mailDir: string);
|
|
17
|
-
/**
|
|
26
|
+
constructor(mailDir: string, events?: EventLogger | undefined, agentId?: string, flairClient?: FlairClient | undefined);
|
|
27
|
+
/**
|
|
28
|
+
* Return all messages in inbox/new and move them to inbox/cur.
|
|
29
|
+
* When a FlairClient is provided, signed envelopes are verified
|
|
30
|
+
* before promotion; invalid/malformed messages go to dlq/.
|
|
31
|
+
*/
|
|
18
32
|
checkNewMail(): Promise<MailMessage[]>;
|
|
19
33
|
/** Write a message to outbox/new for relay delivery. */
|
|
20
34
|
sendMail(to: string, body: string): Promise<void>;
|
|
35
|
+
/** Deliver all messages in outbox to recipient inboxes (local relay). */
|
|
36
|
+
deliverOutbox(): void;
|
|
37
|
+
/**
|
|
38
|
+
* Verify a mail body against the v1 signed envelope spec.
|
|
39
|
+
* Returns { pass: true } if verified, or { pass: false, reason: "..." } on failure.
|
|
40
|
+
* Requires flairClient to be set.
|
|
41
|
+
*/
|
|
42
|
+
private verifyMailBody;
|
|
21
43
|
}
|
|
22
44
|
//# sourceMappingURL=mail.d.ts.map
|
package/dist/io/mail.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"mail.d.ts","sourceRoot":"","sources":["../../src/io/mail.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"mail.d.ts","sourceRoot":"","sources":["../../src/io/mail.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAE1D,OAAO,EAAkB,KAAK,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAE1E,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,IAAI,CAAC;IACjB,iDAAiD;IACjD,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,sBAAsB;IACtB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;GAIG;AACH,qBAAa,UAAU;aAOH,OAAO,EAAE,MAAM;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC;IAT/B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,SAAS,CAAS;gBAGR,OAAO,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,WAAW,YAAA,EACpB,OAAO,SAAY,EACnB,WAAW,CAAC,EAAE,WAAW,YAAA;IAW5C;;;;OAIG;IACG,YAAY,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAgE5C,wDAAwD;IAClD,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA8BvD,yEAAyE;IACzE,aAAa,IAAI,IAAI;IAqBrB;;;;OAIG;YACW,cAAc;CAqD7B"}
|