diff --git a/apps/android/tests/markdown-links.test.ts b/apps/android/tests/markdown-links.test.ts
new file mode 100644
index 0000000..78d4746
--- /dev/null
+++ b/apps/android/tests/markdown-links.test.ts
@@ -0,0 +1,260 @@
+import { beforeEach, describe, expect, it, vi } from 'vitest'
+
+const { openURLMock } = vi.hoisted(() => ({
+ openURLMock: vi.fn(() => Promise.resolve(true)),
+}))
+
+vi.mock('react-native', () => ({
+ Linking: {
+ openURL: openURLMock,
+ canOpenURL: vi.fn(() => Promise.resolve(true)),
+ },
+}))
+
+import {
+ createMarkdownParser,
+ decodeSessionMentionUri,
+ markdownFilePath,
+ openSafeExternalUrl,
+} from '../src/ui/link-helpers'
+
+const parser = createMarkdownParser()
+
+function collectLinkHrefs(source: string): string[] {
+ const hrefs: string[] = []
+ for (const token of parser.parse(source, {})) {
+ for (const child of token.children ?? []) {
+ if (child.type !== 'link_open') continue
+ const href = child.attrGet('href')
+ if (href !== null) hrefs.push(href)
+ }
+ }
+ return hrefs
+}
+
+/** Mirror of the app-side encoder: base64/padded and base64url/unpadded. */
+function mentionFromJson(json: string, unpadded = false): string {
+ const base64 = Buffer.from(json, 'utf8').toString('base64')
+ if (!unpadded) return `dsh-session:${base64}`
+ return `dsh-session:${base64.replace(/=+$/u, '').replace(/\+/gu, '-').replace(/\//gu, '_')}`
+}
+
+function sessionMention(sessionId: string, unpadded = false): string {
+ return mentionFromJson(JSON.stringify(sessionId), unpadded)
+}
+
+describe('openSafeExternalUrl', () => {
+ beforeEach(() => {
+ openURLMock.mockReset()
+ openURLMock.mockImplementation(() => Promise.resolve(true))
+ })
+
+ it('opens https and http links', () => {
+ expect(openSafeExternalUrl('https://example.com/docs')).toBe(true)
+ expect(openURLMock).toHaveBeenLastCalledWith('https://example.com/docs')
+
+ expect(openSafeExternalUrl('http://example.com')).toBe(true)
+ expect(openURLMock).toHaveBeenLastCalledWith('http://example.com')
+ })
+
+ it('matches schemes case-insensitively', () => {
+ expect(openSafeExternalUrl('HTTPS://EXAMPLE.COM/A')).toBe(true)
+ expect(openURLMock).toHaveBeenLastCalledWith('HTTPS://EXAMPLE.COM/A')
+ })
+
+ it('opens mailto links', () => {
+ expect(openSafeExternalUrl('mailto:dev@example.com')).toBe(true)
+ expect(openURLMock).toHaveBeenLastCalledWith('mailto:dev@example.com')
+ })
+
+ it('upgrades a bare www host to https', () => {
+ expect(openSafeExternalUrl('www.example.com/docs')).toBe(true)
+ expect(openURLMock).toHaveBeenLastCalledWith('https://www.example.com/docs')
+ })
+
+ it('trims surrounding whitespace', () => {
+ expect(openSafeExternalUrl(' https://example.com ')).toBe(true)
+ expect(openURLMock).toHaveBeenLastCalledWith('https://example.com')
+ })
+
+ it.each([
+ 'javascript:alert(1)',
+ 'JavaScript:alert(1)',
+ 'data:text/html,x',
+ 'vbscript:msgbox(1)',
+ 'intent://scan#Intent;scheme=zxing;end',
+ 'file:///workspace/src/index.ts',
+ 'dsh-session:eyJhIjoxfQ==',
+ '',
+ ' ',
+ ])('rejects %p without calling the opener', (url) => {
+ expect(openSafeExternalUrl(url)).toBe(false)
+ expect(openURLMock).not.toHaveBeenCalled()
+ })
+
+ it('reports "attempted" and swallows a rejected openURL promise', async () => {
+ openURLMock.mockImplementationOnce(() => Promise.reject(new Error('no handler')))
+
+ expect(openSafeExternalUrl('https://example.com')).toBe(true)
+
+ await Promise.resolve()
+ expect(openURLMock).toHaveBeenCalledTimes(1)
+ })
+})
+
+describe('markdownFilePath', () => {
+ it('keeps workspace-relative paths', () => {
+ expect(markdownFilePath('src/index.ts')).toBe('src/index.ts')
+ expect(markdownFilePath('docs/guide.md')).toBe('docs/guide.md')
+ })
+
+ it('strips a leading ./', () => {
+ expect(markdownFilePath('./src/index.ts')).toBe('src/index.ts')
+ expect(markdownFilePath('./')).toBeUndefined()
+ })
+
+ it('percent-decodes path segments', () => {
+ expect(markdownFilePath('docs/My%20File.md')).toBe('docs/My File.md')
+ expect(markdownFilePath('./docs/a%23b.md')).toBe('docs/a#b.md')
+ })
+
+ it('rejects malformed percent-encoding', () => {
+ expect(markdownFilePath('docs/%ZZ.md')).toBeUndefined()
+ expect(markdownFilePath('docs/%E0%A4%A.md')).toBeUndefined()
+ })
+
+ it('removes query strings and fragments', () => {
+ expect(markdownFilePath('src/index.ts?view=raw')).toBe('src/index.ts')
+ expect(markdownFilePath('src/index.ts#L10')).toBe('src/index.ts')
+ expect(markdownFilePath('src/index.ts?view=raw#L10')).toBe('src/index.ts')
+ })
+
+ it('returns absolute paths unchanged', () => {
+ expect(markdownFilePath('/workspace/src/index.ts')).toBe('/workspace/src/index.ts')
+ })
+
+ it('normalizes file: URLs', () => {
+ expect(markdownFilePath('file:///workspace/src/index.ts')).toBe('/workspace/src/index.ts')
+ expect(markdownFilePath('file:///C:/repo/src/index.ts')).toBe('C:/repo/src/index.ts')
+ expect(markdownFilePath('file:///workspace/My%20File.md')).toBe('/workspace/My File.md')
+ })
+
+ it('accepts Windows drive paths without treating them as a scheme', () => {
+ expect(markdownFilePath('C:/repo/src/index.ts')).toBe('C:/repo/src/index.ts')
+ expect(markdownFilePath('C:/repo/docs/My%20File.md#L3')).toBe('C:/repo/docs/My File.md')
+ })
+
+ it('rejects anchors, protocol-relative paths, and empty input', () => {
+ expect(markdownFilePath('#section')).toBeUndefined()
+ expect(markdownFilePath('//host/share/file.md')).toBeUndefined()
+ expect(markdownFilePath('')).toBeUndefined()
+ expect(markdownFilePath(' ')).toBeUndefined()
+ })
+
+ it.each([
+ 'https://example.com/a.ts',
+ 'http://example.com',
+ 'mailto:dev@example.com',
+ 'data:text/plain,hello',
+ 'javascript:alert(1)',
+ 'dsh-session:eyJhIjoxfQ==',
+ ])('does not classify %p as a workspace path', (href) => {
+ expect(markdownFilePath(href)).toBeUndefined()
+ })
+})
+
+describe('decodeSessionMentionUri', () => {
+ it('decodes the JSON-encoded canonical payload', () => {
+ expect(decodeSessionMentionUri(sessionMention('session-id-123'))).toBe('session-id-123')
+ })
+
+ it('decodes base64url payloads without padding', () => {
+ expect(decodeSessionMentionUri(sessionMention('session-id-123', true))).toBe('session-id-123')
+ })
+
+ it('parses the JSON envelope instead of returning the raw payload', () => {
+ const decoded = decodeSessionMentionUri(mentionFromJson('"abc"'))
+ expect(decoded).toBe('abc')
+ expect(decoded).not.toBe('"abc"')
+ })
+
+ it('decodes non-ASCII (UTF-8) session ids', () => {
+ expect(decodeSessionMentionUri(sessionMention('会话-123'))).toBe('会话-123')
+ expect(decodeSessionMentionUri(sessionMention('séance-émoji-🚀'))).toBe('séance-émoji-🚀')
+ })
+
+ it('trims surrounding whitespace', () => {
+ expect(decodeSessionMentionUri(` ${sessionMention('abc')} `)).toBe('abc')
+ })
+
+ it.each([
+ 'dsh-session:',
+ 'dsh-session: ',
+ 'dsh-session:!!!!',
+ 'dsh-session:a',
+ 'https://example.com',
+ 'src/index.ts',
+ '',
+ ])('returns undefined for %p', (href) => {
+ expect(decodeSessionMentionUri(href)).toBeUndefined()
+ })
+
+ it('returns undefined for payloads that are not a JSON string', () => {
+ expect(decodeSessionMentionUri(mentionFromJson('not json'))).toBeUndefined()
+ expect(decodeSessionMentionUri(mentionFromJson('123'))).toBeUndefined()
+ expect(decodeSessionMentionUri(mentionFromJson('null'))).toBeUndefined()
+ expect(decodeSessionMentionUri(mentionFromJson('{"id":"abc"}'))).toBeUndefined()
+ expect(decodeSessionMentionUri(mentionFromJson('""'))).toBeUndefined()
+ })
+
+ it('returns an id that the caller may fail to resolve', () => {
+ expect(decodeSessionMentionUri(sessionMention('does-not-exist'))).toBe('does-not-exist')
+ })
+
+ it('returns undefined when the bytes are not valid UTF-8', () => {
+ const invalidUtf8 = Buffer.from([0xff, 0xfe]).toString('base64')
+ expect(decodeSessionMentionUri(`dsh-session:${invalidUtf8}`)).toBeUndefined()
+ })
+})
+
+describe('parser linkification', () => {
+ it('linkifies bare URLs in prose', () => {
+ const hrefs = collectLinkHrefs('see https://example.com/docs for details')
+ expect(hrefs).toEqual(['https://example.com/docs'])
+ })
+
+ it('linkifies bare www hosts', () => {
+ const hrefs = collectLinkHrefs('visit www.example.com for docs')
+ expect(hrefs).toHaveLength(1)
+ expect(hrefs[0] ?? '').toMatch(/^https?:\/\/www\.example\.com\/?$/u)
+ })
+
+ it('keeps explicit markdown links', () => {
+ expect(collectLinkHrefs('[docs](https://example.com/docs)')).toEqual([
+ 'https://example.com/docs',
+ ])
+ expect(collectLinkHrefs('[session](dsh-session:eyJhIjoxfQ==)')).toEqual([
+ 'dsh-session:eyJhIjoxfQ==',
+ ])
+ })
+
+ it('does not linkify inline code', () => {
+ expect(collectLinkHrefs('use `https://example.com` here')).toEqual([])
+ })
+
+ it('does not linkify fenced or indented code blocks', () => {
+ expect(collectLinkHrefs('```\nhttps://example.com\n```')).toEqual([])
+ expect(collectLinkHrefs(' https://example.com')).toEqual([])
+ })
+
+ it('does not create duplicate link tokens', () => {
+ expect(collectLinkHrefs('')).toEqual(['https://example.com'])
+ })
+
+ it('keeps raw HTML disabled', () => {
+ const tokens = parser.parse('bold', {})
+ expect(tokens.some((token) => token.type === 'html_inline' || token.type === 'html_block')).toBe(
+ false,
+ )
+ })
+})