@peerllm/client-core 0.1.0

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

@@ -0,0 +1,180 @@
+import { LockedSecretException } from "../../../models/foundations/secrets/exceptions/LockedSecretException.js";
+import { SecretDependencyValidationException } from "../../../models/foundations/secrets/exceptions/SecretDependencyValidationException.js";
+import { NotFoundSecretException } from "../../../models/foundations/secrets/exceptions/NotFoundSecretException.js";
+import { LockUnavailableSecretProcessingException } from "../../../models/processings/secrets/exceptions/LockUnavailableSecretProcessingException.js";
+import { healthy, innermostMessage, unwell } from "../../../models/processings/health/HealthCheck.js";
+import { createTryCatch } from "./SecretProcessingService.Exceptions.js";
+// What a secret is called, and writing one without losing another (SPEC.md 14.4).
+//
+// A key is bound to one profile and is never sent to another profile's host, which is a property of
+// the name rather than of anything that checks later: `api-key:<profileId>` cannot be read for a
+// different profile because it is not that profile's name.
+export const LOCK_RETRY_MILLISECONDS = 50;
+export const LOCK_WAIT_MILLISECONDS = 5_000;
+export function apiKeyName(profileId) {
+    return `api-key:${profileId}`;
+}
+// The other thing worth keeping per profile. The access token a login answers with is dead within
+// the hour and is never written down; the refresh token is what buys another one, which is what
+// lets `peerllm logout` end a session started days ago.
+//
+// A separate name rather than a field beside the key, for the same reason the key has one: a name
+// that belongs to one profile cannot be read for another.
+export function refreshTokenName(profileId) {
+    return `refresh-token:${profileId}`;
+}
+export class SecretProcessingService {
+    secretService;
+    loggingBroker;
+    timeBroker;
+    retryMilliseconds;
+    waitMilliseconds;
+    tryCatch;
+    constructor(secretService, loggingBroker, timeBroker, retryMilliseconds = LOCK_RETRY_MILLISECONDS, waitMilliseconds = LOCK_WAIT_MILLISECONDS) {
+        this.secretService = secretService;
+        this.loggingBroker = loggingBroker;
+        this.timeBroker = timeBroker;
+        this.retryMilliseconds = retryMilliseconds;
+        this.waitMilliseconds = waitMilliseconds;
+        this.tryCatch = createTryCatch(this.loggingBroker);
+    }
+    // A read needs no lock. The store is written whole through a rename, so a reader either sees the
+    // document before the write or the one after it, and never half of either.
+    retrieveApiKey(profileId) {
+        return this.tryCatch(async () => {
+            try {
+                return await this.secretService.retrieveSecret(apiKeyName(profileId));
+            }
+            catch (error) {
+                // No store at all is the same answer as no key for this profile: nobody has signed in.
+                if (error instanceof SecretDependencyValidationException && error.innerError instanceof NotFoundSecretException) {
+                    return null;
+                }
+                throw error;
+            }
+        });
+    }
+    // The same read, for the token that outlives the login. Absent is an answer: it means this
+    // profile's key was typed in rather than signed in for, which is the ordinary case for anybody
+    // who ran `peerllm init --key`.
+    retrieveRefreshToken(profileId) {
+        return this.tryCatch(async () => {
+            try {
+                return await this.secretService.retrieveSecret(refreshTokenName(profileId));
+            }
+            catch (error) {
+                if (error instanceof SecretDependencyValidationException && error.innerError instanceof NotFoundSecretException) {
+                    return null;
+                }
+                throw error;
+            }
+        });
+    }
+    // Whether this machine holds a key for the profile a run would use (PLAN.md 2.7).
+    verifyStore(profileId) {
+        return this.tryCatch(async () => {
+            // Nothing is active, so there is nothing to look for. Asking about the key for a profile named
+            // by the empty string produces a sentence with a hole in it, and a person reading four lines
+            // of report should not have to work out that the hole is the point.
+            if (profileId.trim().length === 0) {
+                return unwell(NAME, "no profile is active, so there is no key to look for.");
+            }
+            try {
+                const key = await this.retrieveApiKey(profileId);
+                if (key === null) {
+                    return unwell(NAME, `no key is stored for '${profileId}'. Run peerllm init --key <key> to store one.`);
+                }
+                // What is there, never what it is. A report a person pastes into an issue must not be a report
+                // that hands their key to whoever reads it.
+                return healthy(NAME, `a key is stored for '${profileId}'`);
+            }
+            catch (error) {
+                return unwell(NAME, `the key store could not be read: ${innermostMessage(error)}`);
+            }
+        });
+    }
+    // Taken under the lock, because writing one secret rewrites the whole store and the desktop may
+    // be doing the same thing at the same moment.
+    upsertApiKey(profileId, key) {
+        return this.tryCatch(async () => {
+            await this.takeLock();
+            try {
+                await this.secretService.modifySecret(apiKeyName(profileId), key);
+            }
+            finally {
+                // Released whatever happened. A lock left behind by a write that threw is a lock the next
+                // writer waits five seconds for.
+                await this.secretService.releaseLock();
+            }
+        });
+    }
+    // Under the same lock as the key, because both live in one document and writing either one
+    // rewrites the whole of it.
+    upsertRefreshToken(profileId, refreshToken) {
+        return this.tryCatch(async () => {
+            await this.takeLock();
+            try {
+                await this.secretService.modifySecret(refreshTokenName(profileId), refreshToken);
+            }
+            finally {
+                await this.secretService.releaseLock();
+            }
+        });
+    }
+    // Forgetting both, under the same lock, because signing out is one act. A machine that forgot
+    // its key and kept its refresh token would be a machine that cannot run and can still be spent.
+    forgetSecrets(profileId) {
+        return this.tryCatch(async () => {
+            await this.takeLock();
+            try {
+                await this.secretService.removeSecret(apiKeyName(profileId));
+                await this.secretService.removeSecret(refreshTokenName(profileId));
+            }
+            finally {
+                await this.secretService.releaseLock();
+            }
+        });
+    }
+    // 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() {
+        const until = this.timeBroker.getCurrentDateTime().getTime() + this.waitMilliseconds;
+        for (;;) {
+            if (await this.attemptLock()) {
+                return;
+            }
+            if (this.timeBroker.getCurrentDateTime().getTime() >= until) {
+                throw new LockUnavailableSecretProcessingException("could not write the secret: the store is locked and did not come free", new Error("the secrets lock was held for the whole wait"));
+            }
+            await pause(this.retryMilliseconds);
+        }
+    }
+    async attemptLock() {
+        try {
+            await this.secretService.acquireLock(holderOf());
+            return true;
+        }
+        catch (error) {
+            if (!isHeld(error)) {
+                throw error;
+            }
+            return false;
+        }
+    }
+}
+function holderOf() {
+    return JSON.stringify({ pid: process.pid, takenOn: new Date().toISOString() });
+}
+// Held is the foundation's dependency-validation answer carrying a LockedSecretException. Anything
+// else that went wrong is not a reason to keep asking.
+function isHeld(error) {
+    return error instanceof SecretDependencyValidationException && error.innerError instanceof LockedSecretException;
+}
+function pause(milliseconds) {
+    return new Promise((resolve) => {
+        setTimeout(resolve, milliseconds);
+    });
+}
+// What this check is called on the report. One word, so the four of them line up.
+const NAME = "keys";
+//# sourceMappingURL=SecretProcessingService.js.map

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

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

