apps 1.0.0-beta.1 → 1.0.0-beta.3

package/dist/chunk-J5AVXTHA.js

@@ -1,154 +0,0 @@
-import {
-  __enterFile,
-  __leaveFile,
-  newRegistry,
-  setActiveRegistry
-} from "./chunk-LWKQDDLZ.js";
-import {
-  JsonSchemaObject,
-  PublishError
-} from "./chunk-B7NEUIJL.js";
-import {
-  collectRegistry
-} from "./chunk-RZA7AXBK.js";
-
-// src/manifest/index.ts
-import { fileURLToPath, pathToFileURL } from "node:url";
-import { Crypto, Effect, FileSystem, Schema, Semaphore } from "effect";
-var hasStandardJsonSchema = (input) => "~standard" in input && typeof input["~standard"].jsonSchema?.input === "function";
-var compileInputSchema = (input, where) => {
-  if ("~standard" in input) {
-    if (!hasStandardJsonSchema(input))
-      return {
-        problem: `${where}: input is a Standard Schema without the jsonSchema extension \u2014 use a library that implements it (zod 4+, effect Schema) or pass raw JSON schema`
-      };
-  }
-  try {
-    const compiled = strictify(
-      hasStandardJsonSchema(input) ? input["~standard"].jsonSchema.input({ target: "draft-2020-12" }) : structuredClone(input)
-    );
-    return { value: Schema.decodeUnknownSync(JsonSchemaObject)(compiled) };
-  } catch (error) {
-    return { problem: schemaPublishProblem(where, error) };
-  }
-};
-var schemaPublishProblem = (where, error) => `${where}: input schema could not compile to JSON schema (${error instanceof Error ? error.message : String(error)})`;
-var strictify = (node) => {
-  if (typeof node !== "object" || node === null) return node;
-  if (Array.isArray(node)) return node.map(strictify);
-  const object = { ...node };
-  if (object.type === "object" && object.additionalProperties === void 0)
-    object.additionalProperties = false;
-  for (const key of ["items", "anyOf", "oneOf", "allOf"])
-    if (key in object) object[key] = strictify(object[key]);
-  for (const key of ["properties", "$defs"])
-    if (object[key] !== void 0 && typeof object[key] === "object" && object[key] !== null)
-      object[key] = Object.fromEntries(
-        Object.entries(object[key]).map(([name, value]) => [
-          name,
-          strictify(value)
-        ])
-      );
-  return object;
-};
-var digestOf = (content) => Effect.gen(function* () {
-  const crypto = yield* Crypto.Crypto;
-  const bytes = yield* Effect.orDie(
-    crypto.digest("SHA-256", new TextEncoder().encode(content))
-  );
-  return Array.from(bytes.slice(0, 8), (byte) => byte.toString(16).padStart(2, "0")).join("");
-});
-var loadPermit = Semaphore.makeUnsafe(1);
-var runNonce = 0;
-var baseAppImports = /* @__PURE__ */ new Set();
-var moduleFailure = (where, error) => new PublishError({
-  problems: [
-    `${where}: failed to execute (${error instanceof Error ? error.message : String(error)})`
-  ]
-});
-var canonicalModuleUrl = (path, where) => Effect.gen(function* () {
-  const fs = yield* FileSystem.FileSystem;
-  const realPath = yield* fs.realPath(path).pipe(
-    Effect.mapError((error) => moduleFailure(where, error))
-  );
-  return pathToFileURL(realPath);
-});
-var importModule = (specifier, where) => Effect.tryPromise({
-  try: () => import(specifier).then(() => void 0),
-  catch: (error) => moduleFailure(where, error)
-});
-var recordModuleProblems = (registry, effect) => effect.pipe(
-  Effect.catchTag(
-    "PublishError",
-    (error) => Effect.sync(() => {
-      registry.problems.push(...error.problems.map((message) => ({ message })));
-    })
-  )
-);
-var executeModules = (appDir, files) => loadPermit.withPermit(
-  Effect.uninterruptibleMask(
-    (restore) => Effect.gen(function* () {
-      const registry = newRegistry();
-      const previous = yield* Effect.sync(() => setActiveRegistry(registry));
-      const nonce = yield* Effect.sync(() => ++runNonce);
-      const execute = Effect.gen(function* () {
-        __enterFile("app.ts");
-        yield* recordModuleProblems(
-          registry,
-          Effect.gen(function* () {
-            const appUrl = yield* canonicalModuleUrl(`${appDir}/app.ts`, "app.ts");
-            const baseUrl = appUrl.href;
-            const specifier = baseAppImports.has(baseUrl) ? `${fileURLToPath(appUrl)}?m=${nonce}` : baseUrl;
-            yield* importModule(specifier, "app.ts");
-            yield* Effect.sync(() => baseAppImports.add(baseUrl));
-          })
-        );
-        for (const file of files) {
-          const where = `tools/${file}`;
-          __enterFile(where);
-          yield* recordModuleProblems(
-            registry,
-            Effect.gen(function* () {
-              const url = yield* canonicalModuleUrl(`${appDir}/tools/${file}`, where);
-              yield* importModule(`${fileURLToPath(url)}?m=${nonce}`, where);
-            })
-          );
-        }
-      });
-      yield* restore(execute).pipe(
-        Effect.ensuring(
-          Effect.sync(() => {
-            __leaveFile();
-            setActiveRegistry(previous);
-          })
-        )
-      );
-      return registry;
-    })
-  )
-);
-var loadApp = (appDir) => Effect.gen(function* () {
-  const fs = yield* FileSystem.FileSystem;
-  const files = (yield* fs.readDirectory(`${appDir}/tools`).pipe(
-    Effect.mapError((error) => new PublishError({ problems: [`tools/: ${error.message}`] }))
-  )).filter((file) => file.endsWith(".ts")).sort();
-  const registry = yield* executeModules(appDir, files);
-  const collected = collectRegistry(registry, compileInputSchema);
-  if (collected.problems.length > 0)
-    return yield* new PublishError({ problems: collected.problems });
-  if (!("manifest" in collected))
-    return yield* Effect.die("validated registry projection unexpectedly missing");
-  return {
-    registry,
-    result: {
-      digest: `snap:${yield* digestOf(collected.canonical)}`,
-      ...collected.manifest
-    }
-  };
-});
-var manifest = (appDir) => Effect.map(loadApp(appDir), ({ result }) => result);
-
-export {
-  loadApp,
-  manifest
-};

