tryassay 0.1.2 → 0.3.0

package/dist/runtime/observer.d.ts

@@ -0,0 +1,48 @@
+import { EventEmitter } from 'node:events';
+import type { SignalSourceType, Observation, FileSystemSignalConfig, WebhookSignalConfig, ScheduleSignalConfig } from './types.js';
+export interface SignalAdapter {
+    readonly type: SignalSourceType;
+    start(emit: (obs: Observation) => void): Promise<void>;
+    stop(): Promise<void>;
+}
+export declare class FileWatcherAdapter implements SignalAdapter {
+    readonly type: SignalSourceType;
+    private watchers;
+    private config;
+    private debounceMs;
+    private pendingChanges;
+    private debounceTimer;
+    constructor(config: FileSystemSignalConfig, debounceMs?: number);
+    start(emit: (obs: Observation) => void): Promise<void>;
+    stop(): Promise<void>;
+    private flushPendingChanges;
+}
+export declare class WebhookAdapter implements SignalAdapter {
+    readonly type: SignalSourceType;
+    private server;
+    private config;
+    constructor(config: WebhookSignalConfig);
+    start(emit: (obs: Observation) => void): Promise<void>;
+    stop(): Promise<void>;
+}
+export declare class ScheduleAdapter implements SignalAdapter {
+    readonly type: SignalSourceType;
+    private timer;
+    private tickCount;
+    private config;
+    constructor(config: ScheduleSignalConfig);
+    start(emit: (obs: Observation) => void): Promise<void>;
+    stop(): Promise<void>;
+}
+export declare class Observer extends EventEmitter {
+    private adapters;
+    private queue;
+    private running;
+    private waitResolve;
+    register(adapter: SignalAdapter): void;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    dequeue(): Promise<Observation | null>;
+    get queueDepth(): number;
+    get isRunning(): boolean;
+}

package/dist/runtime/observer.js

