@peerllm/client-core 0.1.0

package/dist/services/processings/configs/ConfigProcessingService.js

@@ -0,0 +1,157 @@
+import { createDefaultConfigDocument } from "../../../models/foundations/configs/ConfigDocument.js";
+import { NotFoundConfigException } from "../../../models/foundations/configs/exceptions/NotFoundConfigException.js";
+import { LockedConfigException } from "../../../models/foundations/configs/exceptions/LockedConfigException.js";
+import { ConfigDependencyValidationException } from "../../../models/foundations/configs/exceptions/ConfigDependencyValidationException.js";
+import { LockUnavailableConfigProcessingException } from "../../../models/processings/configs/exceptions/LockUnavailableConfigProcessingException.js";
+import { healthy, innermostMessage, unwell } from "../../../models/processings/health/HealthCheck.js";
+import { createTryCatch } from "./ConfigProcessingService.Exceptions.js";
+// Changing the configuration while another application may be changing it too (SPEC.md 14.2).
+//
+// The lock is taken, the document is read, the change is applied, the document is written and the
+// lock is released. A hold lasts milliseconds, which is what lets the loop below bound a crashed
+// holder by age alone and never probe whether a process is alive: a pid is reused, and a check
+// that asks about one is wrong on any machine that has been up long enough.
+export const LOCK_RETRY_MILLISECONDS = 50;
+export const LOCK_WAIT_MILLISECONDS = 5_000;
+export const LOCK_STALE_MILLISECONDS = 30_000;
+export class ConfigProcessingService {
+    configService;
+    loggingBroker;
+    timeBroker;
+    retryMilliseconds;
+    waitMilliseconds;
+    tryCatch;
+    constructor(configService, loggingBroker, timeBroker, retryMilliseconds = LOCK_RETRY_MILLISECONDS, waitMilliseconds = LOCK_WAIT_MILLISECONDS) {
+        this.configService = configService;
+        this.loggingBroker = loggingBroker;
+        this.timeBroker = timeBroker;
+        this.retryMilliseconds = retryMilliseconds;
+        this.waitMilliseconds = waitMilliseconds;
+        this.tryCatch = createTryCatch(this.loggingBroker);
+    }
+    // The document as it stands. A pass-through: reading needs no lock, because the document is
+    // written whole through a rename and a reader sees the version before the write or the one
+    // after it, never half of either. What this adds is the tier, so a caller above can depend on
+    // one service rather than reaching past it to the foundation.
+    retrieveConfig(path) {
+        return this.tryCatch(async () => await this.configService.retrieveConfig(path));
+    }
+    // Whether the configuration this machine has is one a run can start from (PLAN.md 2.7).
+    verifyConfig(path) {
+        return this.tryCatch(async () => {
+            // The one routine in this service that swallows what it catches. Everywhere else an
+            // exception is the truthful answer; here the question being asked is whether the thing is
+            // well, and a check that fails instead of answering has told the user nothing they can use.
+            try {
+                const document = await this.configService.retrieveConfig(path);
+                // A document with no profile is what a first run writes before anybody has signed in. It is
+                // not damaged, and telling somebody it is damaged would send them looking for the wrong thing.
+                if (document.profiles.length === 0) {
+                    return unwell(NAME, `${path} names no profile. Run peerllm init --key <key> to store one.`);
+                }
+                return healthy(NAME, `${path}: ${document.profiles.length} profile(s), active '${document.activeProfileId}'`);
+            }
+            catch (error) {
+                // A document that is not there is a machine nobody has signed in on, which is the ordinary
+                // first case and not damage. Handing somebody the file system's own words about a file they
+                // have never heard of is the least useful thing this command could say to them.
+                if (error instanceof ConfigDependencyValidationException && error.innerError instanceof NotFoundConfigException) {
+                    return unwell(NAME, `nobody has signed in on this machine. Run peerllm init --key <key> to store a profile.`);
+                }
+                return unwell(NAME, `${path} could not be read: ${innermostMessage(error)}`);
+            }
+        });
+    }
+    // Read, change, write, all under the lock, so two applications cannot each read the document and
+    // write back a version missing the other's change.
+    modifyConfig(path, change) {
+        return this.tryCatch(async () => {
+            await this.takeLock(lockPathOf(path));
+            try {
+                const changed = change(await this.readOrDefault(path));
+                await this.configService.modifyConfig(path, changed);
+                return changed;
+            }
+            finally {
+                // Released whatever happened. A lock left behind by a change that threw is a lock the next
+                // writer waits five seconds for and then reclaims, and both of those are worse than a
+                // release in a finally.
+                await this.configService.releaseLock(lockPathOf(path));
+            }
+        });
+    }
+    // A first run has no document. Changing one that is not there means starting from the defaults,
+    // because refusing would mean the only way to get a configuration is to already have one.
+    async readOrDefault(path) {
+        try {
+            return await this.configService.retrieveConfig(path);
+        }
+        catch (error) {
+            if (error instanceof ConfigDependencyValidationException && error.innerError instanceof NotFoundConfigException) {
+                return createDefaultConfigDocument(THIS_APPLICATION);
+            }
+            throw error;
+        }
+    }
+    // One attempt, then another every fifty milliseconds until five seconds have passed. A hold
+    // lasts milliseconds, so a wait this long means the other side is not merely slow.
+    async takeLock(lockPath) {
+        const until = this.timeBroker.getCurrentDateTime().getTime() + this.waitMilliseconds;
+        for (;;) {
+            const taken = await this.attemptLock(lockPath);
+            if (taken) {
+                return;
+            }
+            await this.reclaimIfStale(lockPath);
+            if (this.timeBroker.getCurrentDateTime().getTime() >= until) {
+                throw new LockUnavailableConfigProcessingException("could not change the configuration: the lock is held and did not come free", new Error(`the lock at ${lockPath} was held for the whole wait`));
+            }
+            await pause(this.retryMilliseconds);
+        }
+    }
+    async attemptLock(lockPath) {
+        try {
+            await this.configService.acquireLock(lockPath, process.pid);
+            return true;
+        }
+        catch (error) {
+            if (!isHeld(error)) {
+                throw error;
+            }
+            return false;
+        }
+    }
+    // A holder that is corrupt, or that took the lock longer ago than any honest hold lasts, is
+    // released so the next attempt can take it. Nothing here asks whether that process is alive.
+    async reclaimIfStale(lockPath) {
+        const holder = await this.configService.retrieveLockHolder(lockPath);
+        const takenOn = holder?.takenOn.getTime();
+        const stale = takenOn === undefined || this.timeBroker.getCurrentDateTime().getTime() - takenOn >= LOCK_STALE_MILLISECONDS;
+        if (!stale) {
+            return;
+        }
+        await this.loggingBroker.logWarning(`reclaiming the configuration lock at ${lockPath}: the holder is stale`);
+        await this.configService.releaseLock(lockPath);
+    }
+}
+// The lock sits beside the document it guards, which is what makes it obvious on disk what a
+// leftover file is guarding.
+function lockPathOf(path) {
+    return `${path.replace(/\.json$/, "")}.lock`;
+}
+// Held is the foundation's dependency-validation answer carrying a LockedConfigException. Anything
+// else that went wrong is not a reason to keep asking.
+function isHeld(error) {
+    return (error instanceof ConfigDependencyValidationException && error.innerError instanceof LockedConfigException);
+}
+function pause(milliseconds) {
+    return new Promise((resolve) => {
+        setTimeout(resolve, milliseconds);
+    });
+}
+// The name this client writes into `lastWriter`, so the desktop can tell who touched the document
+// last (SPEC.md 14.2).
+const THIS_APPLICATION = "client-cli";
+// What this check is called on the report. One word, so the four of them line up.
+const NAME = "configuration";
+//# sourceMappingURL=ConfigProcessingService.js.map

