@tiangong-ai/cli 0.0.19 → 0.0.21

package/dist/research/workspace/evidence.js

@@ -0,0 +1,235 @@
+import { constants as fsConstants } from "node:fs";
+import { cp, lstat, open, readFile, readdir } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { CliError } from "../../errors.js";
+import { ensureDirectory, pathExists, resolveContained, sha256Bytes, sha256File, workspacePaths, writeJsonAtomic, } from "./storage.js";
+export async function persistBrokerEvidence(root, receipt, bytes, contextBytes = bytes) {
+    const digest = sha256Bytes(bytes);
+    const locator = `evidence/objects/${digest.slice(0, 2)}/${digest}`;
+    const contextDigest = sha256Bytes(contextBytes);
+    const contextLocator = `evidence/objects/${contextDigest.slice(0, 2)}/${contextDigest}`;
+    const paths = workspacePaths(root);
+    const objectPath = resolveContained(paths.control, locator);
+    await ensureDirectory(dirname(objectPath));
+    await writeImmutableObject(objectPath, bytes, digest);
+    if (contextDigest !== digest) {
+        const contextPath = resolveContained(paths.control, contextLocator);
+        await ensureDirectory(dirname(contextPath));
+        await writeImmutableObject(contextPath, contextBytes, contextDigest);
+    }
+    const value = {
+        schemaVersion: 1,
+        ...receipt,
+        bytes: bytes.byteLength,
+        sha256: digest,
+        locator,
+        contextLocator,
+        contextSha256: contextDigest,
+        contextBytes: contextBytes.byteLength,
+        contextEstimatedTokens: estimateBrokerContextTokens(contextBytes.byteLength),
+        servedAt: new Date().toISOString(),
+    };
+    const receiptPath = join(paths.projects, receipt.projectId, "evidence", "receipts", `${receipt.attemptId}.json`);
+    if (await pathExists(receiptPath)) {
+        const existing = JSON.parse(await readFile(receiptPath, "utf8"));
+        if (JSON.stringify(existing) !== JSON.stringify(value)) {
+            throw new CliError("Broker evidence receipt already exists with different content.", {
+                code: "RESEARCH_EVIDENCE_STORE_INVALID",
+                exitCode: 3,
+            });
+        }
+    }
+    else {
+        await writeJsonAtomic(receiptPath, value, 0o444);
+    }
+    return value;
+}
+export async function loadProjectEvidenceReceipts(root, projectId) {
+    const directory = join(workspacePaths(root).projects, projectId, "evidence", "receipts");
+    if (!(await pathExists(directory)))
+        return [];
+    const entries = await readdir(directory, { withFileTypes: true });
+    const receipts = [];
+    for (const entry of entries.sort((left, right) => left.name.localeCompare(right.name))) {
+        if (!entry.isFile() || entry.isSymbolicLink() || !entry.name.endsWith(".json"))
+            continue;
+        const value = JSON.parse(await readFile(join(directory, entry.name), "utf8"));
+        const receipt = parseReceipt(value);
+        if (receipt.projectId !== projectId || `${receipt.attemptId}.json` !== entry.name) {
+            throw evidenceStoreError("Broker evidence receipt identity does not match its path.");
+        }
+        await verifyEvidenceReceipt(root, receipt);
+        receipts.push(receipt);
+    }
+    return receipts;
+}
+export async function verifyEvidenceReceipt(root, receipt) {
+    const objectPath = resolveContained(workspacePaths(root).control, receipt.locator);
+    const info = await lstat(objectPath).catch(() => undefined);
+    if (!info?.isFile() || info.isSymbolicLink() || info.size !== receipt.bytes) {
+        throw evidenceStoreError(`Broker evidence object is missing or invalid: ${receipt.attemptId}`);
+    }
+    if ((await sha256File(objectPath)) !== receipt.sha256) {
+        throw evidenceStoreError(`Broker evidence object hash mismatch: ${receipt.attemptId}`);
+    }
+    const expectedLocator = `evidence/objects/${receipt.sha256.slice(0, 2)}/${receipt.sha256}`;
+    if (receipt.locator !== expectedLocator) {
+        throw evidenceStoreError(`Broker evidence locator is not content-addressed: ${receipt.attemptId}`);
+    }
+    const contextPath = resolveContained(workspacePaths(root).control, receipt.contextLocator);
+    const contextInfo = await lstat(contextPath).catch(() => undefined);
+    if (!contextInfo?.isFile() ||
+        contextInfo.isSymbolicLink() ||
+        contextInfo.size !== receipt.contextBytes ||
+        receipt.contextEstimatedTokens !== estimateBrokerContextTokens(receipt.contextBytes) ||
+        (await sha256File(contextPath)) !== receipt.contextSha256 ||
+        receipt.contextLocator !==
+            `evidence/objects/${receipt.contextSha256.slice(0, 2)}/${receipt.contextSha256}`) {
+        throw evidenceStoreError(`Broker evidence context object is invalid: ${receipt.attemptId}`);
+    }
+    return objectPath;
+}
+export async function stageProjectEvidence(root, projectId, capsuleProject) {
+    const receipts = await loadProjectEvidenceReceipts(root, projectId);
+    const copied = new Set();
+    for (const receipt of receipts) {
+        await verifyEvidenceReceipt(root, receipt);
+        for (const [digest, locator] of [
+            [receipt.sha256, receipt.locator],
+            [receipt.contextSha256, receipt.contextLocator],
+        ]) {
+            if (copied.has(digest))
+                continue;
+            const source = resolveContained(workspacePaths(root).control, locator);
+            const destination = resolveContained(capsuleProject, locator);
+            await ensureDirectory(dirname(destination));
+            await cp(source, destination, { errorOnExist: true, force: false });
+            copied.add(digest);
+        }
+    }
+    return receipts;
+}
+export async function cloneProjectEvidenceReceipts(root, sourceProjectId, targetProjectId) {
+    const receipts = await loadProjectEvidenceReceipts(root, sourceProjectId);
+    const destination = join(workspacePaths(root).projects, targetProjectId, "evidence", "receipts");
+    await ensureDirectory(destination);
+    const cloned = [];
+    for (const receipt of receipts) {
+        const value = { ...receipt, projectId: targetProjectId };
+        await writeJsonAtomic(join(destination, `${receipt.attemptId}.json`), value, 0o444);
+        cloned.push(value);
+    }
+    return cloned;
+}
+export async function loadBrokerEvidenceCache(root, cacheKeySha256) {
+    const path = brokerCachePath(root, cacheKeySha256);
+    if (!(await pathExists(path)))
+        return null;
+    const info = await lstat(path).catch(() => undefined);
+    if (!info?.isFile() || info.isSymbolicLink()) {
+        throw evidenceStoreError("Broker evidence cache entry is not a regular file.");
+    }
+    const value = JSON.parse(await readFile(path, "utf8"));
+    if (!value ||
+        typeof value !== "object" ||
+        Array.isArray(value) ||
+        value.cacheKeySha256 !== cacheKeySha256) {
+        throw evidenceStoreError("Broker evidence cache entry has an unsupported shape.");
+    }
+    const receipt = parseReceipt(value.receipt);
+    await verifyEvidenceReceipt(root, receipt);
+    return receipt;
+}
+export async function storeBrokerEvidenceCache(root, cacheKeySha256, receipt) {
+    if (!/^[0-9a-f]{64}$/.test(cacheKeySha256)) {
+        throw evidenceStoreError("Broker evidence cache key is invalid.");
+    }
+    await verifyEvidenceReceipt(root, receipt);
+    const path = brokerCachePath(root, cacheKeySha256);
+    if (await pathExists(path))
+        return;
+    await writeJsonAtomic(path, { schemaVersion: 1, cacheKeySha256, receipt }, 0o444);
+}
+function parseReceipt(value) {
+    if (!value ||
+        typeof value !== "object" ||
+        Array.isArray(value) ||
+        value.schemaVersion !== 1 ||
+        typeof value.attemptId !== "string" ||
+        typeof value.projectId !== "string" ||
+        typeof value.capabilityId !== "string" ||
+        !["string", "object"].includes(typeof value.credentialId) ||
+        typeof value.status !== "number" ||
+        typeof value.contentType !== "string" ||
+        !Number.isInteger(value.bytes) ||
+        typeof value.sha256 !== "string" ||
+        !/^[0-9a-f]{64}$/.test(value.sha256) ||
+        typeof value.sourceSha256 !== "string" ||
+        typeof value.locator !== "string" ||
+        typeof value.contextLocator !== "string" ||
+        typeof value.contextSha256 !== "string" ||
+        !/^[0-9a-f]{64}$/.test(value.contextSha256) ||
+        !Number.isInteger(value.contextBytes) ||
+        !Number.isInteger(value.contextEstimatedTokens) ||
+        value.contextEstimatedTokens < 0 ||
+        (value.contextItems !== null &&
+            !Number.isInteger(value.contextItems)) ||
+        (value.contextOffset !== undefined &&
+            (!Number.isInteger(value.contextOffset) ||
+                value.contextOffset < 0)) ||
+        (value.contextTotalItems !== undefined &&
+            value.contextTotalItems !== null &&
+            (!Number.isInteger(value.contextTotalItems) ||
+                value.contextTotalItems < 0)) ||
+        (value.contextNextOffset !== undefined &&
+            value.contextNextOffset !== null &&
+            (!Number.isInteger(value.contextNextOffset) ||
+                value.contextNextOffset < 0)) ||
+        typeof value.contextTruncated !== "boolean" ||
+        typeof value.retrievedAt !== "string" ||
+        typeof value.servedAt !== "string" ||
+        typeof value.cacheHit !== "boolean") {
+        throw evidenceStoreError("Broker evidence receipt has an unsupported shape.");
+    }
+    const receipt = value;
+    if (receipt.credentialId !== null && typeof receipt.credentialId !== "string") {
+        throw evidenceStoreError("Broker evidence credential identity is invalid.");
+    }
+    return receipt;
+}
+function brokerCachePath(root, cacheKeySha256) {
+    if (!/^[0-9a-f]{64}$/.test(cacheKeySha256)) {
+        throw evidenceStoreError("Broker evidence cache key is invalid.");
+    }
+    return join(workspacePaths(root).evidenceCache, cacheKeySha256.slice(0, 2), `${cacheKeySha256}.json`);
+}
+async function writeImmutableObject(path, bytes, expectedSha256) {
+    try {
+        const handle = await open(path, fsConstants.O_CREAT | fsConstants.O_EXCL | fsConstants.O_WRONLY | fsConstants.O_NOFOLLOW, 0o444);
+        try {
+            await handle.writeFile(bytes);
+            await handle.sync();
+        }
+        finally {
+            await handle.close();
+        }
+    }
+    catch (error) {
+        if (error.code !== "EEXIST")
+            throw error;
+        const info = await lstat(path).catch(() => undefined);
+        if (!info?.isFile() || info.isSymbolicLink() || (await sha256File(path)) !== expectedSha256) {
+            throw evidenceStoreError("Content-addressed evidence object failed its integrity check.");
+        }
+    }
+}
+function evidenceStoreError(message) {
+    return new CliError(message, {
+        code: "RESEARCH_EVIDENCE_STORE_INVALID",
+        exitCode: 3,
+    });
+}
+function estimateBrokerContextTokens(bytes) {
+    return Math.ceil(bytes / 3);
+}
+//# sourceMappingURL=evidence.js.map

package/dist/research/workspace/evidence.js.map

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

package/dist/research/workspace/executor.d.ts

@@ -0,0 +1,22 @@
+import type { JsonSchema } from "./schemas.js";
+import type { AgentRoute, AgentRuntimeFingerprint, ExecutionResult } from "./types.js";
+export interface AgentExecutionRequest {
+    route: AgentRoute;
+    prompt: string;
+    outputSchema: JsonSchema;
+    requestId: string;
+    purpose: "primary" | "repair" | "doctor";
+    capsuleRoot: string;
+    projectRoot: string;
+    workspaceRoot: string;
+    timeoutSeconds: number;
+    maxTurns: number;
+    maxOutputTokens: number;
+    maxCostUsd: number;
+    expectedRuntime?: AgentRuntimeFingerprint | undefined;
+    toolPolicy?: "none" | "workspace-read";
+    environment: NodeJS.ProcessEnv;
+    brokerUrl: string | null;
+}
+export declare function executeAgent(request: AgentExecutionRequest): Promise<ExecutionResult>;
+export declare function fingerprintAgentRoute(route: AgentRoute, environment: NodeJS.ProcessEnv): Promise<AgentRuntimeFingerprint>;