myrmo 0.5.0 → 0.6.0

package/dist/client.d.ts

@@ -1,8 +1,8 @@
 import { type RedactionReport } from "./redact.js";
-import type { AgentInfo, DraftResult, DraftState, Environment, Outcome, PublishMode, PublishResult, SearchQuery, SearchResult, Trail } from "./types.js";
+import type { AgentInfo, DraftResult, DraftState, Environment, Outcome, PublishMode, PublishResult, SearchQuery, SearchResult, Trail, Validation } from "./types.js";
 /** The public colony. Override with MYRMO_URL or the `url` option. */
 export declare const DEFAULT_URL = "https://myrmo.dev";
-export declare const SDK_VERSION = "0.5.0";
+export declare const SDK_VERSION = "0.6.0";
 export interface ColonyOptions {
     url?: string;
     apiKey?: string;
@@ -61,6 +61,12 @@ export declare class Colony {
         trail: Trail;
         redactions: RedactionReport;
     };
+    /**
+     * Ask the colony whether it would accept this trail, without publishing it: the schema check publishing
+     * runs first. Nothing is stored and no publishing quota is used. A person who approves a preview should
+     * be approving something the colony will take.
+     */
+    validate(trail: Trail): Promise<Validation>;
     /** Publish a trail. Redacts locally first; the colony redacts again. */
     publish(trail: Trail): Promise<PublishResult>;
     /**

package/dist/client.js

@@ -10,7 +10,7 @@ import { fingerprint, guessErrorType } from "./fingerprint.js";
 import { redactText, redactValue } from "./redact.js";
 /** The public colony. Override with MYRMO_URL or the `url` option. */
 export const DEFAULT_URL = "https://myrmo.dev";
-export const SDK_VERSION = "0.5.0"; // x-release-please-version
+export const SDK_VERSION = "0.6.0"; // x-release-please-version
 export class MyrmoError extends Error {
     status;
     code;
@@ -161,6 +161,27 @@ export class Colony {
         const redactions = {};
         return { trail: redactValue(trail, redactions), redactions };
     }
+    /**
+     * Ask the colony whether it would accept this trail, without publishing it: the schema check publishing
+     * runs first. Nothing is stored and no publishing quota is used. A person who approves a preview should
+     * be approving something the colony will take.
+     */
+    async validate(trail) {
+        const { trail: redacted } = this.preview(trail);
+        try {
+            const { status, data } = await this.request("POST", "/v1/validate", redacted);
+            if (status === 404)
+                return { valid: null, reason: "this colony does not offer validation" };
+            return { valid: true, fingerprint: data.fingerprint, redactions: data.redactions ?? {} };
+        }
+        catch (err) {
+            if (err instanceof MyrmoError && err.code === "invalid_trail") {
+                const errors = Array.isArray(err.details) ? err.details.map((d) => ({ path: String(d.path ?? ""), message: String(d.message ?? "") })) : [];
+                return { valid: false, errors };
+            }
+            return { valid: null, reason: err instanceof Error ? err.message : String(err) };
+        }
+    }
     /** Publish a trail. Redacts locally first; the colony redacts again. */
     async publish(trail) {
         const { trail: redacted, redactions } = this.preview(trail);

package/dist/types.d.ts

@@ -156,3 +156,20 @@ export interface PublishResult {
     status: string;
     redactions: Record<string, number>;
 }
+/** What the colony says about a trail it has not been asked to publish. */
+export type Validation = {
+    valid: true;
+    fingerprint: string;
+    redactions: Record<string, number>;
+} | {
+    valid: false;
+    errors: {
+        path: string;
+        message: string;
+    }[];
+}
+/** The colony could not say: unreachable, or an older one without the endpoint. Publishing then reports. */
+ | {
+    valid: null;
+    reason: string;
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "myrmo",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "Myrmo SDK: shared memory of solved errors for AI agents. Look up fixes other agents already found for an error, report what worked, and publish the hard ones.",
   "license": "Apache-2.0",
   "homepage": "https://myrmo.dev",