@the-ai-company/cbio-node-runtime 1.42.0 → 1.45.2

package/docs/api/functions/createDefaultVaultCoreDependencies.md

@@ -0,0 +1,77 @@
+[**CBIO Node Runtime Agent API v1.45.2**](../README.md)
+
+***
+
+# Function: createDefaultVaultCoreDependencies()
+
+> **createDefaultVaultCoreDependencies**(`options?`): `object`
+
+## Parameters
+
+### options?
+
+[`CreateDefaultVaultCoreDependenciesOptions`](../interfaces/CreateDefaultVaultCoreDependenciesOptions.md) = `{}`
+
+## Returns
+
+`object`
+
+### agentIdentities
+
+> **agentIdentities**: [`InMemoryAgentIdentityRegistry`](../classes/InMemoryAgentIdentityRegistry.md)
+
+### audit
+
+> **audit**: [`InMemoryAuditLog`](../classes/InMemoryAuditLog.md)
+
+### capabilities
+
+> **capabilities**: [`InMemoryCapabilityRegistry`](../classes/InMemoryCapabilityRegistry.md)
+
+### clock
+
+> **clock**: [`SystemClock`](../classes/SystemClock.md)
+
+### custody
+
+> **custody**: [`InMemorySecretCustody`](../classes/InMemorySecretCustody.md)
+
+### customFlows
+
+> **customFlows**: [`InMemoryCustomHttpFlowRegistry`](../classes/InMemoryCustomHttpFlowRegistry.md)
+
+### executor
+
+> **executor**: [`HttpDispatchExecutor`](../classes/HttpDispatchExecutor.md)
+
+### ids
+
+> **ids**: [`RandomIdGenerator`](../classes/RandomIdGenerator.md)
+
+### ownerIdentities
+
+> **ownerIdentities**: [`InMemoryOwnerIdentityRegistry`](../classes/InMemoryOwnerIdentityRegistry.md)
+
+### ownerProofVerifier
+
+> **ownerProofVerifier**: [`SignatureOwnerProofVerifier`](../classes/SignatureOwnerProofVerifier.md)
+
+### policy
+
+> **policy**: [`DefaultPolicyEngine`](../classes/DefaultPolicyEngine.md)
+
+### proofVerifier
+
+> **proofVerifier**: [`SignatureAgentProofVerifier`](../classes/SignatureAgentProofVerifier.md)
+
+### replayGuard
+
+> **replayGuard**: [`InMemoryReplayGuard`](../classes/InMemoryReplayGuard.md)
+
+### secrets
+
+> **secrets**: [`InMemorySecretRepository`](../classes/InMemorySecretRepository.md)
+
+### vaultId
+
+> **vaultId**: [`VaultId`](../interfaces/VaultId.md)

package/docs/api/functions/createIdentity.md

@@ -0,0 +1,30 @@
+[**CBIO Node Runtime Agent API v1.45.2**](../README.md)
+
+***
+
+# Function: createIdentity()
+
+> **createIdentity**(`options?`): `CreatedIdentity`
+
+Creates a new root identity with a fresh Ed25519 keypair.
+
+## Parameters
+
+### options?
+
+[`CreateIdentityOptions`](../interfaces/CreateIdentityOptions.md)
+
+Configuration for the new identity.
+
+## Returns
+
+`CreatedIdentity`
+
+A CreatedIdentity containing the ID and keys.
+
+## Example
+
+```ts
+const identity = createIdentity({ nickname: 'my-agent' });
+console.log(identity.identityId);
+```

package/docs/api/functions/createOwnerHttpFlowBoundary.md

@@ -0,0 +1,17 @@
+[**CBIO Node Runtime Agent API v1.45.2**](../README.md)
+
+***
+
+# Function: createOwnerHttpFlowBoundary()
+
+> **createOwnerHttpFlowBoundary**(`boundary`): [`OwnerHttpFlowBoundary`](../interfaces/OwnerHttpFlowBoundary.md)
+
+## Parameters
+
+### boundary
+
+[`OwnerHttpFlowBoundary`](../interfaces/OwnerHttpFlowBoundary.md)
+
+## Returns
+
+[`OwnerHttpFlowBoundary`](../interfaces/OwnerHttpFlowBoundary.md)

