lastlight-shared 0.1.0

package/dist/providers.js

@@ -0,0 +1,279 @@
+/**
+ * Provider registry — single source of truth for the LLM providers Last Light
+ * knows how to wire end-to-end.
+ *
+ * pi-ai (`@earendil-works/pi-ai`) is provider-agnostic and supports 15+
+ * providers out of the box. Of those, only a subset is "wizard-able" here:
+ * they authenticate with a single API-key env var and expose a stable
+ * endpoint reachable from the sandbox egress firewall. Excluded are the
+ * OAuth-only providers (`openai-codex`, `github-copilot`), the multi-env
+ * Ambient-cred ones (`amazon-bedrock`, `google-vertex`, `azure-openai-*`,
+ * `cloudflare-*`), and the regional-CN variants.
+ *
+ * This registry is consumed by:
+ *   - `src/engine/llm.ts` — the cheap one-shot helper used by the
+ *     prompt screener + intent classifier. It builds requests for the
+ *     `openai-completions` family (which is most wizard-able providers —
+ *     Google and Mistral are routed through their OpenAI-compatible
+ *     endpoints) and the `anthropic-messages` family (Kimi for Coding,
+ *     MiniMax, Anthropic itself).
+ *   - `src/engine/agent-executor.ts` — forwards each provider's env var
+ *     into the sandbox so agentic-pi can auth.
+ *   - `src/sandbox/egress-allowlist.ts` — the SNI/firewall allowlist is
+ *     seeded from each provider's `host`.
+ *   - `src/cli/setup.ts` — the install wizard's step-4 provider picker.
+ *
+ * Keep this list aligned with pi-ai's provider registry. When pi-ai adds a
+ * new provider that we want to surface, add an entry here and everything
+ * else (forwarding, egress, wizard UI) follows automatically.
+ */
+/**
+ * The registry. Order matters — `defaultFastModel()` in `llm.ts` selects
+ * a fast model by iterating this list and picking the first provider
+ * whose env var is present. Always keep Anthropic first (best raw-latency
+ * cheap helper) then OpenAI then OpenRouter, then the rest grouped by
+ * families so the array is easy to scan.
+ */
+export const PROVIDERS = [
+    // ── Anthropic-messages family ───────────────────────────────────────
+    {
+        prefix: "anthropic",
+        displayName: "Anthropic",
+        envKey: "ANTHROPIC_API_KEY",
+        baseUrl: "https://api.anthropic.com/v1",
+        api: "anthropic-messages",
+        host: "anthropic.com",
+        fastModel: "claude-haiku-4-5-20251001",
+        sampleModel: "claude-sonnet-4-6",
+        keyPrefix: "sk-ant-",
+    },
+    {
+        prefix: "kimi-coding",
+        displayName: "Kimi for Coding (Moonshot)",
+        envKey: "KIMI_API_KEY",
+        baseUrl: "https://api.kimi.com/coding",
+        api: "anthropic-messages",
+        host: "kimi.com",
+        fastModel: "kimi-latest",
+        sampleModel: "kimi-latest",
+    },
+    {
+        prefix: "minimax",
+        displayName: "MiniMax",
+        envKey: "MINIMAX_API_KEY",
+        baseUrl: "https://api.minimax.io/anthropic",
+        api: "anthropic-messages",
+        host: "minimax.io",
+        fastModel: "MiniMax-M1",
+        sampleModel: "MiniMax-M2",
+    },
+    // ── OpenAI-completions family — first-party OpenAI ──────────────────
+    {
+        prefix: "openai",
+        displayName: "OpenAI",
+        envKey: "OPENAI_API_KEY",
+        baseUrl: "https://api.openai.com/v1",
+        api: "openai-completions",
+        host: "openai.com",
+        fastModel: "gpt-5.4-mini",
+        sampleModel: "gpt-5.5",
+        maxTokensField: "max_completion_tokens",
+        keyPrefix: "sk-",
+    },
+    // ── Google Gemini — routed through Google's OpenAI-compatible endpoint ──
+    {
+        prefix: "google",
+        displayName: "Google AI Studio (Gemini)",
+        envKey: "GEMINI_API_KEY",
+        baseUrl: "https://generativelanguage.googleapis.com/v1beta/openai",
+        api: "openai-completions",
+        host: "generativelanguage.googleapis.com",
+        fastModel: "gemini-2.5-flash",
+        sampleModel: "gemini-2.5-pro",
+        keyPrefix: "AIza",
+    },
+    // ── Mistral — Mistral exposes an OpenAI-compatible path ──────────────
+    {
+        prefix: "mistral",
+        displayName: "Mistral",
+        envKey: "MISTRAL_API_KEY",
+        baseUrl: "https://api.mistral.ai/v1",
+        api: "openai-completions",
+        host: "mistral.ai",
+        fastModel: "mistral-small-latest",
+        sampleModel: "mistral-large-latest",
+    },
+    // ── OpenAI-compatible inference specialists ──────────────────────────
+    {
+        prefix: "groq",
+        displayName: "Groq",
+        envKey: "GROQ_API_KEY",
+        baseUrl: "https://api.groq.com/openai/v1",
+        api: "openai-completions",
+        host: "groq.com",
+        fastModel: "llama-3.3-70b-versatile",
+        sampleModel: "llama-3.3-70b-versatile",
+    },
+    {
+        prefix: "cerebras",
+        displayName: "Cerebras",
+        envKey: "CEREBRAS_API_KEY",
+        baseUrl: "https://api.cerebras.ai/v1",
+        api: "openai-completions",
+        host: "cerebras.ai",
+        fastModel: "llama-3.3-70b",
+        sampleModel: "llama-3.3-70b",
+    },
+    {
+        prefix: "xai",
+        displayName: "xAI (Grok)",
+        envKey: "XAI_API_KEY",
+        baseUrl: "https://api.x.ai/v1",
+        api: "openai-completions",
+        host: "x.ai",
+        fastModel: "grok-3-mini",
+        sampleModel: "grok-4",
+    },
+    {
+        prefix: "huggingface",
+        displayName: "Hugging Face",
+        envKey: "HF_TOKEN",
+        baseUrl: "https://router.huggingface.co/v1",
+        api: "openai-completions",
+        host: "huggingface.co",
+        fastModel: "meta-llama/Llama-3.3-70B-Instruct",
+        sampleModel: "meta-llama/Llama-3.3-70B-Instruct",
+        keyPrefix: "hf_",
+    },
+    {
+        prefix: "moonshotai",
+        displayName: "Moonshot AI",
+        envKey: "MOONSHOT_API_KEY",
+        baseUrl: "https://api.moonshot.ai/v1",
+        api: "openai-completions",
+        host: "moonshot.ai",
+        fastModel: "kimi-k2",
+        sampleModel: "kimi-k2",
+    },
+    {
+        prefix: "nvidia",
+        displayName: "NVIDIA NIM",
+        envKey: "NVIDIA_API_KEY",
+        baseUrl: "https://integrate.api.nvidia.com/v1",
+        api: "openai-completions",
+        host: "integrate.api.nvidia.com",
+        fastModel: "meta/llama-3.3-70b-instruct",
+        sampleModel: "meta/llama-3.3-70b-instruct",
+    },
+    {
+        prefix: "fireworks",
+        displayName: "Fireworks",
+        envKey: "FIREWORKS_API_KEY",
+        baseUrl: "https://api.fireworks.ai/inference/v1",
+        api: "openai-completions",
+        host: "fireworks.ai",
+        fastModel: "accounts/fireworks/models/llama-v3p3-70b-instruct",
+        sampleModel: "accounts/fireworks/models/llama-v3p3-70b-instruct",
+    },
+    {
+        prefix: "together",
+        displayName: "Together",
+        envKey: "TOGETHER_API_KEY",
+        baseUrl: "https://api.together.ai/v1",
+        api: "openai-completions",
+        host: "together.ai",
+        fastModel: "meta-llama/Llama-3.3-70B-Instruct-Turbo",
+        sampleModel: "meta-llama/Llama-3.3-70B-Instruct-Turbo",
+    },
+    {
+        prefix: "deepseek",
+        displayName: "DeepSeek",
+        envKey: "DEEPSEEK_API_KEY",
+        baseUrl: "https://api.deepseek.com/v1",
+        api: "openai-completions",
+        host: "deepseek.com",
+        fastModel: "deepseek-chat",
+        sampleModel: "deepseek-chat",
+    },
+    {
+        prefix: "zai",
+        displayName: "Z.AI (GLM)",
+        envKey: "ZAI_API_KEY",
+        baseUrl: "https://api.z.ai/api/coding/paas/v4",
+        api: "openai-completions",
+        host: "z.ai",
+        fastModel: "glm-4.6",
+        sampleModel: "glm-4.6",
+    },
+    // ── OpenRouter — aggregator (take any pi.dev-listed model via one key) ──
+    {
+        prefix: "openrouter",
+        displayName: "OpenRouter (aggregator — Anthropic, Google, xAI, …)",
+        envKey: "OPENROUTER_API_KEY",
+        baseUrl: "https://openrouter.ai/api/v1",
+        api: "openai-completions",
+        host: "openrouter.ai",
+        fastModel: "google/gemini-2.5-flash",
+        sampleModel: "anthropic/claude-sonnet-4.5",
+        preserveNestedModelId: true,
+        extraHeaders: {
+            "HTTP-Referer": "https://github.com/nearform/lastlight",
+            "X-Title": "Last Light",
+        },
+        keyPrefix: "sk-or-",
+    },
+];
+const PREFIX_INDEX = new Map(PROVIDERS.map((p) => [p.prefix, p]));
+const ENV_INDEX = new Map(PROVIDERS.map((p) => [p.envKey, p]));
+export function providerByPrefix(prefix) {
+    return PREFIX_INDEX.get(prefix.toLowerCase());
+}
+export function providerByEnvKey(envKey) {
+    return ENV_INDEX.get(envKey);
+}
+/** All the env var names a harness must forward to reach every registered provider. */
+export const PROVIDER_ENV_KEYS = PROVIDERS.map((p) => p.envKey);
+/** All the hosts the sandbox egress firewall must allowlist to reach these providers. */
+export const PROVIDER_HOSTS = PROVIDERS.map((p) => p.host);
+/**
+ * Default model spec shipped with the harness. Keep aligned with the
+ * `OPENCODE_MODEL` default in `config/default.yaml` and the wizard's
+ * initial provider selection.
+ */
+export const DEFAULT_PROVIDER = "anthropic";
+export const DEFAULT_MODEL = "anthropic/claude-sonnet-4-6";
+export const OAUTH_PROVIDERS = [
+    {
+        id: "openai-codex",
+        displayName: "ChatGPT Plus/Pro (Codex)",
+        modelPrefix: "openai-codex",
+        sampleModel: "openai-codex/gpt-5.4",
+        sandboxEnvVar: null, // chatgpt.com backend — no env route, chat-only
+        oauthOnly: true,
+    },
+    {
+        id: "anthropic",
+        displayName: "Anthropic (Claude Pro/Max)",
+        modelPrefix: "anthropic",
+        sampleModel: "anthropic/claude-sonnet-4-6",
+        sandboxEnvVar: "ANTHROPIC_OAUTH_TOKEN",
+        oauthOnly: false, // falls back to ANTHROPIC_API_KEY
+    },
+    {
+        id: "github-copilot",
+        displayName: "GitHub Copilot",
+        modelPrefix: "github-copilot",
+        sampleModel: "github-copilot/gpt-4o",
+        sandboxEnvVar: "COPILOT_GITHUB_TOKEN",
+        oauthOnly: true,
+    },
+];
+const OAUTH_PREFIX_INDEX = new Map(OAUTH_PROVIDERS.map((p) => [p.modelPrefix, p]));
+const OAUTH_ID_INDEX = new Map(OAUTH_PROVIDERS.map((p) => [p.id, p]));
+export function oauthProviderByModelPrefix(prefix) {
+    return OAUTH_PREFIX_INDEX.get(prefix);
+}
+export function oauthProviderById(id) {
+    return OAUTH_ID_INDEX.get(id);
+}
+//# sourceMappingURL=providers.js.map

