@agent-native/core 0.153.10 → 0.154.0

package/dist/server/design-token-utils.js

@@ -108,26 +108,78 @@ export function validateUrl(url) {
 // ---------------------------------------------------------------------------
 // GitHub helpers
 // ---------------------------------------------------------------------------
-/** Parse a GitHub URL or "org/repo" shorthand into owner + repo. */
-export function parseOwnerRepo(raw) {
+/** Parse a GitHub URL or "org/repo" shorthand, retaining an optional ref/path. */
+export function parseGitHubRepoReference(raw) {
     const cleaned = raw
         .trim()
         .replace(/[?#].*$/, "")
         .replace(/\/+$/, "");
+    if (!cleaned)
+        throw new Error("GitHub repository reference cannot be empty.");
     const sshMatch = cleaned.match(/^(?:ssh:\/\/)?git@github\.com[:/]([^/]+)\/([^/]+?)(?:\.git)?$/);
-    if (sshMatch) {
+    if (sshMatch)
         return { owner: sshMatch[1], repo: sshMatch[2] };
-    }
     const shorthand = cleaned.match(/^([^/\s]+)\/([^/\s]+?)(?:\.git)?$/);
-    if (shorthand) {
+    if (shorthand)
         return { owner: shorthand[1], repo: shorthand[2] };
+    let parsed;
+    try {
+        parsed = new URL(cleaned);
+    }
+    catch {
+        throw new Error("Could not parse GitHub owner/repo from URL. " +
+            'Expected format: "https://github.com/org/repo", "org/repo", or "git@github.com:org/repo.git"');
+    }
+    if (parsed.hostname.toLowerCase() !== "github.com") {
+        throw new Error("GitHub repository URL must use github.com.");
     }
-    const urlMatch = cleaned.match(/github\.com[:/]([^/]+)\/([^/]+?)(?:\.git)?(?:\/.*)?$/);
-    if (urlMatch) {
-        return { owner: urlMatch[1], repo: urlMatch[2] };
+    const parts = parsed.pathname
+        .split("/")
+        .filter(Boolean)
+        .map((part) => {
+        try {
+            return decodeURIComponent(part);
+        }
+        catch {
+            return part;
+        }
+    });
+    const owner = parts[0];
+    const repo = parts[1]?.replace(/\.git$/, "");
+    if (!owner || !repo) {
+        throw new Error("Could not parse GitHub owner/repo from URL. " +
+            'Expected format: "https://github.com/org/repo", "org/repo", or "git@github.com:org/repo.git"');
+    }
+    const kind = parts[2];
+    if ((kind === "tree" || kind === "blob") && parts[3]) {
+        return {
+            owner,
+            repo,
+            ref: parts[3],
+            ...(parts.length > 4 ? { subpath: parts.slice(4).join("/") } : {}),
+        };
     }
-    throw new Error("Could not parse GitHub owner/repo from URL. " +
-        'Expected format: "https://github.com/org/repo", "org/repo", or "git@github.com:org/repo.git"');
+    return { owner, repo };
+}
+/** Parse a GitHub URL or "org/repo" shorthand into owner + repo. */
+export function parseOwnerRepo(raw) {
+    const { owner, repo } = parseGitHubRepoReference(raw);
+    return { owner, repo };
+}
+export function canonicalGitHubRepoUrl(raw) {
+    const { owner, repo } = parseGitHubRepoReference(raw);
+    return `https://github.com/${owner}/${repo}`;
+}
+function githubContentsUrl(owner, repo, path, ref) {
+    const encodedPath = path
+        .split("/")
+        .filter(Boolean)
+        .map((segment) => encodeURIComponent(segment))
+        .join("/");
+    const url = new URL(`https://api.github.com/repos/${encodeURIComponent(owner)}/${encodeURIComponent(repo)}/contents/${encodedPath}`);
+    if (ref?.trim())
+        url.searchParams.set("ref", ref.trim());
+    return url;
 }
 /** Fetch a path from the GitHub Contents API as JSON. Returns null on error. */
 function githubHeaders(accept, options = {}) {
@@ -139,9 +191,9 @@ function githubHeaders(accept, options = {}) {
 }
 /** Fetch a path from the GitHub Contents API as JSON with status details. */
 export async function fetchGitHubJsonResult(owner, repo, path, options = {}) {
-    const url = `https://api.github.com/repos/${owner}/${repo}/contents/${path}`;
-    validateUrl(url);
-    const res = await ssrfSafeFetch(url, {
+    const url = githubContentsUrl(owner, repo, path, options.ref);
+    validateUrl(url.toString());
+    const res = await ssrfSafeFetch(url.toString(), {
         headers: githubHeaders("application/vnd.github.v3+json", options),
         signal: AbortSignal.timeout(FETCH_TIMEOUT),
     });
@@ -173,9 +225,9 @@ export async function fetchGitHubJson(owner, repo, path, options = {}) {
 }
 /** Fetch raw file content from the GitHub Contents API. Returns null on error or oversize. */
 export async function fetchGitHubRaw(owner, repo, path, options = {}) {
-    const url = `https://api.github.com/repos/${owner}/${repo}/contents/${path}`;
-    validateUrl(url);
-    const res = await ssrfSafeFetch(url, {
+    const url = githubContentsUrl(owner, repo, path, options.ref);
+    validateUrl(url.toString());
+    const res = await ssrfSafeFetch(url.toString(), {
         headers: githubHeaders("application/vnd.github.v3.raw", options),
         signal: AbortSignal.timeout(FETCH_TIMEOUT),
     });

package/dist/server/index.d.ts

@@ -69,7 +69,7 @@ export { createIntegrationsPlugin, defaultIntegrationsPlugin, enqueueRemoteComma
 export { isElectron, isMobile, getOrigin, getAppBasePath, getAppUrl, resolveOAuthRedirectUri, isAllowedOAuthRedirectUri, encodeOAuthState, decodeOAuthState, resolveOAuthOwner, createOAuthSession, oauthCallbackResponse, oauthErrorPage, oauthDesktopExchangePage, type OAuthStatePayload, type OAuthOwnerResult, type OAuthSessionResult, } from "./google-oauth.js";
 export { buildWorkspaceProviderAuthorizationUrl, createWorkspaceProviderOAuthHandler, exchangeWorkspaceProviderOAuthCode, handleWorkspaceProviderOAuthCallback, handleWorkspaceProviderOAuthStart, isWorkspaceProviderOAuthFlowValid, mergeWorkspaceOAuthValues, resolveWorkspaceProviderIdentity, workspaceProviderOAuthPath, type GenericWorkspaceOAuthProvider, type WorkspaceProviderOAuthFlow, } from "./workspace-provider-oauth.js";
 export { FeatureNotConfiguredError, hasBuilderPrivateKey, isBuilderEnvManaged, getBuilderProxyOrigin, getBuilderImageGenerationBaseUrl, getBuilderWebSearchBaseUrl, getBuilderAuthHeader, resolveBuilderPrivateKey, resolveBuilderAuthHeader, resolveHasBuilderPrivateKey, resolveHasCompleteBuilderConnection, resolveBuilderCredentials, resolveBuilderCredentialsDetailed, resolveBuilderCredentialSource, resolveBuilderCredential, readDeployCredentialEnv, writeBuilderCredentials, deleteBuilderCredentials, resolveSecret, type BuilderCredentialsDetailed, } from "./credential-provider.js";
-export { builderDesignSystemUrl, builderProjectBranchUrl, buildBuilderDesignSystemIndexFiles, createBuilderDesignSystemProxyFields, fetchBuilderDesignSystemDecodeJobStatus, fetchBuilderDesignSystemDocs, getBuilderDesignSystemsBaseUrl, hydrateBuilderDesignSystemReference, indexBuilderDesignSystem, localBuilderDesignSystemId, mimeTypeForBuilderDesignSystemFilename, parseBuilderDesignSystemProxyReference, startBuilderDesignSystemIndex, startBuilderDesignSystemUpload, type BuildBuilderDesignSystemIndexFilesOptions, type BuilderDesignSystemCodeFileInput, type BuilderDesignSystemDecodeJobStatus, type BuilderDesignSystemDocsOptions, type BuilderDesignSystemDocument, type BuilderDesignSystemHydratedReference, type BuilderDesignSystemIndexFile, type BuilderDesignSystemIndexFromSourcesOptions, type BuilderDesignSystemIndexOptions, type BuilderDesignSystemIndexResult, type BuilderDesignSystemUploadAttachment, type BuilderDesignSystemUploadSlot, type BuilderDesignSystemProxyFields, type BuilderDesignSystemProxyFieldsOptions, type BuilderDesignSystemProxyReference, type BuilderDesignSystemSourceKind, } from "./builder-design-systems.js";
+export { builderDesignSystemUrl, builderProjectBranchUrl, buildBuilderDesignSystemIndexFiles, collectBuilderDesignSystemGitHubFiles, createBuilderDesignSystemProxyFields, fetchBuilderDesignSystemDecodeJobStatus, fetchBuilderDesignSystemDocs, getBuilderDesignSystemsBaseUrl, hydrateBuilderDesignSystemReference, indexBuilderDesignSystem, localBuilderDesignSystemId, mimeTypeForBuilderDesignSystemFilename, parseBuilderDesignSystemProxyReference, startBuilderDesignSystemIndex, startBuilderDesignSystemUpload, type BuildBuilderDesignSystemIndexFilesOptions, type BuilderDesignSystemCodeFileInput, type BuilderDesignSystemDecodeJobStatus, type BuilderDesignSystemDocsOptions, type BuilderDesignSystemDocument, type BuilderDesignSystemHydratedReference, type BuilderDesignSystemIndexFile, type BuilderDesignSystemIndexFromSourcesOptions, type BuilderDesignSystemIndexOptions, type BuilderDesignSystemIndexResult, type BuilderDesignSystemGitHubFile, type BuilderDesignSystemGitHubFileCollection, type BuilderDesignSystemGitHubSource, type BuilderDesignSystemUploadAttachment, type BuilderDesignSystemUploadSlot, type BuilderDesignSystemProxyFields, type BuilderDesignSystemProxyFieldsOptions, type BuilderDesignSystemProxyReference, type BuilderDesignSystemSourceKind, } from "./builder-design-systems.js";
 export { createBuilderProject, ensureBuilderProject, findBuilderProjectForRepo, getBuilderBranchProjectId, isBuilderBranchingEnabled, requestBuilderBrowserConnection, resolveBuilderBranchProjectId, resolveIsBuilderBranchingEnabled, runBuilderAgent, type BuilderProjectResult, type RunBuilderAgentResult, } from "./builder-browser.js";
 export { ensureFusionContainer, sendFusionBranchMessage, pushFusionBranch, reserveFusionHostingSlug, deployFusionProject, getFusionDeploys, getFusionBranchEditorUrl, getFusionHostingUrl, type FusionBranchRef, type EnsureFusionContainerResult, type SendFusionMessageResult, } from "./fusion-app.js";
 export { sendEmail, isEmailConfigured, getEmailReadiness, getEmailProvider, type EmailAttachment, type EmailReadiness, type EmailProvider, type SendEmailArgs, } from "./email.js";

package/dist/server/index.js

@@ -74,7 +74,7 @@ export { createIntegrationsPlugin, defaultIntegrationsPlugin, enqueueRemoteComma
 export { isElectron, isMobile, getOrigin, getAppBasePath, getAppUrl, resolveOAuthRedirectUri, isAllowedOAuthRedirectUri, encodeOAuthState, decodeOAuthState, resolveOAuthOwner, createOAuthSession, oauthCallbackResponse, oauthErrorPage, oauthDesktopExchangePage, } from "./google-oauth.js";
 export { buildWorkspaceProviderAuthorizationUrl, createWorkspaceProviderOAuthHandler, exchangeWorkspaceProviderOAuthCode, handleWorkspaceProviderOAuthCallback, handleWorkspaceProviderOAuthStart, isWorkspaceProviderOAuthFlowValid, mergeWorkspaceOAuthValues, resolveWorkspaceProviderIdentity, workspaceProviderOAuthPath, } from "./workspace-provider-oauth.js";
 export { FeatureNotConfiguredError, hasBuilderPrivateKey, isBuilderEnvManaged, getBuilderProxyOrigin, getBuilderImageGenerationBaseUrl, getBuilderWebSearchBaseUrl, getBuilderAuthHeader, resolveBuilderPrivateKey, resolveBuilderAuthHeader, resolveHasBuilderPrivateKey, resolveHasCompleteBuilderConnection, resolveBuilderCredentials, resolveBuilderCredentialsDetailed, resolveBuilderCredentialSource, resolveBuilderCredential, readDeployCredentialEnv, writeBuilderCredentials, deleteBuilderCredentials, resolveSecret, } from "./credential-provider.js";
-export { builderDesignSystemUrl, builderProjectBranchUrl, buildBuilderDesignSystemIndexFiles, createBuilderDesignSystemProxyFields, fetchBuilderDesignSystemDecodeJobStatus, fetchBuilderDesignSystemDocs, getBuilderDesignSystemsBaseUrl, hydrateBuilderDesignSystemReference, indexBuilderDesignSystem, localBuilderDesignSystemId, mimeTypeForBuilderDesignSystemFilename, parseBuilderDesignSystemProxyReference, startBuilderDesignSystemIndex, startBuilderDesignSystemUpload, } from "./builder-design-systems.js";
+export { builderDesignSystemUrl, builderProjectBranchUrl, buildBuilderDesignSystemIndexFiles, collectBuilderDesignSystemGitHubFiles, createBuilderDesignSystemProxyFields, fetchBuilderDesignSystemDecodeJobStatus, fetchBuilderDesignSystemDocs, getBuilderDesignSystemsBaseUrl, hydrateBuilderDesignSystemReference, indexBuilderDesignSystem, localBuilderDesignSystemId, mimeTypeForBuilderDesignSystemFilename, parseBuilderDesignSystemProxyReference, startBuilderDesignSystemIndex, startBuilderDesignSystemUpload, } from "./builder-design-systems.js";
 export { createBuilderProject, ensureBuilderProject, findBuilderProjectForRepo, getBuilderBranchProjectId, isBuilderBranchingEnabled, requestBuilderBrowserConnection, resolveBuilderBranchProjectId, resolveIsBuilderBranchingEnabled, runBuilderAgent, } from "./builder-browser.js";
 export { ensureFusionContainer, sendFusionBranchMessage, pushFusionBranch, reserveFusionHostingSlug, deployFusionProject, getFusionDeploys, getFusionBranchEditorUrl, getFusionHostingUrl, } from "./fusion-app.js";
 export { sendEmail, isEmailConfigured, getEmailReadiness, getEmailProvider, } from "./email.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-native/core",
-  "version": "0.153.10",
+  "version": "0.154.0",
   "description": "Framework for agent-native application development — where AI agents and UI share SQL state, actions, and context",
   "homepage": "https://github.com/BuilderIO/agent-native#readme",
   "bugs": {
@@ -421,8 +421,8 @@
     "y-protocols": "^1.0.7",
     "yjs": "^13.6.31",
     "zod": "^4.3.6",
-    "@agent-native/toolkit": "^0.14.1",
-    "@agent-native/recap-cli": "0.5.4"
+    "@agent-native/recap-cli": "0.5.4",
+    "@agent-native/toolkit": "^0.14.2"
   },
   "devDependencies": {
     "@ai-sdk/anthropic": "^3.0.71",