@walkeros/cli 4.7.0-next-1790722899482 → 4.7.0

package/dist/index.d.ts

@@ -102,8 +102,9 @@ interface BuildOptions extends CLIBuildOptions {
      */
     minifyOptions?: MinifyOptions;
     /**
-     * Window property name for collector (web platform only).
-     * @default "collector"
+     * Window property name for collector (web platform only). Set from the
+     * flow's `config.settings.windowCollector`.
+     * @default "walkerOS"
      */
     windowCollector?: string;
     /**
@@ -267,7 +268,7 @@ interface BundleCommandOptions {
     cache?: boolean;
     verbose?: boolean;
     silent?: boolean;
-    /** Config release id baked into config.collector.release (set-if-absent). */
+    /** Release id baked into config.collector.release. Beats an authored one. */
     release?: string;
 }
 declare function bundleCommand(options: BundleCommandOptions): Promise<void>;
@@ -313,8 +314,9 @@ declare function bundle(configOrPath: unknown, options?: {
     cache?: boolean;
     flowName?: string;
     /**
-     * Config release id baked into `config.collector.release` (set-if-absent),
-     * stamping this flow's entry in `event.source.release` at runtime.
+     * Release id baked into `config.collector.release`, stamping this flow's
+     * entry in `event.source.release` at runtime. Beats an authored release;
+     * omitted, the release is a content id of config, packages and CLI.
      */
     release?: string;
     /**
@@ -727,6 +729,8 @@ declare const ValidateOptionsSchema: z.ZodObject<{
     flow: z.ZodOptional<z.ZodString>;
     path: z.ZodOptional<z.ZodString>;
     strict: z.ZodOptional<z.ZodBoolean>;
+    offline: z.ZodOptional<z.ZodBoolean>;
+    configDir: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 type ValidateOptions = z.infer<typeof ValidateOptionsSchema>;
 
@@ -734,14 +738,14 @@ type ValidateOptions = z.infer<typeof ValidateOptionsSchema>;
  * Every code an error, warning or skip of `validate` can carry. Agents and
  * tests branch on these, never on message text.
  */
-declare const VALIDATE_CODES: readonly ["INPUT_ERROR", "SERIALIZATION_ERROR", "OPTION_NOT_APPLICABLE", "FLOW_NOT_FOUND", "ENTRY_NOT_FOUND", "AMBIGUOUS_ENTRY", "UNSUPPORTED_SECTION", "INVALID_PATH", "SCHEMA_VALIDATION", "CONFIG_WARNING", "EMPTY_FLOWS", "UNKNOWN_KEY", "CONFLICT", "MISSING_PACKAGE", "OBSOLETE_CODE_STRING", "INVALID_IMPORT", "INVALID_CODE_SHAPE", "PACKAGE_VERSION_MISSING", "DEPRECATED_PACKAGE", "UNKNOWN_ROUTE_TARGET", "ROUTE_DEAD_CODE", "ROUTE_EMPTY_MANY", "ROUTE_SINGLE_MANY", "ROUTE_FIRST_MATCH", "INCOMPATIBLE_EXAMPLES", "EXAMPLES_INCOMPLETE", "CONTRACT_VIOLATION", "MAPPING_DOT_KEY", "FLOW_REF_WARNING", "FLOW_CYCLE", "ENTRY_SCHEMA", "INVALID_CONTRACT", "FLAT_CONTRACT_SHAPE", "INVALID_CONTRACT_ENTRY", "UNKNOWN_CONTRACT_KEY", "INVALID_TAGGING", "INVALID_SCHEMA", "INVALID_EXTENDS", "INVALID_SECTION", "INVALID_EVENTS", "CIRCULAR_EXTENDS", "INVALID_ENTITY_KEY", "INVALID_ENTITY", "INVALID_ACTION_KEY", "INVALID_SCHEMA_ENTRY", "NOT_AN_OBJECT", "MISSING_EVENT_NAME", "EMPTY_EVENT_NAME", "INVALID_EVENT_NAME", "INVALID_MAPPING_TYPE", "INVALID_EVENT_PATTERN", "INVALID_RULE_TYPE", "CATCH_ALL_NOT_LAST", "GATED_BY_ERRORS", "NO_PACKAGE", "NO_SETTINGS_SCHEMA", "SCHEMA_UNAVAILABLE"];
+declare const VALIDATE_CODES: readonly ["INPUT_ERROR", "SERIALIZATION_ERROR", "OPTION_NOT_APPLICABLE", "FLOW_NOT_FOUND", "ENTRY_NOT_FOUND", "AMBIGUOUS_ENTRY", "UNSUPPORTED_SECTION", "INVALID_PATH", "SCHEMA_VALIDATION", "CONFIG_WARNING", "EMPTY_FLOWS", "UNKNOWN_KEY", "CONFLICT", "MISSING_PACKAGE", "OBSOLETE_CODE_STRING", "INVALID_IMPORT", "INVALID_CODE_SHAPE", "PACKAGE_VERSION_MISSING", "DEPRECATED_PACKAGE", "UNKNOWN_ROUTE_TARGET", "ROUTE_DEAD_CODE", "ROUTE_EMPTY_MANY", "ROUTE_SINGLE_MANY", "ROUTE_FIRST_MATCH", "INCOMPATIBLE_EXAMPLES", "EXAMPLES_INCOMPLETE", "CONTRACT_VIOLATION", "MAPPING_DOT_KEY", "FLOW_REF_WARNING", "FLOW_CYCLE", "VAR_CYCLE", "INVALID_COMPONENT_NAME", "INVALID_REFERENCE", "STORE_REFERENCE_NOT_FOUND", "UNRESOLVED_REFERENCE", "MISSING_ENV", "WEB_SECRET_REF", "UNRESOLVED_CONTRACT", "ENTRY_SCHEMA", "NO_CONTRACT_SECTION", "INVALID_CONTRACT", "FLAT_CONTRACT_SHAPE", "INVALID_CONTRACT_ENTRY", "UNKNOWN_CONTRACT_KEY", "INVALID_TAGGING", "INVALID_SCHEMA", "INVALID_EXTENDS", "INVALID_SECTION", "INVALID_EVENTS", "CIRCULAR_EXTENDS", "INVALID_ENTITY_KEY", "INVALID_ENTITY", "INVALID_ACTION_KEY", "INVALID_SCHEMA_ENTRY", "NOT_AN_OBJECT", "MISSING_EVENT_NAME", "EMPTY_EVENT_NAME", "INVALID_EVENT_NAME", "INVALID_MAPPING_TYPE", "INVALID_EVENT_PATTERN", "INVALID_RULE_TYPE", "CATCH_ALL_NOT_LAST", "GATED_BY_ERRORS", "CONTRACT_NOT_STATIC", "NO_PACKAGE", "NO_SETTINGS_SCHEMA", "SCHEMA_UNAVAILABLE"];
 type ValidateCode = (typeof VALIDATE_CODES)[number];
 /**
  * Named checks a run includes (`details.scope.checks`). `file:` checks run
  * on the whole file whatever `--flow` says; `flow:` checks run per flow in
  * scope; `entry:` checks run per entry `--path` addressed.
  */
-type ValidateCheck = 'file:schema' | 'flow:schema' | 'flow:steps' | 'flow:package-versions' | 'flow:routes' | 'flow:examples' | 'flow:contract-examples' | 'flow:mapping-keys' | 'flow:flow-refs' | 'entry:settings' | 'contract' | 'event' | 'mapping';
+type ValidateCheck = 'file:schema' | 'file:contract' | 'flow:schema' | 'flow:steps' | 'flow:structure' | 'flow:package-versions' | 'flow:routes' | 'flow:examples' | 'flow:contract-examples' | 'flow:mapping-keys' | 'flow:resolve' | 'flow:package-settings' | 'entry:settings' | 'contract' | 'event' | 'mapping';
 interface ValidateScopeEntry {
     /** Section of the addressed entry, when the path or the match names one. */
     section?: string;
@@ -756,6 +760,8 @@ interface ValidateScope {
     flows: string[];
     entry?: ValidateScopeEntry;
     checks: ValidateCheck[];
+    /** Set when `offline` removed the package settings check from `checks`. */
+    offline?: true;
 }
 /** A check the scope includes that did not run (C5). */
 interface ValidateSkip {
@@ -796,6 +802,8 @@ interface ValidateCommandOptions {
     json?: boolean;
     verbose?: boolean;
     strict?: boolean;
+    /** Skip every package settings check (no network); named in the scope. */
+    offline?: boolean;
     silent?: boolean;
 }
 
@@ -15408,11 +15416,11 @@ declare const BuildResultSchema: z.ZodObject<{
     }, z.core.$strip>>;
     error: z.ZodOptional<z.ZodObject<{
         code: z.ZodEnum<{
+            WEB_SECRET_REF: "WEB_SECRET_REF";
             INVALID_MANIFEST: "INVALID_MANIFEST";
             TOOLCHAIN_MISMATCH: "TOOLCHAIN_MISMATCH";
             INVALID_CONFIG: "INVALID_CONFIG";
             MISSING_BUILD_ENV: "MISSING_BUILD_ENV";
-            WEB_SECRET_REF: "WEB_SECRET_REF";
             UNSUPPORTED_PACKAGE_SPEC: "UNSUPPORTED_PACKAGE_SPEC";
             LOCAL_PATH_NOT_ALLOWED: "LOCAL_PATH_NOT_ALLOWED";
             BUILD_FAILED: "BUILD_FAILED";
@@ -15424,6 +15432,26 @@ declare const BuildResultSchema: z.ZodObject<{
 }, z.core.$strip>;
 type BuildResult = z.infer<typeof BuildResultSchema>;
 
+/**
+ * One retry policy for every network call of a manifest build: the manifest
+ * download, a skeleton download and each PUT. A transient failure (the fetch
+ * rejects, times out, or answers 5xx or 429) is retried; any other status
+ * fails at once, since an expired or wrong presign never heals.
+ *
+ * Messages never carry the URL, its query or a header value: presigned
+ * credentials live there.
+ */
+interface FetchRetryOptions {
+    /** Names the call in warnings and errors, e.g. `Manifest download`. */
+    label: string;
+    /** Per-attempt timeout; each attempt gets a fresh signal. */
+    timeoutMs: number;
+    /** Called once per retry with a ready-to-print line. */
+    warn?: (message: string) => void;
+    /** Injectable for tests. */
+    sleep?: (ms: number) => Promise<void>;
+}
+
 /**
  * `walkeros bundle --manifest <source>`: build from a manifest.
  *
@@ -15439,6 +15467,8 @@ type BuildResult = z.infer<typeof BuildResultSchema>;
 
 /** Env var a bare `--manifest` reads its source from. */
 declare const BUILD_MANIFEST_ENV = "BUILD_MANIFEST_URL";
+/** Retry hooks for the build's network calls; see `fetchWithRetry`. */
+type BuildRetryOptions = Pick<FetchRetryOptions, 'warn' | 'sleep'>;
 interface RunBuildManifestResult {
     result: BuildResult;
     /** False when the result could not be PUT (or the manifest was unreadable). */
@@ -15447,8 +15477,10 @@ interface RunBuildManifestResult {
 /**
  * Run a manifest build end to end. Never throws: every failure becomes a
  * result, and `reported` says whether that result reached `resultPutUrl`.
+ * Each download and upload retries transient failures; `retry.warn` hears
+ * about every retry.
  */
-declare function runBuildManifest(source: string): Promise<RunBuildManifestResult>;
+declare function runBuildManifest(source: string, retry?: BuildRetryOptions): Promise<RunBuildManifestResult>;
 /** Resolve the `--manifest` value, falling back to the env for a bare flag. */
 declare function resolveManifestSource(manifest: string | true, env?: Record<string, string | undefined>): string;
 
@@ -16026,14 +16058,6 @@ declare function loadJsonConfig<T>(configPath: string): Promise<T>;
  * value is masked whatever its shape.
  */
 declare function collectKnownSecrets(flow: Flow.Json, env?: NodeJS.ProcessEnv): string[];
-/**
- * A deep copy of `value` in which every number whose printed form contains a
- * known secret (6+ characters, e.g. `12345678`, `-1234567`, `1234567.5`)
- * becomes `'***'`. Masking such a number inside serialized JSON would leave an
- * unquoted `***` and break the JSON, so it runs on the value before
- * `JSON.stringify`; the text scrub still runs on the serialized result.
- */
-declare function maskKnownNumbers(value: unknown, known: readonly string[]): unknown;
 
 /**
  * Shared resolver for the export name to import from a flow component's
@@ -16252,4 +16276,4 @@ declare module '@walkeros/core' {
     }
 }
 
-export { type AddThreadMessageOptions, ApiError, type ApiErrorDetail, BUILD_ERROR_CODES, BUILD_MANIFEST_ENV, BUILD_MANIFEST_VERSION, type BuildArtifact, BuildArtifactSchema, BuildBundleArtifactSchema, type BuildErrorCode, type BuildManifest, BuildManifestSchema, type BuildOptions, type BuildResult, BuildResultSchema, BuildWrapArtifactSchema, type BuildWrapOptions, BuildWrapOptionsSchema, type BundleStats, type CLIBuildOptions, type ClientContext, type ClientType, type CompareContractInput, type CompleteDeviceLoginOptions, type ContractComparison, type ContractVerdict, type CreatePreviewOptions, type CreateSecretOptions, type CreateThreadOptions, type DeletePreviewOptions, type DeleteSecretOptions, type DeployOptions, DeploymentAmbiguityError, type DeploymentSummaryForFlow, type DeviceAuthorization, type DeviceLoginResult, type EndObserveSessionOptions, type FeedbackOptions, type GetFrameOptions, type GetObserveSessionOptions, type GetPreviewOptions, type GetReleaseOptions, type GlobalOptions, type HealthResult, type ListDeploymentsOptions, type ListFlowsOptions, type ListFramesOptions, type ListJourneysOptions, type ListKnowledgeOptions, type ListPageFramesOptions, type ListPreviewsOptions, type ListProjectsOptions, type ListReleasesOptions, type ListSecretsOptions, type ListStepHistoryOptions, type ListThreadsOptions, type LoginOptions, type LoginResult, type MinifyOptions, type PrepareInput, type PreparedFlow, type ProjectFlows, type PushResult, type RegrantPreviewOptions, type ReleaseDetailResponse, type ReleaseDiffResponse, type ReleaseIndexResponse, type ReleaseRationaleSummary, type ReleaseRef, type RunBuildManifestResult, type SSEEvent, type SSEParseResult, type SetReleaseRationaleOptions, type SimulateCollectorOptions, type SimulateDataOptions, type SimulateDestinationOptions, type SimulateSourceOptions, type SimulateTransformerOptions, type StartObserveSessionOptions, type ThreadAnchorType, type ThreadStatus, type UpdateSecretOptions, VERSION, type ValidateResult, type ValidationError, type ValidationWarning, type WalkerOSConfig, type WrapSkeletonOptions, addThreadMessage, annotateErrorWithDrift, apiFetch, bakedContractHash, bakedContractVersion, buildDataPayload, bundle, bundleCommand, canonicalContractHash, classifyStepProperties, clearAuthFields, clientContextHeaders, collectKnownSecrets, compareContract, completeDeviceLogin, containsCodeMarkers, createApiClient, createDeployCommand, createDeployment, createDeploymentCommand, createFlow, createFlowCommand, createPreview, createProject, createProjectCommand, createSecret, createThread, credentialSource, deleteConfig, deleteDeployment, deleteDeploymentByFlowId, deleteDeploymentCommand, deleteFlow, deleteFlowCommand, deletePreview, deleteProject, deleteProjectCommand, deleteSecret, deploy, deployCommand, deployFetch, duplicateFlow, duplicateFlowCommand, endObserveSession, feedback, feedbackCommand, fetchHealth, formatPushResult, getAuthHeaders, getClientContext, getDefaultProject, getDeployment, getDeploymentBySlug, getDeploymentBySlugCommand, getDeploymentCommand, getFeedbackPreference, getFlow, getFlowCommand, getFrame, getObserveSession, getPreview, getProject, getProjectCommand, getRelease, listAllFlows, listDeployments, listDeploymentsCommand, listFlows, listFlowsCommand, listFrames, listJourneys, listKnowledge, listPageFrames, listPreviews, listProjects, listProjectsCommand, listReleases, listSecrets, listStepHistory, listThreads, loadConfig, loadJsonConfig, login, loginCommand, logout, logoutCommand, maskKnownNumbers, mergeAuthHeaders, parseSSEEvents, publicFetch, push, pushCommand, readConfig, regrantPreview, requireProjectId, resetClientContext, resolveAccessToken, resolveAppUrl, resolveExportName, resolveManifestSource, resolveToken, runBuildManifest, selectDevExamples, setClientContext, setDefaultProject, setFeedbackPreference, setReleaseRationale, simulateCollector, simulateDestination, simulateSource, simulateTransformer, startDeviceAuthorization, startObserveSession, index as telemetry, telemetryDisableCommand, telemetryEnableCommand, telemetryStatusCommand, throwApiError, updateFlow, updateFlowCommand, updateProject, updateProjectCommand, updateSecret, validate, validateCommand, whoami, whoamiCommand, wrapSkeleton, writeConfig };
+export { type AddThreadMessageOptions, ApiError, type ApiErrorDetail, BUILD_ERROR_CODES, BUILD_MANIFEST_ENV, BUILD_MANIFEST_VERSION, type BuildArtifact, BuildArtifactSchema, BuildBundleArtifactSchema, type BuildErrorCode, type BuildManifest, BuildManifestSchema, type BuildOptions, type BuildResult, BuildResultSchema, BuildWrapArtifactSchema, type BuildWrapOptions, BuildWrapOptionsSchema, type BundleStats, type CLIBuildOptions, type ClientContext, type ClientType, type CompareContractInput, type CompleteDeviceLoginOptions, type ContractComparison, type ContractVerdict, type CreatePreviewOptions, type CreateSecretOptions, type CreateThreadOptions, type DeletePreviewOptions, type DeleteSecretOptions, type DeployOptions, DeploymentAmbiguityError, type DeploymentSummaryForFlow, type DeviceAuthorization, type DeviceLoginResult, type EndObserveSessionOptions, type FeedbackOptions, type GetFrameOptions, type GetObserveSessionOptions, type GetPreviewOptions, type GetReleaseOptions, type GlobalOptions, type HealthResult, type ListDeploymentsOptions, type ListFlowsOptions, type ListFramesOptions, type ListJourneysOptions, type ListKnowledgeOptions, type ListPageFramesOptions, type ListPreviewsOptions, type ListProjectsOptions, type ListReleasesOptions, type ListSecretsOptions, type ListStepHistoryOptions, type ListThreadsOptions, type LoginOptions, type LoginResult, type MinifyOptions, type PrepareInput, type PreparedFlow, type ProjectFlows, type PushResult, type RegrantPreviewOptions, type ReleaseDetailResponse, type ReleaseDiffResponse, type ReleaseIndexResponse, type ReleaseRationaleSummary, type ReleaseRef, type RunBuildManifestResult, type SSEEvent, type SSEParseResult, type SetReleaseRationaleOptions, type SimulateCollectorOptions, type SimulateDataOptions, type SimulateDestinationOptions, type SimulateSourceOptions, type SimulateTransformerOptions, type StartObserveSessionOptions, type ThreadAnchorType, type ThreadStatus, type UpdateSecretOptions, VALIDATE_CODES, VERSION, type ValidateCheck, type ValidateCode, type ValidateDeferred, type ValidateResult, type ValidateScope, type ValidateSkip, type ValidationError, type ValidationWarning, type WalkerOSConfig, type WrapSkeletonOptions, addThreadMessage, annotateErrorWithDrift, apiFetch, bakedContractHash, bakedContractVersion, buildDataPayload, bundle, bundleCommand, canonicalContractHash, classifyStepProperties, clearAuthFields, clientContextHeaders, collectKnownSecrets, compareContract, completeDeviceLogin, containsCodeMarkers, createApiClient, createDeployCommand, createDeployment, createDeploymentCommand, createFlow, createFlowCommand, createPreview, createProject, createProjectCommand, createSecret, createThread, credentialSource, deleteConfig, deleteDeployment, deleteDeploymentByFlowId, deleteDeploymentCommand, deleteFlow, deleteFlowCommand, deletePreview, deleteProject, deleteProjectCommand, deleteSecret, deploy, deployCommand, deployFetch, duplicateFlow, duplicateFlowCommand, endObserveSession, feedback, feedbackCommand, fetchHealth, formatPushResult, getAuthHeaders, getClientContext, getDefaultProject, getDeployment, getDeploymentBySlug, getDeploymentBySlugCommand, getDeploymentCommand, getFeedbackPreference, getFlow, getFlowCommand, getFrame, getObserveSession, getPreview, getProject, getProjectCommand, getRelease, listAllFlows, listDeployments, listDeploymentsCommand, listFlows, listFlowsCommand, listFrames, listJourneys, listKnowledge, listPageFrames, listPreviews, listProjects, listProjectsCommand, listReleases, listSecrets, listStepHistory, listThreads, loadConfig, loadJsonConfig, login, loginCommand, logout, logoutCommand, mergeAuthHeaders, parseSSEEvents, publicFetch, push, pushCommand, readConfig, regrantPreview, requireProjectId, resetClientContext, resolveAccessToken, resolveAppUrl, resolveExportName, resolveManifestSource, resolveToken, runBuildManifest, selectDevExamples, setClientContext, setDefaultProject, setFeedbackPreference, setReleaseRationale, simulateCollector, simulateDestination, simulateSource, simulateTransformer, startDeviceAuthorization, startObserveSession, index as telemetry, telemetryDisableCommand, telemetryEnableCommand, telemetryStatusCommand, throwApiError, updateFlow, updateFlowCommand, updateProject, updateProjectCommand, updateSecret, validate, validateCommand, whoami, whoamiCommand, wrapSkeleton, writeConfig };