@factorialco/fcode-cli 3.2.0 → 3.4.0

package/dist/core/types.d.ts

@@ -72,14 +72,27 @@ export interface WorkspaceConfig {
 export type ResourceRepositoryOptions = {
     name: string;
 };
+/**
+ * Why a deleted resource is still in the cloud: a workspace version contains one of its published
+ * snapshots. The row is read-only there and goes for good once the last of those versions does.
+ */
+export type Deletion = {
+    deletedAt: string;
+    retainingVersionTags: string[];
+};
 export declare abstract class Resource {
     abstract readonly contentHash: string;
     id: string | undefined;
     slug: string;
     errorPushing: boolean | undefined;
     resolvingTeamSlug?: string;
+    deletion?: Deletion;
     sameAs(other: Resource): boolean;
 }
+/** Whether the workspace may edit the resource: neither a parent's nor a deleted one is its to change. */
+export declare const isReadOnly: (resource: Resource) => boolean;
+/** The sentence `push` and `diff` use to say why a resource is not the workspace's to change. */
+export declare const readOnlyReason: (resource: Resource) => string | undefined;
 export declare enum OnConflictResolution {
     KEEP_LOCAL = 0,
     KEEP_REMOTE = 1
@@ -148,6 +161,62 @@ export interface ProcessUiTrigger {
      */
     awaitResult?: boolean;
 }
+export interface ProcessFactorial {
+    /** Master switch: nothing below is exposed while false. */
+    enabled: boolean;
+    /**
+     * Whether Factorial waits for the execution and receives its result. Defaults to true, and is
+     * omitted from metadata.json when it does.
+     */
+    awaitResult?: boolean;
+    /**
+     * Monolith policy keys the caller must hold: the outer list is an OR of alternatives, each
+     * inner list an AND. Free text as far as fcode is concerned. Omitted when empty.
+     */
+    requiredPolicies?: string[][];
+    uiTrigger?: ProcessFactorialUiTrigger;
+    form?: ProcessFactorialForm;
+    agentTool?: ProcessFactorialAgentTool;
+    backend?: ProcessFactorialBackend;
+}
+export interface ProcessFactorialUiTrigger {
+    enabled: boolean;
+    /** Identifier of the UI location the button is rendered in. Required while enabled. */
+    locationId?: string;
+    /** Button text; the only field of the block that accepts fcode.i18n("key") tokens. */
+    label?: string;
+    /** f0 icon name, e.g. "Globe". */
+    icon?: string;
+}
+export interface ProcessFactorialForm {
+    enabled: boolean;
+    /** Whether the form may be embedded anonymously. Omitted from metadata.json when false. */
+    public?: boolean;
+    /**
+     * Whether the app offers the form to its users from its own page in Factorial. The `factorial`
+     * block's name for `form.appRole: "USER_FACING_FORM"`. Omitted from metadata.json when false.
+     */
+    appTool?: boolean;
+}
+export type AgentToolEffect = 'READ' | 'WRITE' | 'DESTRUCTIVE';
+export interface ProcessFactorialAgentTool {
+    enabled: boolean;
+    /** What the tool does, written for the model. */
+    description?: string;
+    effect?: AgentToolEffect;
+    whenToUse?: string;
+    whenNotToUse?: string[];
+    preconditions?: string[];
+    doesNotDo?: string[];
+    /** What the agent should do when the tool is unavailable or fails. */
+    degradation?: string;
+    /** Slug of the process this one previews the outcome of, when it is a dry run. */
+    simulatesFor?: string;
+}
+export interface ProcessFactorialBackend {
+    enabled: boolean;
+}
+export type LifecycleRole = 'INSTALL' | 'SETTINGS' | 'UNINSTALL' | 'SYNC';
 export interface ProcessMetadataFields {
     name: string;
     description?: string;
@@ -155,6 +224,7 @@ export interface ProcessMetadataFields {
     webhook?: ProcessWebhook;
     form?: ProcessForm;
     uiTrigger?: ProcessUiTrigger;
+    factorial?: ProcessFactorial;
 }
 export declare class Process extends Resource {
     id: string;
@@ -166,6 +236,9 @@ export declare class Process extends Resource {
     webhook?: ProcessWebhook;
     form?: ProcessForm;
     uiTrigger?: ProcessUiTrigger;
+    factorial?: ProcessFactorial;
+    /** Set by the platform for the reserved lifecycle slugs; not part of the content hash. */
+    lifecycleRole?: LifecycleRole;
     script: {
         parametersSchema: any;
         programmingLanguage: ProgrammingLanguage;
@@ -185,7 +258,7 @@ export declare class Process extends Resource {
         dependencies: {
             scopedToProcess: boolean;
         };
-    }, metadata: ProcessMetadataFields, resolvingTeamSlug?: string);
+    }, metadata: ProcessMetadataFields, resolvingTeamSlug?: string, deletion?: Deletion);
     get contentHash(): string;
 }
 export declare class VersionedProcess extends Resource {
@@ -207,7 +280,7 @@ export declare class ScriptLibrary extends Resource {
     name: string;
     programmingLanguage: ProgrammingLanguage;
     sourceCode: string;
-    constructor(id: string, name: string, sourceCode: string, programmingLanguage: ProgrammingLanguage, resolvingTeamSlug?: string);
+    constructor(id: string, name: string, sourceCode: string, programmingLanguage: ProgrammingLanguage, resolvingTeamSlug?: string, deletion?: Deletion);
     get contentHash(): string;
 }
 export declare class Locale extends Resource {
@@ -217,7 +290,7 @@ export declare class Locale extends Resource {
     slug: string;
     locale: string;
     content: string;
-    constructor(id: string | undefined, locale: string, content: string, resolvingTeamSlug?: string);
+    constructor(id: string | undefined, locale: string, content: string, resolvingTeamSlug?: string, deletion?: Deletion);
     /**
      * The name a locale is tracked and stored under. Unlike every other resource, the identifier is
      * not unique: a workspace sees its own `en` and each parent workspace's `en`, and all of them are

package/dist/core/types.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ServiceAccount = exports.Dependency = exports.DependenciesFlags = exports.TeamNameArg = exports.ShowInheritedFlag = exports.ResourceSlugArg = exports.ForceFlag = exports.ScriptLibraryNotFound = exports.ProcessNotFound = exports.WorkspaceSettings = exports.ProgrammingLanguageManifest = exports.Variable = exports.VersionedProgrammingLanguageManifest = exports.VersionedScriptLibrary = exports.Locale = exports.ScriptLibrary = exports.VersionedProcess = exports.Process = exports.DEFAULT_WEBHOOK_AUTH_HEADER = exports.programmingLanguageDisplayName = exports.PROGRAMMING_LANGUAGES = exports.ResourceStatus = exports.OnConflictResolution = exports.Resource = void 0;
+exports.ServiceAccount = exports.Dependency = exports.DependenciesFlags = exports.TeamNameArg = exports.ShowInheritedFlag = exports.ResourceSlugArg = exports.ForceFlag = exports.ScriptLibraryNotFound = exports.ProcessNotFound = exports.WorkspaceSettings = exports.ProgrammingLanguageManifest = exports.Variable = exports.VersionedProgrammingLanguageManifest = exports.VersionedScriptLibrary = exports.Locale = exports.ScriptLibrary = exports.VersionedProcess = exports.Process = exports.DEFAULT_WEBHOOK_AUTH_HEADER = exports.programmingLanguageDisplayName = exports.PROGRAMMING_LANGUAGES = exports.ResourceStatus = exports.OnConflictResolution = exports.readOnlyReason = exports.isReadOnly = exports.Resource = void 0;
 const core_1 = require("@oclif/core");
 const crypto = require("node:crypto");
 const canonical_hash_1 = require("../utils/canonical-hash");
@@ -10,6 +10,27 @@ class Resource {
     }
 }
 exports.Resource = Resource;
+/** Whether the workspace may edit the resource: neither a parent's nor a deleted one is its to change. */
+const isReadOnly = (resource) => Boolean(resource.resolvingTeamSlug || resource.deletion);
+exports.isReadOnly = isReadOnly;
+/** The sentence `push` and `diff` use to say why a resource is not the workspace's to change. */
+const readOnlyReason = (resource) => {
+    if (resource.resolvingTeamSlug) {
+        return `inherited from team '${resource.resolvingTeamSlug}'`;
+    }
+    if (resource.deletion) {
+        return `deleted in the cloud and kept by workspace version(s) ${resource.deletion.retainingVersionTags.join(', ')}`;
+    }
+    return undefined;
+};
+exports.readOnlyReason = readOnlyReason;
+/**
+ * The deletion as it enters a content hash. A deleted resource must read as changed the moment the
+ * cloud deletes it — or brings it back — so a pull marks its files read-only (or writable again)
+ * even though their content did not move; a live resource contributes nothing, so no stored hash
+ * changes for it.
+ */
+const deletionHashPart = (deletion) => deletion ? JSON.stringify({ deletedAt: deletion.deletedAt, retainingVersionTags: [...deletion.retainingVersionTags].sort() }) : '';
 var OnConflictResolution;
 (function (OnConflictResolution) {
     OnConflictResolution[OnConflictResolution["KEEP_LOCAL"] = 0] = "KEEP_LOCAL";
@@ -41,16 +62,18 @@ exports.programmingLanguageDisplayName = programmingLanguageDisplayName;
 // The header assumed when none is configured; its value carries a Bearer scheme.
 exports.DEFAULT_WEBHOOK_AUTH_HEADER = 'Authorization';
 class Process extends Resource {
-    constructor(id, slug, script, readme, manifest, settings, metadata, resolvingTeamSlug) {
+    constructor(id, slug, script, readme, manifest, settings, metadata, resolvingTeamSlug, deletion) {
         super();
         this.id = id;
         this.slug = slug;
+        this.deletion = deletion;
         this.name = metadata.name;
         this.description = metadata.description;
         this.tags = metadata.tags;
         this.webhook = metadata.webhook;
         this.form = metadata.form;
         this.uiTrigger = metadata.uiTrigger;
+        this.factorial = metadata.factorial;
         this.script = script;
         this.readme = readme;
         this.manifest = settings.dependencies.scopedToProcess && manifest !== null ? manifest : { dependencies: [] };
@@ -70,8 +93,10 @@ class Process extends Resource {
             // Inserted only when set, so every process that predates UI triggers keeps the
             // content hash already stored in .fcode (mirrors WorkspaceSettings.contentHash).
             ...(this.uiTrigger && { uiTrigger: this.uiTrigger }),
+            ...(this.factorial && { factorial: this.factorial }),
             manifestDependencies: this.manifest.dependencies,
             dependenciesScopedToProcess: this.settings.dependencies.scopedToProcess,
+            ...(this.deletion && { deletion: deletionHashPart(this.deletion) }),
         });
     }
 }
@@ -94,7 +119,7 @@ class VersionedProcess extends Resource {
 }
 exports.VersionedProcess = VersionedProcess;
 class ScriptLibrary extends Resource {
-    constructor(id, name, sourceCode, programmingLanguage, resolvingTeamSlug) {
+    constructor(id, name, sourceCode, programmingLanguage, resolvingTeamSlug, deletion) {
         super();
         this.id = id;
         this.slug = name;
@@ -102,20 +127,22 @@ class ScriptLibrary extends Resource {
         this.sourceCode = sourceCode;
         this.programmingLanguage = programmingLanguage;
         this.resolvingTeamSlug = resolvingTeamSlug;
+        this.deletion = deletion;
     }
     get contentHash() {
-        return crypto.createHash('md5').update(this.sourceCode).digest('hex');
+        return crypto.createHash('md5').update(this.sourceCode).update(deletionHashPart(this.deletion)).digest('hex');
     }
 }
 exports.ScriptLibrary = ScriptLibrary;
 class Locale extends Resource {
-    constructor(id, locale, content, resolvingTeamSlug) {
+    constructor(id, locale, content, resolvingTeamSlug, deletion) {
         super();
         this.id = id;
         this.slug = Locale.slugFor(locale, resolvingTeamSlug);
         this.locale = locale;
         this.content = content;
         this.resolvingTeamSlug = resolvingTeamSlug;
+        this.deletion = deletion;
     }
     /**
      * The name a locale is tracked and stored under. Unlike every other resource, the identifier is
@@ -133,7 +160,7 @@ class Locale extends Resource {
     // Hashed over the raw YAML: the file is the source of truth and round-trips comments and
     // ordering, so any edit — even one that parses to the same translations — is a change to push.
     get contentHash() {
-        return crypto.createHash('md5').update(this.content).digest('hex');
+        return crypto.createHash('md5').update(this.content).update(deletionHashPart(this.deletion)).digest('hex');
     }
 }
 exports.Locale = Locale;

package/dist/repositories/locale.js

@@ -32,7 +32,7 @@ class LocaleRepository extends resource_1.default {
         }
         try {
             const content = fs.readFileSync(this.getResourcePath(localeMetadata)).toString();
-            return new types_1.Locale(localeMetadata.id, localeMetadata.locale ?? slug, content, localeMetadata.resolvingTeamSlug);
+            return new types_1.Locale(localeMetadata.id, localeMetadata.locale ?? slug, content, localeMetadata.resolvingTeamSlug, localeMetadata.deletion);
         }
         catch (error) {
             throw new errors_1.LocalLocaleNotFound(error, slug);
@@ -78,12 +78,14 @@ class LocaleRepository extends resource_1.default {
             locale: locale.locale,
             slug: locale.slug,
             ...(locale.resolvingTeamSlug && { resolvingTeamSlug: locale.resolvingTeamSlug }),
+            ...(locale.deletion && { deletion: locale.deletion }),
         };
     }
     async saveFiles(locale) {
         // Inherited locales are written read-only, like inherited modules: they belong to a parent
-        // workspace, and editing one here would push an override rather than change the parent.
-        (0, file_utils_1.outputFileSyncIfChanged)(this.getResourcePath(locale), locale.content || '', { readOnly: Boolean(locale.resolvingTeamSlug) });
+        // workspace, and editing one here would push an override rather than change the parent. A
+        // deleted locale is read-only too: only its versions are still resolved.
+        (0, file_utils_1.outputFileSyncIfChanged)(this.getResourcePath(locale), locale.content || '', { readOnly: (0, types_1.isReadOnly)(locale) });
     }
     async metadataFromFiles(slug) {
         return {

package/dist/repositories/process.js

@@ -37,8 +37,23 @@ function buildProcessMetadata(process) {
     if (process.uiTrigger !== undefined) {
         metadata.uiTrigger = process.uiTrigger;
     }
+    if (process.factorial !== undefined) {
+        metadata.factorial = process.factorial;
+    }
     return metadata;
 }
+/**
+ * The `factorial` block as the file has it, minus the `title` and `description` keys an earlier
+ * draft of the block carried: the process's own name and description took their place, so a file
+ * that still has them is read as if it did not, and the next save drops them.
+ */
+function readFactorialBlock(raw) {
+    if (raw === undefined || raw === null || typeof raw !== 'object') {
+        return raw ?? undefined;
+    }
+    const { title: _title, description: _description, ...factorial } = raw;
+    return factorial;
+}
 const PROCESS_SOURCE_CODE_FILE_NAME = (programmingLanguage) => (programmingLanguage === 'PYTHON' ? 'main.py' : 'index.js');
 exports.PROCESS_SOURCE_CODE_FILE_NAME = PROCESS_SOURCE_CODE_FILE_NAME;
 const PROCESS_DEPENDENCIES_FILE_NAME = (programmingLanguage) => PROGRAMMING_LANGUAGE_DEPENDENCIES_FILE_NAME[programmingLanguage];
@@ -147,7 +162,7 @@ class ProcessRepository extends resource_1.default {
             const manifest = isDependenciesFilePresent
                 ? { dependencies: (0, dependencies_1.dependenciesFromFile)(processMetadata.script.programmingLanguage, fs.readFileSync(dependenciesFile).toString()) }
                 : null;
-            return new types_1.Process(processMetadata.id, processMetadata.slug, { parametersSchema, programmingLanguage: processMetadata.script.programmingLanguage, sourceCode }, readme, manifest, { dependencies: { scopedToProcess: isDependenciesFilePresent } }, metadata, processMetadata.resolvingTeamSlug);
+            return new types_1.Process(processMetadata.id, processMetadata.slug, { parametersSchema, programmingLanguage: processMetadata.script.programmingLanguage, sourceCode }, readme, manifest, { dependencies: { scopedToProcess: isDependenciesFilePresent } }, metadata, processMetadata.resolvingTeamSlug, processMetadata.deletion);
         }
         catch {
             throw new Error(`Process ${processSlug} not found!`);
@@ -163,6 +178,7 @@ class ProcessRepository extends resource_1.default {
                 webhook: raw.webhook,
                 form: raw.form,
                 uiTrigger: raw.uiTrigger,
+                factorial: readFactorialBlock(raw.factorial),
             };
         }
         catch (error) {
@@ -229,6 +245,7 @@ class ProcessRepository extends resource_1.default {
                 programmingLanguage: process.script.programmingLanguage,
             },
             ...(process.resolvingTeamSlug && { resolvingTeamSlug: process.resolvingTeamSlug }),
+            ...(process.deletion && { deletion: process.deletion }),
         };
     }
     async metadataFromFiles(slug) {
@@ -243,7 +260,8 @@ class ProcessRepository extends resource_1.default {
         };
     }
     async saveFiles(process) {
-        const readOnly = Boolean(process.resolvingTeamSlug);
+        // A deleted process is kept exactly as its versions left it, like an inherited one: read-only.
+        const readOnly = (0, types_1.isReadOnly)(process);
         (0, file_utils_1.outputFileSyncIfChanged)(this.buildResourcePath(process, this.getSourceCodeFileName(process.script.programmingLanguage)), process.script.sourceCode || '', {
             readOnly,
         });

package/dist/repositories/script-library.js

@@ -25,7 +25,7 @@ class ScriptLibraryRepository extends resource_1.default {
         const sourceCodeFile = fs.readFileSync(this.getResourcePath(scriptLibraryMetadata));
         try {
             const sourceCode = sourceCodeFile.toString();
-            return new types_1.ScriptLibrary(scriptLibraryMetadata.id, scriptLibraryMetadata.name, sourceCode, scriptLibraryMetadata.programmingLanguage, scriptLibraryMetadata.resolvingTeamSlug);
+            return new types_1.ScriptLibrary(scriptLibraryMetadata.id, scriptLibraryMetadata.name, sourceCode, scriptLibraryMetadata.programmingLanguage, scriptLibraryMetadata.resolvingTeamSlug, scriptLibraryMetadata.deletion);
         }
         catch (error) {
             throw new errors_1.LocalScriptLibraryNotFound(error, slug);
@@ -83,10 +83,11 @@ class ScriptLibraryRepository extends resource_1.default {
             slug: scriptLibrary.slug,
             programmingLanguage: scriptLibrary.programmingLanguage,
             ...(scriptLibrary.resolvingTeamSlug && { resolvingTeamSlug: scriptLibrary.resolvingTeamSlug }),
+            ...(scriptLibrary.deletion && { deletion: scriptLibrary.deletion }),
         };
     }
     async saveFiles(scriptLibrary) {
-        (0, file_utils_1.outputFileSyncIfChanged)(this.getResourcePath(scriptLibrary), scriptLibrary.sourceCode || '', { readOnly: Boolean(scriptLibrary.resolvingTeamSlug) });
+        (0, file_utils_1.outputFileSyncIfChanged)(this.getResourcePath(scriptLibrary), scriptLibrary.sourceCode || '', { readOnly: (0, types_1.isReadOnly)(scriptLibrary) });
     }
     versionsDirectory(scriptLibrary) {
         return path.join(this._repositoryName, this.resourceDirectoryName(scriptLibrary), 'versions');

package/dist/runtime/libs/python/fcode/datastore.py

@@ -21,7 +21,9 @@ class Datastore:
             return self.getAll().get(key, None)
         raise TypeError("Invalid argument type")
 
-    def set(self, key, value):
+    def set(self, key, value, encrypted=False):
+        if not isinstance(encrypted, bool):
+            raise TypeError("Invalid encrypted flag. Encrypted must be a boolean.")
         if isinstance(key, (str, int)) and isinstance(value, (str, int)):
             datastore = self.getAll()
             datastore[key] = value

package/dist/services/fcode-graphql-client.d.ts

@@ -1,5 +1,14 @@
 import { GraphQLClient } from 'graphql-request';
 import { Locale, Process, ProgrammingLanguage, ProgrammingLanguageManifest, RawTeamSettings, ScriptLibrary, TeamUpdateInput, TeamVersion, TeamVersionAlias, Variable, VersionedProcess, VersionedProgrammingLanguageManifest, VersionedScriptLibrary, ServiceAccount } from '../core/types';
+/**
+ * What a delete mutation answers. `deletedAt` is set when the entity was kept as deleted because a
+ * workspace version still contains it; `retainingVersionTags` names those versions.
+ */
+export interface RemovedResource {
+    id: string;
+    deletedAt: string | null;
+    retainingVersionTags: string[];
+}
 export type FcodeGraphQLClientOptions = {
     url: string;
     accessToken: string;
@@ -16,10 +25,17 @@ declare class FcodeGraphQLClient {
     cleanError(error: any): any;
     private cloudUnavailableMessage;
     private isNetworkError;
-    allProcesses(): Promise<Array<Process>>;
+    /**
+     * Every process of the workspace, the deleted ones a workspace version still contains included:
+     * they are pulled read-only with their versions, so the local copy keeps what the versions run.
+     * An api that predates deleted-marked processes rejects the query over the unknown field, and
+     * the fallback lists the live ones as it always did.
+     */
+    allProcesses(includeDeleted?: boolean): Promise<Array<Process>>;
     allVersionedProcesses(processId: string): Promise<Array<VersionedProcess>>;
     createVersionedProcesses(versionedProcess: VersionedProcess): Promise<void>;
-    allScriptLibraries(): Promise<Array<ScriptLibrary>>;
+    /** Same deleted-inclusive listing, and the same fallback, as {@link allProcesses}. */
+    allScriptLibraries(includeDeleted?: boolean): Promise<Array<ScriptLibrary>>;
     allVersionedScriptLibraries(scriptLibraryId: string): Promise<Array<VersionedScriptLibrary>>;
     createVersionedScriptLibrary(versionedScriptLibrary: VersionedScriptLibrary): Promise<void>;
     allVariables(): Promise<Array<Variable>>;
@@ -29,26 +45,48 @@ declare class FcodeGraphQLClient {
      * kept twice here — an override is layered over the parent's file key by key, so the parent's
      * keys are still what the ones it does not mention resolve to.
      */
-    allLocales(): Promise<Array<Locale>>;
+    allLocales(includeDeleted?: boolean): Promise<Array<Locale>>;
+    private fetchLocales;
     pushLocale(locale: Locale): Promise<Locale>;
     updateLocale(locale: Locale): Promise<Locale>;
-    removeLocale(locale: string | undefined): Promise<void>;
+    removeLocale(locale: string | undefined): Promise<RemovedResource>;
     private toProcessInput;
     pushProcess(process: Process): Promise<Process>;
-    removeProcess(id: String | undefined): Promise<Process>;
+    removeProcess(id: String | undefined): Promise<RemovedResource>;
     pushScriptLibrary(scriptLibrary: ScriptLibrary): Promise<ScriptLibrary>;
-    removeScriptLibrary(id: String | undefined): Promise<Process>;
+    removeScriptLibrary(id: String | undefined): Promise<RemovedResource>;
     pushVariable(variable: Variable): Promise<Variable>;
     updateVariable(variable: Variable): Promise<Variable>;
     removeVariable(id: String | undefined): Promise<Process>;
     programmingLanguageManifest(programmingLanguage: ProgrammingLanguage): Promise<ProgrammingLanguageManifest>;
     private inheritedTeam;
+    private deletionOf;
+    private isUndefinedDeletionFieldError;
     /**
      * The public mode and the default header name are left out, so a public webhook — or one
      * using the default header — keeps the metadata.json it already had on disk.
      */
     private mapWebhook;
-    mapProcess({ id, slug, name, description, tags, script, readme, manifest, settings, triggers, resolvingTeamSlug }: any): Process;
+    /**
+     * metadata.json omits every defaulted field of the `factorial` block, so the input restores
+     * them explicitly: every input field left out means "leave unchanged" on the platform, and the
+     * file is the source of truth. That includes the agent tool's clearable texts, sent as "" when
+     * the file has none so deleting the line clears the value. The platform reads a null or empty
+     * `uiTrigger.locationId` / `label` / `icon` and `agentTool.effect` as unchanged, though, so
+     * those are sent only when present (like the legacy `uiTrigger.label`).
+     */
+    private toFactorialInput;
+    /**
+     * The `factorial` block as metadata.json writes it: defaulted fields omitted, and a block or
+     * sub-block omitted only when disabled AND all defaults — a disabled sub-block that still carries
+     * settings (a tool contract, a trigger location, a public form) is kept, or a pull followed by a
+     * push would clear them on the platform. The platform always returns the block, so a process
+     * that never configured one comes back as all defaults and is mapped to no block at all, or every
+     * process in every workspace would gain a `factorial` key (and a new content hash) on its next
+     * pull.
+     */
+    private mapFactorialSettings;
+    mapProcess({ id, slug, name, description, tags, script, readme, manifest, settings, triggers, resolvingTeamSlug, lifecycleRole, deletedAt, retainingVersionTags, }: any): Process;
     /**
      * GraphQL nests the webhook configuration under `settings`, while settings.json and the REST API
      * keep it flat. Mapping it explicitly is what keeps that mismatch from silently reading as