@uppercut-labs/agent-native 0.0.0-stage → 1.1.0

package/dist/doctor.js

@@ -0,0 +1,287 @@
+import { canonicalCapabilityId } from './core/contracts.js';
+import { createDiagnosticObservation, } from './core/diagnostics.js';
+import { evaluateCapabilityDiscovery, } from './discovery.js';
+export const DOCTOR_REPORT_SCHEMA_VERSION = 'uan.doctor-report/v1';
+const checkIdSchema = {
+    type: 'string',
+    pattern: '^UAN-[0-9]{3}\\.[a-z0-9-]+$',
+};
+export const DOCTOR_REPORT_JSON_SCHEMA = Object.freeze({
+    $schema: 'https://json-schema.org/draft/2020-12/schema',
+    type: 'object',
+    properties: {
+        schemaVersion: { const: DOCTOR_REPORT_SCHEMA_VERSION },
+        profile: {
+            type: 'object',
+            properties: {
+                id: { type: 'string', pattern: '^[a-z][a-z0-9-]*$' },
+                selectedCheckIds: { type: 'array', minItems: 1, uniqueItems: true, items: checkIdSchema },
+                requiredCheckIds: { type: 'array', uniqueItems: true, items: checkIdSchema },
+            },
+            required: ['id', 'selectedCheckIds', 'requiredCheckIds'],
+            additionalProperties: false,
+        },
+        findings: {
+            type: 'array',
+            items: {
+                type: 'object',
+                properties: {
+                    checkId: checkIdSchema,
+                    target: { type: 'string', minLength: 1 },
+                    status: { enum: ['passed', 'failed', 'unknown', 'skipped'] },
+                    severity: { enum: ['info', 'warning', 'error'] },
+                    timestamp: { type: 'string', minLength: 1 },
+                    required: { type: 'boolean' },
+                    evidence: {
+                        type: 'object',
+                        properties: {
+                            kind: { enum: ['configured', 'generated', 'reachable', 'protocol', 'behavior'] },
+                            source: { enum: ['unspecified', 'fixture', 'mock', 'real-host'] },
+                            location: { type: 'string', minLength: 1 },
+                            references: {
+                                type: 'array',
+                                items: { type: 'string', pattern: '^[A-Z][A-Z0-9._-]*$' },
+                            },
+                        },
+                        required: ['kind', 'source', 'location', 'references'],
+                        additionalProperties: false,
+                    },
+                    explanation: { type: 'string', minLength: 1 },
+                    nextAction: { type: 'string', minLength: 1 },
+                },
+                required: [
+                    'checkId',
+                    'target',
+                    'status',
+                    'severity',
+                    'timestamp',
+                    'required',
+                    'evidence',
+                    'explanation',
+                    'nextAction',
+                ],
+                additionalProperties: false,
+            },
+        },
+        exitCode: { type: 'integer', enum: [0, 1, 3] },
+    },
+    required: ['schemaVersion', 'profile', 'findings', 'exitCode'],
+    additionalProperties: false,
+});
+export class DoctorUsageError extends TypeError {
+    exitCode = 2;
+    constructor(message) {
+        super(message);
+        this.name = 'DoctorUsageError';
+    }
+}
+function assertText(value, field) {
+    if (typeof value !== 'string' || value.trim().length === 0) {
+        throw new DoctorUsageError(`${field} must be non-empty`);
+    }
+}
+function validateCheck(check) {
+    try {
+        createDiagnosticObservation({ checkId: check.checkId, status: 'unknown' });
+    }
+    catch (error) {
+        throw new DoctorUsageError(error instanceof Error ? error.message : 'doctor check id is invalid');
+    }
+    assertText(check.target, 'target');
+    if (typeof check.required !== 'boolean')
+        throw new DoctorUsageError('required must be boolean');
+    if (!['info', 'warning', 'error'].includes(check.severity)) {
+        throw new DoctorUsageError('severity must be info, warning, or error');
+    }
+    if (!['configured', 'generated', 'reachable', 'protocol', 'behavior'].includes(check.evidence.kind)) {
+        throw new DoctorUsageError('evidence.kind is invalid');
+    }
+    if (check.evidence.source !== undefined &&
+        !['unspecified', 'fixture', 'mock', 'real-host'].includes(check.evidence.source)) {
+        throw new DoctorUsageError('evidence.source is invalid');
+    }
+    assertText(check.evidence.location, 'evidence.location');
+    assertText(check.nextAction, 'nextAction');
+    for (const status of ['passed', 'failed', 'unknown', 'skipped']) {
+        assertText(check.explanations[status], `explanations.${status}`);
+    }
+    if (typeof check.observe !== 'function')
+        throw new DoctorUsageError('observe must be a function');
+}
+function isFindingStatus(value) {
+    return value === 'passed' || value === 'failed' || value === 'unknown' || value === 'skipped';
+}
+function freezeFinding(check, result, timestamp) {
+    const observedStatus = result.status === 'skipped' ? 'unknown' : result.status;
+    const observationOptions = result.evidenceRefs === undefined
+        ? { checkId: check.checkId, status: observedStatus }
+        : {
+            checkId: check.checkId,
+            status: observedStatus,
+            evidenceRefs: result.evidenceRefs,
+        };
+    const observation = createDiagnosticObservation(observationOptions);
+    const references = observation.evidenceRefs;
+    return Object.freeze({
+        checkId: check.checkId,
+        target: check.target,
+        status: result.status,
+        severity: check.severity,
+        timestamp,
+        required: check.required,
+        evidence: Object.freeze({
+            kind: check.evidence.kind,
+            source: check.evidence.source ?? 'unspecified',
+            location: check.evidence.location,
+            references,
+        }),
+        explanation: check.explanations[result.status],
+        nextAction: check.nextAction,
+    });
+}
+export function doctorExitCode(findings) {
+    if (findings.some((finding) => finding.status === 'failed'))
+        return 1;
+    if (findings.some((finding) => finding.required && (finding.status === 'unknown' || finding.status === 'skipped'))) {
+        return 3;
+    }
+    return 0;
+}
+function resolveProfile(checks, profile) {
+    if (profile !== undefined &&
+        (typeof profile.id !== 'string' ||
+            !Array.isArray(profile.selectedCheckIds) ||
+            !Array.isArray(profile.requiredCheckIds))) {
+        throw new DoctorUsageError('profile must provide id, selectedCheckIds, and requiredCheckIds');
+    }
+    const available = new Set(checks.map((check) => check.checkId));
+    const selected = profile?.selectedCheckIds ?? checks.map((check) => check.checkId);
+    const required = profile?.requiredCheckIds ??
+        checks
+            .filter((check) => check.required)
+            .map((check) => check.checkId);
+    const id = profile?.id ?? 'default';
+    if (!/^[a-z][a-z0-9-]*$/.test(id)) {
+        throw new DoctorUsageError('profile id must be a lowercase slug');
+    }
+    if (selected.length === 0 || new Set(selected).size !== selected.length) {
+        throw new DoctorUsageError('profile must select one or more distinct checks');
+    }
+    if (new Set(required).size !== required.length) {
+        throw new DoctorUsageError('profile required checks must be distinct');
+    }
+    for (const checkId of selected) {
+        if (!available.has(checkId))
+            throw new DoctorUsageError(`unknown selected check: ${checkId}`);
+    }
+    const selectedSet = new Set(selected);
+    for (const checkId of required) {
+        if (!selectedSet.has(checkId)) {
+            throw new DoctorUsageError(`required check is not selected: ${checkId}`);
+        }
+    }
+    return Object.freeze({
+        id,
+        selectedCheckIds: Object.freeze([...selected]),
+        requiredCheckIds: Object.freeze([...required]),
+    });
+}
+export async function runDoctor(checks, options = {}) {
+    let ids = new Set();
+    for (const check of checks) {
+        validateCheck(check);
+        if (ids.has(check.checkId)) {
+            throw new DoctorUsageError(`duplicate doctor check id: ${check.checkId}`);
+        }
+        ids.add(check.checkId);
+    }
+    const profile = resolveProfile(checks, options.profile);
+    const selected = new Set(profile.selectedCheckIds);
+    const required = new Set(profile.requiredCheckIds);
+    let findings = [];
+    for (const check of checks) {
+        if (!selected.has(check.checkId))
+            continue;
+        let result;
+        try {
+            result = await check.observe();
+            if (!isFindingStatus(result.status))
+                result = { status: 'unknown' };
+        }
+        catch {
+            result = { status: 'unknown' };
+        }
+        const timestamp = (options.now?.() ?? new Date()).toISOString();
+        findings.push(freezeFinding({ ...check, required: required.has(check.checkId) }, result, timestamp));
+    }
+    const frozenFindings = Object.freeze(findings);
+    return Object.freeze({
+        schemaVersion: DOCTOR_REPORT_SCHEMA_VERSION,
+        profile,
+        findings: frozenFindings,
+        exitCode: doctorExitCode(frozenFindings),
+    });
+}
+export function inspectCapabilityRegistry(registry) {
+    const definitions = registry.definitions.map((definition) => Object.freeze({
+        id: canonicalCapabilityId(definition.identity),
+        description: definition.description,
+        risk: definition.risk,
+        access: definition.access.kind === 'public'
+            ? Object.freeze({ kind: 'public' })
+            : Object.freeze({
+                kind: 'protected',
+                scopes: Object.freeze([...definition.access.scopes]),
+            }),
+    }));
+    const bindings = registry.bindings.map((binding) => Object.freeze({
+        id: binding.id,
+        capabilityId: binding.capabilityId,
+        targets: Object.freeze([...binding.targets]),
+    }));
+    return Object.freeze({
+        definitions: Object.freeze(definitions),
+        bindings: Object.freeze(bindings),
+    });
+}
+export async function listAuthorizedCapabilities(registry, options) {
+    const inspection = inspectCapabilityRegistry(registry);
+    let listed = [];
+    for (const [index, definition] of registry.definitions.entries()) {
+        if (definition === undefined)
+            continue;
+        const decision = await evaluateCapabilityDiscovery(definition, options.surface, options.exposure, options.authorize);
+        if (!decision.visible)
+            continue;
+        const inspected = inspection.definitions[index];
+        if (inspected === undefined)
+            continue;
+        const candidates = inspection.bindings.filter((binding) => binding.capabilityId === inspected.id);
+        const local = candidates.filter((binding) => binding.targets.includes('local'));
+        const server = candidates.filter((binding) => binding.targets.includes('server'));
+        const browser = candidates.filter((binding) => binding.targets.includes('browser'));
+        const publicRead = definition.risk === 'read' && definition.access.kind === 'public';
+        const available = options.surface === 'browser'
+            ? browser.length === 1
+                ? browser
+                : []
+            : options.surface === 'cli'
+                ? [
+                    ...(local.length === 1 ? local : []),
+                    ...(publicRead && server.length === 1 ? server : []),
+                ]
+                : server.length === 1
+                    ? server
+                    : [];
+        if (available.length === 0)
+            continue;
+        listed.push(Object.freeze({
+            ...inspected,
+            bindingIds: Object.freeze([
+                ...new Set(available.map((binding) => binding.id)),
+            ]),
+        }));
+    }
+    return Object.freeze(listed);
+}
+//# sourceMappingURL=doctor.js.map