package/dist/services/processings/workspaceFiles/Globs.d.ts

@@ -0,0 +1,2 @@
+export declare function matchesGlob(relativePath: string, pattern: string): boolean;
+//# sourceMappingURL=Globs.d.ts.map

package/dist/services/processings/workspaceFiles/Globs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Globs.d.ts","sourceRoot":"","sources":["../../../../src/services/processings/workspaceFiles/Globs.ts"],"names":[],"mappings":"AAKA,wBAAgB,WAAW,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAE1E"}

package/dist/services/processings/workspaceFiles/Globs.js

@@ -0,0 +1,18 @@
+import { toExpression } from "./IgnoreRules.js";
+// A glob over the workspace's relative paths (SPEC.md 7.2). The wildcards are the ignore reader's,
+// because a search and a hiding rule that disagree about what a star means is a workspace nobody
+// can reason about.
+export function matchesGlob(relativePath, pattern) {
+    return toGlobPattern(pattern).test(relativePath);
+}
+// A pattern is anchored at both ends, because a glob names what a path is and not what it
+// contains. The one exception is `**/`, which stands for any number of directories including
+// none, so `**/*.ts` finds a file at the root as well as one ten levels down.
+function toGlobPattern(pattern) {
+    const source = pattern
+        .split("**/")
+        .map((part) => toExpression(part))
+        .join("(?:.*/)?");
+    return new RegExp(`^${source}$`);
+}
+//# sourceMappingURL=Globs.js.map

