ashr-labs 0.4.3 → 0.6.0

package/dist/cli.js

@@ -439,7 +439,7 @@ async function main() {
         print(`  is auto-detected from your project.\n`);
         print(`  You can also set ASHR_LABS_API_KEY in your environment`);
         print(`  and run ${DIM}npx ashr-labs${RESET} with no arguments.\n`);
-        print(`  Get your key at ${BOLD}https://app.ashr.io → API Keys${RESET}\n`);
+        print(`  Get your key at ${BOLD}https://lab.ashr.io → API Keys${RESET}\n`);
         process.exit(0);
     }
     // Find the API key: first positional arg that starts with tp_, or env var
@@ -451,12 +451,12 @@ async function main() {
     if (!apiKey) {
         print(`\n${BOLD}${ASHR_BLUE}  ashr labs${RESET}\n`);
         print(`  Usage: ${BOLD}npx ashr-labs <api-key>${RESET}\n`);
-        print(`  Get your key at https://app.ashr.io → API Keys\n`);
+        print(`  Get your key at https://lab.ashr.io → API Keys\n`);
         process.exit(1);
     }
     if (!apiKey.startsWith("tp_")) {
         print(`\n${YELLOW}  Invalid API key — must start with tp_${RESET}`);
-        print(`  Get one at https://app.ashr.io → API Keys\n`);
+        print(`  Get one at https://lab.ashr.io → API Keys\n`);
         process.exit(1);
     }
     print("");

package/dist/client.d.ts

@@ -5,6 +5,7 @@ export declare class AshrLabsClient {
     private _tenantId;
     private _userId;
     private _session;
+    private _notes;
     constructor(apiKey: string, baseUrl?: string, timeout?: number);
     static fromEnv(timeout?: number): AshrLabsClient;
     private _ensureSession;
@@ -133,6 +134,18 @@ export declare class AshrLabsClient {
     listRequests(tenantId?: number | null, status?: string | null, limit?: number, cursor?: number | null): Promise<Record<string, unknown>>;
     listApiKeys(includeInactive?: boolean): Promise<Record<string, unknown>[]>;
     revokeApiKey(apiKeyId: number): Promise<Record<string, unknown>>;
+    /**
+     * Get cached SDK notes from the last init() or getNotes() call.
+     * Notes are platform advisories that may affect how you configure or run your agent.
+     */
+    get notes(): Record<string, unknown>[];
+    /**
+     * Fetch fresh SDK notes from the platform.
+     *
+     * @param agentId - Optional agent ID to also include agent-targeted notes.
+     * @returns List of active notes for your tenant.
+     */
+    getNotes(agentId?: number | null): Promise<Record<string, unknown>[]>;
     init(): Promise<Record<string, unknown>>;
     healthCheck(): Promise<Record<string, unknown>>;
     waitForRequest(requestId: number, timeout?: number, pollInterval?: number): Promise<Record<string, unknown>>;

package/dist/client.js

@@ -7,6 +7,7 @@ export class AshrLabsClient {
     _tenantId = null;
     _userId = null;
     _session = null;
+    _notes = [];
     constructor(apiKey, baseUrl = DEFAULT_BASE_URL, timeout = 30) {
         if (!apiKey || !apiKey.startsWith("tp_")) {
             throw new Error("Invalid API key format. API keys must start with 'tp_'");
@@ -19,7 +20,7 @@ export class AshrLabsClient {
         const apiKey = process.env.ASHR_LABS_API_KEY;
         if (!apiKey) {
             throw new Error("ASHR_LABS_API_KEY environment variable is not set. " +
-                "Create an API key at https://app.ashr.io → API Keys.");
+                "Create an API key at https://lab.ashr.io → API Keys.");
         }
         const baseUrl = process.env.ASHR_LABS_BASE_URL ?? DEFAULT_BASE_URL;
         return new AshrLabsClient(apiKey, baseUrl, timeout);
@@ -32,6 +33,8 @@ export class AshrLabsClient {
         const user = this._session.user;
         this._tenantId = tenant.id;
         this._userId = user.id;
+        this._notes =
+            this._session.notes ?? [];
     }
     async _resolveTenantId(tenantId) {
         if (tenantId != null)
@@ -361,6 +364,31 @@ export class AshrLabsClient {
         return this._makeRequest("revoke_api_key", { api_key_id: apiKeyId });
     }
     // =========================================================================
+    // SDK Notes
+    // =========================================================================
+    /**
+     * Get cached SDK notes from the last init() or getNotes() call.
+     * Notes are platform advisories that may affect how you configure or run your agent.
+     */
+    get notes() {
+        return this._notes;
+    }
+    /**
+     * Fetch fresh SDK notes from the platform.
+     *
+     * @param agentId - Optional agent ID to also include agent-targeted notes.
+     * @returns List of active notes for your tenant.
+     */
+    async getNotes(agentId) {
+        const params = {};
+        if (agentId != null)
+            params.agent_id = agentId;
+        const response = await this._makeRequest("get_sdk_notes", params);
+        this._notes =
+            response.notes ?? [];
+        return this._notes;
+    }
+    // =========================================================================
     // Session Operations
     // =========================================================================
     async init() {

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 export { AshrLabsClient } from "./client.js";
 export { AshrLabsError, AuthenticationError, AuthorizationError, NotFoundError, ValidationError, RateLimitError, ServerError, } from "./exceptions.js";
-export type { User, Tenant, Session, Dataset, Run, Request, APIKey, ToolCall, ExpectedResponse, Action, Scenario, ObservabilityObservation, ObservabilityTrace, VmLogEntry, VmStream, KernelViewport, KernelActionData, KernelEventData, KernelVmMetadata, KernelVmStream, } from "./models.js";
+export type { User, Tenant, Session, SdkNote, Dataset, Run, Request, APIKey, ToolCall, ExpectedResponse, Action, Scenario, ObservabilityObservation, ObservabilityTrace, VmLogEntry, VmStream, KernelViewport, KernelActionData, KernelEventData, KernelVmMetadata, KernelVmStream, } from "./models.js";
 export { KERNEL_ACTION_TYPES, KERNEL_EVENT_TYPES, } from "./models.js";
 export type { KernelActionType, KernelEventType, } from "./models.js";
 export { Trace, Span, Generation } from "./tracing.js";

package/dist/models.d.ts

@@ -12,6 +12,21 @@ export interface Tenant {
     tenant_name?: string;
     is_active?: boolean;
 }
+export interface SdkNote {
+    id?: number;
+    created_at?: string;
+    updated_at?: string;
+    title?: string;
+    content?: string;
+    category?: string;
+    severity?: string;
+    tenant_id?: number | null;
+    agent_id?: number | null;
+    active_from?: string;
+    expires_at?: string | null;
+    is_archived?: boolean;
+    note_metadata?: Record<string, unknown>;
+}
 export interface Session {
     status: string;
     user: User;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ashr-labs",
-  "version": "0.4.3",
+  "version": "0.6.0",
   "description": "TypeScript SDK for the Ashr Labs API — agent testing & evaluation",
   "type": "module",
   "main": "./dist/index.js",
@@ -30,7 +30,9 @@
   ],
   "license": "MIT",
   "devDependencies": {
+    "@onkernel/sdk": "^0.44.0",
     "@types/node": "^25.3.5",
+    "playwright": "^1.58.2",
     "typescript": "^5.4.0",
     "vitest": "^3.0.0"
   },