keri-ts 1.0.0 → 2.0.0

package/esm/keri/npm/src/app/cli/incept.js

@@ -1,185 +0,0 @@
-import { createQueue, spawn } from "effection";
-import { ValidationError } from "../../core/errors.js";
-import { createAgentRuntime, runAgentRuntimeUntil, runtimeHasPendingWork, runtimeHasWellKnownAuth, runtimeOobiTerminalState, } from "../agent-runtime.js";
-import { createConfiger } from "../configing.js";
-import { resolveDelegationCommunicationHab } from "../delegating.js";
-import { Receiptor, WitnessReceiptor } from "../witnessing.js";
-import { setupHby } from "./common/existing.js";
-import { loadInceptFileOptions, parseDataItems, parseThresholdOption } from "./common/parsing.js";
-/**
- * Loads incept options from a file and overlays explicit CLI values.
- */
-function mergeWithFile(args) {
-    let opts = {};
-    if (args.file && args.file !== "") {
-        opts = loadInceptFileOptions(args.file);
-    }
-    if (args.transferable !== undefined)
-        opts.transferable = args.transferable;
-    if (args.wits && args.wits.length > 0)
-        opts.wits = args.wits;
-    if (args.icount !== undefined)
-        opts.icount = Number(args.icount);
-    if (args.isith !== undefined)
-        opts.isith = parseThresholdOption(args.isith);
-    if (args.ncount !== undefined)
-        opts.ncount = Number(args.ncount);
-    if (args.nsith !== undefined)
-        opts.nsith = parseThresholdOption(args.nsith);
-    if (args.toad !== undefined)
-        opts.toad = Number(args.toad);
-    if (args.estOnly !== undefined)
-        opts.estOnly = args.estOnly;
-    if (args.delpre !== undefined)
-        opts.delpre = args.delpre;
-    if (args.data !== undefined)
-        opts.data = parseDataItems(args.data);
-    return opts;
-}
-/**
- * Implements `tufa incept`.
- *
- * Creates a single-sig identifier locally.
- */
-export function* inceptCommand(args) {
-    const inceptArgs = {
-        name: args.name,
-        base: args.base,
-        headDirPath: args.headDirPath,
-        temp: args.temp,
-        passcode: args.passcode,
-        alias: args.alias,
-        configDir: args.configDir,
-        configFile: args.configFile,
-        endpoint: args.endpoint,
-        proxy: args.proxy,
-        file: args.file,
-        transferable: args.transferable,
-        wits: args.wits,
-        toad: args.toad,
-        icount: args.icount,
-        isith: args.isith,
-        ncount: args.ncount,
-        nsith: args.nsith,
-        estOnly: args.estOnly,
-        data: args.data,
-        delpre: args.delpre,
-    };
-    if (!inceptArgs.name) {
-        throw new ValidationError("Name is required and cannot be empty");
-    }
-    if (!inceptArgs.alias) {
-        throw new ValidationError("Alias is required and cannot be empty");
-    }
-    if (inceptArgs.endpoint) {
-        // supported below
-    }
-    const opts = mergeWithFile(inceptArgs);
-    const cues = createQueue();
-    const doer = yield* spawn(function* () {
-        const cf = inceptArgs.configFile
-            ? (yield* createConfiger({
-                name: inceptArgs.configFile,
-                base: "",
-                temp: false,
-                headDirPath: inceptArgs.configDir,
-                reopen: true,
-                clear: false,
-            }))
-            : undefined;
-        const hby = yield* setupHby(inceptArgs.name, inceptArgs.base ?? "", inceptArgs.passcode, inceptArgs.temp ?? false, inceptArgs.headDirPath, {
-            readonly: false,
-            cf,
-            skipConfig: !cf,
-            skipSignator: true,
-        });
-        try {
-            if (hby.db.oobis.cnt() > 0 || hby.db.woobi.cnt() > 0) {
-                const runtime = yield* createAgentRuntime(hby);
-                try {
-                    yield* runAgentRuntimeUntil(runtime, () => !runtimeHasPendingWork(runtime), { timeoutMs: 30_000, pollMailbox: false });
-                    if (hby.db.eoobi.cnt() > 0) {
-                        throw new ValidationError("Bootstrap OOBI resolution failed before inception.");
-                    }
-                    assertConfiguredWellKnownAuth(runtime, hby, "inception");
-                }
-                finally {
-                    yield* runtime.close();
-                }
-            }
-            const hab = hby.makeHab(inceptArgs.alias, undefined, {
-                transferable: opts.transferable ?? false,
-                wits: opts.wits ?? [],
-                toad: opts.toad ?? 0,
-                icount: opts.icount ?? 1,
-                isith: opts.isith,
-                ncount: opts.ncount ?? 1,
-                nsith: opts.nsith,
-                estOnly: opts.estOnly ?? false,
-                data: opts.data ?? [],
-                delpre: opts.delpre,
-            });
-            if (hab.kever?.wits.length) {
-                if (inceptArgs.endpoint) {
-                    const receiptor = new Receiptor(hby);
-                    yield* receiptor.receipt(hab.pre, { sn: 0 });
-                }
-                else {
-                    const witDoer = new WitnessReceiptor(hby);
-                    yield* witDoer.submit(hab.pre, { sn: 0 });
-                }
-            }
-            let delegationPhase = null;
-            if (opts.delpre) {
-                const communicationHab = resolveDelegationCommunicationHab(hby, inceptArgs.proxy);
-                if (!communicationHab) {
-                    throw new ValidationError(`Delegated inception for ${hab.pre} requires --proxy <alias>.`);
-                }
-                const runtime = yield* createAgentRuntime(hby);
-                try {
-                    runtime.delegating.beginLatest(hab.pre, 0, {
-                        communicationHab,
-                    });
-                    yield* runAgentRuntimeUntil(runtime, () => runtime.delegating.complete(hab.pre, 0), { hab, timeoutMs: 120_000, pollMailbox: true });
-                    delegationPhase = runtime.delegating.workflowStatus(hab.pre, "0").phase;
-                }
-                finally {
-                    yield* runtime.close();
-                }
-            }
-            const state = hby.db.getState(hab.pre);
-            console.log(`Prefix  ${hab.pre}`);
-            for (const [idx, key] of (state?.k ?? []).entries()) {
-                console.log(`\tPublic key ${idx + 1}:  ${key}`);
-            }
-            if (delegationPhase) {
-                console.log(`Delegation status  ${delegationPhase}`);
-            }
-            console.log("");
-            cues.add({ kin: "incept", pre: hab.pre, mode: "native" });
-        }
-        finally {
-            yield* hby.close();
-        }
-    });
-    yield* doer;
-    const cue = yield* cues.next();
-    if (cue.done)
-        return;
-}
-function configuredWellKnownUrls(hby) {
-    return Array.isArray(hby.config.wurls)
-        ? hby.config.wurls.filter((entry) => typeof entry === "string")
-        : [];
-}
-function assertConfiguredWellKnownAuth(runtime, hby, context) {
-    const failed = configuredWellKnownUrls(hby).filter((url) => !runtimeHasWellKnownAuth(runtime, url));
-    if (failed.length === 0) {
-        return;
-    }
-    const details = failed.map((url) => {
-        const terminal = runtimeOobiTerminalState(runtime, url);
-        return `${url} (${terminal.record?.state ?? terminal.status})`;
-    }).join(", ");
-    throw new ValidationError(`Bootstrap well-known auth failed before ${context}: ${details}`);
-}

