glirastes 0.4.0 → 0.5.0

package/dist/codegen/tools/sources/next-endpoints.js

@@ -0,0 +1,389 @@
+import { existsSync } from 'node:fs';
+import { readdir, readFile } from 'node:fs/promises';
+import { dirname, join, relative, resolve, sep } from 'node:path';
+import ts from 'typescript';
+import { deriveToolPolicyDefaults } from '../../../contracts/tool-policy.js';
+import { createRouteSourceFingerprint, scanNextAppRoutes, toRoutePath, } from '../../route-scanner.js';
+import { compareCodeUnits } from '../canonical.js';
+import { contractEntryItem, OPAQUE_SCHEMA_DIGEST, probeItemFor, probeKey, resolveEndpointContract, } from '../contract-tiers.js';
+import { collectHandlerEvidence } from '../evidence.js';
+import { findExclusion, hasAiIgnoreMarker, importsChatHandler } from '../exclusions.js';
+import { toolFinding } from '../findings.js';
+import { analyzeRouteHandler } from '../handler-analysis.js';
+import { assignDefinitionIds } from '../identity.js';
+import { inferResponseSchema } from '../output-inference.js';
+import { createAppProgram } from '../program.js';
+import { validateResolutionEntry } from '../resolutions.js';
+export const NEXT_DEFAULT_API_DIR = 'src/app/api';
+const CONTRACT_FILE_NAMES = ['contract.ts', 'contract.tsx', 'contract.js', 'contract.mjs'];
+/** Route exports Next.js serves that the generator does not turn into tools. */
+const UNSUPPORTED_METHODS = new Set(['OPTIONS']);
+const ROUTE_FILE = /^route\.(?:ts|tsx|js|jsx)$/;
+function incomplete(message) {
+    return {
+        observations: [],
+        findings: [toolFinding('E-INVENTORY-011', 'error', 'next-app', message)],
+        complete: false,
+        excluded: [],
+    };
+}
+/**
+ * Mirrors the discovery walk of `scanNextAppRoutes` (route.* files, no
+ * `node_modules`, `.git` or `_private` folders). The scan has already passed
+ * over the same tree, so it is known to be bounded and free of links.
+ */
+async function listRouteFiles(directory) {
+    const files = [];
+    for (const entry of await readdir(directory, { withFileTypes: true })) {
+        if (entry.name === 'node_modules' || entry.name === '.git')
+            continue;
+        const path = join(directory, entry.name);
+        if (entry.isDirectory()) {
+            if (!entry.name.startsWith('_'))
+                files.push(...await listRouteFiles(path));
+        }
+        else if (entry.isFile() && ROUTE_FILE.test(entry.name)) {
+            files.push(path);
+        }
+    }
+    return files;
+}
+function bindingNames(name, into) {
+    if (ts.isIdentifier(name)) {
+        into.add(name.text);
+        return;
+    }
+    for (const element of name.elements) {
+        if (!ts.isOmittedExpression(element))
+            bindingNames(element.name, into);
+    }
+}
+/** Names a route file exports by local syntax; `export *` is already fatal upstream. */
+function exportedNames(sourceFile, source) {
+    const file = ts.createSourceFile(sourceFile, source, ts.ScriptTarget.Latest, true);
+    const names = new Set();
+    const hasModifier = (node, kind) => ts.canHaveModifiers(node) && ts.getModifiers(node)?.some((modifier) => modifier.kind === kind);
+    for (const statement of file.statements) {
+        if (hasModifier(statement, ts.SyntaxKind.DefaultKeyword))
+            continue;
+        if (ts.isExportDeclaration(statement)) {
+            if (statement.isTypeOnly || !statement.exportClause)
+                continue;
+            if (ts.isNamedExports(statement.exportClause)) {
+                for (const element of statement.exportClause.elements) {
+                    if (!element.isTypeOnly)
+                        names.add(element.name.text);
+                }
+            }
+            else {
+                names.add(statement.exportClause.name.text);
+            }
+        }
+        else if (hasModifier(statement, ts.SyntaxKind.ExportKeyword)) {
+            if (ts.isFunctionDeclaration(statement) && statement.name) {
+                names.add(statement.name.text);
+            }
+            else if (ts.isVariableStatement(statement)) {
+                for (const declaration of statement.declarationList.declarations)
+                    bindingNames(declaration.name, names);
+            }
+        }
+    }
+    return names;
+}
+async function enumerateRoutes(root, apiDir) {
+    let scan;
+    try {
+        scan = await scanNextAppRoutes({ rootDir: root, apiDir, mode: 'source-discovery' });
+    }
+    catch {
+        return incomplete('Next.js route discovery is incomplete: a linked, oversized or unreadable file, or too many routes.');
+    }
+    const fatal = (scan.findings ?? []).find((finding) => finding.code !== 'route-export-unresolved');
+    if (fatal) {
+        return incomplete(fatal.code === 'route-wildcard-export-unresolved'
+            ? `${fatal.sourceFile} uses export *, so its handlers cannot be enumerated.`
+            : `${fatal.sourceFile} cannot be parsed.`);
+    }
+    const sources = new Map();
+    const read = async (sourceFile) => {
+        const cached = sources.get(sourceFile);
+        if (cached !== undefined)
+            return cached;
+        const source = await readFile(join(root, sourceFile), 'utf8');
+        sources.set(sourceFile, source);
+        return source;
+    };
+    const entries = new Map();
+    const findings = [];
+    const add = (entry) => {
+        const existing = entries.get(entry.stableKey);
+        if (existing && existing.sourceFile !== entry.sourceFile) {
+            findings.push(toolFinding('E-INVENTORY-010', 'error', entry.stableKey, `${existing.sourceFile} and ${entry.sourceFile} both handle ${entry.stableKey}.`));
+            return;
+        }
+        entries.set(entry.stableKey, entry);
+    };
+    for (const candidate of scan.candidates) {
+        add({
+            stableKey: `${candidate.method} ${candidate.path}`,
+            method: candidate.method,
+            path: candidate.path,
+            pathParams: [...candidate.pathParams],
+            sourceFile: candidate.sourceFile,
+            absoluteFile: join(root, candidate.sourceFile),
+            sourceFingerprint: candidate.sourceFingerprint,
+            source: await read(candidate.sourceFile),
+        });
+    }
+    for (const finding of scan.findings ?? []) {
+        if (finding.code !== 'route-export-unresolved' || !finding.exportName)
+            continue;
+        const absoluteFile = join(root, finding.sourceFile);
+        const route = toRoutePath(resolve(root, apiDir), absoluteFile);
+        const source = await read(finding.sourceFile);
+        add({
+            stableKey: `${finding.exportName} ${route.path}`,
+            method: finding.exportName,
+            path: route.path,
+            pathParams: route.pathParams,
+            sourceFile: finding.sourceFile,
+            absoluteFile,
+            sourceFingerprint: createRouteSourceFingerprint(source, finding.exportName, route.path),
+            source,
+        });
+    }
+    // The route reader drops OPTIONS without a trace, and a route file that
+    // exports only OPTIONS yields no candidate at all: look at every route file.
+    const unsupported = new Map();
+    const apiRoot = resolve(root, apiDir);
+    for (const absoluteFile of (await listRouteFiles(apiRoot)).sort(compareCodeUnits)) {
+        const sourceFile = relative(root, absoluteFile).split(sep).join('/');
+        const route = toRoutePath(apiRoot, absoluteFile);
+        const names = exportedNames(sourceFile, await read(sourceFile));
+        for (const method of [...UNSUPPORTED_METHODS].sort(compareCodeUnits)) {
+            if (!names.has(method))
+                continue;
+            const stableKey = `${method} ${route.path}`;
+            unsupported.set(stableKey, { stableKey, reason: 'unsupported-method', origin: 'code' });
+        }
+    }
+    return {
+        entries: [...entries.values()].sort((left, right) => compareCodeUnits(left.stableKey, right.stableKey)),
+        findings,
+        unsupported: [...unsupported.values()],
+    };
+}
+function contractModuleOf(app, file) {
+    const sourceFile = app.sourceFile(file);
+    if (!sourceFile)
+        return undefined;
+    const moduleSymbol = app.checker.getSymbolAtLocation(sourceFile);
+    if (!moduleSymbol || !app.checker.getExportsOfModule(moduleSymbol).some((symbol) => symbol.name === 'contract')) {
+        return undefined;
+    }
+    return app.appRelative(file);
+}
+function observeRoute(ctx, app, route, probes, resolution) {
+    const { entry, analysis, contractModule } = route;
+    const files = [...new Set([
+            entry.sourceFile,
+            ...(contractModule ? [contractModule] : []),
+            ...(analysis?.importedModules ?? []),
+        ])].sort(compareCodeUnits);
+    if (!analysis?.located?.fn) {
+        return {
+            entry,
+            findings: [toolFinding('handler-unresolved', 'needs_attention', entry.stableKey, `The ${entry.method} export of ${entry.sourceFile} is not a function the generator can read.`)],
+            evidence: { authEvidence: false, externalCall: false },
+            files,
+        };
+    }
+    const located = analysis.located;
+    const evidence = collectHandlerEvidence({
+        app, scope: located.scope, authHelpers: ctx.resolutions.conventions.authHelpers,
+    });
+    const inferredOutput = inferResponseSchema(app.checker, analysis.responseArguments);
+    const candidate = contractModule
+        ? {
+            module: contractModule,
+            loadBearing: analysis.importedModules.includes(contractModule),
+            result: probes.get(probeKey(contractEntryItem(contractModule, entry.method))) ?? { ok: false, reason: 'probe-failed' },
+        }
+        : undefined;
+    const previousContract = ctx.previousContracts.get(entry.stableKey);
+    const resolved = resolveEndpointContract({
+        stableKey: entry.stableKey,
+        method: entry.method,
+        path: entry.path,
+        pathParams: entry.pathParams,
+        evidence: {
+            schemaUses: analysis.schemaUses,
+            queryKeys: analysis.queryKeys,
+            repeatedQueryKeys: analysis.repeatedQueryKeys,
+            bodyKeys: analysis.bodyKeys,
+            readsBody: analysis.readsBody,
+            ...(analysis.normalizedText !== undefined ? { normalizedText: analysis.normalizedText } : {}),
+        },
+        ...(inferredOutput ? { inferredOutput } : {}),
+        probes,
+        ...(candidate ? { contractModule: candidate } : {}),
+        ...(resolution ? { resolution } : {}),
+        ...(previousContract ? { previousContract } : {}),
+    });
+    const findings = [...resolved.findings];
+    if (evidence.authEvidence.length === 0) {
+        findings.push(toolFinding('auth-evidence-missing', 'needs_attention', entry.stableKey, `No session or auth helper call was found for ${entry.stableKey}; the tool stays disabled until the endpoint's authorization is visible.`));
+    }
+    return {
+        entry,
+        resolved,
+        findings,
+        evidence: {
+            authEvidence: evidence.authEvidence.length > 0,
+            externalCall: evidence.externalCall,
+            ...(resolved.declaredEffect ? { declaredEffect: resolved.declaredEffect } : {}),
+            ...(located.jsDoc ? { jsDoc: located.jsDoc } : {}),
+        },
+        interface: {
+            digest: resolved.interfaceDigest,
+            params: resolved.contract?.params ?? {
+                path: [...entry.pathParams],
+                query: [...analysis.queryKeys],
+                body: analysis.bodyKeys === 'opaque' ? 'opaque' : [...analysis.bodyKeys],
+            },
+        },
+        files,
+    };
+}
+function toObserved(piece, definitionId) {
+    const { entry, resolved } = piece;
+    return {
+        execution: {
+            definitionId,
+            stableKey: entry.stableKey,
+            executionKind: 'endpoint',
+            sourceKind: 'next-app',
+            sourceFile: entry.sourceFile,
+            method: entry.method,
+            path: entry.path,
+            sourceFingerprint: entry.sourceFingerprint,
+            inputSchemaDigest: resolved?.inputSchemaDigest ?? OPAQUE_SCHEMA_DIGEST,
+            outputSchemaDigest: resolved?.outputSchemaDigest ?? OPAQUE_SCHEMA_DIGEST,
+        },
+        ...(resolved?.contract ? { contract: resolved.contract } : {}),
+        ...(piece.interface ? { interface: piece.interface } : {}),
+        files: piece.files,
+        evidence: piece.evidence,
+        findings: piece.findings,
+        ...(resolved && Object.keys(resolved.prose).length > 0 ? { prose: resolved.prose } : {}),
+    };
+}
+async function observeNextEndpoints(ctx, apiDir) {
+    if (!existsSync(resolve(ctx.root, apiDir))) {
+        return { observations: [], findings: [], complete: true, excluded: [] };
+    }
+    const enumerated = await enumerateRoutes(ctx.root, apiDir);
+    if (!('entries' in enumerated))
+        return enumerated;
+    const findings = [...enumerated.findings];
+    const excluded = [...enumerated.unsupported];
+    const kept = [];
+    const policyExcludes = ctx.policy.exclude ?? [];
+    for (const entry of enumerated.entries) {
+        const exclusion = findExclusion({
+            stableKey: entry.stableKey,
+            method: entry.method,
+            path: entry.path,
+            chatHandler: importsChatHandler(entry.source),
+            aiIgnore: hasAiIgnoreMarker(entry.source),
+        }, policyExcludes);
+        if (exclusion)
+            excluded.push(exclusion);
+        else
+            kept.push(entry);
+    }
+    excluded.sort((left, right) => compareCodeUnits(left.stableKey, right.stableKey));
+    if (kept.length === 0)
+        return { observations: [], findings, complete: true, excluded };
+    const contractFiles = new Map();
+    for (const entry of kept) {
+        const directory = dirname(entry.absoluteFile);
+        if (contractFiles.has(directory))
+            continue;
+        const file = CONTRACT_FILE_NAMES.map((name) => join(directory, name)).find((candidate) => existsSync(candidate));
+        if (file)
+            contractFiles.set(directory, file);
+    }
+    const app = createAppProgram({
+        root: ctx.root,
+        rootNames: [...new Set([...kept.map((entry) => entry.absoluteFile), ...contractFiles.values()])],
+    });
+    const conventions = ctx.resolutions.conventions;
+    const analyzed = kept.map((entry) => {
+        const sourceFile = app.sourceFile(entry.absoluteFile);
+        const analysis = sourceFile
+            ? analyzeRouteHandler({ app, sourceFile, method: entry.method, conventions })
+            : undefined;
+        const contractFile = contractFiles.get(dirname(entry.absoluteFile));
+        const contractModule = contractFile ? contractModuleOf(app, contractFile) : undefined;
+        return { entry, ...(analysis ? { analysis } : {}), ...(contractModule ? { contractModule } : {}) };
+    });
+    // The input keys of an entry are checked in resolveEndpointContract, after its interfaceDigest.
+    const resolutions = new Map();
+    for (const { entry } of analyzed) {
+        const raw = ctx.resolutions.entries.get(entry.stableKey);
+        if (raw === undefined)
+            continue;
+        const validated = validateResolutionEntry({
+            stableKey: entry.stableKey,
+            raw,
+            codeRiskClass: deriveToolPolicyDefaults({
+                executionKind: 'endpoint', method: entry.method, path: entry.path, definitionId: '',
+            }).riskClass,
+        });
+        findings.push(...validated.findings);
+        if (validated.entry)
+            resolutions.set(entry.stableKey, validated.entry);
+    }
+    const items = new Map();
+    const request = (item) => items.set(probeKey(item), item);
+    for (const { entry, analysis, contractModule } of analyzed) {
+        for (const use of analysis?.schemaUses ?? []) {
+            if (use.binding)
+                request(probeItemFor(use.binding, use.role === 'output' ? 'output' : 'input'));
+        }
+        if (contractModule)
+            request(contractEntryItem(contractModule, entry.method));
+        const resolution = resolutions.get(entry.stableKey);
+        if (resolution?.input?.schemaRef)
+            request(probeItemFor(resolution.input.schemaRef, 'input'));
+        if (resolution?.output?.schemaRef)
+            request(probeItemFor(resolution.output.schemaRef, 'output'));
+    }
+    const keys = [...items.keys()].sort(compareCodeUnits);
+    const results = keys.length > 0 ? await ctx.probe.probe(ctx.root, keys.map((key) => items.get(key))) : [];
+    const probes = new Map(keys.map((key, index) => [
+        key,
+        results[index] ?? { ok: false, reason: 'probe-failed' },
+    ]));
+    const pieces = analyzed.map((route) => observeRoute(ctx, app, route, probes, resolutions.get(route.entry.stableKey)));
+    const naming = assignDefinitionIds(pieces.map(({ entry, resolved }) => ({
+        stableKey: entry.stableKey,
+        method: entry.method,
+        path: entry.path,
+        ...(resolved?.explicitId ? { explicitId: resolved.explicitId } : {}),
+    })), new Map((ctx.previous?.inventory.executions ?? []).map((execution) => [execution.stableKey, execution.definitionId])));
+    findings.push(...naming.findings);
+    return {
+        observations: pieces.map((piece) => toObserved(piece, naming.ids.get(piece.entry.stableKey))),
+        findings,
+        complete: true,
+        excluded,
+    };
+}
+export function createNextEndpointSource(options = {}) {
+    const apiDir = options.apiDir ?? NEXT_DEFAULT_API_DIR;
+    return { kind: 'next-app', observe: (ctx) => observeNextEndpoints(ctx, apiDir) };
+}
+//# sourceMappingURL=next-endpoints.js.map