@@ -0,0 +1,294 @@
+// ============================================================
+// Assay Verified Agent Runtime — Observer Component
+// Watches external signals and converts them to Observations
+// ============================================================
+import { EventEmitter } from 'node:events';
+import { watch } from 'node:fs';
+import { createServer } from 'node:http';
+import { randomUUID } from 'node:crypto';
+import { resolve } from 'node:path';
+// ── FileWatcherAdapter ────────────────────────────────────────
+export class FileWatcherAdapter {
+    type = 'filesystem';
+    watchers = [];
+    config;
+    debounceMs;
+    pendingChanges = new Map();
+    debounceTimer = null;
+    constructor(config, debounceMs = 500) {
+        this.config = config;
+        this.debounceMs = debounceMs;
+    }
+    async start(emit) {
+        for (const dirPath of this.config.paths) {
+            const resolved = resolve(dirPath);
+            const watcher = watch(resolved, { recursive: true }, (eventType, filename) => {
+                if (!filename)
+                    return;
+                if (this.config.ignorePatterns?.some(p => filename.includes(p))) {
+                    return;
+                }
+                const event = eventType === 'rename' ? 'create' : 'modify';
+                const fullPath = `${resolved}/${filename}`;
+                // Accumulate changes in the debounce window
+                this.pendingChanges.set(fullPath, { event, path: fullPath });
+                // Reset the debounce timer
+                if (this.debounceTimer) {
+                    clearTimeout(this.debounceTimer);
+                }
+                this.debounceTimer = setTimeout(() => {
+                    this.flushPendingChanges(emit);
+                }, this.debounceMs);
+            });
+            this.watchers.push(watcher);
+        }
+    }
+    async stop() {
+        if (this.debounceTimer) {
+            clearTimeout(this.debounceTimer);
+            this.debounceTimer = null;
+        }
+        this.pendingChanges.clear();
+        for (const watcher of this.watchers) {
+            watcher.close();
+        }
+        this.watchers = [];
+    }
+    flushPendingChanges(emit) {
+        if (this.pendingChanges.size === 0)
+            return;
+        const changes = Array.from(this.pendingChanges.values());
+        this.pendingChanges.clear();
+        this.debounceTimer = null;
+        if (changes.length === 1) {
+            // Single file change — emit as-is
+            const change = changes[0];
+            const payload = {
+                type: 'file_change',
+                event: change.event,
+                path: change.path,
+            };
+            emit({
+                id: randomUUID(),
+                source: 'filesystem',
+                urgency: 'normal',
+                timestamp: new Date().toISOString(),
+                payload,
+            });
+        }
+        else {
+            // Multiple file changes — emit first as representative, include all paths in observation
+            const primary = changes[0];
+            const payload = {
+                type: 'file_change',
+                event: primary.event,
+                path: primary.path,
+            };
+            emit({
+                id: randomUUID(),
+                source: 'filesystem',
+                urgency: 'normal',
+                timestamp: new Date().toISOString(),
+                payload,
+                // Store all changed paths for context
+                relatedExperienceIds: changes.map(c => c.path),
+            });
+        }
+    }
+}
+// ── WebhookAdapter ────────────────────────────────────────────
+export class WebhookAdapter {
+    type = 'webhook';
+    server = null;
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    async start(emit) {
+        this.server = createServer((req, res) => {
+            if (req.method !== 'POST' || req.url !== this.config.path) {
+                res.writeHead(404);
+                res.end('Not Found');
+                return;
+            }
+            if (this.config.secret) {
+                const provided = req.headers['x-webhook-secret'];
+                if (provided !== this.config.secret) {
+                    res.writeHead(401);
+                    res.end('Unauthorized');
+                    return;
+                }
+            }
+            const chunks = [];
+            req.on('data', (chunk) => chunks.push(chunk));
+            req.on('end', () => {
+                const rawBody = Buffer.concat(chunks).toString('utf-8');
+                let body;
+                try {
+                    body = JSON.parse(rawBody);
+                }
+                catch {
+                    body = rawBody;
+                }
+                const headers = {};
+                for (const [key, value] of Object.entries(req.headers)) {
+                    if (typeof value === 'string') {
+                        headers[key] = value;
+                    }
+                }
+                const payload = {
+                    type: 'webhook',
+                    method: req.method ?? 'POST',
+                    path: req.url ?? this.config.path,
+                    headers,
+                    body,
+                };
+                const obs = {
+                    id: randomUUID(),
+                    source: 'webhook',
+                    urgency: 'high',
+                    timestamp: new Date().toISOString(),
+                    payload,
+                };
+                emit(obs);
+                res.writeHead(200, { 'Content-Type': 'application/json' });
+                res.end(JSON.stringify({ received: true, observationId: obs.id }));
+            });
+        });
+        await new Promise((resolve, reject) => {
+            this.server.listen(this.config.port, () => resolve());
+            this.server.on('error', reject);
+        });
+    }
+    async stop() {
+        if (!this.server)
+            return;
+        await new Promise((resolve, reject) => {
+            this.server.close((err) => {
+                if (err)
+                    reject(err);
+                else
+                    resolve();
+            });
+        });
+        this.server = null;
+    }
+}
+// ── ScheduleAdapter ───────────────────────────────────────────
+export class ScheduleAdapter {
+    type = 'schedule';
+    timer = null;
+    tickCount = 0;
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    async start(emit) {
+        this.tickCount = 0;
+        this.timer = setInterval(() => {
+            this.tickCount++;
+            const payload = {
+                type: 'schedule_tick',
+                label: this.config.label,
+                tickNumber: this.tickCount,
+            };
+            const obs = {
+                id: randomUUID(),
+                source: 'schedule',
+                urgency: 'low',
+                timestamp: new Date().toISOString(),
+                payload,
+            };
+            emit(obs);
+        }, this.config.intervalMs);
+    }
+    async stop() {
+        if (this.timer !== null) {
+            clearInterval(this.timer);
+            this.timer = null;
+        }
+    }
+}
+// ── Priority Queue ────────────────────────────────────────────
+const URGENCY_ORDER = {
+    critical: 0,
+    high: 1,
+    normal: 2,
+    low: 3,
+};
+class PriorityQueue {
+    items = [];
+    enqueue(obs) {
+        this.items.push(obs);
+        this.items.sort((a, b) => URGENCY_ORDER[a.urgency] - URGENCY_ORDER[b.urgency]);
+    }
+    dequeue() {
+        return this.items.shift();
+    }
+    get length() {
+        return this.items.length;
+    }
+    drain() {
+        const all = this.items.splice(0);
+        return all;
+    }
+}
+// ── Observer ──────────────────────────────────────────────────
+export class Observer extends EventEmitter {
+    adapters = [];
+    queue = new PriorityQueue();
+    running = false;
+    waitResolve = null;
+    register(adapter) {
+        this.adapters.push(adapter);
+    }
+    async start() {
+        if (this.running)
+            return;
+        this.running = true;
+        const emitFn = (obs) => {
+            if (!this.running)
+                return;
+            if (this.waitResolve) {
+                const resolve = this.waitResolve;
+                this.waitResolve = null;
+                resolve(obs);
+            }
+            else {
+                this.queue.enqueue(obs);
+            }
+            this.emit('observation', obs);
+        };
+        await Promise.all(this.adapters.map(a => a.start(emitFn)));
+    }
+    async stop() {
+        this.running = false;
+        if (this.waitResolve) {
+            const resolve = this.waitResolve;
+            this.waitResolve = null;
+            resolve(null);
+        }
+        await Promise.all(this.adapters.map(a => a.stop()));
+    }
+    async dequeue() {
+        const immediate = this.queue.dequeue();
+        if (immediate)
+            return immediate;
+        if (!this.running)
+            return null;
+        return new Promise((resolve) => {
+            if (!this.running) {
+                resolve(null);
+                return;
+            }
+            this.waitResolve = resolve;
+        });
+    }
+    get queueDepth() {
+        return this.queue.length;
+    }
+    get isRunning() {
+        return this.running;
+    }
+}
+//# sourceMappingURL=observer.js.map