package/dist/services/processings/workspaceFiles/Globs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Globs.js","sourceRoot":"","sources":["../../../../src/services/processings/workspaceFiles/Globs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEhD,mGAAmG;AACnG,iGAAiG;AACjG,oBAAoB;AACpB,MAAM,UAAU,WAAW,CAAC,YAAoB,EAAE,OAAe;IAC/D,OAAO,aAAa,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;AACnD,CAAC;AAED,0FAA0F;AAC1F,6FAA6F;AAC7F,8EAA8E;AAC9E,SAAS,aAAa,CAAC,OAAe;IACpC,MAAM,MAAM,GAAG,OAAO;SACnB,KAAK,CAAC,KAAK,CAAC;SACZ,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;SACjC,IAAI,CAAC,UAAU,CAAC,CAAC;IAEpB,OAAO,IAAI,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,CAAC;AACnC,CAAC"}

package/dist/services/processings/workspaceFiles/IgnoreRules.d.ts

@@ -0,0 +1,9 @@
+export interface IgnoreRule {
+    readonly pattern: RegExp;
+    readonly directoryOnly: boolean;
+    readonly negated: boolean;
+}
+export declare function readIgnoreRules(content: string): readonly IgnoreRule[];
+export declare function isIgnored(relativePath: string, isDirectory: boolean, rules: readonly IgnoreRule[]): boolean;
+export declare function toExpression(pattern: string): string;
+//# sourceMappingURL=IgnoreRules.d.ts.map

package/dist/services/processings/workspaceFiles/IgnoreRules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IgnoreRules.d.ts","sourceRoot":"","sources":["../../../../src/services/processings/workspaceFiles/IgnoreRules.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,UAAU,EAAE,CAuBtE;AAID,wBAAgB,SAAS,CAAC,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,UAAU,EAAE,GAAG,OAAO,CAc3G;AAYD,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CA2BpD"}

package/dist/services/processings/workspaceFiles/IgnoreRules.js

