@capgo/cli 8.46.1 → 8.47.1

package/dist/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@capgo/cli",
   "type": "module",
-  "version": "8.46.1",
+  "version": "8.47.1",
   "description": "A CLI to upload to capgo servers",
   "author": "Martin martin@capgo.app",
   "license": "Apache 2.0",
@@ -176,7 +176,7 @@
     "test:android-version": "bun test/test-android-version.mjs",
     "test:platform-flow-contract": "bun test/test-platform-flow-contract.mjs",
     "test:tail-engine-shared": "bun test/test-tail-engine-shared.mjs",
-    "test": "bun run build && bun run test:helper-dce && bun run test:version-detection:setup && bun run test:bundle && bun run test:bundle-validation && bun run test:functional && bun run test:semver && bun run test:auto-bump-version && bun run test:auto-bump-ai-diff && bun run test:version-edge-cases && bun run test:regex && bun run test:upload && bun run test:fail-on-incompatible && bun run test:native-dependencies && bun run test:package-json-guard && bun run test:credentials && bun run test:credentials-export && bun run test:credentials-validation && bun run test:android-service-account-validation && bun run test:build-zip-filter && bun run test:checksum && bun run test:build-needed && bun run test:build-cancellation && bun run test:ci-prompts && bun run test:ci-secrets && bun run test:android-onboarding-progress && bun run test:onboarding-telemetry && bun run test:v2-event-migration && bun run test:analytics && bun run test:cli-headers && bun run test:min-cli-version && bun run test:authenticated-command-invocation && bun run test:analytics-error-category && bun run test:analytics-org-resolver && bun run test:supabase-perf && bun run test:preview-qr && bun run test:app-set-options && bun run test:mcp-analytics && bun run test:mcp-instructions && bun run test:mcp-live-update-onboarding && bun run test:mcp-stdout-guard && bun run test:mcp-platform-select && bun run test:mcp-explain-scopes && bun run test:mcp-oauth-reopen && bun run test:mcp-broker-oauth && bun run test:mcp-broker-session && bun run test:mcp-credentials-manage && bun run test:mcp-resume-prompt && bun run test:mcp-build-job && bun run test:mcp-build-tools && bun run test:app-created-source && bun run test:app-add-exists && bun run test:app-list-output-text && bun run test:doctor-analytics && bun run test:posthog-exception && bun run test:cli-recovery && bun run test:create-supabase-client && bun run test:build-platform-selection && bun run test:builder-project-discovery && bun run test:onboarding-recovery && bun run test:onboarding-progress && bun run test:onboarding-run-targets && bun run test:run-device-command && bun run test:init-monorepo-targeting && bun run test:init-app-conflict && bun run test:channel-add-exists && bun run test:wait-log && bun run test:init-guardrails && bun run test:init-replay && bun run test:init-telemetry && bun run test:prompt-preferences && bun run test:esm-sdk && bun run test:mcp && bun run test:mcp-no-key-handshake && bun run test:auth-session && bun run test:version-detection && bun run test:platform-paths && bun run test:project-type-detection && bun run test:payload-split && bun run test:manifest-path-encoding && bun run test:macos-signing && bun run test:asc-key-protocol && bun run test:apple-api-import-helpers && bun run test:apple-api-verify-key && bun run test:bundle-id-detector && bun run test:apple-api-app-list && bun run test:app-verification && bun run test:pbxproj-parser && bun run test:ai-log-capture && bun run test:ai-analyze-flow && bun run test:cicd-failure-help && bun run test:ai-sse-parser && bun run test:ai-render-markdown && bun run test:ai-stream-markdown && bun run test:ai-onboarding-mode && bun run test:ai-fit && bun run test:platform-layout && bun run test:frame-fit && bun run test:onboarding-min-size && bun run test:min-size-gate && bun run test:shell-size-gate && bun run test:build-log-sanitize && bun run test:build-output-viewport && bun run test:diff-viewer-viewport && bun run test:build-complete-exit && bun run test:ai-analyze-stream && bun run test:support-mailto && bun run test:support-redact && bun run test:support-internal-log && bun run test:support-help-menu && bun run test:support-contact && bun run test:support-upload-prompt && bun run test:support-bundle-files && bun run test:self-update && bun run test:update-prompt && bun run test:apple-api-cert-create && bun run test:android-tail-engine && bun run test:android-tail-render && bun run test:android-tail-routing && bun run test:dev-gate-stripped && bun run test:frame-fit-ios-shared && bun run test:ios-confirm-app-id && bun run test:ios-create-new && bun run test:ios-e2e && bun run test:ios-flow-contract && bun run test:ios-import-discovery && bun run test:ios-import-export && bun run test:ios-import-pickers && bun run test:ios-import-recovery && bun run test:ios-recovery && bun run test:ios-resume && bun run test:ios-tail-handoff && bun run test:ios-tui-render && bun run test:p8-error && bun run test:ios-tui-routing && bun run test:ios-updater-sync-validation && bun run test:ios-verify-app && bun run test:ios-marketing-version && bun run test:android-version && bun run test:platform-flow-contract && bun run test:tail-engine-shared && bun run test:prescan && bun run test:android-reporting-api && bun run test:android-app-verification && bun run test:android-rename && bun run test:appflow-auth && bun run test:appflow-api-map && bun run test:appflow-validate && bun run test:appflow-flow && bun run test:appflow-gapfill && bun run test:appflow-engine && bun run test:appflow-tail && bun run test:appflow-fetch && bun run test:appflow-sa-decode && bun run test:app-permission-helper && bun run test:2fa-compliance-network && bun run test:organization-set-api-host && bun run test:trial-warning && bun run test:plan-validation",
+    "test": "bun run build && bun run test:helper-dce && bun run test:version-detection:setup && bun run test:bundle && bun run test:bundle-validation && bun run test:functional && bun run test:semver && bun run test:auto-bump-version && bun run test:auto-bump-ai-diff && bun run test:version-edge-cases && bun run test:regex && bun run test:upload && bun run test:fail-on-incompatible && bun run test:native-dependencies && bun run test:package-json-guard && bun run test:credentials && bun run test:credentials-export && bun run test:credentials-validation && bun run test:android-service-account-validation && bun run test:build-zip-filter && bun run test:checksum && bun run test:build-needed && bun run test:build-cancellation && bun run test:ci-prompts && bun run test:ci-secrets && bun run test:android-onboarding-progress && bun run test:onboarding-telemetry && bun run test:v2-event-migration && bun run test:analytics && bun run test:cli-headers && bun run test:min-cli-version && bun run test:authenticated-command-invocation && bun run test:analytics-error-category && bun run test:analytics-org-resolver && bun run test:supabase-perf && bun run test:preview-qr && bun run test:app-set-options && bun run test:mcp-analytics && bun run test:mcp-instructions && bun run test:mcp-live-update-onboarding && bun run test:mcp-stdout-guard && bun run test:mcp-platform-select && bun run test:mcp-explain-scopes && bun run test:mcp-oauth-reopen && bun run test:mcp-broker-oauth && bun run test:mcp-broker-session && bun run test:mcp-credentials-manage && bun run test:mcp-resume-prompt && bun run test:mcp-build-job && bun run test:mcp-build-tools && bun run test:app-created-source && bun run test:app-add-exists && bun run test:app-list-output-text && bun run test:doctor-analytics && bun run test:posthog-exception && bun run test:cli-recovery && bun run test:create-supabase-client && bun run test:build-platform-selection && bun run test:builder-project-discovery && bun run test:onboarding-recovery && bun run test:onboarding-progress && bun run test:onboarding-run-targets && bun run test:run-device-command && bun run test:init-monorepo-targeting && bun run test:init-app-conflict && bun run test:channel-add-exists && bun run test:wait-log && bun run test:init-guardrails && bun run test:init-replay && bun run test:init-telemetry && bun run test:prompt-preferences && bun run test:esm-sdk && bun run test:mcp && bun run test:mcp-no-key-handshake && bun run test:auth-session && bun run test:version-detection && bun run test:platform-paths && bun run test:project-type-detection && bun run test:payload-split && bun run test:manifest-path-encoding && bun run test:macos-signing && bun run test:asc-key-protocol && bun run test:apple-api-import-helpers && bun run test:apple-api-verify-key && bun run test:bundle-id-detector && bun run test:apple-api-app-list && bun run test:app-verification && bun run test:pbxproj-parser && bun run test:ai-log-capture && bun run test:ai-analyze-flow && bun run test:cicd-failure-help && bun run test:ai-sse-parser && bun run test:ai-render-markdown && bun run test:ai-stream-markdown && bun run test:ai-onboarding-mode && bun run test:ai-fit && bun run test:platform-layout && bun run test:frame-fit && bun run test:onboarding-min-size && bun run test:min-size-gate && bun run test:shell-size-gate && bun run test:build-log-sanitize && bun run test:build-output-viewport && bun run test:diff-viewer-viewport && bun run test:build-complete-exit && bun run test:ai-analyze-stream && bun run test:support-mailto && bun run test:support-redact && bun run test:support-internal-log && bun run test:support-help-menu && bun run test:support-contact && bun run test:support-upload-prompt && bun run test:support-bundle-files && bun run test:self-update && bun run test:update-prompt && bun run test:apple-api-cert-create && bun run test:android-tail-engine && bun run test:android-tail-render && bun run test:android-tail-routing && bun run test:dev-gate-stripped && bun run test:frame-fit-ios-shared && bun run test:ios-confirm-app-id && bun run test:ios-create-new && bun run test:ios-e2e && bun run test:ios-flow-contract && bun run test:ios-import-discovery && bun run test:ios-import-export && bun run test:ios-import-pickers && bun run test:ios-import-recovery && bun run test:ios-recovery && bun run test:ios-resume && bun run test:ios-tail-handoff && bun run test:ios-tui-render && bun run test:p8-error && bun run test:ios-tui-routing && bun run test:ios-updater-sync-validation && bun run test:ios-verify-app && bun run test:ios-marketing-version && bun run test:android-version && bun run test:platform-flow-contract && bun run test:tail-engine-shared && bun run test:prescan && bun run test:android-reporting-api && bun run test:android-gcp && bun run test:android-app-verification && bun run test:android-rename && bun run test:appflow-auth && bun run test:appflow-api-map && bun run test:appflow-validate && bun run test:appflow-flow && bun run test:appflow-gapfill && bun run test:appflow-engine && bun run test:appflow-tail && bun run test:appflow-fetch && bun run test:appflow-sa-decode && bun run test:app-permission-helper && bun run test:2fa-compliance-network && bun run test:organization-set-api-host && bun run test:trial-warning && bun run test:plan-validation",
     "test:build-platform-selection": "bun test/test-build-platform-selection.mjs",
     "test:builder-project-discovery": "bun test/test-builder-project-discovery.mjs",
     "test:ai-log-capture": "bun test/test-ai-log-capture.mjs",
