glirastes 0.3.2 → 0.5.0

package/dist/codegen/tools/sources/react-actions.d.ts

@@ -0,0 +1,12 @@
+import type { ToolSource } from '../types.js';
+export interface ReactActionSourceOptions {
+    /** Where registrations are searched; `src` when the app has one, else the app root. */
+    srcDir?: string;
+}
+/**
+ * The `react-actions` source: one `ui.<actionId>` tool per literal client
+ * action id registered with `useAiClientAction`, `registerAiClientAction`,
+ * `useAiClientActionById` or `bus.subscribeById` (spec 4.4). It also reports
+ * stateful UI controls that no client action reaches yet (`ui-control-unbound`).
+ */
+export declare function createReactActionSource(options?: ReactActionSourceOptions): ToolSource;

package/dist/codegen/tools/sources/react-actions.js

@@ -0,0 +1,341 @@
+import ts from 'typescript';
+import { canonicalJson, compareCodeUnits } from '../canonical.js';
+import { toolFinding } from '../findings.js';
+import { typeToJsonSchema } from '../output-inference.js';
+import { createAppProgram } from '../program.js';
+import { scanAppSources } from './app-files.js';
+import { analyzeUiControls, CONTROL_TEXT } from './ui-controls.js';
+import { actionStableKey, importedCalls, incompleteUiSource, uiDefinitionIdForAction, uiObservation, uniqueDefinitionIds, } from './ui-tools.js';
+const REGISTRATION_SPECS = [
+    { module: 'glirastes/react', names: ['useAiClientAction', 'useAiClientActionById'] },
+    { module: 'glirastes/browser', names: ['registerAiClientAction'] },
+];
+const BUS_MODULES = new Set(['glirastes/react', 'glirastes/browser']);
+const REGISTRATION_TEXT = /useAiClientAction|registerAiClientAction|subscribeById/;
+const WRITE_METHODS = new Set(['POST', 'PUT', 'PATCH', 'DELETE']);
+/** Calls of mutation hooks (React Query, SWR) whose effect the generator cannot see. */
+const MUTATION_CALLS = new Set(['mutate', 'mutateAsync', 'trigger']);
+const EMPTY_PAYLOAD = { type: 'object', properties: {}, additionalProperties: false };
+function unwrap(expression) {
+    let current = expression;
+    while (ts.isParenthesizedExpression(current) || ts.isAsExpression(current) || ts.isSatisfiesExpression(current)) {
+        current = current.expression;
+    }
+    return current;
+}
+function literalId(expression) {
+    if (!expression)
+        return undefined;
+    const value = unwrap(expression);
+    return ts.isStringLiteralLike(value) ? value.text : undefined;
+}
+function importsBus(source) {
+    return source.statements.some((statement) => (ts.isImportDeclaration(statement)
+        && ts.isStringLiteral(statement.moduleSpecifier)
+        && BUS_MODULES.has(statement.moduleSpecifier.text)
+        && !statement.importClause?.isTypeOnly));
+}
+/** The function a handler argument stands for: inline, `useCallback(fn)` or a named function. */
+function functionOf(app, raw, depth = 0) {
+    if (!raw || depth > 4)
+        return undefined;
+    const expression = unwrap(raw);
+    if (ts.isArrowFunction(expression) || ts.isFunctionExpression(expression))
+        return expression;
+    if (ts.isCallExpression(expression) && ts.isIdentifier(expression.expression)
+        && expression.expression.text === 'useCallback') {
+        return functionOf(app, expression.arguments[0], depth + 1);
+    }
+    if (ts.isIdentifier(expression)) {
+        let symbol = app.checker.getSymbolAtLocation(expression);
+        if (symbol && symbol.flags & ts.SymbolFlags.Alias)
+            symbol = app.checker.getAliasedSymbol(symbol);
+        const declaration = symbol?.valueDeclaration;
+        if (declaration && ts.isFunctionDeclaration(declaration))
+            return declaration;
+        if (declaration && ts.isVariableDeclaration(declaration))
+            return functionOf(app, declaration.initializer, depth + 1);
+    }
+    return undefined;
+}
+function objectSchema(app, type, location) {
+    const schema = typeToJsonSchema(app.checker, type, location);
+    if (schema.type !== 'object' || typeof schema.properties !== 'object' || schema.properties === null)
+        return undefined;
+    return { ...schema, additionalProperties: false };
+}
+/** Contract (`z.infer` via `_output`) first, then the handler's parameter type; undefined when untyped. */
+function payloadSchema(app, registration) {
+    const checker = app.checker;
+    if (registration.contract) {
+        const contractType = checker.getTypeAtLocation(registration.contract);
+        const output = checker.getPropertyOfType(contractType, '_output');
+        if (output) {
+            const schema = objectSchema(app, checker.getTypeOfSymbolAtLocation(output, registration.contract), registration.contract);
+            if (schema)
+                return schema;
+        }
+    }
+    const handler = functionOf(app, registration.handler);
+    if (!handler)
+        return undefined;
+    const parameter = handler.parameters[0];
+    if (!parameter)
+        return EMPTY_PAYLOAD;
+    let type = checker.getTypeAtLocation(parameter);
+    if (registration.style === 'action') {
+        const payload = checker.getPropertyOfType(type, 'payload');
+        if (!payload)
+            return undefined;
+        type = checker.getNonNullableType(checker.getTypeOfSymbolAtLocation(payload, parameter));
+    }
+    return objectSchema(app, type, parameter);
+}
+/**
+ * A declaration a call can run code of: a function, method or class, a module imported
+ * as a namespace, or a variable initialised with a function or an object of methods.
+ * Fields, parameters and constants are data: a method on them is a built-in or a
+ * property of a shared type, not a function of another app file.
+ */
+function holdsCode(declaration) {
+    if (ts.isFunctionDeclaration(declaration) || ts.isMethodDeclaration(declaration)
+        || ts.isClassDeclaration(declaration) || ts.isSourceFile(declaration))
+        return true;
+    if (!ts.isVariableDeclaration(declaration) || !declaration.initializer)
+        return false;
+    const initializer = unwrap(declaration.initializer);
+    return ts.isArrowFunction(initializer) || ts.isFunctionExpression(initializer) || ts.isObjectLiteralExpression(initializer);
+}
+/** The app file that declares what a call refers to, when it is not the handler's own file. */
+function otherAppFile(app, callee, ownFile) {
+    const receiver = ts.isPropertyAccessExpression(callee) ? callee.expression : undefined;
+    let symbol = app.checker.getSymbolAtLocation(receiver ?? callee);
+    if (symbol && symbol.flags & ts.SymbolFlags.Alias)
+        symbol = app.checker.getAliasedSymbol(symbol);
+    // A called identifier is callable by definition; a receiver counts only when it holds code.
+    const declaration = receiver ? symbol?.declarations?.find(holdsCode) : symbol?.declarations?.[0];
+    const file = declaration ? app.appRelative(declaration.getSourceFile().fileName) : undefined;
+    return file && file !== ownFile ? file : undefined;
+}
+function calleeLabel(callee) {
+    if (ts.isIdentifier(callee))
+        return callee.text;
+    if (ts.isPropertyAccessExpression(callee))
+        return `${calleeLabel(callee.expression)}.${callee.name.text}`;
+    return 'a computed function';
+}
+/** What the handler body shows about writing (spec 4.5 "nachweisbar"). */
+function writeEvidence(app, handler) {
+    const body = handler && 'body' in handler ? handler.body : undefined;
+    if (!body)
+        return { writes: false };
+    const ownFile = app.appRelative(body.getSourceFile().fileName) ?? '';
+    let writes = false;
+    let unproven;
+    const visit = (node) => {
+        if (writes)
+            return;
+        if (ts.isCallExpression(node)) {
+            const callee = node.expression;
+            if (ts.isIdentifier(callee) && callee.text === 'fetch') {
+                const options = node.arguments[1] ? unwrap(node.arguments[1]) : undefined;
+                const method = options && ts.isObjectLiteralExpression(options)
+                    ? options.properties.find((property) => ((ts.isPropertyAssignment(property) || ts.isShorthandPropertyAssignment(property))
+                        && ts.isIdentifier(property.name) && property.name.text === 'method'))
+                    : undefined;
+                const value = method && ts.isPropertyAssignment(method) ? unwrap(method.initializer) : undefined;
+                if (value && ts.isStringLiteralLike(value)) {
+                    if (WRITE_METHODS.has(value.text.toUpperCase()))
+                        writes = true;
+                }
+                else if (options && (!ts.isObjectLiteralExpression(options) || method || options.properties.some(ts.isSpreadAssignment))) {
+                    unproven ??= 'fetch with a method the generator cannot read';
+                }
+            }
+            else if (ts.isPropertyAccessExpression(callee) && ts.isIdentifier(callee.expression)
+                && callee.expression.text === 'axios' && ['post', 'put', 'patch', 'delete'].includes(callee.name.text)) {
+                writes = true;
+            }
+            else {
+                const name = ts.isIdentifier(callee) ? callee.text : ts.isPropertyAccessExpression(callee) ? callee.name.text : undefined;
+                if (name && MUTATION_CALLS.has(name)) {
+                    unproven ??= `${calleeLabel(callee)}()`;
+                }
+                else {
+                    const file = otherAppFile(app, callee, ownFile);
+                    if (file)
+                        unproven ??= `${calleeLabel(callee)} from ${file}`;
+                }
+            }
+        }
+        ts.forEachChild(node, visit);
+    };
+    visit(body);
+    return writes ? { writes } : { writes, ...(unproven ? { unproven } : {}) };
+}
+function docOf(source, node) {
+    if (!node)
+        return undefined;
+    const text = source.getFullText();
+    const ranges = ts.getLeadingCommentRanges(text, node.getFullStart()) ?? [];
+    const block = [...ranges].reverse().find((range) => text.startsWith('/**', range.pos));
+    if (!block)
+        return undefined;
+    const lines = text.slice(block.pos + 3, block.end - 2).split('\n')
+        .map((line) => line.replace(/^\s*\*\s?/, '').trim())
+        .filter((line) => line.length > 0 && !line.startsWith('@'));
+    return lines.length > 0 ? lines.join(' ') : undefined;
+}
+function statementOf(node) {
+    let current = node;
+    while (current && !ts.isExpressionStatement(current) && !ts.isVariableStatement(current))
+        current = current.parent;
+    return current;
+}
+function registrationsOf(source, file, findings) {
+    const found = [];
+    for (const { name, call } of importedCalls(source, REGISTRATION_SPECS)) {
+        found.push(name === 'useAiClientActionById'
+            ? { file, style: 'action', id: call.arguments[1], handler: call.arguments[2], contract: undefined, call }
+            : { file, style: 'payload', id: call.arguments[0], handler: call.arguments[1], contract: call.arguments[2], call });
+    }
+    if (importsBus(source)) {
+        const visit = (node) => {
+            if (ts.isCallExpression(node) && ts.isPropertyAccessExpression(node.expression)
+                && node.expression.name.text === 'subscribeById') {
+                found.push({ file, style: 'action', id: node.arguments[0], handler: node.arguments[1], contract: undefined, call: node });
+            }
+            ts.forEachChild(node, visit);
+        };
+        visit(source);
+    }
+    const registrations = [];
+    for (const { id, ...entry } of found.sort((left, right) => left.call.getStart() - right.call.getStart())) {
+        const actionId = literalId(id);
+        const line = source.getLineAndCharacterOfPosition(entry.call.getStart()).line + 1;
+        if (actionId === undefined) {
+            findings.push(toolFinding('ui-action-id-dynamic', 'warning', `${file}:${line}`, 'A client action is registered with an id that is not a literal, so the chat cannot call it.'));
+            continue;
+        }
+        if (actionId.startsWith('glirastes.')) {
+            findings.push(toolFinding('ui-action-id-reserved', 'warning', `${file}:${line}`, `${actionId} belongs to the SDK and is not a client action of this app.`));
+            continue;
+        }
+        registrations.push({ ...entry, actionId });
+    }
+    return registrations;
+}
+async function observeActions(ctx, options) {
+    const { root } = ctx;
+    // Every file is read: a control's setter may be used anywhere; only candidates enter the program.
+    const scan = await scanAppSources(root, {
+        ...(options.srcDir ? { srcDir: options.srcDir } : {}),
+        matches: () => true,
+    });
+    if (!scan.complete)
+        return incompleteUiSource('react-actions', scan.reason);
+    const files = scan.files.filter((file) => REGISTRATION_TEXT.test(file.source) || CONTROL_TEXT.test(file.source));
+    if (files.length === 0)
+        return { observations: [], findings: [], complete: true, excluded: [] };
+    const app = createAppProgram({ root, rootNames: files.map((file) => file.absolute) });
+    const findings = [];
+    const byId = new Map();
+    for (const file of files) {
+        const source = app.sourceFile(file.absolute);
+        if (!source)
+            continue;
+        for (const registration of registrationsOf(source, file.path, findings)) {
+            byId.set(registration.actionId, [...byId.get(registration.actionId) ?? [], registration]);
+        }
+    }
+    const named = [];
+    for (const [actionId, registrations] of byId) {
+        const base = uiDefinitionIdForAction(actionId);
+        if (base === undefined) {
+            findings.push(toolFinding('ui-action-id-invalid', 'warning', registrations[0].file, `${JSON.stringify(actionId)} cannot become a tool name.`));
+            continue;
+        }
+        named.push({ actionId, base });
+    }
+    const ids = uniqueDefinitionIds(named.map(({ actionId, base }) => ({ stableKey: actionStableKey(actionId), base })));
+    const controls = analyzeUiControls({
+        app,
+        files,
+        allFiles: scan.files,
+        registrations: [...byId].flatMap(([actionId, registrations]) => registrations.map((registration) => ({
+            actionId,
+            stableKey: actionStableKey(actionId),
+            handler: registration.handler,
+            schema: payloadSchema(app, registration),
+        }))),
+        policy: ctx.policy,
+        functionOf: (expression) => functionOf(app, expression),
+        writes: (fn) => writeEvidence(app, fn).writes,
+    });
+    findings.push(...controls.findings);
+    const observations = named
+        .sort((left, right) => compareCodeUnits(left.actionId, right.actionId))
+        .map(({ actionId }) => {
+        const stableKey = actionStableKey(actionId);
+        const registrations = byId.get(actionId);
+        const schemas = registrations.map((registration) => payloadSchema(app, registration));
+        const typed = [...new Map(schemas
+                .filter((schema) => schema !== undefined)
+                .map((schema) => [canonicalJson(schema), schema])).values()];
+        const handlers = registrations.map((registration) => functionOf(app, registration.handler));
+        const toolFindings = [...controls.byStableKey.get(stableKey) ?? []];
+        if (typed.length === 0) {
+            toolFindings.push(toolFinding('ui-action-payload-untyped', 'needs_attention', stableKey, `${actionId} has neither a payload contract nor a typed handler parameter.`));
+        }
+        else if (typed.length > 1) {
+            toolFindings.push(toolFinding('ui-action-contract-conflict', 'needs_attention', stableKey, `${actionId} is registered with ${typed.length} different payload contracts.`));
+        }
+        const input = typed[0];
+        const jsDoc = registrations
+            .map((registration, index) => {
+            const handler = handlers[index];
+            return docOf(registration.call.getSourceFile(), statementOf(registration.call))
+                ?? (handler && ts.isFunctionDeclaration(handler) ? docOf(handler.getSourceFile(), handler) : undefined);
+        })
+            .find((doc) => doc !== undefined);
+        const evidence = handlers.map((handler) => writeEvidence(app, handler));
+        const uiMutation = evidence.some((entry) => entry.writes);
+        const unproven = evidence.find((entry) => entry.unproven)?.unproven;
+        if (!uiMutation && unproven) {
+            toolFindings.push(toolFinding('ui-action-write-unproven', 'warning', stableKey, `${actionId} calls ${unproven}; if that changes data, raise the tool to write so the chat asks first.`));
+        }
+        return uiObservation({
+            stableKey,
+            definitionId: ids.get(stableKey),
+            actionBindingRef: actionId,
+            ...(input ? { input } : {}),
+            uiAction: { kind: 'client-action', actionId },
+            params: {
+                path: [],
+                query: [],
+                body: Object.keys((input?.properties ?? {})).sort(compareCodeUnits),
+            },
+            facts: {
+                actionId,
+                files: [...new Set(registrations.map((registration) => registration.file))].sort(compareCodeUnits),
+                payloads: typed,
+                uiMutation,
+            },
+            findings: toolFindings,
+            files: [...new Set(registrations.map((registration) => registration.file))].sort(compareCodeUnits),
+            ...(jsDoc ? { jsDoc } : {}),
+            ...(uiMutation ? { uiMutation } : {}),
+        });
+    });
+    return { observations, findings, complete: true, excluded: [] };
+}
+/**
+ * The `react-actions` source: one `ui.<actionId>` tool per literal client
+ * action id registered with `useAiClientAction`, `registerAiClientAction`,
+ * `useAiClientActionById` or `bus.subscribeById` (spec 4.4). It also reports
+ * stateful UI controls that no client action reaches yet (`ui-control-unbound`).
+ */
+export function createReactActionSource(options = {}) {
+    return { kind: 'react-actions', observe: (ctx) => observeActions(ctx, options) };
+}
+//# sourceMappingURL=react-actions.js.map