package/dist/codegen/tools/sources/next-endpoints.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"next-endpoints.js","sourceRoot":"","sources":["../../../../src/codegen/tools/sources/next-endpoints.ts"],"names":[],"mappings":"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"}

package/dist/codegen/tools/sources/next-pages.d.ts

@@ -0,0 +1,18 @@
+import type { JsonSchemaLike, ToolFinding, ToolSource, ToolSourceObservation } from '../types.js';
+import { type AppSourceScan } from './app-files.js';
+import { type PageEntry, type PageTree, type PageTreeOptions } from './page-tree.js';
+export interface NextPagesSourceOptions extends PageTreeOptions {
+    /** Where the navigation bridge is searched; `src` when the app has one, else the app root. */
+    srcDir?: string;
+}
+/** `destination` is one of the page paths; `params` fills their dynamic segments. */
+export declare function navigationInputSchema(pages: ReadonlyArray<PageEntry>): JsonSchemaLike;
+export declare function navigationBridgeMissing(stableKey: string): ToolFinding;
+export declare function scanForNavigationBridge(root: string, srcDir: string | undefined): Promise<AppSourceScan>;
+/** The one `ui.navigate` tool over a page list, whichever source enumerated it. */
+export declare function observeNavigation(kind: string, tree: PageTree, root: string, locale: string, srcDir: string | undefined): Promise<ToolSourceObservation>;
+/**
+ * The `next-pages` source: one `ui.navigate` tool whose destinations are the
+ * pages of the Next.js app router tree (spec 4.4 "Navigation und Filter").
+ */
+export declare function createNextPagesSource(options?: NextPagesSourceOptions): ToolSource;