package/dist/providers.js.map

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

package/dist/workflow-loader.d.ts

@@ -0,0 +1,53 @@
+import { type AgentWorkflowDefinition, type CronWorkflowDefinition } from "lastlight-workflow-engine";
+import type { DisabledConfig, RouteConfig } from "./config-types.js";
+export interface WorkflowAssetConfig {
+    builtInRoot?: string;
+    overlayRoot?: string;
+    disabled?: Partial<DisabledConfig>;
+}
+export interface WorkflowOrigin {
+    layer: string;
+    filePath: string;
+}
+/** Configure ordered asset layers. Built-ins load first; overlay wins by logical name. */
+export declare function configureWorkflowAssets(config?: WorkflowAssetConfig): void;
+/** Legacy wrapper used by older tests to point directly at a workflow directory. */
+export declare function setWorkflowDir(dir: string): void;
+export declare function clearWorkflowCache(): void;
+/** Monotonic counter bumped on every asset-layer reconfigure / cache clear. */
+export declare function getAssetVersion(): number;
+export declare function getWorkflow(name: string): AgentWorkflowDefinition;
+export declare function getCronWorkflows(): CronWorkflowDefinition[];
+export declare function listAgentWorkflows(): AgentWorkflowDefinition[];
+/**
+ * The enabled workflow that claims a given classifier intent via its
+ * `classification.intent`, if any. Backs the router's data-driven fallback: an
+ * intent the router's bespoke switch doesn't handle routes to its owning
+ * workflow. Returns undefined for control intents and unclaimed tokens.
+ */
+export declare function getWorkflowByIntent(intent: string): AgentWorkflowDefinition | undefined;
+export declare function getWorkflowOrigin(name: string): WorkflowOrigin | undefined;
+export declare function getCronWorkflowOrigin(name: string): WorkflowOrigin | undefined;
+export declare function loadWorkflowYamlRaw(name: string): string;
+export declare function loadPromptTemplate(relativePath: string): string;
+export declare function resolvePromptPath(relativePath: string): string;
+export declare function loadSkillRaw(name: string): string;
+export declare function loadSkillInstructions(name: string): string;
+/**
+ * Resolve a list of skill names to their absolute directory paths.
+ * Each returned path is the skill folder root (containing `SKILL.md`
+ * plus any `scripts/`, `references/`, `assets/`) — not the .md file.
+ * The sandbox staging step in agent-executor uses these to symlink or
+ * copy the whole folder into the phase's bundle at
+ * `<workspaceRoot>/.lastlight-skills/<phase>/<name>/`.
+ * Layer-aware: overlay skills win over built-ins (same precedence and
+ * disabled-skill handling as `loadSkillRaw`).
+ */
+export declare function resolveSkillPaths(names: readonly string[]): string[];
+/**
+ * Concatenate resolved agent-context/*.md with overlay filename replacement.
+ * Later layers replace earlier files by basename; disabled.agentContext removes
+ * either exact filenames (rules.md) or stem names (rules).
+ */
+export declare function loadAgentContext(): string;
+export declare function validateAssets(routes?: RouteConfig): void;