package/esm/keri/npm/src/app/cli/index.js

@@ -1,36 +0,0 @@
-/**
- * CLI module - public API
- *
- * This transitional module now exposes only the remaining non-host command
- * helpers that still live under `keri-ts`.
- */
-export { aidCommand } from "./aid.js";
-export { annotateCommand } from "./annotate.js";
-export { benchmarkCommand } from "./benchmark.js";
-export { challengeGenerateCommand, challengeRespondCommand, challengeVerifyCommand } from "./challenge.js";
-export { withAgentRuntime, withExistingHab, withExistingHabery, withHabAndAgentRuntime, } from "./common/context.js";
-export { ensureHby, setupHby } from "./common/existing.js";
-export { writeJsonLine, writeTextLines } from "./common/rendering.js";
-export { resolveWitnessAuths } from "./common/witness-auth.js";
-export { dumpEvts } from "./db-dump.js";
-export { delegateConfirmCommand } from "./delegate.js";
-export { dkrResolveCommand, dwsBindCommand, dwsGenerateCommand, dwsResolveCommand } from "./did.js";
-export { endsAddCommand } from "./ends.js";
-export { exchangeSendCommand } from "./exchange.js";
-export { exportCommand } from "./export.js";
-export { inceptCommand } from "./incept.js";
-export { initCommand } from "./init.js";
-export { interactCommand } from "./interact.js";
-export { ipexAdmitCommand, ipexAgreeCommand, ipexApplyCommand, ipexGrantCommand, ipexJoinCommand, ipexListCommand, ipexOfferCommand, ipexPollCommand, ipexSpurnCommand, } from "./ipex.js";
-export { listCommand } from "./list.js";
-export { locAddCommand } from "./loc.js";
-export { multisigInceptCommand, multisigInteractCommand, multisigJoinCommand, multisigRotateCommand, multisigRpyCommand, } from "./multisig.js";
-export { notificationsListCommand, notificationsMarkReadCommand, notificationsRemoveCommand } from "./notifications.js";
-export { oobiGenerateCommand, oobiRequestCommand, oobiResolveCommand } from "./oobi.js";
-export { queryCommand } from "./query.js";
-export { rotateCommand } from "./rotate.js";
-export { saidifyCommand } from "./saidify.js";
-export { signCommand } from "./sign.js";
-export { vcCreateCommand, vcExportCommand, vcImportCommand, vcListCommand, vcRegistryInceptCommand, vcRegistryListCommand, vcRegistryStatusCommand, vcRevokeCommand, vcSchemaImportCommand, } from "./vc.js";
-export { verifierRunCommand } from "./verifier.js";
-export { verifyCommand } from "./verify.js";

