@tiangong-ai/cli 0.0.19 → 0.0.20

package/dist/research/workspace/capabilities.js

@@ -0,0 +1,291 @@
+import { createHash } from "node:crypto";
+import { readFile, writeFile } from "node:fs/promises";
+import { basename, dirname, isAbsolute, join, relative, resolve } from "node:path";
+import { CliError } from "../../errors.js";
+import { ALLOWED_CAPABILITY_PERMISSIONS } from "./constants.js";
+import { canonicalJson, ensureDirectory, hashRegularTree, isObject, pathExists, readJsonFile, regularTreeFiles, workspacePaths, writeJsonAtomic, } from "./storage.js";
+export async function loadCapabilityDeclarations(root) {
+    const value = await readJsonFile(workspacePaths(root).capabilityDeclarations, "Research capability declarations");
+    if (!isObject(value) || value.schemaVersion !== 1 || !Array.isArray(value.capabilities)) {
+        throw new CliError("Research capability declarations have an unsupported shape.", {
+            code: "RESEARCH_CAPABILITY_INVALID",
+            exitCode: 2,
+        });
+    }
+    const capabilities = value.capabilities.map((item, index) => parseCapability(item, index));
+    assertUnique(capabilities.map((item) => item.id), "capability ID");
+    assertUnique(capabilities.flatMap((item) => item.credentials.map((credential) => credential.id)), "credential ID");
+    return { schemaVersion: 1, capabilities };
+}
+export async function lockCapabilities(root) {
+    const declarations = await loadCapabilityDeclarations(root);
+    const records = await Promise.all(declarations.capabilities.map(async (declaration) => lockCapability(declaration)));
+    records.sort((left, right) => left.id.localeCompare(right.id));
+    assertUnique(records.map((record) => record.skillName), "capability skill name");
+    const lock = {
+        schemaVersion: 1,
+        generatedAt: new Date().toISOString(),
+        capabilities: records,
+    };
+    await writeJsonAtomic(workspacePaths(root).capabilityLock, lock, 0o444);
+    return lock;
+}
+export async function verifyCapabilities(root) {
+    const declarations = await loadCapabilityDeclarations(root);
+    const lockPath = workspacePaths(root).capabilityLock;
+    if (!(await pathExists(lockPath))) {
+        if (declarations.capabilities.length === 0) {
+            return { status: "verified", checked: 0, errors: [] };
+        }
+        return { status: "drifted", checked: 0, errors: ["capability lock is missing"] };
+    }
+    const lock = await readJsonFile(lockPath, "Research capability lock");
+    if (!isCapabilityLock(lock)) {
+        return { status: "drifted", checked: 0, errors: ["capability lock shape is invalid"] };
+    }
+    const lockedById = new Map(lock.capabilities.map((record) => [record.id, record]));
+    const errors = [];
+    for (const declaration of declarations.capabilities) {
+        const record = lockedById.get(declaration.id);
+        if (!record) {
+            errors.push(`${declaration.id}: missing lock record`);
+            continue;
+        }
+        try {
+            const current = await lockCapability(declaration);
+            if (JSON.stringify(current) !== JSON.stringify(record)) {
+                errors.push(`${declaration.id}: installed skill differs from its lock`);
+            }
+        }
+        catch (error) {
+            errors.push(`${declaration.id}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    for (const record of lock.capabilities) {
+        if (!declarations.capabilities.some((item) => item.id === record.id)) {
+            errors.push(`${record.id}: lock record has no declaration`);
+        }
+    }
+    return {
+        status: errors.length ? "drifted" : "verified",
+        checked: declarations.capabilities.length,
+        errors,
+    };
+}
+export async function stageLockedCapabilities(root, destination) {
+    const declarations = await loadCapabilityDeclarations(root);
+    if (declarations.capabilities.length === 0)
+        return [];
+    const verification = await verifyCapabilities(root);
+    if (verification.status !== "verified") {
+        throw new CliError("Research capabilities must be locked and verified before execution.", {
+            code: "RESEARCH_CAPABILITY_DRIFT",
+            exitCode: 3,
+            details: verification,
+        });
+    }
+    const lock = await readJsonFile(workspacePaths(root).capabilityLock, "Research capability lock");
+    const staged = [];
+    for (const record of lock.capabilities) {
+        const target = join(destination, record.skillName);
+        await copyRegularTree(record.skillPath, target);
+        staged.push(target);
+    }
+    return staged;
+}
+export async function declaredCredentialIds(root) {
+    const declarations = await loadCapabilityDeclarations(root);
+    return new Set(declarations.capabilities.flatMap((capability) => capability.credentials.map((credential) => credential.id)));
+}
+async function lockCapability(declaration) {
+    const skillPath = resolve(declaration.skillPath);
+    if (skillPath !== declaration.skillPath) {
+        throw new CliError(`Capability skill path must be absolute: ${declaration.skillPath}`, {
+            code: "RESEARCH_CAPABILITY_INVALID",
+            exitCode: 2,
+        });
+    }
+    const skillEntry = join(skillPath, "SKILL.md");
+    const skillText = await readFile(skillEntry, "utf8").catch(() => {
+        throw new CliError(`Capability is missing SKILL.md: ${skillPath}`, {
+            code: "RESEARCH_CAPABILITY_INVALID",
+            exitCode: 2,
+        });
+    });
+    const skillName = skillFrontmatterName(skillText);
+    if (basename(skillPath) !== skillName) {
+        throw new CliError(`Capability directory and skill name differ: ${skillPath}`, {
+            code: "RESEARCH_CAPABILITY_INVALID",
+            exitCode: 2,
+        });
+    }
+    return {
+        id: declaration.id,
+        skillName,
+        skillPath,
+        treeSha256: await hashRegularTree(skillPath),
+        policySha256: policyHash(declaration),
+        permissions: [...declaration.permissions].sort(),
+        credentialIds: declaration.credentials.map((item) => item.id).sort(),
+    };
+}
+function parseCapability(value, index) {
+    if (!isObject(value))
+        invalid(index, "must be an object");
+    const id = value.id;
+    const skillPath = value.skillPath;
+    const permissions = value.permissions;
+    const allowedHosts = value.allowedHosts ?? [];
+    const credentials = value.credentials ?? [];
+    if (typeof id !== "string" || !/^[a-z][a-z0-9]*(?:[.-][a-z0-9]+)+$/.test(id)) {
+        invalid(index, "id must be a namespaced logical identifier");
+    }
+    if (typeof skillPath !== "string" || !isAbsolute(skillPath)) {
+        invalid(index, "skillPath must be absolute");
+    }
+    if (!Array.isArray(permissions) ||
+        permissions.some((permission) => typeof permission !== "string" || !ALLOWED_CAPABILITY_PERMISSIONS.has(permission))) {
+        invalid(index, "permissions contain an unsupported value");
+    }
+    if (!Array.isArray(credentials))
+        invalid(index, "credentials must be an array");
+    if (!Array.isArray(allowedHosts) || allowedHosts.some((host) => typeof host !== "string")) {
+        invalid(index, "allowedHosts must be an array of exact host names");
+    }
+    const parsedAllowedHosts = [
+        ...new Set(allowedHosts.map((host) => normalizeAllowedHost(host, index))),
+    ].sort();
+    const brokeredNetwork = permissions.includes("brokered-network");
+    if (brokeredNetwork && parsedAllowedHosts.length === 0) {
+        invalid(index, "must declare allowedHosts for brokered-network");
+    }
+    if (!brokeredNetwork && parsedAllowedHosts.length > 0) {
+        invalid(index, "cannot declare allowedHosts without brokered-network");
+    }
+    const parsedCredentials = credentials.map((credential, credentialIndex) => {
+        if (!isObject(credential))
+            invalid(index, `credential ${credentialIndex} must be an object`);
+        if (typeof credential.id !== "string" ||
+            !/^[a-z][a-z0-9]*(?:[.-][a-z0-9]+)+$/.test(credential.id) ||
+            !Array.isArray(credential.allowedHosts) ||
+            credential.allowedHosts.length === 0 ||
+            credential.allowedHosts.some((host) => typeof host !== "string") ||
+            typeof credential.headerName !== "string" ||
+            !/^[A-Za-z][A-Za-z0-9-]*$/.test(credential.headerName) ||
+            typeof credential.prefix !== "string") {
+            invalid(index, `credential ${credentialIndex} is malformed`);
+        }
+        const credentialHosts = [
+            ...new Set(credential.allowedHosts.map((host) => normalizeAllowedHost(host, index, credentialIndex))),
+        ].sort();
+        if (!brokeredNetwork || credentialHosts.some((host) => !parsedAllowedHosts.includes(host))) {
+            invalid(index, `credential ${credentialIndex} hosts must be within capability allowedHosts`);
+        }
+        return {
+            id: credential.id,
+            allowedHosts: credentialHosts,
+            headerName: credential.headerName,
+            prefix: credential.prefix,
+        };
+    });
+    assertUnique(parsedCredentials.map((item) => item.id), `credential ID in ${id}`);
+    return {
+        id,
+        skillPath,
+        permissions: [...new Set(permissions)],
+        allowedHosts: parsedAllowedHosts,
+        credentials: parsedCredentials,
+    };
+}
+function isCapabilityLock(value) {
+    return (isObject(value) &&
+        value.schemaVersion === 1 &&
+        typeof value.generatedAt === "string" &&
+        Array.isArray(value.capabilities) &&
+        value.capabilities.every((record) => isObject(record) &&
+            typeof record.id === "string" &&
+            typeof record.skillName === "string" &&
+            typeof record.skillPath === "string" &&
+            typeof record.treeSha256 === "string" &&
+            typeof record.policySha256 === "string" &&
+            Array.isArray(record.permissions) &&
+            Array.isArray(record.credentialIds)));
+}
+function policyHash(declaration) {
+    return hashText(canonicalJson({
+        permissions: [...declaration.permissions].sort(),
+        allowedHosts: [...declaration.allowedHosts].sort(),
+        credentials: declaration.credentials
+            .map((credential) => ({
+            id: credential.id,
+            allowedHosts: [...credential.allowedHosts].sort(),
+            headerName: credential.headerName.toLowerCase(),
+            prefix: credential.prefix,
+        }))
+            .sort((left, right) => left.id.localeCompare(right.id)),
+    }));
+}
+function hashText(value) {
+    return createHash("sha256").update(value, "utf8").digest("hex");
+}
+function normalizeAllowedHost(value, index, credentialIndex) {
+    const label = credentialIndex === undefined ? "allowedHosts" : `credential ${credentialIndex} host`;
+    const candidate = value.trim().toLowerCase();
+    let parsed;
+    try {
+        parsed = new URL(`https://${candidate}`);
+    }
+    catch {
+        invalid(index, `${label} contains an invalid host`);
+    }
+    if (!candidate ||
+        candidate.includes("*") ||
+        parsed.username ||
+        parsed.password ||
+        parsed.hostname.endsWith(".") ||
+        parsed.pathname !== "/" ||
+        parsed.search ||
+        parsed.hash) {
+        invalid(index, `${label} must contain exact HTTPS host names without paths or wildcards`);
+    }
+    return parsed.host;
+}
+function skillFrontmatterName(content) {
+    const match = content.match(/^---\s*\n([\s\S]*?)\n---(?:\s*\n|$)/);
+    const name = match?.[1]?.match(/^name:\s*["']?([a-z0-9-]+)["']?\s*$/m)?.[1];
+    if (!name) {
+        throw new CliError("Capability SKILL.md has no valid name frontmatter.", {
+            code: "RESEARCH_CAPABILITY_INVALID",
+            exitCode: 2,
+        });
+    }
+    return name;
+}
+async function copyRegularTree(source, target) {
+    const files = await regularTreeFiles(source);
+    for (const path of files) {
+        const logical = relative(source, path);
+        const destination = join(target, logical);
+        await ensureDirectory(dirname(destination));
+        await writeFile(destination, await readFile(path), { mode: 0o600 });
+    }
+}
+function assertUnique(values, label) {
+    const seen = new Set();
+    for (const value of values) {
+        if (seen.has(value)) {
+            throw new CliError(`Duplicate ${label}: ${value}`, {
+                code: "RESEARCH_CAPABILITY_INVALID",
+                exitCode: 2,
+            });
+        }
+        seen.add(value);
+    }
+}
+function invalid(index, detail) {
+    throw new CliError(`Capability declaration ${index} ${detail}.`, {
+        code: "RESEARCH_CAPABILITY_INVALID",
+        exitCode: 2,
+    });
+}
+//# sourceMappingURL=capabilities.js.map

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

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

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

@@ -0,0 +1,8 @@
+export declare const RESEARCH_CONTROL_DIRECTORY = ".tiangong-research";
+export declare const RESEARCH_PROTOCOL_VERSION: 1;
+export declare const RESEARCH_PACKAGE_NAME: "@tiangong-ai/cli";
+export declare const ALLOWED_CAPABILITY_PERMISSIONS: Set<string>;
+export declare const WORKSPACE_OPERATIONS: readonly ["research.context.inspect", "research.workspace.doctor", "research.capability.lock", "research.capability.verify", "research.project.init", "research.project.input.add", "research.status", "research.run"];
+export declare const UNMANAGED_OPERATIONS: readonly ["research.context.inspect", "research.workspace.init"];
+export declare const INVALID_OPERATIONS: readonly ["research.context.inspect"];
+export declare function packageVersion(): string;

package/dist/research/workspace/constants.js

@@ -0,0 +1,37 @@
+import { readFileSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+export const RESEARCH_CONTROL_DIRECTORY = ".tiangong-research";
+export const RESEARCH_PROTOCOL_VERSION = 1;
+export const RESEARCH_PACKAGE_NAME = "@tiangong-ai/cli";
+export const ALLOWED_CAPABILITY_PERMISSIONS = new Set([
+    "project-read",
+    "candidate-write",
+    "brokered-network",
+    "controlled-command",
+]);
+export const WORKSPACE_OPERATIONS = [
+    "research.context.inspect",
+    "research.workspace.doctor",
+    "research.capability.lock",
+    "research.capability.verify",
+    "research.project.init",
+    "research.project.input.add",
+    "research.status",
+    "research.run",
+];
+export const UNMANAGED_OPERATIONS = [
+    "research.context.inspect",
+    "research.workspace.init",
+];
+export const INVALID_OPERATIONS = ["research.context.inspect"];
+export function packageVersion() {
+    const moduleDirectory = dirname(fileURLToPath(import.meta.url));
+    const packagePath = resolve(moduleDirectory, "../../../package.json");
+    const value = JSON.parse(readFileSync(packagePath, "utf8"));
+    if (typeof value.version !== "string" || !value.version.trim()) {
+        throw new Error("Package version is unavailable.");
+    }
+    return value.version;
+}
+//# sourceMappingURL=constants.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/research/workspace/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,CAAC,MAAM,0BAA0B,GAAG,oBAAoB,CAAC;AAC/D,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAU,CAAC;AACpD,MAAM,CAAC,MAAM,qBAAqB,GAAG,kBAA2B,CAAC;AAEjE,MAAM,CAAC,MAAM,8BAA8B,GAAG,IAAI,GAAG,CAAC;IACpD,cAAc;IACd,iBAAiB;IACjB,kBAAkB;IAClB,oBAAoB;CACrB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,0BAA0B;IAC1B,2BAA2B;IAC3B,0BAA0B;IAC1B,4BAA4B;IAC5B,uBAAuB;IACvB,4BAA4B;IAC5B,iBAAiB;IACjB,cAAc;CACN,CAAC;AAEX,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,0BAA0B;IAC1B,yBAAyB;CACjB,CAAC;AAEX,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,0BAA0B,CAAU,CAAC;AAExE,MAAM,UAAU,cAAc;IAC5B,MAAM,eAAe,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAChE,MAAM,WAAW,GAAG,OAAO,CAAC,eAAe,EAAE,uBAAuB,CAAC,CAAC;IACtE,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,WAAW,EAAE,MAAM,CAAC,CAA0B,CAAC;IACrF,IAAI,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;QAC/D,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;IACrD,CAAC;IACD,OAAO,KAAK,CAAC,OAAO,CAAC;AACvB,CAAC"}

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

@@ -0,0 +1,3 @@
+import type { ContextInspection, WorkspaceMarker } from "./types.js";
+export declare function inspectResearchContext(selectedPath: string): Promise<ContextInspection>;
+export declare function isWorkspaceMarker(value: unknown): value is WorkspaceMarker;

package/dist/research/workspace/context.js

@@ -0,0 +1,77 @@
+import { lstat } from "node:fs/promises";
+import { dirname, join, parse, resolve } from "node:path";
+import { INVALID_OPERATIONS, RESEARCH_CONTROL_DIRECTORY, UNMANAGED_OPERATIONS, WORKSPACE_OPERATIONS, } from "./constants.js";
+import { isObject, pathExists, readJsonFile } from "./storage.js";
+export async function inspectResearchContext(selectedPath) {
+    const canonical = resolve(selectedPath);
+    const info = await lstat(canonical).catch(() => undefined);
+    let cursor = info?.isFile() ? dirname(canonical) : canonical;
+    while (true) {
+        const control = join(cursor, RESEARCH_CONTROL_DIRECTORY);
+        if (await pathExists(control)) {
+            const markerPath = join(control, "workspace.json");
+            if (!(await pathExists(markerPath))) {
+                return {
+                    role: "invalid",
+                    selectedPath: canonical,
+                    root: cursor,
+                    allowedOperations: [...INVALID_OPERATIONS],
+                    violations: [
+                        {
+                            code: "WORKSPACE_MARKER_MISSING",
+                            message: `${RESEARCH_CONTROL_DIRECTORY} exists without workspace.json.`,
+                        },
+                    ],
+                };
+            }
+            try {
+                const marker = await readJsonFile(markerPath, "Research workspace marker");
+                if (!isWorkspaceMarker(marker)) {
+                    return invalidMarker(canonical, cursor, "workspace.json has an unsupported shape.");
+                }
+                return {
+                    role: "workspace",
+                    selectedPath: canonical,
+                    root: cursor,
+                    allowedOperations: [...WORKSPACE_OPERATIONS],
+                    violations: [],
+                };
+            }
+            catch (error) {
+                return invalidMarker(canonical, cursor, String(error));
+            }
+        }
+        const parent = dirname(cursor);
+        if (cursor === parent || cursor === parse(cursor).root)
+            break;
+        cursor = parent;
+    }
+    return {
+        role: "unmanaged",
+        selectedPath: canonical,
+        root: null,
+        allowedOperations: [...UNMANAGED_OPERATIONS],
+        violations: [],
+    };
+}
+export function isWorkspaceMarker(value) {
+    return (isObject(value) &&
+        value.schemaVersion === 1 &&
+        value.kind === "tiangong-research-workspace" &&
+        typeof value.workspaceId === "string" &&
+        value.workspaceId.length > 0 &&
+        typeof value.name === "string" &&
+        value.name.length > 0 &&
+        typeof value.createdAt === "string" &&
+        value.createdAt.length > 0);
+}
+function invalidMarker(selectedPath, root, message) {
+    return {
+        role: "invalid",
+        selectedPath,
+        root,
+        allowedOperations: [...INVALID_OPERATIONS],
+        violations: [{ code: "WORKSPACE_MARKER_INVALID", message }],
+    };
+}
+//# sourceMappingURL=context.js.map

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

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

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

@@ -0,0 +1,12 @@
+import type { AgentRoute, ExecutionResult } from "./types.js";
+export interface AgentExecutionRequest {
+    route: AgentRoute;
+    prompt: string;
+    capsuleRoot: string;
+    projectRoot: string;
+    workspaceRoot: string;
+    timeoutSeconds: number;
+    environment: NodeJS.ProcessEnv;
+    brokerUrl: string | null;
+}
+export declare function executeAgent(request: AgentExecutionRequest): Promise<ExecutionResult>;