@phuetz/code-buddy 0.3.0 → 1.0.0-rc.8

package/dist/browser-automation/internet-proof-plan.js

@@ -0,0 +1,219 @@
+export function buildInternetProofPlan(options) {
+    const goal = normalizeRequired(options.goal, 'goal');
+    const query = normalizeText(options.query) || goal;
+    const sourceUrl = normalizeText(options.sourceUrl);
+    const expectedText = normalizeText(options.expectedText);
+    const needsBrowser = options.requiresBrowser === true || Boolean(expectedText);
+    const steps = [];
+    if (!sourceUrl) {
+        steps.push({
+            id: 'discover',
+            title: 'Discover source candidates',
+            tool: 'web_search',
+            required: true,
+            evidence: 'discovery',
+            reason: 'Find current public sources before opening a browser.',
+        });
+    }
+    steps.push({
+        id: 'static-read',
+        title: 'Read the source cheaply',
+        tool: 'web_fetch',
+        required: true,
+        evidence: 'static-read',
+        reason: sourceUrl
+            ? 'Fetch the known URL before browser automation.'
+            : 'Fetch the best search result before browser automation.',
+    });
+    if (needsBrowser) {
+        steps.push({
+            id: 'observe',
+            title: 'Observe page state before acting',
+            tool: 'browser',
+            action: 'observe',
+            required: true,
+            evidence: 'observation',
+            reason: 'Capture actionable refs and visible page context before interaction.',
+        });
+    }
+    steps.push({
+        id: 'extract',
+        title: 'Extract structured page evidence',
+        tool: 'browser',
+        action: 'extract',
+        required: true,
+        evidence: 'extraction',
+        reason: 'Capture URL, title, headings, actions, links and query-focused text evidence.',
+    });
+    if (expectedText) {
+        steps.push({
+            id: 'assert',
+            title: 'Assert the expected page state',
+            tool: 'browser',
+            action: 'assert_text',
+            required: true,
+            evidence: 'assertion',
+            reason: 'Turn the expected text into an explicit pass/fail browser assertion.',
+        });
+    }
+    if (options.persistWhenProven === true) {
+        steps.push({
+            id: 'persist',
+            title: 'Persist only proven durable facts',
+            tool: 'remember',
+            required: false,
+            evidence: 'memory',
+            reason: 'Save only durable facts after extraction or assertions prove them.',
+        });
+        steps.push({
+            id: 'lesson',
+            title: 'Capture reusable workflow lessons',
+            tool: 'lessons_add',
+            required: false,
+            evidence: 'memory',
+            reason: 'Store reusable web automation patterns, not raw browsing noise.',
+        });
+    }
+    return {
+        goal,
+        query,
+        ...(sourceUrl ? { sourceUrl } : {}),
+        ...(expectedText ? { expectedText } : {}),
+        steps,
+    };
+}
+export function buildInternetProofPersistenceSuggestions(options) {
+    const { plan, evidence } = options;
+    const shouldRemember = plan.steps.some((step) => step.tool === 'remember');
+    const shouldAddLesson = plan.steps.some((step) => step.tool === 'lessons_add');
+    if (!shouldRemember && !shouldAddLesson) {
+        return [];
+    }
+    const assertionRequired = plan.steps.some((step) => step.evidence === 'assertion');
+    if (evidence.assertionPassed === false || (assertionRequired && evidence.assertionPassed !== true)) {
+        return [];
+    }
+    const normalizedEvidence = normalizeEvidence(plan, evidence);
+    if (!hasDurableEvidence(normalizedEvidence)) {
+        return [];
+    }
+    const suggestions = [];
+    const proofSteps = summarizeProofSteps(plan);
+    const durableEvidence = buildDurableEvidenceLines(plan, normalizedEvidence);
+    if (shouldRemember) {
+        suggestions.push({
+            tool: 'remember',
+            reason: 'Persist only browser-verified web facts after the proof loop succeeds.',
+            input: {
+                key: buildMemoryKey(plan, normalizedEvidence),
+                value: durableEvidence.join('\n'),
+                scope: 'project',
+                category: 'patterns',
+            },
+        });
+    }
+    if (shouldAddLesson) {
+        suggestions.push({
+            tool: 'lessons_add',
+            reason: 'Capture the reusable internet proof-loop pattern without storing raw browsing noise.',
+            input: {
+                category: 'INSIGHT',
+                content: [
+                    `Verified "${displayTarget(plan, normalizedEvidence)}" before persistence.`,
+                    `Proof loop: ${proofSteps}.`,
+                    `Durable evidence: ${durableEvidence.slice(0, 4).join(' | ')}.`,
+                ].join(' '),
+                context: 'Internet automation proof loop',
+                source: 'self_observed',
+            },
+        });
+    }
+    return suggestions;
+}
+function normalizeText(value) {
+    return value?.trim().replace(/\s+/g, ' ') ?? '';
+}
+function normalizeRequired(value, fieldName) {
+    const normalized = normalizeText(value);
+    if (!normalized) {
+        throw new Error(`${fieldName} is required`);
+    }
+    return normalized;
+}
+function normalizeEvidence(plan, evidence) {
+    return {
+        url: normalizeText(evidence.url) || plan.sourceUrl,
+        title: normalizeText(evidence.title),
+        query: normalizeText(evidence.query) || plan.query,
+        headings: normalizeTextList(evidence.headings),
+        matches: normalizeTextList(evidence.matches),
+        expectedText: normalizeText(evidence.expectedText) || plan.expectedText,
+        assertionPassed: evidence.assertionPassed,
+        snippet: normalizeText(evidence.snippet),
+    };
+}
+function normalizeTextList(values) {
+    const normalized = (values ?? [])
+        .map((value) => truncateSegment(normalizeText(value), 180))
+        .filter((value) => Boolean(value));
+    return [...new Set(normalized)].slice(0, 5);
+}
+function hasDurableEvidence(evidence) {
+    return Boolean(evidence.url ||
+        evidence.title ||
+        evidence.headings?.length ||
+        evidence.matches?.length ||
+        evidence.snippet ||
+        evidence.assertionPassed === true);
+}
+function buildDurableEvidenceLines(plan, evidence) {
+    const lines = [
+        `Goal: ${plan.goal}`,
+        evidence.url ? `URL: ${evidence.url}` : '',
+        evidence.title ? `Title: ${evidence.title}` : '',
+        evidence.query ? `Query: ${evidence.query}` : '',
+        evidence.headings?.length ? `Headings: ${evidence.headings.join(' | ')}` : '',
+        evidence.matches?.length ? `Matches: ${evidence.matches.join(' | ')}` : '',
+        evidence.assertionPassed === true && evidence.expectedText
+            ? `Assertion: passed for "${evidence.expectedText}"`
+            : '',
+        evidence.snippet ? `Snippet: ${truncateSegment(evidence.snippet, 240)}` : '',
+    ];
+    return lines.filter((line) => line.trim());
+}
+function summarizeProofSteps(plan) {
+    return plan.steps
+        .filter((step) => step.required || step.tool === 'remember' || step.tool === 'lessons_add')
+        .map((step) => (step.action ? `${step.tool}.${step.action}` : step.tool))
+        .join(' -> ');
+}
+function buildMemoryKey(plan, evidence) {
+    const target = evidence.title || safeHostname(evidence.url) || evidence.query || plan.goal;
+    return `web-proof:${slugify(target).slice(0, 72)}`;
+}
+function displayTarget(plan, evidence) {
+    return evidence.title || evidence.url || evidence.query || plan.goal;
+}
+function safeHostname(url) {
+    if (!url)
+        return '';
+    try {
+        return new URL(url).hostname.replace(/^www\./, '');
+    }
+    catch {
+        return '';
+    }
+}
+function slugify(value) {
+    const slug = value
+        .normalize('NFKD')
+        .replace(/[\u0300-\u036f]/g, '')
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '');
+    return slug || 'source';
+}
+function truncateSegment(value, maxLength) {
+    return value.length <= maxLength ? value : `${value.slice(0, Math.max(0, maxLength - 3))}...`;
+}
+//# sourceMappingURL=internet-proof-plan.js.map

