@codeam/shared 2.76.34 → 2.76.36

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/dist/index.d.mts CHANGED
@@ -2481,4 +2481,98 @@ interface CompressionSavingsData {
2481
2481
  dailyTrend: CompressionSavingsDaily[];
2482
2482
  }
2483
2483
 
2484
- export { AGENT_REGISTRY, AGENT_STANDARD_BLOCK, AGENT_STANDARD_MARKER, AGENT_STANDARD_TEXT, type AgentAuth, type AgentAuthKind, type AgentId, type AgentMetadata, type AgentMode, type AgentModel, type AgentReviewFinding, type AgentReviewPlan, type AgentReviewReport, type AgentSavings, type AnswerResolvedEvent, type AwaitingAnswerEvent, type AwaitingAnswerOption, type BeadsActionCommand, type BeadsActionKind, type BeadsActionPayload, type BeadsActionRequest, type BeadsActionType, type BeadsConfigureAction, type BeadsDependencyDto, type BeadsDependencyKind, type BeadsIngestPayload, type BeadsIssueDto, type BeadsIssueStatus, type BeadsMemoryDto, type BeadsProjectDto, type BeadsProvisioningPayload, type BeadsProvisioningStatus, type BeadsSnapshotDto, type BeadsStatus, type BeadsStatusState, type BeadsStatusSummary, type BlameLineWire, type BrokeredIntegrationToken, CODER_PROMPT, type ChromeStep, type ChromeToolType, type CommitEntryWire, type ComposerAttachmentMeta, type ComposerErrorCode, type ComposerSessionContext, type ComposerStructureRequest, type ComposerStructureStreamEvent, type CompressionSavingsDaily, type CompressionSavingsData, DEFAULT_API_BASE_URL, DEFAULT_FEATURE_GATES, DEFAULT_GUARDRAIL_POLICY, DEPLOY_CHOICE_ORDER, DEP_TO_INTEGRATION, DEV_API_BASE_URL, type DeployChoice, type DerivedCredentialSource, type EnvVar, type FeatureGateKey, type FeatureGates, type FileBlameEvent, type FileChangeStatus, type FileChangedEvent, type FileHistoryEvent, type FileReviewStatus, GUARDRAIL_CATEGORIES, GUARDRAIL_CATEGORY_META, GUARDRAIL_CONFIGURE_COMMAND, GUARDRAIL_DISPOSITIONS, type GuardrailCategory, type GuardrailCategoryMeta, type GuardrailDisposition, type GuardrailPolicy, HANDOFF_FENCE_TAG, HEARTBEAT_INTERVAL_MS_DEFAULT, HOUSE_AGENT_ID, HOUSE_AGENT_NAME, HOUSE_AGENT_PROVIDER, HOUSE_AGENT_SUBTITLE, HOUSE_AGENT_VENDOR, type HandoffProposal, type HandoffResolution, type HunkLineType, INSTALL_SNIPPETS, INTEGRATION_BRANDING, INTEGRATION_REGISTRY, INTERNAL_TO_PUBLIC, type InputSuggestionChunk, type IntegrationApiKeyField, type IntegrationAuthKind, type IntegrationBranding, type IntegrationCategory, type IntegrationDefinition, type IntegrationDelivery, type IntegrationHealth, type IntegrationId, type IntegrationMcpDelivery, type IntegrationStatus, type IntegrationsManifest, type IntegrationsManifestEntry, LINKED_AGENT_IDS, type LinkedAgentId, MANAGED_AGENT_ENV, MANAGED_AGENT_SUBTITLE, MANAGED_PROVIDER_DISPLAY_NAMES, MANAGED_PROVIDER_IDS, MAX_PACK_FINDINGS, MODEL_CONTEXT_WINDOW, MODEL_PRICING, type ManagedProviderId, type MissingService, type ModelPricing, type NormalizedMessage, OBSERVER_BRIDGE_PORT, PACK_ACTION_COMMAND, PACK_FINDINGS_FILE, PACK_HANDOFF_HEADING, PACK_REGISTRY, PACK_START_COMMAND, PACK_STATUS_COMMAND, PACK_WORKFLOW_ARTICLE, PLUGIN_AGENT_STATUSES, PREVIEW_DETECT_PROMPT, PROTOCOL_VERSION, PUBLIC_TO_INTERNAL, type PackActionKind, type PackActionPayload, type PackDefinition, type PackFinding, type PackFindingResolution, type PackFindingSeverity, type PackFindingsParseResult, type PackHandoffRecord, type PackId, type PackPendingControl, type PackRunState, type PackRunStatus, type PackStageDef, type PackStageState, type PackStageStatus, type PackStartPayload, type ParsedPackFindings, type PendingReviewHunkEvent, type PendingReviewHunkLine, type PluginAgentReport, type PluginAgentStatus, type PrCheck, type PrRef, type PrReviewEntry, type PrReviewVerdict, type PreviewAgentHighlight, type PreviewDetection, type PreviewErrorCode, type PreviewErrorReason, type PreviewErrorStage, type PreviewOrigin, type PreviewScriptCandidate, type PreviewState, type PreviewStatus, type PullRequestDetail, type PullRequestSummary, QA_PROMPT, REVIEWER_PROMPT, type RemoteCommand, type RepoStack, type RepoStackDetection, SCRATCH_STARTER_PROMPTS, SCRATCH_ZIP_FREE_LIMIT_BYTES, SCRATCH_ZIP_WIFI_HINT_BYTES, SESSION_BLOCKER_KINDS, SKILL_REGISTRY, SPECIFIER_PROMPT, SQUAD_CONFIGURE_COMMAND, SQUAD_HOP_BUDGET_DEFAULT, SQUAD_HOP_BUDGET_MAX, SQUAD_HOP_BUDGET_MIN, SQUAD_SPECIALTIES, SQUAD_STATS_COMMAND, SSE_SOCKET_TIMEOUT_MS, STACK_TO_RECOMMENDED, SWITCH_AGENT_COMMAND, type ScratchExportResult, type ScratchProjectState, type ScratchSavedVia, type SelectPrompt, type SessionBlocker, type SessionBlockerKind, SessionBlockerSchema, type SkillDefinition, type SkillDelivery, type SkillFileDelivery, type SkillId, type SkillRail, type SkillsManifest, type SkillsManifestEntry, type SquadAutoConfig, type SquadConfigurePayload, type SquadConfigureResult, type SquadMemberActivity, type SquadRosterAgent, type SquadRosterData, type SquadStatsResult, type StartTaskFailedResult, type StartTaskPayload, type StarterPrompt, type StreamingChunkEvent, type StreamingChunkKind, type SwitchAgentCommand, type SwitchAgentResult, type SwitchAgentStatus, type SwitchAgentStep, TERMINAL_AGENT_PREFIX, UNKNOWN_MODEL_PRICING, UPCOMING_INTEGRATION_IDS, USER_EVENTS, type UserEventName, clampHopBudget, classifyStack, detectedIntegrationsFromDeps, extractHandoffSection, getAgent, getContextWindow, getEnabledAgents, getEnabledIntegrations, getIntegration, getIntegrationBranding, getIntegrationsByCategory, getPackDefinition, getPricing, getSkillDefinition, installableAgentIds, internalToPublic, isGuardrailDisposition, isKnownAgentId, isKnownIntegrationId, isKnownModel, isLinkedAgentId, isManagedProviderId, isNoopInstallSnippet, isPackId, isPluginAgentStatus, isSkillId, normalizeAgentId, normalizeGuardrailPolicy, orderDeployChoices, parsePackFindings, publicToInternal, recommendForDeps, renderToLines, resolveApiBaseUrl, skillHasRail, toRemoteCommand, toSessionBlocker, tryGetContextWindow };
2484
+ /**
2485
+ * "Point at it": the ONE in-page element picker, for both hosts.
2486
+ *
2487
+ * - Remix (the Worker injects it into every WEB app): `mode: 'single'` — one
2488
+ * pick, then off. Channel `'remix-point'` on field `channel`.
2489
+ * - The console Preview (the CLI's preview proxy injects it): `mode: 'multi'`
2490
+ * — up to `maxMarks` picks, each leaving a numbered mark, plus the agent's
2491
+ * highlights and the React source. Channel `'codeam-inspector'` on field
2492
+ * `source`.
2493
+ *
2494
+ * Single mode is the Remix picker as it shipped in
2495
+ * `codeagent-mobile/apps/remix-worker/src/point.ts`, behaviour for behaviour
2496
+ * (its tests run unchanged in `remix-compat.test.ts`). Multi mode keeps the
2497
+ * console inspector's wire protocol and replaces only its drawing.
2498
+ *
2499
+ * It runs inside somebody else's app, so:
2500
+ *
2501
+ * 1. Inert by default. At load it only listens for `message`; it observes,
2502
+ * paints and blocks nothing until the parent turns it on.
2503
+ * 2. Allow-listed parents. Only `allowedParents`, and only from the parent
2504
+ * window, can drive it. (The React Native door, below, is the host app
2505
+ * calling into its OWN WebView — there is no third party to filter.)
2506
+ * 3. Describes, never extracts. It reports the element the person pointed
2507
+ * at (bounded text and markup), never form values or storage.
2508
+ * 4. Fully reversible. Turning it off removes every listener and node; the
2509
+ * console's pinned marks and agent highlights go when the parent clears
2510
+ * them (`marks([])`, `agent-clear`).
2511
+ *
2512
+ * It is TEXT, not a module: its destination is the <head> of a user app. It
2513
+ * runs both as a classic script and as a `new Function('window', 'document',
2514
+ * src)` body (the Worker's tests), so it only names `window` and `document`.
2515
+ */
2516
+ interface PointPickerOptions {
2517
+ /** `'remix-point'` (Remix) | `'codeam-inspector'` (console). */
2518
+ channel: string;
2519
+ /** The message field that carries the channel: `channel` (Remix) | `source` (console). */
2520
+ channelField: 'channel' | 'source';
2521
+ /** Origins allowed to drive the picker (the pages that frame the app). */
2522
+ allowedParents: readonly string[];
2523
+ /**
2524
+ * `single`: off after one pick, acks `on`, Escape sends `cancel` (Remix).
2525
+ * `multi`: stays on, acks `ready`, reports `hover`, each pick leaves a
2526
+ * numbered mark kept in sync by `marks(ids)` (console).
2527
+ */
2528
+ mode: 'single' | 'multi';
2529
+ /** Multi mode: how many marks the page keeps (default 4, the apps' `MAX_MARKS`). */
2530
+ maxMarks?: number;
2531
+ /** Default ring accent, `#RRGGBB`; an `enable` message may override it. */
2532
+ accent?: string;
2533
+ /** Console: `agent-highlight` / `agent-clear` (the agent's cyan marks). */
2534
+ agentHighlights?: boolean;
2535
+ /** Console: React `_debugSource` (`{ file, line }`) on every described element. */
2536
+ reactSource?: boolean;
2537
+ /**
2538
+ * Console: the control API (`enable`, `disable`, `marks`, `highlight`,
2539
+ * `clear`) exposed as `window[globalName]` — only inside a React Native
2540
+ * WebView, whose host drives it with `injectJavaScript` — and messages are
2541
+ * then published over `ReactNativeWebView.postMessage` as JSON strings.
2542
+ */
2543
+ globalName?: string;
2544
+ }
2545
+ /** What a `pick` (and, in multi mode, a `hover`) carries as `element`. */
2546
+ interface PointPick {
2547
+ tag: string;
2548
+ id: string | null;
2549
+ /** The `class` attribute, squashed — a string on the wire, as both apps read it. */
2550
+ classes: string;
2551
+ selector: string;
2552
+ text: string;
2553
+ html: string;
2554
+ rect: {
2555
+ x: number;
2556
+ y: number;
2557
+ w: number;
2558
+ h: number;
2559
+ };
2560
+ /** Multi mode: the page's id for the mark this pick left (absent past `maxMarks`). */
2561
+ markId?: string;
2562
+ /** Multi mode: the page viewport the rect is measured against. */
2563
+ viewport?: {
2564
+ w: number;
2565
+ h: number;
2566
+ };
2567
+ /** `reactSource`: the component's file and line, `null` without a dev React. */
2568
+ source?: {
2569
+ file: string;
2570
+ line: number | null;
2571
+ } | null;
2572
+ }
2573
+ declare const POINT_TEXT_MAX = 120;
2574
+ declare const POINT_HTML_MAX = 600;
2575
+ /** The picker as a self-contained IIFE. Idempotent per channel (a window flag). */
2576
+ declare function pointPickerScript(opts: PointPickerOptions): string;
2577
+
2578
+ export { AGENT_REGISTRY, AGENT_STANDARD_BLOCK, AGENT_STANDARD_MARKER, AGENT_STANDARD_TEXT, type AgentAuth, type AgentAuthKind, type AgentId, type AgentMetadata, type AgentMode, type AgentModel, type AgentReviewFinding, type AgentReviewPlan, type AgentReviewReport, type AgentSavings, type AnswerResolvedEvent, type AwaitingAnswerEvent, type AwaitingAnswerOption, type BeadsActionCommand, type BeadsActionKind, type BeadsActionPayload, type BeadsActionRequest, type BeadsActionType, type BeadsConfigureAction, type BeadsDependencyDto, type BeadsDependencyKind, type BeadsIngestPayload, type BeadsIssueDto, type BeadsIssueStatus, type BeadsMemoryDto, type BeadsProjectDto, type BeadsProvisioningPayload, type BeadsProvisioningStatus, type BeadsSnapshotDto, type BeadsStatus, type BeadsStatusState, type BeadsStatusSummary, type BlameLineWire, type BrokeredIntegrationToken, CODER_PROMPT, type ChromeStep, type ChromeToolType, type CommitEntryWire, type ComposerAttachmentMeta, type ComposerErrorCode, type ComposerSessionContext, type ComposerStructureRequest, type ComposerStructureStreamEvent, type CompressionSavingsDaily, type CompressionSavingsData, DEFAULT_API_BASE_URL, DEFAULT_FEATURE_GATES, DEFAULT_GUARDRAIL_POLICY, DEPLOY_CHOICE_ORDER, DEP_TO_INTEGRATION, DEV_API_BASE_URL, type DeployChoice, type DerivedCredentialSource, type EnvVar, type FeatureGateKey, type FeatureGates, type FileBlameEvent, type FileChangeStatus, type FileChangedEvent, type FileHistoryEvent, type FileReviewStatus, GUARDRAIL_CATEGORIES, GUARDRAIL_CATEGORY_META, GUARDRAIL_CONFIGURE_COMMAND, GUARDRAIL_DISPOSITIONS, type GuardrailCategory, type GuardrailCategoryMeta, type GuardrailDisposition, type GuardrailPolicy, HANDOFF_FENCE_TAG, HEARTBEAT_INTERVAL_MS_DEFAULT, HOUSE_AGENT_ID, HOUSE_AGENT_NAME, HOUSE_AGENT_PROVIDER, HOUSE_AGENT_SUBTITLE, HOUSE_AGENT_VENDOR, type HandoffProposal, type HandoffResolution, type HunkLineType, INSTALL_SNIPPETS, INTEGRATION_BRANDING, INTEGRATION_REGISTRY, INTERNAL_TO_PUBLIC, type InputSuggestionChunk, type IntegrationApiKeyField, type IntegrationAuthKind, type IntegrationBranding, type IntegrationCategory, type IntegrationDefinition, type IntegrationDelivery, type IntegrationHealth, type IntegrationId, type IntegrationMcpDelivery, type IntegrationStatus, type IntegrationsManifest, type IntegrationsManifestEntry, LINKED_AGENT_IDS, type LinkedAgentId, MANAGED_AGENT_ENV, MANAGED_AGENT_SUBTITLE, MANAGED_PROVIDER_DISPLAY_NAMES, MANAGED_PROVIDER_IDS, MAX_PACK_FINDINGS, MODEL_CONTEXT_WINDOW, MODEL_PRICING, type ManagedProviderId, type MissingService, type ModelPricing, type NormalizedMessage, OBSERVER_BRIDGE_PORT, PACK_ACTION_COMMAND, PACK_FINDINGS_FILE, PACK_HANDOFF_HEADING, PACK_REGISTRY, PACK_START_COMMAND, PACK_STATUS_COMMAND, PACK_WORKFLOW_ARTICLE, PLUGIN_AGENT_STATUSES, POINT_HTML_MAX, POINT_TEXT_MAX, PREVIEW_DETECT_PROMPT, PROTOCOL_VERSION, PUBLIC_TO_INTERNAL, type PackActionKind, type PackActionPayload, type PackDefinition, type PackFinding, type PackFindingResolution, type PackFindingSeverity, type PackFindingsParseResult, type PackHandoffRecord, type PackId, type PackPendingControl, type PackRunState, type PackRunStatus, type PackStageDef, type PackStageState, type PackStageStatus, type PackStartPayload, type ParsedPackFindings, type PendingReviewHunkEvent, type PendingReviewHunkLine, type PluginAgentReport, type PluginAgentStatus, type PointPick, type PointPickerOptions, type PrCheck, type PrRef, type PrReviewEntry, type PrReviewVerdict, type PreviewAgentHighlight, type PreviewDetection, type PreviewErrorCode, type PreviewErrorReason, type PreviewErrorStage, type PreviewOrigin, type PreviewScriptCandidate, type PreviewState, type PreviewStatus, type PullRequestDetail, type PullRequestSummary, QA_PROMPT, REVIEWER_PROMPT, type RemoteCommand, type RepoStack, type RepoStackDetection, SCRATCH_STARTER_PROMPTS, SCRATCH_ZIP_FREE_LIMIT_BYTES, SCRATCH_ZIP_WIFI_HINT_BYTES, SESSION_BLOCKER_KINDS, SKILL_REGISTRY, SPECIFIER_PROMPT, SQUAD_CONFIGURE_COMMAND, SQUAD_HOP_BUDGET_DEFAULT, SQUAD_HOP_BUDGET_MAX, SQUAD_HOP_BUDGET_MIN, SQUAD_SPECIALTIES, SQUAD_STATS_COMMAND, SSE_SOCKET_TIMEOUT_MS, STACK_TO_RECOMMENDED, SWITCH_AGENT_COMMAND, type ScratchExportResult, type ScratchProjectState, type ScratchSavedVia, type SelectPrompt, type SessionBlocker, type SessionBlockerKind, SessionBlockerSchema, type SkillDefinition, type SkillDelivery, type SkillFileDelivery, type SkillId, type SkillRail, type SkillsManifest, type SkillsManifestEntry, type SquadAutoConfig, type SquadConfigurePayload, type SquadConfigureResult, type SquadMemberActivity, type SquadRosterAgent, type SquadRosterData, type SquadStatsResult, type StartTaskFailedResult, type StartTaskPayload, type StarterPrompt, type StreamingChunkEvent, type StreamingChunkKind, type SwitchAgentCommand, type SwitchAgentResult, type SwitchAgentStatus, type SwitchAgentStep, TERMINAL_AGENT_PREFIX, UNKNOWN_MODEL_PRICING, UPCOMING_INTEGRATION_IDS, USER_EVENTS, type UserEventName, clampHopBudget, classifyStack, detectedIntegrationsFromDeps, extractHandoffSection, getAgent, getContextWindow, getEnabledAgents, getEnabledIntegrations, getIntegration, getIntegrationBranding, getIntegrationsByCategory, getPackDefinition, getPricing, getSkillDefinition, installableAgentIds, internalToPublic, isGuardrailDisposition, isKnownAgentId, isKnownIntegrationId, isKnownModel, isLinkedAgentId, isManagedProviderId, isNoopInstallSnippet, isPackId, isPluginAgentStatus, isSkillId, normalizeAgentId, normalizeGuardrailPolicy, orderDeployChoices, parsePackFindings, pointPickerScript, publicToInternal, recommendForDeps, renderToLines, resolveApiBaseUrl, skillHasRail, toRemoteCommand, toSessionBlocker, tryGetContextWindow };
package/dist/index.d.ts CHANGED
@@ -2481,4 +2481,98 @@ interface CompressionSavingsData {
2481
2481
  dailyTrend: CompressionSavingsDaily[];
2482
2482
  }
