wexample-wex-addon-process 4.1.4__tar.gz → 5.0.0__tar.gz

{wexample_wex_addon_process-4.1.4 → wexample_wex_addon_process-5.0.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: wexample-wex-addon-process
-Version: 4.1.4
+Version: 5.0.0
 Summary: Executes process runs defined on disk—either directly or by consuming them from a queue as a worker—against filestate selections
 Author-Email: weeger <contact@wexample.com>
 License: MIT
@@ -10,7 +10,7 @@ Classifier: Operating System :: OS Independent
 Requires-Python: >=3.10
 Requires-Dist: wexample-file>=9.2.0
 Requires-Dist: wexample-queue>=2.0.0
-Requires-Dist: wexample-wex-addon-app>=33.3.0
+Requires-Dist: wexample-wex-addon-app>=34.0.0
 Provides-Extra: dev
 Requires-Dist: pytest; extra == "dev"
 Requires-Dist: pytest-cov; extra == "dev"
@@ -18,7 +18,7 @@ Description-Content-Type: text/markdown
 
 # wex-addon-process
 
-Version: 4.1.4
+Version: 5.0.0
 
 `wexample-wex-addon-process` runs the treatments a board declares. A *process* says what to run and on which selection of files; a *run* is one execution of it, asked for by writing a record and picked up by a worker.
 
@@ -360,13 +360,11 @@ This package is part of the Wexample Suite — a collection of high-quality, mod
 
 The suite includes packages for configuration management, file handling, prompts, and more. Each package can be used independently or as part of the integrated suite.
 
-Visit the [Wexample Suite documentation](https://docs.wexample.com) for the complete package ecosystem.
-
 ## Dependencies
 
 - wexample-file: >=9.2.0
 - wexample-queue: >=2.0.0
-- wexample-wex-addon-app: >=33.3.0
+- wexample-wex-addon-app: >=34.0.0
 
 ## Versioning & Compatibility Policy
 
@@ -392,6 +390,8 @@ This packages suite embodies this spirit. Trusted by professionals and enthusias
 
 Wexample cultivates a culture of mastery. Each package, each contribution carries the mark of a community that values precision, ethics, and innovation — a community proud to shape the future of digital craftsmanship.
 
+Built and maintained by [Romain Weeger](https://weeger.io).
+
 ## Known Limitations & Roadmap
 
 Current limitations and planned features are tracked in the GitHub issues.
@@ -411,7 +411,6 @@ See the [project roadmap](https://github.com/wexample/python-wex-addon-process/i
 ## Useful Links
 
 - **Homepage**: https://github.com/wexample/python-wex-addon-process
-- **Documentation**: [docs.wexample.com](https://docs.wexample.com)
 - **Issue Tracker**: https://github.com/wexample/python-wex-addon-process/issues
 - **Discussions**: https://github.com/wexample/python-wex-addon-process/discussions
 - **PyPI**: [pypi.org/project/wexample-wex-addon-process](https://pypi.org/project/wexample-wex-addon-process/)

{wexample_wex_addon_process-4.1.4 → wexample_wex_addon_process-5.0.0}/README.md

@@ -1,6 +1,6 @@
 # wex-addon-process
 
-Version: 4.1.4
+Version: 5.0.0
 
 `wexample-wex-addon-process` runs the treatments a board declares. A *process* says what to run and on which selection of files; a *run* is one execution of it, asked for by writing a record and picked up by a worker.
 
@@ -342,13 +342,11 @@ This package is part of the Wexample Suite — a collection of high-quality, mod
 
 The suite includes packages for configuration management, file handling, prompts, and more. Each package can be used independently or as part of the integrated suite.
 
-Visit the [Wexample Suite documentation](https://docs.wexample.com) for the complete package ecosystem.
-
 ## Dependencies
 
 - wexample-file: >=9.2.0
 - wexample-queue: >=2.0.0
-- wexample-wex-addon-app: >=33.3.0
+- wexample-wex-addon-app: >=34.0.0
 
 ## Versioning & Compatibility Policy
 
@@ -374,6 +372,8 @@ This packages suite embodies this spirit. Trusted by professionals and enthusias
 
 Wexample cultivates a culture of mastery. Each package, each contribution carries the mark of a community that values precision, ethics, and innovation — a community proud to shape the future of digital craftsmanship.
 
+Built and maintained by [Romain Weeger](https://weeger.io).
+
 ## Known Limitations & Roadmap
 
 Current limitations and planned features are tracked in the GitHub issues.
@@ -393,7 +393,6 @@ See the [project roadmap](https://github.com/wexample/python-wex-addon-process/i
 ## Useful Links
 
 - **Homepage**: https://github.com/wexample/python-wex-addon-process
-- **Documentation**: [docs.wexample.com](https://docs.wexample.com)
 - **Issue Tracker**: https://github.com/wexample/python-wex-addon-process/issues
 - **Discussions**: https://github.com/wexample/python-wex-addon-process/discussions
 - **PyPI**: [pypi.org/project/wexample-wex-addon-process](https://pypi.org/project/wexample-wex-addon-process/)

{wexample_wex_addon_process-4.1.4 → wexample_wex_addon_process-5.0.0}/pyproject.toml

@@ -6,7 +6,7 @@ build-backend = "pdm.backend"
 
 [project]
 name = "wexample-wex-addon-process"
-version = "4.1.4"
+version = "5.0.0"
 description = "Executes process runs defined on disk—either directly or by consuming them from a queue as a worker—against filestate selections"
 authors = [
     { name = "weeger", email = "contact@wexample.com" },
@@ -20,7 +20,7 @@ classifiers = [
 dependencies = [
     "wexample-file>=9.2.0",
     "wexample-queue>=2.0.0",
-    "wexample-wex-addon-app>=33.3.0",
+    "wexample-wex-addon-app>=34.0.0",
 ]
 
 [project.readme]

wexample_wex_addon_process-5.0.0/src/wexample_wex_addon_process/builtin/builtin_process.py

@@ -0,0 +1,32 @@
+from __future__ import annotations
+
+from dataclasses import dataclass, field
+from typing import Any
+
+
+@dataclass(frozen=True)
+class BuiltinProcess:
+    """A process an addon ships: the same in every app, declared by no record.
+
+    What a process record says, said in code — a type, the options it is handed, and
+    the selection it runs on, a selection computed in code named by its provider, since
+    there is no selection record to point at either. A run names it by its identity, as
+    it names a process an app holds; nothing in an app can change it.
+    """
+
+    name: str
+    selection: str
+    title: str
+    type: str
+    
+    options: dict[str, Any] = field(default_factory=dict)
+    severity: str | None = None
+
+    @property
+    def identity(self) -> str:
+        """The uuid a run and a consumer know it by, following from its name."""
+        from wexample_wex_core.helper.data_record import record_identity
+
+        from wexample_wex_addon_process.const.process import KIND_PROCESS
+
+        return record_identity(KIND_PROCESS, self.name)

wexample_wex_addon_process-5.0.0/src/wexample_wex_addon_process/builtin/builtin_process_registry.py

@@ -0,0 +1,29 @@
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, Any
+
+if TYPE_CHECKING:
+    from wexample_wex_addon_process.builtin.builtin_process import BuiltinProcess
+
+
+class BuiltinProcessRegistry:
+    """The processes the loaded addons ship, by the identity a run names them with."""
+
+    def __init__(self, processes: list[BuiltinProcess]) -> None:
+        self._processes = {process.identity: process for process in processes}
+
+    @classmethod
+    def from_kernel(cls, kernel: Any) -> BuiltinProcessRegistry:
+        return cls(
+            [
+                process
+                for addon in kernel.get_addons().values()
+                for process in addon.get_builtin_processes()
+            ]
+        )
+
+    def all(self) -> list[BuiltinProcess]:
+        return sorted(self._processes.values(), key=lambda process: process.name)
+
+    def get(self, identity: str) -> BuiltinProcess | None:
+        return self._processes.get(identity)

wexample_wex_addon_process-5.0.0/src/wexample_wex_addon_process/commands/process/create.py

@@ -0,0 +1,108 @@
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+from wexample_cli.const.tags import EffectTag, ScopeTag
+from wexample_cli.decorator.api_command import api_command
+from wexample_cli.decorator.command import command
+from wexample_cli.decorator.middleware import middleware
+from wexample_cli.decorator.option import option
+from wexample_wex_addon_app.middleware.app_middleware import AppMiddleware
+from wexample_wex_core.const.globals import COMMAND_TYPE_ADDON
+
+if TYPE_CHECKING:
+    from wexample_app.response.abstract_response import AbstractResponse
+    from wexample_cli.context.execution_context import ExecutionContext
+    from wexample_wex_addon_app.workdir.managed_workdir import ManagedWorkdir
+
+
+@option(name="title", type=str, required=True, description="What the process is called.")
+@option(
+    name="type",
+    short_name="ty",
+    type=str,
+    required=True,
+    description="The process type it runs, by its registry name.",
+)
+@option(
+    name="selection",
+    type=str,
+    required=True,
+    description="Uuid of the selection it runs on, a record under `.wex/data/selection/`.",
+)
+@option(
+    name="options",
+    type=str,
+    required=False,
+    default="{}",
+    description="Its options, a JSON object, handed to the type as they are.",
+)
+@option(
+    name="severity",
+    short_name="sv",
+    type=str,
+    required=False,
+    description="How serious what it finds is (`warning`, `error`…); left out, the reader's default.",
+)
+@api_command(commit_subject="process creation")
+@middleware(middleware=AppMiddleware)
+@command(
+    type=COMMAND_TYPE_ADDON,
+    description="Create a process of the app, its record under `.wex/data/process/`. The selection it names must be one the app holds.",
+    tags=[
+        EffectTag.CREATE,
+        ScopeTag.APP,
+        ScopeTag.LOCAL,
+    ],
+)
+def process__process__create(
+    context: ExecutionContext,
+    app_workdir: ManagedWorkdir,
+    title: str,
+    type: str,
+    selection: str,
+    options: str = "{}",
+    severity: str | None = None,
+) -> AbstractResponse:
+    import json
+    from datetime import UTC, datetime
+
+    from wexample_app.response.dict_response import DictResponse
+    from wexample_wex_core.helper.data_record import data_kind_dir, new_record_path
+
+    from wexample_wex_addon_process.const.process import (
+        KIND_PROCESS,
+        KIND_SELECTION,
+        PROCESS_KEY_DATE_CREATED,
+        PROCESS_KEY_OPTIONS,
+        PROCESS_KEY_SELECTION_ID,
+        PROCESS_KEY_SEVERITY,
+        PROCESS_KEY_TITLE,
+        PROCESS_KEY_TYPE,
+    )
+    from wexample_wex_addon_process.record.record_file import record_path, write_record
+
+    app_path = app_workdir.get_path()
+    if not record_path(app_path, KIND_SELECTION, selection).is_file():
+        from wexample_wex_addon_process.exception.record_not_found_exception import (
+            RecordNotFoundException,
+        )
+
+        raise RecordNotFoundException(kind=KIND_SELECTION, record_id=selection)
+
+    record = new_record_path(data_kind_dir(app_path, KIND_PROCESS))
+    values = {
+        PROCESS_KEY_TITLE: title,
+        PROCESS_KEY_TYPE: type,
+        PROCESS_KEY_SELECTION_ID: selection,
+        PROCESS_KEY_OPTIONS: json.loads(options),
+        PROCESS_KEY_DATE_CREATED: datetime.now(UTC).isoformat(timespec="seconds"),
+    }
+    if severity:
+        values[PROCESS_KEY_SEVERITY] = severity
+    write_record(record, values)
+
+    return DictResponse(
+        kernel=context.kernel,
+        content={"id": record.stem, "path": str(record), "written": [str(record)]},
+    )

wexample_wex_addon_process-5.0.0/src/wexample_wex_addon_process/commands/process/remove.py

@@ -0,0 +1,46 @@
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+from wexample_cli.const.tags import EffectTag, ScopeTag
+from wexample_cli.decorator.api_command import api_command
+from wexample_cli.decorator.command import command
+from wexample_cli.decorator.middleware import middleware
+from wexample_cli.decorator.option import option
+from wexample_wex_addon_app.middleware.app_middleware import AppMiddleware
+from wexample_wex_core.const.globals import COMMAND_TYPE_ADDON
+
+if TYPE_CHECKING:
+    from wexample_app.response.abstract_response import AbstractResponse
+    from wexample_cli.context.execution_context import ExecutionContext
+    from wexample_wex_addon_app.workdir.managed_workdir import ManagedWorkdir
+
+
+@option(name="id", type=str, required=True, description="Uuid of the process to take away.")
+@api_command(commit_subject="process removal")
+@middleware(middleware=AppMiddleware)
+@command(
+    type=COMMAND_TYPE_ADDON,
+    description="Take a process of the app away, its record and the directory beside it. Its runs stay: they are the history of what it did.",
+    tags=[
+        EffectTag.DELETE,
+        ScopeTag.APP,
+        ScopeTag.LOCAL,
+    ],
+)
+def process__process__remove(
+    context: ExecutionContext,
+    app_workdir: ManagedWorkdir,
+    id: str,
+) -> AbstractResponse:
+    from wexample_app.response.dict_response import DictResponse
+    from wexample_wex_core.helper.data_record import record_remove
+
+    from wexample_wex_addon_process.const.process import KIND_PROCESS
+    from wexample_wex_addon_process.record.record_file import record_path
+
+    removed = record_remove(record_path(app_workdir.get_path(), KIND_PROCESS, id))
+    return DictResponse(
+        kernel=context.kernel,
+        content={"id": id, "written": [str(path) for path in removed]},
+    )

wexample_wex_addon_process-5.0.0/src/wexample_wex_addon_process/commands/process/update.py

@@ -0,0 +1,107 @@
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+from wexample_cli.const.tags import EffectTag, ScopeTag
+from wexample_cli.decorator.api_command import api_command
+from wexample_cli.decorator.command import command
+from wexample_cli.decorator.middleware import middleware
+from wexample_cli.decorator.option import option
+from wexample_wex_addon_app.middleware.app_middleware import AppMiddleware
+from wexample_wex_core.const.globals import COMMAND_TYPE_ADDON
+
+if TYPE_CHECKING:
+    from wexample_app.response.abstract_response import AbstractResponse
+    from wexample_cli.context.execution_context import ExecutionContext
+    from wexample_wex_addon_app.workdir.managed_workdir import ManagedWorkdir
+
+
+@option(name="id", type=str, required=True, description="Uuid of the process to rewrite.")
+@option(name="title", type=str, required=True, description="What the process is called.")
+@option(
+    name="type",
+    short_name="ty",
+    type=str,
+    required=True,
+    description="The process type it runs, by its registry name.",
+)
+@option(
+    name="selection",
+    type=str,
+    required=False,
+    description="Uuid of the selection it runs on, a record under `.wex/data/selection/`; left out, it keeps its own.",
+)
+@option(
+    name="options",
+    type=str,
+    required=False,
+    default="{}",
+    description="Its options, a JSON object, handed to the type as they are.",
+)
+@option(
+    name="severity",
+    short_name="sv",
+    type=str,
+    required=False,
+    description="How serious what it finds is (`warning`, `error`…); left out, the reader's default.",
+)
+@api_command(commit_subject="process edition")
+@middleware(middleware=AppMiddleware)
+@command(
+    type=COMMAND_TYPE_ADDON,
+    description="Rewrite a process of the app from the fields a form holds. Fields of the record it does not take stay as they were.",
+    tags=[
+        EffectTag.WRITE,
+        ScopeTag.APP,
+        ScopeTag.LOCAL,
+    ],
+)
+def process__process__update(
+    context: ExecutionContext,
+    app_workdir: ManagedWorkdir,
+    id: str,
+    title: str,
+    type: str,
+    selection: str | None = None,
+    options: str = "{}",
+    severity: str | None = None,
+) -> AbstractResponse:
+    import json
+
+    from wexample_app.response.dict_response import DictResponse
+
+    from wexample_wex_addon_process.const.process import (
+        KIND_PROCESS,
+        KIND_SELECTION,
+        PROCESS_KEY_OPTIONS,
+        PROCESS_KEY_SELECTION_ID,
+        PROCESS_KEY_SEVERITY,
+        PROCESS_KEY_TITLE,
+        PROCESS_KEY_TYPE,
+    )
+    from wexample_wex_addon_process.exception.record_not_found_exception import (
+        RecordNotFoundException,
+    )
+    from wexample_wex_addon_process.record.record_file import record_path, write_record
+
+    app_path = app_workdir.get_path()
+    record = record_path(app_path, KIND_PROCESS, id)
+    if not record.is_file():
+        raise RecordNotFoundException(kind=KIND_PROCESS, record_id=id)
+    values = {
+        PROCESS_KEY_TITLE: title,
+        PROCESS_KEY_TYPE: type,
+        PROCESS_KEY_OPTIONS: json.loads(options),
+    }
+    if selection:
+        if not record_path(app_path, KIND_SELECTION, selection).is_file():
+            raise RecordNotFoundException(kind=KIND_SELECTION, record_id=selection)
+        values[PROCESS_KEY_SELECTION_ID] = selection
+    if severity:
+        values[PROCESS_KEY_SEVERITY] = severity
+    write_record(record, values)
+
+    return DictResponse(
+        kernel=context.kernel,
+        content={"id": id, "path": str(record), "written": [str(record)]},
+    )

wexample_wex_addon_process-5.0.0/src/wexample_wex_addon_process/commands/run/cancel.py

@@ -0,0 +1,54 @@
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+from wexample_cli.const.tags import EffectTag, ScopeTag
+from wexample_cli.decorator.api_command import api_command
+from wexample_cli.decorator.command import command
+from wexample_cli.decorator.middleware import middleware
+from wexample_cli.decorator.option import option
+from wexample_wex_addon_app.middleware.app_middleware import AppMiddleware
+from wexample_wex_core.const.globals import COMMAND_TYPE_ADDON
+
+if TYPE_CHECKING:
+    from wexample_app.response.abstract_response import AbstractResponse
+    from wexample_cli.context.execution_context import ExecutionContext
+    from wexample_wex_addon_app.workdir.managed_workdir import ManagedWorkdir
+
+
+@option(name="id", type=str, required=True, description="Uuid of the run to stop.")
+@api_command(commit_subject="process run cancel")
+@middleware(middleware=AppMiddleware)
+@command(
+    type=COMMAND_TYPE_ADDON,
+    description="Ask a run to stop. Whoever executes it reads the request between two items, so the file under way is finished first.",
+    tags=[
+        EffectTag.WRITE,
+        ScopeTag.APP,
+        ScopeTag.LOCAL,
+    ],
+)
+def process__run__cancel(
+    context: ExecutionContext,
+    app_workdir: ManagedWorkdir,
+    id: str,
+) -> AbstractResponse:
+    from wexample_app.response.dict_response import DictResponse
+
+    from wexample_wex_addon_process.const.process import (
+        KIND_PROCESS_RUN,
+        RUN_KEY_CANCEL,
+    )
+    from wexample_wex_addon_process.record.record_file import record_path, write_record
+
+    path = record_path(app_workdir.get_path(), KIND_PROCESS_RUN, id)
+    if not path.is_file():
+        from wexample_wex_addon_process.exception.record_not_found_exception import (
+            RecordNotFoundException,
+        )
+
+        raise RecordNotFoundException(kind=KIND_PROCESS_RUN, record_id=id)
+    write_record(path, {RUN_KEY_CANCEL: True})
+
+    # Nothing to commit: runs stay out of the project's history.
+    return DictResponse(kernel=context.kernel, content={"id": id, "path": str(path), "written": []})

wexample_wex_addon_process-5.0.0/src/wexample_wex_addon_process/commands/run/create.py

@@ -0,0 +1,144 @@
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+from wexample_cli.const.tags import EffectTag, ScopeTag
+from wexample_cli.decorator.api_command import api_command
+from wexample_cli.decorator.command import command
+from wexample_cli.decorator.middleware import middleware
+from wexample_cli.decorator.option import option
+from wexample_wex_addon_app.middleware.app_middleware import AppMiddleware
+from wexample_wex_core.const.globals import COMMAND_TYPE_ADDON
+
+if TYPE_CHECKING:
+    from wexample_app.response.abstract_response import AbstractResponse
+    from wexample_cli.context.execution_context import ExecutionContext
+    from wexample_wex_addon_app.workdir.managed_workdir import ManagedWorkdir
+
+
+@option(
+    name="process",
+    type=str,
+    required=True,
+    description="Uuid of the process to run: a record under `.wex/data/process/`, or one an addon ships (`/data/process` lists them).",
+)
+@option(
+    name="options",
+    short_name="o",
+    type=str,
+    required=False,
+    description="Options of the run's own, a JSON object laid over the process's.",
+)
+@option(
+    name="action",
+    type=str,
+    required=False,
+    description="What the run does instead of the process's own action.",
+)
+@option(
+    name="items",
+    type=str,
+    required=False,
+    description="What it goes through instead of the selection, a JSON list of paths.",
+)
+@option(
+    name="commit_work",
+    short_name="cw",
+    type=bool,
+    is_flag=True,
+    default=False,
+    description="Have the run commit the paths it declares it wrote, once it is done.",
+)
+@option(
+    name="work_author",
+    short_name="wa",
+    type=str,
+    required=False,
+    description="`Name <email>` the run's commit is signed by.",
+)
+@api_command(commit_subject="process run")
+@middleware(middleware=AppMiddleware)
+@command(
+    type=COMMAND_TYPE_ADDON,
+    description="Open a run of a process, pending, its record under `.wex/data/process_run/` — what a worker picks up, or `process::run/execute` runs by hand. Runs stay out of the project's history: their directory ignores them.",
+    tags=[
+        EffectTag.CREATE,
+        ScopeTag.APP,
+        ScopeTag.LOCAL,
+    ],
+)
+def process__run__create(
+    context: ExecutionContext,
+    app_workdir: ManagedWorkdir,
+    process: str,
+    action: str | None = None,
+    items: str | None = None,
+    options: str | None = None,
+    commit_work: bool = False,
+    work_author: str | None = None,
+) -> AbstractResponse:
+    import json
+    from datetime import UTC, datetime
+
+    from wexample_app.response.dict_response import DictResponse
+    from wexample_wex_core.helper.data_record import data_kind_dir, new_record_path
+
+    from wexample_wex_addon_process.builtin.builtin_process_registry import (
+        BuiltinProcessRegistry,
+    )
+    from wexample_wex_addon_process.const.process import (
+        KIND_PROCESS,
+        KIND_PROCESS_RUN,
+        RUN_KEY_ACTION,
+        RUN_KEY_AUTHOR,
+        RUN_KEY_COMMIT,
+        RUN_KEY_DATE_CREATED,
+        RUN_KEY_ITEMS,
+        RUN_KEY_OPTIONS,
+        RUN_KEY_PROCESS_ID,
+        RUN_KEY_STATE,
+        STATE_PENDING,
+    )
+    from wexample_wex_addon_process.record.record_file import record_path, write_record
+
+    app_path = app_workdir.get_path()
+    if (
+        not record_path(app_path, KIND_PROCESS, process).is_file()
+        and BuiltinProcessRegistry.from_kernel(context.kernel).get(process) is None
+    ):
+        from wexample_wex_addon_process.exception.record_not_found_exception import (
+            RecordNotFoundException,
+        )
+
+        raise RecordNotFoundException(kind=KIND_PROCESS, record_id=process)
+
+    directory = data_kind_dir(app_path, KIND_PROCESS_RUN)
+    directory.mkdir(parents=True, exist_ok=True)
+    # A process is a declaration worth committing and a run is a dated fact that is
+    # not, so the directory holding them says so itself rather than relying on every
+    # project to have thought of it.
+    ignore = directory / ".gitignore"
+    written = []
+    if not ignore.is_file():
+        ignore.write_text("*\n!.gitignore\n", encoding="utf-8")
+        written.append(str(ignore))
+
+    # The overrides only when there are some: a run that names none is the process as
+    # declared, and its record says nothing more.
+    values = {
+        RUN_KEY_PROCESS_ID: process,
+        RUN_KEY_STATE: STATE_PENDING,
+        RUN_KEY_ACTION: action,
+        RUN_KEY_ITEMS: json.loads(items) if items else None,
+        RUN_KEY_OPTIONS: json.loads(options) if options else None,
+        RUN_KEY_COMMIT: commit_work,
+        RUN_KEY_AUTHOR: work_author if commit_work else None,
+        RUN_KEY_DATE_CREATED: datetime.now(UTC).isoformat(timespec="seconds"),
+    }
+    record = new_record_path(directory)
+    write_record(record, {key: value for key, value in values.items() if value is not None})
+
+    return DictResponse(
+        kernel=context.kernel,
+        content={"id": record.stem, "path": str(record), "written": written},
+    )