package/dist/browser-automation/internet-proof-plan.js.map

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

package/dist/browser-automation/internet-scout-plan.d.ts

@@ -0,0 +1,47 @@
+export type InternetScoutIntent = 'research' | 'prospecting' | 'profile_enrichment' | 'page_verification' | 'lead_discovery';
+export declare const INTERNET_SCOUT_INTENTS: InternetScoutIntent[];
+export type InternetScoutStepTool = 'web_search' | 'web_fetch' | 'browser' | 'relationship_context' | 'remember' | 'lessons_add';
+export type InternetScoutStepStage = 'discover' | 'read' | 'observe' | 'interact' | 'extract' | 'context' | 'assert' | 'persist';
+export type InternetScoutEvidenceKind = 'source-candidates' | 'static-content' | 'visible-state' | 'user-action' | 'structured-facts' | 'relationship-card' | 'assertion' | 'memory';
+export interface InternetScoutPlanOptions {
+    goal: string;
+    query?: string;
+    sourceUrl?: string;
+    intent?: InternetScoutIntent;
+    requiresInteraction?: boolean;
+    expectedText?: string;
+    persistWhenProven?: boolean;
+    maxPages?: number;
+    allowLoginPages?: boolean;
+}
+export interface InternetScoutStep {
+    id: string;
+    title: string;
+    tool: InternetScoutStepTool;
+    stage: InternetScoutStepStage;
+    evidence: InternetScoutEvidenceKind;
+    required: boolean;
+    action?: string;
+    reason: string;
+    inputs?: Record<string, string | number | boolean>;
+}
+export interface InternetScoutPlan {
+    goal: string;
+    query: string;
+    intent: InternetScoutIntent;
+    sourceUrl?: string;
+    expectedText?: string;
+    maxPages: number;
+    allowLoginPages: boolean;
+    steps: InternetScoutStep[];
+    safetyRules: string[];
+    stopConditions: string[];
+    evidenceChecklist: string[];
+    rateLimit: {
+        maxPages: number;
+        pauseBetweenPagesMs: number;
+        retryPolicy: string;
+    };
+}
+export declare function buildInternetScoutPlan(options: InternetScoutPlanOptions): InternetScoutPlan;
+export declare function renderInternetScoutPlan(plan: InternetScoutPlan): string;