2483
2483
 
2484
- export { AGENT_REGISTRY, AGENT_STANDARD_BLOCK, AGENT_STANDARD_MARKER, AGENT_STANDARD_TEXT, type AgentAuth, type AgentAuthKind, type AgentId, type AgentMetadata, type AgentMode, type AgentModel, type AgentReviewFinding, type AgentReviewPlan, type AgentReviewReport, type AgentSavings, type AnswerResolvedEvent, type AwaitingAnswerEvent, type AwaitingAnswerOption, type BeadsActionCommand, type BeadsActionKind, type BeadsActionPayload, type BeadsActionRequest, type BeadsActionType, type BeadsConfigureAction, type BeadsDependencyDto, type BeadsDependencyKind, type BeadsIngestPayload, type BeadsIssueDto, type BeadsIssueStatus, type BeadsMemoryDto, type BeadsProjectDto, type BeadsProvisioningPayload, type BeadsProvisioningStatus, type BeadsSnapshotDto, type BeadsStatus, type BeadsStatusState, type BeadsStatusSummary, type BlameLineWire, type BrokeredIntegrationToken, CODER_PROMPT, type ChromeStep, type ChromeToolType, type CommitEntryWire, type ComposerAttachmentMeta, type ComposerErrorCode, type ComposerSessionContext, type ComposerStructureRequest, type ComposerStructureStreamEvent, type CompressionSavingsDaily, type CompressionSavingsData, DEFAULT_API_BASE_URL, DEFAULT_FEATURE_GATES, DEFAULT_GUARDRAIL_POLICY, DEPLOY_CHOICE_ORDER, DEP_TO_INTEGRATION, DEV_API_BASE_URL, type DeployChoice, type DerivedCredentialSource, type EnvVar, type FeatureGateKey, type FeatureGates, type FileBlameEvent, type FileChangeStatus, type FileChangedEvent, type FileHistoryEvent, type FileReviewStatus, GUARDRAIL_CATEGORIES, GUARDRAIL_CATEGORY_META, GUARDRAIL_CONFIGURE_COMMAND, GUARDRAIL_DISPOSITIONS, type GuardrailCategory, type GuardrailCategoryMeta, type GuardrailDisposition, type GuardrailPolicy, HANDOFF_FENCE_TAG, HEARTBEAT_INTERVAL_MS_DEFAULT, HOUSE_AGENT_ID, HOUSE_AGENT_NAME, HOUSE_AGENT_PROVIDER, HOUSE_AGENT_SUBTITLE, HOUSE_AGENT_VENDOR, type HandoffProposal, type HandoffResolution, type HunkLineType, INSTALL_SNIPPETS, INTEGRATION_BRANDING, INTEGRATION_REGISTRY, INTERNAL_TO_PUBLIC, type InputSuggestionChunk, type IntegrationApiKeyField, type IntegrationAuthKind, type IntegrationBranding, type IntegrationCategory, type IntegrationDefinition, type IntegrationDelivery, type IntegrationHealth, type IntegrationId, type IntegrationMcpDelivery, type IntegrationStatus, type IntegrationsManifest, type IntegrationsManifestEntry, LINKED_AGENT_IDS, type LinkedAgentId, MANAGED_AGENT_ENV, MANAGED_AGENT_SUBTITLE, MANAGED_PROVIDER_DISPLAY_NAMES, MANAGED_PROVIDER_IDS, MAX_PACK_FINDINGS, MODEL_CONTEXT_WINDOW, MODEL_PRICING, type ManagedProviderId, type MissingService, type ModelPricing, type NormalizedMessage, OBSERVER_BRIDGE_PORT, PACK_ACTION_COMMAND, PACK_FINDINGS_FILE, PACK_HANDOFF_HEADING, PACK_REGISTRY, PACK_START_COMMAND, PACK_STATUS_COMMAND, PACK_WORKFLOW_ARTICLE, PLUGIN_AGENT_STATUSES, PREVIEW_DETECT_PROMPT, PROTOCOL_VERSION, PUBLIC_TO_INTERNAL, type PackActionKind, type PackActionPayload, type PackDefinition, type PackFinding, type PackFindingResolution, type PackFindingSeverity, type PackFindingsParseResult, type PackHandoffRecord, type PackId, type PackPendingControl, type PackRunState, type PackRunStatus, type PackStageDef, type PackStageState, type PackStageStatus, type PackStartPayload, type ParsedPackFindings, type PendingReviewHunkEvent, type PendingReviewHunkLine, type PluginAgentReport, type PluginAgentStatus, type PrCheck, type PrRef, type PrReviewEntry, type PrReviewVerdict, type PreviewAgentHighlight, type PreviewDetection, type PreviewErrorCode, type PreviewErrorReason, type PreviewErrorStage, type PreviewOrigin, type PreviewScriptCandidate, type PreviewState, type PreviewStatus, type PullRequestDetail, type PullRequestSummary, QA_PROMPT, REVIEWER_PROMPT, type RemoteCommand, type RepoStack, type RepoStackDetection, SCRATCH_STARTER_PROMPTS, SCRATCH_ZIP_FREE_LIMIT_BYTES, SCRATCH_ZIP_WIFI_HINT_BYTES, SESSION_BLOCKER_KINDS, SKILL_REGISTRY, SPECIFIER_PROMPT, SQUAD_CONFIGURE_COMMAND, SQUAD_HOP_BUDGET_DEFAULT, SQUAD_HOP_BUDGET_MAX, SQUAD_HOP_BUDGET_MIN, SQUAD_SPECIALTIES, SQUAD_STATS_COMMAND, SSE_SOCKET_TIMEOUT_MS, STACK_TO_RECOMMENDED, SWITCH_AGENT_COMMAND, type ScratchExportResult, type ScratchProjectState, type ScratchSavedVia, type SelectPrompt, type SessionBlocker, type SessionBlockerKind, SessionBlockerSchema, type SkillDefinition, type SkillDelivery, type SkillFileDelivery, type SkillId, type SkillRail, type SkillsManifest, type SkillsManifestEntry, type SquadAutoConfig, type SquadConfigurePayload, type SquadConfigureResult, type SquadMemberActivity, type SquadRosterAgent, type SquadRosterData, type SquadStatsResult, type StartTaskFailedResult, type StartTaskPayload, type StarterPrompt, type StreamingChunkEvent, type StreamingChunkKind, type SwitchAgentCommand, type SwitchAgentResult, type SwitchAgentStatus, type SwitchAgentStep, TERMINAL_AGENT_PREFIX, UNKNOWN_MODEL_PRICING, UPCOMING_INTEGRATION_IDS, USER_EVENTS, type UserEventName, clampHopBudget, classifyStack, detectedIntegrationsFromDeps, extractHandoffSection, getAgent, getContextWindow, getEnabledAgents, getEnabledIntegrations, getIntegration, getIntegrationBranding, getIntegrationsByCategory, getPackDefinition, getPricing, getSkillDefinition, installableAgentIds, internalToPublic, isGuardrailDisposition, isKnownAgentId, isKnownIntegrationId, isKnownModel, isLinkedAgentId, isManagedProviderId, isNoopInstallSnippet, isPackId, isPluginAgentStatus, isSkillId, normalizeAgentId, normalizeGuardrailPolicy, orderDeployChoices, parsePackFindings, publicToInternal, recommendForDeps, renderToLines, resolveApiBaseUrl, skillHasRail, toRemoteCommand, toSessionBlocker, tryGetContextWindow };
2484
+ /**
2485
+ * "Point at it": the ONE in-page element picker, for both hosts.
2486
+ *
2487
+ * - Remix (the Worker injects it into every WEB app): `mode: 'single'` — one
2488
+ * pick, then off. Channel `'remix-point'` on field `channel`.
2489
+ * - The console Preview (the CLI's preview proxy injects it): `mode: 'multi'`
2490
+ * — up to `maxMarks` picks, each leaving a numbered mark, plus the agent's
2491
+ * highlights and the React source. Channel `'codeam-inspector'` on field
2492
+ * `source`.
2493
+ *
2494
+ * Single mode is the Remix picker as it shipped in
2495
+ * `codeagent-mobile/apps/remix-worker/src/point.ts`, behaviour for behaviour
2496
+ * (its tests run unchanged in `remix-compat.test.ts`). Multi mode keeps the
2497
+ * console inspector's wire protocol and replaces only its drawing.
2498
+ *
2499
+ * It runs inside somebody else's app, so:
2500
+ *
2501
+ * 1. Inert by default. At load it only listens for `message`; it observes,
2502
+ * paints and blocks nothing until the parent turns it on.
2503
+ * 2. Allow-listed parents. Only `allowedParents`, and only from the parent
2504
+ * window, can drive it. (The React Native door, below, is the host app
2505
+ * calling into its OWN WebView — there is no third party to filter.)
2506
+ * 3. Describes, never extracts. It reports the element the person pointed
2507
+ * at (bounded text and markup), never form values or storage.
2508
+ * 4. Fully reversible. Turning it off removes every listener and node; the
2509
+ * console's pinned marks and agent highlights go when the parent clears
2510
+ * them (`marks([])`, `agent-clear`).
2511
+ *
2512
+ * It is TEXT, not a module: its destination is the <head> of a user app. It
2513
+ * runs both as a classic script and as a `new Function('window', 'document',
2514
+ * src)` body (the Worker's tests), so it only names `window` and `document`.
2515
+ */
2516
+ interface PointPickerOptions {
2517
+ /** `'remix-point'` (Remix) | `'codeam-inspector'` (console). */
2518
+ channel: string;
2519
+ /** The message field that carries the channel: `channel` (Remix) | `source` (console). */
2520
+ channelField: 'channel' | 'source';
2521
+ /** Origins allowed to drive the picker (the pages that frame the app). */
2522
+ allowedParents: readonly string[];
2523
+ /**
2524
+ * `single`: off after one pick, acks `on`, Escape sends `cancel` (Remix).
2525
+ * `multi`: stays on, acks `ready`, reports `hover`, each pick leaves a
2526
+ * numbered mark kept in sync by `marks(ids)` (console).
2527
+ */
2528
+ mode: 'single' | 'multi';
2529
+ /** Multi mode: how many marks the page keeps (default 4, the apps' `MAX_MARKS`). */
2530
+ maxMarks?: number;
2531
+ /** Default ring accent, `#RRGGBB`; an `enable` message may override it. */
2532
+ accent?: string;
2533
+ /** Console: `agent-highlight` / `agent-clear` (the agent's cyan marks). */
2534
+ agentHighlights?: boolean;
2535
+ /** Console: React `_debugSource` (`{ file, line }`) on every described element. */
2536
+ reactSource?: boolean;
2537
+ /**
2538
+ * Console: the control API (`enable`, `disable`, `marks`, `highlight`,
2539
+ * `clear`) exposed as `window[globalName]` — only inside a React Native
2540
+ * WebView, whose host drives it with `injectJavaScript` — and messages are
2541
+ * then published over `ReactNativeWebView.postMessage` as JSON strings.
2542
+ */
2543
+ globalName?: string;
2544
+ }
2545
+ /** What a `pick` (and, in multi mode, a `hover`) carries as `element`. */
2546
+ interface PointPick {
2547
+ tag: string;
2548
+ id: string | null;
2549
+ /** The `class` attribute, squashed — a string on the wire, as both apps read it. */
2550
+ classes: string;
2551
+ selector: string;
2552
+ text: string;
2553
+ html: string;
2554
+ rect: {
2555
+ x: number;
2556
+ y: number;
2557
+ w: number;
2558
+ h: number;
2559
+ };
2560
+ /** Multi mode: the page's id for the mark this pick left (absent past `maxMarks`). */
2561
+ markId?: string;
2562
+ /** Multi mode: the page viewport the rect is measured against. */
2563
+ viewport?: {
2564
+ w: number;
2565
+ h: number;
2566
+ };
2567
+ /** `reactSource`: the component's file and line, `null` without a dev React. */
2568
+ source?: {
2569
+ file: string;
2570
+ line: number | null;
2571
+ } | null;
2572
+ }
2573
+ declare const POINT_TEXT_MAX = 120;
2574
+ declare const POINT_HTML_MAX = 600;
2575
+ /** The picker as a self-contained IIFE. Idempotent per channel (a window flag). */
2576
+ declare function pointPickerScript(opts: PointPickerOptions): string;
2577
+
2578
+ export { AGENT_REGISTRY, AGENT_STANDARD_BLOCK, AGENT_STANDARD_MARKER, AGENT_STANDARD_TEXT, type AgentAuth, type AgentAuthKind, type AgentId, type AgentMetadata, type AgentMode, type AgentModel, type AgentReviewFinding, type AgentReviewPlan, type AgentReviewReport, type AgentSavings, type AnswerResolvedEvent, type AwaitingAnswerEvent, type AwaitingAnswerOption, type BeadsActionCommand, type BeadsActionKind, type BeadsActionPayload, type BeadsActionRequest, type BeadsActionType, type BeadsConfigureAction, type BeadsDependencyDto, type BeadsDependencyKind, type BeadsIngestPayload, type BeadsIssueDto, type BeadsIssueStatus, type BeadsMemoryDto, type BeadsProjectDto, type BeadsProvisioningPayload, type BeadsProvisioningStatus, type BeadsSnapshotDto, type BeadsStatus, type BeadsStatusState, type BeadsStatusSummary, type BlameLineWire, type BrokeredIntegrationToken, CODER_PROMPT, type ChromeStep, type ChromeToolType, type CommitEntryWire, type ComposerAttachmentMeta, type ComposerErrorCode, type ComposerSessionContext, type ComposerStructureRequest, type ComposerStructureStreamEvent, type CompressionSavingsDaily, type CompressionSavingsData, DEFAULT_API_BASE_URL, DEFAULT_FEATURE_GATES, DEFAULT_GUARDRAIL_POLICY, DEPLOY_CHOICE_ORDER, DEP_TO_INTEGRATION, DEV_API_BASE_URL, type DeployChoice, type DerivedCredentialSource, type EnvVar, type FeatureGateKey, type FeatureGates, type FileBlameEvent, type FileChangeStatus, type FileChangedEvent, type FileHistoryEvent, type FileReviewStatus, GUARDRAIL_CATEGORIES, GUARDRAIL_CATEGORY_META, GUARDRAIL_CONFIGURE_COMMAND, GUARDRAIL_DISPOSITIONS, type GuardrailCategory, type GuardrailCategoryMeta, type GuardrailDisposition, type GuardrailPolicy, HANDOFF_FENCE_TAG, HEARTBEAT_INTERVAL_MS_DEFAULT, HOUSE_AGENT_ID, HOUSE_AGENT_NAME, HOUSE_AGENT_PROVIDER, HOUSE_AGENT_SUBTITLE, HOUSE_AGENT_VENDOR, type HandoffProposal, type HandoffResolution, type HunkLineType, INSTALL_SNIPPETS, INTEGRATION_BRANDING, INTEGRATION_REGISTRY, INTERNAL_TO_PUBLIC, type InputSuggestionChunk, type IntegrationApiKeyField, type IntegrationAuthKind, type IntegrationBranding, type IntegrationCategory, type IntegrationDefinition, type IntegrationDelivery, type IntegrationHealth, type IntegrationId, type IntegrationMcpDelivery, type IntegrationStatus, type IntegrationsManifest, type IntegrationsManifestEntry, LINKED_AGENT_IDS, type LinkedAgentId, MANAGED_AGENT_ENV, MANAGED_AGENT_SUBTITLE, MANAGED_PROVIDER_DISPLAY_NAMES, MANAGED_PROVIDER_IDS, MAX_PACK_FINDINGS, MODEL_CONTEXT_WINDOW, MODEL_PRICING, type ManagedProviderId, type MissingService, type ModelPricing, type NormalizedMessage, OBSERVER_BRIDGE_PORT, PACK_ACTION_COMMAND, PACK_FINDINGS_FILE, PACK_HANDOFF_HEADING, PACK_REGISTRY, PACK_START_COMMAND, PACK_STATUS_COMMAND, PACK_WORKFLOW_ARTICLE, PLUGIN_AGENT_STATUSES, POINT_HTML_MAX, POINT_TEXT_MAX, PREVIEW_DETECT_PROMPT, PROTOCOL_VERSION, PUBLIC_TO_INTERNAL, type PackActionKind, type PackActionPayload, type PackDefinition, type PackFinding, type PackFindingResolution, type PackFindingSeverity, type PackFindingsParseResult, type PackHandoffRecord, type PackId, type PackPendingControl, type PackRunState, type PackRunStatus, type PackStageDef, type PackStageState, type PackStageStatus, type PackStartPayload, type ParsedPackFindings, type PendingReviewHunkEvent, type PendingReviewHunkLine, type PluginAgentReport, type PluginAgentStatus, type PointPick, type PointPickerOptions, type PrCheck, type PrRef, type PrReviewEntry, type PrReviewVerdict, type PreviewAgentHighlight, type PreviewDetection, type PreviewErrorCode, type PreviewErrorReason, type PreviewErrorStage, type PreviewOrigin, type PreviewScriptCandidate, type PreviewState, type PreviewStatus, type PullRequestDetail, type PullRequestSummary, QA_PROMPT, REVIEWER_PROMPT, type RemoteCommand, type RepoStack, type RepoStackDetection, SCRATCH_STARTER_PROMPTS, SCRATCH_ZIP_FREE_LIMIT_BYTES, SCRATCH_ZIP_WIFI_HINT_BYTES, SESSION_BLOCKER_KINDS, SKILL_REGISTRY, SPECIFIER_PROMPT, SQUAD_CONFIGURE_COMMAND, SQUAD_HOP_BUDGET_DEFAULT, SQUAD_HOP_BUDGET_MAX, SQUAD_HOP_BUDGET_MIN, SQUAD_SPECIALTIES, SQUAD_STATS_COMMAND, SSE_SOCKET_TIMEOUT_MS, STACK_TO_RECOMMENDED, SWITCH_AGENT_COMMAND, type ScratchExportResult, type ScratchProjectState, type ScratchSavedVia, type SelectPrompt, type SessionBlocker, type SessionBlockerKind, SessionBlockerSchema, type SkillDefinition, type SkillDelivery, type SkillFileDelivery, type SkillId, type SkillRail, type SkillsManifest, type SkillsManifestEntry, type SquadAutoConfig, type SquadConfigurePayload, type SquadConfigureResult, type SquadMemberActivity, type SquadRosterAgent, type SquadRosterData, type SquadStatsResult, type StartTaskFailedResult, type StartTaskPayload, type StarterPrompt, type StreamingChunkEvent, type StreamingChunkKind, type SwitchAgentCommand, type SwitchAgentResult, type SwitchAgentStatus, type SwitchAgentStep, TERMINAL_AGENT_PREFIX, UNKNOWN_MODEL_PRICING, UPCOMING_INTEGRATION_IDS, USER_EVENTS, type UserEventName, clampHopBudget, classifyStack, detectedIntegrationsFromDeps, extractHandoffSection, getAgent, getContextWindow, getEnabledAgents, getEnabledIntegrations, getIntegration, getIntegrationBranding, getIntegrationsByCategory, getPackDefinition, getPricing, getSkillDefinition, installableAgentIds, internalToPublic, isGuardrailDisposition, isKnownAgentId, isKnownIntegrationId, isKnownModel, isLinkedAgentId, isManagedProviderId, isNoopInstallSnippet, isPackId, isPluginAgentStatus, isSkillId, normalizeAgentId, normalizeGuardrailPolicy, orderDeployChoices, parsePackFindings, pointPickerScript, publicToInternal, recommendForDeps, renderToLines, resolveApiBaseUrl, skillHasRail, toRemoteCommand, toSessionBlocker, tryGetContextWindow };