package/dist/services/processings/configs/ConfigProcessingService.js.map

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

package/dist/services/processings/processes/ProcessProcessingService.Exceptions.d.ts

@@ -0,0 +1,4 @@
+import type { LoggingBroker } from "@hassanhabib/standard-agents";
+export type TryCatch = <T>(routine: () => Promise<T>) => Promise<T>;
+export declare function createTryCatch(loggingBroker: LoggingBroker): TryCatch;
+//# sourceMappingURL=ProcessProcessingService.Exceptions.d.ts.map

package/dist/services/processings/processes/ProcessProcessingService.Exceptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProcessProcessingService.Exceptions.d.ts","sourceRoot":"","sources":["../../../../src/services/processings/processes/ProcessProcessingService.Exceptions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAclE,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;AAEpE,wBAAgB,cAAc,CAAC,aAAa,EAAE,aAAa,GAAG,QAAQ,CA8CrE"}

package/dist/services/processings/processes/ProcessProcessingService.Exceptions.js

@@ -0,0 +1,33 @@
+import { ProcessDependencyValidationException } from "../../../models/foundations/processes/exceptions/ProcessDependencyValidationException.js";
+import { ProcessServiceException } from "../../../models/foundations/processes/exceptions/ProcessServiceException.js";
+import { ProcessValidationException } from "../../../models/foundations/processes/exceptions/ProcessValidationException.js";
+import { FailedProcessProcessingServiceException } from "../../../models/processings/processes/exceptions/FailedProcessProcessingServiceException.js";
+import { ProcessProcessingDependencyException } from "../../../models/processings/processes/exceptions/ProcessProcessingDependencyException.js";
+import { ProcessProcessingDependencyValidationException } from "../../../models/processings/processes/exceptions/ProcessProcessingDependencyValidationException.js";
+import { ProcessProcessingServiceException } from "../../../models/processings/processes/exceptions/ProcessProcessingServiceException.js";
+import { ProcessProcessingValidationException } from "../../../models/processings/processes/exceptions/ProcessProcessingValidationException.js";
+export function createTryCatch(loggingBroker) {
+    return async function tryCatch(routine) {
+        try {
+            return await routine();
+        }
+        catch (error) {
+            if (error instanceof ProcessValidationException) {
+                throw await createAndLog(loggingBroker, new ProcessProcessingValidationException("Process processing validation error occurred, fix the error and try again.", error.innerError));
+            }
+            if (error instanceof ProcessDependencyValidationException) {
+                throw await createAndLog(loggingBroker, new ProcessProcessingDependencyValidationException("Process processing dependency validation error occurred, fix the error and try again.", error.innerError));
+            }
+            if (error instanceof ProcessServiceException) {
+                throw await createAndLog(loggingBroker, new ProcessProcessingDependencyException("Process processing dependency error occurred, contact support.", error.innerError));
+            }
+            const failed = new FailedProcessProcessingServiceException("Failed process processing service error occurred, contact support.", error instanceof Error ? error : new Error(String(error)));
+            throw await createAndLog(loggingBroker, new ProcessProcessingServiceException("Process processing service error occurred, contact support.", failed));
+        }
+    };
+}
+async function createAndLog(loggingBroker, exception) {
+    await loggingBroker.logError(exception);
+    return exception;
+}
+//# sourceMappingURL=ProcessProcessingService.Exceptions.js.map