package/docs/api/functions/createPersistentVaultCoreDependencies.md

@@ -0,0 +1,85 @@
+[**CBIO Node Runtime Agent API v1.45.2**](../README.md)
+
+***
+
+# Function: createPersistentVaultCoreDependencies()
+
+> **createPersistentVaultCoreDependencies**(`storage`, `options`): `object`
+
+## Parameters
+
+### storage
+
+[`IStorageProvider`](../interfaces/IStorageProvider.md)
+
+### options
+
+[`CreatePersistentVaultCoreDependenciesOptions`](../interfaces/CreatePersistentVaultCoreDependenciesOptions.md)
+
+## Returns
+
+`object`
+
+### agentIdentities
+
+> **agentIdentities**: [`PersistentVaultAgentIdentityRegistry`](../classes/PersistentVaultAgentIdentityRegistry.md)
+
+### audit
+
+> **audit**: [`PersistentVaultAuditLog`](../classes/PersistentVaultAuditLog.md)
+
+### capabilities
+
+> **capabilities**: [`PersistentVaultCapabilityRegistry`](../classes/PersistentVaultCapabilityRegistry.md)
+
+### capabilityRevocations
+
+> **capabilityRevocations**: [`CapabilityRevocationRegistry`](../interfaces/CapabilityRevocationRegistry.md)
+
+### clock
+
+> **clock**: [`SystemClock`](../classes/SystemClock.md)
+
+### custody
+
+> **custody**: [`PersistentVaultSecretCustody`](../classes/PersistentVaultSecretCustody.md)
+
+### customFlows
+
+> **customFlows**: [`CustomHttpFlowRegistry`](../interfaces/CustomHttpFlowRegistry.md)
+
+### executor
+
+> **executor**: [`HttpDispatchExecutor`](../classes/HttpDispatchExecutor.md)
+
+### ids
+
+> **ids**: [`RandomIdGenerator`](../classes/RandomIdGenerator.md)
+
+### ownerIdentities
+
+> **ownerIdentities**: [`PersistentVaultOwnerIdentityRegistry`](../classes/PersistentVaultOwnerIdentityRegistry.md)
+
+### ownerProofVerifier
+
+> **ownerProofVerifier**: [`SignatureOwnerProofVerifier`](../classes/SignatureOwnerProofVerifier.md)
+
+### policy
+
+> **policy**: [`DefaultPolicyEngine`](../classes/DefaultPolicyEngine.md)
+
+### proofVerifier
+
+> **proofVerifier**: [`SignatureAgentProofVerifier`](../classes/SignatureAgentProofVerifier.md)
+
+### replayGuard
+
+> **replayGuard**: [`ReplayGuard`](../interfaces/ReplayGuard.md)
+
+### secrets
+
+> **secrets**: [`PersistentVaultSecretRepository`](../classes/PersistentVaultSecretRepository.md)
+
+### vaultId
+
+> **vaultId**: [`VaultId`](../interfaces/VaultId.md)

package/docs/api/functions/createStandardAcquireBoundary.md

@@ -0,0 +1,31 @@
+[**CBIO Node Runtime Agent API v1.45.2**](../README.md)
+
+***
+
+# Function: createStandardAcquireBoundary()
+
+> **createStandardAcquireBoundary**(`input`): [`OwnerHttpFlowBoundary`](../interfaces/OwnerHttpFlowBoundary.md)
+
+## Parameters
+
+### input
+
+#### method?
+
+`string`
+
+#### responseField
+
+`"access_token"` \| `"refresh_token"` \| `"id_token"`
+
+#### storeAlias
+
+`string`
+
+#### targetUrl
+
+`string`
+
+## Returns
+
+[`OwnerHttpFlowBoundary`](../interfaces/OwnerHttpFlowBoundary.md)

package/docs/api/functions/createStandardDispatchBoundary.md