package/esm/keri/npm/src/app/cli/init.js

@@ -1,149 +0,0 @@
-import { createQueue, spawn } from "effection";
-import { PathError, ValidationError } from "../../core/errors.js";
-import { createAgentRuntime, runAgentRuntimeUntil, runtimeHasPendingWork, runtimeHasWellKnownAuth, runtimeOobiTerminalState, } from "../agent-runtime.js";
-import { normalizeCesrBodyMode } from "../cesr-http.js";
-import { createConfiger } from "../configing.js";
-import { createHabery } from "../habbing.js";
-/**
- * Implements `tufa init`.
- *
- * Creates/open a habery keystore and database.
- */
-export function* initCommand(args) {
-    // Extract values from args
-    const initArgs = {
-        name: args.name,
-        base: args.base,
-        headDirPath: args.headDirPath,
-        temp: args.temp,
-        salt: args.salt,
-        configDir: args.configDir,
-        configFile: args.configFile,
-        passcode: args.passcode,
-        nopasscode: args.nopasscode,
-        aeid: args.aeid,
-        seed: args.seed,
-        cesrBodyMode: normalizeCesrBodyMode(args.cesrBodyMode),
-    };
-    // Validate required name
-    const name = initArgs.name;
-    if (!name || name === "") {
-        throw new ValidationError("Name is required and cannot be empty");
-    }
-    const base = initArgs.base || "";
-    const headDirPath = initArgs.headDirPath;
-    const temp = initArgs.temp || false;
-    let bran = initArgs.passcode;
-    const nopasscode = initArgs.nopasscode || false;
-    // Handle passcode input if not provided and not using nopasscode
-    if (!nopasscode && !bran) {
-        console.log("Creating encrypted keystore, please enter your 22 character passcode:");
-        // For now, we'll use a simple prompt since Deno doesn't have getpass equivalent
-        // In a real implementation, you'd want to use a proper password input library
-        const passcode = prompt("Passcode: ");
-        const retry = prompt("Re-enter passcode: ");
-        if (passcode !== retry) {
-            throw new ValidationError("Passcodes do not match");
-        }
-        bran = passcode || undefined;
-    }
-    const cues = createQueue();
-    const doer = yield* spawn(function* () {
-        const cf = initArgs.configFile
-            ? (yield* createConfiger({
-                name: initArgs.configFile,
-                base: "",
-                temp: false,
-                headDirPath: initArgs.configDir,
-                reopen: true,
-                clear: false,
-            }))
-            : undefined;
-        let hby;
-        try {
-            hby = yield* createHabery({
-                name,
-                base,
-                headDirPath,
-                temp,
-                cf,
-                skipConfig: !cf,
-                skipSignator: true,
-                bran: bran ?? undefined,
-                aeid: initArgs.aeid,
-                seed: initArgs.seed,
-                salt: initArgs.salt,
-                cesrBodyMode: initArgs.cesrBodyMode,
-            });
-        }
-        catch (error) {
-            if (temp || !(error instanceof PathError)) {
-                throw error;
-            }
-            console.log("Persistent keystore path unavailable, retrying with temporary keystore mode.");
-            hby = yield* createHabery({
-                name,
-                base,
-                headDirPath,
-                temp: true,
-                cf,
-                skipConfig: !cf,
-                skipSignator: true,
-                bran: bran ?? undefined,
-                aeid: initArgs.aeid,
-                seed: initArgs.seed,
-                salt: initArgs.salt,
-                cesrBodyMode: initArgs.cesrBodyMode,
-            });
-        }
-        try {
-            hby.ks.pinGbls("cesrBodyMode", initArgs.cesrBodyMode ?? "header");
-            if (runtimeBootstrapNeeded(hby)) {
-                const runtime = yield* createAgentRuntime(hby);
-                try {
-                    yield* runAgentRuntimeUntil(runtime, () => !runtimeHasPendingWork(runtime), { timeoutMs: 30_000, pollMailbox: false });
-                    if (hby.db.eoobi.cnt() > 0) {
-                        throw new ValidationError("Bootstrap OOBI resolution failed during init.");
-                    }
-                    assertConfiguredWellKnownAuth(runtime, hby, "init");
-                }
-                finally {
-                    yield* runtime.close();
-                }
-            }
-            console.log("KERI Keystore created at:", hby.ks.path);
-            console.log("KERI Database created at:", hby.db.path);
-            console.log("KERI Credential Store created at:", hby.db.path);
-            if (hby.mgr.aeid) {
-                console.log("\taeid:", hby.mgr.aeid);
-            }
-            cues.add({ kin: "init", mode: "native", name });
-        }
-        finally {
-            yield* hby.close();
-        }
-    });
-    yield* doer;
-    const cue = yield* cues.next();
-    if (cue.done)
-        return;
-}
-function runtimeBootstrapNeeded(hby) {
-    return hby.db.oobis.cnt() > 0 || hby.db.woobi.cnt() > 0;
-}
-function configuredWellKnownUrls(hby) {
-    return Array.isArray(hby.config.wurls)
-        ? hby.config.wurls.filter((entry) => typeof entry === "string")
-        : [];
-}
-function assertConfiguredWellKnownAuth(runtime, hby, context) {
-    const failed = configuredWellKnownUrls(hby).filter((url) => !runtimeHasWellKnownAuth(runtime, url));
-    if (failed.length === 0) {
-        return;
-    }
-    const details = failed.map((url) => {
-        const terminal = runtimeOobiTerminalState(runtime, url);
-        return `${url} (${terminal.record?.state ?? terminal.status})`;
-    }).join(", ");
-    throw new ValidationError(`Bootstrap well-known auth failed during ${context}: ${details}`);
-}

