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

# Session canvas

> Use SessionRpc in Laravel Copilot SDK to list and show session canvases and invoke canvas actions.

## Session canvas

Scope: SessionRpc (per-session operations tied to a Session)

For an overview of RPC and the list of all RPC pages, see [RPC](https://kawax.biz/en/packages/laravel-copilot-sdk/rpc.md).

## Session canvas

Call the Canvas RPCs from `$session->rpc()->canvas()`. `list()` returns the list in
`canvases` of a `CanvasList`, and `listOpen()` returns it in `openCanvases` of a
`CanvasListOpenResult`. `open()` returns an `OpenCanvasInstance`, and
action invocations return a `CanvasActionInvokeResult`. `close()` has no
return value.

```php theme={null}
$canvases = $session->rpc()->canvas();
$available = $canvases->list()->canvases;
$openInstances = $canvases->listOpen()->openCanvases;

$instance = $canvases->open([
    'canvasId' => 'editor',
    'instanceId' => 'editor-1',
    'input' => ['file' => 'README.md'],
]);

$result = $canvases->action()->invoke([
    'instanceId' => $instance->instanceId,
    'actionName' => 'format',
    'input' => ['style' => 'compact'],
]);

$canvases->close(['instanceId' => $instance->instanceId]);
```

Canvas provider reverse-RPCs (`canvas.open` / `canvas.close` /
`canvas.action.invoke`) are handled by `canvasHandler` in `SessionConfig` /
`ResumeSessionConfig`. Rendering the canvas is the responsibility of the host UI.


## Related topics

- [SessionConfig](https://kawax.biz/en/packages/laravel-copilot-sdk/session-config.md)
- [RPC (Remote Procedure Call)](https://kawax.biz/en/packages/laravel-copilot-sdk/rpc.md)
- [SessionRpc overview](https://kawax.biz/en/packages/laravel-copilot-sdk/rpc/session-overview.md)
- [Session](https://kawax.biz/en/session.md)
- [Remote Sessions](https://kawax.biz/en/packages/laravel-copilot-sdk/remote-sessions.md)


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