@moda-ai/cli 1.22.1 → 1.23.0

package/dist/init/sdk-guide.js

@@ -1,185 +0,0 @@
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
-import { dirname, join } from 'node:path';
-import { readBundledIndex } from '../skills-bundled.js';
-import { renderCatalogListing } from './sdk-catalog.js';
-export const SDK_GUIDE_PATH = '.moda/SDK_INTEGRATION.md';
-/**
- * Write the human/agent-readable fallback guide (.moda/SDK_INTEGRATION.md).
- * Used when automatic SDK integration did not complete successfully.
- */
-export function writeSdkIntegrationGuide(cwd = process.cwd()) {
-    const relativePath = SDK_GUIDE_PATH;
-    const absolutePath = join(cwd, relativePath);
-    const content = renderSdkIntegrationGuideContent();
-    mkdirSync(dirname(absolutePath), { recursive: true });
-    writeFileSync(absolutePath, content);
-    return relativePath;
-}
-export function renderSdkIntegrationGuideContent() {
-    const index = readBundledIndex();
-    const catalogSection = index
-        ? [
-            '## Available integration skills',
-            '',
-            renderCatalogListing(index),
-            '',
-            'During `moda init`, Moda materializes these skills into a temporary catalog for your',
-            'coding agent. To integrate by hand, read the matching skill inside the installed CLI',
-            'package (`.../@moda-ai/cli/skills/integration/<id>/SKILL.md`), re-run `moda init` with',
-            'a coding agent CLI installed, or follow https://docs.moda.dev/ingestion.',
-            '',
-        ]
-        : [
-            '## Available integration skills',
-            '',
-            '_The bundled skill index is unavailable in this install; use the generic steps below',
-            'and https://docs.moda.dev/ingestion for stack-specific guidance._',
-            '',
-        ];
-    return [
-        '# Moda SDK Integration Guide',
-        '',
-        'Generated by `moda init`. **The SDK integration was not applied automatically.**',
-        'This checklist gets you there by hand or with your coding agent.',
-        '',
-        ...catalogSection,
-        '## 1. Install the SDK',
-        '',
-        'Install the Moda SDK for your stack with **your** package manager. If a catalog skill',
-        'above matches your repo, use its exact package name and install command.',
-        '',
-        'Examples (adapt to your stack):',
-        '',
-        'Node.js / TypeScript:',
-        '',
-        '```bash',
-        'npm install moda-ai   # or: bun add / pnpm add / yarn add',
-        '```',
-        '',
-        'Python:',
-        '',
-        '```bash',
-        'pip install moda-ai   # or: uv add / poetry add',
-        '```',
-        '',
-        'Do not paste `MODA_API_KEY` into source or `.env` files. Keep it in your deployment',
-        'environment, secret manager, or local shell.',
-        '',
-        '## 2. Initialize Moda before LLM clients',
-        '',
-        'Initialize before any LLM client is created.',
-        '',
-        'Node.js / TypeScript (example):',
-        '',
-        '```ts',
-        "import { Moda } from 'moda-ai';",
-        '',
-        'await Moda.init(process.env.MODA_API_KEY!);',
-        '```',
-        '',
-        'Python (example):',
-        '',
-        '```python',
-        'import os',
-        '',
-        'import moda',
-        '',
-        'moda.init(os.environ["MODA_API_KEY"])',
-        '```',
-        '',
-        '## 3. Set conversation and user context',
-        '',
-        'Set a stable conversation id before each LLM call, and a user id when one user can be',
-        'identified. For concurrent request handlers, use scoped context helpers from the SDK',
-        'instead of setting global context across overlapping requests.',
-        '',
-        'Node.js / TypeScript (example):',
-        '',
-        '```ts',
-        'Moda.conversationId = sessionId;',
-        'Moda.userId = userId;',
-        '```',
-        '',
-        'Python (example):',
-        '',
-        '```python',
-        'moda.conversation_id = session_id',
-        'moda.user_id = user_id',
-        '```',
-        '',
-        '## 4. Flush before exit',
-        '',
-        'Node.js / TypeScript: `await Moda.flush();` — Python: `moda.flush()`.',
-        '',
-        '## 5. Validate',
-        '',
-        'Tenant health (does not prove this integration by itself):',
-        '',
-        '```bash',
-        'moda doctor --online --json',
-        '```',
-        '',
-        'Exact-trace confirmation: send one request through your app with a known conversation id,',
-        'then run `moda audit <that-id>` — you should see your llm span(s).',
-        '',
-    ].join('\n');
-}
-/** Read optional harness discovery context from `.moda/harness.json`. */
-export function readRuntimeSummary(cwd) {
-    const empty = {
-        runtimeAgents: 0,
-        agentFamilies: 0,
-        frameworks: [],
-        providers: [],
-        runtimeAgentNames: [],
-    };
-    const path = join(cwd, '.moda', 'harness.json');
-    if (!existsSync(path))
-        return empty;
-    try {
-        const parsed = JSON.parse(readFileSync(path, 'utf8'));
-        if (!isRecord(parsed))
-            return empty;
-        const runtimeAgents = Array.isArray(parsed.runtimeAgents) ? parsed.runtimeAgents : [];
-        const agentFamilies = Array.isArray(parsed.agentFamilies) ? parsed.agentFamilies : [];
-        const frameworks = Array.isArray(parsed.agentFrameworks) ? parsed.agentFrameworks : [];
-        const providers = Array.isArray(parsed.modelProviders) ? parsed.modelProviders : [];
-        return {
-            runtimeAgents: runtimeAgents.length,
-            agentFamilies: agentFamilies.length,
-            runtimeAgentNames: runtimeAgents
-                .map((agent) => isRecord(agent) && typeof agent.name === 'string' ? agent.name : undefined)
-                .filter((name) => Boolean(name)),
-            frameworks: frameworks
-                .map((framework) => isRecord(framework) && typeof framework.name === 'string' ? framework.name : undefined)
-                .filter((name) => Boolean(name)),
-            providers: providers
-                .map((provider) => isRecord(provider) && typeof provider.name === 'string' ? provider.name : undefined)
-                .filter((name) => Boolean(name)),
-        };
-    }
-    catch {
-        return empty;
-    }
-}
-export function renderRuntimeSummaryBlock(summary) {
-    const runtimeNames = summary.runtimeAgentNames.slice(0, 8);
-    const lines = [
-        `- Runtime agents: ${summary.runtimeAgents}`,
-        `- Agent families: ${summary.agentFamilies}`,
-    ];
-    if (summary.frameworks.length > 0) {
-        lines.push(`- Frameworks: ${summary.frameworks.join(', ')}`);
-    }
-    if (summary.providers.length > 0) {
-        lines.push(`- Providers: ${summary.providers.join(', ')}`);
-    }
-    if (runtimeNames.length > 0) {
-        lines.push(`- Runtime agent names: ${runtimeNames.join(', ')}`);
-    }
-    return lines.join('\n');
-}
-function isRecord(value) {
-    return typeof value === 'object' && value !== null && !Array.isArray(value);
-}
-//# sourceMappingURL=sdk-guide.js.map