package/dist/services/processings/processes/ProcessProcessingService.Exceptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProcessProcessingService.Exceptions.js","sourceRoot":"","sources":["../../../../src/services/processings/processes/ProcessProcessingService.Exceptions.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oCAAoC,EAAE,MAAM,0FAA0F,CAAC;AAChJ,OAAO,EAAE,uBAAuB,EAAE,MAAM,6EAA6E,CAAC;AACtH,OAAO,EAAE,0BAA0B,EAAE,MAAM,gFAAgF,CAAC;AAC5H,OAAO,EAAE,uCAAuC,EAAE,MAAM,6FAA6F,CAAC;AACtJ,OAAO,EAAE,oCAAoC,EAAE,MAAM,0FAA0F,CAAC;AAChJ,OAAO,EAAE,8CAA8C,EAAE,MAAM,oGAAoG,CAAC;AACpK,OAAO,EAAE,iCAAiC,EAAE,MAAM,uFAAuF,CAAC;AAC1I,OAAO,EAAE,oCAAoC,EAAE,MAAM,0FAA0F,CAAC;AAOhJ,MAAM,UAAU,cAAc,CAAC,aAA4B;IACzD,OAAO,KAAK,UAAU,QAAQ,CAAI,OAAyB;QACzD,IAAI,CAAC;YACH,OAAO,MAAM,OAAO,EAAE,CAAC;QACzB,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,IAAI,KAAK,YAAY,0BAA0B,EAAE,CAAC;gBAChD,MAAM,MAAM,YAAY,CACtB,aAAa,EACb,IAAI,oCAAoC,CACtC,4EAA4E,EAC5E,KAAK,CAAC,UAAU,CACjB,CACF,CAAC;YACJ,CAAC;YAED,IAAI,KAAK,YAAY,oCAAoC,EAAE,CAAC;gBAC1D,MAAM,MAAM,YAAY,CACtB,aAAa,EACb,IAAI,8CAA8C,CAChD,uFAAuF,EACvF,KAAK,CAAC,UAAU,CACjB,CACF,CAAC;YACJ,CAAC;YAED,IAAI,KAAK,YAAY,uBAAuB,EAAE,CAAC;gBAC7C,MAAM,MAAM,YAAY,CACtB,aAAa,EACb,IAAI,oCAAoC,CACtC,gEAAgE,EAChE,KAAK,CAAC,UAAU,CACjB,CACF,CAAC;YACJ,CAAC;YAED,MAAM,MAAM,GAAG,IAAI,uCAAuC,CACxD,oEAAoE,EACpE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAC1D,CAAC;YAEF,MAAM,MAAM,YAAY,CACtB,aAAa,EACb,IAAI,iCAAiC,CAAC,6DAA6D,EAAE,MAAM,CAAC,CAC7G,CAAC;QACJ,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,YAAY,CAAkB,aAA4B,EAAE,SAAY;IACrF,MAAM,aAAa,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IAExC,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/services/processings/processes/ProcessProcessingService.d.ts

@@ -0,0 +1,13 @@
+import type { LoggingBroker } from "@hassanhabib/standard-agents";
+import { type HealthCheck } from "../../../models/processings/health/HealthCheck.js";
+import type { ProcessService } from "../../foundations/processes/ProcessService.js";
+export declare const MAXIMUM_OUTPUT_BYTES = 32768;
+export declare class ProcessProcessingService {
+    private readonly processService;
+    private readonly loggingBroker;
+    private readonly tryCatch;
+    constructor(processService: ProcessService, loggingBroker: LoggingBroker);
+    runCommand(argv: readonly string[], cwd: string, signal?: AbortSignal): Promise<string>;
+    verifyTooling(cwd: string): Promise<HealthCheck>;
+}
+//# sourceMappingURL=ProcessProcessingService.d.ts.map

package/dist/services/processings/processes/ProcessProcessingService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProcessProcessingService.d.ts","sourceRoot":"","sources":["../../../../src/services/processings/processes/ProcessProcessingService.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAGlE,OAAO,EAAqC,KAAK,WAAW,EAAE,MAAM,mDAAmD,CAAC;AACxH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+CAA+C,CAAC;AAQpF,eAAO,MAAM,oBAAoB,QAAS,CAAC;AAE3C,qBAAa,wBAAwB;IACnC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAiB;IAChD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;IAC9C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAW;gBAEjB,cAAc,EAAE,cAAc,EAAE,aAAa,EAAE,aAAa;IAMxE,UAAU,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC;IASvF,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;CAkBxD"}