package/dist/codegen/tools/sources/react-actions.js.map

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

package/dist/codegen/tools/sources/route-config.d.ts

@@ -0,0 +1,49 @@
+import ts from 'typescript';
+import type { ToolSource } from '../types.js';
+import { type PageTree } from './page-tree.js';
+import { type ImportSpec } from './ui-tools.js';
+import type { PolicyExcludeRule } from '../exclusions.js';
+/** How one router library declares its route objects. */
+interface RouterDialect {
+    kind: 'react-router' | 'vue-router';
+    specs: ReadonlyArray<ImportSpec>;
+    /** Calls that receive the route array. */
+    calls: ReadonlyArray<string>;
+    /** The route array is the first argument (react-router) or its `routes` property (vue-router). */
+    routesIn: 'argument' | 'routes-property';
+    components: ReadonlyArray<string>;
+    lazy: ReadonlyArray<string>;
+    marker: RegExp;
+    /** What the component of a route may be, named when it cannot be resolved. */
+    unresolved: string;
+}
+declare const DIALECTS: {
+    readonly 'react-router': RouterDialect;
+    readonly 'vue-router': RouterDialect;
+};
+export type RouterKind = keyof typeof DIALECTS;
+export interface RouteConfigOptions {
+    /** Where the route objects are searched; `src` when the app has one, else the app root. */
+    srcDir?: string;
+}
+/**
+ * Pages of a react-router or vue-router app: the route object arrays given
+ * to `createBrowserRouter`, `createHashRouter`, `createMemoryRouter` or
+ * `useRoutes`, or the `routes` of vue-router's `createRouter`. JSX routes,
+ * spread or computed routes and aliases make the enumeration incomplete
+ * instead of silently missing pages.
+ */
+export declare function enumerateRouteConfigPages(root: string, options: RouteConfigOptions, policyExcludes: ReadonlyArray<PolicyExcludeRule>, router?: RouterKind): Promise<PageTree>;
+/** The declaration of a page component in its module: a named export or `default`. */
+export declare function componentDeclaration(source: ts.SourceFile, component: string): ts.Node | undefined;
+/**
+ * The `react-router` source: one `ui.navigate` tool whose destinations are
+ * the app's route objects, executed by the navigation bridge.
+ */
+export declare function createReactRouterSource(options?: RouteConfigOptions): ToolSource;
+/**
+ * The `vue-router` source: one `ui.navigate` tool whose destinations are the
+ * routes of `createRouter`, executed by `registerNavigationBridge`.
+ */
+export declare function createVueRouterSource(options?: RouteConfigOptions): ToolSource;
+export {};