@@ -0,0 +1,72 @@
+// What a workspace has asked not to be shown (SPEC.md 6.1). A first grep in a Node repository
+// that returns thirty kilobytes of dependencies is a grep that told the model nothing and cost a
+// fortune, so the listing walks honour the same files a developer already keeps.
+//
+// This reads the common subset of the gitignore format and says so: blank lines and comments, a
+// leading slash to anchor, a trailing slash for directories only, a leading bang to bring
+// something back, and the wildcards. What it does not do is the exotic corners of the format, and
+// a pattern it cannot read is skipped rather than guessed at, because guessing at an ignore rule
+// either hides something the user wanted or shows something they did not.
+export function readIgnoreRules(content) {
+    const rules = [];
+    for (const rawLine of content.split("\n")) {
+        const line = rawLine.trim();
+        if (line.length === 0 || line.startsWith("#")) {
+            continue;
+        }
+        const negated = line.startsWith("!");
+        const withoutBang = negated ? line.slice(1) : line;
+        const directoryOnly = withoutBang.endsWith("/");
+        const withoutSlash = directoryOnly ? withoutBang.slice(0, -1) : withoutBang;
+        if (withoutSlash.length === 0) {
+            continue;
+        }
+        rules.push({ pattern: toPattern(withoutSlash), directoryOnly, negated });
+    }
+    return rules;
+}
+// The last rule that matches wins, which is what makes a bang mean "except this" rather than
+// "never mind all of it".
+export function isIgnored(relativePath, isDirectory, rules) {
+    let ignored = false;
+    for (const rule of rules) {
+        if (rule.directoryOnly && !isDirectory) {
+            continue;
+        }
+        if (rule.pattern.test(relativePath)) {
+            ignored = !rule.negated;
+        }
+    }
+    return ignored;
+}
+// A pattern anchored with a leading slash matches from the workspace root; one without matches at
+// any depth, which is what makes `node_modules` hide every one of them rather than only the top.
+function toPattern(pattern) {
+    const anchored = pattern.startsWith("/");
+    const body = anchored ? pattern.slice(1) : pattern;
+    const source = `${anchored ? "^" : "^(?:.*/)?"}${toExpression(body)}(?:/.*)?$`;
+    return new RegExp(source);
+}
+export function toExpression(pattern) {
+    let expression = "";
+    for (let index = 0; index < pattern.length; index += 1) {
+        const character = pattern[index] ?? "";
+        if (character === "*") {
+            // Two stars cross directories; one stays inside a segment.
+            if (pattern[index + 1] === "*") {
+                expression += ".*";
+                index += 1;
+                continue;
+            }
+            expression += "[^/]*";
+            continue;
+        }
+        if (character === "?") {
+            expression += "[^/]";
+            continue;
+        }
+        expression += character.replace(/[.+^${}()|[\]\\]/g, (matched) => `\\${matched}`);
+    }
+    return expression;
+}
+//# sourceMappingURL=IgnoreRules.js.map

package/dist/services/processings/workspaceFiles/IgnoreRules.js.map

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

package/dist/services/processings/workspaceFiles/WorkspaceFileProcessingService.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=WorkspaceFileProcessingService.Exceptions.d.ts.map

package/dist/services/processings/workspaceFiles/WorkspaceFileProcessingService.Exceptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkspaceFileProcessingService.Exceptions.d.ts","sourceRoot":"","sources":["../../../../src/services/processings/workspaceFiles/WorkspaceFileProcessingService.Exceptions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAgBlE,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,CAiDrE"}

package/dist/services/processings/workspaceFiles/WorkspaceFileProcessingService.Exceptions.js

