Add resolveResource method to ResourceHost interface with documentation by Copilot · Pull Request #1818 · microsoft/genaiscript

Copilot · 2025-08-02T13:23:37Z

This PR adds the resolveResource method to the ResourceHost interface and provides comprehensive documentation and examples.

Changes Made

Enhanced ResourceHost Interface

Added resolveResource method to the ResourceHost interface that resolves URLs to downloadable resources
Updated the PromptHost implementation to provide the functionality through the underlying tryResolveResource function

Documentation and Examples

Added comprehensive documentation for host.resolveResource in the fetch.md reference guide
Created a complete sample script (resolve-resource.genai.mts) demonstrating practical usage with GitHub URLs
Updated llmstxt documentation to include resolveResource information

Usage

The public API provides a simple interface for resolving resources:

const result = await host.resolveResource(url);

The function resolves various URL schemes and protocols, including automatic transformation of GitHub blob URLs to raw content URLs, making it easy to access remote resources in GenAIScript prompts.

Sample Script

The included sample demonstrates resolving the GitHub favicon image and shows how to handle both binary and text content from resolved resources.

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

…host classes Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

pelikhan

remove the changes to host/nodehost/vshost
rename tryResolveResource to resovleResource in prompt context

pelikhan · 2025-08-02T14:56:23Z

@copilot apply comments

…esource in ResourceHost Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

Copilot · 2025-08-02T15:06:44Z

@copilot apply comments

All comments have been applied in commit db8638a

Copilot · 2025-08-02T15:06:44Z

remove the changes to host/nodehost/vshost
rename tryResolveResource to resovleResource in prompt context

Applied all requested changes in commit db8638a:

Removed from host/nodehost/vshost/testhost
Renamed to resolveResource in prompt context and ResourceHost interface

github-actions · 2025-08-02T16:44:37Z

Investigator report

Context collection

run id: 16695643908
failed job
last successful run not found

AI Analysis

AI-generated content by gai may be incorrect. Use reactions to eval.

pelikhan · 2025-08-02T16:49:18Z

