apps 1.0.0-beta.0 → 1.0.0-beta.2

package/src/manifest/collect.ts

@@ -1,198 +0,0 @@
-import type { AuthMethod, ParamSpec, Registry } from "../authoring/index";
-
-type JsonValue = null | boolean | number | string | readonly JsonValue[] | {
-  readonly [key: string]: JsonValue;
-};
-type JsonSchemaObject = Readonly<Record<string, JsonValue>>;
-
-interface CollectedClaim {
-  readonly origin: string;
-  readonly reach: readonly string[];
-  readonly params: Readonly<Record<string, ParamSpec>>;
-  readonly auth: Readonly<Record<string, AuthMethod>>;
-}
-
-interface CollectedRequirement {
-  readonly role: string;
-  readonly service: string;
-  readonly arity: "one" | "optional" | "many";
-  readonly grant?: string;
-  readonly description?: string;
-}
-
-interface CollectedTool {
-  readonly address: string;
-  readonly name: string;
-  readonly description: string;
-  readonly inputSchema: JsonSchemaObject;
-  readonly annotations: {
-    readonly readOnly?: boolean;
-    readonly destructive?: boolean;
-    readonly scopes?: readonly string[];
-  };
-  readonly requires: readonly CollectedRequirement[];
-  readonly file: string;
-}
-
-interface CollectedManifest {
-  readonly app: { readonly key: string; readonly label: string; readonly description: string };
-  readonly services: readonly CollectedClaim[];
-  readonly tools: readonly CollectedTool[];
-}
-
-/** Result of compiling one authored input schema during registry projection. */
-export type InputSchemaCompilation =
-  | { readonly value: JsonSchemaObject }
-  | { readonly problem: string };
-
-/** Registry projection before the deployment-specific digest implementation. */
-export type RegistryCollection =
-  | { readonly problems: readonly string[] }
-  | {
-      readonly problems: readonly [];
-      readonly manifest: CollectedManifest;
-      readonly canonical: string;
-    };
-
-/**
- * Validate and project an executed authoring registry into deterministic data.
- *
- * This function is deliberately closure-free: the workerd runner injects its
- * source into the guest while the local manifest calls the same function
- * directly. Schema compilation is supplied because each runtime owns its
- * boundary decoder.
- */
-export const collectRegistry = (
-  registry: Registry,
-  compileInputSchema: (input: object, where: string) => InputSchemaCompilation,
-): RegistryCollection => {
-  const requirementKey = Symbol.for("executor/apps/requirement");
-  const problems = registry.problems.map((problem) => problem.message);
-  const app = registry.app;
-
-  const requirementSpecOf = (value: unknown) =>
-    typeof value === "object" && value !== null && requirementKey in value
-      ? (value as Record<PropertyKey, unknown>)[requirementKey] as {
-          readonly service: {
-            readonly origin: string;
-            readonly auth?: Readonly<Record<string, unknown>>;
-          };
-          readonly arity: "one" | "optional" | "many";
-          readonly grant?: string;
-          readonly description?: string;
-        }
-      : undefined;
-
-  const canonicalJson = (value: unknown): string => {
-    const sortKeys = (node: unknown): unknown => {
-      if (Array.isArray(node)) return node.map(sortKeys);
-      if (typeof node === "object" && node !== null)
-        return Object.fromEntries(
-          Object.entries(node as Record<string, unknown>)
-            .sort(([left], [right]) => left.localeCompare(right))
-            .map(([key, child]) => [key, sortKeys(child)]),
-        );
-      return node;
-    };
-    return JSON.stringify(sortKeys(value));
-  };
-
-  const claims = new Map<string, CollectedClaim>();
-  for (const [origin, registered] of registry.services) {
-    if (registered.file !== "app.ts") continue;
-    const { decl } = registered;
-    claims.set(origin, {
-      origin,
-      reach: decl.reach ?? [],
-      params: decl.params ?? {},
-      auth: decl.auth ?? {},
-    });
-  }
-
-  const collectRequirement = (
-    role: string,
-    requirement: unknown,
-    where: string,
-  ): CollectedRequirement | undefined => {
-    const spec = requirementSpecOf(requirement);
-    if (spec === undefined) {
-      problems.push(`${where}: requirement '${role}' is not a service/requirement value`);
-      return undefined;
-    }
-    const origin = spec.service.origin;
-    if (!claims.has(origin))
-      problems.push(`${where}: requirement '${role}' names ${origin}, which app.ts does not declare`);
-    if (spec.grant !== undefined && !(spec.grant in (spec.service.auth ?? {})))
-      problems.push(
-        `${where}: requirement '${role}' pins grant '${spec.grant}', not a auth method on ${origin}`,
-      );
-    return {
-      role,
-      service: origin,
-      arity: spec.arity,
-      ...(spec.grant === undefined ? {} : { grant: spec.grant }),
-      ...(spec.description === undefined ? {} : { description: spec.description }),
-    };
-  };
-
-  if (app === undefined) problems.push("app.ts must call defineApp({...})");
-  else if (typeof app.description !== "string" || app.description.trim().length === 0)
-    problems.push("app.ts: app description must not be empty");
-
-  for (const [file, summary] of registry.toolFiles) {
-    if (summary.definitions > 1 && summary.hasUnnamedTool)
-      problems.push(`${file}: multi-tool files must name every tool`);
-  }
-
-  const tools: CollectedTool[] = [];
-  if (app !== undefined) {
-    for (const [name, registered] of registry.tools) {
-      const { spec, file } = registered;
-      const address = `${app.key}/${name}`;
-      if (typeof spec.description !== "string" || spec.description.trim().length === 0)
-        problems.push(`${file}: tool '${name}' description must not be empty`);
-      const requires = Object.entries(spec.requirements ?? {})
-        .flatMap(([role, requirement]) => {
-          const collected = collectRequirement(role, requirement, address);
-          return collected === undefined ? [] : [collected];
-        })
-        .sort((left, right) => left.role.localeCompare(right.role));
-      let compiled: InputSchemaCompilation;
-      try {
-        compiled = compileInputSchema(spec.input, address);
-      } catch (error) {
-        compiled = {
-          problem: `${address}: input schema could not compile to JSON schema (${
-            error instanceof Error ? error.message : String(error)
-          })`,
-        };
-      }
-      if ("problem" in compiled) {
-        problems.push(compiled.problem);
-        continue;
-      }
-      tools.push({
-        address,
-        name,
-        description: spec.description,
-        inputSchema: compiled.value,
-        annotations: spec.annotations ?? {},
-        requires,
-        file,
-      });
-    }
-  }
-
-  if (problems.length > 0 || app === undefined) return { problems };
-  const services = [...claims.values()].sort((left, right) =>
-    left.origin.localeCompare(right.origin),
-  );
-  const sortedTools = [...tools].sort((left, right) => left.address.localeCompare(right.address));
-  const appResult = { key: app.key, label: app.label, description: app.description };
-  const manifest = { app: appResult, services, tools: sortedTools } satisfies CollectedManifest;
-  return {
-    problems: [],
-    manifest,
-    canonical: canonicalJson(manifest),
-  };
-};