@@ -0,0 +1,23 @@
+[**CBIO Node Runtime Agent API v1.45.2**](../README.md)
+
+***
+
+# Function: createStandardDispatchBoundary()
+
+> **createStandardDispatchBoundary**(`input`): [`OwnerHttpFlowBoundary`](../interfaces/OwnerHttpFlowBoundary.md)
+
+## Parameters
+
+### input
+
+#### method
+
+`string`
+
+#### targetUrl
+
+`string`
+
+## Returns
+
+[`OwnerHttpFlowBoundary`](../interfaces/OwnerHttpFlowBoundary.md)

package/docs/api/functions/createVault.md

@@ -0,0 +1,58 @@
+[**CBIO Node Runtime Agent API v1.45.2**](../README.md)
+
+***
+
+# Function: createVault()
+
+## Call Signature
+
+> **createVault**(`storage`, `options`): `Promise`\<[`CreatedVault`](../interfaces/CreatedVault.md)\>
+
+Creates and bootstraps a new persistent vault.
+
+### Parameters
+
+#### storage
+
+`string` \| [`IStorageProvider`](../interfaces/IStorageProvider.md)
+
+Workspace storage (or path string) where vaults are stored.
+
+#### options
+
+[`CreateVaultOptions`](../interfaces/CreateVaultOptions.md)
+
+Configuration including owner identity and metadata.
+
+### Returns
+
+`Promise`\<[`CreatedVault`](../interfaces/CreatedVault.md)\>
+
+A [CreatedVault](../interfaces/CreatedVault.md) instance.
+
+### Example
+
+```ts
+const vault = await createVault({
+  ownerIdentity,
+  nickname: 'production-secrets'
+});
+```
+
+## Call Signature
+
+> **createVault**(`options`): `Promise`\<[`CreatedVault`](../interfaces/CreatedVault.md)\>
+
+Creates a new vault using the default workspace storage.
+
+### Parameters
+
+#### options
+
+[`CreateVaultOptions`](../interfaces/CreateVaultOptions.md)
+
+Configuration for the new vault.
+
+### Returns
+
+`Promise`\<[`CreatedVault`](../interfaces/CreatedVault.md)\>

package/docs/api/functions/createVaultClient.md

@@ -0,0 +1,32 @@
+[**CBIO Node Runtime Agent API v1.45.2**](../README.md)
+
+***
+
+# Function: createVaultClient()
+
+> **createVaultClient**(`options`): [`VaultClient`](../interfaces/VaultClient.md)
+
+Creates a [VaultClient](../interfaces/VaultClient.md) instance for a specific vault owner.
+
+## Parameters
+
+### options
+
+[`CreateVaultClientOptions`](../interfaces/CreateVaultClientOptions.md)
+
+Configuration including owner identity and the vault service.
+
+## Returns
+
+[`VaultClient`](../interfaces/VaultClient.md)
+
+An initialized [VaultClient](../interfaces/VaultClient.md).
+
+## Example
+
+```ts
+const client = createVaultClient({
+  ownerIdentity,
+  vault
+});
+```

package/docs/api/functions/createVaultCore.md

@@ -0,0 +1,17 @@
+[**CBIO Node Runtime Agent API v1.45.2**](../README.md)
+
+***
+
+# Function: createVaultCore()
+
+> **createVaultCore**(`deps`): [`VaultCore`](../interfaces/VaultCore.md)
+
+## Parameters
+
+### deps
+
+[`VaultCoreDependencies`](../interfaces/VaultCoreDependencies.md)
+
+## Returns
+
+[`VaultCore`](../interfaces/VaultCore.md)

package/docs/api/functions/createVaultService.md

@@ -0,0 +1,31 @@
+[**CBIO Node Runtime Agent API v1.45.2**](../README.md)
+
+***
+
+# Function: createVaultService()
+
+> **createVaultService**(`deps`, `options?`): [`VaultService`](../interfaces/VaultService.md)
+
+## Parameters
+
+### deps
+
+[`VaultCoreDependencies`](../interfaces/VaultCoreDependencies.md)
+
+### options?
+
+#### clock?
+
+[`Clock`](../interfaces/Clock.md)
+
+#### customFlows?
+
+[`VaultCustomFlowResolver`](../interfaces/VaultCustomFlowResolver.md)
+
+#### fetchImpl?
+
+\{(`input`, `init?`): `Promise`\<`Response`\>; (`input`, `init?`): `Promise`\<`Response`\>; \}
+
+## Returns
+
+[`VaultService`](../interfaces/VaultService.md)

