Merge pull request #177 from SentienceAPI/rebrand2

rebrand 2 with Predicate*

Author: rcholic

CHANGELOG.md

@@ -0,0 +1,23 @@
+# Changelog
+
+All notable changes to `@predicatelabs/sdk` will be documented in this file.
+
+## Unreleased
+
+### Deprecated
+
+- Soft-deprecated legacy `Sentience*` class names in favor of `Predicate*` names:
+  - `SentienceBrowser` -> `PredicateBrowser`
+  - `SentienceAgent` -> `PredicateAgent`
+  - `SentienceVisualAgent` -> `PredicateVisualAgent`
+  - `SentienceDebugger` -> `PredicateDebugger`
+  - `backends.SentienceContext` -> `backends.PredicateContext`
+- Legacy names remain supported as runtime aliases for compatibility during a transition window of **1-2 releases**.
+
+### Added
+
+- Runtime alias exports for `Predicate*` counterparts to preserve backwards compatibility while enabling rebrand migration.
+
+### Fixed
+
+- Hardened `search()` in `src/actions.ts` for CI reliability by making `page.waitForLoadState('networkidle')` best-effort with a bounded timeout, preventing flaky timeouts on pages with long-lived background requests.

README.md

@@ -32,6 +32,26 @@ npm install @predicatelabs/sdk
 npx playwright install chromium
 ```
 
+## Naming migration (Predicate rebrand)
+
+Use the new `Predicate*` class names for all new code:
+
+- `PredicateBrowser`
+- `PredicateAgent`
+- `PredicateVisualAgent`
+- `PredicateDebugger`
+- `backends.PredicateContext`
+
+The legacy `Sentience*` names are still available as runtime aliases for compatibility, but are now soft-deprecated and planned for removal after **1-2 releases**.
+
+Mapping:
+
+- `SentienceBrowser` -> `PredicateBrowser`
+- `SentienceAgent` -> `PredicateAgent`
+- `SentienceVisualAgent` -> `PredicateVisualAgent`
+- `SentienceDebugger` -> `PredicateDebugger`
+- `backends.SentienceContext` -> `backends.PredicateContext`
+
 ## Conceptual example (why this exists)
 
 - Steps are **gated by verifiable UI assertions**

src/actions.ts

@@ -1134,7 +1134,13 @@ export async function search(
   const urlBefore = page.url();
   const url = buildSearchUrl(query, engine);
   await browser.goto(url);
-  await page.waitForLoadState('networkidle');
+  // Some search engines keep long-lived background requests open in CI,
+  // so treat networkidle as a best-effort signal instead of a hard requirement.
+  try {
+    await page.waitForLoadState('networkidle', { timeout: 5000 });
+  } catch {
+    // no-op: page is already loaded enough for URL/result assertions
+  }
 
   const durationMs = Date.now() - startTime;
   const urlAfter = page.url();

src/agent.ts

@@ -535,3 +535,9 @@ export class SentienceAgent {
     }
   }
 }
+
+/**
+ * Predicate rebrand alias for SentienceAgent.
+ * Kept as a runtime alias to avoid breaking existing integrations.
+ */
+export const PredicateAgent = SentienceAgent;

src/backends/index.ts

@@ -108,6 +108,7 @@ export {
 // SentienceContext (Token-Slasher Context Middleware)
 export {
   SentienceContext,
+  PredicateContext,
   SentienceContextState,
   SentienceContextOptions,
   TopElementSelector,

src/backends/sentience-context.ts

@@ -474,3 +474,9 @@ export class SentienceContext {
     return this._selector;
   }
 }
+
+/**
+ * Predicate rebrand alias for SentienceContext.
+ * Kept as a runtime alias to avoid breaking existing integrations.
+ */
+export const PredicateContext = SentienceContext;

src/browser.ts

@@ -1021,3 +1021,9 @@ export class SentienceBrowser implements IBrowser {
     return finalPath;
   }
 }
+
+/**
+ * Predicate rebrand alias for SentienceBrowser.
+ * Kept as a runtime alias to avoid breaking existing integrations.
+ */
+export const PredicateBrowser = SentienceBrowser;

src/debugger.ts

@@ -131,3 +131,9 @@ export class SentienceDebugger {
     return new DebuggerAssertionHandle(this, predicate, label, required, true, openedStepId);
   }
 }
+
+/**
+ * Predicate rebrand alias for SentienceDebugger.
+ * Kept as a runtime alias to avoid breaking existing integrations.
+ */
+export const PredicateDebugger = SentienceDebugger;

src/index.ts

@@ -2,7 +2,7 @@
  * Sentience TypeScript SDK - AI Agent Browser Automation
  */
 
-export { SentienceBrowser, PermissionPolicy } from './browser';
+export { SentienceBrowser, PredicateBrowser, PermissionPolicy } from './browser';
 export { snapshot, SnapshotOptions, SnapshotGatewayError } from './snapshot';
 export { query, find, parseSelector } from './query';
 export {
@@ -46,8 +46,8 @@ export {
   AnthropicProvider,
   GLMProvider,
 } from './llm-provider';
-export { SentienceAgent, AgentActResult, HistoryEntry, TokenStats } from './agent';
-export { SentienceVisualAgent } from './visual-agent';
+export { SentienceAgent, PredicateAgent, AgentActResult, HistoryEntry, TokenStats } from './agent';
+export { SentienceVisualAgent, PredicateVisualAgent } from './visual-agent';
 
 // Conversational Agent Layer (v0.3.0+)
 export {
@@ -87,7 +87,7 @@ export {
   isCollapsed,
 } from './verification';
 export { AgentRuntime, AssertionHandle, AssertionRecord, EventuallyOptions } from './agent-runtime';
-export { SentienceDebugger } from './debugger';
+export { SentienceDebugger, PredicateDebugger } from './debugger';
 export { RuntimeAgent } from './runtime-agent';
 export type { RuntimeStep, StepVerification } from './runtime-agent';
 export { parseVisionExecutorAction, executeVisionExecutorAction } from './vision-executor';

src/visual-agent.ts

@@ -906,3 +906,9 @@ Return ONLY the integer ID number from the label, nothing else.`;
     }
   }
 }
+
+/**
+ * Predicate rebrand alias for SentienceVisualAgent.
+ * Kept as a runtime alias to avoid breaking existing integrations.
+ */
+export const PredicateVisualAgent = SentienceVisualAgent;