package/dist/runtime/observer.js.map

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

package/dist/runtime/planner.d.ts

@@ -0,0 +1,4 @@
+import type { Decision, AgentConfig, ActionPlan } from './types.js';
+export declare class Planner {
+    plan(decision: Decision, config: AgentConfig): Promise<ActionPlan>;
+}

package/dist/runtime/planner.js

@@ -0,0 +1,299 @@
+// ============================================================
+// Assay Verified Agent Runtime — Planner
+// Decomposes a Decision into concrete, verifiable ActionSteps
+// ============================================================
+import { randomUUID } from 'node:crypto';
+import { getClient, MODEL } from '../lib/anthropic.js';
+// ── Approval level ranking (for comparison) ─────────────────
+const APPROVAL_RANK = {
+    auto: 0,
+    single: 1,
+    escalate: 2,
+};
+function highestApproval(a, b) {
+    return APPROVAL_RANK[a] >= APPROVAL_RANK[b] ? a : b;
+}
+// ── System prompt ───────────────────────────────────────────
+function buildSystemPrompt(config) {
+    return `You are an operational planner for a verified agent runtime.
+
+Your job: decompose a high-level decision into concrete, ordered action steps.
+
+## Agent scope
+- Name: ${config.name}
+- Allowed directories: ${config.scope.allowedDirectories.join(', ')}
+- Allowed commands: ${config.scope.allowedCommands.join(', ')}
+- Allowed URLs: ${config.scope.allowedUrls.join(', ')}
+- Blocked patterns: ${config.scope.blockedPatterns.join(', ')}
+- Max plan steps: ${config.limits.maxPlanSteps}
+- Command timeout: ${config.limits.commandTimeoutMs}ms
+
+## Rules
+1. Each step must have ONE operation (code_write, code_run, api_call, git, or message).
+2. Every step needs preConditions (what must be true before) and postConditions (what must be true after).
+3. Use dependsOn (array of step indices) to express ordering constraints.
+4. Stay within the agent's allowed scope. Never produce steps that violate blocked patterns.
+5. Be concrete — file paths, exact commands, real URLs. No placeholders.
+6. Keep the total number of steps at or below ${config.limits.maxPlanSteps}.
+
+## Output format
+Respond with ONLY a JSON array of steps. No markdown, no explanation, no wrapping.
+
+Each step object:
+{
+  "index": 0,
+  "description": "Human-readable description",
+  "operation": { "type": "code_write"|"code_run"|"api_call"|"git"|"message", ...fields },
+  "preConditions": [{ "description": "...", "check": "..." }],
+  "postConditions": [{ "description": "...", "check": "..." }],
+  "dependsOn": [],
+  "estimatedDurationMs": 5000
+}
+
+Operation schemas:
+- code_write: { type: "code_write", filePath: string, content: string, mode: "create"|"edit"|"append", editTarget?: string }
+- code_run: { type: "code_run", command: string, cwd?: string, timeoutMs: number, env?: Record<string,string> }
+- api_call: { type: "api_call", method: "GET"|"POST"|"PUT"|"DELETE"|"PATCH", url: string, headers?: Record<string,string>, body?: any, expectedStatus?: number }
+- git: { type: "git", command: "add"|"commit"|"push"|"branch"|"checkout", args: string[], cwd?: string }
+- message: { type: "message", channel: "console"|"slack"|"email", recipient?: string, subject?: string, content: string }`;
+}
+// ── User prompt ─────────────────────────────────────────────
+function buildUserPrompt(decision) {
+    const actions = decision.proposedActions
+        .map((a, i) => `${i + 1}. [${a.operationType}] ${a.description}\n   Target: ${a.target}\n   Details: ${a.details}`)
+        .join('\n');
+    return `Decompose this decision into concrete action steps.
+
+## Decision
+ID: ${decision.id}
+Reasoning: ${decision.reasoning}
+Confidence: ${decision.confidence}
+Risks: ${decision.risks.join('; ')}
+
+## Proposed actions
+${actions}
+
+Produce the JSON array of steps now.`;
+}
+// ── Parse helpers ───────────────────────────────────────────
+function extractJsonArray(raw) {
+    // Try direct parse first
+    const trimmed = raw.trim();
+    try {
+        const parsed = JSON.parse(trimmed);
+        if (Array.isArray(parsed))
+            return parsed;
+    }
+    catch {
+        // fall through
+    }
+    // Try extracting from markdown code block
+    const fenceMatch = trimmed.match(/```(?:json)?\s*\n?([\s\S]*?)\n?\s*```/);
+    if (fenceMatch) {
+        try {
+            const parsed = JSON.parse(fenceMatch[1].trim());
+            if (Array.isArray(parsed))
+                return parsed;
+        }
+        catch {
+            // fall through
+        }
+    }
+    // Try finding array boundaries
+    const start = trimmed.indexOf('[');
+    const end = trimmed.lastIndexOf(']');
+    if (start !== -1 && end > start) {
+        try {
+            const parsed = JSON.parse(trimmed.slice(start, end + 1));
+            if (Array.isArray(parsed))
+                return parsed;
+        }
+        catch {
+            // fall through
+        }
+    }
+    throw new Error('Failed to extract JSON array from Claude response');
+}
+function isValidOperationType(t) {
+    return typeof t === 'string' && ['code_write', 'code_run', 'api_call', 'git', 'message'].includes(t);
+}
+function parseConditions(raw) {
+    if (!Array.isArray(raw))
+        return [];
+    return raw
+        .filter((c) => c !== null && typeof c === 'object')
+        .map((c) => ({
+        description: typeof c.description === 'string' ? c.description : 'unknown',
+        check: typeof c.check === 'string' ? c.check : '',
+    }));
+}
+function parseOperation(raw) {
+    if (raw === null || typeof raw !== 'object')
+        return null;
+    const op = raw;
+    if (!isValidOperationType(op.type))
+        return null;
+    switch (op.type) {
+        case 'code_write':
+            return {
+                type: 'code_write',
+                filePath: typeof op.filePath === 'string' ? op.filePath : '',
+                content: typeof op.content === 'string' ? op.content : '',
+                mode: op.mode === 'create' || op.mode === 'edit' || op.mode === 'append'
+                    ? op.mode
+                    : 'create',
+                editTarget: typeof op.editTarget === 'string' ? op.editTarget : undefined,
+            };
+        case 'code_run':
+            return {
+                type: 'code_run',
+                command: typeof op.command === 'string' ? op.command : '',
+                cwd: typeof op.cwd === 'string' ? op.cwd : undefined,
+                timeoutMs: typeof op.timeoutMs === 'number' ? op.timeoutMs : 30_000,
+                env: op.env !== null && typeof op.env === 'object' ? op.env : undefined,
+            };
+        case 'api_call':
+            return {
+                type: 'api_call',
+                method: ['GET', 'POST', 'PUT', 'DELETE', 'PATCH'].includes(op.method)
+                    ? op.method
+                    : 'GET',
+                url: typeof op.url === 'string' ? op.url : '',
+                headers: op.headers !== null && typeof op.headers === 'object' ? op.headers : undefined,
+                body: op.body,
+                expectedStatus: typeof op.expectedStatus === 'number' ? op.expectedStatus : undefined,
+            };
+        case 'git':
+            return {
+                type: 'git',
+                command: ['add', 'commit', 'push', 'branch', 'checkout'].includes(op.command)
+                    ? op.command
+                    : 'add',
+                args: Array.isArray(op.args) ? op.args.filter((a) => typeof a === 'string') : [],
+                cwd: typeof op.cwd === 'string' ? op.cwd : undefined,
+            };
+        case 'message':
+            return {
+                type: 'message',
+                channel: op.channel === 'console' || op.channel === 'slack' || op.channel === 'email'
+                    ? op.channel
+                    : 'console',
+                recipient: typeof op.recipient === 'string' ? op.recipient : undefined,
+                subject: typeof op.subject === 'string' ? op.subject : undefined,
+                content: typeof op.content === 'string' ? op.content : '',
+            };
+        default:
+            return null;
+    }
+}
+function parseRawStep(raw) {
+    if (raw === null || typeof raw !== 'object')
+        return null;
+    const obj = raw;
+    const operation = parseOperation(obj.operation);
+    if (!operation)
+        return null;
+    return {
+        index: typeof obj.index === 'number' ? obj.index : 0,
+        description: typeof obj.description === 'string' ? obj.description : 'unnamed step',
+        operation,
+        preConditions: parseConditions(obj.preConditions),
+        postConditions: parseConditions(obj.postConditions),
+        dependsOn: Array.isArray(obj.dependsOn)
+            ? obj.dependsOn.filter((d) => typeof d === 'number')
+            : [],
+        estimatedDurationMs: typeof obj.estimatedDurationMs === 'number' ? obj.estimatedDurationMs : 5000,
+    };
+}
+// ── Planner ─────────────────────────────────────────────────
+export class Planner {
+    async plan(decision, config) {
+        const planId = randomUUID();
+        const client = getClient();
+        const systemPrompt = buildSystemPrompt(config);
+        const userPrompt = buildUserPrompt(decision);
+        // Stream the response and collect content
+        let content = '';
+        let inputTokens = 0;
+        let outputTokens = 0;
+        const stream = client.messages.stream({
+            model: config.modelId || MODEL,
+            max_tokens: 8_000,
+            system: systemPrompt,
+            messages: [{ role: 'user', content: userPrompt }],
+        });
+        stream.on('text', (text) => {
+            content += text;
+        });
+        const finalMessage = await stream.finalMessage();
+        inputTokens = finalMessage.usage.input_tokens;
+        outputTokens = finalMessage.usage.output_tokens;
+        // Parse the response into steps
+        let rawSteps;
+        try {
+            const parsed = extractJsonArray(content);
+            rawSteps = parsed
+                .map(parseRawStep)
+                .filter((s) => s !== null);
+        }
+        catch (err) {
+            // Graceful fallback: return a single-step plan that logs the failure
+            rawSteps = [{
+                    index: 0,
+                    description: `Plan generation failed: ${err instanceof Error ? err.message : String(err)}`,
+                    operation: {
+                        type: 'message',
+                        channel: 'console',
+                        content: `Planner could not parse Claude response. Raw output length: ${content.length} chars.`,
+                    },
+                    preConditions: [],
+                    postConditions: [],
+                    dependsOn: [],
+                    estimatedDurationMs: 0,
+                }];
+        }
+        // Enforce max plan steps
+        if (rawSteps.length > config.limits.maxPlanSteps) {
+            rawSteps = rawSteps.slice(0, config.limits.maxPlanSteps);
+        }
+        // Build index-to-ID map for dependsOn resolution
+        const stepIds = new Map();
+        for (const raw of rawSteps) {
+            stepIds.set(raw.index, randomUUID());
+        }
+        // Convert raw steps to ActionSteps
+        let overallRisk = 'auto';
+        const steps = rawSteps.map((raw, i) => {
+            const stepId = stepIds.get(raw.index) ?? randomUUID();
+            const opType = raw.operation.type;
+            const approvalLevel = config.approvalDefaults[opType] ?? 'single';
+            overallRisk = highestApproval(overallRisk, approvalLevel);
+            // Resolve dependsOn indices to step IDs
+            const dependsOn = raw.dependsOn
+                .map((depIndex) => stepIds.get(depIndex))
+                .filter((id) => id !== undefined);
+            return {
+                id: stepId,
+                planId,
+                index: i,
+                description: raw.description,
+                operation: raw.operation,
+                preConditions: raw.preConditions,
+                postConditions: raw.postConditions,
+                approvalLevel,
+                dependsOn,
+            };
+        });
+        const estimatedDurationMs = rawSteps.reduce((sum, s) => sum + (s.estimatedDurationMs ?? 5000), 0);
+        return {
+            id: planId,
+            decisionId: decision.id,
+            steps,
+            totalSteps: steps.length,
+            estimatedDurationMs,
+            overallRisk,
+            timestamp: new Date().toISOString(),
+        };
+    }
+}
+//# sourceMappingURL=planner.js.map