package/docs/api/functions/createWorkspaceStorage.md

@@ -0,0 +1,17 @@
+[**CBIO Node Runtime Agent API v1.45.2**](../README.md)
+
+***
+
+# Function: createWorkspaceStorage()
+
+> **createWorkspaceStorage**(`baseDir?`): [`FsStorageProvider`](../classes/FsStorageProvider.md)
+
+## Parameters
+
+### baseDir?
+
+`string` = `...`
+
+## Returns
+
+[`FsStorageProvider`](../classes/FsStorageProvider.md)

package/docs/api/functions/deriveChildIdentity.md

@@ -0,0 +1,41 @@
+[**CBIO Node Runtime Agent API v1.45.2**](../README.md)
+
+***
+
+# Function: deriveChildIdentity()
+
+> **deriveChildIdentity**(`parent`, `childIndex`, `options?`): [`ChildIdentity`](../interfaces/ChildIdentity.md)
+
+Deterministically derives a child identity from a parent's private key and an index.
+
+## Parameters
+
+### parent
+
+`string` \| `CreatedIdentity`
+
+The parent identity object or its private key string.
+
+### childIndex
+
+`number`
+
+A non-negative integer for derivation.
+
+### options?
+
+[`DeriveIdentityOptions`](../interfaces/DeriveIdentityOptions.md) = `{}`
+
+Optional nickname for the child.
+
+## Returns
+
+[`ChildIdentity`](../interfaces/ChildIdentity.md)
+
+A [ChildIdentity](../interfaces/ChildIdentity.md) with derivation metadata.
+
+## Example
+
+```ts
+const child = deriveChildIdentity(parentIdentity, 0, { nickname: 'sub-agent-0' });
+```

package/docs/api/functions/deriveIdentityId.md

@@ -0,0 +1,17 @@
+[**CBIO Node Runtime Agent API v1.45.2**](../README.md)
+
+***
+
+# Function: deriveIdentityId()
+
+> **deriveIdentityId**(`publicKey`): `string`
+
+## Parameters
+
+### publicKey
+
+`string`
+
+## Returns
+
+`string`

package/docs/api/functions/ensureIdentityPrivateVault.md

@@ -0,0 +1,21 @@
+[**CBIO Node Runtime Agent API v1.45.2**](../README.md)
+
+***
+
+# Function: ensureIdentityPrivateVault()
+
+> **ensureIdentityPrivateVault**(`storage`, `identity`): `Promise`\<`void`\>
+
+## Parameters
+
+### storage
+
+[`IStorageProvider`](../interfaces/IStorageProvider.md)
+
+### identity
+
+`CreatedIdentity`
+
+## Returns
+
+`Promise`\<`void`\>

package/docs/api/functions/getDefaultWorkspaceDir.md

@@ -0,0 +1,11 @@
+[**CBIO Node Runtime Agent API v1.45.2**](../README.md)
+
+***
+
+# Function: getDefaultWorkspaceDir()
+
+> **getDefaultWorkspaceDir**(): `string`
+
+## Returns
+
+`string`

package/docs/api/functions/handleVaultHttpDispatch.md

@@ -0,0 +1,30 @@
+[**CBIO Node Runtime Agent API v1.45.2**](../README.md)
+
+***
+
+# Function: handleVaultHttpDispatch()
+
+> **handleVaultHttpDispatch**(`service`, `body`): `Promise`\<[`VaultAgentDispatchResponse`](../interfaces/VaultAgentDispatchResponse.md) \| [`VaultAgentDispatchErrorResponse`](../interfaces/VaultAgentDispatchErrorResponse.md)\>
+
+Standard server-side helper to handle a vault agent dispatch request from an HTTP body.
+This can be used in any HTTP server framework (Express, Fastify, etc.).
+
+## Parameters
+
+### service
+
+[`VaultService`](../interfaces/VaultService.md)
+
+The VaultService instance to handle the request.
+
+### body
+
+`unknown`
+
+The parsed JSON body of the incoming HTTP request.
+
+## Returns
+
+`Promise`\<[`VaultAgentDispatchResponse`](../interfaces/VaultAgentDispatchResponse.md) \| [`VaultAgentDispatchErrorResponse`](../interfaces/VaultAgentDispatchErrorResponse.md)\>
+
+A JSON-serializable response object.