package/dist/services/processings/processes/ProcessProcessingService.js

@@ -0,0 +1,66 @@
+import { healthy, innermostMessage, unwell } from "../../../models/processings/health/HealthCheck.js";
+import { createTryCatch } from "./ProcessProcessingService.Exceptions.js";
+// A command's whole story, in the shape a model can read (SPEC.md 7.2).
+//
+// What the model needs is what a person watching a terminal needs: what it printed, and whether it
+// worked. The exit code is stated rather than left to be inferred from the prose, because "the
+// tests failed" and "the runner crashed" read alike in output and mean different things.
+export const MAXIMUM_OUTPUT_BYTES = 32_768;
+export class ProcessProcessingService {
+    processService;
+    loggingBroker;
+    tryCatch;
+    constructor(processService, loggingBroker) {
+        this.processService = processService;
+        this.loggingBroker = loggingBroker;
+        this.tryCatch = createTryCatch(this.loggingBroker);
+    }
+    runCommand(argv, cwd, signal) {
+        return this.tryCatch(async () => {
+            const outcome = await this.processService.runProcess(argv, cwd, signal);
+            return present(outcome, argv);
+        });
+    }
+    // Whether the programs the git tools lean on are on this machine (PLAN.md 2.7).
+    verifyTooling(cwd) {
+        return this.tryCatch(async () => {
+            try {
+                const outcome = await this.processService.runProcess([...GIT_VERSION], cwd);
+                // Not on the PATH is the ordinary way this fails, and it is worth naming, because a run that
+                // loses its git tools halfway through a task looks to the user like the agent forgetting how
+                // to work rather than like a machine missing a program.
+                if (outcome.exitCode !== 0) {
+                    return unwell(NAME, `git did not answer. The git tools need it on the PATH.`);
+                }
+                return healthy(NAME, outcome.stdout.trim() || "git answered");
+            }
+            catch (error) {
+                return unwell(NAME, `git could not be run: ${innermostMessage(error)}`);
+            }
+        });
+    }
+}
+function present(outcome, argv) {
+    const said = [outcome.stdout, outcome.stderr].filter((stream) => stream.trim().length > 0).join("\n");
+    return [tail(said), verdict(outcome, argv)].filter((part) => part.length > 0).join("\n");
+}
+// Said plainly, because a non-zero exit is the answer to the question the agent asked.
+function verdict(outcome, argv) {
+    if (outcome.timedOut) {
+        return `[${argv[0] ?? ""}] was still running and was stopped`;
+    }
+    return `[${argv[0] ?? ""}] exited ${outcome.exitCode ?? "without a code"}`;
+}
+// The end rather than the beginning. A test runner says what failed last, and the first thirty-two
+// kilobytes of a long build are the part nobody needed.
+function tail(said) {
+    if (Buffer.byteLength(said, "utf8") <= MAXIMUM_OUTPUT_BYTES) {
+        return said;
+    }
+    const kept = Buffer.from(said, "utf8").subarray(-MAXIMUM_OUTPUT_BYTES).toString("utf8");
+    return [`[output cut: the last ${MAXIMUM_OUTPUT_BYTES} bytes follow]`, kept].join("\n");
+}
+// What this check is called on the report, and the smallest question that proves git is there.
+const NAME = "tooling";
+const GIT_VERSION = ["git", "--version"];
+//# sourceMappingURL=ProcessProcessingService.js.map

package/dist/services/processings/processes/ProcessProcessingService.js.map

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

package/dist/services/processings/registrySkills/RegistrySkillProcessingService.Exceptions.d.ts

@@ -0,0 +1,4 @@
+import type { LoggingBroker } from "@hassanhabib/standard-agents";
+export type TryCatch = <T>(routine: () => Promise<T>) => Promise<T>;
+export declare function createTryCatch(loggingBroker: LoggingBroker): TryCatch;
+//# sourceMappingURL=RegistrySkillProcessingService.Exceptions.d.ts.map

package/dist/services/processings/registrySkills/RegistrySkillProcessingService.Exceptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RegistrySkillProcessingService.Exceptions.d.ts","sourceRoot":"","sources":["../../../../src/services/processings/registrySkills/RegistrySkillProcessingService.Exceptions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAelE,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;AAEpE,wBAAgB,cAAc,CAAC,aAAa,EAAE,aAAa,GAAG,QAAQ,CAoDrE"}

package/dist/services/processings/registrySkills/RegistrySkillProcessingService.Exceptions.js

