@agent-native/core 0.137.8 → 0.138.0

package/dist/provider-api/actions/custom-provider-registration.d.ts

@@ -75,8 +75,10 @@ export declare function createCustomProviderRegistrationAction<TSchema extends Z
         user: "user";
     }>>;
 }, z.core.$strip>>, {
+    id?: undefined;
+    provider?: undefined;
     deleted?: undefined;
-    message?: undefined;
+    found?: undefined;
     providers: {
         id: string;
         label: string;
@@ -87,47 +89,45 @@ export declare function createCustomProviderRegistrationAction<TSchema extends Z
         updatedAt: number;
     }[];
     count: number;
-    provider?: undefined;
-    found?: undefined;
     registered?: undefined;
-    id?: undefined;
     label?: undefined;
+    message?: undefined;
 } | {
+    id?: undefined;
     deleted?: undefined;
-    count?: undefined;
-    message?: undefined;
     providers?: undefined;
+    count?: undefined;
     found: boolean;
     provider: import("../custom-registry.js").CustomProviderConfig;
     registered?: undefined;
-    id?: undefined;
     label?: undefined;
+    message?: undefined;
 } | {
+    provider?: undefined;
     deleted?: undefined;
-    count?: undefined;
-    message?: undefined;
     providers?: undefined;
-    provider?: undefined;
+    count?: undefined;
     found: boolean;
     id: string;
     registered?: undefined;
     label?: undefined;
-} | {
-    count?: undefined;
     message?: undefined;
-    providers?: undefined;
+} | {
     provider?: undefined;
     found?: undefined;
+    providers?: undefined;
+    count?: undefined;
     deleted: boolean;
     id: string;
     registered?: undefined;
     label?: undefined;
+    message?: undefined;
 } | {
-    deleted?: undefined;
-    count?: undefined;
-    providers?: undefined;
     provider?: undefined;
+    deleted?: undefined;
     found?: undefined;
+    providers?: undefined;
+    count?: undefined;
     registered: boolean;
     id: string;
     label: string;

package/dist/provider-api/actions/provider-api.d.ts

@@ -144,7 +144,7 @@ export declare function createProviderApiCatalogAction<TSchema extends ZodTypeAn
     provider: z.ZodOptional<ZodTypeAny<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>;
 }, z.core.$strip>>, {
     providers: unknown[] | {
-        id: "amplitude" | "apollo" | "bigquery" | "clay" | "commonroom" | "dataforseo" | "figma" | "ga4" | "gcloud" | "github" | "gmail" | "gong" | "google_calendar" | "google_drive" | "google_slides" | "grafana" | "granola" | "hubspot" | "jira" | "mixpanel" | "notion" | "posthog" | "prometheus" | "pylon" | "salesforce" | "sentry" | "slack" | "stripe" | "twitter";
+        id: "amplitude" | "apollo" | "bigquery" | "clay" | "commonroom" | "dataforseo" | "figma" | "fullstory" | "ga4" | "gcloud" | "github" | "gmail" | "gong" | "google_calendar" | "google_drive" | "google_slides" | "grafana" | "granola" | "hubspot" | "jira" | "mixpanel" | "notion" | "posthog" | "prometheus" | "pylon" | "salesforce" | "sentry" | "slack" | "stripe" | "twitter";
         label: string;
         defaultBaseUrl: string;
         requiresConnectionId: boolean;
@@ -246,7 +246,7 @@ export declare function createProviderApiActions(runtime: Pick<ProviderApiRuntim
         provider?: unknown;
     }, {
         providers: unknown[] | {
-            id: "amplitude" | "apollo" | "bigquery" | "clay" | "commonroom" | "dataforseo" | "figma" | "ga4" | "gcloud" | "github" | "gmail" | "gong" | "google_calendar" | "google_drive" | "google_slides" | "grafana" | "granola" | "hubspot" | "jira" | "mixpanel" | "notion" | "posthog" | "prometheus" | "pylon" | "salesforce" | "sentry" | "slack" | "stripe" | "twitter";
+            id: "amplitude" | "apollo" | "bigquery" | "clay" | "commonroom" | "dataforseo" | "figma" | "fullstory" | "ga4" | "gcloud" | "github" | "gmail" | "gong" | "google_calendar" | "google_drive" | "google_slides" | "grafana" | "granola" | "hubspot" | "jira" | "mixpanel" | "notion" | "posthog" | "prometheus" | "pylon" | "salesforce" | "sentry" | "slack" | "stripe" | "twitter";
             label: string;
             defaultBaseUrl: string;
             requiresConnectionId: boolean;
@@ -314,6 +314,8 @@ export declare function createProviderApiActions(runtime: Pick<ProviderApiRuntim
         id?: undefined;
         provider?: undefined;
         deleted?: undefined;
+        found?: undefined;
+        message?: undefined;
         providers: {
             id: string;
             label: string;
@@ -324,46 +326,44 @@ export declare function createProviderApiActions(runtime: Pick<ProviderApiRuntim
             updatedAt: number;
         }[];
         count: number;
-        found?: undefined;
         registered?: undefined;
         label?: undefined;
-        message?: undefined;
     } | {
         id?: undefined;
-        deleted?: undefined;
         count?: undefined;
+        deleted?: undefined;
+        message?: undefined;
         providers?: undefined;
         found: boolean;
         provider: import("../custom-registry.js").CustomProviderConfig;
         registered?: undefined;
         label?: undefined;
-        message?: undefined;
     } | {
+        count?: undefined;
         provider?: undefined;
         deleted?: undefined;
-        count?: undefined;
+        message?: undefined;
         providers?: undefined;
         found: boolean;
         id: string;
         registered?: undefined;
         label?: undefined;
-        message?: undefined;
     } | {
-        provider?: undefined;
         count?: undefined;
-        providers?: undefined;
+        provider?: undefined;
         found?: undefined;
+        message?: undefined;
+        providers?: undefined;
         deleted: boolean;
         id: string;
         registered?: undefined;
         label?: undefined;
-        message?: undefined;
     } | {
+        count?: undefined;
         provider?: undefined;
         deleted?: undefined;
-        count?: undefined;
-        providers?: undefined;
         found?: undefined;
+        providers?: undefined;
         registered: boolean;
         id: string;
         label: string;

package/dist/provider-api/index.d.ts

@@ -4,7 +4,7 @@ import { type WebContentSearchOptions, type WebExtractMode, type WebResponseMode
 import type { CustomProviderConfig } from "./custom-registry.js";
 export type { CustomProviderConfig, CustomProviderScope, CustomProviderAuthKind, UpsertCustomProviderArgs, } from "./custom-registry.js";
 export { upsertCustomProvider, deleteCustomProvider, listCustomProviders, getCustomProvider, validateCustomBaseUrl, assertCanMutateCustomProviderScope, CustomProviderAuthError, } from "./custom-registry.js";
-export declare const PROVIDER_API_IDS: readonly ["amplitude", "apollo", "bigquery", "clay", "commonroom", "dataforseo", "ga4", "gcloud", "github", "figma", "gmail", "gong", "google_calendar", "google_drive", "google_slides", "granola", "grafana", "hubspot", "salesforce", "jira", "mixpanel", "notion", "posthog", "prometheus", "pylon", "sentry", "slack", "stripe", "twitter"];
+export declare const PROVIDER_API_IDS: readonly ["amplitude", "apollo", "bigquery", "clay", "commonroom", "dataforseo", "ga4", "gcloud", "github", "figma", "fullstory", "gmail", "gong", "google_calendar", "google_drive", "google_slides", "granola", "grafana", "hubspot", "salesforce", "jira", "mixpanel", "notion", "posthog", "prometheus", "pylon", "sentry", "slack", "stripe", "twitter"];
 export type ProviderApiId = (typeof PROVIDER_API_IDS)[number];
 export type ProviderApiMethod = "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD";
 /** Cursor-pagination config for fetchAllPages. */
@@ -422,7 +422,7 @@ export declare function listProviderApiCatalog(provider?: ProviderApiId | string
     providerIds?: readonly (ProviderApiId | string)[];
     providerOverrides?: readonly ProviderApiConfig[];
 }): {
-    id: "amplitude" | "apollo" | "bigquery" | "clay" | "commonroom" | "dataforseo" | "figma" | "ga4" | "gcloud" | "github" | "gmail" | "gong" | "google_calendar" | "google_drive" | "google_slides" | "grafana" | "granola" | "hubspot" | "jira" | "mixpanel" | "notion" | "posthog" | "prometheus" | "pylon" | "salesforce" | "sentry" | "slack" | "stripe" | "twitter";
+    id: "amplitude" | "apollo" | "bigquery" | "clay" | "commonroom" | "dataforseo" | "figma" | "fullstory" | "ga4" | "gcloud" | "github" | "gmail" | "gong" | "google_calendar" | "google_drive" | "google_slides" | "grafana" | "granola" | "hubspot" | "jira" | "mixpanel" | "notion" | "posthog" | "prometheus" | "pylon" | "salesforce" | "sentry" | "slack" | "stripe" | "twitter";
     label: string;
     defaultBaseUrl: string;
     requiresConnectionId: boolean;
@@ -444,7 +444,7 @@ export declare function createProviderApiRuntime(options: ProviderApiRuntimeOpti
 export declare function fetchProviderApiDocs(options: ProviderApiDocsOptions, runtime?: ProviderApiRuntimeOptions): Promise<{
     provider: string;
     catalog: {
-        id: "amplitude" | "apollo" | "bigquery" | "clay" | "commonroom" | "dataforseo" | "figma" | "ga4" | "gcloud" | "github" | "gmail" | "gong" | "google_calendar" | "google_drive" | "google_slides" | "grafana" | "granola" | "hubspot" | "jira" | "mixpanel" | "notion" | "posthog" | "prometheus" | "pylon" | "salesforce" | "sentry" | "slack" | "stripe" | "twitter";
+        id: "amplitude" | "apollo" | "bigquery" | "clay" | "commonroom" | "dataforseo" | "figma" | "fullstory" | "ga4" | "gcloud" | "github" | "gmail" | "gong" | "google_calendar" | "google_drive" | "google_slides" | "grafana" | "granola" | "hubspot" | "jira" | "mixpanel" | "notion" | "posthog" | "prometheus" | "pylon" | "salesforce" | "sentry" | "slack" | "stripe" | "twitter";
         label: string;
         defaultBaseUrl: string;
         requiresConnectionId: boolean;
@@ -484,7 +484,7 @@ export declare function fetchProviderApiDocs(options: ProviderApiDocsOptions, ru
     guidance?: undefined;
     provider: string;
     catalog: {
-        id: "amplitude" | "apollo" | "bigquery" | "clay" | "commonroom" | "dataforseo" | "figma" | "ga4" | "gcloud" | "github" | "gmail" | "gong" | "google_calendar" | "google_drive" | "google_slides" | "grafana" | "granola" | "hubspot" | "jira" | "mixpanel" | "notion" | "posthog" | "prometheus" | "pylon" | "salesforce" | "sentry" | "slack" | "stripe" | "twitter";
+        id: "amplitude" | "apollo" | "bigquery" | "clay" | "commonroom" | "dataforseo" | "figma" | "fullstory" | "ga4" | "gcloud" | "github" | "gmail" | "gong" | "google_calendar" | "google_drive" | "google_slides" | "grafana" | "granola" | "hubspot" | "jira" | "mixpanel" | "notion" | "posthog" | "prometheus" | "pylon" | "salesforce" | "sentry" | "slack" | "stripe" | "twitter";
         label: string;
         defaultBaseUrl: string;
         requiresConnectionId: boolean;

package/dist/provider-api/index.js

@@ -22,6 +22,7 @@ export const PROVIDER_API_IDS = [
     "gcloud",
     "github",
     "figma",
+    "fullstory",
     "gmail",
     "gong",
     "google_calendar",
@@ -393,6 +394,40 @@ const PROVIDER_CONFIGS = {
             "The REST API cannot create arbitrary canvas frames or layers. Use Figma's official OAuth MCP write tools when connected, or export a Design selection as Figma-compatible SVG for visual handoff.",
         ],
     },
+    fullstory: {
+        id: "fullstory",
+        label: "FullStory Server API",
+        defaultBaseUrl: "https://api.fullstory.com",
+        auth: {
+            type: "basic-raw",
+            key: "FULLSTORY_API_KEY",
+        },
+        credentialKeys: ["FULLSTORY_API_KEY"],
+        docsUrls: [
+            "https://developer.fullstory.com/server/authentication/",
+            "https://developer.fullstory.com/server/sessions/introduction/",
+            "https://developer.fullstory.com/server/sessions/get-session-events/",
+        ],
+        allowedHostSuffixes: ["fullstory.com"],
+        templateUses: ["analytics"],
+        examples: [
+            {
+                label: "List sessions for a user",
+                method: "GET",
+                path: "/sessions/v2",
+                query: { email: "<user-email>", limit: 20 },
+            },
+            {
+                label: "Get session events",
+                method: "GET",
+                path: "/v2/sessions/{sessionId}/events",
+            },
+        ],
+        notes: [
+            "FullStory Server API uses Basic <API_KEY> authentication. Architect access is required for user-data reads and exports.",
+            "Use the connected FullStory MCP for natural-language metrics, session replay, screenshots, and accessibility trees; this API fallback is for structured reads and event payloads.",
+        ],
+    },
     gmail: {
         id: "gmail",
         label: "Gmail API",

package/dist/resources/handlers.d.ts

@@ -48,8 +48,8 @@ export declare function handleUpdateResource(event: any): Promise<import("./stor
 }>;
 /** DELETE /_agent-native/resources/:id — delete a resource */
 export declare function handleDeleteResource(event: any): Promise<{
-    ok?: undefined;
     error: string;
+    ok?: undefined;
 } | {
     error?: undefined;
     ok: boolean;

package/dist/resources/handlers.js

@@ -532,7 +532,7 @@ export async function handleUploadResource(event) {
         }
         setResponseStatus(event, 503);
         return {
-            error: "File storage is not configured. Connect Builder.io or register an S3/R2/GCS file upload provider before uploading binary resources.",
+            error: "File storage is not configured. Connect Builder.io (free tier available) or register an S3/R2/GCS file upload provider before uploading binary resources.",
             storageSetupRequired: true,
         };
     }

package/dist/scripts/docs/framework-search.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Core script: framework-search
+ *
+ * Search the version-matched framework docs and readable source together.
+ * This is intentionally bounded and read-only so every app chat can use the
+ * same fallback when a question is not answered by the docs alone.
+ */
+export default function frameworkSearchScript(args: string[]): Promise<void>;
+//# sourceMappingURL=framework-search.d.ts.map

package/dist/scripts/docs/framework-search.js

@@ -0,0 +1,239 @@
+/**
+ * Core script: framework-search
+ *
+ * Search the version-matched framework docs and readable source together.
+ * This is intentionally bounded and read-only so every app chat can use the
+ * same fallback when a question is not answered by the docs alone.
+ */
+import fs from "node:fs";
+import { createTextMatcher, } from "../../search-utils/index.js";
+import { parseArgs } from "../utils.js";
+import { loadAllDocs } from "./search.js";
+import { listSourceFiles } from "./source-search.js";
+const DEFAULT_LIMIT = 30;
+const MAX_LIMIT = 50;
+const MAX_SNIPPETS_PER_RESULT = 3;
+function parseScope(value) {
+    if (!value)
+        return { value: "all" };
+    if (value === "all" || value === "docs" || value === "source") {
+        return { value };
+    }
+    return { error: `Invalid scope "${value}". Use all, docs, or source.` };
+}
+function parseMode(value) {
+    if (!value)
+        return { value: "substring" };
+    if (value === "substring" ||
+        value === "glob" ||
+        value === "sql-like" ||
+        value === "regex") {
+        return { value };
+    }
+    return {
+        error: `Invalid mode "${value}". Use substring, glob, sql-like, or regex.`,
+    };
+}
+function parseLimit(value) {
+    if (!value)
+        return { value: DEFAULT_LIMIT };
+    const parsed = Number(value);
+    if (!Number.isInteger(parsed) || parsed < 1) {
+        return { error: "Limit must be a positive integer." };
+    }
+    return { value: Math.min(parsed, MAX_LIMIT) };
+}
+function docsAsEntries(docs) {
+    return docs.map((doc) => ({
+        kind: "doc",
+        path: `docs/${doc.slug}`,
+        title: doc.title,
+        body: `${doc.title}\n${doc.description}\n${doc.body}`,
+    }));
+}
+function sourceAsEntries(files) {
+    const entries = [];
+    let unreadable = 0;
+    for (const file of files) {
+        try {
+            entries.push({
+                kind: "source",
+                path: file.relativePath,
+                body: fs.readFileSync(file.absolutePath, "utf-8"),
+                file,
+            });
+        }
+        catch {
+            unreadable += 1;
+        }
+    }
+    return { entries, unreadable };
+}
+function snippetsForEntry(entry, matcher, pathMatch) {
+    const snippets = [];
+    const lines = entry.body.split(/\r?\n/);
+    for (let index = 0; index < lines.length; index += 1) {
+        if (!matcher.matches(lines[index]))
+            continue;
+        const line = lines[index].trim();
+        if (!line)
+            continue;
+        snippets.push(`${index + 1}: ${line.slice(0, 260)}`);
+        if (snippets.length >= MAX_SNIPPETS_PER_RESULT)
+            break;
+    }
+    if (snippets.length === 0 && pathMatch) {
+        const firstLine = lines.find((line) => line.trim());
+        if (firstLine)
+            snippets.push(`1: ${firstLine.trim().slice(0, 260)}`);
+    }
+    return snippets;
+}
+function pathMatches(path, filter) {
+    if (!filter)
+        return { matches: true };
+    const matcher = createTextMatcher(filter, "glob");
+    return { matches: matcher.matches(path), error: matcher.error };
+}
+async function searchFramework(options) {
+    const [docs, sourceResult] = await Promise.all([
+        options.scope === "source" ? Promise.resolve([]) : loadAllDocs(),
+        options.scope === "docs"
+            ? Promise.resolve({ entries: [], unreadable: 0 })
+            : Promise.resolve(sourceAsEntries(listSourceFiles())),
+    ]);
+    const entries = [
+        ...(options.scope === "source" ? [] : docsAsEntries(docs)),
+        ...(options.scope === "docs" ? [] : sourceResult.entries),
+    ];
+    const matcher = createTextMatcher(options.pattern, options.mode);
+    if (matcher.error) {
+        return { hits: [], total: 0, unreadable: 0 };
+    }
+    const hits = [];
+    for (const entry of entries) {
+        const pathResult = pathMatches(entry.path, options.pathFilter);
+        if (pathResult.error)
+            continue;
+        if (!pathResult.matches)
+            continue;
+        const pathMatch = matcher.matches(entry.path);
+        const contentMatch = matcher.matches(entry.body);
+        if (!pathMatch && !contentMatch)
+            continue;
+        const snippets = snippetsForEntry(entry, matcher, pathMatch);
+        hits.push({ entry, pathMatch, snippets });
+    }
+    // Keep the result deterministic and favor docs titles and exact path hits.
+    hits.sort((a, b) => {
+        const aScore = (a.pathMatch ? 2 : 0) + (a.entry.kind === "doc" ? 1 : 0);
+        const bScore = (b.pathMatch ? 2 : 0) + (b.entry.kind === "doc" ? 1 : 0);
+        return bScore - aScore || a.entry.path.localeCompare(b.entry.path);
+    });
+    return {
+        hits: hits.slice(0, options.limit),
+        total: hits.length,
+        unreadable: sourceResult.unreadable,
+    };
+}
+function printHelp() {
+    console.log(`Usage: pnpm action framework-search [options]
+
+Options:
+  --pattern <text>   Text, wildcard, SQL-like, or regex pattern to search
+  --query <text>     Alias for --pattern
+  --scope <scope>    all, docs, or source (default: all)
+  --mode <mode>      substring, glob, sql-like, or regex (default: substring)
+  --path <glob>      Optional glob to limit matching paths
+  --limit <number>   Maximum files to return (default: ${DEFAULT_LIMIT}, max: ${MAX_LIMIT})
+  --list             List the searchable docs and source roots
+  --help             Show this help message`);
+}
+export default async function frameworkSearchScript(args) {
+    const parsed = parseArgs(args);
+    if (parsed.help === "true") {
+        printHelp();
+        return;
+    }
+    const scopeResult = parseScope(parsed.scope);
+    if (scopeResult.error) {
+        console.log(scopeResult.error);
+        return;
+    }
+    const scope = scopeResult.value;
+    const modeResult = parseMode(parsed.mode);
+    if (modeResult.error) {
+        console.log(modeResult.error);
+        return;
+    }
+    const mode = modeResult.value;
+    const limitResult = parseLimit(parsed.limit);
+    if (limitResult.error) {
+        console.log(limitResult.error);
+        return;
+    }
+    const limit = limitResult.value;
+    if (parsed.list === "true") {
+        const [docs, sourceFiles] = await Promise.all([
+            scope === "source" ? Promise.resolve([]) : loadAllDocs(),
+            scope === "docs"
+                ? Promise.resolve([])
+                : Promise.resolve(listSourceFiles()),
+        ]);
+        console.log(JSON.stringify({
+            docs: docs.map((doc) => ({ slug: doc.slug, title: doc.title })),
+            source: {
+                files: sourceFiles.length,
+                roots: Array.from(new Set(sourceFiles.map((file) => file.relativePath.split("/")[0]))),
+            },
+        }, null, 2));
+        return;
+    }
+    const pattern = parsed.pattern ?? parsed.query;
+    if (!pattern) {
+        printHelp();
+        return;
+    }
+    const matcher = createTextMatcher(pattern, mode);
+    if (matcher.error) {
+        console.log(matcher.error);
+        return;
+    }
+    if (parsed.path) {
+        const pathMatcher = createTextMatcher(parsed.path, "glob");
+        if (pathMatcher.error) {
+            console.log(pathMatcher.error);
+            return;
+        }
+    }
+    const result = await searchFramework({
+        pattern,
+        mode,
+        scope,
+        pathFilter: parsed.path,
+        limit,
+    });
+    if (result.total === 0) {
+        console.log(`No matches in the indexed ${scope} corpus for ${JSON.stringify(pattern)}.`);
+        console.log("The search covers version-matched framework docs, runtime-visible skills, and readable Core, Toolkit, and first-party template source. A miss is not proof that an implementation is absent if the relevant package source is not published in this app.");
+        if (result.unreadable > 0) {
+            console.log(`Skipped ${result.unreadable} unreadable source file(s).`);
+        }
+        return;
+    }
+    console.log(`Found ${result.total} matching file(s) in ${scope} using ${mode} mode for ${JSON.stringify(pattern)}:\n`);
+    for (const hit of result.hits) {
+        const label = hit.entry.kind === "doc" ? "doc" : "source";
+        console.log(`[${label}] ${hit.entry.path}${hit.entry.title ? ` - ${hit.entry.title}` : ""}`);
+        for (const snippet of hit.snippets)
+            console.log(`  ${snippet}`);
+        console.log("");
+    }
+    if (result.total > result.hits.length) {
+        console.log(`Showing ${result.hits.length} of ${result.total} matching files. Refine --path, --pattern, or --limit for more targeted evidence.`);
+    }
+    if (result.unreadable > 0) {
+        console.log(`Skipped ${result.unreadable} unreadable source file(s).`);
+    }
+}
+//# sourceMappingURL=framework-search.js.map

package/dist/scripts/docs/index.js

@@ -1,4 +1,5 @@
 export const coreDocsScripts = {
+    "framework-search": (args) => import("./framework-search.js").then((m) => m.default(args)),
     "docs-search": (args) => import("./search.js").then((m) => m.default(args)),
     "source-search": (args) => import("./source-search.js").then((m) => m.default(args)),
 };

package/dist/scripts/docs/search.d.ts

@@ -9,5 +9,15 @@
  *   pnpm action docs-search --slug authentication
  *   pnpm action docs-search --list
  */
+interface DocMeta {
+    slug: string;
+    title: string;
+    description: string;
+}
+export interface DocFull extends DocMeta {
+    body: string;
+}
+export declare function loadAllDocs(): Promise<DocFull[]>;
 export default function docsSearchScript(args: string[]): Promise<void>;
+export {};
 //# sourceMappingURL=search.d.ts.map

package/dist/scripts/docs/search.js

@@ -164,7 +164,7 @@ async function loadAgentBundleDocs() {
         return [];
     }
 }
-async function loadAllDocs() {
+export async function loadAllDocs() {
     return [...loadFilesystemDocs(), ...(await loadAgentBundleDocs())];
 }
 async function searchDocs(query) {

package/dist/scripts/docs/source-search.d.ts

@@ -1,15 +1,22 @@
 /**
  * Core script: source-search
  *
- * Search and read the packaged Agent Native first-party template corpus.
- * The corpus is generated into @agent-native/core/corpus during package build.
+ * Search and read version-matched framework source.
+ * First-party templates are generated into @agent-native/core/corpus during
+ * package build; Core and Toolkit source are read from their installed roots.
  *
  * Usage:
  *   pnpm action source-search --query "defineAction"
  *   pnpm action source-search --path templates/chat/actions/hello.ts
+ *   pnpm action source-search --path core/src/action.ts
  *   pnpm action source-search --path templates/plan/AGENTS.md
  *   pnpm action source-search --list
  */
+export interface SourceFile {
+    relativePath: string;
+    absolutePath: string;
+    visibilityRoot?: string;
+}
 /**
  * The corpus is a sibling of the package root, so a bundled serverless deploy
  * never carries it. Callers register this tool conditionally: advertising a
@@ -17,5 +24,6 @@
  * and reads to it like the code genuinely does not exist.
  */
 export declare function hasSourceCorpus(): boolean;
+export declare function listSourceFiles(): SourceFile[];
 export default function sourceSearchScript(args: string[]): Promise<void>;
 //# sourceMappingURL=source-search.d.ts.map