package/dist/doctor.js.map

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

package/dist/harness-codex.d.ts

@@ -0,0 +1,17 @@
+import { HarnessError, type HarnessFailureReason, type ProgrammaticHarnessAdapter } from './harness.js';
+export type CodexHarnessOptions = {
+    readonly model: string;
+    readonly effort?: 'low' | 'medium' | 'high' | 'xhigh' | 'max';
+    readonly executable?: string;
+    /** Arguments before app-server, for an explicitly selected CLI launcher. */
+    readonly executableArgs?: readonly string[];
+    readonly sandbox?: 'read-only' | 'workspace-write';
+    readonly requestTimeoutMs?: number;
+    readonly turnTimeoutMs?: number;
+    readonly shutdownTimeoutMs?: number;
+};
+export declare class CodexHarnessError extends HarnessError {
+    constructor(reason: HarnessFailureReason);
+}
+export declare function createCodexHarnessAdapter(input: CodexHarnessOptions): ProgrammaticHarnessAdapter;
+//# sourceMappingURL=harness-codex.d.ts.map

package/dist/harness-codex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"harness-codex.d.ts","sourceRoot":"","sources":["../src/harness-codex.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,YAAY,EAKZ,KAAK,oBAAoB,EAGzB,KAAK,0BAA0B,EAKhC,MAAM,cAAc,CAAC;AAEtB,MAAM,MAAM,mBAAmB,GAAG;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,CAAC;IAC9D,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,4EAA4E;IAC5E,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5C,QAAQ,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,iBAAiB,CAAC;IACnD,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;CACrC,CAAC;AAEF,qBAAa,iBAAkB,SAAQ,YAAY;IACjD,YAAY,MAAM,EAAE,oBAAoB,EAQvC;CACF;AA2OD,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,mBAAmB,GAAG,0BAA0B,CA2PhG"}