glirastes 0.3.2 → 0.5.0

package/dist/codegen/tools/artifact.js

@@ -0,0 +1,199 @@
+import { z } from 'zod';
+import { APP_SETUP_EXCLUSION_LIMITS, AppSetupArtifactSchema, ToolRiskClassSchema, } from '../../contracts/index.js';
+import { confirmationFloor } from '../../contracts/tool-policy.js';
+import { modelFacingToolName } from '../../runtime/local-tool-bindings.js';
+import { canonicalRuntimeJson } from '../../sync/signature-verifier.js';
+import { canonicalJson, compareCodeUnits, deterministicUuid, sha256Digest } from './canonical.js';
+import { sortFindings, TRANSIENT_FINDING_CODES } from './findings.js';
+export const EPOCH = '1970-01-01T00:00:00.000Z';
+const PLACEHOLDER_ID = '00000000-0000-4000-8000-000000000000';
+/**
+ * The Platform accepts at most 5,000 exclusions with stable keys of at most
+ * 512 characters (P08b Task 9). One oversized entry would reject the whole
+ * capability report, so longer keys are left out and the list is cut in
+ * code-unit order. `tool-report.json` keeps the complete list.
+ */
+export function clipExclusions(excluded) {
+    const byKey = new Map();
+    for (const entry of excluded) {
+        if (entry.stableKey.length > APP_SETUP_EXCLUSION_LIMITS.maxStableKeyLength)
+            continue;
+        if (!byKey.has(entry.stableKey))
+            byKey.set(entry.stableKey, { stableKey: entry.stableKey, origin: entry.origin });
+    }
+    return [...byKey.values()]
+        .sort((left, right) => compareCodeUnits(left.stableKey, right.stableKey))
+        .slice(0, APP_SETUP_EXCLUSION_LIMITS.maxEntries);
+}
+export function promptMetadata(bundle) {
+    return {
+        bundleDigest: sha256Digest(canonicalRuntimeJson(bundle.sections)),
+        artifactRef: bundle.artifactRef,
+        plannerDigest: sha256Digest(bundle.sections.planner),
+        appBehaviorDigest: sha256Digest(bundle.sections.appBehavior),
+        responseStyleDigest: sha256Digest(bundle.sections.responseStyle),
+        capabilityFragmentDigests: Object.fromEntries(Object.entries(bundle.sections.capabilityFragments)
+            .sort(([left], [right]) => compareCodeUnits(left, right))
+            .map(([name, content]) => [name, sha256Digest(content)])),
+    };
+}
+function candidate(tool) {
+    const { execution, prose, effective } = tool;
+    const base = {
+        toolId: execution.toolId,
+        sourceFingerprint: execution.sourceFingerprint,
+        name: execution.definitionId,
+        description: prose.description,
+        modelName: modelFacingToolName(execution.definitionId),
+        module: prose.module,
+        sharedWith: [...prose.sharedWith],
+        usageHints: [...prose.usageHints],
+        presentation: prose.presentation,
+        allowedRoles: [...effective.allowedRoles].sort(compareCodeUnits),
+        operationGroup: tool.operationGroup,
+        riskClass: effective.riskClass,
+        enabled: effective.enabled,
+        requiresApproval: confirmationFloor(effective.riskClass, effective.requiresApproval),
+        inputSchemaDigest: execution.inputSchemaDigest,
+        outputSchemaDigest: execution.outputSchemaDigest,
+        ...(tool.provenance ? { provenance: tool.provenance } : {}),
+    };
+    if (execution.executionKind === 'endpoint') {
+        return {
+            ...base,
+            executionKind: 'endpoint',
+            method: execution.method,
+            path: execution.path,
+            authBindingRef: 'endpoint-authorization',
+        };
+    }
+    return { ...base, executionKind: 'ui', actionBindingRef: execution.actionBindingRef };
+}
+function withoutIdentity(artifact) {
+    const { artifactId: _artifactId, runId: _runId, generatedAt: _generatedAt, ...content } = artifact;
+    return content;
+}
+function contentDigestOf(content) {
+    return sha256Digest(canonicalJson(content));
+}
+export function buildSetupArtifact(input) {
+    const tools = input.tools.map(candidate).sort((left, right) => compareCodeUnits(left.toolId, right.toolId));
+    const previousPlanner = input.previous?.planner ?? input.previous?.artifact?.planner;
+    const warnings = [...new Map(input.warnings.map((warning) => [`${warning.code}|${warning.subjectRef}`, warning])).values()]
+        .sort((left, right) => compareCodeUnits(left.code, right.code) || compareCodeUnits(left.subjectRef, right.subjectRef));
+    const draft = AppSetupArtifactSchema.parse({
+        schemaVersion: 1,
+        artifactId: PLACEHOLDER_ID,
+        runId: PLACEHOLDER_ID,
+        appId: input.appId,
+        discoveryDigest: input.discoveryDigest,
+        assessmentMode: 'autonomous',
+        status: tools.some((tool) => tool.operationGroup === 'needs_attention') ? 'review' : 'ready',
+        tools,
+        planner: {
+            plannerId: previousPlanner?.plannerId ?? deterministicUuid(input.appId, ['planner']),
+            modelBindingRef: previousPlanner?.modelBindingRef ?? 'default',
+            promptBindingRef: previousPlanner?.promptBindingRef ?? `prompt:${input.targetAppKey}`,
+            budgetProfileRef: previousPlanner?.budgetProfileRef ?? 'default',
+            toolIds: tools.filter((tool) => tool.enabled).map((tool) => tool.toolId),
+        },
+        prompts: promptMetadata(input.promptBundle),
+        warnings,
+        ...(input.exclusions ? { exclusions: clipExclusions(input.exclusions) } : {}),
+        generatedAt: EPOCH,
+    });
+    const contentDigest = contentDigestOf(withoutIdentity(draft));
+    const previous = input.previous?.artifact;
+    const generatedAt = previous && contentDigestOf(withoutIdentity(previous)) === contentDigest
+        ? previous.generatedAt
+        : input.now ? input.now().toISOString() : previous?.generatedAt ?? EPOCH;
+    const artifact = AppSetupArtifactSchema.parse({
+        ...draft,
+        artifactId: deterministicUuid(input.appId, ['setup-artifact', contentDigest]),
+        runId: deterministicUuid(input.appId, ['setup-run', contentDigest]),
+        generatedAt,
+    });
+    return { artifact, raw: canonicalJson(artifact) };
+}
+export function renderToolContracts(appId, entries) {
+    return canonicalJson({
+        schemaVersion: 1,
+        appId,
+        tools: [...entries].sort((left, right) => compareCodeUnits(left.toolId, right.toolId)),
+    });
+}
+export function schemaQualityOf(contract, resolutionOrigin) {
+    if (!contract)
+        return 'none';
+    switch (contract.source) {
+        case 'native':
+        case 'contract-module':
+        case 'legacy-ai-tool':
+            return 'zod';
+        case 'ui-bridge':
+            // Pages, URL parsers and payload types are read from code as JSON Schema.
+            return contract.runtime.input.kind === 'module-export' ? 'zod' : 'json-schema';
+        case 'openapi':
+            return 'openapi';
+        case 'derived':
+            return 'field-names';
+        case 'resolution':
+            if (resolutionOrigin === 'agent')
+                return 'agent';
+            return contract.runtime.input.kind === 'module-export' ? 'zod' : 'json-schema';
+    }
+}
+export const ToolReportFileSchema = z.object({
+    schemaVersion: z.literal(1),
+    appId: z.uuid(),
+    discoveryDigest: z.string(),
+    tools: z.array(z.object({
+        toolId: z.uuid(),
+        stableKey: z.string(),
+        definitionId: z.string(),
+        enabled: z.boolean(),
+        riskClass: ToolRiskClassSchema,
+        requiresApproval: z.boolean(),
+        contractSource: z.enum([
+            'native', 'contract-module', 'legacy-ai-tool', 'resolution', 'openapi', 'derived', 'ui-bridge',
+        ]).nullable(),
+        quality: z.object({
+            description: z.enum(['human', 'code', 'agent', 'template']),
+            schema: z.enum(['zod', 'openapi', 'json-schema', 'agent', 'field-names', 'none']),
+        }).strict(),
+    }).strict()),
+    findings: z.array(z.object({
+        code: z.string(),
+        severity: z.enum(['error', 'needs_attention', 'warning']),
+        subjectRef: z.string(),
+        nextAction: z.string(),
+    }).strict()),
+    excluded: z.array(z.object({
+        stableKey: z.string(),
+        reason: z.string(),
+        origin: z.enum(['default', 'policy', 'code']),
+    }).strict()),
+}).strict();
+/** Content-free state report: no messages, no change-relative findings. */
+export function renderToolReport(input) {
+    const seen = new Set();
+    const findings = sortFindings(input.findings)
+        .filter((finding) => !TRANSIENT_FINDING_CODES.has(finding.code))
+        .filter((finding) => {
+        const key = `${finding.severity}|${finding.code}|${finding.subjectRef}`;
+        if (seen.has(key))
+            return false;
+        seen.add(key);
+        return true;
+    })
+        .map(({ code, severity, subjectRef, nextAction }) => ({ code, severity, subjectRef, nextAction }));
+    return canonicalJson({
+        schemaVersion: 1,
+        appId: input.appId,
+        discoveryDigest: input.discoveryDigest,
+        tools: [...input.tools].sort((left, right) => compareCodeUnits(left.stableKey, right.stableKey)),
+        findings,
+        excluded: [...input.excluded].sort((left, right) => compareCodeUnits(left.stableKey, right.stableKey)),
+    });
+}
+//# sourceMappingURL=artifact.js.map