@@ -0,0 +1,36 @@
+import { RegistrySkillDependencyException } from "../../../models/foundations/registrySkills/exceptions/RegistrySkillDependencyException.js";
+import { RegistrySkillDependencyValidationException } from "../../../models/foundations/registrySkills/exceptions/RegistrySkillDependencyValidationException.js";
+import { RegistrySkillServiceException } from "../../../models/foundations/registrySkills/exceptions/RegistrySkillServiceException.js";
+import { RegistrySkillValidationException } from "../../../models/foundations/registrySkills/exceptions/RegistrySkillValidationException.js";
+import { FailedRegistrySkillProcessingServiceException } from "../../../models/processings/registrySkills/exceptions/FailedRegistrySkillProcessingServiceException.js";
+import { InvalidRegistrySkillProcessingException } from "../../../models/processings/registrySkills/exceptions/InvalidRegistrySkillProcessingException.js";
+import { RegistrySkillProcessingDependencyException } from "../../../models/processings/registrySkills/exceptions/RegistrySkillProcessingDependencyException.js";
+import { RegistrySkillProcessingDependencyValidationException } from "../../../models/processings/registrySkills/exceptions/RegistrySkillProcessingDependencyValidationException.js";
+import { RegistrySkillProcessingServiceException } from "../../../models/processings/registrySkills/exceptions/RegistrySkillProcessingServiceException.js";
+import { RegistrySkillProcessingValidationException } from "../../../models/processings/registrySkills/exceptions/RegistrySkillProcessingValidationException.js";
+export function createTryCatch(loggingBroker) {
+    return async function tryCatch(routine) {
+        try {
+            return await routine();
+        }
+        catch (error) {
+            if (error instanceof InvalidRegistrySkillProcessingException) {
+                throw await createAndLog(loggingBroker, new RegistrySkillProcessingValidationException("Registry skill processing validation error occurred, fix the error and try again.", error));
+            }
+            if (error instanceof RegistrySkillValidationException ||
+                error instanceof RegistrySkillDependencyValidationException) {
+                throw await createAndLog(loggingBroker, new RegistrySkillProcessingDependencyValidationException("Registry skill processing dependency validation error occurred, fix the error and try again.", error.innerError));
+            }
+            if (error instanceof RegistrySkillDependencyException || error instanceof RegistrySkillServiceException) {
+                throw await createAndLog(loggingBroker, new RegistrySkillProcessingDependencyException("Registry skill processing dependency error occurred, contact support.", error.innerError));
+            }
+            const failed = new FailedRegistrySkillProcessingServiceException("Failed registry skill processing service error occurred, contact support.", error instanceof Error ? error : new Error(String(error)));
+            throw await createAndLog(loggingBroker, new RegistrySkillProcessingServiceException("Registry skill processing service error occurred, contact support.", failed));
+        }
+    };
+}
+async function createAndLog(loggingBroker, exception) {
+    await loggingBroker.logError(exception);
+    return exception;
+}
+//# sourceMappingURL=RegistrySkillProcessingService.Exceptions.js.map

package/dist/services/processings/registrySkills/RegistrySkillProcessingService.Exceptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RegistrySkillProcessingService.Exceptions.js","sourceRoot":"","sources":["../../../../src/services/processings/registrySkills/RegistrySkillProcessingService.Exceptions.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gCAAgC,EAAE,MAAM,2FAA2F,CAAC;AAC7I,OAAO,EAAE,0CAA0C,EAAE,MAAM,qGAAqG,CAAC;AACjK,OAAO,EAAE,6BAA6B,EAAE,MAAM,wFAAwF,CAAC;AACvI,OAAO,EAAE,gCAAgC,EAAE,MAAM,2FAA2F,CAAC;AAC7I,OAAO,EAAE,6CAA6C,EAAE,MAAM,wGAAwG,CAAC;AACvK,OAAO,EAAE,uCAAuC,EAAE,MAAM,kGAAkG,CAAC;AAC3J,OAAO,EAAE,0CAA0C,EAAE,MAAM,qGAAqG,CAAC;AACjK,OAAO,EAAE,oDAAoD,EAAE,MAAM,+GAA+G,CAAC;AACrL,OAAO,EAAE,uCAAuC,EAAE,MAAM,kGAAkG,CAAC;AAC3J,OAAO,EAAE,0CAA0C,EAAE,MAAM,qGAAqG,CAAC;AAMjK,MAAM,UAAU,cAAc,CAAC,aAA4B;IACzD,OAAO,KAAK,UAAU,QAAQ,CAAI,OAAyB;QACzD,IAAI,CAAC;YACH,OAAO,MAAM,OAAO,EAAE,CAAC;QACzB,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,IAAI,KAAK,YAAY,uCAAuC,EAAE,CAAC;gBAC7D,MAAM,MAAM,YAAY,CACtB,aAAa,EACb,IAAI,0CAA0C,CAC5C,mFAAmF,EACnF,KAAK,CACN,CACF,CAAC;YACJ,CAAC;YAED,IACE,KAAK,YAAY,gCAAgC;gBACjD,KAAK,YAAY,0CAA0C,EAC3D,CAAC;gBACD,MAAM,MAAM,YAAY,CACtB,aAAa,EACb,IAAI,oDAAoD,CACtD,8FAA8F,EAC9F,KAAK,CAAC,UAAU,CACjB,CACF,CAAC;YACJ,CAAC;YAED,IAAI,KAAK,YAAY,gCAAgC,IAAI,KAAK,YAAY,6BAA6B,EAAE,CAAC;gBACxG,MAAM,MAAM,YAAY,CACtB,aAAa,EACb,IAAI,0CAA0C,CAC5C,uEAAuE,EACvE,KAAK,CAAC,UAAU,CACjB,CACF,CAAC;YACJ,CAAC;YAED,MAAM,MAAM,GAAG,IAAI,6CAA6C,CAC9D,2EAA2E,EAC3E,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAC1D,CAAC;YAEF,MAAM,MAAM,YAAY,CACtB,aAAa,EACb,IAAI,uCAAuC,CACzC,oEAAoE,EACpE,MAAM,CACP,CACF,CAAC;QACJ,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,YAAY,CAAkB,aAA4B,EAAE,SAAY;IACrF,MAAM,aAAa,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IAExC,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/services/processings/registrySkills/RegistrySkillProcessingService.d.ts

