@skaile/workspaces 6.16.0 → 6.17.0

package/dist/serve-preflight-XJS5OZML.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../cli/src/commands/serve-preflight.ts"],"names":[],"mappings":"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","file":"serve-preflight-XJS5OZML.js","sourcesContent":["/**\n * Start-up checks for `skaile serve`: fail with one actionable line before the\n * runner reports ready, instead of on the first prompt.\n */\n\nimport { statSync } from \"node:fs\";\nimport type { AgentRefLookups, PreflightAgentRef } from \"@skaile/workspaces/bridge\";\nimport {\n  type MergedAIProviderRegistry,\n  registryEntries,\n} from \"@skaile/workspaces/core/provider-registry\";\nimport { loadRegistryView } from \"./providers.ts\";\nimport {\n  DEFAULT_HARNESS_ID,\n  loadSkWorkspaceConfig,\n  primaryAgentRef,\n  resolveSettings,\n  resolveSkWorkspaceConfig,\n  SKAILE_YAML_DEFAULT,\n} from \"@skaile/workspaces/core\";\nimport {\n  connectorErrorLines,\n  connectorMountPathChecks,\n  unknownConnectorDriverErrors,\n} from \"../config-checks.ts\";\nimport { logWarn } from \"../helpers.ts\";\nimport { agentDefinitionProblem, instanceRefProblem } from \"./validate-instances.ts\";\n\n/**\n * Check that the model endpoint can load pi-ai, when `skaile serve` will start the\n * endpoint (`--model-endpoint`, or `model_endpoint.enabled` in skaile.yaml). Without\n * this the endpoint printed its ready line and answered every request with a 500.\n *\n * @param projectDir - Project the server serves.\n * @param flag - Parsed `--model-endpoint`, when given.\n * @param probe - Replaceable pi-ai check, for tests.\n * @returns The one-line problem (both places looked in, the install command), or `null`.\n */\nexport async function checkModelEndpointPeer(\n  projectDir: string,\n  flag: { enabled?: boolean } | undefined,\n  probe?: (projectDir: string) => Promise<string | null>,\n): Promise<string | null> {\n  const enabled =\n    flag?.enabled ?? resolveSkWorkspaceConfig(projectDir).model_endpoint?.enabled === true;\n  if (!enabled) return null;\n  const check = probe ?? (await import(\"@skaile/workspaces/model-endpoint\")).checkPiAiInstalled;\n  return check(projectDir);\n}\n\n/**\n * Resolve `--provider <name>`: it picks one AI provider registry entry, the way\n * `--providers <ids>` picks several. The session then holds that entry only.\n *\n * Fails, with one line, when the entry is not in the local registry\n * (`providers.yml` and the layers above it) or when `--providers` is given\n * too and does not list it. The registry check is skipped when the registry\n * comes from the host (`secrets.provider` other than `env`): the platform\n * sends its entries at `session_init`, after the server is up.\n *\n * @param projectDir - Project the server serves.\n * @param provider - `--provider`, when given.\n * @param providers - Ids of `--providers`, when given.\n * @param registry - Replaceable registry loader, for tests.\n * @returns The entry ids the session keeps, or the one-line problem.\n */\nexport function resolveServeProvider(\n  projectDir: string,\n  provider: string | undefined,\n  providers: readonly string[],\n  registry: () => MergedAIProviderRegistry = () => loadRegistryView({ projectDir }).merged,\n): { providers: readonly string[] } | { problem: string } {\n  const id = provider?.trim();\n  if (!id) return { providers };\n  if (providers.length > 0 && !providers.includes(id)) {\n    return {\n      problem: `--provider '${id}' is not in --providers (${providers.join(\", \")}). Use one of the two flags.`,\n    };\n  }\n  const secretsProvider = resolveSkWorkspaceConfig(projectDir).secrets?.provider;\n  if (!secretsProvider || secretsProvider === \"env\") {\n    const known = registryEntries(registry()).map(([entryId]) => entryId);\n    if (!known.includes(id)) {\n      return {\n        problem:\n          known.length > 0\n            ? `--provider: '${id}' is not an AI provider entry. Defined: ${known.join(\", \")}. Run: skaile providers list`\n            : `--provider: '${id}' is not an AI provider entry; none is defined. Run: skaile providers add`,\n      };\n    }\n  }\n  return { providers: providers.length > 0 ? providers : [id] };\n}\n\n/**\n * Check that `--project-dir` is an existing directory, before `serve` creates anything in it. A\n * missing folder used to fail with a raw `ENOENT` stack from the log store (p1732). A symlink to\n * a directory passes; a relative path is read from the current directory.\n *\n * @param projectDir - The `--project-dir` value as typed.\n * @returns The one-line problem, or `null` when the directory exists.\n */\nexport function checkServeProjectDir(projectDir: string): string | null {\n  try {\n    if (statSync(projectDir).isDirectory()) return null;\n  } catch {\n    // missing, a dangling link or unreadable: the same line\n  }\n  return `--project-dir: '${projectDir}' is not a directory`;\n}\n\n/**\n * The agent refs `skaile serve` resolves before it is ready: `agent.definition` and the `ref` of\n * every `agents:` instance in the project's `skaile.yaml`, for `preflight`. Without them `serve`\n * died with a raw `AgentRefResolutionError` stack for the definition and started with no word\n * for an instance it could not resolve.\n *\n * @param projectDir - Project the server serves.\n */\nexport function serveAgentRef(projectDir: string): PreflightAgentRef {\n  const config = resolveSkWorkspaceConfig(projectDir);\n  const definition = primaryAgentRef(config);\n  return {\n    ...(definition ? { definition } : {}),\n    instances: Object.fromEntries(\n      Object.entries(config.agent?.instances ?? {}).map(([id, instance]) => [id, instance.ref]),\n    ),\n  };\n}\n\n/**\n * How `preflight` resolves an agent ref: the `agent_ref_unresolved` rule `validate` applies, so\n * both print the same line (p1733).\n */\nexport const agentRefLookups: AgentRefLookups = {\n  definition: agentDefinitionProblem,\n  instance: instanceRefProblem,\n};\n\n/**\n * Whether the AI provider registry of this server is the local one. With `secrets.provider` other\n * than `env` the platform delivers its registry layer at `session_init`, after the server is up\n * (p1332), so the local registry cannot refuse a model.\n *\n * @param projectDir - Project the server serves.\n */\nexport function servesLocalRegistry(projectDir: string): boolean {\n  const secretsProvider = resolveSkWorkspaceConfig(projectDir).secrets?.provider;\n  return !secretsProvider || secretsProvider === \"env\";\n}\n\n/**\n * Check that the connectors `skaile.yaml` declares are ones the runner can mount: every\n * connector error `validate` gives (no `driver`, no `id`, a duplicate `id`, an `access` that is\n * neither `read-only` nor `read-write`, a `local` `mountPath` that is missing or reaches outside\n * the project through a symlink, a `driver` nothing provides). `serve` stops on exactly those and\n * prints the same lines. What `validate` only warns about (a `mountPath` outside the project) is\n * warned about too.\n *\n * @param projectDir - Project the server serves.\n * @returns One line per error, joined by newlines, or `null` when every connector is fine.\n */\nexport async function checkServeConnectors(projectDir: string): Promise<string | null> {\n  const file = loadSkWorkspaceConfig(projectDir);\n  const connectors = file?.config.connectors ?? [];\n  const mounts = connectorMountPathChecks(projectDir, SKAILE_YAML_DEFAULT, connectors);\n  for (const line of mounts.warnings) logWarn(line);\n  const lines = [\n    ...connectorErrorLines(file?.diagnostics ?? [], SKAILE_YAML_DEFAULT),\n    ...mounts.errors,\n    ...(await unknownConnectorDriverErrors(projectDir, SKAILE_YAML_DEFAULT, connectors)),\n  ];\n  return lines.length > 0 ? lines.join(\"\\n\") : null;\n}\n\n/**\n * The harness and the model `serve` hands to `preflight`. `--harness` overrides the harness of\n * `skaile.yaml`. Only an explicit `--model` is returned: a model from `skaile.yaml` may be served\n * by a provider the platform sends at `session_init`, so it is not judged before ready.\n */\nexport async function resolveServeStart(\n  projectDir: string,\n  overrides: { harness?: string; model?: string },\n): Promise<{ harness: string; model: string | undefined }> {\n  const settings = await resolveSettings(projectDir, {\n    ...(overrides.harness ? { harness: overrides.harness } : {}),\n    ...(overrides.model ? { model: overrides.model } : {}),\n  });\n  return {\n    harness: settings.harness ?? DEFAULT_HARNESS_ID,\n    model: overrides.model ? settings.model : undefined,\n  };\n}\n"]}