package/dist/init/sdk-integration.d.ts

@@ -1,53 +0,0 @@
-import { type CodingAgentAdapter, type CodingAgentEvent, runCodingAgent } from '../harness.js';
-import { type SdkAgentResult } from './sdk-protocol.js';
-import { verifyExactTrace, type VerificationEvidence } from './sdk-verification.js';
-import { readRuntimeSummary } from './sdk-guide.js';
-export { describeCodingAgentEvent } from '../harness.js';
-export type SdkIntegrationStatus = 'integrated_verified' | 'needs_human_input' | 'repository_checks_failed' | 'smoke_execution_failed' | 'telemetry_not_observed' | 'nothing_to_integrate' | 'agent_failed' | 'agent_unavailable' | 'cancelled';
-export interface SdkIntegrationOutcome {
-    status: SdkIntegrationStatus;
-    adapter?: CodingAgentAdapter;
-    verification_id?: string;
-    verification?: VerificationEvidence;
-    agent_result?: SdkAgentResult;
-    repair_attempts: number;
-    security_findings?: string[];
-    installed_skill_ids?: string[];
-    detail?: string;
-}
-export interface SdkIntegrationOptions {
-    cwd?: string;
-    adapter?: CodingAgentAdapter;
-    human?: boolean;
-    onProgress?: (message: string) => void;
-    onEvent?: (event: CodingAgentEvent) => void;
-    onPhase?: (phase: 'investigating' | 'verifying' | 'repairing', message: string) => void;
-    apiKey?: string;
-    ingestUrl?: string;
-    maxRepairAttempts?: number;
-    verifyTimeoutMs?: number;
-    runAgent?: typeof runCodingAgent;
-    verify?: typeof verifyExactTrace;
-    fetchAudit?: (id: string) => Promise<unknown>;
-}
-type RepairableClassification = 'telemetry_not_observed' | 'repository_checks_failed' | 'smoke_execution_failed' | 'protocol_violation' | 'failed';
-export declare function runSdkIntegration(options?: SdkIntegrationOptions): Promise<SdkIntegrationOutcome>;
-export interface SdkIntegrationPromptOptions {
-    catalogDir: string;
-    catalogListing: string;
-    verificationId: string;
-    harnessSummary?: ReturnType<typeof readRuntimeSummary>;
-}
-export declare function renderSdkIntegrationPrompt(opts: SdkIntegrationPromptOptions): string;
-export interface SdkRepairPromptOptions extends SdkIntegrationPromptOptions {
-    attempt: number;
-    maxAttempts: number;
-    classification: RepairableClassification;
-    previousResult?: SdkAgentResult;
-    verification?: VerificationEvidence;
-    securityFindings?: string[];
-}
-export declare function renderSdkRepairPrompt(opts: SdkRepairPromptOptions): string;
-export declare function parseGitDeltaPaths(deltaLines: string[]): string[];
-export declare function redactSecretText(text: string, apiKey?: string): string;
-//# sourceMappingURL=sdk-integration.d.ts.map