@@ -0,0 +1,34 @@
+import { WorkspaceFileDependencyException } from "../../../models/foundations/workspaceFiles/exceptions/WorkspaceFileDependencyException.js";
+import { WorkspaceFileServiceException } from "../../../models/foundations/workspaceFiles/exceptions/WorkspaceFileServiceException.js";
+import { WorkspaceFileValidationException } from "../../../models/foundations/workspaceFiles/exceptions/WorkspaceFileValidationException.js";
+import { FailedWorkspaceFileProcessingServiceException } from "../../../models/processings/workspaceFiles/exceptions/FailedWorkspaceFileProcessingServiceException.js";
+import { InvalidWorkspaceFileProcessingException } from "../../../models/processings/workspaceFiles/exceptions/InvalidWorkspaceFileProcessingException.js";
+import { WorkspaceFileProcessingDependencyException } from "../../../models/processings/workspaceFiles/exceptions/WorkspaceFileProcessingDependencyException.js";
+import { WorkspaceFileProcessingDependencyValidationException } from "../../../models/processings/workspaceFiles/exceptions/WorkspaceFileProcessingDependencyValidationException.js";
+import { WorkspaceFileProcessingServiceException } from "../../../models/processings/workspaceFiles/exceptions/WorkspaceFileProcessingServiceException.js";
+import { WorkspaceFileProcessingValidationException } from "../../../models/processings/workspaceFiles/exceptions/WorkspaceFileProcessingValidationException.js";
+export function createTryCatch(loggingBroker) {
+    return async function tryCatch(routine) {
+        try {
+            return await routine();
+        }
+        catch (error) {
+            if (error instanceof InvalidWorkspaceFileProcessingException) {
+                throw await createAndLog(loggingBroker, new WorkspaceFileProcessingValidationException("Workspace file processing validation error occurred, fix the error and try again.", error));
+            }
+            if (error instanceof WorkspaceFileValidationException) {
+                throw await createAndLog(loggingBroker, new WorkspaceFileProcessingDependencyValidationException("Workspace file processing dependency validation error occurred, fix the error and try again.", error.innerError));
+            }
+            if (error instanceof WorkspaceFileDependencyException || error instanceof WorkspaceFileServiceException) {
+                throw await createAndLog(loggingBroker, new WorkspaceFileProcessingDependencyException("Workspace file processing dependency error occurred, contact support.", error.innerError));
+            }
+            const failedWorkspaceFileProcessingServiceException = new FailedWorkspaceFileProcessingServiceException("Failed workspace file processing service error occurred, contact support.", error instanceof Error ? error : new Error(String(error)));
+            throw await createAndLog(loggingBroker, new WorkspaceFileProcessingServiceException("Workspace file processing service error occurred, contact support.", failedWorkspaceFileProcessingServiceException));
+        }
+    };
+}
+async function createAndLog(loggingBroker, exception) {
+    await loggingBroker.logError(exception);
+    return exception;
+}
+//# sourceMappingURL=WorkspaceFileProcessingService.Exceptions.js.map

package/dist/services/processings/workspaceFiles/WorkspaceFileProcessingService.Exceptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkspaceFileProcessingService.Exceptions.js","sourceRoot":"","sources":["../../../../src/services/processings/workspaceFiles/WorkspaceFileProcessingService.Exceptions.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gCAAgC,EAAE,MAAM,2FAA2F,CAAC;AAC7I,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;AAQjK,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,IAAI,KAAK,YAAY,gCAAgC,EAAE,CAAC;gBACtD,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,6CAA6C,GAAG,IAAI,6CAA6C,CACrG,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,6CAA6C,CAC9C,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/workspaceFiles/WorkspaceFileProcessingService.Validations.d.ts

@@ -0,0 +1,9 @@
+export declare function validateRange(offset: number, limit: number): void;
+export declare function validateAnchorFound(first: number, anchor: string, path: string): void;
+export declare function validateAnchorIsAlone(second: number, anchor: string, path: string): void;
+export declare function validateAnchor(anchor: string, path: string): void;
+export declare function validateReplacement(replacement: string, path: string): void;
+export declare function validateNewContent(content: string, path: string): void;
+export declare function validateWasRead(hasRead: boolean, path: string): void;
+export declare function validateWholeWasRead(sawWholeFile: boolean, path: string, totalLines: number): void;
+//# sourceMappingURL=WorkspaceFileProcessingService.Validations.d.ts.map

package/dist/services/processings/workspaceFiles/WorkspaceFileProcessingService.Validations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkspaceFileProcessingService.Validations.d.ts","sourceRoot":"","sources":["../../../../src/services/processings/workspaceFiles/WorkspaceFileProcessingService.Validations.ts"],"names":[],"mappings":"AAKA,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAYjE;AAID,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAMrF;AAWD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAMxF;AASD,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAQjE;AAED,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAE3E;AAYD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAEtE;AASD,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAOpE;AAID,wBAAgB,oBAAoB,CAAC,YAAY,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAMlG"}

package/dist/services/processings/workspaceFiles/WorkspaceFileProcessingService.Validations.js