package/dist/codegen/tools/artifact.js.map

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

package/dist/codegen/tools/canonical.d.ts

@@ -0,0 +1,12 @@
+import { type LocalJsonSchema } from '../../runtime/json-schema.js';
+/** Locale-independent ordering so outputs are byte-identical across Node versions. */
+export declare function compareCodeUnits(left: string, right: string): number;
+export declare function sortKeysDeep(value: unknown): unknown;
+/** Canonical file form for every generator-owned JSON output. */
+export declare function canonicalJson(value: unknown): string;
+export declare function sha256Digest(value: string): string;
+/** UUIDv5-shaped identifier scoped to the app; same inputs, same identifier. */
+export declare function deterministicUuid(appId: string, parts: ReadonlyArray<string>): string;
+export declare const OPAQUE_JSON_SCHEMA: LocalJsonSchema;
+/** Must equal what the runtime computes for `createJsonSchemaLike(schema)` at boot. */
+export declare function jsonSchemaDigest(schema: LocalJsonSchema): string;

package/dist/codegen/tools/canonical.js

@@ -0,0 +1,41 @@
+import { createHash } from 'node:crypto';
+import { createJsonSchemaLike } from '../../runtime/json-schema.js';
+import { createLocalSchemaDigest } from '../../runtime/local-tool-bindings.js';
+/** Locale-independent ordering so outputs are byte-identical across Node versions. */
+export function compareCodeUnits(left, right) {
+    return left < right ? -1 : left > right ? 1 : 0;
+}
+export function sortKeysDeep(value) {
+    if (Array.isArray(value))
+        return value.map(sortKeysDeep);
+    if (value === null || typeof value !== 'object')
+        return value;
+    return Object.fromEntries(Object.keys(value)
+        .sort(compareCodeUnits)
+        .map((key) => [key, sortKeysDeep(value[key])]));
+}
+/** Canonical file form for every generator-owned JSON output. */
+export function canonicalJson(value) {
+    return `${JSON.stringify(sortKeysDeep(value), null, 2)}\n`;
+}
+export function sha256Digest(value) {
+    return `sha256:${createHash('sha256').update(value).digest('base64url')}`;
+}
+/** UUIDv5-shaped identifier scoped to the app; same inputs, same identifier. */
+export function deterministicUuid(appId, parts) {
+    const bytes = createHash('sha1')
+        .update(Buffer.from(appId.replaceAll('-', ''), 'hex'))
+        .update(JSON.stringify(['glirastes.tools.v1', ...parts]))
+        .digest()
+        .subarray(0, 16);
+    bytes[6] = (bytes[6] & 0x0f) | 0x50;
+    bytes[8] = (bytes[8] & 0x3f) | 0x80;
+    const hex = bytes.toString('hex');
+    return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`;
+}
+export const OPAQUE_JSON_SCHEMA = Object.freeze({});
+/** Must equal what the runtime computes for `createJsonSchemaLike(schema)` at boot. */
+export function jsonSchemaDigest(schema) {
+    return createLocalSchemaDigest(createJsonSchemaLike(schema));
+}
+//# sourceMappingURL=canonical.js.map

package/dist/codegen/tools/canonical.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonical.js","sourceRoot":"","sources":["../../../src/codegen/tools/canonical.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,oBAAoB,EAAwB,MAAM,8BAA8B,CAAC;AAC1F,OAAO,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AAE/E,sFAAsF;AACtF,MAAM,UAAU,gBAAgB,CAAC,IAAY,EAAE,KAAa;IAC1D,OAAO,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IACzD,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC9D,OAAO,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC;SACzC,IAAI,CAAC,gBAAgB,CAAC;SACtB,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,YAAY,CAAE,KAAiC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACjF,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;AAC7D,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,OAAO,UAAU,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC;AAC5E,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,iBAAiB,CAAC,KAAa,EAAE,KAA4B;IAC3E,MAAM,KAAK,GAAG,UAAU,CAAC,MAAM,CAAC;SAC7B,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC;SACrD,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,oBAAoB,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC;SACxD,MAAM,EAAE;SACR,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACnB,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAE,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IACrC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAE,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IACrC,MAAM,GAAG,GAAG,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAClC,OAAO,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;AAC7G,CAAC;AAED,MAAM,CAAC,MAAM,kBAAkB,GAAoB,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAErE,uFAAuF;AACvF,MAAM,UAAU,gBAAgB,CAAC,MAAuB;IACtD,OAAO,uBAAuB,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC,CAAC;AAC/D,CAAC"}

package/dist/codegen/tools/chat-interactions.d.ts

@@ -0,0 +1,27 @@
+import { type ChatInteractionsData } from '../../contracts/chat-interactions.js';
+import type { AppSetupArtifact } from '../../contracts/index.js';
+import type { ToolContractsEntry } from './types.js';
+export interface DeriveChatInteractionsInput {
+    artifact: AppSetupArtifact;
+    contracts: ReadonlyArray<ToolContractsEntry>;
+}
+/** `my-tasks`, `myTasks`, `my_tasks` → `My tasks`. */
+export declare function humanizeIdentifier(value: string): string;
+/**
+ * Derives the chat's `@` entities and `/` commands from the enabled tools,
+ * a pure function of the setup artifact and the tool contracts:
+ *
+ * - entities from read endpoints with a search parameter (`search`, `q`,
+ *   `query`, `term`) whose output lists objects with an id and a label;
+ * - entity actions from endpoints with exactly one path parameter below the
+ *   entity's collection (`PATCH /api/tasks/:id`), and "Open" from pages with
+ *   one parameter of the entity (`/tasks/:taskId`);
+ * - commands from navigation (one per page without parameters), URL
+ *   filters and client actions.
+ *
+ * Labels are English and German defaults from identifiers; overrides and
+ * skills replace them. Bounded and sorted, so the module stays byte-stable;
+ * an entry the protocol cannot carry is dropped alone, so app code never
+ * makes the generated module (and `tools refresh`) fail here.
+ */
+export declare function deriveChatInteractions(input: DeriveChatInteractionsInput): ChatInteractionsData;