\n
TypeScript
\n\n\n\n```typescript\nconst session = await client.createSession({\n onPermissionRequest: approveAll,\n enableCitations: true,\n});\n\nconst resumed = await client.resumeSession(session.sessionId, {\n onPermissionRequest: approveAll,\n enableCitations: true,\n});\n```\n\n
\n\n
Python
\n\n\n\n```python\nsession = await client.create_session(\n on_permission_request=PermissionHandler.approve_all,\n enable_citations=True,\n)\n\nresumed = await client.resume_session(\n session.session_id,\n on_permission_request=PermissionHandler.approve_all,\n enable_citations=True,\n)\n```\n\n
\n\n
Go
\n\n\n\n```golang\nsession, err := client.CreateSession(ctx, &copilot.SessionConfig{\n OnPermissionRequest: copilot.PermissionHandler.ApproveAll,\n EnableCitations: copilot.Bool(true),\n})\n\nresumed, err := client.ResumeSession(ctx, session.SessionID, &copilot.ResumeSessionConfig{\n OnPermissionRequest: copilot.PermissionHandler.ApproveAll,\n EnableCitations: copilot.Bool(true),\n})\n```\n\n
\n\n
.NET
\n\n\n\n```csharp\nvar session = await client.CreateSessionAsync(new SessionConfig\n{\n OnPermissionRequest = PermissionHandler.ApproveAll,\n EnableCitations = true,\n});\n\nvar resumed = await client.ResumeSessionAsync(session.SessionId, new ResumeSessionConfig\n{\n OnPermissionRequest = PermissionHandler.ApproveAll,\n EnableCitations = true,\n});\n```\n\n
\n\n
Java
\n\n\n\n```java\nCopilotSession session = client\n .createSession(new SessionConfig()\n .setOnPermissionRequest(PermissionHandler.APPROVE_ALL)\n .setEnableCitations(true))\n .get();\n\nCopilotSession resumed = client\n .resumeSession(session.getSessionId(), new ResumeSessionConfig()\n .setOnPermissionRequest(PermissionHandler.APPROVE_ALL)\n .setEnableCitations(true))\n .get();\n```\n\n
\n\n
Rust
\n\n\n\n```rust\nlet session = client\n .create_session(\n SessionConfig::new()\n .approve_all_permissions()\n .with_enable_citations(true),\n )\n .await?;\n\nlet resumed = client\n .resume_session(\n ResumeSessionConfig::new(session.id().clone())\n .approve_all_permissions()\n .with_enable_citations(true),\n )\n .await?;\n```\n\n
\n\n
\n
TypeScript
\n\n\n\n```typescript\nsession.on((event) => {\n if (event.type !== \"assistant.message\" || !event.data.citations) {\n return;\n }\n\n const { sources, spans } = event.data.citations;\n const sourceById = new Map(sources.map((source) => [source.id, source]));\n\n for (const span of spans) {\n const quoted = event.data.content.slice(span.startIndex, span.endIndex);\n for (const reference of span.references) {\n const source = sourceById.get(reference.sourceId);\n const label = source?.title ?? source?.url ?? source?.path ?? source?.id;\n console.log(`\"${quoted}\" — ${label}`);\n }\n }\n});\n```\n\n
\n\n
Python
\n\n\n\n```python\nfrom copilot.session_events import SessionEventType\n\ndef utf16_slice(text: str, start: int, end: int) -> str:\n \"\"\"Slice by UTF-16 code units, which is how span offsets are measured.\"\"\"\n units = text.encode(\"utf-16-le\")\n return units[start * 2 : end * 2].decode(\"utf-16-le\")\n\ndef handle(event):\n if event.type != SessionEventType.ASSISTANT_MESSAGE or not event.data.citations:\n return\n\n sources = {source.id: source for source in event.data.citations.sources}\n\n for span in event.data.citations.spans:\n quoted = utf16_slice(event.data.content, span.start_index, span.end_index)\n for reference in span.references:\n source = sources[reference.source_id]\n label = source.title or source.url or source.path or source.id\n print(f'\"{quoted}\" — {label}')\n\nsession.on(handle)\n```\n\n
\n\n
Go
\n\n\n\n```golang\n// import \"unicode/utf16\"\n\nsession.On(func(event copilot.SessionEvent) {\n d, ok := event.Data.(*copilot.AssistantMessageData)\n if !ok || d.Citations == nil {\n return\n }\n\n sources := map[string]copilot.CitationSource{}\n for _, source := range d.Citations.Sources {\n sources[source.ID] = source\n }\n\n // Span offsets are UTF-16 code units, so index the UTF-16 view of the content.\n units := utf16.Encode([]rune(d.Content))\n\n for _, span := range d.Citations.Spans {\n quoted := string(utf16.Decode(units[span.StartIndex:span.EndIndex]))\n for _, reference := range span.References {\n source := sources[reference.SourceID]\n label := source.ID\n switch {\n case source.Title != nil:\n label = *source.Title\n case source.URL != nil:\n label = *source.URL\n case source.Path != nil:\n label = *source.Path\n }\n fmt.Printf(\"%q — %s\\n\", quoted, label)\n }\n }\n})\n```\n\n
\n\n
.NET
\n\n\n\n```csharp\nsession.On
(evt =>\n{\n if (evt is not AssistantMessageEvent message || message.Data.Citations is null)\n {\n return;\n }\n\n var sources = message.Data.Citations.Sources.ToDictionary(source => source.Id);\n\n foreach (var span in message.Data.Citations.Spans)\n {\n var quoted = message.Data.Content[(int)span.StartIndex..(int)span.EndIndex];\n foreach (var reference in span.References)\n {\n var source = sources[reference.SourceId];\n var label = source.Title ?? source.Url ?? source.Path ?? source.Id;\n Console.WriteLine($\"\\\"{quoted}\\\" — {label}\");\n }\n }\n});\n```\n\n\n\n
Java
\n\n\n\n```java\nsession.on(AssistantMessageEvent.class, event -> {\n Citations citations = event.getData().citations();\n if (citations == null) {\n return;\n }\n\n Map
sources = citations.sources().stream()\n .collect(Collectors.toMap(CitationSource::id, source -> source));\n\n for (CitationSpan span : citations.spans()) {\n String quoted = event.getData().content()\n .substring(span.startIndex().intValue(), span.endIndex().intValue());\n for (CitationReference reference : span.references()) {\n CitationSource source = sources.get(reference.sourceId());\n String label = source.title() != null ? source.title()\n : source.url() != null ? source.url()\n : source.path() != null ? source.path()\n : source.id();\n System.out.printf(\"\\\"%s\\\" — %s%n\", quoted, label);\n }\n }\n});\n```\n\n\n\n
Rust
\n\n\n\n```rust\nuse github_copilot_sdk::session_events::AssistantMessageData;\nuse std::collections::HashMap;\n\nlet mut events = session.subscribe();\n\nwhile let Ok(event) = events.recv().await {\n if event.event_type != \"assistant.message\" {\n continue;\n }\n\n let Some(data) = event.typed_data::
() else {\n continue;\n };\n let Some(citations) = data.citations.as_ref() else {\n continue;\n };\n\n let sources: HashMap<&str, _> = citations\n .sources\n .iter()\n .map(|source| (source.id.as_str(), source))\n .collect();\n\n // Span offsets are UTF-16 code units, so index the UTF-16 view of the content.\n let units: Vec = data.content.encode_utf16().collect();\n\n for span in &citations.spans {\n let quoted = String::from_utf16_lossy(\n &units[span.start_index as usize..span.end_index as usize],\n );\n for reference in &span.references {\n let Some(source) = sources.get(reference.source_id.as_str()) else {\n continue;\n };\n let label = source\n .title\n .as_deref()\n .or(source.url.as_deref())\n .or(source.path.as_deref())\n .unwrap_or(source.id.as_str());\n println!(\"\\\"{quoted}\\\" — {label}\");\n }\n }\n}\n```\n\n\n\n