---
title: Client reference
summary: Complete reference for every contract operation this repository calls.
status: draft
owner: SAIF.Core documentation
last_reviewed: 2026-09-24
---

# Client reference

**No operation on `AgentStateService` or `IClientAccessPolicy` is called from repository source.** This page documents all 6 declared operations — the full surface listed on [Operation map](operation-map.md#operations-present-but-not-called) and described on [Contract](contract.md#declared-operations) — each marked as unused in this repository.

---

## RegisterForRealtimeFeedOnReports

Registers a client for the unfiltered real-time feed of agent state reports.

| Field | Value |
| --- | --- |
| **Operation** | `RegisterForRealtimeFeedOnReports` |
| **Port type** | `IAgentStateService` (namespace `Silverlight`) |
| **Pattern** | Request/response |
| **Input message** | `clientToken: guid`, `requestingUserId: guid` |
| **Output message** | `RegisterForRealtimeFeedOnReportsResult: ArrayOfExtendedRealtimeUserState` |
| **Declared faults** | None declared |
| **Called in this repository** | No — no call site found in repository source (see [Operation map](operation-map.md#operations-present-but-not-called)) |
| **Source** | `Services/SAIF.Services.Web.Proxies/Service References/CallRexState/Silverlight.wsdl` |

### Notes — RegisterForRealtimeFeedOnReports
- Not called or reachable from this repository; documented from the WSDL contract only.

---

## RegisterForRealtimeFeedOnReportsFiltered

Registers a client for the real-time feed of agent state reports, filtered by location and department.

| Field | Value |
| --- | --- |
| **Operation** | `RegisterForRealtimeFeedOnReportsFiltered` |
| **Port type** | `IAgentStateService` (namespace `Silverlight`) |
| **Pattern** | Request/response |
| **Input message** | `clientToken: guid`, `requestingUserId: guid`, `locationFilter: string`, `locationBlanksOnly: boolean`, `departmentFilter: string`, `departmentBlanksOnly: boolean` |
| **Output message** | `RegisterForRealtimeFeedOnReportsFilteredResult: ArrayOfExtendedRealtimeUserState` |
| **Declared faults** | None declared |
| **Called in this repository** | No — no call site found in repository source (see [Operation map](operation-map.md#operations-present-but-not-called)) |
| **Source** | `Services/SAIF.Services.Web.Proxies/Service References/CallRexState/Silverlight.wsdl` |

### Notes — RegisterForRealtimeFeedOnReportsFiltered
- Not called or reachable from this repository; documented from the WSDL contract only.

---

## UnregisterForRealtimeFeed

Unregisters a client from the real-time agent state feed.

| Field | Value |
| --- | --- |
| **Operation** | `UnregisterForRealtimeFeed` |
| **Port type** | `IAgentStateService` (namespace `Silverlight`) |
| **Pattern** | One-way (input only) |
| **Input message** | `clientToken: guid` |
| **Output message** | — (one-way) |
| **Declared faults** | None declared |
| **Called in this repository** | No — no call site found in repository source (see [Operation map](operation-map.md#operations-present-but-not-called)) |
| **Source** | `Services/SAIF.Services.Web.Proxies/Service References/CallRexState/Silverlight.wsdl` |

### Notes — UnregisterForRealtimeFeed
- Not called or reachable from this repository; documented from the WSDL contract only.

---

## KeepAlive

Keeps a registered real-time feed subscription alive.

| Field | Value |
| --- | --- |
| **Operation** | `KeepAlive` |
| **Port type** | `IAgentStateService` (namespace `Silverlight`) |
| **Pattern** | One-way (input only) |
| **Input message** | `clientToken: guid` |
| **Output message** | — (one-way) |
| **Declared faults** | None declared |
| **Called in this repository** | No — no call site found in repository source (see [Operation map](operation-map.md#operations-present-but-not-called)) |
| **Source** | `Services/SAIF.Services.Web.Proxies/Service References/CallRexState/Silverlight.wsdl` |

### Notes — KeepAlive
- Not called or reachable from this repository; documented from the WSDL contract only.

---

## ReceiveState

Server-initiated callback that delivers a real-time user state update to the registered client.

| Field | Value |
| --- | --- |
| **Operation** | `ReceiveState` |
| **Port type** | `IAgentStateService` (namespace `Silverlight`), callback contract `IAgentStateServiceCallback` |
| **Pattern** | Callback (output-only, server → client) |
| **Input message** | — (server-initiated) |
| **Output message** | `userState: RealtimeUserState` |
| **Declared faults** | None declared |
| **Called in this repository** | No — no type in this repository implements `IAgentStateServiceCallback`, so this callback has no repository-side handler (see [Operation map](operation-map.md#operations-present-but-not-called)) |
| **Source** | `Services/SAIF.Services.Web.Proxies/Service References/CallRexState/Silverlight.wsdl` |

### Notes — ReceiveState
- Not called or reachable from this repository; documented from the WSDL contract only.
- This is a server → client callback, not a client-invoked operation; it would only be reachable if a repository type implemented `IAgentStateServiceCallback`, which none does*.

---

## GetPolicy

Returns the Silverlight cross-domain access policy document.

| Field | Value |
| --- | --- |
| **Operation** | `GetPolicy` |
| **Port type** | `IClientAccessPolicy` (namespace `http://tempuri.org/`) |
| **Pattern** | Request/response |
| **Input message** | `GetPolicy` (empty) |
| **Output message** | `GetPolicyResult: StreamBody` |
| **Declared faults** | None declared |
| **Called in this repository** | No — no call site found in repository source; also has no binding or port declared for `IClientAccessPolicy` in the WSDL (see [Operation map](operation-map.md#operations-present-but-not-called)) |
| **Source** | `Services/SAIF.Services.Web.Proxies/Service References/CallRexState/service.wsdl` |

### Notes — GetPolicy
- Not called or reachable from this repository; documented from the WSDL contract only.
- Inferred to be the conventional Silverlight cross-domain policy endpoint*; no `<wsdl:binding>` or `<wsdl:port>` is declared for `IClientAccessPolicy`, so `ClientAccessPolicyClient` has no usable endpoint from the WSDL or `app.config`.

---

## Coverage checklist

| Operation | Documented section | Called by |
| --- | --- | --- |
| `RegisterForRealtimeFeedOnReports` | [`RegisterForRealtimeFeedOnReports`](#registerforrealtimefeedonreports) | Not called |
| `RegisterForRealtimeFeedOnReportsFiltered` | [`RegisterForRealtimeFeedOnReportsFiltered`](#registerforrealtimefeedonreportsfiltered) | Not called |
| `UnregisterForRealtimeFeed` | [`UnregisterForRealtimeFeed`](#unregisterforrealtimefeed) | Not called |
| `KeepAlive` | [`KeepAlive`](#keepalive) | Not called |
| `ReceiveState` | [`ReceiveState`](#receivestate) | Not called — no callback handler implemented |
| `GetPolicy` | [`GetPolicy`](#getpolicy) | Not called |

> **Note:** Statements marked with `*` were inferred from code structure, naming
> conventions, or contextual evidence where direct confirmation was not available
> in source artifacts.

## Related documentation
- [Client index](index.md)
- [Overview](overview.md)
- [Architecture](architecture.md)
- [Contract](contract.md)
- [Operation map](operation-map.md)
- [Consumption](consumption.md)
- [Dependencies](dependencies.md)
- [Tech debt](tech-debt.md)

## Sources
- `Services/SAIF.Services.Web.Proxies/Service References/CallRexState/service.wsdl`