@@ -207,6 +207,7 @@
     "test:mcp-live-update-onboarding": "bun test/test-mcp-live-update-onboarding.mjs",
     "test:app-set-options": "bun test/test-app-set-options.mjs && bun test/test-app-list-options.mjs",
     "test:android-reporting-api": "bun test/test-android-reporting-api.mjs",
+    "test:android-gcp": "bun test/test-android-gcp.mjs",
     "test:android-app-verification": "bun test/test-android-app-verification.mjs",
     "test:android-rename": "bun test/test-android-rename.mjs",
     "test:appflow-auth": "bun test/test-appflow-auth.mjs",

package/dist/src/build/onboarding/android/gcp-api.d.ts

@@ -104,7 +104,8 @@ export declare function pollOperation(accessToken: string, operationName: string
  *
  *  - 4–30 characters
  *  - allowed chars: letters, digits, space, hyphen (`-`), apostrophe (`'`),
- *    exclamation (`!`), period (`.`)
+ *    exclamation (`!`) — periods (`.`) are **not** allowed (appIds like
+ *    `com.example.app` must be normalized before submit)
  *  - must start and end with a letter or digit
  *
  * We strip any disallowed character (including em-dashes — which break the

package/dist/src/mcp/tool-schemas.d.ts

@@ -124,6 +124,28 @@ export declare const mcpGetStatsInputSchema: z.ZodObject<{
     rangeStart: z.ZodOptional<z.ZodString>;
     rangeEnd: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
+export declare const mcpObserveInputSchema: z.ZodObject<{
+    appId: z.ZodString;
+    sort: z.ZodOptional<z.ZodEnum<{
+        slowest: "slowest";
+        fastest: "fastest";
+        newest: "newest";
+        oldest: "oldest";
+    }>>;
+    deviceId: z.ZodOptional<z.ZodString>;
+    action: z.ZodOptional<z.ZodString>;
+    view: z.ZodOptional<z.ZodEnum<{
+        device: "device";
+        events: "events";
+        summary: "summary";
+        metrics: "metrics";
+        routes: "routes";
+        versions: "versions";
+    }>>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    days: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<3>, z.ZodLiteral<7>, z.ZodLiteral<30>]>>;
+    versionName: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
 export declare const mcpRequestBuildInputSchema: z.ZodObject<{
     appId: z.ZodString;
     platform: z.ZodEnum<{

package/dist/src/observe/api.d.ts

@@ -0,0 +1,2 @@
+import type { ObserveOptions } from '../schemas/sdk';
+export declare function fetchObserve(options: ObserveOptions): Promise<Record<string, unknown>>;

package/dist/src/observe/command.d.ts

@@ -0,0 +1,14 @@
+import type { ObserveView } from '../schemas/sdk';
+export interface ObserveCliOptions {
+    apikey?: string;
+    days?: string;
+    action?: string;
+    device?: string;
+    versionName?: string;
+    sort?: string;
+    limit?: string;
+    json?: boolean;
+    supaHost?: string;
+    supaAnon?: string;
+}
+export declare function observeCommand(view: ObserveView, appIdArg: string | undefined, options: ObserveCliOptions, deviceIdArg?: string): Promise<void>;

package/dist/src/schemas/index.d.ts

@@ -14,6 +14,6 @@ export type { Compatibility, CompatibilityDetails, IncompatibilityReason, Native
 export type { CapacitorConfig, ExtConfigPairs } from './config';
 export { organizationAddOptionsSchema, organizationDeleteOptionsSchema, organizationSetOptionsSchema, passwordPolicyConfigSchema } from './organization';
 export type { OrganizationAddOptions, OrganizationDeleteOptions, OrganizationSetOptions, PasswordPolicyConfig } from './organization';
-export { accountIdOptionsSchema, addAppOptionsSchema, addChannelOptionsSchema, addOrganizationOptionsSchema, appInfoSchema, bundleInfoSchema, cleanupOptionsSchema, currentBundleOptionsSchema, decryptBundleOptionsSchema, deleteOldKeyOptionsSchema, deleteOrganizationOptionsSchema, deviceStatsSchema, doctorOptionsSchema, encryptBundleOptionsSchema, generateKeyOptionsSchema, getStatsOptionsSchema, listOrganizationsOptionsSchema, loginOptionsSchema, organizationInfoSchema, saveKeyOptionsSchema, bundleCompatibilityOptionsSchema as sdkBundleCompatibilityOptionsSchema, requestBuildOptionsSchema as sdkRequestBuildOptionsSchema, setSettingOptionsSchema, statsOrderSchema, updateAppOptionsSchema, updateChannelOptionsSchema, updateOrganizationOptionsSchema, uploadOptionsSchema, uploadResultSchema, zipBundleOptionsSchema, } from './sdk';
-export type { AccountIdOptions, AddAppOptions, AddChannelOptions, AddOrganizationOptions, AppInfo, BundleInfo, CleanupOptions, CurrentBundleOptions, DecryptBundleOptions, DeleteOldKeyOptions, DeleteOrganizationOptions, DeviceStats, DoctorOptions, EncryptBundleOptions, GenerateKeyOptions, GetStatsOptions, ListOrganizationsOptions, LoginOptions, OrganizationInfo, SaveKeyOptions, BundleCompatibilityOptions as SdkBundleCompatibilityOptions, RequestBuildOptions as SdkRequestBuildOptions, SDKResult, SetSettingOptions, StatsOrder, UpdateAppOptions, UpdateChannelOptions, UpdateOrganizationOptions, UploadOptions, UploadResult, ZipBundleOptions, } from './sdk';
+export { accountIdOptionsSchema, addAppOptionsSchema, addChannelOptionsSchema, addOrganizationOptionsSchema, appInfoSchema, bundleInfoSchema, cleanupOptionsSchema, currentBundleOptionsSchema, decryptBundleOptionsSchema, deleteOldKeyOptionsSchema, deleteOrganizationOptionsSchema, deviceStatsSchema, doctorOptionsSchema, encryptBundleOptionsSchema, generateKeyOptionsSchema, getStatsOptionsSchema, listOrganizationsOptionsSchema, loginOptionsSchema, observeOptionsObjectSchema, observeOptionsSchema, observeDaysSchema, observeSortSchema, observeViewSchema, organizationInfoSchema, saveKeyOptionsSchema, bundleCompatibilityOptionsSchema as sdkBundleCompatibilityOptionsSchema, requestBuildOptionsSchema as sdkRequestBuildOptionsSchema, setSettingOptionsSchema, statsOrderSchema, updateAppOptionsSchema, updateChannelOptionsSchema, updateOrganizationOptionsSchema, uploadOptionsSchema, uploadResultSchema, zipBundleOptionsSchema, } from './sdk';
+export type { AccountIdOptions, AddAppOptions, AddChannelOptions, AddOrganizationOptions, AppInfo, BundleInfo, CleanupOptions, CurrentBundleOptions, DecryptBundleOptions, DeleteOldKeyOptions, DeleteOrganizationOptions, DeviceStats, DoctorOptions, EncryptBundleOptions, GenerateKeyOptions, GetStatsOptions, ListOrganizationsOptions, LoginOptions, ObserveOptions, ObserveView, OrganizationInfo, SaveKeyOptions, BundleCompatibilityOptions as SdkBundleCompatibilityOptions, RequestBuildOptions as SdkRequestBuildOptions, SDKResult, SetSettingOptions, StatsOrder, UpdateAppOptions, UpdateChannelOptions, UpdateOrganizationOptions, UploadOptions, UploadResult, ZipBundleOptions, } from './sdk';
 export { validateOptions } from './validate';

package/dist/src/schemas/sdk.d.ts

@@ -456,6 +456,77 @@ export declare const deviceStatsSchema: z.ZodObject<{
     createdAt: z.ZodString;
 }, z.core.$strip>;
 export type DeviceStats = z.infer<typeof deviceStatsSchema>;
+export declare const observeViewSchema: z.ZodEnum<{
+    device: "device";
+    events: "events";
+    summary: "summary";
+    metrics: "metrics";
+    routes: "routes";
+    versions: "versions";
+}>;
+export declare const observeSortSchema: z.ZodEnum<{
+    slowest: "slowest";
+    fastest: "fastest";
+    newest: "newest";
+    oldest: "oldest";
+}>;
+export declare const observeDaysSchema: z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<3>, z.ZodLiteral<7>, z.ZodLiteral<30>]>;
+export declare const observeOptionsObjectSchema: z.ZodObject<{
+    appId: z.ZodString;
+    view: z.ZodOptional<z.ZodEnum<{
+        device: "device";
+        events: "events";
+        summary: "summary";
+        metrics: "metrics";
+        routes: "routes";
+        versions: "versions";
+    }>>;
+    days: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<3>, z.ZodLiteral<7>, z.ZodLiteral<30>]>>;
+    action: z.ZodOptional<z.ZodString>;
+    deviceId: z.ZodOptional<z.ZodString>;
+    versionName: z.ZodOptional<z.ZodString>;
+    sort: z.ZodOptional<z.ZodEnum<{
+        slowest: "slowest";
+        fastest: "fastest";
+        newest: "newest";
+        oldest: "oldest";
+    }>>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    apikey: z.ZodOptional<z.ZodString>;
+    supaHost: z.ZodOptional<z.ZodString>;
+    supaAnon: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare function refineObserveDeviceId(value: {
+    view?: z.infer<typeof observeViewSchema>;
+    deviceId?: string;
+}, ctx: z.RefinementCtx): void;
+export declare const observeOptionsSchema: z.ZodObject<{
+    appId: z.ZodString;
+    view: z.ZodOptional<z.ZodEnum<{
+        device: "device";
+        events: "events";
+        summary: "summary";
+        metrics: "metrics";
+        routes: "routes";
+        versions: "versions";
+    }>>;
+    days: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<3>, z.ZodLiteral<7>, z.ZodLiteral<30>]>>;
+    action: z.ZodOptional<z.ZodString>;
+    deviceId: z.ZodOptional<z.ZodString>;
+    versionName: z.ZodOptional<z.ZodString>;
+    sort: z.ZodOptional<z.ZodEnum<{
+        slowest: "slowest";
+        fastest: "fastest";
+        newest: "newest";
+        oldest: "oldest";
+    }>>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    apikey: z.ZodOptional<z.ZodString>;
+    supaHost: z.ZodOptional<z.ZodString>;
+    supaAnon: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type ObserveOptions = z.infer<typeof observeOptionsSchema>;
+export type ObserveView = z.infer<typeof observeViewSchema>;
 export declare const probeOptionsSchema: z.ZodObject<{
     platform: z.ZodEnum<{
         android: "android";

package/dist/src/sdk.d.ts

@@ -4,7 +4,7 @@ import type { EncryptResult } from './bundle/encrypt';
 import type { ZipResult } from './bundle/zip';
 import type { StarAllRepositoryResult } from './github';
 import type { ProbeInternalResult } from './probe';
-import type { AccountIdOptions, AddAppOptions, AddChannelOptions, AddOrganizationOptions, AppInfo, BundleCompatibilityOptions, BundleInfo, CleanupOptions, CurrentBundleOptions, DecryptBundleOptions, DeleteOldKeyOptions, DeleteOrganizationOptions, DeviceStats, DoctorOptions, EncryptBundleOptions, GenerateKeyOptions, GetStatsOptions, ListOrganizationsOptions, LoginOptions, OrganizationInfo, ProbeOptions, RequestBuildOptions, SaveKeyOptions, SDKResult, SetSettingOptions, StarAllRepositoriesOptions, StarRepoOptions, UpdateAppOptions, UpdateChannelOptions, UpdateOrganizationOptions, UploadOptions, UploadResult, ZipBundleOptions } from './schemas/sdk';
+import type { AccountIdOptions, AddAppOptions, AddChannelOptions, AddOrganizationOptions, AppInfo, BundleCompatibilityOptions, BundleInfo, CleanupOptions, CurrentBundleOptions, DecryptBundleOptions, DeleteOldKeyOptions, DeleteOrganizationOptions, DeviceStats, DoctorOptions, EncryptBundleOptions, GenerateKeyOptions, GetStatsOptions, ListOrganizationsOptions, LoginOptions, ObserveOptions, OrganizationInfo, ProbeOptions, RequestBuildOptions, SaveKeyOptions, SDKResult, SetSettingOptions, StarAllRepositoriesOptions, StarRepoOptions, UpdateAppOptions, UpdateChannelOptions, UpdateOrganizationOptions, UploadOptions, UploadResult, ZipBundleOptions } from './schemas/sdk';
 import { getInfoInternal } from './app/info';
 import { checkCompatibilityInternal } from './bundle/compatibility';
 export type DoctorInfo = Awaited<ReturnType<typeof getInfoInternal>>;
@@ -358,6 +358,11 @@ export declare class CapgoSDK {
      * ```
      */
     getStats(options: GetStatsOptions): Promise<SDKResult<DeviceStats[]>>;
+    /**
+     * Query Capgo Observe (launch, issues, routes, device timelines).
+     * Start with view=summary; follow findings.next. Use --json / MCP for agents.
+     */
+    observe(options: ObserveOptions): Promise<SDKResult<Record<string, unknown>>>;
     setAppSetting(path: string, options: SetSettingOptions): Promise<SDKResult>;
     probe(options: ProbeOptions): Promise<SDKResult<ProbeInternalResult>>;
 }
@@ -506,6 +511,11 @@ export declare function requestBuild(options: RequestBuildOptions): Promise<SDKR
  * ```
  */
 export declare function getStats(options: GetStatsOptions): Promise<SDKResult<DeviceStats[]>>;
+/**
+ * Query Capgo Observe (functional API).
+ * Start with view=summary and follow findings.next. view=device is the session timeline.
+ */
+export declare function getObserve(options: ObserveOptions): Promise<SDKResult<Record<string, unknown>>>;
 export declare function probeUpdates(options: ProbeOptions): Promise<SDKResult<ProbeInternalResult>>;
 /**
  * Get Capacitor configuration
@@ -522,7 +532,7 @@ export declare function getCapacitorConfig(): Promise<import("./config").ExtConf
 export type { BuildCredentials } from './build/request';
 export type { CapacitorConfig } from './config';
 export type { ProbeInternalResult } from './probe';
-export type { AccountIdOptions, AddAppOptions, AddChannelOptions, AddOrganizationOptions, AppInfo, BundleCompatibilityOptions, BundleInfo, CleanupOptions, CurrentBundleOptions, DecryptBundleOptions, DeleteOldKeyOptions, DeleteOrganizationOptions, DeviceStats, DoctorOptions, EncryptBundleOptions, GenerateKeyOptions, GetStatsOptions, ListOrganizationsOptions, LoginOptions, OrganizationInfo, ProbeOptions, RequestBuildOptions, SaveKeyOptions, SDKResult, SetSettingOptions, StarAllRepositoriesOptions, StarRepoOptions, StatsOrder, UpdateAppOptions, UpdateChannelOptions, UpdateOrganizationOptions, UploadOptions, UploadResult, ZipBundleOptions, } from './schemas/sdk';
+export type { AccountIdOptions, AddAppOptions, AddChannelOptions, AddOrganizationOptions, AppInfo, BundleCompatibilityOptions, BundleInfo, CleanupOptions, CurrentBundleOptions, DecryptBundleOptions, DeleteOldKeyOptions, DeleteOrganizationOptions, DeviceStats, DoctorOptions, EncryptBundleOptions, GenerateKeyOptions, GetStatsOptions, ListOrganizationsOptions, LoginOptions, ObserveOptions, OrganizationInfo, ProbeOptions, RequestBuildOptions, SaveKeyOptions, SDKResult, SetSettingOptions, StarAllRepositoriesOptions, StarRepoOptions, StatsOrder, UpdateAppOptions, UpdateChannelOptions, UpdateOrganizationOptions, UploadOptions, UploadResult, ZipBundleOptions, } from './schemas/sdk';
 export type { Database } from './types/supabase.types';
 export { createSupabaseClient } from './utils';
 export { formatApiErrorForCli, getSecurityPolicyMessage, isSecurityPolicyError, parseSecurityPolicyError, SECURITY_POLICY_ERRORS, SECURITY_POLICY_MESSAGES, } from './utils/security_policy_errors';