melchizedek-agents 0.9.6 → 0.16.0

package/dist/lib/config.d.ts

@@ -19,7 +19,7 @@
  * Default Gemini model used by the A2A server when no model is specified
  * in the caller's YAML or request.
  *
- * Use gemini-3.1-flash-lite for lightweight/cost-efficient loads (subagents,
+ * Use gemini-3.5-flash-lite for lightweight/cost-efficient loads (subagents,
  * data retrieval). Use gemini-3.8-flash in YAML for production orchestrators.
  *
  * NOTE: gemini-2.5-flash is known incompatible with this framework's
@@ -28,7 +28,7 @@
  *
  * Supported Gemini identifiers: https://ai.google.dev/gemini-api/docs/models
  */
-export declare const DEFAULT_GEMINI_MODEL = "gemini-3.1-flash-lite";
+export declare const DEFAULT_GEMINI_MODEL = "gemini-3.5-flash-lite";
 /**
  * Default Claude model used by the A2A server when a claude-* model is
  * requested but no specific identifier is provided.
@@ -47,14 +47,14 @@ export declare const DEFAULT_GPT_MODEL = "gpt-5-mini";
 /**
  * Default xAI model used when a grok-* model is requested but no specific
  * identifier is provided. Requires XAI_API_KEY (lib/models/grokLlm.ts).
- * grok-4.5 is a reasoning model (reasoning cannot be disabled); it returns
+ * grok-4.7 is a reasoning model (reasoning cannot be disabled); it returns
  * reasoning summaries, which the adapter surfaces as thinking.
  */
-export declare const DEFAULT_GROK_MODEL = "grok-4.5";
+export declare const DEFAULT_GROK_MODEL = "grok-4.7";
 /**
- * Reasoning effort sent with grok-4.5 requests: 'low' | 'medium' | 'high'
- * (xAI's own default is 'high'). Pinned to MEDIUM — deeper than low
- * without high's latency and token cost. Source: docs.x.ai › Model
+ * Reasoning effort sent with grok-4.5/4.7 requests: 'low' | 'medium' | 'high'
+ * (xAI's own default is 'high'; 4.7 adds 'xhigh'). Pinned to MEDIUM — deeper
+ * than low without high's latency and token cost. Source: docs.x.ai › Model
  * capabilities › Text › Reasoning › Effort levels. Older grok ids don't
  * accept the param and never receive it (lib/models/grokLlm.ts).
  */

package/dist/lib/config.js

@@ -20,7 +20,7 @@
  * Default Gemini model used by the A2A server when no model is specified
  * in the caller's YAML or request.
  *
- * Use gemini-3.1-flash-lite for lightweight/cost-efficient loads (subagents,
+ * Use gemini-3.5-flash-lite for lightweight/cost-efficient loads (subagents,
  * data retrieval). Use gemini-3.8-flash in YAML for production orchestrators.
  *
  * NOTE: gemini-2.5-flash is known incompatible with this framework's
@@ -29,7 +29,7 @@
  *
  * Supported Gemini identifiers: https://ai.google.dev/gemini-api/docs/models
  */
-export const DEFAULT_GEMINI_MODEL = 'gemini-3.1-flash-lite';
+export const DEFAULT_GEMINI_MODEL = 'gemini-3.5-flash-lite';
 /**
  * Default Claude model used by the A2A server when a claude-* model is
  * requested but no specific identifier is provided.
@@ -48,14 +48,14 @@ export const DEFAULT_GPT_MODEL = 'gpt-5-mini';
 /**
  * Default xAI model used when a grok-* model is requested but no specific
  * identifier is provided. Requires XAI_API_KEY (lib/models/grokLlm.ts).
- * grok-4.5 is a reasoning model (reasoning cannot be disabled); it returns
+ * grok-4.7 is a reasoning model (reasoning cannot be disabled); it returns
  * reasoning summaries, which the adapter surfaces as thinking.
  */
-export const DEFAULT_GROK_MODEL = 'grok-4.5';
+export const DEFAULT_GROK_MODEL = 'grok-4.7';
 /**
- * Reasoning effort sent with grok-4.5 requests: 'low' | 'medium' | 'high'
- * (xAI's own default is 'high'). Pinned to MEDIUM — deeper than low
- * without high's latency and token cost. Source: docs.x.ai › Model
+ * Reasoning effort sent with grok-4.5/4.7 requests: 'low' | 'medium' | 'high'
+ * (xAI's own default is 'high'; 4.7 adds 'xhigh'). Pinned to MEDIUM — deeper
+ * than low without high's latency and token cost. Source: docs.x.ai › Model
  * capabilities › Text › Reasoning › Effort levels. Older grok ids don't
  * accept the param and never receive it (lib/models/grokLlm.ts).
  */

package/dist/lib/doctor.d.ts

@@ -0,0 +1,145 @@
+/**
+ * lib/doctor.ts — the onboarding walkthrough, generated from the truth.
+ *
+ * WHY this file exists:
+ *   The question every newcomer asks — "which keys do I need?" — used to be
+ *   answered by prose in four documents that drift. The doctor answers it
+ *   from the YAMLs and the environment: every syndicate the loader can see,
+ *   every agent's model, the provider that id routes to, whether that path
+ *   is funded (direct key, gateway, or local), and which declared
+ *   server-side tools the path will drop. Then it says exactly what to set,
+ *   grouped by how much each variable unlocks.
+ *
+ * WHAT IT NEVER DOES:
+ *   - edit .env or any file;
+ *   - send a request (demo_model_optionality.ts is the live proof);
+ *   - print a key VALUE. Only names of env vars appear (secrets-hygiene).
+ *
+ * The routing and capability judgments are not re-implemented here: they
+ * come from lib/models/gateway.ts and lib/models/capabilities.ts, the same
+ * modules the registry and the A2A server use, so the report cannot
+ * disagree with what a run would do.
+ */
+import type { Platform } from './models/endpoints.ts';
+import type { CapabilityGap, CapabilityReport } from './models/capabilities.ts';
+import type { ProviderId } from './models/providerMap.ts';
+/**
+ * What a file costs to run: `keyless` (all Ollama), a single provider's id
+ * when every agent shares one (`gemini`, `anthropic`, `openai`, `xai` — one
+ * key runs it), or `multi-provider` when the models mix.
+ */
+export type Tier = 'keyless' | Exclude<ProviderId, 'ollama'> | 'multi-provider';
+export interface DoctorRow {
+    /** Agent name as declared; nested syndicates read "Parent › Child". */
+    agent: string;
+    role: 'orchestrator' | 'subagent';
+    model: string;
+    report: CapabilityReport;
+    /**
+     * What this agent's YAML asks of its model that the resolved path does not
+     * fully give it (lib/models/capabilities.ts, ADR 0019). Gaps never block a
+     * syndicate; they are printed so a degraded role is not a surprise.
+     */
+    gaps: CapabilityGap[];
+}
+export type VerdictState = 'ready' | 'ready-local' | 'via-gateway' | 'blocked';
+export interface DoctorSyndicate {
+    /** Path relative to the agents dir, e.g. "examples/council.yaml". */
+    file: string;
+    name: string;
+    tier: Tier;
+    /** The `# tier:` header comment, when the file declares one. */
+    declaredTier?: string;
+    rows: DoctorRow[];
+    verdict: {
+        state: VerdictState;
+        detail: string;
+    };
+    /** `npm run <script>` when package.json has an alias for this file. */
+    runCommand?: string;
+    /**
+     * A load, parse or validation error (every problem, one per line). Rows
+     * are empty when the file itself failed; a nested failure keeps the rows
+     * that did resolve.
+     */
+    error?: string;
+    /**
+     * Long-term memory only: the namespace its facts are filed under
+     * (ADR 0020), and what is wrong with it, if anything.
+     */
+    memory?: {
+        namespace: string;
+        declared: boolean;
+        issue?: string;
+    };
+}
+export interface Unlock {
+    env: string;
+    provider: ProviderId;
+    label: string;
+    consoleUrl: string;
+    /** Syndicates this one variable would move from blocked to ready. */
+    syndicates: string[];
+}
+export interface DoctorResult {
+    agentsDir: string;
+    syndicates: DoctorSyndicate[];
+    unlocks: Unlock[];
+    gateway: {
+        id: string;
+        label: string;
+        usable: boolean;
+        problem?: string;
+    } | null;
+    /** Every provider not on its default endpoint: a cloud platform or a proxy (ADR 0023). */
+    endpoints: DoctorEndpoint[];
+    counts: Record<VerdictState, number>;
+}
+export interface DoctorEndpoint {
+    provider: ProviderId;
+    platform: Platform | 'invalid';
+    label: string;
+    /** How it authenticates; a cloud credential chain is not exercised by the doctor. */
+    credential: string;
+    /** The platform SDK it needs beyond the provider's own, and whether it resolves. */
+    sdk?: {
+        module: string;
+        installed: boolean;
+    };
+    problems: string[];
+    /** Cloud platforms are tested against mocks only (ADR 0023). */
+    liveVerified: boolean;
+}
+/** One row per provider that is not on its vendor's public API with an env key. */
+export declare function endpointRows(): DoctorEndpoint[];
+export declare const CONSOLE_URLS: Record<ProviderId, string>;
+/**
+ * Every syndicate file the loader can see: the root (this deployment's
+ * live syndicates), examples/ (the starter pack) and templates/ (the
+ * production templates). The schema document
+ * and evals/ are skipped — one is not a syndicate, the others exist to be
+ * measured, not served (config/agents/README.md).
+ */
+export declare function listSyndicateFiles(agentsDir: string): string[];
+/** The `# tier:` comment in the file's leading comment block, if any. */
+export declare function declaredTierOf(filePath: string): string | undefined;
+/** The tier the models actually imply. */
+export declare function tierOf(rows: readonly DoctorRow[]): Tier;
+/** `npm run <alias>` for a file, read from package.json scripts. */
+export declare function runCommandFor(file: string, scripts: Record<string, string> | undefined): string | undefined;
+export declare function diagnoseSyndicate(file: string, agentsDir: string, scripts?: Record<string, string>): DoctorSyndicate;
+/**
+ * ADR 0020: a long-term syndicate declares the namespace its facts are filed
+ * under, and two syndicates share memory only by declaring the same one.
+ * Checked for the deployment's own files (the agents-dir root). The shipped
+ * examples and templates are copied before use, and a copy gets its own
+ * namespace from `npm run doctor -- --fix-namespaces <file>`.
+ */
+export declare function flagMemoryNamespaces(syndicates: DoctorSyndicate[]): void;
+export declare function runDoctor(options?: {
+    agentsDir?: string;
+    scripts?: Record<string, string>;
+}): DoctorResult;
+export declare function renderDoctor(result: DoctorResult, opts?: {
+    color?: boolean;
+}): string;