opensteer 0.4.14 → 0.5.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +23 -0
- package/dist/{chunk-WXUXG76V.js → chunk-SXPIGCSD.js} +746 -899
- package/dist/cli/server.cjs +777 -929
- package/dist/cli/server.js +1 -1
- package/dist/index.cjs +777 -931
- package/dist/index.d.cts +16 -29
- package/dist/index.d.ts +16 -29
- package/dist/index.js +1 -3
- package/package.json +2 -2
package/dist/index.d.cts
CHANGED
|
@@ -437,14 +437,14 @@ declare class Opensteer {
|
|
|
437
437
|
private resolvePath;
|
|
438
438
|
private resolvePathWithAi;
|
|
439
439
|
private buildPathFromElement;
|
|
440
|
-
private tryBuildPathFromCounter;
|
|
441
440
|
private resolveCounterHandle;
|
|
442
441
|
private resolveCounterHandleForAction;
|
|
443
442
|
private buildPathFromResolvedHandle;
|
|
443
|
+
private tryBuildPathFromResolvedHandle;
|
|
444
444
|
private withIndexedIframeContext;
|
|
445
|
+
private withHandleIframeContext;
|
|
445
446
|
private readPathFromCounterIndex;
|
|
446
447
|
private buildPathFromSelector;
|
|
447
|
-
private ensureSnapshotWithCounters;
|
|
448
448
|
private persistPath;
|
|
449
449
|
private persistExtractPaths;
|
|
450
450
|
private extractPersistedPayload;
|
|
@@ -617,32 +617,7 @@ declare function cleanForClickable(html: string): string;
|
|
|
617
617
|
declare function cleanForScrollable(html: string): string;
|
|
618
618
|
declare function cleanForAction(html: string): string;
|
|
619
619
|
|
|
620
|
-
interface CounterBinding {
|
|
621
|
-
sessionId: string;
|
|
622
|
-
frameToken: string;
|
|
623
|
-
nodeId: string;
|
|
624
|
-
instanceToken: string;
|
|
625
|
-
}
|
|
626
|
-
interface CounterRequest {
|
|
627
|
-
key: string;
|
|
628
|
-
counter: number;
|
|
629
|
-
attribute?: string;
|
|
630
|
-
}
|
|
631
|
-
interface CounterSnapshotLike {
|
|
632
|
-
snapshotSessionId: string;
|
|
633
|
-
counterBindings: Map<number, CounterBinding> | null;
|
|
634
|
-
}
|
|
635
|
-
type CounterResolutionErrorCode = 'ERR_COUNTER_NOT_FOUND' | 'ERR_COUNTER_FRAME_UNAVAILABLE' | 'ERR_COUNTER_STALE_OR_NOT_FOUND' | 'ERR_COUNTER_AMBIGUOUS';
|
|
636
|
-
declare class CounterResolutionError extends Error {
|
|
637
|
-
readonly code: CounterResolutionErrorCode;
|
|
638
|
-
constructor(code: CounterResolutionErrorCode, message: string);
|
|
639
|
-
}
|
|
640
|
-
declare function ensureLiveCounters(page: Page, nodeMeta: Map<string, SerializedNodeMeta>, nodeIds: string[]): Promise<Map<string, number>>;
|
|
641
|
-
declare function resolveCounterElement(page: Page, snapshot: CounterSnapshotLike, counter: number): Promise<ElementHandle<Element>>;
|
|
642
|
-
declare function resolveCountersBatch(page: Page, snapshot: CounterSnapshotLike, requests: CounterRequest[]): Promise<Record<string, unknown>>;
|
|
643
|
-
|
|
644
620
|
interface PreparedSnapshot {
|
|
645
|
-
snapshotSessionId: string;
|
|
646
621
|
mode: SnapshotMode;
|
|
647
622
|
url: string | null;
|
|
648
623
|
rawHtml: string;
|
|
@@ -650,10 +625,22 @@ interface PreparedSnapshot {
|
|
|
650
625
|
reducedHtml: string;
|
|
651
626
|
cleanedHtml: string;
|
|
652
627
|
counterIndex: Map<number, ElementPath> | null;
|
|
653
|
-
counterBindings: Map<number, CounterBinding> | null;
|
|
654
628
|
}
|
|
655
629
|
declare function prepareSnapshot(page: Page, options?: SnapshotOptions): Promise<PreparedSnapshot>;
|
|
656
630
|
|
|
631
|
+
interface CounterRequest {
|
|
632
|
+
key: string;
|
|
633
|
+
counter: number;
|
|
634
|
+
attribute?: string;
|
|
635
|
+
}
|
|
636
|
+
type CounterResolutionErrorCode = 'ERR_COUNTER_NOT_FOUND' | 'ERR_COUNTER_AMBIGUOUS';
|
|
637
|
+
declare class CounterResolutionError extends Error {
|
|
638
|
+
readonly code: CounterResolutionErrorCode;
|
|
639
|
+
constructor(code: CounterResolutionErrorCode, message: string);
|
|
640
|
+
}
|
|
641
|
+
declare function resolveCounterElement(page: Page, counter: number): Promise<ElementHandle<Element>>;
|
|
642
|
+
declare function resolveCountersBatch(page: Page, requests: CounterRequest[]): Promise<Record<string, unknown>>;
|
|
643
|
+
|
|
657
644
|
declare function normalizeNamespace(input?: string): string;
|
|
658
645
|
declare function resolveNamespaceDir(rootDir: string, namespace: string): string;
|
|
659
646
|
|
|
@@ -903,4 +890,4 @@ declare class OpensteerCuaAgentHandler {
|
|
|
903
890
|
private maybeRenderCursor;
|
|
904
891
|
}
|
|
905
892
|
|
|
906
|
-
export { type ActionExecutionResult, type ActionFailure, type ActionFailureBlocker, type ActionFailureClassificationSource, type ActionFailureCode, type ActionFailureDetails, type ActionResult, type ActionWaitOptions, ActionWsClient, type AiExtractArgs, type AiExtractCallback, type AiExtractResult, type AiModelConfig, type AiResolveArgs, type AiResolveCallback, type AiResolveCallbackResult, type AiResolveResult, type ArrayExtractedRow, type ArrayRowMetadata, type ArraySelector, type AttributeMatchClause, type BaseActionOptions, type BoundingBox, type ClickOptions, type CloudActionFailure, type CloudActionFailureDetails, type CloudActionMethod, type CloudActionRequest, type CloudActionResponse, type CloudActionSuccess, CloudCdpClient, type CloudCdpConnectArgs, type CloudCdpConnection, type CloudErrorCode, type CloudSelectorCacheImportEntry, type CloudSelectorCacheImportRequest, type CloudSelectorCacheImportResponse, CloudSessionClient, type CloudSessionContractVersion, type CloudSessionCreateRequest, type CloudSessionCreateResponse, type CloudSessionSourceType, type CloudSessionSummary, type ContextHop, type CookieParam, type
|
|
893
|
+
export { type ActionExecutionResult, type ActionFailure, type ActionFailureBlocker, type ActionFailureClassificationSource, type ActionFailureCode, type ActionFailureDetails, type ActionResult, type ActionWaitOptions, ActionWsClient, type AiExtractArgs, type AiExtractCallback, type AiExtractResult, type AiModelConfig, type AiResolveArgs, type AiResolveCallback, type AiResolveCallbackResult, type AiResolveResult, type ArrayExtractedRow, type ArrayRowMetadata, type ArraySelector, type AttributeMatchClause, type BaseActionOptions, type BoundingBox, type ClickOptions, type CloudActionFailure, type CloudActionFailureDetails, type CloudActionMethod, type CloudActionRequest, type CloudActionResponse, type CloudActionSuccess, CloudCdpClient, type CloudCdpConnectArgs, type CloudCdpConnection, type CloudErrorCode, type CloudSelectorCacheImportEntry, type CloudSelectorCacheImportRequest, type CloudSelectorCacheImportResponse, CloudSessionClient, type CloudSessionContractVersion, type CloudSessionCreateRequest, type CloudSessionCreateResponse, type CloudSessionSourceType, type CloudSessionSummary, type ContextHop, type CookieParam, type CounterRequest, CounterResolutionError, type CounterResolutionErrorCode, type DomPath, type ElementPath, ElementPathError, type ElementPathErrorCode, type ExtractFromPlanOptions, type ExtractOptions, type ExtractSchema, type ExtractSchemaField, type ExtractSchemaValue, type ExtractionFieldPlan, type ExtractionPlan, type ExtractionRunResult, type FieldSelector, type FileUploadOptions, type GotoOptions, type HoverOptions, type InputOptions, type LaunchOptions, LocalSelectorStorage, type MarkInteractivityOptions, type MatchClause, type MatchOperator, OPENSTEER_HIDDEN_ATTR, OPENSTEER_INTERACTIVE_ATTR, OPENSTEER_SCROLLABLE_ATTR, OS_BOUNDARY_ATTR, OS_IFRAME_BOUNDARY_TAG, OS_NODE_ID_ATTR, OS_SHADOW_BOUNDARY_TAG, OS_UNAVAILABLE_ATTR, Opensteer, OpensteerActionError, type OpensteerAgentAction, OpensteerAgentActionError, OpensteerAgentApiError, OpensteerAgentBusyError, type OpensteerAgentConfig, OpensteerAgentConfigError, OpensteerAgentError, type OpensteerAgentExecuteOptions, OpensteerAgentExecutionError, type OpensteerAgentInstance, type OpensteerAgentMode, type OpensteerAgentModelConfig, type OpensteerAgentProvider, OpensteerAgentProviderError, type OpensteerAgentResult, type OpensteerAgentUsage, type OpensteerAuthScheme, type OpensteerBrowserConfig, type OpensteerCloudAnnouncePolicy, type OpensteerCloudConfig, OpensteerCloudError, type OpensteerCloudOptions, type OpensteerConfig, OpensteerCuaAgentHandler, type OpensteerStorageConfig, type PathNode, type PathNodePosition, type PositionMatchClause, type PreparedSnapshot, type RegistryEntry, type ResolvedElementPath, type ScreenshotOptions, type ScrollOptions, type SelectOptions, type SelectorFile, type SelectorRegistry, type SerializeOptions, type SerializedNodeMeta, type SerializedPageHTML, type SnapshotMode, type SnapshotOptions, type StateResult, type TabInfo, buildElementPathFromHandle, buildElementPathFromSelector, buildPathSelectorHint, cleanForAction, cleanForClickable, cleanForExtraction, cleanForFull, cleanForScrollable, clearCookies, cloneElementPath, closeTab, cloudNotLaunchedError, cloudSessionContractVersion, cloudUnsupportedMethodError, collectLocalSelectorCacheEntries, countArrayItemsWithPath, createCuaClient, createEmptyRegistry, createExtractCallback, createResolveCallback, createTab, exportCookies, extractArrayRowsWithPaths, extractArrayWithPaths, extractWithPaths, getCookies, getElementAttributes, getElementBoundingBox, getElementText, getElementValue, getModelProvider, getPageHtml, getPageTitle, importCookies, listTabs, markInteractiveElements, normalizeNamespace, performClick, performFileUpload, performHover, performInput, performScroll, performSelect, prepareSnapshot, pressKey, resolveAgentConfig, resolveCounterElement, resolveCountersBatch, resolveElementPath, resolveNamespaceDir, sanitizeElementPath, serializePageHTML, setCookie, switchTab, typeText, waitForVisualStability };
|
package/dist/index.d.ts
CHANGED
|
@@ -437,14 +437,14 @@ declare class Opensteer {
|
|
|
437
437
|
private resolvePath;
|
|
438
438
|
private resolvePathWithAi;
|
|
439
439
|
private buildPathFromElement;
|
|
440
|
-
private tryBuildPathFromCounter;
|
|
441
440
|
private resolveCounterHandle;
|
|
442
441
|
private resolveCounterHandleForAction;
|
|
443
442
|
private buildPathFromResolvedHandle;
|
|
443
|
+
private tryBuildPathFromResolvedHandle;
|
|
444
444
|
private withIndexedIframeContext;
|
|
445
|
+
private withHandleIframeContext;
|
|
445
446
|
private readPathFromCounterIndex;
|
|
446
447
|
private buildPathFromSelector;
|
|
447
|
-
private ensureSnapshotWithCounters;
|
|
448
448
|
private persistPath;
|
|
449
449
|
private persistExtractPaths;
|
|
450
450
|
private extractPersistedPayload;
|
|
@@ -617,32 +617,7 @@ declare function cleanForClickable(html: string): string;
|
|
|
617
617
|
declare function cleanForScrollable(html: string): string;
|
|
618
618
|
declare function cleanForAction(html: string): string;
|
|
619
619
|
|
|
620
|
-
interface CounterBinding {
|
|
621
|
-
sessionId: string;
|
|
622
|
-
frameToken: string;
|
|
623
|
-
nodeId: string;
|
|
624
|
-
instanceToken: string;
|
|
625
|
-
}
|
|
626
|
-
interface CounterRequest {
|
|
627
|
-
key: string;
|
|
628
|
-
counter: number;
|
|
629
|
-
attribute?: string;
|
|
630
|
-
}
|
|
631
|
-
interface CounterSnapshotLike {
|
|
632
|
-
snapshotSessionId: string;
|
|
633
|
-
counterBindings: Map<number, CounterBinding> | null;
|
|
634
|
-
}
|
|
635
|
-
type CounterResolutionErrorCode = 'ERR_COUNTER_NOT_FOUND' | 'ERR_COUNTER_FRAME_UNAVAILABLE' | 'ERR_COUNTER_STALE_OR_NOT_FOUND' | 'ERR_COUNTER_AMBIGUOUS';
|
|
636
|
-
declare class CounterResolutionError extends Error {
|
|
637
|
-
readonly code: CounterResolutionErrorCode;
|
|
638
|
-
constructor(code: CounterResolutionErrorCode, message: string);
|
|
639
|
-
}
|
|
640
|
-
declare function ensureLiveCounters(page: Page, nodeMeta: Map<string, SerializedNodeMeta>, nodeIds: string[]): Promise<Map<string, number>>;
|
|
641
|
-
declare function resolveCounterElement(page: Page, snapshot: CounterSnapshotLike, counter: number): Promise<ElementHandle<Element>>;
|
|
642
|
-
declare function resolveCountersBatch(page: Page, snapshot: CounterSnapshotLike, requests: CounterRequest[]): Promise<Record<string, unknown>>;
|
|
643
|
-
|
|
644
620
|
interface PreparedSnapshot {
|
|
645
|
-
snapshotSessionId: string;
|
|
646
621
|
mode: SnapshotMode;
|
|
647
622
|
url: string | null;
|
|
648
623
|
rawHtml: string;
|
|
@@ -650,10 +625,22 @@ interface PreparedSnapshot {
|
|
|
650
625
|
reducedHtml: string;
|
|
651
626
|
cleanedHtml: string;
|
|
652
627
|
counterIndex: Map<number, ElementPath> | null;
|
|
653
|
-
counterBindings: Map<number, CounterBinding> | null;
|
|
654
628
|
}
|
|
655
629
|
declare function prepareSnapshot(page: Page, options?: SnapshotOptions): Promise<PreparedSnapshot>;
|
|
656
630
|
|
|
631
|
+
interface CounterRequest {
|
|
632
|
+
key: string;
|
|
633
|
+
counter: number;
|
|
634
|
+
attribute?: string;
|
|
635
|
+
}
|
|
636
|
+
type CounterResolutionErrorCode = 'ERR_COUNTER_NOT_FOUND' | 'ERR_COUNTER_AMBIGUOUS';
|
|
637
|
+
declare class CounterResolutionError extends Error {
|
|
638
|
+
readonly code: CounterResolutionErrorCode;
|
|
639
|
+
constructor(code: CounterResolutionErrorCode, message: string);
|
|
640
|
+
}
|
|
641
|
+
declare function resolveCounterElement(page: Page, counter: number): Promise<ElementHandle<Element>>;
|
|
642
|
+
declare function resolveCountersBatch(page: Page, requests: CounterRequest[]): Promise<Record<string, unknown>>;
|
|
643
|
+
|
|
657
644
|
declare function normalizeNamespace(input?: string): string;
|
|
658
645
|
declare function resolveNamespaceDir(rootDir: string, namespace: string): string;
|
|
659
646
|
|
|
@@ -903,4 +890,4 @@ declare class OpensteerCuaAgentHandler {
|
|
|
903
890
|
private maybeRenderCursor;
|
|
904
891
|
}
|
|
905
892
|
|
|
906
|
-
export { type ActionExecutionResult, type ActionFailure, type ActionFailureBlocker, type ActionFailureClassificationSource, type ActionFailureCode, type ActionFailureDetails, type ActionResult, type ActionWaitOptions, ActionWsClient, type AiExtractArgs, type AiExtractCallback, type AiExtractResult, type AiModelConfig, type AiResolveArgs, type AiResolveCallback, type AiResolveCallbackResult, type AiResolveResult, type ArrayExtractedRow, type ArrayRowMetadata, type ArraySelector, type AttributeMatchClause, type BaseActionOptions, type BoundingBox, type ClickOptions, type CloudActionFailure, type CloudActionFailureDetails, type CloudActionMethod, type CloudActionRequest, type CloudActionResponse, type CloudActionSuccess, CloudCdpClient, type CloudCdpConnectArgs, type CloudCdpConnection, type CloudErrorCode, type CloudSelectorCacheImportEntry, type CloudSelectorCacheImportRequest, type CloudSelectorCacheImportResponse, CloudSessionClient, type CloudSessionContractVersion, type CloudSessionCreateRequest, type CloudSessionCreateResponse, type CloudSessionSourceType, type CloudSessionSummary, type ContextHop, type CookieParam, type
|
|
893
|
+
export { type ActionExecutionResult, type ActionFailure, type ActionFailureBlocker, type ActionFailureClassificationSource, type ActionFailureCode, type ActionFailureDetails, type ActionResult, type ActionWaitOptions, ActionWsClient, type AiExtractArgs, type AiExtractCallback, type AiExtractResult, type AiModelConfig, type AiResolveArgs, type AiResolveCallback, type AiResolveCallbackResult, type AiResolveResult, type ArrayExtractedRow, type ArrayRowMetadata, type ArraySelector, type AttributeMatchClause, type BaseActionOptions, type BoundingBox, type ClickOptions, type CloudActionFailure, type CloudActionFailureDetails, type CloudActionMethod, type CloudActionRequest, type CloudActionResponse, type CloudActionSuccess, CloudCdpClient, type CloudCdpConnectArgs, type CloudCdpConnection, type CloudErrorCode, type CloudSelectorCacheImportEntry, type CloudSelectorCacheImportRequest, type CloudSelectorCacheImportResponse, CloudSessionClient, type CloudSessionContractVersion, type CloudSessionCreateRequest, type CloudSessionCreateResponse, type CloudSessionSourceType, type CloudSessionSummary, type ContextHop, type CookieParam, type CounterRequest, CounterResolutionError, type CounterResolutionErrorCode, type DomPath, type ElementPath, ElementPathError, type ElementPathErrorCode, type ExtractFromPlanOptions, type ExtractOptions, type ExtractSchema, type ExtractSchemaField, type ExtractSchemaValue, type ExtractionFieldPlan, type ExtractionPlan, type ExtractionRunResult, type FieldSelector, type FileUploadOptions, type GotoOptions, type HoverOptions, type InputOptions, type LaunchOptions, LocalSelectorStorage, type MarkInteractivityOptions, type MatchClause, type MatchOperator, OPENSTEER_HIDDEN_ATTR, OPENSTEER_INTERACTIVE_ATTR, OPENSTEER_SCROLLABLE_ATTR, OS_BOUNDARY_ATTR, OS_IFRAME_BOUNDARY_TAG, OS_NODE_ID_ATTR, OS_SHADOW_BOUNDARY_TAG, OS_UNAVAILABLE_ATTR, Opensteer, OpensteerActionError, type OpensteerAgentAction, OpensteerAgentActionError, OpensteerAgentApiError, OpensteerAgentBusyError, type OpensteerAgentConfig, OpensteerAgentConfigError, OpensteerAgentError, type OpensteerAgentExecuteOptions, OpensteerAgentExecutionError, type OpensteerAgentInstance, type OpensteerAgentMode, type OpensteerAgentModelConfig, type OpensteerAgentProvider, OpensteerAgentProviderError, type OpensteerAgentResult, type OpensteerAgentUsage, type OpensteerAuthScheme, type OpensteerBrowserConfig, type OpensteerCloudAnnouncePolicy, type OpensteerCloudConfig, OpensteerCloudError, type OpensteerCloudOptions, type OpensteerConfig, OpensteerCuaAgentHandler, type OpensteerStorageConfig, type PathNode, type PathNodePosition, type PositionMatchClause, type PreparedSnapshot, type RegistryEntry, type ResolvedElementPath, type ScreenshotOptions, type ScrollOptions, type SelectOptions, type SelectorFile, type SelectorRegistry, type SerializeOptions, type SerializedNodeMeta, type SerializedPageHTML, type SnapshotMode, type SnapshotOptions, type StateResult, type TabInfo, buildElementPathFromHandle, buildElementPathFromSelector, buildPathSelectorHint, cleanForAction, cleanForClickable, cleanForExtraction, cleanForFull, cleanForScrollable, clearCookies, cloneElementPath, closeTab, cloudNotLaunchedError, cloudSessionContractVersion, cloudUnsupportedMethodError, collectLocalSelectorCacheEntries, countArrayItemsWithPath, createCuaClient, createEmptyRegistry, createExtractCallback, createResolveCallback, createTab, exportCookies, extractArrayRowsWithPaths, extractArrayWithPaths, extractWithPaths, getCookies, getElementAttributes, getElementBoundingBox, getElementText, getElementValue, getModelProvider, getPageHtml, getPageTitle, importCookies, listTabs, markInteractiveElements, normalizeNamespace, performClick, performFileUpload, performHover, performInput, performScroll, performSelect, prepareSnapshot, pressKey, resolveAgentConfig, resolveCounterElement, resolveCountersBatch, resolveElementPath, resolveNamespaceDir, sanitizeElementPath, serializePageHTML, setCookie, switchTab, typeText, waitForVisualStability };
|
package/dist/index.js
CHANGED
|
@@ -43,7 +43,6 @@ import {
|
|
|
43
43
|
createCuaClient,
|
|
44
44
|
createEmptyRegistry,
|
|
45
45
|
createTab,
|
|
46
|
-
ensureLiveCounters,
|
|
47
46
|
exportCookies,
|
|
48
47
|
extractArrayRowsWithPaths,
|
|
49
48
|
extractArrayWithPaths,
|
|
@@ -78,7 +77,7 @@ import {
|
|
|
78
77
|
switchTab,
|
|
79
78
|
typeText,
|
|
80
79
|
waitForVisualStability
|
|
81
|
-
} from "./chunk-
|
|
80
|
+
} from "./chunk-SXPIGCSD.js";
|
|
82
81
|
import {
|
|
83
82
|
createResolveCallback
|
|
84
83
|
} from "./chunk-SPHS6YWD.js";
|
|
@@ -136,7 +135,6 @@ export {
|
|
|
136
135
|
createExtractCallback,
|
|
137
136
|
createResolveCallback,
|
|
138
137
|
createTab,
|
|
139
|
-
ensureLiveCounters,
|
|
140
138
|
exportCookies,
|
|
141
139
|
extractArrayRowsWithPaths,
|
|
142
140
|
extractArrayWithPaths,
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "opensteer",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.5.1",
|
|
4
4
|
"description": "Open-source browser automation SDK with robust selectors and deterministic replay.",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"type": "module",
|
|
@@ -61,7 +61,7 @@
|
|
|
61
61
|
],
|
|
62
62
|
"repository": {
|
|
63
63
|
"type": "git",
|
|
64
|
-
"url": "https://github.com/
|
|
64
|
+
"url": "https://github.com/steerlabs/opensteer"
|
|
65
65
|
},
|
|
66
66
|
"scripts": {
|
|
67
67
|
"build": "tsup src/index.ts src/cli/server.ts --dts --format esm,cjs --clean --external ai --external zod --external @ai-sdk/openai --external @ai-sdk/anthropic --external @ai-sdk/google --external @ai-sdk/xai --external @ai-sdk/groq --external openai --external @anthropic-ai/sdk --external @google/genai",
|