package/dist/chunk-RZA7AXBK.js

@@ -1,107 +0,0 @@
-// src/manifest/collect.ts
-var collectRegistry = (registry, compileInputSchema) => {
-  const requirementKey = Symbol.for("executor/apps/requirement");
-  const problems = registry.problems.map((problem) => problem.message);
-  const app = registry.app;
-  const requirementSpecOf = (value) => typeof value === "object" && value !== null && requirementKey in value ? value[requirementKey] : void 0;
-  const canonicalJson = (value) => {
-    const sortKeys = (node) => {
-      if (Array.isArray(node)) return node.map(sortKeys);
-      if (typeof node === "object" && node !== null)
-        return Object.fromEntries(
-          Object.entries(node).sort(([left], [right]) => left.localeCompare(right)).map(([key, child]) => [key, sortKeys(child)])
-        );
-      return node;
-    };
-    return JSON.stringify(sortKeys(value));
-  };
-  const claims = /* @__PURE__ */ new Map();
-  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, requirement, where) => {
-    const spec = requirementSpecOf(requirement);
-    if (spec === void 0) {
-      problems.push(`${where}: requirement '${role}' is not a service/requirement value`);
-      return void 0;
-    }
-    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 !== void 0 && !(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 === void 0 ? {} : { grant: spec.grant },
-      ...spec.description === void 0 ? {} : { description: spec.description }
-    };
-  };
-  if (app === void 0) 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 = [];
-  if (app !== void 0) {
-    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 === void 0 ? [] : [collected];
-      }).sort((left, right) => left.role.localeCompare(right.role));
-      let compiled;
-      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 === void 0) 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 };
-  return {
-    problems: [],
-    manifest,
-    canonical: canonicalJson(manifest)
-  };
-};
-
-export {
-  collectRegistry
-};

package/dist/manifest/collect.d.ts

@@ -1,64 +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 declare const collectRegistry: (registry: Registry, compileInputSchema: (input: object, where: string) => InputSchemaCompilation) => RegistryCollection;
-export {};

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),
-  };
-};