@atbash/sdk 0.10.12-dev.0 → 0.12.0-dev.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/README.md +5 -0
- package/dist/browser.d.mts +39 -13
- package/dist/browser.mjs +173 -114
- package/dist/browser.mjs.map +1 -1
- package/dist/index.d.mts +39 -13
- package/dist/index.d.ts +39 -13
- package/dist/index.js +212 -133
- package/dist/index.js.map +1 -1
- package/dist/index.mjs +210 -131
- package/dist/index.mjs.map +1 -1
- package/index.d.ts +18 -10
- package/index.js +85 -196
- package/package.json +5 -5
package/dist/index.d.mts
CHANGED
|
@@ -452,7 +452,7 @@ declare class Atbash {
|
|
|
452
452
|
* lazily as a signed `log_tool_call` tx and refreshed every 4 min so
|
|
453
453
|
* server-side replay protection windows never expire it mid-session.
|
|
454
454
|
*/
|
|
455
|
-
private
|
|
455
|
+
private _authBearers;
|
|
456
456
|
/** Guards `logEnvironmentOnce` — hosts construct several clients. */
|
|
457
457
|
private static environmentLogged;
|
|
458
458
|
constructor(privkey: string, options?: AtbashOptions);
|
|
@@ -600,6 +600,12 @@ declare class Atbash {
|
|
|
600
600
|
private riskEngineGet;
|
|
601
601
|
private riskEnginePost;
|
|
602
602
|
private riskEngineRecords;
|
|
603
|
+
/**
|
|
604
|
+
* BRID for an org — one round-trip to the map, honoring the client's chain
|
|
605
|
+
* cache. Returns undefined when the org is unknown, so the caller falls
|
|
606
|
+
* back to the client default (best-effort discovery).
|
|
607
|
+
*/
|
|
608
|
+
private bridForOrg;
|
|
603
609
|
private raiseIfError;
|
|
604
610
|
/** Wrap a failed HTTP *response* (non-2xx / non-200) as an AtbashAPIError. */
|
|
605
611
|
private httpError;
|
|
@@ -683,6 +689,12 @@ interface AtbashUserConfig {
|
|
|
683
689
|
agentKey?: string;
|
|
684
690
|
orgName?: string;
|
|
685
691
|
judgeEndpoint?: string;
|
|
692
|
+
/**
|
|
693
|
+
* Response-signing pubkey of a self-hosted judge (66 hex). Setting it makes
|
|
694
|
+
* `fromConfig` use the self-hosted policy for `judgeEndpoint`, which is the
|
|
695
|
+
* only way a non-allowlisted judge host is accepted.
|
|
696
|
+
*/
|
|
697
|
+
judgeVerifyPubKey?: string;
|
|
686
698
|
blockchainRid?: string;
|
|
687
699
|
provider?: string;
|
|
688
700
|
providerModel?: string;
|
|
@@ -785,15 +797,26 @@ declare function scanMemoryBatch(entries: MemoryEntry[], auth: AgentAuth, opts?:
|
|
|
785
797
|
interface CommitMemoryOptions {
|
|
786
798
|
/** Score in [1, 10]. Defaults to 5 (matches the Rell entity default). */
|
|
787
799
|
score?: number;
|
|
800
|
+
/**
|
|
801
|
+
* Which memory file this commit targets. Defaults to `""` — the
|
|
802
|
+
* un-pathed slot, matching Rell's `file_path: text = ""` default.
|
|
803
|
+
* Pass an explicit filename (e.g. `"AGENTS.md"`) to keep files
|
|
804
|
+
* versioned independently on chain.
|
|
805
|
+
*/
|
|
806
|
+
filePath?: string;
|
|
788
807
|
/** Org name — when set, the SDK resolves which chain the agent lives on. */
|
|
789
808
|
orgName?: string;
|
|
790
809
|
/** Atbash service endpoint for org→chain lookup. */
|
|
791
810
|
endpoint?: string;
|
|
811
|
+
/** Self-hosted judge response-signing pubkey; required with a non-allowlisted `endpoint`. */
|
|
812
|
+
verifyPubKey?: string;
|
|
792
813
|
chainOpts?: ChainOpts;
|
|
793
814
|
}
|
|
794
815
|
interface RollbackMemoryOptions {
|
|
795
816
|
orgName?: string;
|
|
796
817
|
endpoint?: string;
|
|
818
|
+
/** Self-hosted judge response-signing pubkey; required with a non-allowlisted `endpoint`. */
|
|
819
|
+
verifyPubKey?: string;
|
|
797
820
|
chainOpts?: ChainOpts;
|
|
798
821
|
}
|
|
799
822
|
/**
|
|
@@ -815,6 +838,7 @@ declare function commitMemoryVersion(plaintext: string, auth: AgentAuth, opts?:
|
|
|
815
838
|
*/
|
|
816
839
|
interface AgentMemoryEntry {
|
|
817
840
|
id: number;
|
|
841
|
+
filePath: string;
|
|
818
842
|
content: string;
|
|
819
843
|
decryptError?: string;
|
|
820
844
|
score: number;
|
|
@@ -826,6 +850,7 @@ interface AgentMemoryEntry {
|
|
|
826
850
|
interface MemoryRollbackEvent {
|
|
827
851
|
fromId: number;
|
|
828
852
|
toId: number;
|
|
853
|
+
filePath: string;
|
|
829
854
|
reason: string;
|
|
830
855
|
signer: string;
|
|
831
856
|
createdAt: number;
|
|
@@ -836,36 +861,39 @@ interface MemoryRollbackEvent {
|
|
|
836
861
|
* response is a single integer, so this is safe to call on every
|
|
837
862
|
* memory-read hot path.
|
|
838
863
|
*/
|
|
839
|
-
declare function getActiveMemoryId(auth: AgentAuth, chainOpts?: ChainOpts): Promise<number | null>;
|
|
864
|
+
declare function getActiveMemoryId(auth: AgentAuth, chainOpts?: ChainOpts, filePath?: string | null): Promise<number | null>;
|
|
840
865
|
/**
|
|
841
866
|
* Recent active memory entries — subset of active versions filtered
|
|
842
867
|
* by the chain's `MEMORY_RECENT_WINDOW_MS`. For a time-unbounded view
|
|
843
|
-
* of every currently active version, use `
|
|
868
|
+
* of every currently active version, use `getActiveAgentMemory`.
|
|
844
869
|
*/
|
|
845
|
-
declare function
|
|
870
|
+
declare function getRecentAgentMemory(auth: AgentAuth, chainOpts?: ChainOpts, filePath?: string | null): Promise<AgentMemoryEntry[]>;
|
|
846
871
|
/**
|
|
847
872
|
* All currently-active memory entries with no time cutoff. Use this
|
|
848
873
|
* when you need every active version regardless of age.
|
|
849
874
|
*/
|
|
850
|
-
declare function
|
|
875
|
+
declare function getActiveAgentMemory(auth: AgentAuth, chainOpts?: ChainOpts, filePath?: string | null): Promise<AgentMemoryEntry[]>;
|
|
851
876
|
/**
|
|
852
877
|
* Full version history — active + inactive, most recent first. Used
|
|
853
878
|
* by rollback UX to choose a target version.
|
|
854
879
|
*/
|
|
855
|
-
declare function getMemoryHistory(auth: AgentAuth, chainOpts?: ChainOpts): Promise<AgentMemoryEntry[]>;
|
|
880
|
+
declare function getMemoryHistory(auth: AgentAuth, chainOpts?: ChainOpts, filePath?: string | null): Promise<AgentMemoryEntry[]>;
|
|
856
881
|
/**
|
|
857
882
|
* Fetch a single memory entry by version id, including its current
|
|
858
|
-
* `is_active` state.
|
|
883
|
+
* `is_active` state. Version ids are agent-unique on chain (not
|
|
884
|
+
* per-file), so `id` alone resolves the target row.
|
|
859
885
|
*/
|
|
860
886
|
declare function getMemoryById(id: number, auth: AgentAuth, chainOpts?: ChainOpts): Promise<AgentMemoryEntry>;
|
|
861
887
|
/**
|
|
862
888
|
* Audit trail of rollback events for this agent, most recent first.
|
|
889
|
+
* Scope by file with `filePath`; omit for a cross-file view.
|
|
863
890
|
*/
|
|
864
|
-
declare function getRollbackHistory(auth: AgentAuth, chainOpts?: ChainOpts): Promise<MemoryRollbackEvent[]>;
|
|
891
|
+
declare function getRollbackHistory(auth: AgentAuth, chainOpts?: ChainOpts, filePath?: string | null): Promise<MemoryRollbackEvent[]>;
|
|
865
892
|
/**
|
|
866
893
|
* Roll back to a previously-committed memory version. The target
|
|
867
|
-
* `toId` must exist and be currently inactive.
|
|
868
|
-
*
|
|
894
|
+
* `toId` must exist and be currently inactive. The chain resolves the
|
|
895
|
+
* target row's `file_path` from `toId` — no file path is passed in.
|
|
896
|
+
* `reason` is required and is recorded on-chain in `memory_rollback_log`.
|
|
869
897
|
*/
|
|
870
898
|
declare function rollbackMemory(toId: number, reason: string, auth: AgentAuth, opts?: RollbackMemoryOptions): Promise<void>;
|
|
871
899
|
|
|
@@ -950,8 +978,6 @@ interface GuardMemoryWriteInput extends ClassifyMemoryWriteOptions {
|
|
|
950
978
|
debug?: boolean;
|
|
951
979
|
/** Optional logger for debug probe + persist-failure warnings. */
|
|
952
980
|
logger?: GuardLogger;
|
|
953
|
-
/** Absolute path of the agent's managed memory file. Required for chain commits — omitted skips them. */
|
|
954
|
-
memoryFilePath?: string;
|
|
955
981
|
}
|
|
956
982
|
/** Plugin-facing decision. Shape mirrors what plugins return from `before_tool_call`. */
|
|
957
983
|
interface GuardMemoryDecision {
|
|
@@ -1372,4 +1398,4 @@ declare function containsSecret(text: string): boolean;
|
|
|
1372
1398
|
declare function createMemorySnapshot(entries: MemoryEntry[], takenAt: number): MemorySnapshot;
|
|
1373
1399
|
declare function diffMemorySnapshots(before: MemorySnapshot, after: MemorySnapshot): MemoryDiffResult;
|
|
1374
1400
|
|
|
1375
|
-
export { type ActionType, type AgentAuth, type AgentLookupOptions, type AgentMemoryEntry, type AgentPolicy, type AnomalySeverity, type AnomalyType, Atbash, AtbashAPIError, type AtbashLogger, type AtbashOptions, type AtbashUserConfig, BOOT_SYNC_HINT, type ChainOpts, type ClassifierToolContext, type ClassifierToolEvent, type ClassifyMemoryReadOptions, type ClassifyMemoryWriteOptions, type ClientSource, type CommitMemoryOptions, DEFAULT_BLOCKCHAIN_RID, DEFAULT_CHROMIA_NODE_URLS, DEFAULT_ENDPOINT, DEFAULT_MEMORY_PATH_PATTERNS, DEFAULT_MEMORY_READ_TOOL_NAMES, DEFAULT_MEMORY_WRITE_TOOL_NAMES, type Decision, type DecisionVerdict, EciesDomain, type EncryptedMemory, type Envelope, type FromConfigOptions, type GuardLogger, type GuardMemoryDecision, type GuardMemoryWriteInput, type GuardMemoryWriteResult, type HeldAction, type HeldActionReview, type HookDecision, HttpClient, HttpTransportError, type JudgeEndpointConfig, type JudgeOptions, type JudgeResult, type JudgmentState, type JudgmentStatus, KEY_FILENAMES, type KeyPair, type LogToolCallOptions, type LogToolCallResult, type MemoryAnomaly, type MemoryDiffResult, type MemoryEntry, MemoryGuardManager, type MemoryGuardManagerOptions, MemoryIntegrityError, type MemoryPointer, type MemoryRollbackEvent, type MemoryScanOptions, type MemoryScanResult, type MemoryScanVerdict, type MemorySnapshot, type ModifiedEntry, type Network, type OrgSubscription, PointerStore, type Provider, type PubkeyValue, type RedactResult, type RollbackMemoryOptions, type SecretKind, type SecretMatch, SignatureVerificationError, type Subscription, type SyncMemoryOptions, type SyncMemoryResult, type TelemetryConfig, type TierInfo, type ToolCallFull, type ToolCallInput, type ToolCallRecord, type ValidatedEndpoint, type Verdict, type WrappedLogger, bootSyncFailureLine, buildAllowedJudgeHosts, chooseKeyPath, claimHashHex, classifyMemoryRead, classifyMemoryWrite, columnAad, commitMemoryVersion, containsEvasionCharacters, containsSecret, createFileLogger, createMemoryGuardManager, createMemorySnapshot, decryptForOrg, decryptMemoryContent, defaultPluginLogPath, defaultPointerPath, deriveMemoryKey, derivePublicKey, diffMemorySnapshots, encryptForOrg, encryptMemoryContent, encryptedLength, flushTelemetry, generateKeypair,
|
|
1401
|
+
export { type ActionType, type AgentAuth, type AgentLookupOptions, type AgentMemoryEntry, type AgentPolicy, type AnomalySeverity, type AnomalyType, Atbash, AtbashAPIError, type AtbashLogger, type AtbashOptions, type AtbashUserConfig, BOOT_SYNC_HINT, type ChainOpts, type ClassifierToolContext, type ClassifierToolEvent, type ClassifyMemoryReadOptions, type ClassifyMemoryWriteOptions, type ClientSource, type CommitMemoryOptions, DEFAULT_BLOCKCHAIN_RID, DEFAULT_CHROMIA_NODE_URLS, DEFAULT_ENDPOINT, DEFAULT_MEMORY_PATH_PATTERNS, DEFAULT_MEMORY_READ_TOOL_NAMES, DEFAULT_MEMORY_WRITE_TOOL_NAMES, type Decision, type DecisionVerdict, EciesDomain, type EncryptedMemory, type Envelope, type FromConfigOptions, type GuardLogger, type GuardMemoryDecision, type GuardMemoryWriteInput, type GuardMemoryWriteResult, type HeldAction, type HeldActionReview, type HookDecision, HttpClient, HttpTransportError, type JudgeEndpointConfig, type JudgeOptions, type JudgeResult, type JudgmentState, type JudgmentStatus, KEY_FILENAMES, type KeyPair, type LogToolCallOptions, type LogToolCallResult, type MemoryAnomaly, type MemoryDiffResult, type MemoryEntry, MemoryGuardManager, type MemoryGuardManagerOptions, MemoryIntegrityError, type MemoryPointer, type MemoryRollbackEvent, type MemoryScanOptions, type MemoryScanResult, type MemoryScanVerdict, type MemorySnapshot, type ModifiedEntry, type Network, type OrgSubscription, PointerStore, type Provider, type PubkeyValue, type RedactResult, type RollbackMemoryOptions, type SecretKind, type SecretMatch, SignatureVerificationError, type Subscription, type SyncMemoryOptions, type SyncMemoryResult, type TelemetryConfig, type TierInfo, type ToolCallFull, type ToolCallInput, type ToolCallRecord, type ValidatedEndpoint, type Verdict, type WrappedLogger, bootSyncFailureLine, buildAllowedJudgeHosts, chooseKeyPath, claimHashHex, classifyMemoryRead, classifyMemoryWrite, columnAad, commitMemoryVersion, containsEvasionCharacters, containsSecret, createFileLogger, createMemoryGuardManager, createMemorySnapshot, decryptForOrg, decryptMemoryContent, defaultPluginLogPath, defaultPointerPath, deriveMemoryKey, derivePublicKey, diffMemorySnapshots, encryptForOrg, encryptMemoryContent, encryptedLength, flushTelemetry, generateKeypair, getActiveAgentMemory, getActiveMemoryId, getConfigDir, getConfigPath, getMemoryById, getMemoryHistory, getRecentAgentMemory, getRollbackHistory, guardMemoryWrite, isEnvelope, isValidPrivateKey, keyFingerprintOf, keyPathCandidates, loadAgent, loadAgentFromFile, loadUserConfig, normalizeActionForHash, normalizeForMatching, normalizeStatus, normalizeVerdict, packEnvelope, parseEnvelope, pubkeyToHex, recordCall, recordDuration, redactJsonStrings, redactSecrets, resolve, resolveKeyPath, rollbackMemory, saveUserConfig, scanMemory, scanMemoryBatch, setupTelemetry, shutdownTelemetry, signEncryptedToolCall, signJudgeAction, signLogToolCall, syncLocalMemory, validateJudgeEndpoint, verifyJudgeResponseSignature, verifySignature };
|
package/dist/index.d.ts
CHANGED
|
@@ -452,7 +452,7 @@ declare class Atbash {
|
|
|
452
452
|
* lazily as a signed `log_tool_call` tx and refreshed every 4 min so
|
|
453
453
|
* server-side replay protection windows never expire it mid-session.
|
|
454
454
|
*/
|
|
455
|
-
private
|
|
455
|
+
private _authBearers;
|
|
456
456
|
/** Guards `logEnvironmentOnce` — hosts construct several clients. */
|
|
457
457
|
private static environmentLogged;
|
|
458
458
|
constructor(privkey: string, options?: AtbashOptions);
|
|
@@ -600,6 +600,12 @@ declare class Atbash {
|
|
|
600
600
|
private riskEngineGet;
|
|
601
601
|
private riskEnginePost;
|
|
602
602
|
private riskEngineRecords;
|
|
603
|
+
/**
|
|
604
|
+
* BRID for an org — one round-trip to the map, honoring the client's chain
|
|
605
|
+
* cache. Returns undefined when the org is unknown, so the caller falls
|
|
606
|
+
* back to the client default (best-effort discovery).
|
|
607
|
+
*/
|
|
608
|
+
private bridForOrg;
|
|
603
609
|
private raiseIfError;
|
|
604
610
|
/** Wrap a failed HTTP *response* (non-2xx / non-200) as an AtbashAPIError. */
|
|
605
611
|
private httpError;
|
|
@@ -683,6 +689,12 @@ interface AtbashUserConfig {
|
|
|
683
689
|
agentKey?: string;
|
|
684
690
|
orgName?: string;
|
|
685
691
|
judgeEndpoint?: string;
|
|
692
|
+
/**
|
|
693
|
+
* Response-signing pubkey of a self-hosted judge (66 hex). Setting it makes
|
|
694
|
+
* `fromConfig` use the self-hosted policy for `judgeEndpoint`, which is the
|
|
695
|
+
* only way a non-allowlisted judge host is accepted.
|
|
696
|
+
*/
|
|
697
|
+
judgeVerifyPubKey?: string;
|
|
686
698
|
blockchainRid?: string;
|
|
687
699
|
provider?: string;
|
|
688
700
|
providerModel?: string;
|
|
@@ -785,15 +797,26 @@ declare function scanMemoryBatch(entries: MemoryEntry[], auth: AgentAuth, opts?:
|
|
|
785
797
|
interface CommitMemoryOptions {
|
|
786
798
|
/** Score in [1, 10]. Defaults to 5 (matches the Rell entity default). */
|
|
787
799
|
score?: number;
|
|
800
|
+
/**
|
|
801
|
+
* Which memory file this commit targets. Defaults to `""` — the
|
|
802
|
+
* un-pathed slot, matching Rell's `file_path: text = ""` default.
|
|
803
|
+
* Pass an explicit filename (e.g. `"AGENTS.md"`) to keep files
|
|
804
|
+
* versioned independently on chain.
|
|
805
|
+
*/
|
|
806
|
+
filePath?: string;
|
|
788
807
|
/** Org name — when set, the SDK resolves which chain the agent lives on. */
|
|
789
808
|
orgName?: string;
|
|
790
809
|
/** Atbash service endpoint for org→chain lookup. */
|
|
791
810
|
endpoint?: string;
|
|
811
|
+
/** Self-hosted judge response-signing pubkey; required with a non-allowlisted `endpoint`. */
|
|
812
|
+
verifyPubKey?: string;
|
|
792
813
|
chainOpts?: ChainOpts;
|
|
793
814
|
}
|
|
794
815
|
interface RollbackMemoryOptions {
|
|
795
816
|
orgName?: string;
|
|
796
817
|
endpoint?: string;
|
|
818
|
+
/** Self-hosted judge response-signing pubkey; required with a non-allowlisted `endpoint`. */
|
|
819
|
+
verifyPubKey?: string;
|
|
797
820
|
chainOpts?: ChainOpts;
|
|
798
821
|
}
|
|
799
822
|
/**
|
|
@@ -815,6 +838,7 @@ declare function commitMemoryVersion(plaintext: string, auth: AgentAuth, opts?:
|
|
|
815
838
|
*/
|
|
816
839
|
interface AgentMemoryEntry {
|
|
817
840
|
id: number;
|
|
841
|
+
filePath: string;
|
|
818
842
|
content: string;
|
|
819
843
|
decryptError?: string;
|
|
820
844
|
score: number;
|
|
@@ -826,6 +850,7 @@ interface AgentMemoryEntry {
|
|
|
826
850
|
interface MemoryRollbackEvent {
|
|
827
851
|
fromId: number;
|
|
828
852
|
toId: number;
|
|
853
|
+
filePath: string;
|
|
829
854
|
reason: string;
|
|
830
855
|
signer: string;
|
|
831
856
|
createdAt: number;
|
|
@@ -836,36 +861,39 @@ interface MemoryRollbackEvent {
|
|
|
836
861
|
* response is a single integer, so this is safe to call on every
|
|
837
862
|
* memory-read hot path.
|
|
838
863
|
*/
|
|
839
|
-
declare function getActiveMemoryId(auth: AgentAuth, chainOpts?: ChainOpts): Promise<number | null>;
|
|
864
|
+
declare function getActiveMemoryId(auth: AgentAuth, chainOpts?: ChainOpts, filePath?: string | null): Promise<number | null>;
|
|
840
865
|
/**
|
|
841
866
|
* Recent active memory entries — subset of active versions filtered
|
|
842
867
|
* by the chain's `MEMORY_RECENT_WINDOW_MS`. For a time-unbounded view
|
|
843
|
-
* of every currently active version, use `
|
|
868
|
+
* of every currently active version, use `getActiveAgentMemory`.
|
|
844
869
|
*/
|
|
845
|
-
declare function
|
|
870
|
+
declare function getRecentAgentMemory(auth: AgentAuth, chainOpts?: ChainOpts, filePath?: string | null): Promise<AgentMemoryEntry[]>;
|
|
846
871
|
/**
|
|
847
872
|
* All currently-active memory entries with no time cutoff. Use this
|
|
848
873
|
* when you need every active version regardless of age.
|
|
849
874
|
*/
|
|
850
|
-
declare function
|
|
875
|
+
declare function getActiveAgentMemory(auth: AgentAuth, chainOpts?: ChainOpts, filePath?: string | null): Promise<AgentMemoryEntry[]>;
|
|
851
876
|
/**
|
|
852
877
|
* Full version history — active + inactive, most recent first. Used
|
|
853
878
|
* by rollback UX to choose a target version.
|
|
854
879
|
*/
|
|
855
|
-
declare function getMemoryHistory(auth: AgentAuth, chainOpts?: ChainOpts): Promise<AgentMemoryEntry[]>;
|
|
880
|
+
declare function getMemoryHistory(auth: AgentAuth, chainOpts?: ChainOpts, filePath?: string | null): Promise<AgentMemoryEntry[]>;
|
|
856
881
|
/**
|
|
857
882
|
* Fetch a single memory entry by version id, including its current
|
|
858
|
-
* `is_active` state.
|
|
883
|
+
* `is_active` state. Version ids are agent-unique on chain (not
|
|
884
|
+
* per-file), so `id` alone resolves the target row.
|
|
859
885
|
*/
|
|
860
886
|
declare function getMemoryById(id: number, auth: AgentAuth, chainOpts?: ChainOpts): Promise<AgentMemoryEntry>;
|
|
861
887
|
/**
|
|
862
888
|
* Audit trail of rollback events for this agent, most recent first.
|
|
889
|
+
* Scope by file with `filePath`; omit for a cross-file view.
|
|
863
890
|
*/
|
|
864
|
-
declare function getRollbackHistory(auth: AgentAuth, chainOpts?: ChainOpts): Promise<MemoryRollbackEvent[]>;
|
|
891
|
+
declare function getRollbackHistory(auth: AgentAuth, chainOpts?: ChainOpts, filePath?: string | null): Promise<MemoryRollbackEvent[]>;
|
|
865
892
|
/**
|
|
866
893
|
* Roll back to a previously-committed memory version. The target
|
|
867
|
-
* `toId` must exist and be currently inactive.
|
|
868
|
-
*
|
|
894
|
+
* `toId` must exist and be currently inactive. The chain resolves the
|
|
895
|
+
* target row's `file_path` from `toId` — no file path is passed in.
|
|
896
|
+
* `reason` is required and is recorded on-chain in `memory_rollback_log`.
|
|
869
897
|
*/
|
|
870
898
|
declare function rollbackMemory(toId: number, reason: string, auth: AgentAuth, opts?: RollbackMemoryOptions): Promise<void>;
|
|
871
899
|
|
|
@@ -950,8 +978,6 @@ interface GuardMemoryWriteInput extends ClassifyMemoryWriteOptions {
|
|
|
950
978
|
debug?: boolean;
|
|
951
979
|
/** Optional logger for debug probe + persist-failure warnings. */
|
|
952
980
|
logger?: GuardLogger;
|
|
953
|
-
/** Absolute path of the agent's managed memory file. Required for chain commits — omitted skips them. */
|
|
954
|
-
memoryFilePath?: string;
|
|
955
981
|
}
|
|
956
982
|
/** Plugin-facing decision. Shape mirrors what plugins return from `before_tool_call`. */
|
|
957
983
|
interface GuardMemoryDecision {
|
|
@@ -1372,4 +1398,4 @@ declare function containsSecret(text: string): boolean;
|
|
|
1372
1398
|
declare function createMemorySnapshot(entries: MemoryEntry[], takenAt: number): MemorySnapshot;
|
|
1373
1399
|
declare function diffMemorySnapshots(before: MemorySnapshot, after: MemorySnapshot): MemoryDiffResult;
|
|
1374
1400
|
|
|
1375
|
-
export { type ActionType, type AgentAuth, type AgentLookupOptions, type AgentMemoryEntry, type AgentPolicy, type AnomalySeverity, type AnomalyType, Atbash, AtbashAPIError, type AtbashLogger, type AtbashOptions, type AtbashUserConfig, BOOT_SYNC_HINT, type ChainOpts, type ClassifierToolContext, type ClassifierToolEvent, type ClassifyMemoryReadOptions, type ClassifyMemoryWriteOptions, type ClientSource, type CommitMemoryOptions, DEFAULT_BLOCKCHAIN_RID, DEFAULT_CHROMIA_NODE_URLS, DEFAULT_ENDPOINT, DEFAULT_MEMORY_PATH_PATTERNS, DEFAULT_MEMORY_READ_TOOL_NAMES, DEFAULT_MEMORY_WRITE_TOOL_NAMES, type Decision, type DecisionVerdict, EciesDomain, type EncryptedMemory, type Envelope, type FromConfigOptions, type GuardLogger, type GuardMemoryDecision, type GuardMemoryWriteInput, type GuardMemoryWriteResult, type HeldAction, type HeldActionReview, type HookDecision, HttpClient, HttpTransportError, type JudgeEndpointConfig, type JudgeOptions, type JudgeResult, type JudgmentState, type JudgmentStatus, KEY_FILENAMES, type KeyPair, type LogToolCallOptions, type LogToolCallResult, type MemoryAnomaly, type MemoryDiffResult, type MemoryEntry, MemoryGuardManager, type MemoryGuardManagerOptions, MemoryIntegrityError, type MemoryPointer, type MemoryRollbackEvent, type MemoryScanOptions, type MemoryScanResult, type MemoryScanVerdict, type MemorySnapshot, type ModifiedEntry, type Network, type OrgSubscription, PointerStore, type Provider, type PubkeyValue, type RedactResult, type RollbackMemoryOptions, type SecretKind, type SecretMatch, SignatureVerificationError, type Subscription, type SyncMemoryOptions, type SyncMemoryResult, type TelemetryConfig, type TierInfo, type ToolCallFull, type ToolCallInput, type ToolCallRecord, type ValidatedEndpoint, type Verdict, type WrappedLogger, bootSyncFailureLine, buildAllowedJudgeHosts, chooseKeyPath, claimHashHex, classifyMemoryRead, classifyMemoryWrite, columnAad, commitMemoryVersion, containsEvasionCharacters, containsSecret, createFileLogger, createMemoryGuardManager, createMemorySnapshot, decryptForOrg, decryptMemoryContent, defaultPluginLogPath, defaultPointerPath, deriveMemoryKey, derivePublicKey, diffMemorySnapshots, encryptForOrg, encryptMemoryContent, encryptedLength, flushTelemetry, generateKeypair,
|
|
1401
|
+
export { type ActionType, type AgentAuth, type AgentLookupOptions, type AgentMemoryEntry, type AgentPolicy, type AnomalySeverity, type AnomalyType, Atbash, AtbashAPIError, type AtbashLogger, type AtbashOptions, type AtbashUserConfig, BOOT_SYNC_HINT, type ChainOpts, type ClassifierToolContext, type ClassifierToolEvent, type ClassifyMemoryReadOptions, type ClassifyMemoryWriteOptions, type ClientSource, type CommitMemoryOptions, DEFAULT_BLOCKCHAIN_RID, DEFAULT_CHROMIA_NODE_URLS, DEFAULT_ENDPOINT, DEFAULT_MEMORY_PATH_PATTERNS, DEFAULT_MEMORY_READ_TOOL_NAMES, DEFAULT_MEMORY_WRITE_TOOL_NAMES, type Decision, type DecisionVerdict, EciesDomain, type EncryptedMemory, type Envelope, type FromConfigOptions, type GuardLogger, type GuardMemoryDecision, type GuardMemoryWriteInput, type GuardMemoryWriteResult, type HeldAction, type HeldActionReview, type HookDecision, HttpClient, HttpTransportError, type JudgeEndpointConfig, type JudgeOptions, type JudgeResult, type JudgmentState, type JudgmentStatus, KEY_FILENAMES, type KeyPair, type LogToolCallOptions, type LogToolCallResult, type MemoryAnomaly, type MemoryDiffResult, type MemoryEntry, MemoryGuardManager, type MemoryGuardManagerOptions, MemoryIntegrityError, type MemoryPointer, type MemoryRollbackEvent, type MemoryScanOptions, type MemoryScanResult, type MemoryScanVerdict, type MemorySnapshot, type ModifiedEntry, type Network, type OrgSubscription, PointerStore, type Provider, type PubkeyValue, type RedactResult, type RollbackMemoryOptions, type SecretKind, type SecretMatch, SignatureVerificationError, type Subscription, type SyncMemoryOptions, type SyncMemoryResult, type TelemetryConfig, type TierInfo, type ToolCallFull, type ToolCallInput, type ToolCallRecord, type ValidatedEndpoint, type Verdict, type WrappedLogger, bootSyncFailureLine, buildAllowedJudgeHosts, chooseKeyPath, claimHashHex, classifyMemoryRead, classifyMemoryWrite, columnAad, commitMemoryVersion, containsEvasionCharacters, containsSecret, createFileLogger, createMemoryGuardManager, createMemorySnapshot, decryptForOrg, decryptMemoryContent, defaultPluginLogPath, defaultPointerPath, deriveMemoryKey, derivePublicKey, diffMemorySnapshots, encryptForOrg, encryptMemoryContent, encryptedLength, flushTelemetry, generateKeypair, getActiveAgentMemory, getActiveMemoryId, getConfigDir, getConfigPath, getMemoryById, getMemoryHistory, getRecentAgentMemory, getRollbackHistory, guardMemoryWrite, isEnvelope, isValidPrivateKey, keyFingerprintOf, keyPathCandidates, loadAgent, loadAgentFromFile, loadUserConfig, normalizeActionForHash, normalizeForMatching, normalizeStatus, normalizeVerdict, packEnvelope, parseEnvelope, pubkeyToHex, recordCall, recordDuration, redactJsonStrings, redactSecrets, resolve, resolveKeyPath, rollbackMemory, saveUserConfig, scanMemory, scanMemoryBatch, setupTelemetry, shutdownTelemetry, signEncryptedToolCall, signJudgeAction, signLogToolCall, syncLocalMemory, validateJudgeEndpoint, verifyJudgeResponseSignature, verifySignature };
|