@@ -0,0 +1,76 @@
+import { InvalidWorkspaceFileProcessingException } from "../../../models/processings/workspaceFiles/exceptions/InvalidWorkspaceFileProcessingException.js";
+// Lines are counted from one, the way an editor and a stack trace both count them, so a zero or a
+// negative offset is a caller who thinks they are counting from somewhere else and would read the
+// wrong part of the file without ever being told.
+export function validateRange(offset, limit) {
+    if (!Number.isInteger(offset) || offset < 1) {
+        throw new InvalidWorkspaceFileProcessingException(`could not read: the first line must be 1 or greater, not ${offset}`);
+    }
+    if (!Number.isInteger(limit) || limit < 0) {
+        throw new InvalidWorkspaceFileProcessingException(`could not read: the line count must be 0 or greater, not ${limit}`);
+    }
+}
+// An anchor nobody can find is a model editing a file it remembers rather than the file that is
+// there. The refusal names the anchor, because the next thing the model must do is read again.
+export function validateAnchorFound(first, anchor, path) {
+    if (first === -1) {
+        throw new InvalidWorkspaceFileProcessingException(`could not apply: ${path} does not contain that anchor. Read the file again and anchor on what is there: ${summariseAnchor(anchor)}`);
+    }
+}
+function summariseAnchor(anchor) {
+    const firstLine = anchor.split("\n")[0] ?? "";
+    return firstLine.length > 80 ? `${firstLine.slice(0, 80)}...` : firstLine;
+}
+// Twice is a refusal, and no argument changes that. A model that says "replace both" is guessing
+// about a file it read some turns ago, and the edit that destroys work is always the one that
+// matched in a second place nobody looked at.
+export function validateAnchorIsAlone(second, anchor, path) {
+    if (second !== -1) {
+        throw new InvalidWorkspaceFileProcessingException(`could not apply: ${path} contains that anchor more than once. Extend it until it is unique: ${summariseAnchor(anchor)}`);
+    }
+}
+// What a model writes when it is summarising instead of editing. An anchor or a replacement
+// carrying one of these would delete the part it stands for, which is the single most expensive
+// mistake this tool can make.
+const PLACEHOLDER = /^\s*(?:\/\/|#|--|<!--)?\s*(?:\.\.\.|\u2026)(?!\s*\))/;
+const EXISTING_CODE = /existing code|rest of (?:the )?file|unchanged/i;
+export function validateAnchor(anchor, path) {
+    if (anchor.length === 0) {
+        throw new InvalidWorkspaceFileProcessingException(`could not apply: ${path} was given an empty anchor, which matches everywhere and means nothing`);
+    }
+    validateNoPlaceholder(anchor, path, "anchor");
+}
+export function validateReplacement(replacement, path) {
+    validateNoPlaceholder(replacement, path, "replacement");
+}
+function validateNoPlaceholder(text, path, part) {
+    for (const line of text.split("\n")) {
+        if (PLACEHOLDER.test(line) || EXISTING_CODE.test(line)) {
+            throw new InvalidWorkspaceFileProcessingException(`could not apply: the ${part} for ${path} carries a placeholder ('${line.trim()}'). Write the text out in full; a placeholder here deletes what it stands for`);
+        }
+    }
+}
+export function validateNewContent(content, path) {
+    validateNoPlaceholder(content, path, "content");
+}
+// A whole-file write replaces everything, including the parts of the file nobody looked at. A run
+// that has not read the file is a run writing back what it remembers, and what it remembers is
+// whatever the model made up for the lines it never saw.
+//
+// The refusal names the retry rather than only the reason. A model that had already written the
+// whole new file, was refused for not having read the old one, read it, and then did not call again:
+// told what it must do first, it was never told that the thing it was doing is still worth doing.
+export function validateWasRead(hasRead, path) {
+    if (!hasRead) {
+        throw new InvalidWorkspaceFileProcessingException(`could not write: this run has not read ${path}. ` +
+            `Call read_file on it, then call write_file again with the same content`);
+    }
+}
+// Having read some of it is not having read it. A file handed over one page at a time and then
+// written back whole is a file whose other pages the write deletes.
+export function validateWholeWasRead(sawWholeFile, path, totalLines) {
+    if (!sawWholeFile) {
+        throw new InvalidWorkspaceFileProcessingException(`could not write: this run has seen only part of ${path}, which is ${totalLines} lines. Read all of it, or change the part you have with single_find_and_replace`);
+    }
+}
+//# sourceMappingURL=WorkspaceFileProcessingService.Validations.js.map

package/dist/services/processings/workspaceFiles/WorkspaceFileProcessingService.Validations.js.map

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

package/dist/services/processings/workspaceFiles/WorkspaceFileProcessingService.d.ts

@@ -0,0 +1,59 @@
+import { type LoggingBroker } from "@hassanhabib/standard-agents";
+import type { WorkspaceEntry } from "../../../models/foundations/workspaceFiles/WorkspaceEntry.js";
+import type { AppliedEdit } from "../../../models/processings/workspaceFiles/AppliedEdit.js";
+import type { RestoredRun } from "../../../models/processings/workspaceFiles/RestoredRun.js";
+import type { GrepMatch } from "../../../models/processings/workspaceFiles/GrepMatch.js";
+import type { PagedFile } from "../../../models/processings/workspaceFiles/PagedFile.js";
+import { type HealthCheck } from "../../../models/processings/health/HealthCheck.js";
+import type { WorkspaceFileService } from "../../foundations/workspaceFiles/WorkspaceFileService.js";
+export declare const MAXIMUM_PAGE_BYTES = 16384;
+export declare const MAXIMUM_GLOB_MATCHES = 200;
+export declare const MAXIMUM_GREP_MATCHES = 100;
+export type FileChange = "created" | "rewritten" | "edited" | "deleted";
+export interface ChangedFile {
+    readonly path: string;
+    readonly change: FileChange;
+}
+export declare class WorkspaceFileProcessingService {
+    private readonly workspaceFileService;
+    private readonly loggingBroker;
+    private readonly workspaceRoot;
+    private readonly tryCatch;
+    private readonly readSet;
+    private readonly snapshots;
+    private readonly wrote;
+    private readonly changeSet;
+    private readonly onChanged;
+    constructor(workspaceFileService: WorkspaceFileService, loggingBroker: LoggingBroker, workspaceRoot: string, onChanged?: (changed: ChangedFile) => void);
+    retrieveFile(path: string, offset?: number, limit?: number): Promise<PagedFile>;
+    listDirectory(path: string): Promise<readonly WorkspaceEntry[]>;
+    glob(root: string, pattern: string): Promise<readonly string[]>;
+    grep(root: string, expression: string, contextLines?: number): Promise<readonly GrepMatch[]>;
+    private matchesIn;
+    private readOrSkip;
+    applyEdit(path: string, anchor: string, replacement: string): Promise<AppliedEdit>;
+    createFile(path: string, content: string): Promise<void>;
+    applyWrite(path: string, content: string): Promise<void>;
+    deletePath(path: string): Promise<void>;
+    private keepSnapshot;
+    private rememberWritten;
+    private writeManifest;
+    restoreRun(runId: string): Promise<RestoredRun>;
+    private changedSince;
+    private putBack;
+    private readManifest;
+    verifyWorkspace(): Promise<HealthCheck>;
+    private listing;
+    private collect;
+    private ignoreRules;
+    changesOf(runId: string): readonly ChangedFile[];
+    private recordChange;
+    readRangesOf(path: string): ReadonlyArray<{
+        firstLine: number;
+        lastLine: number;
+    }>;
+    private hasRead;
+    private forgetReads;
+    private rememberRead;
+}
+//# sourceMappingURL=WorkspaceFileProcessingService.d.ts.map

package/dist/services/processings/workspaceFiles/WorkspaceFileProcessingService.d.ts.map

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