@@ -0,0 +1,16 @@
+import type { FileBroker, LoggingBroker } from "@hassanhabib/standard-agents";
+import type { RegistrySkill } from "../../../models/brokers/registries/RegistrySkill.js";
+import type { InstalledSkill } from "../../../models/processings/registrySkills/InstalledSkill.js";
+import type { RegistrySkillService } from "../../foundations/registrySkills/RegistrySkillService.js";
+export declare class RegistrySkillProcessingService {
+    private readonly registrySkillService;
+    private readonly fileBroker;
+    private readonly loggingBroker;
+    private readonly tryCatch;
+    constructor(registrySkillService: RegistrySkillService, fileBroker: FileBroker, loggingBroker: LoggingBroker);
+    retrieveOffered(query: string): Promise<readonly RegistrySkill[]>;
+    installSkill(skillsRoot: string, id: string): Promise<InstalledSkill>;
+    retrieveInstalled(skillsRoot: string): Promise<readonly InstalledSkill[]>;
+    private namesIn;
+}
+//# sourceMappingURL=RegistrySkillProcessingService.d.ts.map

package/dist/services/processings/registrySkills/RegistrySkillProcessingService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RegistrySkillProcessingService.d.ts","sourceRoot":"","sources":["../../../../src/services/processings/registrySkills/RegistrySkillProcessingService.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAE9E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qDAAqD,CAAC;AACzF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8DAA8D,CAAC;AACnG,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0DAA0D,CAAC;AASrG,qBAAa,8BAA8B;IACzC,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAuB;IAC5D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;IACxC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;IAC9C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAW;gBAGlC,oBAAoB,EAAE,oBAAoB,EAC1C,UAAU,EAAE,UAAU,EACtB,aAAa,EAAE,aAAa;IAQvB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,aAAa,EAAE,CAAC;IAOjE,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAkBrE,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,cAAc,EAAE,CAAC;YAuBlE,OAAO;CAOtB"}

package/dist/services/processings/registrySkills/RegistrySkillProcessingService.js

@@ -0,0 +1,67 @@
+import { createTryCatch } from "./RegistrySkillProcessingService.Exceptions.js";
+// Higher order over the registry (PLAN.md 2.8): a skill fetched and a skill on disk are two acts
+// that are only useful together.
+//
+// Where a skill goes is decided here rather than by the registry or by the door: one folder per
+// owner and one per skill inside it, so two people may publish `code-review` and a machine may hold
+// both.
+export class RegistrySkillProcessingService {
+    registrySkillService;
+    fileBroker;
+    loggingBroker;
+    tryCatch;
+    constructor(registrySkillService, fileBroker, loggingBroker) {
+        this.registrySkillService = registrySkillService;
+        this.fileBroker = fileBroker;
+        this.loggingBroker = loggingBroker;
+        this.tryCatch = createTryCatch(this.loggingBroker);
+    }
+    retrieveOffered(query) {
+        return this.tryCatch(async () => await this.registrySkillService.retrieveSkills(query));
+    }
+    // Fetched, then written. The foundation has already refused anything that is not a skill or that
+    // names a file outside its own folder, which is why this can write what it was handed without
+    // looking at the paths again.
+    installSkill(skillsRoot, id) {
+        return this.tryCatch(async () => {
+            const skill = await this.registrySkillService.retrieveSkill(id);
+            const folder = folderOf(skillsRoot, skill.owner, skill.name);
+            for (const file of skill.files) {
+                await this.fileBroker.writeFileAtomic(`${folder}/${file.path}`, file.content);
+            }
+            await this.loggingBroker.logInformation(`installed '${skill.name}' from ${skill.owner} into ${folder}`);
+            return { id: skill.id, owner: skill.owner, name: skill.name, version: skill.version, folder };
+        });
+    }
+    // What this machine holds, read off the disk rather than from a list it keeps beside it. A
+    // manifest of installed skills would be a second answer to "what is installed", and the one that
+    // is wrong is always the one nobody updated.
+    retrieveInstalled(skillsRoot) {
+        return this.tryCatch(async () => {
+            const installed = [];
+            for (const owner of await this.namesIn(skillsRoot)) {
+                for (const name of await this.namesIn(`${skillsRoot}/${owner}`)) {
+                    const folder = `${skillsRoot}/${owner}/${name}`;
+                    // A folder with no SKILL.md is not a skill, whatever put it there.
+                    if ((await this.fileBroker.stat(`${folder}/SKILL.md`)) === null) {
+                        continue;
+                    }
+                    installed.push({ id: "", owner, name, version: 0, folder });
+                }
+            }
+            return installed;
+        });
+    }
+    // A directory that is not there holds nothing, which is the ordinary answer on a machine that has
+    // installed no skills yet.
+    async namesIn(path) {
+        if ((await this.fileBroker.stat(path)) === null) {
+            return [];
+        }
+        return await this.fileBroker.readdir(path);
+    }
+}
+function folderOf(skillsRoot, owner, name) {
+    return `${skillsRoot}/${owner}/${name}`;
+}
+//# sourceMappingURL=RegistrySkillProcessingService.js.map