package/dist/codegen/tools/sources/next-pages.js

@@ -0,0 +1,88 @@
+import { compareCodeUnits } from '../canonical.js';
+import { toolFinding } from '../findings.js';
+import { scanAppSources } from './app-files.js';
+import { enumeratePages } from './page-tree.js';
+import { hasNavigationBridge, incompleteUiSource, mentionsNavigationBridge, NAVIGATE_ACTION_BINDING, NAVIGATE_DEFINITION_ID, NAVIGATE_STABLE_KEY, uiObservation, } from './ui-tools.js';
+const MAX_LISTED_DESTINATIONS = 40;
+/** `destination` is one of the page paths; `params` fills their dynamic segments. */
+export function navigationInputSchema(pages) {
+    const params = [...new Set(pages.flatMap((page) => page.params))].sort(compareCodeUnits);
+    return {
+        type: 'object',
+        properties: {
+            destination: { type: 'string', enum: pages.map((page) => page.path) },
+            ...(params.length > 0
+                ? {
+                    params: {
+                        type: 'object',
+                        properties: Object.fromEntries(params.map((name) => [name, { type: 'string', minLength: 1 }])),
+                        additionalProperties: false,
+                    },
+                }
+                : {}),
+        },
+        required: ['destination'],
+        additionalProperties: false,
+    };
+}
+function navigationProse(locale, pages) {
+    const german = locale.toLowerCase().startsWith('de');
+    const listed = pages.slice(0, MAX_LISTED_DESTINATIONS).map((page) => (page.params.length > 0
+        ? `${page.path} (${german ? 'braucht' : 'needs'} ${page.params.map((name) => `params.${name}`).join(', ')})`
+        : page.path));
+    const rest = pages.length - listed.length;
+    const more = rest > 0 ? (german ? ` und ${rest} weitere` : ` and ${rest} more`) : '';
+    return german
+        ? {
+            contractDescription: `Öffnet eine Seite dieser App im Browser des Nutzers. Ziele: ${listed.join(', ')}${more}.`,
+            presentation: { locale, singular: 'Seite öffnen', plural: 'Seiten öffnen', approval: 'Seite öffnen' },
+        }
+        : {
+            contractDescription: `Open a page of this app in the user's browser. Destinations: ${listed.join(', ')}${more}.`,
+            presentation: { locale, singular: 'Open page', plural: 'Open pages', approval: 'Open a page' },
+        };
+}
+export function navigationBridgeMissing(stableKey) {
+    return toolFinding('navigation-bridge-missing', 'needs_attention', stableKey, 'No useGlirastesNavigationBridge or registerNavigationBridge call was found, so the browser cannot run this tool.');
+}
+export function scanForNavigationBridge(root, srcDir) {
+    return scanAppSources(root, { ...(srcDir ? { srcDir } : {}), matches: mentionsNavigationBridge });
+}
+/** The one `ui.navigate` tool over a page list, whichever source enumerated it. */
+export async function observeNavigation(kind, tree, root, locale, srcDir) {
+    if (!tree.complete)
+        return incompleteUiSource(kind, tree.reason);
+    if (tree.pages.length === 0) {
+        return { observations: [], findings: tree.findings, complete: true, excluded: tree.excluded };
+    }
+    const sources = await scanForNavigationBridge(root, srcDir);
+    if (!sources.complete)
+        return incompleteUiSource(kind, sources.reason);
+    const tool = uiObservation({
+        stableKey: NAVIGATE_STABLE_KEY,
+        definitionId: NAVIGATE_DEFINITION_ID,
+        actionBindingRef: NAVIGATE_ACTION_BINDING,
+        input: navigationInputSchema(tree.pages),
+        uiAction: { kind: 'navigate' },
+        params: {
+            path: [...new Set(tree.pages.flatMap((page) => page.params))].sort(compareCodeUnits),
+            query: [],
+            body: [],
+        },
+        facts: { destinations: tree.pages.map(({ path, params }) => ({ path, params })) },
+        findings: hasNavigationBridge(sources.files) ? [] : [navigationBridgeMissing(NAVIGATE_STABLE_KEY)],
+        prose: navigationProse(locale, tree.pages),
+    });
+    return { observations: [tool], findings: tree.findings, complete: true, excluded: tree.excluded };
+}
+/**
+ * The `next-pages` source: one `ui.navigate` tool whose destinations are the
+ * pages of the Next.js app router tree (spec 4.4 "Navigation und Filter").
+ */
+export function createNextPagesSource(options = {}) {
+    return {
+        kind: 'next-pages',
+        observe: async (ctx) => observeNavigation('next-pages', await enumeratePages(ctx.root, options, ctx.policy.exclude ?? []), ctx.root, ctx.config.locale, options.srcDir),
+    };
+}
+//# sourceMappingURL=next-pages.js.map

package/dist/codegen/tools/sources/next-pages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"next-pages.js","sourceRoot":"","sources":["../../../../src/codegen/tools/sources/next-pages.ts"],"names":[],"mappings":"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"}

package/dist/codegen/tools/sources/openapi-endpoints.d.ts

@@ -0,0 +1,17 @@
+import type { ToolSource } from '../types.js';
+export declare const OPENAPI_DEFAULT_DOCUMENT = "openapi.json";
+export interface OpenapiSourceOptions {
+    /** App-relative path of the exported OpenAPI 3.1 document. */
+    document?: string;
+    /** App-relative folder of the FastAPI code whose routes are counted against the export. */
+    fastapi?: string;
+    /** The Python interpreter that counts the routes; tests point it at a missing file. */
+    python?: string;
+}
+/**
+ * An exported OpenAPI 3.1 document (FastAPI writes one), read as JSON. With
+ * `fastapi` set, the routes of the FastAPI code are counted with Python's
+ * `ast` module (`python3 -I`, the app is never imported) and a stale export
+ * stops the refresh.
+ */
+export declare function createOpenapiEndpointSource(options?: OpenapiSourceOptions): ToolSource;