package/dist/browser-automation/internet-scout-plan.js

@@ -0,0 +1,242 @@
+export const INTERNET_SCOUT_INTENTS = [
+    'research',
+    'prospecting',
+    'profile_enrichment',
+    'page_verification',
+    'lead_discovery',
+];
+const DEFAULT_MAX_PAGES = 5;
+const DEFAULT_PAUSE_MS = 1500;
+const RELATIONSHIP_INTENTS = new Set([
+    'prospecting',
+    'profile_enrichment',
+    'lead_discovery',
+]);
+export function buildInternetScoutPlan(options) {
+    const goal = normalizeRequired(options.goal, 'goal');
+    const query = normalizeText(options.query) || goal;
+    const sourceUrl = normalizeText(options.sourceUrl);
+    const expectedText = normalizeText(options.expectedText);
+    const intent = normalizeIntent(options.intent);
+    const maxPages = normalizeMaxPages(options.maxPages);
+    const allowLoginPages = options.allowLoginPages === true;
+    const steps = [];
+    if (!sourceUrl) {
+        steps.push({
+            id: 'discover',
+            title: 'Discover public source candidates',
+            tool: 'web_search',
+            stage: 'discover',
+            evidence: 'source-candidates',
+            required: true,
+            reason: 'Start with search results so the agent can compare sources before opening pages.',
+            inputs: { query, maxPages },
+        });
+    }
+    steps.push({
+        id: 'static-read',
+        title: 'Read the source before opening a browser',
+        tool: 'web_fetch',
+        stage: 'read',
+        evidence: 'static-content',
+        required: true,
+        reason: sourceUrl
+            ? 'Cheap static fetch may already contain the needed evidence.'
+            : 'Fetch the strongest search candidate before using browser automation.',
+        inputs: sourceUrl ? { url: sourceUrl } : { query },
+    });
+    if (options.requiresInteraction === true || expectedText) {
+        steps.push({
+            id: 'observe',
+            title: 'Observe visible state before acting',
+            tool: 'browser',
+            stage: 'observe',
+            evidence: 'visible-state',
+            required: true,
+            action: 'observe',
+            reason: 'Capture refs, visible text, forms, and blockers before any click or typing.',
+            inputs: { query },
+        });
+    }
+    if (options.requiresInteraction === true) {
+        steps.push({
+            id: 'interaction-plan',
+            title: 'Identify the target element before acting',
+            tool: 'browser',
+            stage: 'interact',
+            evidence: 'user-action',
+            required: false,
+            action: 'identify_element',
+            reason: 'Use LLM-assisted observation to resolve a visible selector before any click, typing, or form fill.',
+            inputs: { target: query, requiresVisibleRef: true },
+        });
+    }
+    steps.push({
+        id: 'extract',
+        title: 'Extract structured page evidence',
+        tool: 'browser',
+        stage: 'extract',
+        evidence: 'structured-facts',
+        required: true,
+        action: 'extract',
+        reason: 'Collect URL, title, headings, links, actions, and goal-focused text snippets as proof.',
+        inputs: { query },
+    });
+    if (RELATIONSHIP_INTENTS.has(intent)) {
+        steps.push({
+            id: 'relationship-context',
+            title: 'Convert public findings into a safe context card',
+            tool: 'relationship_context',
+            stage: 'context',
+            evidence: 'relationship-card',
+            required: false,
+            reason: 'Prospecting and profile enrichment should separate public facts from private or uncertain identity claims.',
+            inputs: { mode: 'prospecting' },
+        });
+    }
+    if (expectedText) {
+        steps.push({
+            id: 'assert',
+            title: 'Assert the expected page state',
+            tool: 'browser',
+            stage: 'assert',
+            evidence: 'assertion',
+            required: true,
+            action: 'assert_text',
+            reason: 'Make the browsing result testable with an explicit pass/fail assertion.',
+            inputs: { expectedText },
+        });
+    }
+    if (options.persistWhenProven === true) {
+        steps.push({
+            id: 'persist',
+            title: 'Persist only durable verified facts',
+            tool: 'remember',
+            stage: 'persist',
+            evidence: 'memory',
+            required: false,
+            reason: 'Save concise facts only after source evidence or assertions prove them.',
+        });
+        steps.push({
+            id: 'lesson',
+            title: 'Capture reusable navigation lessons',
+            tool: 'lessons_add',
+            stage: 'persist',
+            evidence: 'memory',
+            required: false,
+            reason: 'Store repeatable browsing patterns, selectors, blockers, or proof loops without raw page dumps.',
+        });
+    }
+    return {
+        goal,
+        query,
+        intent,
+        ...(sourceUrl ? { sourceUrl } : {}),
+        ...(expectedText ? { expectedText } : {}),
+        maxPages,
+        allowLoginPages,
+        steps,
+        safetyRules: buildSafetyRules(),
+        stopConditions: buildStopConditions(allowLoginPages),
+        evidenceChecklist: buildEvidenceChecklist(intent, Boolean(expectedText)),
+        rateLimit: {
+            maxPages,
+            pauseBetweenPagesMs: DEFAULT_PAUSE_MS,
+            retryPolicy: 'Retry transient network failures once; do not retry 403, 429, captcha, or auth walls.',
+        },
+    };
+}
+export function renderInternetScoutPlan(plan) {
+    const lines = [
+        `# Internet Scout Plan: ${plan.goal}`,
+        '',
+        `Intent: ${plan.intent}`,
+        `Query: ${plan.query}`,
+        plan.sourceUrl ? `Source URL: ${plan.sourceUrl}` : '',
+        plan.expectedText ? `Expected text: ${plan.expectedText}` : '',
+        `Page budget: ${plan.maxPages}`,
+        '',
+        '## Steps',
+        ...plan.steps.map((step, index) => {
+            const toolAction = step.action ? `${step.tool}.${step.action}` : step.tool;
+            const requirement = step.required ? 'required' : 'optional';
+            return `${index + 1}. ${step.title} [${toolAction}, ${requirement}] - ${step.reason}`;
+        }),
+        '',
+        '## Stop Conditions',
+        ...plan.stopConditions.map((condition) => `- ${condition}`),
+        '',
+        '## Evidence Checklist',
+        ...plan.evidenceChecklist.map((item) => `- ${item}`),
+        '',
+        '## Safety Rules',
+        ...plan.safetyRules.map((rule) => `- ${rule}`),
+    ];
+    return lines.filter((line) => line !== '').join('\n');
+}
+function normalizeText(value) {
+    return value?.trim().replace(/\s+/g, ' ') ?? '';
+}
+function normalizeRequired(value, fieldName) {
+    const normalized = normalizeText(value);
+    if (!normalized) {
+        throw new Error(`${fieldName} is required`);
+    }
+    return normalized;
+}
+function normalizeIntent(intent) {
+    if (!intent) {
+        return 'research';
+    }
+    if (!INTERNET_SCOUT_INTENTS.includes(intent)) {
+        throw new Error(`intent must be one of: ${INTERNET_SCOUT_INTENTS.join(', ')}`);
+    }
+    return intent;
+}
+function normalizeMaxPages(maxPages) {
+    if (maxPages === undefined) {
+        return DEFAULT_MAX_PAGES;
+    }
+    if (!Number.isFinite(maxPages)) {
+        return DEFAULT_MAX_PAGES;
+    }
+    return Math.min(20, Math.max(1, Math.floor(maxPages)));
+}
+function buildSafetyRules() {
+    return [
+        'Use public web pages or user-authorized pages only.',
+        'Prefer web_fetch before browser automation to reduce page load and side effects.',
+        'Observe before clicking or typing, and use visible refs rather than blind selectors.',
+        'Do not bypass captcha, bot checks, paywalls, access controls, or robots/rate-limit signals.',
+        'Do not infer or persist identity for unknown people without explicit permission and evidence.',
+        'Persist only compact facts with source evidence; avoid storing raw page dumps or private data.',
+    ];
+}
+function buildStopConditions(allowLoginPages) {
+    const loginCondition = allowLoginPages
+        ? 'Credentials, cookies, or session injection are required and were not explicitly user-provided.'
+        : 'A login wall, paywall, or private member area is required.';
+    return [
+        'Captcha, device challenge, security checkpoint, or bot-verification wall appears.',
+        loginCondition,
+        'HTTP 403, 429, rate-limit warning, or explicit crawling prohibition appears.',
+        'The task asks for stealth, captcha solving, scraping behind access controls, or credential harvesting.',
+        'The page exposes sensitive personal data that is not necessary for the user-authorized goal.',
+    ];
+}
+function buildEvidenceChecklist(intent, needsAssertion) {
+    const checklist = [
+        'Final URL and page title.',
+        'At least one source snippet or heading tied to the goal.',
+        'Source timestamps or observed-at time when available.',
+        'Clear note of any blocker, missing evidence, or uncertainty.',
+    ];
+    if (RELATIONSHIP_INTENTS.has(intent)) {
+        checklist.push('Public facts separated from private memory, guesses, and sensitive facts.');
+    }
+    if (needsAssertion) {
+        checklist.push('Explicit assert_text pass/fail result for the expected page state.');
+    }
+    return checklist;
+}
+//# sourceMappingURL=internet-scout-plan.js.map