package/dist/services/processings/registrySkills/RegistrySkillProcessingService.js.map

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

package/dist/services/processings/secrets/SecretProcessingService.Exceptions.d.ts

@@ -0,0 +1,4 @@
+import type { LoggingBroker } from "@hassanhabib/standard-agents";
+export type TryCatch = <T>(routine: () => Promise<T>) => Promise<T>;
+export declare function createTryCatch(loggingBroker: LoggingBroker): TryCatch;
+//# sourceMappingURL=SecretProcessingService.Exceptions.d.ts.map

package/dist/services/processings/secrets/SecretProcessingService.Exceptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SecretProcessingService.Exceptions.d.ts","sourceRoot":"","sources":["../../../../src/services/processings/secrets/SecretProcessingService.Exceptions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAelE,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;AAEpE,wBAAgB,cAAc,CAAC,aAAa,EAAE,aAAa,GAAG,QAAQ,CAwDrE"}

package/dist/services/processings/secrets/SecretProcessingService.Exceptions.js

@@ -0,0 +1,38 @@
+import { SecretDependencyException } from "../../../models/foundations/secrets/exceptions/SecretDependencyException.js";
+import { SecretDependencyValidationException } from "../../../models/foundations/secrets/exceptions/SecretDependencyValidationException.js";
+import { SecretServiceException } from "../../../models/foundations/secrets/exceptions/SecretServiceException.js";
+import { SecretValidationException } from "../../../models/foundations/secrets/exceptions/SecretValidationException.js";
+import { FailedSecretProcessingServiceException } from "../../../models/processings/secrets/exceptions/FailedSecretProcessingServiceException.js";
+import { LockUnavailableSecretProcessingException } from "../../../models/processings/secrets/exceptions/LockUnavailableSecretProcessingException.js";
+import { SecretProcessingDependencyException } from "../../../models/processings/secrets/exceptions/SecretProcessingDependencyException.js";
+import { SecretProcessingDependencyValidationException } from "../../../models/processings/secrets/exceptions/SecretProcessingDependencyValidationException.js";
+import { SecretProcessingServiceException } from "../../../models/processings/secrets/exceptions/SecretProcessingServiceException.js";
+import { SecretProcessingValidationException } from "../../../models/processings/secrets/exceptions/SecretProcessingValidationException.js";
+export function createTryCatch(loggingBroker) {
+    return async function tryCatch(routine) {
+        try {
+            return await routine();
+        }
+        catch (error) {
+            if (error instanceof LockUnavailableSecretProcessingException) {
+                throw await createAndLog(loggingBroker, new SecretProcessingDependencyValidationException("Secret processing dependency validation error occurred, fix the error and try again.", error));
+            }
+            if (error instanceof SecretValidationException) {
+                throw await createAndLog(loggingBroker, new SecretProcessingValidationException("Secret processing validation error occurred, fix the error and try again.", error.innerError));
+            }
+            if (error instanceof SecretDependencyValidationException) {
+                throw await createAndLog(loggingBroker, new SecretProcessingDependencyValidationException("Secret processing dependency validation error occurred, fix the error and try again.", error.innerError));
+            }
+            if (error instanceof SecretDependencyException || error instanceof SecretServiceException) {
+                throw await createAndLog(loggingBroker, new SecretProcessingDependencyException("Secret processing dependency error occurred, contact support.", error.innerError));
+            }
+            const failed = new FailedSecretProcessingServiceException("Failed secret processing service error occurred, contact support.", error instanceof Error ? error : new Error(String(error)));
+            throw await createAndLog(loggingBroker, new SecretProcessingServiceException("Secret processing service error occurred, contact support.", failed));
+        }
+    };
+}
+async function createAndLog(loggingBroker, exception) {
+    await loggingBroker.logError(exception);
+    return exception;
+}
+//# sourceMappingURL=SecretProcessingService.Exceptions.js.map