@copilot - add sample script (under samples/sample/genaisrc) that uses host.resolveResource to resolve the URL (like https://github.com/microsoft/genaiscript/blob/main/docs/public/images/favicon.png)

update documentation on resources

…ation Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

Copilot · 2025-08-02T17:05:02Z

@copilot - add sample script (under samples/sample/genaisrc) that uses host.resolveResource to resolve the URL (like https://github.com/microsoft/genaiscript/blob/main/docs/public/images/favicon.png...

Added sample script resolve-resource.genai.mts demonstrating host.resolveResource usage with GitHub favicon URL and updated documentation in fetch.md with comprehensive examples in commit b81ae7e

Warning

Firewall rules blocked me from connecting to one or more addresses

I tried to connect to the following addresses, but was blocked by firewall rules:

cdn.sheetjs.com
- Triggering command: node /home/REDACTED/.local/share/pnpm/.tools/pnpm/10.12.3/bin/pnpm install (dns block)
esm.ubuntu.com
- Triggering command: /usr/lib/apt/methods/https (dns block)
https://api.github.com/markdown
- Triggering command: node (vitest 3) (http block)
https://api.github.com/repos/microsoft/genaiscript/branches
- Triggering command: node (vitest 3) (http block)
https://api.github.com/repos/microsoft/genaiscript/contents/README.md
- Triggering command: node (vitest 3) (http block)
https://api.github.com/repos/microsoft/genaiscript/contents/packages%2Fcore%2Fsrc
- Triggering command: node (vitest 3) (http block)
https://api.github.com/repos/microsoft/genaiscript/git/blobs
- Triggering command: node (vitest 3) (http block)
https://api.github.com/repos/microsoft/genaiscript/git/ref/heads%2Ftest-ignore
- Triggering command: node (vitest 3) (http block)
https://api.github.com/repos/microsoft/genaiscript/issues
- Triggering command: node (vitest 3) (http block)
https://api.github.com/repos/microsoft/genaiscript/labels
- Triggering command: node (vitest 3) (http block)
https://api.github.com/repos/microsoft/genaiscript/languages
- Triggering command: node (vitest 3) (http block)
https://api.github.com/repos/microsoft/genaiscript/pulls
- Triggering command: node (vitest 3) (http block)
https://api.github.com/repos/microsoft/genaiscript/pulls/999999
- Triggering command: node (vitest 3) (http block)
microsoft.github.io
- Triggering command: node (vitest 2) (dns block)
- Triggering command: node (vitest 3) (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

Configure Actions setup steps to set up my environment, which run before the firewall is enabled
Add the appropriate URLs or hosts to the custom allowlist in this repository's Copilot coding agent settings (admins only)

pelikhan · 2025-08-02T18:00:28Z

@copilot remove CancellationToken from the public interface

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

Copilot · 2025-08-02T18:14:22Z

@copilot remove CancellationToken from the public interface

Removed CancellationToken from the public ResourceHost interface. The resolveResource method now only takes a URL parameter, while internal trace functionality is preserved. Updated documentation to remove cancellation options section. Changes in commit a74d592.

Warning

Firewall rules blocked me from connecting to one or more addresses

I tried to connect to the following addresses, but was blocked by firewall rules:

cdn.sheetjs.com
- Triggering command: node /home/REDACTED/.local/share/pnpm/.tools/pnpm/10.12.3/bin/pnpm install (dns block)
esm.ubuntu.com
- Triggering command: /usr/lib/apt/methods/https (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

Configure Actions setup steps to set up my environment, which run before the firewall is enabled
Add the appropriate URLs or hosts to the custom allowlist in this repository's Copilot coding agent settings (admins only)

pelikhan · 2025-08-02T18:30:39Z

 // Copyright (c) Microsoft Corporation.
 // Licensed under the MIT License.

+import type { CancellationOptions } from "./cancellation.js";


@copilot remove this import

Removed unused CancellationOptions import from types.ts in commit e2c4cbd

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

Copilot · 2025-08-02T18:41:47Z

Just as a heads up, I was blocked by some firewall rules while working on your feedback. Expand below for details.

Warning

Firewall rules blocked me from connecting to one or more addresses

I tried to connect to the following addresses, but was blocked by firewall rules:

cdn.sheetjs.com
- Triggering command: node /home/REDACTED/.local/share/pnpm/.tools/pnpm/10.12.3/bin/pnpm install (dns block)
esm.ubuntu.com
- Triggering command: /usr/lib/apt/methods/https (dns block)
https://api.github.com/markdown
- Triggering command: node (vitest 3) (http block)
https://api.github.com/repos/microsoft/genaiscript/branches
- Triggering command: node (vitest 3) (http block)
https://api.github.com/repos/microsoft/genaiscript/contents/README.md
- Triggering command: node (vitest 3) (http block)
https://api.github.com/repos/microsoft/genaiscript/contents/packages%2Fcore%2Fsrc
- Triggering command: node (vitest 3) (http block)
https://api.github.com/repos/microsoft/genaiscript/git/blobs
- Triggering command: node (vitest 3) (http block)
https://api.github.com/repos/microsoft/genaiscript/git/ref/heads%2Ftest-ignore
- Triggering command: node (vitest 3) (http block)
https://api.github.com/repos/microsoft/genaiscript/issues
- Triggering command: node (vitest 3) (http block)
https://api.github.com/repos/microsoft/genaiscript/labels
- Triggering command: node (vitest 3) (http block)
https://api.github.com/repos/microsoft/genaiscript/languages
- Triggering command: node (vitest 3) (http block)
https://api.github.com/repos/microsoft/genaiscript/pulls
- Triggering command: node (vitest 3) (http block)
https://api.github.com/repos/microsoft/genaiscript/pulls/999999
- Triggering command: node (vitest 3) (http block)
microsoft.github.io
- Triggering command: node (vitest 2) (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

Configure Actions setup steps to set up my environment, which run before the firewall is enabled
Add the appropriate URLs or hosts to the custom allowlist in this repository's Copilot coding agent settings (admins only)

github-actions · 2025-08-02T21:40:42Z

Warning

LLM error (403): error

AI-generated content by docs may be incorrect.

Initial plan

a2ccb22

Copilot AI assigned Copilot and pelikhan Aug 2, 2025

Copilot started work on behalf of pelikhan August 2, 2025 13:23 View session

Add tryResolveResource method to Host interface and implement in all …

c177601

…host classes Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

Copilot AI changed the title ~~[WIP] Export the tryResolveResource functionality through the host interface object.~~ Export tryResolveResource functionality through the host interface Aug 2, 2025

Copilot AI requested a review from pelikhan August 2, 2025 13:53

Copilot finished work on behalf of pelikhan August 2, 2025 13:53

pelikhan reviewed Aug 2, 2025

View reviewed changes

Comment thread packages/core/src/promptcontext.ts Outdated

pelikhan reviewed Aug 2, 2025

View reviewed changes

Comment thread packages/core/src/types.ts Outdated

pelikhan reviewed Aug 2, 2025

View reviewed changes

Comment thread packages/core/src/host.ts Outdated

pelikhan reviewed Aug 2, 2025

View reviewed changes

Comment thread packages/runtime/src/nodehost.ts Outdated

pelikhan reviewed Aug 2, 2025

View reviewed changes

Comment thread packages/vscode/src/vshost.ts Outdated

pelikhan reviewed Aug 2, 2025

View reviewed changes

Copilot started work on behalf of pelikhan August 2, 2025 14:56 View session

Remove tryResolveResource from host interfaces and rename to resolveR…

db8638a

…esource in ResourceHost Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

Copilot AI changed the title ~~Export tryResolveResource functionality through the host interface~~ Export resolveResource functionality through the ResourceHost interface for prompt contexts Aug 2, 2025

Copilot AI requested a review from pelikhan August 2, 2025 15:07

Copilot finished work on behalf of pelikhan August 2, 2025 15:07

Merge branch 'dev' into copilot/fix-66ab302c-0453-432c-b543-c232c106e6bb

e64cd18

pelikhan marked this pull request as ready for review August 2, 2025 16:38

pelikhan reviewed Aug 2, 2025

View reviewed changes

Comment thread packages/core/src/promptcontext.ts Outdated

Update packages/core/src/promptcontext.ts

0cfd9eb

pelikhan reviewed Aug 2, 2025

View reviewed changes

Comment thread packages/core/src/types.ts Outdated

Update packages/core/src/types.ts

6745d1f

Refactor prompt context resource resolution to simplify options handling

6af2ee1

Copilot started work on behalf of pelikhan August 2, 2025 16:49 View session

Add resolveResource options parameter and sample script with document…

b81ae7e

…ation Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

Copilot AI changed the title ~~Export resolveResource functionality through the ResourceHost interface for prompt contexts~~ Add options parameter to resolveResource method and documentation Aug 2, 2025

Copilot AI requested a review from pelikhan August 2, 2025 17:05

Copilot finished work on behalf of pelikhan August 2, 2025 17:05

Copilot started work on behalf of pelikhan August 2, 2025 18:00 View session

Remove CancellationToken from public resolveResource interface

a74d592

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

Copilot AI changed the title ~~Add options parameter to resolveResource method and documentation~~ Add resolveResource method to ResourceHost interface with documentation Aug 2, 2025

Copilot finished work on behalf of pelikhan August 2, 2025 18:15

pelikhan reviewed Aug 2, 2025

View reviewed changes

Copilot started work on behalf of pelikhan August 2, 2025 18:30 View session

Remove unused CancellationOptions import from types.ts

e2c4cbd

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

Copilot AI requested a review from pelikhan August 2, 2025 18:41

Copilot finished work on behalf of pelikhan August 2, 2025 18:41

pelikhan approved these changes Aug 2, 2025

View reviewed changes

genai: /docs [skip ci]

7be6759

pelikhan merged commit 09ae642 into dev Aug 2, 2025
1 check passed

pelikhan deleted the copilot/fix-66ab302c-0453-432c-b543-c232c106e6bb branch August 4, 2025 08:18

Conversation

Copilot AI commented Aug 2, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Changes Made

Usage

Sample Script

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

pelikhan left a comment

Choose a reason for hiding this comment

Uh oh!

pelikhan commented Aug 2, 2025

Uh oh!

Copilot AI commented Aug 2, 2025

Uh oh!

Copilot AI commented Aug 2, 2025

Uh oh!

Uh oh!

Uh oh!

github-actions Bot commented Aug 2, 2025

Investigator report

Context collection

AI Analysis

Uh oh!

pelikhan commented Aug 2, 2025

Uh oh!

Copilot AI commented Aug 2, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

I tried to connect to the following addresses, but was blocked by firewall rules:

Uh oh!

pelikhan commented Aug 2, 2025

Uh oh!

Copilot AI commented Aug 2, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

I tried to connect to the following addresses, but was blocked by firewall rules:

Uh oh!

pelikhan Aug 2, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Aug 2, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI commented Aug 2, 2025

I tried to connect to the following addresses, but was blocked by firewall rules:

Uh oh!

github-actions Bot commented Aug 2, 2025

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Copilot AI commented Aug 2, 2025 •

edited

Loading

Copilot AI commented Aug 2, 2025 •

edited

Loading

Copilot AI commented Aug 2, 2025 •

edited

Loading