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

# LiveConnection

> A connection built from the manifest's settings.

```csharp
public sealed class LiveConnection : IDisposable
```

**Implements:** `IDisposable`

## Constructors

```csharp
public LiveConnection(ConnectorManifest manifest, string? directory = null, VendorLimits? limits = null)
```

Reads a connector's settings into a connection.

### Parameters

**manifest** `ConnectorManifest` *required*

**directory** `string`

**limits** `VendorLimits`

## Fields

**LocalFile** `string` *required*

The connector's gitignored settings file.

## Properties

**Context** `ConnectionContext` *required*

A context with working credentials.

**RefusedContext** `ConnectionContext` *required*

A context whose secret is spoiled.

**Transport** `HttpMessageHandler` *required*

The handler requests go through.

**Values** `IReadOnlyDictionary\<string, string\>` *required*

The connection's setting values.

## Methods

### Dispose()

```csharp
public void Dispose()
```

Disposes the transport.

### Keep()

```csharp
public static Task Keep(string file, string key, string value)
```

Writes one setting into a local file.

#### Parameters

**file** `string` *required*

**key** `string` *required*

**value** `string` *required*

#### Returns

`Task`

### Over()

```csharp
public ConnectionContext Over(HttpMessageHandler transport)
```

Builds a working context over a handler.

#### Parameters

**transport** `HttpMessageHandler` *required*

#### Returns

`ConnectionContext`

### ReadLocal()

```csharp
public static Dictionary<string, string?> ReadLocal(string file)
```

Reads the values in a local settings file.

#### Parameters

**file** `string` *required*

#### Returns

`Dictionary<string, string>`

### Require()

```csharp
public string Require(string key)
```

Gets a setting.

#### Parameters

**key** `string` *required*

#### Returns

`string`

### Spoiled()

```csharp
public static string Spoiled(string secret)
```

Changes one character of a secret.

#### Parameters

**secret** `string` *required*

#### Returns

`string`

### With()

```csharp
public ConnectionContext With(HttpMessageHandler transport, IReadOnlyDictionary<string, string?> values)
```

Builds a context with other setting values.

#### Parameters

**transport** `HttpMessageHandler` *required*

**values** `IReadOnlyDictionary\<string, string\>` *required*

#### Returns

`ConnectionContext`


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.