package/dist/services/processings/secrets/SecretProcessingService.Exceptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SecretProcessingService.Exceptions.js","sourceRoot":"","sources":["../../../../src/services/processings/secrets/SecretProcessingService.Exceptions.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,yBAAyB,EAAE,MAAM,6EAA6E,CAAC;AACxH,OAAO,EAAE,mCAAmC,EAAE,MAAM,uFAAuF,CAAC;AAC5I,OAAO,EAAE,sBAAsB,EAAE,MAAM,0EAA0E,CAAC;AAClH,OAAO,EAAE,yBAAyB,EAAE,MAAM,6EAA6E,CAAC;AACxH,OAAO,EAAE,sCAAsC,EAAE,MAAM,0FAA0F,CAAC;AAClJ,OAAO,EAAE,wCAAwC,EAAE,MAAM,4FAA4F,CAAC;AACtJ,OAAO,EAAE,mCAAmC,EAAE,MAAM,uFAAuF,CAAC;AAC5I,OAAO,EAAE,6CAA6C,EAAE,MAAM,iGAAiG,CAAC;AAChK,OAAO,EAAE,gCAAgC,EAAE,MAAM,oFAAoF,CAAC;AACtI,OAAO,EAAE,mCAAmC,EAAE,MAAM,uFAAuF,CAAC;AAM5I,MAAM,UAAU,cAAc,CAAC,aAA4B;IACzD,OAAO,KAAK,UAAU,QAAQ,CAAI,OAAyB;QACzD,IAAI,CAAC;YACH,OAAO,MAAM,OAAO,EAAE,CAAC;QACzB,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,IAAI,KAAK,YAAY,wCAAwC,EAAE,CAAC;gBAC9D,MAAM,MAAM,YAAY,CACtB,aAAa,EACb,IAAI,6CAA6C,CAC/C,sFAAsF,EACtF,KAAK,CACN,CACF,CAAC;YACJ,CAAC;YAED,IAAI,KAAK,YAAY,yBAAyB,EAAE,CAAC;gBAC/C,MAAM,MAAM,YAAY,CACtB,aAAa,EACb,IAAI,mCAAmC,CACrC,2EAA2E,EAC3E,KAAK,CAAC,UAAU,CACjB,CACF,CAAC;YACJ,CAAC;YAED,IAAI,KAAK,YAAY,mCAAmC,EAAE,CAAC;gBACzD,MAAM,MAAM,YAAY,CACtB,aAAa,EACb,IAAI,6CAA6C,CAC/C,sFAAsF,EACtF,KAAK,CAAC,UAAU,CACjB,CACF,CAAC;YACJ,CAAC;YAED,IAAI,KAAK,YAAY,yBAAyB,IAAI,KAAK,YAAY,sBAAsB,EAAE,CAAC;gBAC1F,MAAM,MAAM,YAAY,CACtB,aAAa,EACb,IAAI,mCAAmC,CACrC,+DAA+D,EAC/D,KAAK,CAAC,UAAU,CACjB,CACF,CAAC;YACJ,CAAC;YAED,MAAM,MAAM,GAAG,IAAI,sCAAsC,CACvD,mEAAmE,EACnE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAC1D,CAAC;YAEF,MAAM,MAAM,YAAY,CACtB,aAAa,EACb,IAAI,gCAAgC,CAAC,4DAA4D,EAAE,MAAM,CAAC,CAC3G,CAAC;QACJ,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,YAAY,CAAkB,aAA4B,EAAE,SAAY;IACrF,MAAM,aAAa,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IAExC,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/services/processings/secrets/SecretProcessingService.d.ts

@@ -0,0 +1,25 @@
+import type { LoggingBroker, TimeBroker } from "@hassanhabib/standard-agents";
+import { type HealthCheck } from "../../../models/processings/health/HealthCheck.js";
+import type { SecretService } from "../../foundations/secrets/SecretService.js";
+export declare const LOCK_RETRY_MILLISECONDS = 50;
+export declare const LOCK_WAIT_MILLISECONDS = 5000;
+export declare function apiKeyName(profileId: string): string;
+export declare function refreshTokenName(profileId: string): string;
+export declare class SecretProcessingService {
+    private readonly secretService;
+    private readonly loggingBroker;
+    private readonly timeBroker;
+    private readonly retryMilliseconds;
+    private readonly waitMilliseconds;
+    private readonly tryCatch;
+    constructor(secretService: SecretService, loggingBroker: LoggingBroker, timeBroker: TimeBroker, retryMilliseconds?: number, waitMilliseconds?: number);
+    retrieveApiKey(profileId: string): Promise<string | null>;
+    retrieveRefreshToken(profileId: string): Promise<string | null>;
+    verifyStore(profileId: string): Promise<HealthCheck>;
+    upsertApiKey(profileId: string, key: string): Promise<void>;
+    upsertRefreshToken(profileId: string, refreshToken: string): Promise<void>;
+    forgetSecrets(profileId: string): Promise<void>;
+    private takeLock;
+    private attemptLock;
+}
+//# sourceMappingURL=SecretProcessingService.d.ts.map

package/dist/services/processings/secrets/SecretProcessingService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SecretProcessingService.d.ts","sourceRoot":"","sources":["../../../../src/services/processings/secrets/SecretProcessingService.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAM9E,OAAO,EAAqC,KAAK,WAAW,EAAE,MAAM,mDAAmD,CAAC;AACxH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4CAA4C,CAAC;AAQhF,eAAO,MAAM,uBAAuB,KAAK,CAAC;AAE1C,eAAO,MAAM,sBAAsB,OAAQ,CAAC;AAE5C,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEpD;AAQD,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED,qBAAa,uBAAuB;IAClC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;IAC9C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;IAC9C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;IACxC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAW;gBAGlC,aAAa,EAAE,aAAa,EAC5B,aAAa,EAAE,aAAa,EAC5B,UAAU,EAAE,UAAU,EACtB,iBAAiB,SAA0B,EAC3C,gBAAgB,SAAyB;IAYpC,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAkBzD,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAe/D,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IA2BpD,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgB3D,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAc1E,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAexC,QAAQ;YAmBR,WAAW;CAa1B"}