myrmo 0.13.0 → 0.14.0

package/dist/client.d.ts

@@ -2,7 +2,7 @@ import { type RedactionReport } from "./redact.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.13.0";
+export declare const SDK_VERSION = "0.14.0";
 export interface ColonyOptions {
     url?: string;
     apiKey?: string;
@@ -105,4 +105,14 @@ export declare class Colony {
     }): Promise<Record<string, unknown> | null>;
     /** Status and content of one trail. */
     trail(trailId: string): Promise<Record<string, unknown> | null>;
+    /** One page of the colony's trails, most recently active first: `{ items, next_cursor }` (`GET /v1/feed`). */
+    feed(options?: {
+        limit?: number;
+        cursor?: string;
+    }): Promise<{
+        items: Record<string, unknown>[];
+        next_cursor?: string | null;
+    }>;
+    /** Every trail of the colony, page by page (an export or a backup of what the team learned). */
+    allTrails(): AsyncGenerator<Record<string, unknown>>;
 }

package/dist/client.js

@@ -11,7 +11,7 @@ import { namesConflict } from "./names.js";
 import { possibleNames, 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.13.0"; // x-release-please-version
+export const SDK_VERSION = "0.14.0"; // x-release-please-version
 /** What a colony that is restarting or overloaded answers with. */
 const UNAVAILABLE = new Set([502, 503, 504]);
 const DEFAULT_RETRY_DELAYS_MS = [500, 1500, 3000];
@@ -287,4 +287,21 @@ export class Colony {
         const { status, data } = await this.request("GET", `/v1/trails/${encodeURIComponent(trailId)}`, undefined, undefined, true);
         return status === 404 ? null : data;
     }
+    /** One page of the colony's trails, most recently active first: `{ items, next_cursor }` (`GET /v1/feed`). */
+    async feed(options = {}) {
+        const query = new URLSearchParams({ limit: String(Math.min(50, Math.max(1, options.limit ?? 50))) });
+        if (options.cursor)
+            query.set("cursor", options.cursor);
+        const { data } = await this.request("GET", `/v1/feed?${query}`, undefined, undefined, true);
+        return { items: Array.isArray(data?.items) ? data.items : [], next_cursor: data?.next_cursor ?? null };
+    }
+    /** Every trail of the colony, page by page (an export or a backup of what the team learned). */
+    async *allTrails() {
+        let cursor;
+        do {
+            const page = await this.feed({ cursor });
+            yield* page.items;
+            cursor = page.next_cursor ?? undefined;
+        } while (cursor);
+    }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "myrmo",
-  "version": "0.13.0",
+  "version": "0.14.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",