@capitalthought/agentsfirst-mcp 0.1.0

package/dist/probe.d.ts

@@ -0,0 +1,192 @@
+export interface AgentsMdSignals {
+    exists: boolean;
+    path?: string;
+    size_bytes?: number;
+    line_count?: number;
+    sections?: {
+        permissions: boolean;
+        sequence: boolean;
+        identifiers: boolean;
+        errors: boolean;
+        visible_outputs: boolean;
+        anti_patterns: boolean;
+    };
+}
+export interface McpServerSignals {
+    detected: boolean;
+    indicators: {
+        package_json_dep?: string;
+        matching_files?: Record<string, number>;
+        tool_names_sampled?: string[];
+        verb_first_ratio?: number;
+        uses_zod_for_params?: boolean;
+    };
+}
+export interface CliSignals {
+    detected: boolean;
+    indicators: {
+        package_json_bin?: string[];
+        pyproject_scripts?: boolean;
+        cargo_bins?: boolean;
+        bin_dir_entries?: string[];
+        argv_handling?: boolean;
+    };
+}
+export interface TypedSdkSignals {
+    detected: boolean;
+    indicators: {
+        declared_types_entry?: string;
+        has_exports_field?: boolean;
+        dts_files?: number;
+    };
+}
+export interface PrepGateSignals {
+    detected: boolean;
+    indicators: {
+        prep_files?: string[];
+        prep_tool_registrations?: number;
+        prep_function_exported?: boolean;
+    };
+}
+export interface TypedStateSignals {
+    detected: boolean;
+    has_migrations: boolean;
+    indicators: {
+        zod_imports: number;
+        json_schema_files: number;
+        migration_files: number;
+        prisma: boolean;
+        drizzle: number;
+        typescript_strict: boolean;
+    };
+}
+export interface VisibleOutputSignals {
+    detected: boolean;
+    indicators: {
+        slack_imports: number;
+        postmark: number;
+        resend: number;
+        email_general: number;
+        asana: number;
+        linear: number;
+        audit_log_files: number;
+        todo_ship_markers: number;
+    };
+}
+export interface MultiModelSignals {
+    detected: boolean;
+    indicators: {
+        anthropic: number;
+        openai: number;
+        google_genai: number;
+        xai: number;
+        distinct_llm_sdks: string[];
+        consensus_pattern: number;
+    };
+}
+export interface PerspectiveDispatchSignals {
+    detected: boolean;
+    indicators: {
+        persona_files?: number;
+        reviewer_pattern: number;
+    };
+}
+export interface RecoverySignals {
+    detected: boolean;
+    has_escalation: boolean;
+    indicators: {
+        retry_helper: number;
+        recovery_files: number;
+        escalation_pattern: number;
+    };
+}
+export interface ToolCountSignals {
+    mcp_register_tool_calls: number;
+    cli_bin_entries: number;
+    estimated_total: number;
+}
+export interface DiscoverabilitySignals {
+    indicators: {
+        package_name?: string | null;
+        has_repository_field?: boolean;
+        has_homepage?: boolean;
+        publishable?: boolean;
+        readme_mentions_mcp?: boolean;
+        readme_mentions_install?: boolean;
+        readme_mentions_agents_first?: boolean;
+    };
+}
+export interface StalenessSignals {
+    agent_file_ages: Record<string, {
+        mtime: string;
+        days_ago: number;
+    }>;
+}
+export interface CodebaseSignals {
+    mode: 'codebase';
+    target: string;
+    project_name: string;
+    timestamp: string;
+    signals: {
+        agents_md: AgentsMdSignals;
+        mcp_server: McpServerSignals;
+        cli: CliSignals;
+        typed_sdk: TypedSdkSignals;
+        prep_gate: PrepGateSignals;
+        typed_state: TypedStateSignals;
+        visible_outputs: VisibleOutputSignals;
+        multi_model: MultiModelSignals;
+        perspective_dispatch: PerspectiveDispatchSignals;
+        autonomous_recovery: RecoverySignals;
+        tool_count: ToolCountSignals;
+        discoverability: DiscoverabilitySignals;
+        staleness: StalenessSignals;
+    };
+    derived: {
+        has_any_agent_interface: boolean;
+        god_server_risk: 'ok' | 'warn' | 'fail';
+        agents_without_rules_risk: boolean;
+    };
+}
+export interface SurfaceProbe {
+    url: string;
+    status?: number;
+    ok?: boolean;
+    content_type?: string | null;
+    length?: number;
+    body?: string;
+    truncated?: boolean;
+    error?: string;
+}
+export interface WebsiteSignals {
+    mode: 'website';
+    target: string;
+    timestamp: string;
+    signals: {
+        surfaces: Record<string, SurfaceProbe>;
+        robots_analysis?: {
+            ai_agents_addressed: string[];
+            address_count: number;
+            blanket_disallow: boolean;
+        };
+        markdown_negotiation: {
+            requested?: string;
+            content_type_returned?: string;
+            served_markdown?: boolean;
+            status?: number;
+            error?: string;
+        };
+        homepage: SurfaceProbe;
+        homepage_analysis?: {
+            mentions_mcp: boolean;
+            mentions_npx: boolean;
+            mentions_cli: boolean;
+            mentions_sdk: boolean;
+            mentions_api: boolean;
+            mentions_oauth: boolean;
+            mentions_agents_first: boolean;
+        };
+    };
+}
+export declare function probeCodebase(rootArg: string): Promise<CodebaseSignals>;
+export declare function probeWebsite(url: string): Promise<WebsiteSignals>;