package/docs/api/functions/identityPrivateVaultChildrenKey.md

@@ -0,0 +1,17 @@
+[**CBIO Node Runtime Agent API v1.45.2**](../README.md)
+
+***
+
+# Function: identityPrivateVaultChildrenKey()
+
+> **identityPrivateVaultChildrenKey**(`identityId`): `string`
+
+## Parameters
+
+### identityId
+
+`string`
+
+## Returns
+
+`string`

package/docs/api/functions/identityPrivateVaultPrefix.md

@@ -0,0 +1,17 @@
+[**CBIO Node Runtime Agent API v1.45.2**](../README.md)
+
+***
+
+# Function: identityPrivateVaultPrefix()
+
+> **identityPrivateVaultPrefix**(`identityId`): `string`
+
+## Parameters
+
+### identityId
+
+`string`
+
+## Returns
+
+`string`

package/docs/api/functions/identityPrivateVaultProfileKey.md

@@ -0,0 +1,17 @@
+[**CBIO Node Runtime Agent API v1.45.2**](../README.md)
+
+***
+
+# Function: identityPrivateVaultProfileKey()
+
+> **identityPrivateVaultProfileKey**(`identityId`): `string`
+
+## Parameters
+
+### identityId
+
+`string`
+
+## Returns
+
+`string`

package/docs/api/functions/identityPrivateVaultPublicSealedKey.md

@@ -0,0 +1,17 @@
+[**CBIO Node Runtime Agent API v1.45.2**](../README.md)
+
+***
+
+# Function: identityPrivateVaultPublicSealedKey()
+
+> **identityPrivateVaultPublicSealedKey**(`identityId`): `string`
+
+## Parameters
+
+### identityId
+
+`string`
+
+## Returns
+
+`string`

package/docs/api/functions/initializeVaultCustody.md

@@ -0,0 +1,21 @@
+[**CBIO Node Runtime Agent API v1.45.2**](../README.md)
+
+***
+
+# Function: initializeVaultCustody()
+
+> **initializeVaultCustody**(`storage`, `options?`): `Promise`\<[`InitializedVaultCustody`](../interfaces/InitializedVaultCustody.md)\>
+
+## Parameters
+
+### storage
+
+[`IStorageProvider`](../interfaces/IStorageProvider.md)
+
+### options?
+
+[`InitializeVaultCustodyOptions`](../interfaces/InitializeVaultCustodyOptions.md) = `{}`
+
+## Returns
+
+`Promise`\<[`InitializedVaultCustody`](../interfaces/InitializedVaultCustody.md)\>

package/docs/api/functions/listIdentities.md

@@ -0,0 +1,19 @@
+[**CBIO Node Runtime Agent API v1.45.2**](../README.md)
+
+***
+
+# Function: listIdentities()
+
+> **listIdentities**(`storage`): `Promise`\<`any`[]\>
+
+Lists all identities in the workspace with their discovery metadata.
+
+## Parameters
+
+### storage
+
+[`IStorageProvider`](../interfaces/IStorageProvider.md)
+
+## Returns
+
+`Promise`\<`any`[]\>

package/docs/api/functions/listVaults.md

@@ -0,0 +1,23 @@
+[**CBIO Node Runtime Agent API v1.45.2**](../README.md)
+
+***
+
+# Function: listVaults()
+
+> **listVaults**(`storage`): `Promise`\<`object`[]\>
+
+Lists all available vaults in the workspace by scanning for signed profiles.
+
+## Parameters
+
+### storage
+
+[`IStorageProvider`](../interfaces/IStorageProvider.md)
+
+The root workspace storage provider.
+
+## Returns
+
+`Promise`\<`object`[]\>
+
+A list of vault IDs and their public discovery metadata.