package/dist/browser-automation/internet-scout-plan.js.map

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

package/dist/browser-automation/internet-scout-runner.d.ts

@@ -0,0 +1,53 @@
+import type { ToolResult } from '../types/index.js';
+import { type InternetScoutPlan, type InternetScoutPlanOptions, type InternetScoutStepTool } from './internet-scout-plan.js';
+export type InternetScoutExecutableTool = InternetScoutStepTool;
+export type InternetScoutTraceStatus = 'success' | 'failed' | 'skipped' | 'stopped';
+export type InternetScoutWaitUntil = 'load' | 'domcontentloaded' | 'networkidle';
+export interface InternetScoutRunOptions extends InternetScoutPlanOptions {
+    useBrowser?: boolean;
+    headless?: boolean;
+    browserPageLimit?: number;
+    waitUntil?: InternetScoutWaitUntil;
+    scrollCount?: number;
+    executePersistence?: boolean;
+}
+export interface InternetScoutToolExecutor {
+    execute(tool: InternetScoutExecutableTool, input: Record<string, unknown>): Promise<ToolResult>;
+    isSafeUrl?(url: string): Promise<{
+        safe: true;
+    } | {
+        safe: false;
+        reason: string;
+    }>;
+}
+export interface InternetScoutTrace {
+    stepId: string;
+    tool: InternetScoutExecutableTool;
+    action?: string;
+    status: InternetScoutTraceStatus;
+    url?: string;
+    input?: Record<string, unknown>;
+    output?: string;
+    error?: string;
+    blocker?: string;
+}
+export interface InternetScoutEvidence {
+    url?: string;
+    title?: string;
+    headings: string[];
+    matches: string[];
+    snippet?: string;
+    assertionPassed?: boolean;
+    expectedText?: string;
+}
+export interface InternetScoutRunResult {
+    success: boolean;
+    stopped: boolean;
+    blocker?: string;
+    plan: InternetScoutPlan;
+    selectedUrls: string[];
+    evidence: InternetScoutEvidence[];
+    traces: InternetScoutTrace[];
+}
+export declare function runInternetScout(options: InternetScoutRunOptions, executor: InternetScoutToolExecutor): Promise<InternetScoutRunResult>;
+export declare function renderInternetScoutRunResult(result: InternetScoutRunResult): string;