package/esm/keri/npm/src/app/cli/interact.js

@@ -1,72 +0,0 @@
-import { ValidationError } from "../../core/errors.js";
-import { Receiptor, WitnessReceiptor } from "../witnessing.js";
-import { withExistingHab } from "./common/context.js";
-import { parseDataItems } from "./common/parsing.js";
-import { resolveWitnessAuths } from "./common/witness-auth.js";
-/**
- * Create one local interaction event and optionally converge witness receipts.
- *
- * Maintainer boundary:
- * - CLI concerns stop at argument parsing, witness-auth capture, and success
- *   output
- * - interaction event authoring and local acceptance live in `Hab.interact(...)`
- */
-export function* interactCommand(args) {
-    const interactArgs = {
-        name: args.name,
-        base: args.base,
-        headDirPath: args.headDirPath,
-        passcode: args.passcode,
-        alias: args.alias,
-        compat: args.compat,
-        endpoint: args.endpoint,
-        authenticate: args.authenticate,
-        code: args.code,
-        codeTime: args.codeTime,
-        data: args.data,
-    };
-    if (!interactArgs.name) {
-        throw new ValidationError("Name is required and cannot be empty");
-    }
-    if (!interactArgs.alias) {
-        throw new ValidationError("Alias is required and cannot be empty");
-    }
-    const data = parseDataItems(interactArgs.data);
-    yield* withExistingHab(interactArgs, interactArgs.alias, {
-        compat: interactArgs.compat ?? false,
-        readonly: false,
-        skipConfig: true,
-        skipSignator: true,
-    }, function* ({ hby, hab }) {
-        if (!hab.kever) {
-            throw new ValidationError(`Missing accepted key state for ${hab.pre}.`);
-        }
-        hab.interact({ data });
-        if (hab.kever?.wits.length) {
-            const auths = resolveWitnessAuths(hab.kever.wits, interactArgs.code ?? [], {
-                codeTime: interactArgs.codeTime,
-                promptMissing: interactArgs.authenticate ?? false,
-            });
-            if (interactArgs.endpoint) {
-                const receiptor = new Receiptor(hby);
-                yield* receiptor.receipt(hab.pre, {
-                    sn: hab.kever.sn,
-                    auths,
-                });
-            }
-            else {
-                const witDoer = new WitnessReceiptor(hby);
-                yield* witDoer.submit(hab.pre, {
-                    sn: hab.kever.sn,
-                    auths,
-                });
-            }
-        }
-        const state = hby.db.getState(hab.pre);
-        console.log(`Prefix  ${hab.pre}`);
-        console.log(`New Sequence No.  ${hab.kever?.sn ?? state?.s ?? ""}`);
-        for (const [idx, key] of (state?.k ?? []).entries()) {
-            console.log(`\tPublic key ${idx + 1}:  ${key}`);
-        }
-    });
-}