> ## Documentation Index
> Fetch the complete documentation index at: https://docs.parmanasystems.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Class: ParmanaClient

Defined in: [typescript/src/client/ParmanaClient.ts:73](https://github.com/pavancharak/AgentLabsBuildathon/blob/main/typescript/src/client/ParmanaClient.ts#L73)

Canonical Parmana SDK client.

## Constructors

### Constructor

> **new ParmanaClient**(`configuration`): `ParmanaClient`

Defined in: [typescript/src/client/ParmanaClient.ts:142](https://github.com/pavancharak/AgentLabsBuildathon/blob/main/typescript/src/client/ParmanaClient.ts#L142)

Creates a Parmana SDK client.

#### Parameters

##### configuration

[`Configuration`](/sdks/reference/typescript/interfaces/Configuration)

#### Returns

`ParmanaClient`

## Properties

### configuration

> `readonly` **configuration**: [`Configuration`](/sdks/reference/typescript/interfaces/Configuration)

Defined in: [typescript/src/client/ParmanaClient.ts:77](https://github.com/pavancharak/AgentLabsBuildathon/blob/main/typescript/src/client/ParmanaClient.ts#L77)

Immutable SDK configuration.

## Methods

### endpoint()

> **endpoint**(): `string`

Defined in: [typescript/src/client/ParmanaClient.ts:180](https://github.com/pavancharak/AgentLabsBuildathon/blob/main/typescript/src/client/ParmanaClient.ts#L180)

Returns the configured Runtime endpoint.

#### Returns

`string`

***

### health()

> **health**(): `Promise`\<`HealthStatus`>

Defined in: [typescript/src/client/ParmanaClient.ts:187](https://github.com/pavancharak/AgentLabsBuildathon/blob/main/typescript/src/client/ParmanaClient.ts#L187)

Performs a Runtime health check.

#### Returns

`Promise`\<`HealthStatus`>

***

### version()

> **version**(): `Promise`\<`unknown`>

Defined in: [typescript/src/client/ParmanaClient.ts:194](https://github.com/pavancharak/AgentLabsBuildathon/blob/main/typescript/src/client/ParmanaClient.ts#L194)

Returns the Runtime name, version, and API version.

#### Returns

`Promise`\<`unknown`>

***

### execute()

> **execute**(`transaction`): `Promise`\<[`ExecutionTrustRecord`](/sdks/reference/typescript/interfaces/ExecutionTrustRecord)>

Defined in: [typescript/src/client/ParmanaClient.ts:201](https://github.com/pavancharak/AgentLabsBuildathon/blob/main/typescript/src/client/ParmanaClient.ts#L201)

Executes a Business Transaction.

#### Parameters

##### transaction

[`BusinessTransaction`](/sdks/reference/typescript/interfaces/BusinessTransaction)

#### Returns

`Promise`\<[`ExecutionTrustRecord`](/sdks/reference/typescript/interfaces/ExecutionTrustRecord)>

***

### verify()

> **verify**(`businessTransactionId`): `Promise`\<[`Verification`](/sdks/reference/typescript/interfaces/Verification)>

Defined in: [typescript/src/client/ParmanaClient.ts:213](https://github.com/pavancharak/AgentLabsBuildathon/blob/main/typescript/src/client/ParmanaClient.ts#L213)

Runs a fresh verification of an Execution Trust Record, appending a
new Verification to its history. Distinct from
getLatestVerification(), which reads the most recent one without
re-verifying.

#### Parameters

##### businessTransactionId

`string`

#### Returns

`Promise`\<[`Verification`](/sdks/reference/typescript/interfaces/Verification)>

***

### getLatestVerification()

> **getLatestVerification**(`businessTransactionId`): `Promise`\<[`Verification`](/sdks/reference/typescript/interfaces/Verification)>

Defined in: [typescript/src/client/ParmanaClient.ts:220](https://github.com/pavancharak/AgentLabsBuildathon/blob/main/typescript/src/client/ParmanaClient.ts#L220)

Returns the latest Verification.

#### Parameters

##### businessTransactionId

`string`

#### Returns

`Promise`\<[`Verification`](/sdks/reference/typescript/interfaces/Verification)>

***

### replay()

> **replay**(`businessTransactionId`): `Promise`\<[`ReplayResult`](/sdks/reference/typescript/interfaces/ReplayResult)>

Defined in: [typescript/src/client/ParmanaClient.ts:229](https://github.com/pavancharak/AgentLabsBuildathon/blob/main/typescript/src/client/ParmanaClient.ts#L229)

Performs deterministic replay.

#### Parameters

##### businessTransactionId

`string`

#### Returns

`Promise`\<[`ReplayResult`](/sdks/reference/typescript/interfaces/ReplayResult)>

***

### receipt()

> **receipt**(`businessTransactionId`): `Promise`\<[`Receipt`](/sdks/reference/typescript/interfaces/Receipt)>

Defined in: [typescript/src/client/ParmanaClient.ts:236](https://github.com/pavancharak/AgentLabsBuildathon/blob/main/typescript/src/client/ParmanaClient.ts#L236)

Generates an execution receipt.

#### Parameters

##### businessTransactionId

`string`

#### Returns

`Promise`\<[`Receipt`](/sdks/reference/typescript/interfaces/Receipt)>

***

### createTransaction()

> **createTransaction**(`transaction`): `Promise`\<[`ExecutionTrustRecord`](/sdks/reference/typescript/interfaces/ExecutionTrustRecord)>

Defined in: [typescript/src/client/ParmanaClient.ts:245](https://github.com/pavancharak/AgentLabsBuildathon/blob/main/typescript/src/client/ParmanaClient.ts#L245)

Creates (executes) a Business Transaction via POST /transactions,
a second, independent entry point into the identical execution
pipeline as execute() (POST /execute). See TransactionApi.create.

#### Parameters

##### transaction

[`BusinessTransaction`](/sdks/reference/typescript/interfaces/BusinessTransaction)

#### Returns

`Promise`\<[`ExecutionTrustRecord`](/sdks/reference/typescript/interfaces/ExecutionTrustRecord)>

***

### transaction()

> **transaction**(`businessTransactionId`): `Promise`\<[`BusinessTransaction`](/sdks/reference/typescript/interfaces/BusinessTransaction)>

Defined in: [typescript/src/client/ParmanaClient.ts:254](https://github.com/pavancharak/AgentLabsBuildathon/blob/main/typescript/src/client/ParmanaClient.ts#L254)

Retrieves a Business Transaction.

#### Parameters

##### businessTransactionId

`string`

#### Returns

`Promise`\<[`BusinessTransaction`](/sdks/reference/typescript/interfaces/BusinessTransaction)>

***

### transactions()

> **transactions**(`page?`, `pageSize?`): `Promise`\<[`BusinessTransaction`](/sdks/reference/typescript/interfaces/BusinessTransaction)\[]>

Defined in: [typescript/src/client/ParmanaClient.ts:263](https://github.com/pavancharak/AgentLabsBuildathon/blob/main/typescript/src/client/ParmanaClient.ts#L263)

Lists Business Transactions.

#### Parameters

##### page?

`number` = `1`

##### pageSize?

`number` = `25`

#### Returns

`Promise`\<[`BusinessTransaction`](/sdks/reference/typescript/interfaces/BusinessTransaction)\[]>

***

### trustRecord()

> **trustRecord**(`businessTransactionId`): `Promise`\<[`ExecutionTrustRecord`](/sdks/reference/typescript/interfaces/ExecutionTrustRecord)>

Defined in: [typescript/src/client/ParmanaClient.ts:270](https://github.com/pavancharak/AgentLabsBuildathon/blob/main/typescript/src/client/ParmanaClient.ts#L270)

Retrieves an Execution Trust Record.

#### Parameters

##### businessTransactionId

`string`

#### Returns

`Promise`\<[`ExecutionTrustRecord`](/sdks/reference/typescript/interfaces/ExecutionTrustRecord)>

***

### validatePolicy()

> **validatePolicy**(`policyId`, `policyVersion`): `Promise`\<[`PolicyValidationResult`](/sdks/reference/typescript/interfaces/PolicyValidationResult)>

Defined in: [typescript/src/client/ParmanaClient.ts:279](https://github.com/pavancharak/AgentLabsBuildathon/blob/main/typescript/src/client/ParmanaClient.ts#L279)

Confirms that a policy (name + version) is loadable by the Runtime.

#### Parameters

##### policyId

`string`

##### policyVersion

`string`

#### Returns

`Promise`\<[`PolicyValidationResult`](/sdks/reference/typescript/interfaces/PolicyValidationResult)>

***

### refusalRecord()

> **refusalRecord**(`businessTransactionId`): `Promise`\<[`RefusalRecord`](/sdks/reference/typescript/interfaces/RefusalRecord)>

Defined in: [typescript/src/client/ParmanaClient.ts:289](https://github.com/pavancharak/AgentLabsBuildathon/blob/main/typescript/src/client/ParmanaClient.ts#L289)

Retrieves a Refusal Record by Business Transaction ID.

#### Parameters

##### businessTransactionId

`string`

#### Returns

`Promise`\<[`RefusalRecord`](/sdks/reference/typescript/interfaces/RefusalRecord)>

***

### verifyRefusalRecord()

> **verifyRefusalRecord**(`record`): `Promise`\<`boolean`>

Defined in: [typescript/src/client/ParmanaClient.ts:296](https://github.com/pavancharak/AgentLabsBuildathon/blob/main/typescript/src/client/ParmanaClient.ts#L296)

Verifies a Refusal Record's signature.

#### Parameters

##### record

[`RefusalRecord`](/sdks/reference/typescript/interfaces/RefusalRecord)

#### Returns

`Promise`\<`boolean`>

***

### executionIntent()

> **executionIntent**(`businessTransactionId`): `Promise`\<[`ExecutionIntentView`](/sdks/reference/typescript/interfaces/ExecutionIntentView)>

Defined in: [typescript/src/client/ParmanaClient.ts:305](https://github.com/pavancharak/AgentLabsBuildathon/blob/main/typescript/src/client/ParmanaClient.ts#L305)

Retrieves an Execution Intent and its status by Business Transaction ID
(ADR-0012). The intent is the signed statement, stored before an action is
released, of what was about to be released.

#### Parameters

##### businessTransactionId

`string`

#### Returns

`Promise`\<[`ExecutionIntentView`](/sdks/reference/typescript/interfaces/ExecutionIntentView)>

***

### verifyExecutionIntent()

> **verifyExecutionIntent**(`intent`): `Promise`\<`boolean`>

Defined in: [typescript/src/client/ParmanaClient.ts:316](https://github.com/pavancharak/AgentLabsBuildathon/blob/main/typescript/src/client/ParmanaClient.ts#L316)

Verifies an Execution Intent's hash and signature. Needs no credential.
`true` proves the intent is genuine and unaltered. It does not prove the
action was released, or what its result was.

#### Parameters

##### intent

[`ExecutionIntent`](/sdks/reference/typescript/interfaces/ExecutionIntent)

#### Returns

`Promise`\<`boolean`>

***

### unfinalizedExecutionIntents()

> **unfinalizedExecutionIntents**(`limit?`): `Promise`\<[`UnfinalizedExecutionIntents`](/sdks/reference/typescript/interfaces/UnfinalizedExecutionIntents)>

Defined in: [typescript/src/client/ParmanaClient.ts:325](https://github.com/pavancharak/AgentLabsBuildathon/blob/main/typescript/src/client/ParmanaClient.ts#L325)

Lists Execution Intents that never reached a signed Trust Record and were
not closed by hand, oldest first. Needs a credential provisioned as a
verified human.

#### Parameters

##### limit?

`number`

#### Returns

`Promise`\<[`UnfinalizedExecutionIntents`](/sdks/reference/typescript/interfaces/UnfinalizedExecutionIntents)>

***

### finalizeExecutionIntent()

> **finalizeExecutionIntent**(`businessTransactionId`): `Promise`\<[`FinalizeExecutionIntentResult`](/sdks/reference/typescript/interfaces/FinalizeExecutionIntentResult)>

Defined in: [typescript/src/client/ParmanaClient.ts:336](https://github.com/pavancharak/AgentLabsBuildathon/blob/main/typescript/src/client/ParmanaClient.ts#L336)

Rebuilds the signed Trust Record for a released action whose record was
never produced. Never calls a connector. Safe to run twice. Needs a
credential provisioned as a verified human.

#### Parameters

##### businessTransactionId

`string`

#### Returns

`Promise`\<[`FinalizeExecutionIntentResult`](/sdks/reference/typescript/interfaces/FinalizeExecutionIntentResult)>

***

### resolveExecutionIntent()

> **resolveExecutionIntent**(`businessTransactionId`, `input`): `Promise`\<[`ResolveExecutionIntentResult`](/sdks/reference/typescript/interfaces/ResolveExecutionIntentResult)>

Defined in: [typescript/src/client/ParmanaClient.ts:347](https://github.com/pavancharak/AgentLabsBuildathon/blob/main/typescript/src/client/ParmanaClient.ts#L347)

Closes a PREPARED or ERRORED intent that a verified human reconciled at the
connector. The note is required. The resolution is an attributed operator
statement in unsigned status, not a Trust Record.

#### Parameters

##### businessTransactionId

`string`

##### input

[`ResolveExecutionIntentInput`](/sdks/reference/typescript/interfaces/ResolveExecutionIntentInput)

#### Returns

`Promise`\<[`ResolveExecutionIntentResult`](/sdks/reference/typescript/interfaces/ResolveExecutionIntentResult)>

***

### verifyAuditEvent()

> **verifyAuditEvent**(`event`, `signature`): `Promise`\<`boolean`>

Defined in: [typescript/src/client/ParmanaClient.ts:357](https://github.com/pavancharak/AgentLabsBuildathon/blob/main/typescript/src/client/ParmanaClient.ts#L357)

Verifies a signed caller-authentication audit event's signature.

#### Parameters

##### event

[`AuditEvent`](/sdks/reference/typescript/interfaces/AuditEvent)

##### signature

[`Signature`](/sdks/reference/typescript/interfaces/Signature)

#### Returns

`Promise`\<`boolean`>