# Complete Lightbulb SDK and MCP reference

Generated 2026-08-30 from reviewed source. This document distinguishes public source from unreleased candidates and does not grant product entitlement or execution authority.

Canonical browser pages:
- https://www.lightbulbpartners.com/developers/sdk
- https://www.lightbulbpartners.com/developers/mcp
- https://www.lightbulbpartners.com/developers/reference

# Public source — Lightbulb 0.10.2

GitHub source · beta

Exact Git revision: `68d215b8d6cd346770e78fa3487299de1057ddaa`  
Source-tree SHA-256: `18e8d77bce0a5355757f51dc33557934faa25e14c7f47a7bba5186688b86efa9`

Documentation coverage: Full source docstrings: `sdk.syncMethods, sdk.asyncMethods, sdk.modules, mcp.tools`. Names, signatures, export inventories, counts, and provenance remain complete for this exact revision.

## Surface counts

- Synchronous client methods: 197
- Async client members: 31
- Awaitable async-client methods: 29
- Typed modules: 7
- Typed callable/type symbols: 28
- Class and resource methods: 307
- Declared public exports: 29
- Root package exports: 29
- Stable SDK facade exports: 0
- Public MCP tools: 1250
- MCP namespaces: 47

## Synchronous Python client

### `active_company_id`



~~~python
@property
def active_company_id() -> str | None
~~~


The currently selected company context (needed for write operations).

Source: `lightbulb/client.py:222`.

### `active_company_id`



~~~python
@active_company_id.setter
def active_company_id(value: str | None) -> None
~~~


Source: `lightbulb/client.py:227`.

### `apply_aoc_tick`



~~~python
def apply_aoc_tick(tick_id: str, body: Dict[str, Any] | None=None) -> Dict[str, Any]
~~~


Apply a previously-computed AutoCompany tick (committing its decisions).

Source: `lightbulb/client.py:2265`.

### `apply_code_workspace_proposal`



~~~python
def apply_code_workspace_proposal(workspace_id: str, proposal_id: str) -> Dict[str, Any]
~~~


Apply a previously-submitted proposal to the workspace files.

Source: `lightbulb/client.py:1768`.

### `approve_runtime_action`



~~~python
def approve_runtime_action(action_id: str) -> Dict[str, Any]
~~~


Approve (activate) a pending runtime action — ADMIN/TENANT only
(``POST /api/domain-agents/runtime-actions/{id}/approve``).

Source: `lightbulb/client.py:1341`.

### `approve_task`



~~~python
def approve_task(task_id: str, *, comments: str='') -> Dict[str, Any]
~~~


Approve a pending HITL task.

Source: `lightbulb/client.py:1098`.

### `approve_voice_action`



~~~python
def approve_voice_action(execution_id: str, approval_task_id: str, *, comments: str='') -> Dict[str, Any]
~~~


Approve a pending in-call action (e.g. transfer, wire info, commit booking).

Source: `lightbulb/client.py:1415`.

### `backbone_execute`



~~~python
def backbone_execute(objective: str, *, inputs: Dict[str, Any] | None=None) -> Dict[str, Any]
~~~


Execute a task through the backbone agent (research, analysis, code generation).

Source: `lightbulb/client.py:978`.

### `cancel_code_workspace_run`



~~~python
def cancel_code_workspace_run(workspace_id: str, run_id: str) -> Dict[str, Any]
~~~


Cancel an in-flight coding run.

Source: `lightbulb/client.py:1812`.

### `claude_session_action`



~~~python
def claude_session_action(workspace_id: str, session_id: str, action: str, body: Dict[str, Any] | None=None) -> Dict[str, Any]
~~~


Perform an action on a Claude SDK session.

action: one of rename, tag, fork, delete, interrupt, mcp/reconnect,
        mcp/toggle, rewind, tasks/stop, compact

Source: `lightbulb/client.py:2024`.

### `code_workspace_add_collaborator`



~~~python
def code_workspace_add_collaborator(workspace_id: str, *, email: str | None=None, user_id: str | None=None, role: str='viewer') -> Dict[str, Any]
~~~


Add a collaborator to a code workspace (role: viewer | editor | admin).

Source: `lightbulb/client.py:1572`.

### `code_workspace_add_note`



~~~python
def code_workspace_add_note(workspace_id: str, content: str) -> Dict[str, Any]
~~~


Append a workspace note (visible to collaborators).

Source: `lightbulb/client.py:1671`.

### `code_workspace_approve_access_request`



~~~python
def code_workspace_approve_access_request(workspace_id: str, request_id: str) -> Dict[str, Any]
~~~


Approve a pending workspace access request.

Source: `lightbulb/client.py:1649`.

### `code_workspace_chat`



~~~python
def code_workspace_chat(workspace_id: str, message: str, **kwargs) -> Dict[str, Any]
~~~


Send a chat message to a code workspace.

Source: `lightbulb/client.py:860`.

### `code_workspace_clear_policy`



~~~python
def code_workspace_clear_policy(workspace_id: str, request_family: str) -> Dict[str, Any]
~~~


Clear cached policy decisions for a request family.

Source: `lightbulb/client.py:1979`.

### `code_workspace_collaboration`



~~~python
def code_workspace_collaboration(workspace_id: str) -> Dict[str, Any]
~~~


Get collaboration info (members, share links, pending requests).

Source: `lightbulb/client.py:1562`.

### `code_workspace_create_pull_request`



~~~python
def code_workspace_create_pull_request(workspace_id: str, body: Dict[str, Any] | None=None) -> Dict[str, Any]
~~~


Open a GitHub pull request from the workspace branch.

Source: `lightbulb/client.py:1790`.

### `code_workspace_create_share_link`



~~~python
def code_workspace_create_share_link(workspace_id: str, *, role: str='viewer', expires_in_seconds: int | None=None) -> Dict[str, Any]
~~~


Create a share-link token granting access to the workspace.

Source: `lightbulb/client.py:1615`.

### `code_workspace_deny_access_request`



~~~python
def code_workspace_deny_access_request(workspace_id: str, request_id: str) -> Dict[str, Any]
~~~


Deny a pending workspace access request.

Source: `lightbulb/client.py:1660`.

### `code_workspace_evals`



~~~python
def code_workspace_evals(workspace_id: str) -> Dict[str, Any]
~~~


Get accumulated eval rollups for a workspace's runs.

Source: `lightbulb/client.py:1958`.

### `code_workspace_invoke_tool`



~~~python
def code_workspace_invoke_tool(workspace_id: str, tool_key: str, arguments: Dict[str, Any] | None=None) -> Dict[str, Any]
~~~


Invoke a workspace-scoped tool (read/write files, run commands, git ops).

Tool keys are registered in the workspace's runtime catalog. Common keys:
    - ``files.read`` — read a file by path
    - ``files.write`` — write a file
    - ``files.list`` — list directory contents
    - ``shell.run`` — execute a shell command
    - ``git.status`` — show git working-tree state
    - ``git.diff`` — produce a diff
    - ``git.commit`` — create a commit
Use :meth:`code_workspace_runtime_catalog` to discover what's available
for a specific workspace.

Source: `lightbulb/client.py:1825`.

### `code_workspace_link_repository`



~~~python
def code_workspace_link_repository(workspace_id: str, body: Dict[str, Any]) -> Dict[str, Any]
~~~


Link a GitHub repository to the workspace.

Source: `lightbulb/client.py:1801`.

### `code_workspace_policy_replay`



~~~python
def code_workspace_policy_replay(workspace_id: str, **filters: Any) -> Dict[str, Any]
~~~


Replay a policy decision over historical runs (debug helper).

Source: `lightbulb/client.py:1968`.

### `code_workspace_preview`



~~~python
def code_workspace_preview(workspace_id: str) -> Dict[str, Any]
~~~


Get the current preview state (URL, status, last build).

Source: `lightbulb/client.py:1898`.

### `code_workspace_preview_proxy`



~~~python
def code_workspace_preview_proxy(workspace_id: str, path: str='', *, method: str='GET', body: Any=None, headers: Dict[str, str] | None=None) -> httpx.Response
~~~


Proxy an HTTP call through the workspace preview.

Returns the raw httpx.Response so callers can inspect status/headers/body.
Use this for headless e2e tests against in-progress code.

Security: caller-supplied ``headers`` are merged BEFORE auth headers, so
a caller cannot overwrite ``Authorization`` / ``X-Tenant-Id`` /
``X-Internal-API-Key``. ``method`` and ``path`` are validated.

Source: `lightbulb/client.py:1919`.

### `code_workspace_preview_start`



~~~python
def code_workspace_preview_start(workspace_id: str, body: Dict[str, Any] | None=None) -> Dict[str, Any]
~~~


Start the workspace preview server (renders the in-progress code).

Source: `lightbulb/client.py:1883`.

### `code_workspace_preview_stop`



~~~python
def code_workspace_preview_stop(workspace_id: str) -> Dict[str, Any]
~~~


Stop the workspace preview server.

Source: `lightbulb/client.py:1908`.

### `code_workspace_promote_policy`



~~~python
def code_workspace_promote_policy(workspace_id: str, body: Dict[str, Any]) -> Dict[str, Any]
~~~


Promote workspace-scoped policy to a higher scope (company/tenant).

Source: `lightbulb/client.py:1990`.

### `code_workspace_redeem_share_link`



~~~python
def code_workspace_redeem_share_link(token: str) -> Dict[str, Any]
~~~


Redeem a workspace share-link token to gain access.

Source: `lightbulb/client.py:1638`.

### `code_workspace_register_runtime_tools`



~~~python
def code_workspace_register_runtime_tools(workspace_id: str, body: Dict[str, Any]) -> Dict[str, Any]
~~~


Register or update workspace runtime tools.

Source: `lightbulb/client.py:1866`.

### `code_workspace_remove_collaborator`



~~~python
def code_workspace_remove_collaborator(workspace_id: str, collaborator_id: str) -> None
~~~


Revoke a collaborator's access.

Source: `lightbulb/client.py:1606`.

### `code_workspace_revoke_share_link`



~~~python
def code_workspace_revoke_share_link(workspace_id: str, link_id: str) -> None
~~~


Revoke a share link.

Source: `lightbulb/client.py:1629`.

### `code_workspace_run_review`



~~~python
def code_workspace_run_review(workspace_id: str, run_id: str, *, verdict: str, feedback: str='') -> Dict[str, Any]
~~~


Submit a human review verdict (accept | reject | request_changes) for a run.

Source: `lightbulb/client.py:1717`.

### `code_workspace_run_review_apply`



~~~python
def code_workspace_run_review_apply(workspace_id: str, run_id: str) -> Dict[str, Any]
~~~


Apply review-suggested changes to the workspace.

Source: `lightbulb/client.py:1735`.

### `code_workspace_run_telemetry`



~~~python
def code_workspace_run_telemetry(workspace_id: str, **filters: Any) -> Dict[str, Any]
~~~


Raw telemetry rows for a workspace's runs.

Source: `lightbulb/client.py:1706`.

### `code_workspace_runs_insights`



~~~python
def code_workspace_runs_insights(workspace_id: str) -> Dict[str, Any]
~~~


Aggregate run-quality insights for a workspace (cost, latency, success rate).

Source: `lightbulb/client.py:1696`.

### `code_workspace_runtime_catalog`



~~~python
def code_workspace_runtime_catalog(workspace_id: str) -> Dict[str, Any]
~~~


Read the workspace's runtime tool catalog (which tool keys are available).

Source: `lightbulb/client.py:1856`.

### `code_workspace_update_collaborator`



~~~python
def code_workspace_update_collaborator(workspace_id: str, collaborator_id: str, *, role: str) -> Dict[str, Any]
~~~


Change a collaborator's role.

Source: `lightbulb/client.py:1595`.

### `codex_thread_action`



~~~python
def codex_thread_action(workspace_id: str, thread_id: str, action: str, body: Dict[str, Any] | None=None) -> Dict[str, Any]
~~~


Perform a thread-level action (rename | archive | unarchive | compact | rollback).

Source: `lightbulb/client.py:2073`.

### `codex_turn_action`



~~~python
def codex_turn_action(workspace_id: str, thread_id: str, turn_id: str, action: str, body: Dict[str, Any] | None=None) -> Dict[str, Any]
~~~


Steer or interrupt a specific Codex turn (action: steer | interrupt).

Source: `lightbulb/client.py:2094`.

### `compute_aoc_tick`



~~~python
def compute_aoc_tick(body: Dict[str, Any] | None=None) -> Dict[str, Any]
~~~


Run a one-shot AutoCompany tick computation.

Source: `lightbulb/client.py:2254`.

### `create_aoc_run`



~~~python
def create_aoc_run(body: Dict[str, Any]) -> Dict[str, Any]
~~~


Create a new AutoCompany run.

Source: `lightbulb/client.py:2131`.

### `create_aoc_task`



~~~python
def create_aoc_task(body: Dict[str, Any]) -> Dict[str, Any]
~~~


Create an AutoCompany task.

Source: `lightbulb/client.py:2174`.

### `create_approval_auto_accept`



~~~python
def create_approval_auto_accept(task_id: str, body: Dict[str, Any] | None=None) -> Dict[str, Any]
~~~


Create an auto-accept rule keyed off the shape of an existing approval task.

Source: `lightbulb/client.py:2508`.

### `create_code_workspace`



~~~python
def create_code_workspace(*, source: str | None=None, repo_connection_id: str | None=None, branch: str | None=None, depth: int | None=None, label: str | None=None, metadata: Dict[str, Any] | None=None, company_id: str | None=None) -> Dict[str, Any]
~~~


Create a code workspace.

Source: `lightbulb/client.py:816`.

### `create_conversation`



~~~python
def create_conversation(domain: str) -> Dict[str, Any]
~~~


Create a new conversation for a domain.

Source: `lightbulb/client.py:587`.

### `create_crm_task`



~~~python
def create_crm_task(body: Dict[str, Any], tenant_id: str | None=None) -> Dict[str, Any]
~~~


Create a CRM task.

Source: `lightbulb/client.py:2461`.

### `create_document`



~~~python
def create_document(title: str, body: str, *, format: str='docx', target_suite: str='internal_library') -> DispatchResult
~~~


Create a new document.

Source: `lightbulb/client.py:706`.

### `create_document_session`



~~~python
def create_document_session(*, document_type: str='general', document_title: str='Untitled Document') -> Dict[str, Any]
~~~


Create a new document builder session.

Source: `lightbulb/client.py:606`.

### `create_page_builder_session`



~~~python
def create_page_builder_session(brand_name: str='', initial_prompt: str='') -> Dict[str, Any]
~~~


Create a new page builder session.

Source: `lightbulb/client.py:759`.

### `create_project`



~~~python
def create_project(name: str, *, instructions: str='', workspace_id: str | None=None, repo_connection_id: str | None=None, product_machine_plan: Dict[str, Any] | None=None, idempotency_key: str | None=None) -> Dict[str, Any]
~~~


Create a Lightbulb project (``POST /api/projects`` → ``ProjectCreateRequest``).

``name`` is required. Optionally bind a code workspace / repo connection
and seed the product-machine plan. Pass ``idempotency_key`` to make a
retried create return the existing project instead of duplicating it
(sent via the ``Idempotency-Key`` header the controller honours).

Source: `lightbulb/client.py:899`.

### `create_slide_deck`



~~~python
def create_slide_deck(title: str, body: str='', *, target_suite: str='internal_library') -> DispatchResult
~~~


Create a new slide deck.

Source: `lightbulb/client.py:742`.

### `create_spreadsheet`



~~~python
def create_spreadsheet(title: str, body: str='', *, target_suite: str='internal_library') -> DispatchResult
~~~


Create a new spreadsheet.

Source: `lightbulb/client.py:727`.

### `delete_approval_preference`



~~~python
def delete_approval_preference(preference_id: str) -> Dict[str, Any]
~~~


Remove an auto-accept rule.

Source: `lightbulb/client.py:2519`.

### `delete_conversation`



~~~python
def delete_conversation(domain: str, conversation_id: str) -> None
~~~


Delete a conversation.

Source: `lightbulb/client.py:596`.

### `delete_crm_task`



~~~python
def delete_crm_task(task_id: str, tenant_id: str | None=None) -> None
~~~


Delete a CRM task.

Source: `lightbulb/client.py:2485`.

### `dispatch`



~~~python
def dispatch(domain: str, *, action: str='chat', message: str='', objective: str='', inputs: Dict[str, Any] | None=None, conversation_id: str | None=None, company_id: str | None=None) -> DispatchResult
~~~


Dispatch a one-shot action to a domain agent and wait for the result.

Source: `lightbulb/client.py:361`.

### `document_builder_add_collaborator`



~~~python
def document_builder_add_collaborator(session_id: str, *, email: str | None=None, user_id: str | None=None, role: str='viewer') -> Dict[str, Any]
~~~


Add a collaborator to a document builder session.

Source: `lightbulb/client.py:2737`.

### `document_builder_add_note`



~~~python
def document_builder_add_note(session_id: str, content: str) -> Dict[str, Any]
~~~


Add a note to a document builder session.

Source: `lightbulb/client.py:2886`.

### `document_builder_collaboration`



~~~python
def document_builder_collaboration(session_id: str) -> Dict[str, Any]
~~~


Collaboration info for a document builder session.

Source: `lightbulb/client.py:2727`.

### `document_builder_create_share_link`



~~~python
def document_builder_create_share_link(session_id: str, *, role: str='viewer', expires_in_seconds: int | None=None) -> Dict[str, Any]
~~~


Create a share-link token for a document builder session.

Source: `lightbulb/client.py:2760`.

### `document_builder_get_messages`



~~~python
def document_builder_get_messages(session_id: str, **filters: Any) -> List[Dict[str, Any]]
~~~


Get the message history for a document builder session.

Source: `lightbulb/client.py:2785`.

### `document_builder_redeem_share_link`



~~~python
def document_builder_redeem_share_link(session_id: str, token: str) -> Dict[str, Any]
~~~


Redeem a document builder share link.

Source: `lightbulb/client.py:2774`.

### `document_builder_save`



~~~python
def document_builder_save(session_id: str, body: Dict[str, Any] | None=None) -> Dict[str, Any]
~~~


Save a document builder session's current state.

Source: `lightbulb/client.py:2797`.

### `get_aoc_decision`



~~~python
def get_aoc_decision(decision_id: str) -> Dict[str, Any]
~~~


Get a specific AutoCompany decision.

Source: `lightbulb/client.py:2222`.

### `get_aoc_run`



~~~python
def get_aoc_run(run_id: str) -> Dict[str, Any]
~~~


Get an AutoCompany run detail.

Source: `lightbulb/client.py:2138`.

### `get_aoc_task`



~~~python
def get_aoc_task(task_id: str) -> Dict[str, Any]
~~~


Get an AutoCompany task detail.

Source: `lightbulb/client.py:2181`.

### `get_aoc_tick`



~~~python
def get_aoc_tick(tick_id: str) -> Dict[str, Any]
~~~


Get a single AutoCompany tick.

Source: `lightbulb/client.py:2244`.

### `get_approval`



~~~python
def get_approval(task_id: str) -> Dict[str, Any]
~~~


Get full details of an approval task.

Source: `lightbulb/client.py:1091`.

### `get_artifact`



~~~python
def get_artifact(artifact_id: str) -> Dict[str, Any]
~~~


Get a specific artifact by ID.

Source: `lightbulb/client.py:1005`.

### `get_code_workspace_active_run`



~~~python
def get_code_workspace_active_run(workspace_id: str) -> Dict[str, Any] | None
~~~


Get the currently active run for a code workspace, if one exists.

Source: `lightbulb/client.py:875`.

### `get_code_workspace_claude_session`



~~~python
def get_code_workspace_claude_session(workspace_id: str, session_id: str) -> Dict[str, Any]
~~~


Get a single Claude SDK session.

Source: `lightbulb/client.py:2014`.

### `get_code_workspace_codex_thread`



~~~python
def get_code_workspace_codex_thread(workspace_id: str, thread_id: str) -> Dict[str, Any]
~~~


Get a Codex thread (turns, status, metadata).

Source: `lightbulb/client.py:2063`.

### `get_code_workspace_run`



~~~python
def get_code_workspace_run(workspace_id: str, run_id: str) -> Dict[str, Any]
~~~


Get a specific code workspace run.

Source: `lightbulb/client.py:887`.

### `get_conversation`



~~~python
def get_conversation(domain: str, conversation_id: str) -> Dict[str, Any]
~~~


Get conversation history.

Source: `lightbulb/client.py:578`.

### `get_crm_task`



~~~python
def get_crm_task(task_id: str, tenant_id: str | None=None) -> Dict[str, Any]
~~~


Get a single CRM task.

Source: `lightbulb/client.py:2450`.

### `get_document_schemas`



~~~python
def get_document_schemas(session_id: str) -> Dict[str, Any]
~~~


Get the document schemas for a session.

Source: `lightbulb/client.py:636`.

### `get_document_session`



~~~python
def get_document_session(session_id: str) -> Dict[str, Any]
~~~


Get a document builder session.

Source: `lightbulb/client.py:628`.

### `get_product_machine_plan`



~~~python
def get_product_machine_plan(project_id: str) -> Dict[str, Any]
~~~


Get a project's product-machine plan / deliverables
(``GET /api/projects/{id}/product-machine/plan``).

Source: `lightbulb/client.py:953`.

### `get_project`



~~~python
def get_project(project_id: str) -> Dict[str, Any]
~~~


Get a single project (``GET /api/projects/{id}``).

Source: `lightbulb/client.py:943`.

### `get_voice_execution`



~~~python
def get_voice_execution(execution_id: str) -> Dict[str, Any]
~~~


Get a voice execution detail (transcripts, status, agent decisions).

Source: `lightbulb/client.py:1394`.

### `get_workflow`



~~~python
def get_workflow(workflow_id: str) -> Dict[str, Any]
~~~


Get a workflow by ID.

Source: `lightbulb/client.py:1065`.

### `grep_documents`



~~~python
def grep_documents(pattern: str, *, regex: bool=True, case_sensitive: bool=False, folder_path: str | None=None, top_k: int=20) -> DispatchResult
~~~


Grep across document content using pattern matching.

Source: `lightbulb/client.py:664`.

### `hr_live_advance_application`



~~~python
def hr_live_advance_application(application_id: str, *, body: Dict[str, Any] | None=None) -> Dict[str, Any]
~~~


Advance a Greenhouse candidate to the next stage (HITL-gated).

Source: `lightbulb/client.py:1531`.

### `hr_live_cases`



~~~python
def hr_live_cases(**filters: Any) -> Dict[str, Any]
~~~


HR case board items from Monday.com.

Source: `lightbulb/client.py:1498`.

### `hr_live_health`



~~~python
def hr_live_health() -> Dict[str, Any]
~~~


Health check for HR connector tokens (BambooHR / Greenhouse / Monday).

Source: `lightbulb/client.py:1553`.

### `hr_live_leave_balance`



~~~python
def hr_live_leave_balance(bamboo_employee_id: str) -> Dict[str, Any]
~~~


BambooHR leave balance for an employee.

Source: `lightbulb/client.py:1478`.

### `hr_live_monday_onboarding_board`



~~~python
def hr_live_monday_onboarding_board(checklist_id: str) -> Dict[str, Any]
~~~


Monday.com board view for an HR onboarding checklist.

Source: `lightbulb/client.py:1488`.

### `hr_live_recruiting_applications`



~~~python
def hr_live_recruiting_applications(**filters: Any) -> Dict[str, Any]
~~~


Greenhouse applications.

Source: `lightbulb/client.py:1520`.

### `hr_live_recruiting_jobs`



~~~python
def hr_live_recruiting_jobs(**filters: Any) -> Dict[str, Any]
~~~


Greenhouse job listings.

Source: `lightbulb/client.py:1509`.

### `hr_live_reject_application`



~~~python
def hr_live_reject_application(application_id: str, *, body: Dict[str, Any] | None=None) -> Dict[str, Any]
~~~


Reject a Greenhouse application (HITL-gated).

Source: `lightbulb/client.py:1542`.

### `hr_live_whos_out`



~~~python
def hr_live_whos_out(**filters: Any) -> Dict[str, Any]
~~~


BambooHR who's-out roster (current and upcoming time-off).

Source: `lightbulb/client.py:1467`.

### `invoke_tool`



~~~python
def invoke_tool(tool_name: str, arguments: Dict[str, Any]) -> Dict[str, Any]
~~~


Invoke a platform tool by name (e.g. connector tools, utility tools).

Posts to ``POST /api/tools/invoke`` with ``toolName`` + ``inputs`` (plus
tenant/company scope from auth so the platform's RBAC + HITL machinery
can resolve the binding without re-reading the JWT for every field).

Source: `lightbulb/client.py:1150`.

### `it_ops_live_connector`



~~~python
def it_ops_live_connector(connector: str, **filters: Any) -> Dict[str, Any]
~~~


Pass-through to a live IT-Ops connector (jira | slack | github | notion).

Source: `lightbulb/client.py:2612`.

### `it_ops_mcp_manifest`



~~~python
def it_ops_mcp_manifest() -> Dict[str, Any]
~~~


Get the IT-Ops workspace MCP manifest.

Source: `lightbulb/client.py:2626`.

### `list_aoc_decisions`



~~~python
def list_aoc_decisions(**filters: Any) -> List[Dict[str, Any]]
~~~


List AutoCompany decisions awaiting or post-resolution.

Source: `lightbulb/client.py:2210`.

### `list_aoc_runs`



~~~python
def list_aoc_runs(**filters: Any) -> List[Dict[str, Any]]
~~~


List AutoCompany cognitive-loop runs.

Source: `lightbulb/client.py:2119`.

### `list_aoc_task_events`



~~~python
def list_aoc_task_events(task_id: str) -> List[Dict[str, Any]]
~~~


List events recorded against an AutoCompany task.

Source: `lightbulb/client.py:2188`.

### `list_aoc_tasks`



~~~python
def list_aoc_tasks(**filters: Any) -> List[Dict[str, Any]]
~~~


List AutoCompany tasks.

Source: `lightbulb/client.py:2162`.

### `list_aoc_ticks`



~~~python
def list_aoc_ticks(**filters: Any) -> List[Dict[str, Any]]
~~~


List AutoCompany cognitive-loop ticks.

Source: `lightbulb/client.py:2232`.

### `list_approval_preferences`



~~~python
def list_approval_preferences() -> List[Dict[str, Any]]
~~~


List the user's HITL auto-accept rules.

Source: `lightbulb/client.py:2497`.

### `list_artifacts`



~~~python
def list_artifacts(**filters) -> List[Dict[str, Any]]
~~~


List artifacts (charts, reports, analyses, etc.).

Source: `lightbulb/client.py:993`.

### `list_code_workspace_claude_sessions`



~~~python
def list_code_workspace_claude_sessions(workspace_id: str) -> List[Dict[str, Any]]
~~~


List Claude SDK sessions associated with a workspace.

Source: `lightbulb/client.py:2003`.

### `list_code_workspace_codex_threads`



~~~python
def list_code_workspace_codex_threads(workspace_id: str, **filters: Any) -> List[Dict[str, Any]]
~~~


List Codex runtime threads attached to a workspace.

Source: `lightbulb/client.py:2051`.

### `list_code_workspace_proposals`



~~~python
def list_code_workspace_proposals(workspace_id: str) -> List[Dict[str, Any]]
~~~


List code-change proposals submitted to the workspace.

Source: `lightbulb/client.py:1746`.

### `list_code_workspace_runs`



~~~python
def list_code_workspace_runs(workspace_id: str, **filters: Any) -> List[Dict[str, Any]]
~~~


List historical coding runs for a workspace.

Source: `lightbulb/client.py:1684`.

### `list_code_workspaces`



~~~python
def list_code_workspaces() -> List[Dict[str, Any]]
~~~


List code workspaces.

Source: `lightbulb/client.py:853`.

### `list_companies`



~~~python
def list_companies() -> List[Dict[str, Any]]
~~~


List companies the user has access to within their tenant.

Source: `lightbulb/client.py:253`.

### `list_connected_integrations`



~~~python
def list_connected_integrations(company_id: str | None=None) -> List[Dict[str, Any]]
~~~


List connected integrations (OAuth connections) for the current company scope.

Source: `lightbulb/client.py:237`.

### `list_connectors`



~~~python
def list_connectors() -> List[Dict[str, Any]]
~~~


List available connectors and their status.

Source: `lightbulb/client.py:1142`.

### `list_contacts`



~~~python
def list_contacts(**filters) -> List[Dict[str, Any]]
~~~


List CRM contacts.

Source: `lightbulb/client.py:1175`.

### `list_conversations`



~~~python
def list_conversations(domain: str) -> List[Dict[str, Any]]
~~~


List all conversations for a domain.

Source: `lightbulb/client.py:569`.

### `list_crm_tasks`



~~~python
def list_crm_tasks(tenant_id: str | None=None, **filters: Any) -> List[Dict[str, Any]]
~~~


List CRM tasks scoped to a tenant (defaults to authed tenant).

Source: `lightbulb/client.py:2437`.

### `list_deals`



~~~python
def list_deals(**filters) -> List[Dict[str, Any]]
~~~


List CRM deals/opportunities.

Source: `lightbulb/client.py:1187`.

### `list_document_sessions`



~~~python
def list_document_sessions() -> List[Dict[str, Any]]
~~~


List document builder sessions.

Source: `lightbulb/client.py:620`.

### `list_domain_actions`



~~~python
def list_domain_actions(domain: str) -> List[Dict[str, Any]]
~~~


List available actions for a specific domain agent.

Source: `lightbulb/client.py:1291`.

### `list_domains`



~~~python
def list_domains() -> List[Dict[str, Any]]
~~~


List all available domain agents and their capabilities.

Source: `lightbulb/client.py:1284`.

### `list_folder`



~~~python
def list_folder(folder_path: str='', *, source_system: str | None=None, max_items: int=100) -> DispatchResult
~~~


List documents in a folder.

Source: `lightbulb/client.py:689`.

### `list_notifications`



~~~python
def list_notifications(**filters) -> List[Dict[str, Any]]
~~~


List notifications (HITL decisions, workflow alerts, system messages).

Source: `lightbulb/client.py:1201`.

### `list_page_builder_sessions`



~~~python
def list_page_builder_sessions() -> List[Dict[str, Any]]
~~~


List page builder sessions.

Source: `lightbulb/client.py:771`.

### `list_pending_approvals`



~~~python
def list_pending_approvals() -> List[Dict[str, Any]]
~~~


List pending HITL approval tasks waiting for your decision.

Source: `lightbulb/client.py:1084`.

### `list_projects`



~~~python
def list_projects() -> List[Dict[str, Any]]
~~~


List the caller's projects (``GET /api/projects``).

Source: `lightbulb/client.py:935`.

### `list_runtime_actions`



~~~python
def list_runtime_actions(status: str='active') -> Dict[str, Any]
~~~


List runtime domain actions by status
(``GET /api/domain-agents/runtime-actions?status=``).

Returns the controller's ``{status, count, actions:[...]}`` envelope.

Source: `lightbulb/client.py:1365`.

### `list_voice_executions`



~~~python
def list_voice_executions(**filters: Any) -> List[Dict[str, Any]]
~~~


List voice agent executions (live and historical phone calls).

Source: `lightbulb/client.py:1382`.

### `list_voice_pending_approvals`



~~~python
def list_voice_pending_approvals() -> List[Dict[str, Any]]
~~~


List in-call HITL approvals waiting for caller-side decision.

Source: `lightbulb/client.py:1404`.

### `list_workflows`



~~~python
def list_workflows() -> List[Dict[str, Any]]
~~~


List workflow definitions.

Source: `lightbulb/client.py:1057`.

### `mark_all_notifications_read`



~~~python
def mark_all_notifications_read() -> Dict[str, Any]
~~~


Mark all notifications as read.

Source: `lightbulb/client.py:2554`.

### `mark_notification_read`



~~~python
def mark_notification_read(notification_id: str) -> Dict[str, Any]
~~~


Mark a single notification as read.

Source: `lightbulb/client.py:2543`.

### `marketing_add_website_analytics_site`



~~~python
def marketing_add_website_analytics_site(body: Dict[str, Any]) -> Dict[str, Any]
~~~


Register a website with the analytics setup.

Source: `lightbulb/client.py:2832`.

### `marketing_content_configure_provider`



~~~python
def marketing_content_configure_provider(provider: str, body: Dict[str, Any]) -> Dict[str, Any]
~~~


Configure a marketing-content provider (e.g. ga4, segment, plausible).

Source: `lightbulb/client.py:2820`.

### `marketing_content_setup`



~~~python
def marketing_content_setup() -> Dict[str, Any]
~~~


Get the marketing content connector setup state.

Source: `lightbulb/client.py:2810`.

### `marketing_install_website_analytics`



~~~python
def marketing_install_website_analytics(workspace_id: str, body: Dict[str, Any] | None=None) -> Dict[str, Any]
~~~


Install website analytics into a code workspace.

Source: `lightbulb/client.py:2875`.

### `marketing_remove_website_analytics_site`



~~~python
def marketing_remove_website_analytics_site(site_id: str) -> Dict[str, Any]
~~~


Remove a registered analytics site.

Source: `lightbulb/client.py:2854`.

### `marketing_select_website_analytics_site`



~~~python
def marketing_select_website_analytics_site(site_id: str) -> Dict[str, Any]
~~~


Activate a registered analytics site.

Source: `lightbulb/client.py:2843`.

### `marketing_verify_website_analytics`



~~~python
def marketing_verify_website_analytics(body: Dict[str, Any] | None=None) -> Dict[str, Any]
~~~


Verify the website analytics setup is wired correctly.

Source: `lightbulb/client.py:2864`.

### `memory_add_skill`



~~~python
def memory_add_skill(body: Dict[str, Any]) -> Dict[str, Any]
~~~


Record a new skill / capability.

Source: `lightbulb/client.py:2428`.

### `memory_create_entry`



~~~python
def memory_create_entry(body: Dict[str, Any]) -> Dict[str, Any]
~~~


Create a structured memory entry.

Source: `lightbulb/client.py:2300`.

### `memory_create_identity`



~~~python
def memory_create_identity(body: Dict[str, Any]) -> Dict[str, Any]
~~~


Create an identity record.

Source: `lightbulb/client.py:2365`.

### `memory_create_link`



~~~python
def memory_create_link(body: Dict[str, Any]) -> Dict[str, Any]
~~~


Create a memory link between two entities.

Source: `lightbulb/client.py:2413`.

### `memory_get_entry`



~~~python
def memory_get_entry(entry_id: str) -> Dict[str, Any]
~~~


Get a specific memory entry.

Source: `lightbulb/client.py:2290`.

### `memory_get_identity`



~~~python
def memory_get_identity(doc_id: str) -> Dict[str, Any]
~~~


Get an identity record by doc id.

Source: `lightbulb/client.py:2372`.

### `memory_graph`



~~~python
def memory_graph(**filters: Any) -> Dict[str, Any]
~~~


Full memory graph (or filtered subgraph).

Source: `lightbulb/client.py:2335`.

### `memory_graph_node`



~~~python
def memory_graph_node(node_id: str) -> Dict[str, Any]
~~~


Get a single node from the memory graph.

Source: `lightbulb/client.py:2346`.

### `memory_list_entries`



~~~python
def memory_list_entries(**filters: Any) -> List[Dict[str, Any]]
~~~


List memory entries (structured records).

Source: `lightbulb/client.py:2278`.

### `memory_list_events`



~~~python
def memory_list_events(**filters: Any) -> List[Dict[str, Any]]
~~~


List memory events (timeline of state changes).

Source: `lightbulb/client.py:2382`.

### `memory_list_identity`



~~~python
def memory_list_identity() -> List[Dict[str, Any]]
~~~


List identity records in the memory graph.

Source: `lightbulb/client.py:2357`.

### `memory_list_links`



~~~python
def memory_list_links(**filters: Any) -> List[Dict[str, Any]]
~~~


List entity links in the memory graph.

Source: `lightbulb/client.py:2401`.

### `memory_list_skills`



~~~python
def memory_list_skills() -> List[Dict[str, Any]]
~~~


List skills/capabilities recorded in memory.

Source: `lightbulb/client.py:2420`.

### `memory_projection_memory`



~~~python
def memory_projection_memory() -> Dict[str, Any]
~~~


Memory-structure projection of the agent.

Source: `lightbulb/client.py:2321`.

### `memory_projection_soul`



~~~python
def memory_projection_soul() -> Dict[str, Any]
~~~


Identity / personality projection of the agent.

Source: `lightbulb/client.py:2314`.

### `memory_query`



~~~python
def memory_query(body: Dict[str, Any]) -> Dict[str, Any]
~~~


Run a structured memory query (filters, time-windows, semantic).

Source: `lightbulb/client.py:2307`.

### `memory_recall`



~~~python
def memory_recall(key: str, *, namespace: str='default') -> Dict[str, Any]
~~~


Recall a value from agent memory.

Source: `lightbulb/client.py:1247`.

### `memory_record_event`



~~~python
def memory_record_event(body: Dict[str, Any]) -> Dict[str, Any]
~~~


Record a memory event.

Source: `lightbulb/client.py:2394`.

### `memory_search`



~~~python
def memory_search(query: str, *, namespace: str='default', top_k: int=5) -> List[Dict[str, Any]]
~~~


Search agent memory semantically (``POST /api/memory/query``).

Maps ``{query, namespace, top_k}`` onto the gateway's
``MemoryQueryRequest`` (``query_text``, ``categories=[namespace]``,
``top_k``) and returns the ranked ``entries`` list from the
``MemoryQueryResponse``. (The ``POST /api/memory/search`` route this used
to target has no handler — the semantic route is ``/query``.)

Source: `lightbulb/client.py:1257`.

### `memory_status`



~~~python
def memory_status() -> Dict[str, Any]
~~~


Health / capacity status of the memory subsystem.

Source: `lightbulb/client.py:2328`.

### `memory_store`



~~~python
def memory_store(key: str, value: str, *, namespace: str='default') -> Dict[str, Any]
~~~


Store a value in agent memory.

Writes to the memory gateway's durable entry store
(``POST /api/memory/entries`` → ``MemoryEntryCreate``). The simple
``{key, value, namespace}`` triple is mapped onto the entry DTO so it
round-trips with :meth:`memory_search`:

- ``namespace`` → ``category`` (the grouping the search scopes by),
- ``value`` → ``summary`` (the retrievable content),
- ``key`` → preserved in ``tags`` and ``details_json`` for later lookup.

Stored as a durable ``semantic`` entry. (The bare ``POST /api/memory``
route this used to target has no handler — it 404'd.)

Source: `lightbulb/client.py:1215`.

### `modify_voice_action`



~~~python
def modify_voice_action(execution_id: str, approval_task_id: str, modifications: Dict[str, Any]) -> Dict[str, Any]
~~~


Approve a voice action with modifications to the proposed payload.

Source: `lightbulb/client.py:1449`.

### `page_builder_capabilities`



~~~python
def page_builder_capabilities(session_id: str) -> Dict[str, Any]
~~~


List page capabilities (forms, search, auth, etc.).

Source: `lightbulb/client.py:2682`.

### `page_builder_deploy`



~~~python
def page_builder_deploy(session_id: str, page_key: str='') -> Dict[str, Any]
~~~


Deploy a page builder session.

Source: `lightbulb/client.py:797`.

### `page_builder_get_preview`



~~~python
def page_builder_get_preview(session_id: str) -> Dict[str, Any]
~~~


Get the preview URL for a page builder session.

Source: `lightbulb/client.py:807`.

### `page_builder_get_schemas`



~~~python
def page_builder_get_schemas(session_id: str) -> Dict[str, Any]
~~~


Get the current page schemas for a session.

Source: `lightbulb/client.py:790`.

### `page_builder_install_artifact`



~~~python
def page_builder_install_artifact(session_id: str, body: Dict[str, Any]) -> Dict[str, Any]
~~~


Install a component artifact into the page session.

Source: `lightbulb/client.py:2671`.

### `page_builder_promote_install_bundle`



~~~python
def page_builder_promote_install_bundle(session_id: str, body: Dict[str, Any]) -> Dict[str, Any]
~~~


Promote an install bundle to the workspace.

Source: `lightbulb/client.py:2660`.

### `page_builder_promote_section`



~~~python
def page_builder_promote_section(session_id: str, body: Dict[str, Any]) -> Dict[str, Any]
~~~


Promote a section artifact to the install bundle.

Source: `lightbulb/client.py:2649`.

### `page_builder_save_backend_contract`



~~~python
def page_builder_save_backend_contract(session_id: str, body: Dict[str, Any]) -> Dict[str, Any]
~~~


Define a backend contract for a page (data shape + agent binding).

Source: `lightbulb/client.py:2703`.

### `page_builder_save_capability`



~~~python
def page_builder_save_capability(session_id: str, body: Dict[str, Any]) -> Dict[str, Any]
~~~


Save a capability to the page session.

Source: `lightbulb/client.py:2692`.

### `page_builder_send_message`



~~~python
def page_builder_send_message(session_id: str, content: str) -> Dict[str, Any]
~~~


Send a message to a page builder session (non-streaming).

Source: `lightbulb/client.py:779`.

### `page_builder_unpublish`



~~~python
def page_builder_unpublish(session_id: str) -> Dict[str, Any]
~~~


Unpublish a deployed page builder session.

Source: `lightbulb/client.py:2714`.

### `page_builder_workspace_automation`



~~~python
def page_builder_workspace_automation(session_id: str, body: Dict[str, Any] | None=None) -> Dict[str, Any]
~~~


Run the page-builder workspace automation (auto-wire pages → agents → backend).

Source: `lightbulb/client.py:2638`.

### `post_aoc_task_event`



~~~python
def post_aoc_task_event(task_id: str, body: Dict[str, Any]) -> Dict[str, Any]
~~~


Post a new event onto an AutoCompany task.

Source: `lightbulb/client.py:2199`.

### `rag_query`



~~~python
def rag_query(question: str, *, top_k: int=5, document_ids: List[str] | None=None) -> Dict[str, Any]
~~~


Query the RAG knowledge base directly.

Source: `lightbulb/client.py:1122`.

### `rag_upload_document`



~~~python
def rag_upload_document(filename: str, content: str, **metadata) -> Dict[str, Any]
~~~


Upload a document to the RAG library.

Source: `lightbulb/client.py:1132`.

### `refresh_auth`



~~~python
def refresh_auth() -> bool
~~~


Run the configured ``auth_refresh`` callback and swap in fresh auth.

Returns ``True`` if a new ``AuthStrategy`` was installed. Callers
typically invoke this after catching :class:`AuthenticationError`,
then retry the failed request:

    try:
        client.dispatch("finance", action="chat", message="...")
    except AuthenticationError:
        if client.refresh_auth():
            client.dispatch("finance", action="chat", message="...")

Source: `lightbulb/client.py:286`.

### `register_external_artifact`



~~~python
def register_external_artifact(*, type: str, title: str='', summary: str='', uri: str='', content: str='', project_id: Optional[str]=None, source_agent: str='external_agent', metadata: Optional[Dict[str, Any]]=None, attach_workspace: bool=False) -> Dict[str, Any]
~~~


Register an external artifact (codebase/document/slide deck/spreadsheet/url) created
by a general agent so Lightbulb domain agents can discover and work on it.

Either ``uri`` or ``content`` must be provided. For a ``codebase`` artifact with a repo
``uri``, set ``attach_workspace=True`` to also clone it into a Code Workspace so Lightbulb
agents can work on it.

Source: `lightbulb/client.py:1012`.

### `register_runtime_action`



~~~python
def register_runtime_action(domain: str, action: str, *, description: str='', agent_spec: Dict[str, Any] | None=None, component_ids: List[str] | None=None, workflow_type: str='') -> Dict[str, Any]
~~~


Author a runtime domain action (``POST /api/domain-agents/runtime-actions``).

Lands as ``pending_approval`` — not dispatchable until approved. Provide
an ``agent_spec`` to author a brand-new agent (``domain`` may be
``"custom"``); without one, ``domain`` must be an existing contract domain
and this adds an action to it. The request body uses the backend's
camelCase keys (``agentSpec``, ``componentIds``, ``workflowType``).

Source: `lightbulb/client.py:1305`.

### `reject_code_workspace_proposal`



~~~python
def reject_code_workspace_proposal(workspace_id: str, proposal_id: str, *, reason: str='') -> Dict[str, Any]
~~~


Reject a proposal.

Source: `lightbulb/client.py:1779`.

### `reject_runtime_action`



~~~python
def reject_runtime_action(action_id: str) -> Dict[str, Any]
~~~


Reject a pending runtime action — ADMIN/TENANT only
(``POST /api/domain-agents/runtime-actions/{id}/reject``).

Source: `lightbulb/client.py:1353`.

### `reject_task`



~~~python
def reject_task(task_id: str, *, comments: str='') -> Dict[str, Any]
~~~


Reject a pending HITL task.

Source: `lightbulb/client.py:1109`.

### `reject_voice_action`



~~~python
def reject_voice_action(execution_id: str, approval_task_id: str, *, comments: str='') -> Dict[str, Any]
~~~


Reject a pending in-call action.

Source: `lightbulb/client.py:1432`.

### `search_documents`



~~~python
def search_documents(query: str, *, folder_path: str | None=None, top_k: int=10) -> DispatchResult
~~~


Search across all documents using semantic search.

Source: `lightbulb/client.py:646`.

### `set_approval_preference_state`



~~~python
def set_approval_preference_state(preference_id: str, *, enabled: bool) -> Dict[str, Any]
~~~


Enable or disable an auto-accept rule.

Source: `lightbulb/client.py:2530`.

### `stop_aoc_run`



~~~python
def stop_aoc_run(run_id: str) -> Dict[str, Any]
~~~


Stop an in-flight AutoCompany cognitive-loop run.

Source: `lightbulb/client.py:2145`.

### `stream_chat`



~~~python
def stream_chat(domain: str, *, message: str, action: str | None=None, inputs: Dict[str, Any] | None=None, conversation_id: str | None=None, company_id: str | None=None) -> Generator[SSEEvent, None, None]
~~~


Stream a domain agent chat via Server-Sent Events.

Yields SSEEvent objects for each event (status, chat, artifact, complete, error).

Source: `lightbulb/client.py:412`.

### `stream_code_workspace_chat`



~~~python
def stream_code_workspace_chat(workspace_id: str, message: str, **kwargs: Any) -> Generator[SSEEvent, None, None]
~~~


Stream a coding agent chat as Server-Sent Events.

Yields SSEEvent objects (status, token, tool_call, diff, complete, error).
The non-streaming counterpart is :meth:`code_workspace_chat`.

Source: `lightbulb/client.py:500`.

### `stream_document_builder_message`



~~~python
def stream_document_builder_message(session_id: str, content: str) -> Generator[SSEEvent, None, None]
~~~


Stream a document builder message via SSE.

Source: `lightbulb/client.py:552`.

### `stream_page_builder_message`



~~~python
def stream_page_builder_message(session_id: str, content: str) -> Generator[SSEEvent, None, None]
~~~


Stream a page builder message via SSE (token-by-token output).

Source: `lightbulb/client.py:523`.

### `stream_page_builder_workspace_automation`



~~~python
def stream_page_builder_workspace_automation(session_id: str, body: Dict[str, Any] | None=None) -> Generator[SSEEvent, None, None]
~~~


Stream the page-builder workspace automation pipeline.

Source: `lightbulb/client.py:538`.

### `submit_code_workspace_proposal`



~~~python
def submit_code_workspace_proposal(workspace_id: str, body: Dict[str, Any]) -> Dict[str, Any]
~~~


Submit a code-change proposal (diff + summary).

Source: `lightbulb/client.py:1757`.

### `trigger_workflow`



~~~python
def trigger_workflow(workflow_type: str, objective: str, *, inputs: Dict[str, Any] | None=None) -> Dict[str, Any]
~~~


Trigger a workflow execution.

Source: `lightbulb/client.py:1072`.

### `update_crm_task`



~~~python
def update_crm_task(task_id: str, body: Dict[str, Any], tenant_id: str | None=None) -> Dict[str, Any]
~~~


Update a CRM task.

Source: `lightbulb/client.py:2473`.

### `update_product_machine_plan`



~~~python
def update_product_machine_plan(project_id: str, plan: Dict[str, Any]) -> Dict[str, Any]
~~~


Replace a project's product-machine plan
(``PUT /api/projects/{id}/product-machine/plan``).

Source: `lightbulb/client.py:964`.

### `validate_aoc_run_config`



~~~python
def validate_aoc_run_config(run_id: str) -> Dict[str, Any]
~~~


Validate an AutoCompany run's configuration.

Source: `lightbulb/client.py:2152`.

### `whoami`



~~~python
def whoami() -> Dict[str, Any]
~~~


Get the current user's identity, role, tenant, company, and permissions.

Source: `lightbulb/client.py:230`.

### `workspace_bundle`



~~~python
def workspace_bundle(domain: str) -> Dict[str, Any]
~~~


Get a domain workspace data bundle (state, surfaces, recent runs).

Source: `lightbulb/client.py:2567`.

### `workspace_conversation`



~~~python
def workspace_conversation(domain: str, conversation_id: str) -> Dict[str, Any]
~~~


Get a domain workspace conversation.

Source: `lightbulb/client.py:2589`.

### `workspace_surface`



~~~python
def workspace_surface(domain: str, surface: str, **filters: Any) -> Dict[str, Any]
~~~


Read a domain workspace surface (e.g. internal_suite, live connector).

Source: `lightbulb/client.py:2600`.

### `workspace_trace`



~~~python
def workspace_trace(domain: str, trace_id: str) -> Dict[str, Any]
~~~


Get a workspace trace (full agent execution log).

Source: `lightbulb/client.py:2578`.

## Asynchronous Python client

### `__aenter__`



~~~python
async def __aenter__() -> 'AsyncLightbulbClient'
~~~


Source: `lightbulb/async_client.py:95`.

### `__aexit__`



~~~python
async def __aexit__(exc_type, exc, tb) -> None
~~~


Source: `lightbulb/async_client.py:99`.

### `active_company_id`



~~~python
@property
def active_company_id() -> str | None
~~~


Source: `lightbulb/async_client.py:141`.

### `active_company_id`



~~~python
@active_company_id.setter
def active_company_id(value: str | None) -> None
~~~


Source: `lightbulb/async_client.py:145`.

### `approve_task`



~~~python
async def approve_task(task_id: str, *, comments: str='') -> Dict[str, Any]
~~~


Source: `lightbulb/async_client.py:483`.

### `approve_voice_action`



~~~python
async def approve_voice_action(execution_id: str, approval_task_id: str, *, comments: str='') -> Dict[str, Any]
~~~


Source: `lightbulb/async_client.py:526`.

### `close`



~~~python
async def close() -> None
~~~


Source: `lightbulb/async_client.py:114`.

### `code_workspace_chat`



~~~python
async def code_workspace_chat(workspace_id: str, message: str, **kwargs: Any) -> Dict[str, Any]
~~~


Source: `lightbulb/async_client.py:405`.

### `dispatch`



~~~python
async def dispatch(domain: str, *, action: str='chat', message: str='', objective: str='', inputs: Dict[str, Any] | None=None, conversation_id: str | None=None, company_id: str | None=None) -> DispatchResult
~~~


Source: `lightbulb/async_client.py:223`.

### `document_builder_get_messages`



~~~python
async def document_builder_get_messages(session_id: str, **filters: Any) -> List[Dict[str, Any]]
~~~


Source: `lightbulb/async_client.py:461`.

### `get_code_workspace_active_run`



~~~python
async def get_code_workspace_active_run(workspace_id: str) -> Dict[str, Any] | None
~~~


Source: `lightbulb/async_client.py:429`.

### `get_code_workspace_run`



~~~python
async def get_code_workspace_run(workspace_id: str, run_id: str) -> Dict[str, Any]
~~~


Source: `lightbulb/async_client.py:420`.

### `invoke_tool`



~~~python
async def invoke_tool(tool_name: str, arguments: Dict[str, Any]) -> Dict[str, Any]
~~~


Invoke a platform tool by name. Mirrors the sync client's wire shape:
``toolName`` + ``inputs`` (plus tenant/company scope from auth).

Source: `lightbulb/async_client.py:561`.

### `list_aoc_runs`



~~~python
async def list_aoc_runs(**filters: Any) -> List[Dict[str, Any]]
~~~


Source: `lightbulb/async_client.py:538`.

### `list_code_workspaces`



~~~python
async def list_code_workspaces() -> List[Dict[str, Any]]
~~~


Source: `lightbulb/async_client.py:399`.

### `list_companies`



~~~python
async def list_companies() -> List[Dict[str, Any]]
~~~


Source: `lightbulb/async_client.py:186`.

### `list_connected_integrations`



~~~python
async def list_connected_integrations(company_id: str | None=None) -> List[Dict[str, Any]]
~~~


Source: `lightbulb/async_client.py:206`.

### `list_domains`



~~~python
async def list_domains() -> List[Dict[str, Any]]
~~~


Source: `lightbulb/async_client.py:197`.

### `list_pending_approvals`



~~~python
async def list_pending_approvals() -> List[Dict[str, Any]]
~~~


Source: `lightbulb/async_client.py:474`.

### `list_voice_executions`



~~~python
async def list_voice_executions(**filters: Any) -> List[Dict[str, Any]]
~~~


Source: `lightbulb/async_client.py:505`.

### `list_voice_pending_approvals`



~~~python
async def list_voice_pending_approvals() -> List[Dict[str, Any]]
~~~


Source: `lightbulb/async_client.py:516`.

### `page_builder_send_message`



~~~python
async def page_builder_send_message(session_id: str, content: str) -> Dict[str, Any]
~~~


Source: `lightbulb/async_client.py:451`.

### `refresh_auth`



~~~python
async def refresh_auth() -> bool
~~~


Async equivalent of :meth:`LightbulbClient.refresh_auth`.

Source: `lightbulb/async_client.py:119`.

### `reject_task`



~~~python
async def reject_task(task_id: str, *, comments: str='') -> Dict[str, Any]
~~~


Source: `lightbulb/async_client.py:493`.

### `search_documents`



~~~python
async def search_documents(query: str, *, top_k: int=10) -> Dict[str, Any]
~~~


Source: `lightbulb/async_client.py:442`.

### `stop_aoc_run`



~~~python
async def stop_aoc_run(run_id: str) -> Dict[str, Any]
~~~


Source: `lightbulb/async_client.py:549`.

### `stream_chat`



~~~python
async def stream_chat(domain: str, *, message: str, action: str | None=None, inputs: Dict[str, Any] | None=None, conversation_id: str | None=None, company_id: str | None=None) -> AsyncGenerator[SSEEvent, None]
~~~


Source: `lightbulb/async_client.py:271`.

### `stream_code_workspace_chat`



~~~python
async def stream_code_workspace_chat(workspace_id: str, message: str, **kwargs: Any) -> AsyncGenerator[SSEEvent, None]
~~~


Source: `lightbulb/async_client.py:303`.

### `stream_document_builder_message`



~~~python
async def stream_document_builder_message(session_id: str, content: str) -> AsyncGenerator[SSEEvent, None]
~~~


Source: `lightbulb/async_client.py:332`.

### `stream_page_builder_message`



~~~python
async def stream_page_builder_message(session_id: str, content: str) -> AsyncGenerator[SSEEvent, None]
~~~


Source: `lightbulb/async_client.py:321`.

### `whoami`



~~~python
async def whoami() -> Dict[str, Any]
~~~


Source: `lightbulb/async_client.py:180`.

## Typed modules and callable/type symbols

## Module `lightbulb.async_client`

Async-native Lightbulb platform client.

Mirrors the most-used methods of :class:`lightbulb.client.LightbulbClient` but
uses ``httpx.AsyncClient`` so callers in asyncio-based applications (FastAPI,
discord.py, aiohttp servers, etc.) don't have to bounce through a thread pool.

Coverage is curated, not exhaustive — the goal is "the methods you'll call in
a hot loop." For niche operations, use :class:`LightbulbClient` directly.

Usage::

    >>> from lightbulb import AsyncLightbulbClient, JwtAuth
    >>> async with AsyncLightbulbClient("https://...", auth=JwtAuth(...)) as c:
    ...     me = await c.whoami()
    ...     async for ev in c.stream_chat("finance", message="Run forecasting"):
    ...         print(ev.event, ev.data)

### `lightbulb.async_client.AsyncLightbulbClient`

class. Source: `lightbulb/async_client.py:50`.

Async client for the Lightbulb platform API.

#### Methods

##### `lightbulb.async_client.AsyncLightbulbClient.__aenter__`



~~~python
async def __aenter__() -> 'AsyncLightbulbClient'
~~~


Source: `lightbulb/async_client.py:95`.

##### `lightbulb.async_client.AsyncLightbulbClient.__aexit__`



~~~python
async def __aexit__(exc_type, exc, tb) -> None
~~~


Source: `lightbulb/async_client.py:99`.

##### `lightbulb.async_client.AsyncLightbulbClient.active_company_id`



~~~python
@property
def active_company_id() -> str | None
~~~


Source: `lightbulb/async_client.py:141`.

##### `lightbulb.async_client.AsyncLightbulbClient.active_company_id`



~~~python
@active_company_id.setter
def active_company_id(value: str | None) -> None
~~~


Source: `lightbulb/async_client.py:145`.

##### `lightbulb.async_client.AsyncLightbulbClient.approve_task`



~~~python
async def approve_task(task_id: str, *, comments: str='') -> Dict[str, Any]
~~~


Source: `lightbulb/async_client.py:483`.

##### `lightbulb.async_client.AsyncLightbulbClient.approve_voice_action`



~~~python
async def approve_voice_action(execution_id: str, approval_task_id: str, *, comments: str='') -> Dict[str, Any]
~~~


Source: `lightbulb/async_client.py:526`.

##### `lightbulb.async_client.AsyncLightbulbClient.close`



~~~python
async def close() -> None
~~~


Source: `lightbulb/async_client.py:114`.

##### `lightbulb.async_client.AsyncLightbulbClient.code_workspace_chat`



~~~python
async def code_workspace_chat(workspace_id: str, message: str, **kwargs: Any) -> Dict[str, Any]
~~~


Source: `lightbulb/async_client.py:405`.

##### `lightbulb.async_client.AsyncLightbulbClient.dispatch`



~~~python
async def dispatch(domain: str, *, action: str='chat', message: str='', objective: str='', inputs: Dict[str, Any] | None=None, conversation_id: str | None=None, company_id: str | None=None) -> DispatchResult
~~~


Source: `lightbulb/async_client.py:223`.

##### `lightbulb.async_client.AsyncLightbulbClient.document_builder_get_messages`



~~~python
async def document_builder_get_messages(session_id: str, **filters: Any) -> List[Dict[str, Any]]
~~~


Source: `lightbulb/async_client.py:461`.

##### `lightbulb.async_client.AsyncLightbulbClient.get_code_workspace_active_run`



~~~python
async def get_code_workspace_active_run(workspace_id: str) -> Dict[str, Any] | None
~~~


Source: `lightbulb/async_client.py:429`.

##### `lightbulb.async_client.AsyncLightbulbClient.get_code_workspace_run`



~~~python
async def get_code_workspace_run(workspace_id: str, run_id: str) -> Dict[str, Any]
~~~


Source: `lightbulb/async_client.py:420`.

##### `lightbulb.async_client.AsyncLightbulbClient.invoke_tool`



~~~python
async def invoke_tool(tool_name: str, arguments: Dict[str, Any]) -> Dict[str, Any]
~~~


Invoke a platform tool by name. Mirrors the sync client's wire shape:
``toolName`` + ``inputs`` (plus tenant/company scope from auth).

Source: `lightbulb/async_client.py:561`.

##### `lightbulb.async_client.AsyncLightbulbClient.list_aoc_runs`



~~~python
async def list_aoc_runs(**filters: Any) -> List[Dict[str, Any]]
~~~


Source: `lightbulb/async_client.py:538`.

##### `lightbulb.async_client.AsyncLightbulbClient.list_code_workspaces`



~~~python
async def list_code_workspaces() -> List[Dict[str, Any]]
~~~


Source: `lightbulb/async_client.py:399`.

##### `lightbulb.async_client.AsyncLightbulbClient.list_companies`



~~~python
async def list_companies() -> List[Dict[str, Any]]
~~~


Source: `lightbulb/async_client.py:186`.

##### `lightbulb.async_client.AsyncLightbulbClient.list_connected_integrations`



~~~python
async def list_connected_integrations(company_id: str | None=None) -> List[Dict[str, Any]]
~~~


Source: `lightbulb/async_client.py:206`.

##### `lightbulb.async_client.AsyncLightbulbClient.list_domains`



~~~python
async def list_domains() -> List[Dict[str, Any]]
~~~


Source: `lightbulb/async_client.py:197`.

##### `lightbulb.async_client.AsyncLightbulbClient.list_pending_approvals`



~~~python
async def list_pending_approvals() -> List[Dict[str, Any]]
~~~


Source: `lightbulb/async_client.py:474`.

##### `lightbulb.async_client.AsyncLightbulbClient.list_voice_executions`



~~~python
async def list_voice_executions(**filters: Any) -> List[Dict[str, Any]]
~~~


Source: `lightbulb/async_client.py:505`.

##### `lightbulb.async_client.AsyncLightbulbClient.list_voice_pending_approvals`



~~~python
async def list_voice_pending_approvals() -> List[Dict[str, Any]]
~~~


Source: `lightbulb/async_client.py:516`.

##### `lightbulb.async_client.AsyncLightbulbClient.page_builder_send_message`



~~~python
async def page_builder_send_message(session_id: str, content: str) -> Dict[str, Any]
~~~


Source: `lightbulb/async_client.py:451`.

##### `lightbulb.async_client.AsyncLightbulbClient.refresh_auth`



~~~python
async def refresh_auth() -> bool
~~~


Async equivalent of :meth:`LightbulbClient.refresh_auth`.

Source: `lightbulb/async_client.py:119`.

##### `lightbulb.async_client.AsyncLightbulbClient.reject_task`



~~~python
async def reject_task(task_id: str, *, comments: str='') -> Dict[str, Any]
~~~


Source: `lightbulb/async_client.py:493`.

##### `lightbulb.async_client.AsyncLightbulbClient.search_documents`



~~~python
async def search_documents(query: str, *, top_k: int=10) -> Dict[str, Any]
~~~


Source: `lightbulb/async_client.py:442`.

##### `lightbulb.async_client.AsyncLightbulbClient.stop_aoc_run`



~~~python
async def stop_aoc_run(run_id: str) -> Dict[str, Any]
~~~


Source: `lightbulb/async_client.py:549`.

##### `lightbulb.async_client.AsyncLightbulbClient.stream_chat`



~~~python
async def stream_chat(domain: str, *, message: str, action: str | None=None, inputs: Dict[str, Any] | None=None, conversation_id: str | None=None, company_id: str | None=None) -> AsyncGenerator[SSEEvent, None]
~~~


Source: `lightbulb/async_client.py:271`.

##### `lightbulb.async_client.AsyncLightbulbClient.stream_code_workspace_chat`



~~~python
async def stream_code_workspace_chat(workspace_id: str, message: str, **kwargs: Any) -> AsyncGenerator[SSEEvent, None]
~~~


Source: `lightbulb/async_client.py:303`.

##### `lightbulb.async_client.AsyncLightbulbClient.stream_document_builder_message`



~~~python
async def stream_document_builder_message(session_id: str, content: str) -> AsyncGenerator[SSEEvent, None]
~~~


Source: `lightbulb/async_client.py:332`.

##### `lightbulb.async_client.AsyncLightbulbClient.stream_page_builder_message`



~~~python
async def stream_page_builder_message(session_id: str, content: str) -> AsyncGenerator[SSEEvent, None]
~~~


Source: `lightbulb/async_client.py:321`.

##### `lightbulb.async_client.AsyncLightbulbClient.whoami`



~~~python
async def whoami() -> Dict[str, Any]
~~~


Source: `lightbulb/async_client.py:180`.

## Module `lightbulb.auth`

Authentication strategies for the Lightbulb API.

Security design:
- API keys and JWTs are never logged, serialised to repr, or included in exceptions.
- Credentials are stored as private attributes and only emitted into outbound headers.
- All credential values are validated on construction (fail-fast).

### `lightbulb.auth.ApiKeyAuth`

class. Source: `lightbulb/auth.py:83`.

Authenticate with a service API key + tenant context.

This is the service-to-service auth path. The key is sent with a tenant
(and optional company) scope header and is only intended for trusted,
loopback/local integration use.

#### Methods

##### `lightbulb.auth.ApiKeyAuth.apply`



~~~python
def apply(headers: Dict[str, str]) -> Dict[str, str]
~~~


Source: `lightbulb/auth.py:105`.

##### `lightbulb.auth.ApiKeyAuth.company_id`



~~~python
@property
def company_id() -> str | None
~~~


Source: `lightbulb/auth.py:119`.

##### `lightbulb.auth.ApiKeyAuth.tenant_id`



~~~python
@property
def tenant_id() -> str
~~~


Source: `lightbulb/auth.py:115`.

### `lightbulb.auth.JwtAuth`

class. Source: `lightbulb/auth.py:126`.

Authenticate with a JWT Bearer token.

This is the user-facing auth path.  The JWT must contain tenantId and
userId claims.

#### Methods

##### `lightbulb.auth.JwtAuth.apply`



~~~python
def apply(headers: Dict[str, str]) -> Dict[str, str]
~~~


Source: `lightbulb/auth.py:145`.

##### `lightbulb.auth.JwtAuth.company_id`



~~~python
@property
def company_id() -> str | None
~~~


Source: `lightbulb/auth.py:158`.

##### `lightbulb.auth.JwtAuth.tenant_id`



~~~python
@property
def tenant_id() -> str
~~~


Source: `lightbulb/auth.py:154`.

### `lightbulb.auth.TwoFactorRequired`

class. Source: `lightbulb/auth.py:165`.

Raised by login() when the user has 2FA enabled and no code was provided.

The caller should prompt for a 6-digit TOTP (or 8-digit backup) code and call
``complete_2fa_login(base_url, email, code)``.

Attributes:
    base_url: The platform URL (so the caller can pass it back).
    email: The email address to use when completing the challenge.
    message: Server-supplied prompt (e.g. "Enter your authenticator code").

### `lightbulb.auth.login`

function. Source: `lightbulb/auth.py:184`.



~~~python
login(base_url: str, email: str, password: str, *, code: str | None=None, timeout: float=15.0, interactive: bool=False) -> JwtAuth
~~~


Authenticate with email/password and return a JwtAuth with the user's real permissions.

The returned JwtAuth goes through the normal JWT auth path in Spring Boot,
meaning all requests are scoped to the user's actual tenant, company, roles,
and RBAC permissions — no privilege escalation.

2FA handling:
    - If the account has 2FA enabled and ``code`` is provided, the SDK
      performs the two-step flow automatically.
    - If 2FA is enabled and no code is provided, the SDK raises
      :class:`TwoFactorRequired`. Catch it, prompt for the code, then call
      :func:`complete_2fa_login` (or call :func:`login` again with ``code``).
    - Pass ``interactive=True`` to read the code from stdin if the platform
      asks for it (suitable for CLIs).

Args:
    base_url: Platform URL (e.g. "https://agents.lightbulbpartners.com")
    email: User's login email
    password: User's password
    code: Optional 6-digit TOTP or 8-digit backup code. Pass this if you
        already know the user has 2FA enabled.
    interactive: If True and stdin is a TTY, prompt for the 2FA code when
        the server reports requires2FA.

Returns:
    JwtAuth configured with the user's JWT, tenant ID, and company ID.

Raises:
    TwoFactorRequired: If the account has 2FA enabled and no code was
        provided (and interactive=False).
    RuntimeError: If login fails (invalid credentials, server error, etc.)
    ValueError: If the response is missing required fields.

### `lightbulb.auth.complete_2fa_login`

function. Source: `lightbulb/auth.py:314`.



~~~python
complete_2fa_login(base_url: str, email: str, code: str, *, timeout: float=15.0) -> JwtAuth
~~~


Complete a two-factor login challenge.

Call this after :func:`login` raises :class:`TwoFactorRequired`, passing the
6-digit TOTP code from the user's authenticator app or an 8-digit backup code.

Args:
    base_url: Platform URL.
    email: The same email used in the initial login call.
    code: 6-digit TOTP code or 8-digit backup code.
    timeout: HTTP timeout.

Returns:
    JwtAuth scoped to the user's permissions.

Raises:
    RuntimeError: If verification fails (bad code, expired, rate-limited).

### `lightbulb.auth.sso_redirect_url`

function. Source: `lightbulb/auth.py:550`.



~~~python
sso_redirect_url(base_url: str, provider: str='google', *, timeout: float=5.0) -> str
~~~


Resolve the OAuth2 SSO start URL for the given provider.

The platform exposes ``GET /api/auth/oauth2/{provider}`` which returns a
JSON envelope ``{"url": "/oauth2/authorization/{provider}"}``. This helper
fetches that envelope, validates it (must be on the same host as
``base_url``, must be http(s), no protocol-relative bypasses), and returns
the absolute URL the caller should redirect to.

Args:
    base_url: Platform base URL.
    provider: Either ``"google"`` or ``"microsoft"``.
    timeout: HTTP timeout.

Returns:
    Fully-qualified SSO start URL on the platform's host.

### `lightbulb.auth.device_login`

function. Source: `lightbulb/auth.py:588`.



~~~python
device_login(base_url: str, client_id: str='claude-code', *, poll_interval: float=5.0, open_browser: bool=True, timeout: float=15.0) -> tuple[JwtAuth, int]
~~~


Authenticate via OAuth2 Device Authorization Grant (RFC 8628).

1. POST /api/auth/device/authorize → device_code + user_code + verification_uri
2. Print instructions, optionally open browser
3. Poll POST /api/auth/device/token until approved/denied/expired
4. Return (JwtAuth, expires_in)

Args:
    base_url: Platform URL
    client_id: Client identifier (default "claude-code")
    poll_interval: Seconds between polls (default 5)
    open_browser: Whether to auto-open the verification URL
    timeout: HTTP request timeout

Returns:
    Tuple of (JwtAuth scoped to user's permissions, expires_in seconds)

Raises:
    RuntimeError: If auth is denied, expired, or fails.

## Module `lightbulb.client`

Lightbulb platform API client.

Usage::

    from lightbulb import LightbulbClient, ApiKeyAuth

    auth = ApiKeyAuth(
        api_key="your-internal-api-key",
        tenant_id="00000000-0000-0000-0000-000000000001",
        user_id="00000000-0000-0000-0000-000000000002",
    )
    client = LightbulbClient("https://agents.lightbulbpartners.com", auth=auth)

    # Dispatch a document agent action
    result = client.dispatch("document_intelligence", action="search_documents", message="quarterly revenue")

    # Stream a domain agent chat
    for event in client.stream_chat("document_intelligence", message="Create a quarterly report"):
        print(event)

Security notes:
- Credentials are injected via the AuthStrategy and never logged.
- All inputs are validated before being sent.
- The client enforces HTTPS in production (non-localhost) by default.
- Request/response bodies are size-bounded to prevent memory exhaustion.

### `lightbulb.client.LightbulbClient`

class. Source: `lightbulb/client.py:184`.

Synchronous client for the Lightbulb platform API.

#### Methods

##### `lightbulb.client.LightbulbClient.active_company_id`



~~~python
@property
def active_company_id() -> str | None
~~~


The currently selected company context (needed for write operations).

Source: `lightbulb/client.py:222`.

##### `lightbulb.client.LightbulbClient.active_company_id`



~~~python
@active_company_id.setter
def active_company_id(value: str | None) -> None
~~~


Source: `lightbulb/client.py:227`.

##### `lightbulb.client.LightbulbClient.apply_aoc_tick`



~~~python
def apply_aoc_tick(tick_id: str, body: Dict[str, Any] | None=None) -> Dict[str, Any]
~~~


Apply a previously-computed AutoCompany tick (committing its decisions).

Source: `lightbulb/client.py:2265`.

##### `lightbulb.client.LightbulbClient.apply_code_workspace_proposal`



~~~python
def apply_code_workspace_proposal(workspace_id: str, proposal_id: str) -> Dict[str, Any]
~~~


Apply a previously-submitted proposal to the workspace files.

Source: `lightbulb/client.py:1768`.

##### `lightbulb.client.LightbulbClient.approve_runtime_action`



~~~python
def approve_runtime_action(action_id: str) -> Dict[str, Any]
~~~


Approve (activate) a pending runtime action — ADMIN/TENANT only
(``POST /api/domain-agents/runtime-actions/{id}/approve``).

Source: `lightbulb/client.py:1341`.

##### `lightbulb.client.LightbulbClient.approve_task`



~~~python
def approve_task(task_id: str, *, comments: str='') -> Dict[str, Any]
~~~


Approve a pending HITL task.

Source: `lightbulb/client.py:1098`.

##### `lightbulb.client.LightbulbClient.approve_voice_action`



~~~python
def approve_voice_action(execution_id: str, approval_task_id: str, *, comments: str='') -> Dict[str, Any]
~~~


Approve a pending in-call action (e.g. transfer, wire info, commit booking).

Source: `lightbulb/client.py:1415`.

##### `lightbulb.client.LightbulbClient.backbone_execute`



~~~python
def backbone_execute(objective: str, *, inputs: Dict[str, Any] | None=None) -> Dict[str, Any]
~~~


Execute a task through the backbone agent (research, analysis, code generation).

Source: `lightbulb/client.py:978`.

##### `lightbulb.client.LightbulbClient.cancel_code_workspace_run`



~~~python
def cancel_code_workspace_run(workspace_id: str, run_id: str) -> Dict[str, Any]
~~~


Cancel an in-flight coding run.

Source: `lightbulb/client.py:1812`.

##### `lightbulb.client.LightbulbClient.claude_session_action`



~~~python
def claude_session_action(workspace_id: str, session_id: str, action: str, body: Dict[str, Any] | None=None) -> Dict[str, Any]
~~~


Perform an action on a Claude SDK session.

action: one of rename, tag, fork, delete, interrupt, mcp/reconnect,
        mcp/toggle, rewind, tasks/stop, compact

Source: `lightbulb/client.py:2024`.

##### `lightbulb.client.LightbulbClient.code_workspace_add_collaborator`



~~~python
def code_workspace_add_collaborator(workspace_id: str, *, email: str | None=None, user_id: str | None=None, role: str='viewer') -> Dict[str, Any]
~~~


Add a collaborator to a code workspace (role: viewer | editor | admin).

Source: `lightbulb/client.py:1572`.

##### `lightbulb.client.LightbulbClient.code_workspace_add_note`



~~~python
def code_workspace_add_note(workspace_id: str, content: str) -> Dict[str, Any]
~~~


Append a workspace note (visible to collaborators).

Source: `lightbulb/client.py:1671`.

##### `lightbulb.client.LightbulbClient.code_workspace_approve_access_request`



~~~python
def code_workspace_approve_access_request(workspace_id: str, request_id: str) -> Dict[str, Any]
~~~


Approve a pending workspace access request.

Source: `lightbulb/client.py:1649`.

##### `lightbulb.client.LightbulbClient.code_workspace_chat`



~~~python
def code_workspace_chat(workspace_id: str, message: str, **kwargs) -> Dict[str, Any]
~~~


Send a chat message to a code workspace.

Source: `lightbulb/client.py:860`.

##### `lightbulb.client.LightbulbClient.code_workspace_clear_policy`



~~~python
def code_workspace_clear_policy(workspace_id: str, request_family: str) -> Dict[str, Any]
~~~


Clear cached policy decisions for a request family.

Source: `lightbulb/client.py:1979`.

##### `lightbulb.client.LightbulbClient.code_workspace_collaboration`



~~~python
def code_workspace_collaboration(workspace_id: str) -> Dict[str, Any]
~~~


Get collaboration info (members, share links, pending requests).

Source: `lightbulb/client.py:1562`.

##### `lightbulb.client.LightbulbClient.code_workspace_create_pull_request`



~~~python
def code_workspace_create_pull_request(workspace_id: str, body: Dict[str, Any] | None=None) -> Dict[str, Any]
~~~


Open a GitHub pull request from the workspace branch.

Source: `lightbulb/client.py:1790`.

##### `lightbulb.client.LightbulbClient.code_workspace_create_share_link`



~~~python
def code_workspace_create_share_link(workspace_id: str, *, role: str='viewer', expires_in_seconds: int | None=None) -> Dict[str, Any]
~~~


Create a share-link token granting access to the workspace.

Source: `lightbulb/client.py:1615`.

##### `lightbulb.client.LightbulbClient.code_workspace_deny_access_request`



~~~python
def code_workspace_deny_access_request(workspace_id: str, request_id: str) -> Dict[str, Any]
~~~


Deny a pending workspace access request.

Source: `lightbulb/client.py:1660`.

##### `lightbulb.client.LightbulbClient.code_workspace_evals`



~~~python
def code_workspace_evals(workspace_id: str) -> Dict[str, Any]
~~~


Get accumulated eval rollups for a workspace's runs.

Source: `lightbulb/client.py:1958`.

##### `lightbulb.client.LightbulbClient.code_workspace_invoke_tool`



~~~python
def code_workspace_invoke_tool(workspace_id: str, tool_key: str, arguments: Dict[str, Any] | None=None) -> Dict[str, Any]
~~~


Invoke a workspace-scoped tool (read/write files, run commands, git ops).

Tool keys are registered in the workspace's runtime catalog. Common keys:
    - ``files.read`` — read a file by path
    - ``files.write`` — write a file
    - ``files.list`` — list directory contents
    - ``shell.run`` — execute a shell command
    - ``git.status`` — show git working-tree state
    - ``git.diff`` — produce a diff
    - ``git.commit`` — create a commit
Use :meth:`code_workspace_runtime_catalog` to discover what's available
for a specific workspace.

Source: `lightbulb/client.py:1825`.

##### `lightbulb.client.LightbulbClient.code_workspace_link_repository`



~~~python
def code_workspace_link_repository(workspace_id: str, body: Dict[str, Any]) -> Dict[str, Any]
~~~


Link a GitHub repository to the workspace.

Source: `lightbulb/client.py:1801`.

##### `lightbulb.client.LightbulbClient.code_workspace_policy_replay`



~~~python
def code_workspace_policy_replay(workspace_id: str, **filters: Any) -> Dict[str, Any]
~~~


Replay a policy decision over historical runs (debug helper).

Source: `lightbulb/client.py:1968`.

##### `lightbulb.client.LightbulbClient.code_workspace_preview`



~~~python
def code_workspace_preview(workspace_id: str) -> Dict[str, Any]
~~~


Get the current preview state (URL, status, last build).

Source: `lightbulb/client.py:1898`.

##### `lightbulb.client.LightbulbClient.code_workspace_preview_proxy`



~~~python
def code_workspace_preview_proxy(workspace_id: str, path: str='', *, method: str='GET', body: Any=None, headers: Dict[str, str] | None=None) -> httpx.Response
~~~


Proxy an HTTP call through the workspace preview.

Returns the raw httpx.Response so callers can inspect status/headers/body.
Use this for headless e2e tests against in-progress code.

Security: caller-supplied ``headers`` are merged BEFORE auth headers, so
a caller cannot overwrite ``Authorization`` / ``X-Tenant-Id`` /
``X-Internal-API-Key``. ``method`` and ``path`` are validated.

Source: `lightbulb/client.py:1919`.

##### `lightbulb.client.LightbulbClient.code_workspace_preview_start`



~~~python
def code_workspace_preview_start(workspace_id: str, body: Dict[str, Any] | None=None) -> Dict[str, Any]
~~~


Start the workspace preview server (renders the in-progress code).

Source: `lightbulb/client.py:1883`.

##### `lightbulb.client.LightbulbClient.code_workspace_preview_stop`



~~~python
def code_workspace_preview_stop(workspace_id: str) -> Dict[str, Any]
~~~


Stop the workspace preview server.

Source: `lightbulb/client.py:1908`.

##### `lightbulb.client.LightbulbClient.code_workspace_promote_policy`



~~~python
def code_workspace_promote_policy(workspace_id: str, body: Dict[str, Any]) -> Dict[str, Any]
~~~


Promote workspace-scoped policy to a higher scope (company/tenant).

Source: `lightbulb/client.py:1990`.

##### `lightbulb.client.LightbulbClient.code_workspace_redeem_share_link`



~~~python
def code_workspace_redeem_share_link(token: str) -> Dict[str, Any]
~~~


Redeem a workspace share-link token to gain access.

Source: `lightbulb/client.py:1638`.

##### `lightbulb.client.LightbulbClient.code_workspace_register_runtime_tools`



~~~python
def code_workspace_register_runtime_tools(workspace_id: str, body: Dict[str, Any]) -> Dict[str, Any]
~~~


Register or update workspace runtime tools.

Source: `lightbulb/client.py:1866`.

##### `lightbulb.client.LightbulbClient.code_workspace_remove_collaborator`



~~~python
def code_workspace_remove_collaborator(workspace_id: str, collaborator_id: str) -> None
~~~


Revoke a collaborator's access.

Source: `lightbulb/client.py:1606`.

##### `lightbulb.client.LightbulbClient.code_workspace_revoke_share_link`



~~~python
def code_workspace_revoke_share_link(workspace_id: str, link_id: str) -> None
~~~


Revoke a share link.

Source: `lightbulb/client.py:1629`.

##### `lightbulb.client.LightbulbClient.code_workspace_run_review`



~~~python
def code_workspace_run_review(workspace_id: str, run_id: str, *, verdict: str, feedback: str='') -> Dict[str, Any]
~~~


Submit a human review verdict (accept | reject | request_changes) for a run.

Source: `lightbulb/client.py:1717`.

##### `lightbulb.client.LightbulbClient.code_workspace_run_review_apply`



~~~python
def code_workspace_run_review_apply(workspace_id: str, run_id: str) -> Dict[str, Any]
~~~


Apply review-suggested changes to the workspace.

Source: `lightbulb/client.py:1735`.

##### `lightbulb.client.LightbulbClient.code_workspace_run_telemetry`



~~~python
def code_workspace_run_telemetry(workspace_id: str, **filters: Any) -> Dict[str, Any]
~~~


Raw telemetry rows for a workspace's runs.

Source: `lightbulb/client.py:1706`.

##### `lightbulb.client.LightbulbClient.code_workspace_runs_insights`



~~~python
def code_workspace_runs_insights(workspace_id: str) -> Dict[str, Any]
~~~


Aggregate run-quality insights for a workspace (cost, latency, success rate).

Source: `lightbulb/client.py:1696`.

##### `lightbulb.client.LightbulbClient.code_workspace_runtime_catalog`



~~~python
def code_workspace_runtime_catalog(workspace_id: str) -> Dict[str, Any]
~~~


Read the workspace's runtime tool catalog (which tool keys are available).

Source: `lightbulb/client.py:1856`.

##### `lightbulb.client.LightbulbClient.code_workspace_update_collaborator`



~~~python
def code_workspace_update_collaborator(workspace_id: str, collaborator_id: str, *, role: str) -> Dict[str, Any]
~~~


Change a collaborator's role.

Source: `lightbulb/client.py:1595`.

##### `lightbulb.client.LightbulbClient.codex_thread_action`



~~~python
def codex_thread_action(workspace_id: str, thread_id: str, action: str, body: Dict[str, Any] | None=None) -> Dict[str, Any]
~~~


Perform a thread-level action (rename | archive | unarchive | compact | rollback).

Source: `lightbulb/client.py:2073`.

##### `lightbulb.client.LightbulbClient.codex_turn_action`



~~~python
def codex_turn_action(workspace_id: str, thread_id: str, turn_id: str, action: str, body: Dict[str, Any] | None=None) -> Dict[str, Any]
~~~


Steer or interrupt a specific Codex turn (action: steer | interrupt).

Source: `lightbulb/client.py:2094`.

##### `lightbulb.client.LightbulbClient.compute_aoc_tick`



~~~python
def compute_aoc_tick(body: Dict[str, Any] | None=None) -> Dict[str, Any]
~~~


Run a one-shot AutoCompany tick computation.

Source: `lightbulb/client.py:2254`.

##### `lightbulb.client.LightbulbClient.create_aoc_run`



~~~python
def create_aoc_run(body: Dict[str, Any]) -> Dict[str, Any]
~~~


Create a new AutoCompany run.

Source: `lightbulb/client.py:2131`.

##### `lightbulb.client.LightbulbClient.create_aoc_task`



~~~python
def create_aoc_task(body: Dict[str, Any]) -> Dict[str, Any]
~~~


Create an AutoCompany task.

Source: `lightbulb/client.py:2174`.

##### `lightbulb.client.LightbulbClient.create_approval_auto_accept`



~~~python
def create_approval_auto_accept(task_id: str, body: Dict[str, Any] | None=None) -> Dict[str, Any]
~~~


Create an auto-accept rule keyed off the shape of an existing approval task.

Source: `lightbulb/client.py:2508`.

##### `lightbulb.client.LightbulbClient.create_code_workspace`



~~~python
def create_code_workspace(*, source: str | None=None, repo_connection_id: str | None=None, branch: str | None=None, depth: int | None=None, label: str | None=None, metadata: Dict[str, Any] | None=None, company_id: str | None=None) -> Dict[str, Any]
~~~


Create a code workspace.

Source: `lightbulb/client.py:816`.

##### `lightbulb.client.LightbulbClient.create_conversation`



~~~python
def create_conversation(domain: str) -> Dict[str, Any]
~~~


Create a new conversation for a domain.

Source: `lightbulb/client.py:587`.

##### `lightbulb.client.LightbulbClient.create_crm_task`



~~~python
def create_crm_task(body: Dict[str, Any], tenant_id: str | None=None) -> Dict[str, Any]
~~~


Create a CRM task.

Source: `lightbulb/client.py:2461`.

##### `lightbulb.client.LightbulbClient.create_document`



~~~python
def create_document(title: str, body: str, *, format: str='docx', target_suite: str='internal_library') -> DispatchResult
~~~


Create a new document.

Source: `lightbulb/client.py:706`.

##### `lightbulb.client.LightbulbClient.create_document_session`



~~~python
def create_document_session(*, document_type: str='general', document_title: str='Untitled Document') -> Dict[str, Any]
~~~


Create a new document builder session.

Source: `lightbulb/client.py:606`.

##### `lightbulb.client.LightbulbClient.create_page_builder_session`



~~~python
def create_page_builder_session(brand_name: str='', initial_prompt: str='') -> Dict[str, Any]
~~~


Create a new page builder session.

Source: `lightbulb/client.py:759`.

##### `lightbulb.client.LightbulbClient.create_project`



~~~python
def create_project(name: str, *, instructions: str='', workspace_id: str | None=None, repo_connection_id: str | None=None, product_machine_plan: Dict[str, Any] | None=None, idempotency_key: str | None=None) -> Dict[str, Any]
~~~


Create a Lightbulb project (``POST /api/projects`` → ``ProjectCreateRequest``).

``name`` is required. Optionally bind a code workspace / repo connection
and seed the product-machine plan. Pass ``idempotency_key`` to make a
retried create return the existing project instead of duplicating it
(sent via the ``Idempotency-Key`` header the controller honours).

Source: `lightbulb/client.py:899`.

##### `lightbulb.client.LightbulbClient.create_slide_deck`



~~~python
def create_slide_deck(title: str, body: str='', *, target_suite: str='internal_library') -> DispatchResult
~~~


Create a new slide deck.

Source: `lightbulb/client.py:742`.

##### `lightbulb.client.LightbulbClient.create_spreadsheet`



~~~python
def create_spreadsheet(title: str, body: str='', *, target_suite: str='internal_library') -> DispatchResult
~~~


Create a new spreadsheet.

Source: `lightbulb/client.py:727`.

##### `lightbulb.client.LightbulbClient.delete_approval_preference`



~~~python
def delete_approval_preference(preference_id: str) -> Dict[str, Any]
~~~


Remove an auto-accept rule.

Source: `lightbulb/client.py:2519`.

##### `lightbulb.client.LightbulbClient.delete_conversation`



~~~python
def delete_conversation(domain: str, conversation_id: str) -> None
~~~


Delete a conversation.

Source: `lightbulb/client.py:596`.

##### `lightbulb.client.LightbulbClient.delete_crm_task`



~~~python
def delete_crm_task(task_id: str, tenant_id: str | None=None) -> None
~~~


Delete a CRM task.

Source: `lightbulb/client.py:2485`.

##### `lightbulb.client.LightbulbClient.dispatch`



~~~python
def dispatch(domain: str, *, action: str='chat', message: str='', objective: str='', inputs: Dict[str, Any] | None=None, conversation_id: str | None=None, company_id: str | None=None) -> DispatchResult
~~~


Dispatch a one-shot action to a domain agent and wait for the result.

Source: `lightbulb/client.py:361`.

##### `lightbulb.client.LightbulbClient.document_builder_add_collaborator`



~~~python
def document_builder_add_collaborator(session_id: str, *, email: str | None=None, user_id: str | None=None, role: str='viewer') -> Dict[str, Any]
~~~


Add a collaborator to a document builder session.

Source: `lightbulb/client.py:2737`.

##### `lightbulb.client.LightbulbClient.document_builder_add_note`



~~~python
def document_builder_add_note(session_id: str, content: str) -> Dict[str, Any]
~~~


Add a note to a document builder session.

Source: `lightbulb/client.py:2886`.

##### `lightbulb.client.LightbulbClient.document_builder_collaboration`



~~~python
def document_builder_collaboration(session_id: str) -> Dict[str, Any]
~~~


Collaboration info for a document builder session.

Source: `lightbulb/client.py:2727`.

##### `lightbulb.client.LightbulbClient.document_builder_create_share_link`



~~~python
def document_builder_create_share_link(session_id: str, *, role: str='viewer', expires_in_seconds: int | None=None) -> Dict[str, Any]
~~~


Create a share-link token for a document builder session.

Source: `lightbulb/client.py:2760`.

##### `lightbulb.client.LightbulbClient.document_builder_get_messages`



~~~python
def document_builder_get_messages(session_id: str, **filters: Any) -> List[Dict[str, Any]]
~~~


Get the message history for a document builder session.

Source: `lightbulb/client.py:2785`.

##### `lightbulb.client.LightbulbClient.document_builder_redeem_share_link`



~~~python
def document_builder_redeem_share_link(session_id: str, token: str) -> Dict[str, Any]
~~~


Redeem a document builder share link.

Source: `lightbulb/client.py:2774`.

##### `lightbulb.client.LightbulbClient.document_builder_save`



~~~python
def document_builder_save(session_id: str, body: Dict[str, Any] | None=None) -> Dict[str, Any]
~~~


Save a document builder session's current state.

Source: `lightbulb/client.py:2797`.

##### `lightbulb.client.LightbulbClient.get_aoc_decision`



~~~python
def get_aoc_decision(decision_id: str) -> Dict[str, Any]
~~~


Get a specific AutoCompany decision.

Source: `lightbulb/client.py:2222`.

##### `lightbulb.client.LightbulbClient.get_aoc_run`



~~~python
def get_aoc_run(run_id: str) -> Dict[str, Any]
~~~


Get an AutoCompany run detail.

Source: `lightbulb/client.py:2138`.

##### `lightbulb.client.LightbulbClient.get_aoc_task`



~~~python
def get_aoc_task(task_id: str) -> Dict[str, Any]
~~~


Get an AutoCompany task detail.

Source: `lightbulb/client.py:2181`.

##### `lightbulb.client.LightbulbClient.get_aoc_tick`



~~~python
def get_aoc_tick(tick_id: str) -> Dict[str, Any]
~~~


Get a single AutoCompany tick.

Source: `lightbulb/client.py:2244`.

##### `lightbulb.client.LightbulbClient.get_approval`



~~~python
def get_approval(task_id: str) -> Dict[str, Any]
~~~


Get full details of an approval task.

Source: `lightbulb/client.py:1091`.

##### `lightbulb.client.LightbulbClient.get_artifact`



~~~python
def get_artifact(artifact_id: str) -> Dict[str, Any]
~~~


Get a specific artifact by ID.

Source: `lightbulb/client.py:1005`.

##### `lightbulb.client.LightbulbClient.get_code_workspace_active_run`



~~~python
def get_code_workspace_active_run(workspace_id: str) -> Dict[str, Any] | None
~~~


Get the currently active run for a code workspace, if one exists.

Source: `lightbulb/client.py:875`.

##### `lightbulb.client.LightbulbClient.get_code_workspace_claude_session`



~~~python
def get_code_workspace_claude_session(workspace_id: str, session_id: str) -> Dict[str, Any]
~~~


Get a single Claude SDK session.

Source: `lightbulb/client.py:2014`.

##### `lightbulb.client.LightbulbClient.get_code_workspace_codex_thread`



~~~python
def get_code_workspace_codex_thread(workspace_id: str, thread_id: str) -> Dict[str, Any]
~~~


Get a Codex thread (turns, status, metadata).

Source: `lightbulb/client.py:2063`.

##### `lightbulb.client.LightbulbClient.get_code_workspace_run`



~~~python
def get_code_workspace_run(workspace_id: str, run_id: str) -> Dict[str, Any]
~~~


Get a specific code workspace run.

Source: `lightbulb/client.py:887`.

##### `lightbulb.client.LightbulbClient.get_conversation`



~~~python
def get_conversation(domain: str, conversation_id: str) -> Dict[str, Any]
~~~


Get conversation history.

Source: `lightbulb/client.py:578`.

##### `lightbulb.client.LightbulbClient.get_crm_task`



~~~python
def get_crm_task(task_id: str, tenant_id: str | None=None) -> Dict[str, Any]
~~~


Get a single CRM task.

Source: `lightbulb/client.py:2450`.

##### `lightbulb.client.LightbulbClient.get_document_schemas`



~~~python
def get_document_schemas(session_id: str) -> Dict[str, Any]
~~~


Get the document schemas for a session.

Source: `lightbulb/client.py:636`.

##### `lightbulb.client.LightbulbClient.get_document_session`



~~~python
def get_document_session(session_id: str) -> Dict[str, Any]
~~~


Get a document builder session.

Source: `lightbulb/client.py:628`.

##### `lightbulb.client.LightbulbClient.get_product_machine_plan`



~~~python
def get_product_machine_plan(project_id: str) -> Dict[str, Any]
~~~


Get a project's product-machine plan / deliverables
(``GET /api/projects/{id}/product-machine/plan``).

Source: `lightbulb/client.py:953`.

##### `lightbulb.client.LightbulbClient.get_project`



~~~python
def get_project(project_id: str) -> Dict[str, Any]
~~~


Get a single project (``GET /api/projects/{id}``).

Source: `lightbulb/client.py:943`.

##### `lightbulb.client.LightbulbClient.get_voice_execution`



~~~python
def get_voice_execution(execution_id: str) -> Dict[str, Any]
~~~


Get a voice execution detail (transcripts, status, agent decisions).

Source: `lightbulb/client.py:1394`.

##### `lightbulb.client.LightbulbClient.get_workflow`



~~~python
def get_workflow(workflow_id: str) -> Dict[str, Any]
~~~


Get a workflow by ID.

Source: `lightbulb/client.py:1065`.

##### `lightbulb.client.LightbulbClient.grep_documents`



~~~python
def grep_documents(pattern: str, *, regex: bool=True, case_sensitive: bool=False, folder_path: str | None=None, top_k: int=20) -> DispatchResult
~~~


Grep across document content using pattern matching.

Source: `lightbulb/client.py:664`.

##### `lightbulb.client.LightbulbClient.hr_live_advance_application`



~~~python
def hr_live_advance_application(application_id: str, *, body: Dict[str, Any] | None=None) -> Dict[str, Any]
~~~


Advance a Greenhouse candidate to the next stage (HITL-gated).

Source: `lightbulb/client.py:1531`.

##### `lightbulb.client.LightbulbClient.hr_live_cases`



~~~python
def hr_live_cases(**filters: Any) -> Dict[str, Any]
~~~


HR case board items from Monday.com.

Source: `lightbulb/client.py:1498`.

##### `lightbulb.client.LightbulbClient.hr_live_health`



~~~python
def hr_live_health() -> Dict[str, Any]
~~~


Health check for HR connector tokens (BambooHR / Greenhouse / Monday).

Source: `lightbulb/client.py:1553`.

##### `lightbulb.client.LightbulbClient.hr_live_leave_balance`



~~~python
def hr_live_leave_balance(bamboo_employee_id: str) -> Dict[str, Any]
~~~


BambooHR leave balance for an employee.

Source: `lightbulb/client.py:1478`.

##### `lightbulb.client.LightbulbClient.hr_live_monday_onboarding_board`



~~~python
def hr_live_monday_onboarding_board(checklist_id: str) -> Dict[str, Any]
~~~


Monday.com board view for an HR onboarding checklist.

Source: `lightbulb/client.py:1488`.

##### `lightbulb.client.LightbulbClient.hr_live_recruiting_applications`



~~~python
def hr_live_recruiting_applications(**filters: Any) -> Dict[str, Any]
~~~


Greenhouse applications.

Source: `lightbulb/client.py:1520`.

##### `lightbulb.client.LightbulbClient.hr_live_recruiting_jobs`



~~~python
def hr_live_recruiting_jobs(**filters: Any) -> Dict[str, Any]
~~~


Greenhouse job listings.

Source: `lightbulb/client.py:1509`.

##### `lightbulb.client.LightbulbClient.hr_live_reject_application`



~~~python
def hr_live_reject_application(application_id: str, *, body: Dict[str, Any] | None=None) -> Dict[str, Any]
~~~


Reject a Greenhouse application (HITL-gated).

Source: `lightbulb/client.py:1542`.

##### `lightbulb.client.LightbulbClient.hr_live_whos_out`



~~~python
def hr_live_whos_out(**filters: Any) -> Dict[str, Any]
~~~


BambooHR who's-out roster (current and upcoming time-off).

Source: `lightbulb/client.py:1467`.

##### `lightbulb.client.LightbulbClient.invoke_tool`



~~~python
def invoke_tool(tool_name: str, arguments: Dict[str, Any]) -> Dict[str, Any]
~~~


Invoke a platform tool by name (e.g. connector tools, utility tools).

Posts to ``POST /api/tools/invoke`` with ``toolName`` + ``inputs`` (plus
tenant/company scope from auth so the platform's RBAC + HITL machinery
can resolve the binding without re-reading the JWT for every field).

Source: `lightbulb/client.py:1150`.

##### `lightbulb.client.LightbulbClient.it_ops_live_connector`



~~~python
def it_ops_live_connector(connector: str, **filters: Any) -> Dict[str, Any]
~~~


Pass-through to a live IT-Ops connector (jira | slack | github | notion).

Source: `lightbulb/client.py:2612`.

##### `lightbulb.client.LightbulbClient.it_ops_mcp_manifest`



~~~python
def it_ops_mcp_manifest() -> Dict[str, Any]
~~~


Get the IT-Ops workspace MCP manifest.

Source: `lightbulb/client.py:2626`.

##### `lightbulb.client.LightbulbClient.list_aoc_decisions`



~~~python
def list_aoc_decisions(**filters: Any) -> List[Dict[str, Any]]
~~~


List AutoCompany decisions awaiting or post-resolution.

Source: `lightbulb/client.py:2210`.

##### `lightbulb.client.LightbulbClient.list_aoc_runs`



~~~python
def list_aoc_runs(**filters: Any) -> List[Dict[str, Any]]
~~~


List AutoCompany cognitive-loop runs.

Source: `lightbulb/client.py:2119`.

##### `lightbulb.client.LightbulbClient.list_aoc_task_events`



~~~python
def list_aoc_task_events(task_id: str) -> List[Dict[str, Any]]
~~~


List events recorded against an AutoCompany task.

Source: `lightbulb/client.py:2188`.

##### `lightbulb.client.LightbulbClient.list_aoc_tasks`



~~~python
def list_aoc_tasks(**filters: Any) -> List[Dict[str, Any]]
~~~


List AutoCompany tasks.

Source: `lightbulb/client.py:2162`.

##### `lightbulb.client.LightbulbClient.list_aoc_ticks`



~~~python
def list_aoc_ticks(**filters: Any) -> List[Dict[str, Any]]
~~~


List AutoCompany cognitive-loop ticks.

Source: `lightbulb/client.py:2232`.

##### `lightbulb.client.LightbulbClient.list_approval_preferences`



~~~python
def list_approval_preferences() -> List[Dict[str, Any]]
~~~


List the user's HITL auto-accept rules.

Source: `lightbulb/client.py:2497`.

##### `lightbulb.client.LightbulbClient.list_artifacts`



~~~python
def list_artifacts(**filters) -> List[Dict[str, Any]]
~~~


List artifacts (charts, reports, analyses, etc.).

Source: `lightbulb/client.py:993`.

##### `lightbulb.client.LightbulbClient.list_code_workspace_claude_sessions`



~~~python
def list_code_workspace_claude_sessions(workspace_id: str) -> List[Dict[str, Any]]
~~~


List Claude SDK sessions associated with a workspace.

Source: `lightbulb/client.py:2003`.

##### `lightbulb.client.LightbulbClient.list_code_workspace_codex_threads`



~~~python
def list_code_workspace_codex_threads(workspace_id: str, **filters: Any) -> List[Dict[str, Any]]
~~~


List Codex runtime threads attached to a workspace.

Source: `lightbulb/client.py:2051`.

##### `lightbulb.client.LightbulbClient.list_code_workspace_proposals`



~~~python
def list_code_workspace_proposals(workspace_id: str) -> List[Dict[str, Any]]
~~~


List code-change proposals submitted to the workspace.

Source: `lightbulb/client.py:1746`.

##### `lightbulb.client.LightbulbClient.list_code_workspace_runs`



~~~python
def list_code_workspace_runs(workspace_id: str, **filters: Any) -> List[Dict[str, Any]]
~~~


List historical coding runs for a workspace.

Source: `lightbulb/client.py:1684`.

##### `lightbulb.client.LightbulbClient.list_code_workspaces`



~~~python
def list_code_workspaces() -> List[Dict[str, Any]]
~~~


List code workspaces.

Source: `lightbulb/client.py:853`.

##### `lightbulb.client.LightbulbClient.list_companies`



~~~python
def list_companies() -> List[Dict[str, Any]]
~~~


List companies the user has access to within their tenant.

Source: `lightbulb/client.py:253`.

##### `lightbulb.client.LightbulbClient.list_connected_integrations`



~~~python
def list_connected_integrations(company_id: str | None=None) -> List[Dict[str, Any]]
~~~


List connected integrations (OAuth connections) for the current company scope.

Source: `lightbulb/client.py:237`.

##### `lightbulb.client.LightbulbClient.list_connectors`



~~~python
def list_connectors() -> List[Dict[str, Any]]
~~~


List available connectors and their status.

Source: `lightbulb/client.py:1142`.

##### `lightbulb.client.LightbulbClient.list_contacts`



~~~python
def list_contacts(**filters) -> List[Dict[str, Any]]
~~~


List CRM contacts.

Source: `lightbulb/client.py:1175`.

##### `lightbulb.client.LightbulbClient.list_conversations`



~~~python
def list_conversations(domain: str) -> List[Dict[str, Any]]
~~~


List all conversations for a domain.

Source: `lightbulb/client.py:569`.

##### `lightbulb.client.LightbulbClient.list_crm_tasks`



~~~python
def list_crm_tasks(tenant_id: str | None=None, **filters: Any) -> List[Dict[str, Any]]
~~~


List CRM tasks scoped to a tenant (defaults to authed tenant).

Source: `lightbulb/client.py:2437`.

##### `lightbulb.client.LightbulbClient.list_deals`



~~~python
def list_deals(**filters) -> List[Dict[str, Any]]
~~~


List CRM deals/opportunities.

Source: `lightbulb/client.py:1187`.

##### `lightbulb.client.LightbulbClient.list_document_sessions`



~~~python
def list_document_sessions() -> List[Dict[str, Any]]
~~~


List document builder sessions.

Source: `lightbulb/client.py:620`.

##### `lightbulb.client.LightbulbClient.list_domain_actions`



~~~python
def list_domain_actions(domain: str) -> List[Dict[str, Any]]
~~~


List available actions for a specific domain agent.

Source: `lightbulb/client.py:1291`.

##### `lightbulb.client.LightbulbClient.list_domains`



~~~python
def list_domains() -> List[Dict[str, Any]]
~~~


List all available domain agents and their capabilities.

Source: `lightbulb/client.py:1284`.

##### `lightbulb.client.LightbulbClient.list_folder`



~~~python
def list_folder(folder_path: str='', *, source_system: str | None=None, max_items: int=100) -> DispatchResult
~~~


List documents in a folder.

Source: `lightbulb/client.py:689`.

##### `lightbulb.client.LightbulbClient.list_notifications`



~~~python
def list_notifications(**filters) -> List[Dict[str, Any]]
~~~


List notifications (HITL decisions, workflow alerts, system messages).

Source: `lightbulb/client.py:1201`.

##### `lightbulb.client.LightbulbClient.list_page_builder_sessions`



~~~python
def list_page_builder_sessions() -> List[Dict[str, Any]]
~~~


List page builder sessions.

Source: `lightbulb/client.py:771`.

##### `lightbulb.client.LightbulbClient.list_pending_approvals`



~~~python
def list_pending_approvals() -> List[Dict[str, Any]]
~~~


List pending HITL approval tasks waiting for your decision.

Source: `lightbulb/client.py:1084`.

##### `lightbulb.client.LightbulbClient.list_projects`



~~~python
def list_projects() -> List[Dict[str, Any]]
~~~


List the caller's projects (``GET /api/projects``).

Source: `lightbulb/client.py:935`.

##### `lightbulb.client.LightbulbClient.list_runtime_actions`



~~~python
def list_runtime_actions(status: str='active') -> Dict[str, Any]
~~~


List runtime domain actions by status
(``GET /api/domain-agents/runtime-actions?status=``).

Returns the controller's ``{status, count, actions:[...]}`` envelope.

Source: `lightbulb/client.py:1365`.

##### `lightbulb.client.LightbulbClient.list_voice_executions`



~~~python
def list_voice_executions(**filters: Any) -> List[Dict[str, Any]]
~~~


List voice agent executions (live and historical phone calls).

Source: `lightbulb/client.py:1382`.

##### `lightbulb.client.LightbulbClient.list_voice_pending_approvals`



~~~python
def list_voice_pending_approvals() -> List[Dict[str, Any]]
~~~


List in-call HITL approvals waiting for caller-side decision.

Source: `lightbulb/client.py:1404`.

##### `lightbulb.client.LightbulbClient.list_workflows`



~~~python
def list_workflows() -> List[Dict[str, Any]]
~~~


List workflow definitions.

Source: `lightbulb/client.py:1057`.

##### `lightbulb.client.LightbulbClient.mark_all_notifications_read`



~~~python
def mark_all_notifications_read() -> Dict[str, Any]
~~~


Mark all notifications as read.

Source: `lightbulb/client.py:2554`.

##### `lightbulb.client.LightbulbClient.mark_notification_read`



~~~python
def mark_notification_read(notification_id: str) -> Dict[str, Any]
~~~


Mark a single notification as read.

Source: `lightbulb/client.py:2543`.

##### `lightbulb.client.LightbulbClient.marketing_add_website_analytics_site`



~~~python
def marketing_add_website_analytics_site(body: Dict[str, Any]) -> Dict[str, Any]
~~~


Register a website with the analytics setup.

Source: `lightbulb/client.py:2832`.

##### `lightbulb.client.LightbulbClient.marketing_content_configure_provider`



~~~python
def marketing_content_configure_provider(provider: str, body: Dict[str, Any]) -> Dict[str, Any]
~~~


Configure a marketing-content provider (e.g. ga4, segment, plausible).

Source: `lightbulb/client.py:2820`.

##### `lightbulb.client.LightbulbClient.marketing_content_setup`



~~~python
def marketing_content_setup() -> Dict[str, Any]
~~~


Get the marketing content connector setup state.

Source: `lightbulb/client.py:2810`.

##### `lightbulb.client.LightbulbClient.marketing_install_website_analytics`



~~~python
def marketing_install_website_analytics(workspace_id: str, body: Dict[str, Any] | None=None) -> Dict[str, Any]
~~~


Install website analytics into a code workspace.

Source: `lightbulb/client.py:2875`.

##### `lightbulb.client.LightbulbClient.marketing_remove_website_analytics_site`



~~~python
def marketing_remove_website_analytics_site(site_id: str) -> Dict[str, Any]
~~~


Remove a registered analytics site.

Source: `lightbulb/client.py:2854`.

##### `lightbulb.client.LightbulbClient.marketing_select_website_analytics_site`



~~~python
def marketing_select_website_analytics_site(site_id: str) -> Dict[str, Any]
~~~


Activate a registered analytics site.

Source: `lightbulb/client.py:2843`.

##### `lightbulb.client.LightbulbClient.marketing_verify_website_analytics`



~~~python
def marketing_verify_website_analytics(body: Dict[str, Any] | None=None) -> Dict[str, Any]
~~~


Verify the website analytics setup is wired correctly.

Source: `lightbulb/client.py:2864`.

##### `lightbulb.client.LightbulbClient.memory_add_skill`



~~~python
def memory_add_skill(body: Dict[str, Any]) -> Dict[str, Any]
~~~


Record a new skill / capability.

Source: `lightbulb/client.py:2428`.

##### `lightbulb.client.LightbulbClient.memory_create_entry`



~~~python
def memory_create_entry(body: Dict[str, Any]) -> Dict[str, Any]
~~~


Create a structured memory entry.

Source: `lightbulb/client.py:2300`.

##### `lightbulb.client.LightbulbClient.memory_create_identity`



~~~python
def memory_create_identity(body: Dict[str, Any]) -> Dict[str, Any]
~~~


Create an identity record.

Source: `lightbulb/client.py:2365`.

##### `lightbulb.client.LightbulbClient.memory_create_link`



~~~python
def memory_create_link(body: Dict[str, Any]) -> Dict[str, Any]
~~~


Create a memory link between two entities.

Source: `lightbulb/client.py:2413`.

##### `lightbulb.client.LightbulbClient.memory_get_entry`



~~~python
def memory_get_entry(entry_id: str) -> Dict[str, Any]
~~~


Get a specific memory entry.

Source: `lightbulb/client.py:2290`.

##### `lightbulb.client.LightbulbClient.memory_get_identity`



~~~python
def memory_get_identity(doc_id: str) -> Dict[str, Any]
~~~


Get an identity record by doc id.

Source: `lightbulb/client.py:2372`.

##### `lightbulb.client.LightbulbClient.memory_graph`



~~~python
def memory_graph(**filters: Any) -> Dict[str, Any]
~~~


Full memory graph (or filtered subgraph).

Source: `lightbulb/client.py:2335`.

##### `lightbulb.client.LightbulbClient.memory_graph_node`



~~~python
def memory_graph_node(node_id: str) -> Dict[str, Any]
~~~


Get a single node from the memory graph.

Source: `lightbulb/client.py:2346`.

##### `lightbulb.client.LightbulbClient.memory_list_entries`



~~~python
def memory_list_entries(**filters: Any) -> List[Dict[str, Any]]
~~~


List memory entries (structured records).

Source: `lightbulb/client.py:2278`.

##### `lightbulb.client.LightbulbClient.memory_list_events`



~~~python
def memory_list_events(**filters: Any) -> List[Dict[str, Any]]
~~~


List memory events (timeline of state changes).

Source: `lightbulb/client.py:2382`.

##### `lightbulb.client.LightbulbClient.memory_list_identity`



~~~python
def memory_list_identity() -> List[Dict[str, Any]]
~~~


List identity records in the memory graph.

Source: `lightbulb/client.py:2357`.

##### `lightbulb.client.LightbulbClient.memory_list_links`



~~~python
def memory_list_links(**filters: Any) -> List[Dict[str, Any]]
~~~


List entity links in the memory graph.

Source: `lightbulb/client.py:2401`.

##### `lightbulb.client.LightbulbClient.memory_list_skills`



~~~python
def memory_list_skills() -> List[Dict[str, Any]]
~~~


List skills/capabilities recorded in memory.

Source: `lightbulb/client.py:2420`.

##### `lightbulb.client.LightbulbClient.memory_projection_memory`



~~~python
def memory_projection_memory() -> Dict[str, Any]
~~~


Memory-structure projection of the agent.

Source: `lightbulb/client.py:2321`.

##### `lightbulb.client.LightbulbClient.memory_projection_soul`



~~~python
def memory_projection_soul() -> Dict[str, Any]
~~~


Identity / personality projection of the agent.

Source: `lightbulb/client.py:2314`.

##### `lightbulb.client.LightbulbClient.memory_query`



~~~python
def memory_query(body: Dict[str, Any]) -> Dict[str, Any]
~~~


Run a structured memory query (filters, time-windows, semantic).

Source: `lightbulb/client.py:2307`.

##### `lightbulb.client.LightbulbClient.memory_recall`



~~~python
def memory_recall(key: str, *, namespace: str='default') -> Dict[str, Any]
~~~


Recall a value from agent memory.

Source: `lightbulb/client.py:1247`.

##### `lightbulb.client.LightbulbClient.memory_record_event`



~~~python
def memory_record_event(body: Dict[str, Any]) -> Dict[str, Any]
~~~


Record a memory event.

Source: `lightbulb/client.py:2394`.

##### `lightbulb.client.LightbulbClient.memory_search`



~~~python
def memory_search(query: str, *, namespace: str='default', top_k: int=5) -> List[Dict[str, Any]]
~~~


Search agent memory semantically (``POST /api/memory/query``).

Maps ``{query, namespace, top_k}`` onto the gateway's
``MemoryQueryRequest`` (``query_text``, ``categories=[namespace]``,
``top_k``) and returns the ranked ``entries`` list from the
``MemoryQueryResponse``. (The ``POST /api/memory/search`` route this used
to target has no handler — the semantic route is ``/query``.)

Source: `lightbulb/client.py:1257`.

##### `lightbulb.client.LightbulbClient.memory_status`



~~~python
def memory_status() -> Dict[str, Any]
~~~


Health / capacity status of the memory subsystem.

Source: `lightbulb/client.py:2328`.

##### `lightbulb.client.LightbulbClient.memory_store`



~~~python
def memory_store(key: str, value: str, *, namespace: str='default') -> Dict[str, Any]
~~~


Store a value in agent memory.

Writes to the memory gateway's durable entry store
(``POST /api/memory/entries`` → ``MemoryEntryCreate``). The simple
``{key, value, namespace}`` triple is mapped onto the entry DTO so it
round-trips with :meth:`memory_search`:

- ``namespace`` → ``category`` (the grouping the search scopes by),
- ``value`` → ``summary`` (the retrievable content),
- ``key`` → preserved in ``tags`` and ``details_json`` for later lookup.

Stored as a durable ``semantic`` entry. (The bare ``POST /api/memory``
route this used to target has no handler — it 404'd.)

Source: `lightbulb/client.py:1215`.

##### `lightbulb.client.LightbulbClient.modify_voice_action`



~~~python
def modify_voice_action(execution_id: str, approval_task_id: str, modifications: Dict[str, Any]) -> Dict[str, Any]
~~~


Approve a voice action with modifications to the proposed payload.

Source: `lightbulb/client.py:1449`.

##### `lightbulb.client.LightbulbClient.page_builder_capabilities`



~~~python
def page_builder_capabilities(session_id: str) -> Dict[str, Any]
~~~


List page capabilities (forms, search, auth, etc.).

Source: `lightbulb/client.py:2682`.

##### `lightbulb.client.LightbulbClient.page_builder_deploy`



~~~python
def page_builder_deploy(session_id: str, page_key: str='') -> Dict[str, Any]
~~~


Deploy a page builder session.

Source: `lightbulb/client.py:797`.

##### `lightbulb.client.LightbulbClient.page_builder_get_preview`



~~~python
def page_builder_get_preview(session_id: str) -> Dict[str, Any]
~~~


Get the preview URL for a page builder session.

Source: `lightbulb/client.py:807`.

##### `lightbulb.client.LightbulbClient.page_builder_get_schemas`



~~~python
def page_builder_get_schemas(session_id: str) -> Dict[str, Any]
~~~


Get the current page schemas for a session.

Source: `lightbulb/client.py:790`.

##### `lightbulb.client.LightbulbClient.page_builder_install_artifact`



~~~python
def page_builder_install_artifact(session_id: str, body: Dict[str, Any]) -> Dict[str, Any]
~~~


Install a component artifact into the page session.

Source: `lightbulb/client.py:2671`.

##### `lightbulb.client.LightbulbClient.page_builder_promote_install_bundle`



~~~python
def page_builder_promote_install_bundle(session_id: str, body: Dict[str, Any]) -> Dict[str, Any]
~~~


Promote an install bundle to the workspace.

Source: `lightbulb/client.py:2660`.

##### `lightbulb.client.LightbulbClient.page_builder_promote_section`



~~~python
def page_builder_promote_section(session_id: str, body: Dict[str, Any]) -> Dict[str, Any]
~~~


Promote a section artifact to the install bundle.

Source: `lightbulb/client.py:2649`.

##### `lightbulb.client.LightbulbClient.page_builder_save_backend_contract`



~~~python
def page_builder_save_backend_contract(session_id: str, body: Dict[str, Any]) -> Dict[str, Any]
~~~


Define a backend contract for a page (data shape + agent binding).

Source: `lightbulb/client.py:2703`.

##### `lightbulb.client.LightbulbClient.page_builder_save_capability`



~~~python
def page_builder_save_capability(session_id: str, body: Dict[str, Any]) -> Dict[str, Any]
~~~


Save a capability to the page session.

Source: `lightbulb/client.py:2692`.

##### `lightbulb.client.LightbulbClient.page_builder_send_message`



~~~python
def page_builder_send_message(session_id: str, content: str) -> Dict[str, Any]
~~~


Send a message to a page builder session (non-streaming).

Source: `lightbulb/client.py:779`.

##### `lightbulb.client.LightbulbClient.page_builder_unpublish`



~~~python
def page_builder_unpublish(session_id: str) -> Dict[str, Any]
~~~


Unpublish a deployed page builder session.

Source: `lightbulb/client.py:2714`.

##### `lightbulb.client.LightbulbClient.page_builder_workspace_automation`



~~~python
def page_builder_workspace_automation(session_id: str, body: Dict[str, Any] | None=None) -> Dict[str, Any]
~~~


Run the page-builder workspace automation (auto-wire pages → agents → backend).

Source: `lightbulb/client.py:2638`.

##### `lightbulb.client.LightbulbClient.post_aoc_task_event`



~~~python
def post_aoc_task_event(task_id: str, body: Dict[str, Any]) -> Dict[str, Any]
~~~


Post a new event onto an AutoCompany task.

Source: `lightbulb/client.py:2199`.

##### `lightbulb.client.LightbulbClient.rag_query`



~~~python
def rag_query(question: str, *, top_k: int=5, document_ids: List[str] | None=None) -> Dict[str, Any]
~~~


Query the RAG knowledge base directly.

Source: `lightbulb/client.py:1122`.

##### `lightbulb.client.LightbulbClient.rag_upload_document`



~~~python
def rag_upload_document(filename: str, content: str, **metadata) -> Dict[str, Any]
~~~


Upload a document to the RAG library.

Source: `lightbulb/client.py:1132`.

##### `lightbulb.client.LightbulbClient.refresh_auth`



~~~python
def refresh_auth() -> bool
~~~


Run the configured ``auth_refresh`` callback and swap in fresh auth.

Returns ``True`` if a new ``AuthStrategy`` was installed. Callers
typically invoke this after catching :class:`AuthenticationError`,
then retry the failed request:

    try:
        client.dispatch("finance", action="chat", message="...")
    except AuthenticationError:
        if client.refresh_auth():
            client.dispatch("finance", action="chat", message="...")

Source: `lightbulb/client.py:286`.

##### `lightbulb.client.LightbulbClient.register_external_artifact`



~~~python
def register_external_artifact(*, type: str, title: str='', summary: str='', uri: str='', content: str='', project_id: Optional[str]=None, source_agent: str='external_agent', metadata: Optional[Dict[str, Any]]=None, attach_workspace: bool=False) -> Dict[str, Any]
~~~


Register an external artifact (codebase/document/slide deck/spreadsheet/url) created
by a general agent so Lightbulb domain agents can discover and work on it.

Either ``uri`` or ``content`` must be provided. For a ``codebase`` artifact with a repo
``uri``, set ``attach_workspace=True`` to also clone it into a Code Workspace so Lightbulb
agents can work on it.

Source: `lightbulb/client.py:1012`.

##### `lightbulb.client.LightbulbClient.register_runtime_action`



~~~python
def register_runtime_action(domain: str, action: str, *, description: str='', agent_spec: Dict[str, Any] | None=None, component_ids: List[str] | None=None, workflow_type: str='') -> Dict[str, Any]
~~~


Author a runtime domain action (``POST /api/domain-agents/runtime-actions``).

Lands as ``pending_approval`` — not dispatchable until approved. Provide
an ``agent_spec`` to author a brand-new agent (``domain`` may be
``"custom"``); without one, ``domain`` must be an existing contract domain
and this adds an action to it. The request body uses the backend's
camelCase keys (``agentSpec``, ``componentIds``, ``workflowType``).

Source: `lightbulb/client.py:1305`.

##### `lightbulb.client.LightbulbClient.reject_code_workspace_proposal`



~~~python
def reject_code_workspace_proposal(workspace_id: str, proposal_id: str, *, reason: str='') -> Dict[str, Any]
~~~


Reject a proposal.

Source: `lightbulb/client.py:1779`.

##### `lightbulb.client.LightbulbClient.reject_runtime_action`



~~~python
def reject_runtime_action(action_id: str) -> Dict[str, Any]
~~~


Reject a pending runtime action — ADMIN/TENANT only
(``POST /api/domain-agents/runtime-actions/{id}/reject``).

Source: `lightbulb/client.py:1353`.

##### `lightbulb.client.LightbulbClient.reject_task`



~~~python
def reject_task(task_id: str, *, comments: str='') -> Dict[str, Any]
~~~


Reject a pending HITL task.

Source: `lightbulb/client.py:1109`.

##### `lightbulb.client.LightbulbClient.reject_voice_action`



~~~python
def reject_voice_action(execution_id: str, approval_task_id: str, *, comments: str='') -> Dict[str, Any]
~~~


Reject a pending in-call action.

Source: `lightbulb/client.py:1432`.

##### `lightbulb.client.LightbulbClient.search_documents`



~~~python
def search_documents(query: str, *, folder_path: str | None=None, top_k: int=10) -> DispatchResult
~~~


Search across all documents using semantic search.

Source: `lightbulb/client.py:646`.

##### `lightbulb.client.LightbulbClient.set_approval_preference_state`



~~~python
def set_approval_preference_state(preference_id: str, *, enabled: bool) -> Dict[str, Any]
~~~


Enable or disable an auto-accept rule.

Source: `lightbulb/client.py:2530`.

##### `lightbulb.client.LightbulbClient.stop_aoc_run`



~~~python
def stop_aoc_run(run_id: str) -> Dict[str, Any]
~~~


Stop an in-flight AutoCompany cognitive-loop run.

Source: `lightbulb/client.py:2145`.

##### `lightbulb.client.LightbulbClient.stream_chat`



~~~python
def stream_chat(domain: str, *, message: str, action: str | None=None, inputs: Dict[str, Any] | None=None, conversation_id: str | None=None, company_id: str | None=None) -> Generator[SSEEvent, None, None]
~~~


Stream a domain agent chat via Server-Sent Events.

Yields SSEEvent objects for each event (status, chat, artifact, complete, error).

Source: `lightbulb/client.py:412`.

##### `lightbulb.client.LightbulbClient.stream_code_workspace_chat`



~~~python
def stream_code_workspace_chat(workspace_id: str, message: str, **kwargs: Any) -> Generator[SSEEvent, None, None]
~~~


Stream a coding agent chat as Server-Sent Events.

Yields SSEEvent objects (status, token, tool_call, diff, complete, error).
The non-streaming counterpart is :meth:`code_workspace_chat`.

Source: `lightbulb/client.py:500`.

##### `lightbulb.client.LightbulbClient.stream_document_builder_message`



~~~python
def stream_document_builder_message(session_id: str, content: str) -> Generator[SSEEvent, None, None]
~~~


Stream a document builder message via SSE.

Source: `lightbulb/client.py:552`.

##### `lightbulb.client.LightbulbClient.stream_page_builder_message`



~~~python
def stream_page_builder_message(session_id: str, content: str) -> Generator[SSEEvent, None, None]
~~~


Stream a page builder message via SSE (token-by-token output).

Source: `lightbulb/client.py:523`.

##### `lightbulb.client.LightbulbClient.stream_page_builder_workspace_automation`



~~~python
def stream_page_builder_workspace_automation(session_id: str, body: Dict[str, Any] | None=None) -> Generator[SSEEvent, None, None]
~~~


Stream the page-builder workspace automation pipeline.

Source: `lightbulb/client.py:538`.

##### `lightbulb.client.LightbulbClient.submit_code_workspace_proposal`



~~~python
def submit_code_workspace_proposal(workspace_id: str, body: Dict[str, Any]) -> Dict[str, Any]
~~~


Submit a code-change proposal (diff + summary).

Source: `lightbulb/client.py:1757`.

##### `lightbulb.client.LightbulbClient.trigger_workflow`



~~~python
def trigger_workflow(workflow_type: str, objective: str, *, inputs: Dict[str, Any] | None=None) -> Dict[str, Any]
~~~


Trigger a workflow execution.

Source: `lightbulb/client.py:1072`.

##### `lightbulb.client.LightbulbClient.update_crm_task`



~~~python
def update_crm_task(task_id: str, body: Dict[str, Any], tenant_id: str | None=None) -> Dict[str, Any]
~~~


Update a CRM task.

Source: `lightbulb/client.py:2473`.

##### `lightbulb.client.LightbulbClient.update_product_machine_plan`



~~~python
def update_product_machine_plan(project_id: str, plan: Dict[str, Any]) -> Dict[str, Any]
~~~


Replace a project's product-machine plan
(``PUT /api/projects/{id}/product-machine/plan``).

Source: `lightbulb/client.py:964`.

##### `lightbulb.client.LightbulbClient.validate_aoc_run_config`



~~~python
def validate_aoc_run_config(run_id: str) -> Dict[str, Any]
~~~


Validate an AutoCompany run's configuration.

Source: `lightbulb/client.py:2152`.

##### `lightbulb.client.LightbulbClient.whoami`



~~~python
def whoami() -> Dict[str, Any]
~~~


Get the current user's identity, role, tenant, company, and permissions.

Source: `lightbulb/client.py:230`.

##### `lightbulb.client.LightbulbClient.workspace_bundle`



~~~python
def workspace_bundle(domain: str) -> Dict[str, Any]
~~~


Get a domain workspace data bundle (state, surfaces, recent runs).

Source: `lightbulb/client.py:2567`.

##### `lightbulb.client.LightbulbClient.workspace_conversation`



~~~python
def workspace_conversation(domain: str, conversation_id: str) -> Dict[str, Any]
~~~


Get a domain workspace conversation.

Source: `lightbulb/client.py:2589`.

##### `lightbulb.client.LightbulbClient.workspace_surface`



~~~python
def workspace_surface(domain: str, surface: str, **filters: Any) -> Dict[str, Any]
~~~


Read a domain workspace surface (e.g. internal_suite, live connector).

Source: `lightbulb/client.py:2600`.

##### `lightbulb.client.LightbulbClient.workspace_trace`



~~~python
def workspace_trace(domain: str, trace_id: str) -> Dict[str, Any]
~~~


Get a workspace trace (full agent execution log).

Source: `lightbulb/client.py:2578`.

## Module `lightbulb.connectors`

Typed clients for the deep connector integrations exposed by the platform.

These wrap the user-facing tool surface (``invoke_tool``) and the dedicated
HR-live endpoints, so callers don't have to remember tool keys or argument
shapes. Patterned after :class:`lightbulb.stripe.StripeOrchestratorClient`.

Usage::

    >>> from lightbulb import LightbulbClient, SlackClient, JiraClient
    >>> client = LightbulbClient(...)
    >>> SlackClient(client).post_message(channel="#deals", text="Hello")
    >>> JiraClient(client).create_issue(project_key="ENG", summary="Bug", issue_type="Bug")

For HR connectors, ``BambooHRClient``, ``GreenhouseClient`` and ``MondayClient``
hit the dedicated ``/api/hr/live`` surface (which the SDK already wraps).

### `lightbulb.connectors.SlackClient`

class. Source: `lightbulb/connectors.py:39`.

Thin wrapper over LightbulbClient for Slack operations.

All operations route through the platform's tool surface, which enforces
OAuth scope, rate limits, and audit logging.

Fields:
- `inner: LightbulbClient`

#### Methods

##### `lightbulb.connectors.SlackClient.add_reaction`



~~~python
def add_reaction(*, channel: str, ts: str, name: str) -> Dict[str, Any]
~~~


Add an emoji reaction (e.g. name='thumbsup').

Source: `lightbulb/connectors.py:70`.

##### `lightbulb.connectors.SlackClient.archive_channel`



~~~python
def archive_channel(channel: str) -> Dict[str, Any]
~~~


Source: `lightbulb/connectors.py:91`.

##### `lightbulb.connectors.SlackClient.create_channel`



~~~python
def create_channel(*, name: str, is_private: bool=False) -> Dict[str, Any]
~~~


Source: `lightbulb/connectors.py:79`.

##### `lightbulb.connectors.SlackClient.get_channel_history`



~~~python
def get_channel_history(channel: str, *, limit: int=100, cursor: str='') -> Dict[str, Any]
~~~


Source: `lightbulb/connectors.py:94`.

##### `lightbulb.connectors.SlackClient.get_thread_replies`



~~~python
def get_thread_replies(*, channel: str, ts: str, limit: int=100) -> Dict[str, Any]
~~~


Source: `lightbulb/connectors.py:100`.

##### `lightbulb.connectors.SlackClient.invite_to_channel`



~~~python
def invite_to_channel(*, channel: str, users: List[str]) -> Dict[str, Any]
~~~


Source: `lightbulb/connectors.py:88`.

##### `lightbulb.connectors.SlackClient.join_channel`



~~~python
def join_channel(channel: str) -> Dict[str, Any]
~~~


Source: `lightbulb/connectors.py:82`.

##### `lightbulb.connectors.SlackClient.list_channels`



~~~python
def list_channels(*, types: str='public_channel,private_channel', limit: int=200) -> Dict[str, Any]
~~~


Source: `lightbulb/connectors.py:76`.

##### `lightbulb.connectors.SlackClient.list_users`



~~~python
def list_users(*, limit: int=200, cursor: str='') -> Dict[str, Any]
~~~


Source: `lightbulb/connectors.py:111`.

##### `lightbulb.connectors.SlackClient.lookup_user`



~~~python
def lookup_user(*, email: str) -> Dict[str, Any]
~~~


Source: `lightbulb/connectors.py:108`.

##### `lightbulb.connectors.SlackClient.post_message`



~~~python
def post_message(*, channel: str, text: str, thread_ts: Optional[str]=None, blocks: Optional[List[Dict[str, Any]]]=None) -> Dict[str, Any]
~~~


Post a message to a Slack channel or thread.

Source: `lightbulb/connectors.py:48`.

##### `lightbulb.connectors.SlackClient.search_messages`



~~~python
def search_messages(query: str, *, count: int=20) -> Dict[str, Any]
~~~


Source: `lightbulb/connectors.py:105`.

##### `lightbulb.connectors.SlackClient.set_channel_topic`



~~~python
def set_channel_topic(*, channel: str, topic: str) -> Dict[str, Any]
~~~


Source: `lightbulb/connectors.py:85`.

##### `lightbulb.connectors.SlackClient.update_message`



~~~python
def update_message(*, channel: str, ts: str, text: str) -> Dict[str, Any]
~~~


Edit a previously-posted message.

Source: `lightbulb/connectors.py:64`.

### `lightbulb.connectors.JiraClient`

class. Source: `lightbulb/connectors.py:122`.

Thin wrapper over LightbulbClient for Atlassian Jira operations.

Fields:
- `inner: LightbulbClient`

#### Methods

##### `lightbulb.connectors.JiraClient.add_comment`



~~~python
def add_comment(issue_key: str, body: str) -> Dict[str, Any]
~~~


Source: `lightbulb/connectors.py:172`.

##### `lightbulb.connectors.JiraClient.create_issue`



~~~python
def create_issue(*, project_key: str, summary: str, issue_type: str='Task', description: str='', assignee: Optional[str]=None, labels: Optional[List[str]]=None, priority: Optional[str]=None, custom_fields: Optional[Dict[str, Any]]=None) -> Dict[str, Any]
~~~


Source: `lightbulb/connectors.py:127`.

##### `lightbulb.connectors.JiraClient.get_board_sprints`



~~~python
def get_board_sprints(board_id: str, *, state: str='active') -> Dict[str, Any]
~~~


Source: `lightbulb/connectors.py:183`.

##### `lightbulb.connectors.JiraClient.get_issue`



~~~python
def get_issue(issue_key: str) -> Dict[str, Any]
~~~


Source: `lightbulb/connectors.py:160`.

##### `lightbulb.connectors.JiraClient.get_sprint_issues`



~~~python
def get_sprint_issues(sprint_id: str) -> Dict[str, Any]
~~~


Source: `lightbulb/connectors.py:180`.

##### `lightbulb.connectors.JiraClient.link_issues`



~~~python
def link_issues(*, inward_key: str, outward_key: str, link_type: str) -> Dict[str, Any]
~~~


Source: `lightbulb/connectors.py:175`.

##### `lightbulb.connectors.JiraClient.search_issues`



~~~python
def search_issues(jql: str, *, max_results: int=50) -> Dict[str, Any]
~~~


Run a JQL search.

Source: `lightbulb/connectors.py:156`.

##### `lightbulb.connectors.JiraClient.transition_issue`



~~~python
def transition_issue(issue_key: str, transition: str, *, comment: str='') -> Dict[str, Any]
~~~


Source: `lightbulb/connectors.py:166`.

##### `lightbulb.connectors.JiraClient.update_issue`



~~~python
def update_issue(issue_key: str, fields: Dict[str, Any]) -> Dict[str, Any]
~~~


Source: `lightbulb/connectors.py:163`.

### `lightbulb.connectors.BambooHRClient`

class. Source: `lightbulb/connectors.py:191`.

BambooHR client.

Read endpoints route through the platform's HR-live surface (no rebuild of
tokens, scopes, or rate limits). Write operations route through the tool
surface so they pass through HITL approvals where required.

Fields:
- `inner: LightbulbClient`

#### Methods

##### `lightbulb.connectors.BambooHRClient.create_leave_request`



~~~python
def create_leave_request(body: Dict[str, Any]) -> Dict[str, Any]
~~~


Source: `lightbulb/connectors.py:217`.

##### `lightbulb.connectors.BambooHRClient.get_employee`



~~~python
def get_employee(employee_id: str) -> Dict[str, Any]
~~~


Source: `lightbulb/connectors.py:211`.

##### `lightbulb.connectors.BambooHRClient.health`



~~~python
def health() -> Dict[str, Any]
~~~


Source: `lightbulb/connectors.py:208`.

##### `lightbulb.connectors.BambooHRClient.leave_balance`



~~~python
def leave_balance(employee_id: str) -> Dict[str, Any]
~~~


Source: `lightbulb/connectors.py:205`.

##### `lightbulb.connectors.BambooHRClient.list_employees`



~~~python
def list_employees(**filters: Any) -> Dict[str, Any]
~~~


Source: `lightbulb/connectors.py:214`.

##### `lightbulb.connectors.BambooHRClient.whos_out`



~~~python
def whos_out(**filters: Any) -> Dict[str, Any]
~~~


Roster of employees currently or upcoming OOO.

Source: `lightbulb/connectors.py:201`.

### `lightbulb.connectors.GreenhouseClient`

class. Source: `lightbulb/connectors.py:225`.

Greenhouse ATS client (recruiting).

Fields:
- `inner: LightbulbClient`

#### Methods

##### `lightbulb.connectors.GreenhouseClient.advance_application`



~~~python
def advance_application(application_id: str, body: Optional[Dict[str, Any]]=None) -> Dict[str, Any]
~~~


HITL-gated: advance a candidate to the next stage.

Source: `lightbulb/connectors.py:236`.

##### `lightbulb.connectors.GreenhouseClient.get_candidate`



~~~python
def get_candidate(candidate_id: str) -> Dict[str, Any]
~~~


Source: `lightbulb/connectors.py:244`.

##### `lightbulb.connectors.GreenhouseClient.list_applications`



~~~python
def list_applications(**filters: Any) -> Dict[str, Any]
~~~


Source: `lightbulb/connectors.py:233`.

##### `lightbulb.connectors.GreenhouseClient.list_candidates`



~~~python
def list_candidates(**filters: Any) -> Dict[str, Any]
~~~


Source: `lightbulb/connectors.py:247`.

##### `lightbulb.connectors.GreenhouseClient.list_jobs`



~~~python
def list_jobs(**filters: Any) -> Dict[str, Any]
~~~


Source: `lightbulb/connectors.py:230`.

##### `lightbulb.connectors.GreenhouseClient.reject_application`



~~~python
def reject_application(application_id: str, body: Optional[Dict[str, Any]]=None) -> Dict[str, Any]
~~~


HITL-gated: reject a candidate.

Source: `lightbulb/connectors.py:240`.

### `lightbulb.connectors.MondayClient`

class. Source: `lightbulb/connectors.py:255`.

Monday.com client used by the HR engagement and onboarding flows.

Fields:
- `inner: LightbulbClient`

#### Methods

##### `lightbulb.connectors.MondayClient.cases`



~~~python
def cases(**filters: Any) -> Dict[str, Any]
~~~


Source: `lightbulb/connectors.py:264`.

##### `lightbulb.connectors.MondayClient.create_item`



~~~python
def create_item(*, board_id: str, group_id: str, item_name: str, column_values: Optional[Dict[str, Any]]=None) -> Dict[str, Any]
~~~


Source: `lightbulb/connectors.py:273`.

##### `lightbulb.connectors.MondayClient.get_board`



~~~python
def get_board(board_id: str) -> Dict[str, Any]
~~~


Source: `lightbulb/connectors.py:270`.

##### `lightbulb.connectors.MondayClient.list_boards`



~~~python
def list_boards(**filters: Any) -> Dict[str, Any]
~~~


Source: `lightbulb/connectors.py:267`.

##### `lightbulb.connectors.MondayClient.onboarding_board`



~~~python
def onboarding_board(checklist_id: str) -> Dict[str, Any]
~~~


Read the Monday board for an HR onboarding checklist.

Source: `lightbulb/connectors.py:260`.

##### `lightbulb.connectors.MondayClient.update_item`



~~~python
def update_item(*, item_id: str, column_values: Dict[str, Any]) -> Dict[str, Any]
~~~


Source: `lightbulb/connectors.py:283`.

## Module `lightbulb.errors`

Friendly exception hierarchy for the Lightbulb SDK.

Callers can catch any platform-side failure with a single ``LightbulbError``
or narrow to a specific subclass (``AuthenticationError``,
``RateLimitedError``, etc.).

Usage::

    from lightbulb import LightbulbClient
    from lightbulb.errors import AuthenticationError, RateLimitedError

    try:
        client.dispatch("finance", action="chat", message="hello")
    except AuthenticationError:
        ...  # token expired
    except RateLimitedError as exc:
        ...  # back off

The factory :func:`from_response` wraps an :class:`httpx.HTTPStatusError` into
the appropriate subclass. :func:`raise_if_error` calls
:class:`~httpx.Response.raise_for_status` and converts failures the same way —
used by :class:`~lightbulb.client.LightbulbClient` on every platform response.

Auth-flow helpers (login, 2FA, device flow) raise :class:`RuntimeError` /
:class:`ValueError` with sanitized messages where applicable.

### `lightbulb.errors.LightbulbError`

class. Source: `lightbulb/errors.py:49`.

Base for all Lightbulb SDK exceptions raised against the platform.

Attributes:
    status_code: HTTP status (or None for client-side validation errors).
    path: Request path that triggered the error (best-effort).
    request_id: Server-supplied trace ID, if any.

Fields:
- `status_code: Optional[int] = None`

### `lightbulb.errors.AuthenticationError`

class. Source: `lightbulb/errors.py:74`.

401 — credentials missing or invalid (token expired, bad password, etc.).

### `lightbulb.errors.PermissionDenied`

class. Source: `lightbulb/errors.py:79`.

403 — caller is authenticated but lacks permission for the action.

### `lightbulb.errors.NotFoundError`

class. Source: `lightbulb/errors.py:84`.

404 — resource does not exist or is outside the caller's scope.

### `lightbulb.errors.ValidationError`

class. Source: `lightbulb/errors.py:89`.

400 / 422 — request was malformed or rejected by server validation.

Also raised by client-side validators (``_validate_domain`` etc.) when the
SDK can detect a bad input before hitting the network.

Multiply-inherits from :class:`ValueError` so existing ``except ValueError``
clauses keep working — the rest of the SDK has historically raised
``ValueError`` for input rejection.

### `lightbulb.errors.RateLimitedError`

class. Source: `lightbulb/errors.py:102`.

429 — too many requests. Back off and retry.

### `lightbulb.errors.ServerError`

class. Source: `lightbulb/errors.py:117`.

5xx — the platform itself is unhappy. Usually transient.

### `lightbulb.errors.from_response`

function. Source: `lightbulb/errors.py:161`.



~~~python
from_response(response: httpx.Response, *, default_message: str='') -> LightbulbError
~~~


Map an HTTP response to the matching LightbulbError subclass.

The error message is drawn from the server's ``message`` / ``error`` /
``detail`` field when present, NEVER from the raw body.

### `lightbulb.errors.wrap_http_error`

function. Source: `lightbulb/errors.py:177`.



~~~python
wrap_http_error(exc: httpx.HTTPStatusError) -> LightbulbError
~~~


Convert an ``httpx.HTTPStatusError`` to a LightbulbError without leaking the body.

### `lightbulb.errors.raise_if_error`

function. Source: `lightbulb/errors.py:182`.



~~~python
raise_if_error(response: httpx.Response) -> None
~~~


Raise a :class:`LightbulbError` subclass if ``response`` has an error status.

Safe to use on any :class:`~httpx.Response`; does nothing on 2xx/3xx.

## Module `lightbulb.stripe`

Typed client for the Stripe Orchestration Agent.

Wraps the orchestrator's HTTP surface so external code (your own scripts,
LangChain tools, OpenAI Agents SDK skills) can drive the orchestrator
without rebuilding the request/response shapes from scratch.

Two ways to use:

    >>> from lightbulb import LightbulbClient
    >>> from lightbulb.stripe import StripeOrchestratorClient
    >>> stripe = StripeOrchestratorClient(LightbulbClient(api_key="..."))
    >>> stripe.dispatch("customers", "list", {"limit": 10})

Or directly via the convenience helpers — they all route through
``LightbulbClient.invoke_tool`` so existing auth / retry / logging applies.

### `lightbulb.stripe.StripeWorkflow`

class. Source: `lightbulb/stripe.py:32`.

Names of the high-level composite workflows the orchestrator exposes.

#### Methods

##### `lightbulb.stripe.StripeWorkflow.all`



~~~python
def all() -> List[str]
~~~


Source: `lightbulb/stripe.py:41`.

### `lightbulb.stripe.StripeOrchestratorClient`

class. Source: `lightbulb/stripe.py:51`.

Thin wrapper over LightbulbClient that drives the Stripe orchestration
agent through the platform's standard tool-invocation surface.

Fields:
- `inner: LightbulbClient`

#### Methods

##### `lightbulb.stripe.StripeOrchestratorClient.account_health`



~~~python
def account_health() -> Dict[str, Any]
~~~


Source: `lightbulb/stripe.py:172`.

##### `lightbulb.stripe.StripeOrchestratorClient.approve`



~~~python
def approve(approval_id: str, **extra: Any) -> Dict[str, Any]
~~~


Source: `lightbulb/stripe.py:150`.

##### `lightbulb.stripe.StripeOrchestratorClient.as_agent_toolkit_tools`



~~~python
def as_agent_toolkit_tools() -> List[Dict[str, Any]]
~~~


Return tool descriptors compatible with stripe-agent-toolkit shape.

Each entry has ``name``, ``description``, and a ``call`` callable that
takes a dict and returns a dict. Drop-in for any agent framework that
accepts named tools with a structured schema (OpenAI Agents SDK,
LangChain ``StructuredTool.from_function``, CrewAI ``Tool``, etc.).

Source: `lightbulb/stripe.py:198`.

##### `lightbulb.stripe.StripeOrchestratorClient.create_refund`



~~~python
def create_refund(charge_id: str, amount: int, **extra: Any) -> Dict[str, Any]
~~~


Source: `lightbulb/stripe.py:93`.

##### `lightbulb.stripe.StripeOrchestratorClient.dispatch`



~~~python
def dispatch(resource: str, verb: str, op_inputs: Optional[Dict[str, Any]]=None, *, stripe_account_id: Optional[str]=None) -> Dict[str, Any]
~~~


Send any (resource, verb) combination through the orchestrator.

Examples:
    >>> sd.dispatch("customers", "list", {"limit": 25})
    >>> sd.dispatch("refunds", "create", {"charge": "ch_...", "amount": 500})

Source: `lightbulb/stripe.py:59`.

##### `lightbulb.stripe.StripeOrchestratorClient.execute`



~~~python
def execute(approval_id: str) -> Dict[str, Any]
~~~


Source: `lightbulb/stripe.py:162`.

##### `lightbulb.stripe.StripeOrchestratorClient.forecast_snapshot`



~~~python
def forecast_snapshot() -> Dict[str, Any]
~~~


Source: `lightbulb/stripe.py:169`.

##### `lightbulb.stripe.StripeOrchestratorClient.list_customers`



~~~python
def list_customers(**filters: Any) -> Dict[str, Any]
~~~


Source: `lightbulb/stripe.py:84`.

##### `lightbulb.stripe.StripeOrchestratorClient.list_pending_approvals`



~~~python
def list_pending_approvals() -> Dict[str, Any]
~~~


Source: `lightbulb/stripe.py:147`.

##### `lightbulb.stripe.StripeOrchestratorClient.list_subscriptions`



~~~python
def list_subscriptions(**filters: Any) -> Dict[str, Any]
~~~


Source: `lightbulb/stripe.py:87`.

##### `lightbulb.stripe.StripeOrchestratorClient.mcp_invoke`



~~~python
def mcp_invoke(tool: str, arguments: Optional[Dict[str, Any]]=None, *, stripe_account_id: Optional[str]=None) -> Dict[str, Any]
~~~


Source: `lightbulb/stripe.py:189`.

##### `lightbulb.stripe.StripeOrchestratorClient.raw_api_request`



~~~python
def raw_api_request(api_path: str, *, method: str='GET', params: Optional[Dict[str, Any]]=None, stripe_account_id: Optional[str]=None, base_address: Optional[str]=None) -> Dict[str, Any]
~~~


Governed long-tail Stripe API request.

The backend only accepts Stripe API paths beginning with ``/v1/`` or
``/v2/`` and routes non-GET calls through the normal simulator, audit,
idempotency, and HITL approval path.

Source: `lightbulb/stripe.py:100`.

##### `lightbulb.stripe.StripeOrchestratorClient.reject`



~~~python
def reject(approval_id: str, reason: str='') -> Dict[str, Any]
~~~


Source: `lightbulb/stripe.py:156`.

##### `lightbulb.stripe.StripeOrchestratorClient.retrieve_charge`



~~~python
def retrieve_charge(charge_id: str) -> Dict[str, Any]
~~~


Source: `lightbulb/stripe.py:90`.

##### `lightbulb.stripe.StripeOrchestratorClient.run_preference_learner`



~~~python
def run_preference_learner() -> Dict[str, Any]
~~~


Source: `lightbulb/stripe.py:175`.

##### `lightbulb.stripe.StripeOrchestratorClient.run_workflow`



~~~python
def run_workflow(workflow: str) -> Dict[str, Any]
~~~


Source: `lightbulb/stripe.py:180`.

##### `lightbulb.stripe.StripeOrchestratorClient.twin_list`



~~~python
def twin_list(resource_kind: str, *, limit: int=50) -> Dict[str, Any]
~~~


Source: `lightbulb/stripe.py:131`.

##### `lightbulb.stripe.StripeOrchestratorClient.twin_retrieve`



~~~python
def twin_retrieve(*, stripe_account_id: str, resource_kind: str, external_id: str) -> Dict[str, Any]
~~~


Source: `lightbulb/stripe.py:137`.

## Module `lightbulb.xero`

Typed client for the Xero deep-integration agent.

Wraps /api/finance/xero/agent/* and /api/finance/xero/intake/* so external
code can drive the Xero controller without rebuilding request/response shapes.

Usage::

    >>> from lightbulb import LightbulbClient
    >>> from lightbulb.xero import XeroAgentClient, XeroPlaybook
    >>> xero = XeroAgentClient(LightbulbClient(...))
    >>> snapshot = xero.snapshot()
    >>> proposals = xero.proposals(kind="bank_reconciliation")
    >>> xero.run_playbook(XeroPlaybook.MONTH_END_CLOSE)

All operations route through the platform's HITL gate — proposals must be
approved before execution.

### `lightbulb.xero.XeroPlaybook`

class. Source: `lightbulb/xero.py:35`.

Well-known Xero playbook IDs.

#### Methods

##### `lightbulb.xero.XeroPlaybook.all`



~~~python
def all() -> List[str]
~~~


Source: `lightbulb/xero.py:47`.

### `lightbulb.xero.XeroAgentClient`

class. Source: `lightbulb/xero.py:60`.

Thin wrapper over LightbulbClient that targets ``/api/finance/xero``.

Fields:
- `inner: LightbulbClient`

#### Methods

##### `lightbulb.xero.XeroAgentClient.approve_proposal`



~~~python
def approve_proposal(proposal_id: str, body: Optional[Dict[str, Any]]=None) -> Dict[str, Any]
~~~


Approve a proposal so it can execute against Xero.

Source: `lightbulb/xero.py:100`.

##### `lightbulb.xero.XeroAgentClient.create_proposal`



~~~python
def create_proposal(body: Dict[str, Any]) -> Dict[str, Any]
~~~


Create a proposal (queues an HITL approval).

Source: `lightbulb/xero.py:89`.

##### `lightbulb.xero.XeroAgentClient.org_profile`



~~~python
def org_profile(xero_tenant_id: str) -> Dict[str, Any]
~~~


Get the Xero org profile (chart of accounts, tax rates, branding).

Source: `lightbulb/xero.py:146`.

##### `lightbulb.xero.XeroAgentClient.proposals`



~~~python
def proposals(body: Optional[Dict[str, Any]]=None) -> Dict[str, Any]
~~~


Generate proposals (reconciliation, AP, payroll, etc.) for the org.

Source: `lightbulb/xero.py:78`.

##### `lightbulb.xero.XeroAgentClient.propose_bill`



~~~python
def propose_bill(body: Dict[str, Any]) -> Dict[str, Any]
~~~


Propose an AP bill entry into Xero (HITL-gated).

Source: `lightbulb/xero.py:162`.

##### `lightbulb.xero.XeroAgentClient.propose_invoice`



~~~python
def propose_invoice(body: Dict[str, Any]) -> Dict[str, Any]
~~~


Propose an AR invoice entry into Xero (HITL-gated).

Source: `lightbulb/xero.py:158`.

##### `lightbulb.xero.XeroAgentClient.propose_journal`



~~~python
def propose_journal(body: Dict[str, Any]) -> Dict[str, Any]
~~~


Propose a manual journal entry into Xero (HITL-gated).

Source: `lightbulb/xero.py:166`.

##### `lightbulb.xero.XeroAgentClient.propose_payroll_trueup`



~~~python
def propose_payroll_trueup(body: Dict[str, Any]) -> Dict[str, Any]
~~~


Propose a payroll true-up adjustment into Xero (HITL-gated).

Source: `lightbulb/xero.py:170`.

##### `lightbulb.xero.XeroAgentClient.reject_proposal`



~~~python
def reject_proposal(proposal_id: str, *, reason: str='') -> Dict[str, Any]
~~~


Reject a Xero proposal.

Source: `lightbulb/xero.py:111`.

##### `lightbulb.xero.XeroAgentClient.run_playbook`



~~~python
def run_playbook(playbook_id: str, body: Optional[Dict[str, Any]]=None) -> Dict[str, Any]
~~~


Run a Xero playbook (e.g. month_end_close, ar_followup).

Source: `lightbulb/xero.py:135`.

##### `lightbulb.xero.XeroAgentClient.run_sync`



~~~python
def run_sync(body: Optional[Dict[str, Any]]=None) -> Dict[str, Any]
~~~


Trigger a Xero data sync (org rosters, AR/AP, payroll, ledger).

Source: `lightbulb/xero.py:124`.

##### `lightbulb.xero.XeroAgentClient.snapshot`



~~~python
def snapshot(body: Optional[Dict[str, Any]]=None) -> Dict[str, Any]
~~~


Fetch a multi-org Xero financial snapshot (cash, AR, AP, payroll, taxes).

Source: `lightbulb/xero.py:67`.

## Declared public exports

## Export declaration `lightbulb.__all__`

Source: `lightbulb/__init__.py`. Declared exports: 29.

### `lightbulb.LightbulbClient`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import LightbulbClient
~~~


Binding: `lightbulb.client.LightbulbClient` → `lightbulb.client.LightbulbClient`.

Source: `lightbulb/client.py:184`.

### `lightbulb.AsyncLightbulbClient`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import AsyncLightbulbClient
~~~


Binding: `lightbulb.async_client.AsyncLightbulbClient` → `lightbulb.async_client.AsyncLightbulbClient`.

Source: `lightbulb/async_client.py:50`.

### `lightbulb.ApiKeyAuth`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ApiKeyAuth
~~~


Binding: `lightbulb.auth.ApiKeyAuth` → `lightbulb.auth.ApiKeyAuth`.

Source: `lightbulb/auth.py:83`.

### `lightbulb.JwtAuth`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import JwtAuth
~~~


Binding: `lightbulb.auth.JwtAuth` → `lightbulb.auth.JwtAuth`.

Source: `lightbulb/auth.py:126`.

### `lightbulb.TwoFactorRequired`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import TwoFactorRequired
~~~


Binding: `lightbulb.auth.TwoFactorRequired` → `lightbulb.auth.TwoFactorRequired`.

Source: `lightbulb/auth.py:165`.

### `lightbulb.login`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import login
~~~


Binding: `lightbulb.auth.login` → `lightbulb.auth.login`.

Source: `lightbulb/auth.py:184`.

### `lightbulb.complete_2fa_login`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import complete_2fa_login
~~~


Binding: `lightbulb.auth.complete_2fa_login` → `lightbulb.auth.complete_2fa_login`.

Source: `lightbulb/auth.py:314`.

### `lightbulb.device_login`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import device_login
~~~


Binding: `lightbulb.auth.device_login` → `lightbulb.auth.device_login`.

Source: `lightbulb/auth.py:588`.

### `lightbulb.sso_redirect_url`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import sso_redirect_url
~~~


Binding: `lightbulb.auth.sso_redirect_url` → `lightbulb.auth.sso_redirect_url`.

Source: `lightbulb/auth.py:550`.

### `lightbulb.LightbulbError`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import LightbulbError
~~~


Binding: `lightbulb.errors.LightbulbError` → `lightbulb.errors.LightbulbError`.

Source: `lightbulb/errors.py:49`.

### `lightbulb.AuthenticationError`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import AuthenticationError
~~~


Binding: `lightbulb.errors.AuthenticationError` → `lightbulb.errors.AuthenticationError`.

Source: `lightbulb/errors.py:74`.

### `lightbulb.PermissionDenied`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PermissionDenied
~~~


Binding: `lightbulb.errors.PermissionDenied` → `lightbulb.errors.PermissionDenied`.

Source: `lightbulb/errors.py:79`.

### `lightbulb.NotFoundError`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import NotFoundError
~~~


Binding: `lightbulb.errors.NotFoundError` → `lightbulb.errors.NotFoundError`.

Source: `lightbulb/errors.py:84`.

### `lightbulb.ValidationError`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ValidationError
~~~


Binding: `lightbulb.errors.ValidationError` → `lightbulb.errors.ValidationError`.

Source: `lightbulb/errors.py:89`.

### `lightbulb.RateLimitedError`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import RateLimitedError
~~~


Binding: `lightbulb.errors.RateLimitedError` → `lightbulb.errors.RateLimitedError`.

Source: `lightbulb/errors.py:102`.

### `lightbulb.ServerError`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ServerError
~~~


Binding: `lightbulb.errors.ServerError` → `lightbulb.errors.ServerError`.

Source: `lightbulb/errors.py:117`.

### `lightbulb.from_response`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import from_response
~~~


Binding: `lightbulb.errors.from_response` → `lightbulb.errors.from_response`.

Source: `lightbulb/errors.py:161`.

### `lightbulb.wrap_http_error`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import wrap_http_error
~~~


Binding: `lightbulb.errors.wrap_http_error` → `lightbulb.errors.wrap_http_error`.

Source: `lightbulb/errors.py:177`.

### `lightbulb.raise_if_error`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import raise_if_error
~~~


Binding: `lightbulb.errors.raise_if_error` → `lightbulb.errors.raise_if_error`.

Source: `lightbulb/errors.py:182`.

### `lightbulb.StripeOrchestratorClient`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import StripeOrchestratorClient
~~~


Binding: `lightbulb.stripe.StripeOrchestratorClient` → `lightbulb.stripe.StripeOrchestratorClient`.

Source: `lightbulb/stripe.py:51`.

### `lightbulb.StripeWorkflow`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import StripeWorkflow
~~~


Binding: `lightbulb.stripe.StripeWorkflow` → `lightbulb.stripe.StripeWorkflow`.

Source: `lightbulb/stripe.py:32`.

### `lightbulb.XeroAgentClient`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import XeroAgentClient
~~~


Binding: `lightbulb.xero.XeroAgentClient` → `lightbulb.xero.XeroAgentClient`.

Source: `lightbulb/xero.py:60`.

### `lightbulb.XeroPlaybook`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import XeroPlaybook
~~~


Binding: `lightbulb.xero.XeroPlaybook` → `lightbulb.xero.XeroPlaybook`.

Source: `lightbulb/xero.py:35`.

### `lightbulb.JiraClient`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import JiraClient
~~~


Binding: `lightbulb.connectors.JiraClient` → `lightbulb.connectors.JiraClient`.

Source: `lightbulb/connectors.py:122`.

### `lightbulb.SlackClient`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SlackClient
~~~


Binding: `lightbulb.connectors.SlackClient` → `lightbulb.connectors.SlackClient`.

Source: `lightbulb/connectors.py:39`.

### `lightbulb.BambooHRClient`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import BambooHRClient
~~~


Binding: `lightbulb.connectors.BambooHRClient` → `lightbulb.connectors.BambooHRClient`.

Source: `lightbulb/connectors.py:191`.

### `lightbulb.GreenhouseClient`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GreenhouseClient
~~~


Binding: `lightbulb.connectors.GreenhouseClient` → `lightbulb.connectors.GreenhouseClient`.

Source: `lightbulb/connectors.py:225`.

### `lightbulb.MondayClient`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import MondayClient
~~~


Binding: `lightbulb.connectors.MondayClient` → `lightbulb.connectors.MondayClient`.

Source: `lightbulb/connectors.py:255`.

### `lightbulb.__version__`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import __version__
~~~


Binding: `lightbulb._version.__version__` → `lightbulb._version.__version__`.

Source: `lightbulb/_version.py:3`.

## MCP tools

### `airwallex_create_payment`

Namespace: `airwallex`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
airwallex_create_payment(arguments: str='{}') -> str
~~~


Airwallex connector operation `create_payment` (platform tool `airwallex.create_payment`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:10615`.

### `airwallex_list_balances`

Namespace: `airwallex`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
airwallex_list_balances(arguments: str='{}') -> str
~~~


Airwallex connector operation `list_balances` (platform tool `airwallex.list_balances`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:10636`.

### `airwallex_list_payouts`

Namespace: `airwallex`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
airwallex_list_payouts(arguments: str='{}') -> str
~~~


Airwallex connector operation `list_payouts` (platform tool `airwallex.list_payouts`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:10657`.

### `airwallex_list_transactions`

Namespace: `airwallex`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
airwallex_list_transactions(arguments: str='{}') -> str
~~~


Airwallex connector operation `list_transactions` (platform tool `airwallex.list_transactions`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:10678`.

### `bamboohr_add_employee`

Namespace: `bamboohr`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
bamboohr_add_employee(arguments: str='{}') -> str
~~~


Bamboohr connector operation `add_employee` (platform tool `bamboohr.add_employee`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:10699`.

### `billcom_approve_bill`

Namespace: `billcom`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
billcom_approve_bill(arguments: str='{}') -> str
~~~


Billcom connector operation `approve_bill` (platform tool `billcom.approve_bill`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:10720`.

### `billcom_create_bill`

Namespace: `billcom`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
billcom_create_bill(arguments: str='{}') -> str
~~~


Billcom connector operation `create_bill` (platform tool `billcom.create_bill`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:10741`.

### `billcom_list_bills`

Namespace: `billcom`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
billcom_list_bills(arguments: str='{}') -> str
~~~


Billcom connector operation `list_bills` (platform tool `billcom.list_bills`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:10762`.

### `billcom_list_payments`

Namespace: `billcom`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
billcom_list_payments(arguments: str='{}') -> str
~~~


Billcom connector operation `list_payments` (platform tool `billcom.list_payments`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:10783`.

### `billcom_list_vendors`

Namespace: `billcom`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
billcom_list_vendors(arguments: str='{}') -> str
~~~


Billcom connector operation `list_vendors` (platform tool `billcom.list_vendors`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:10804`.

### `clio_action_plan_create`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_action_plan_create(arguments: str='{}') -> str
~~~


Clio connector operation `action_plan_create` (platform tool `clio.action_plan_create`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:10825`.

### `clio_action_plan_submit`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_action_plan_submit(arguments: str='{}') -> str
~~~


Clio connector operation `action_plan_submit` (platform tool `clio.action_plan_submit`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:10846`.

### `clio_api_request`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_api_request(arguments: str='{}') -> str
~~~


Clio connector operation `api_request` (platform tool `clio.api_request`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:10867`.

### `clio_create_bill`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_create_bill(arguments: str='{}') -> str
~~~


Clio connector operation `create_bill` (platform tool `clio.create_bill`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:10888`.

### `clio_create_contact`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_create_contact(arguments: str='{}') -> str
~~~


Clio connector operation `create_contact` (platform tool `clio.create_contact`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:10909`.

### `clio_create_custom_action`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_create_custom_action(arguments: str='{}') -> str
~~~


Clio connector operation `create_custom_action` (platform tool `clio.create_custom_action`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:10930`.

### `clio_create_damage`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_create_damage(arguments: str='{}') -> str
~~~


Clio connector operation `create_damage` (platform tool `clio.create_damage`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:10951`.

### `clio_create_folder`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_create_folder(arguments: str='{}') -> str
~~~


Clio connector operation `create_folder` (platform tool `clio.create_folder`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:10972`.

### `clio_create_grant`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_create_grant(arguments: str='{}') -> str
~~~


Clio connector operation `create_grant` (platform tool `clio.create_grant`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:10993`.

### `clio_create_matter`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_create_matter(display_number: Optional[str]=None, description: Optional[str]=None, client_id: Optional[str]=None, practice_area_id: Optional[str]=None) -> str
~~~


Create a new Clio matter.

Args:
    display_number (required): Matter display number.
    description (required): 
    client_id (required): Clio contact ID for the client.
    practice_area_id: Practice area ID.

Source: `lightbulb/mcp_generated_tools.py:11014`.

### `clio_create_medical_records_detail`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_create_medical_records_detail(arguments: str='{}') -> str
~~~


Clio connector operation `create_medical_records_detail` (platform tool `clio.create_medical_records_detail`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:11039`.

### `clio_create_payment_link`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_create_payment_link(arguments: str='{}') -> str
~~~


Clio connector operation `create_payment_link` (platform tool `clio.create_payment_link`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:11060`.

### `clio_create_task`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_create_task(arguments: str='{}') -> str
~~~


Clio connector operation `create_task` (platform tool `clio.create_task`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:11081`.

### `clio_create_time_entry`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_create_time_entry(arguments: str='{}') -> str
~~~


Clio connector operation `create_time_entry` (platform tool `clio.create_time_entry`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:11102`.

### `clio_create_webhook`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_create_webhook(arguments: str='{}') -> str
~~~


Clio connector operation `create_webhook` (platform tool `clio.create_webhook`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:11123`.

### `clio_delete_custom_action`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_delete_custom_action(arguments: str='{}') -> str
~~~


Clio connector operation `delete_custom_action` (platform tool `clio.delete_custom_action`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:11144`.

### `clio_delete_damage`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_delete_damage(arguments: str='{}') -> str
~~~


Clio connector operation `delete_damage` (platform tool `clio.delete_damage`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:11165`.

### `clio_delete_grant`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_delete_grant(arguments: str='{}') -> str
~~~


Clio connector operation `delete_grant` (platform tool `clio.delete_grant`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:11186`.

### `clio_delete_medical_records_detail`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_delete_medical_records_detail(arguments: str='{}') -> str
~~~


Clio connector operation `delete_medical_records_detail` (platform tool `clio.delete_medical_records_detail`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:11207`.

### `clio_delete_webhook`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_delete_webhook(arguments: str='{}') -> str
~~~


Clio connector operation `delete_webhook` (platform tool `clio.delete_webhook`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:11228`.

### `clio_get_contact`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_get_contact(arguments: str='{}') -> str
~~~


Clio connector operation `get_contact` (platform tool `clio.get_contact`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:11249`.

### `clio_get_custom_action`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_get_custom_action(arguments: str='{}') -> str
~~~


Clio connector operation `get_custom_action` (platform tool `clio.get_custom_action`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:11270`.

### `clio_get_damage`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_get_damage(arguments: str='{}') -> str
~~~


Clio connector operation `get_damage` (platform tool `clio.get_damage`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:11291`.

### `clio_get_document`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_get_document(arguments: str='{}') -> str
~~~


Clio connector operation `get_document` (platform tool `clio.get_document`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:11312`.

### `clio_get_grant`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_get_grant(arguments: str='{}') -> str
~~~


Clio connector operation `get_grant` (platform tool `clio.get_grant`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:11333`.

### `clio_get_matter`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_get_matter(arguments: str='{}') -> str
~~~


Clio connector operation `get_matter` (platform tool `clio.get_matter`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:11354`.

### `clio_get_medical_records_detail`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_get_medical_records_detail(arguments: str='{}') -> str
~~~


Clio connector operation `get_medical_records_detail` (platform tool `clio.get_medical_records_detail`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:11375`.

### `clio_get_user`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_get_user(arguments: str='{}') -> str
~~~


Clio connector operation `get_user` (platform tool `clio.get_user`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:11396`.

### `clio_get_webhook`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_get_webhook(arguments: str='{}') -> str
~~~


Clio connector operation `get_webhook` (platform tool `clio.get_webhook`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:11417`.

### `clio_list_activities`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_list_activities(arguments: str='{}') -> str
~~~


Clio connector operation `list_activities` (platform tool `clio.list_activities`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:11438`.

### `clio_list_bills`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_list_bills(arguments: str='{}') -> str
~~~


Clio connector operation `list_bills` (platform tool `clio.list_bills`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:11459`.

### `clio_list_calendars`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_list_calendars(arguments: str='{}') -> str
~~~


Clio connector operation `list_calendars` (platform tool `clio.list_calendars`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:11480`.

### `clio_list_communications`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_list_communications(arguments: str='{}') -> str
~~~


Clio connector operation `list_communications` (platform tool `clio.list_communications`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:11501`.

### `clio_list_contacts`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_list_contacts(arguments: str='{}') -> str
~~~


Clio connector operation `list_contacts` (platform tool `clio.list_contacts`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:11522`.

### `clio_list_custom_actions`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_list_custom_actions(arguments: str='{}') -> str
~~~


Clio connector operation `list_custom_actions` (platform tool `clio.list_custom_actions`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:11543`.

### `clio_list_custom_fields`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_list_custom_fields(arguments: str='{}') -> str
~~~


Clio connector operation `list_custom_fields` (platform tool `clio.list_custom_fields`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:11564`.

### `clio_list_damages`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_list_damages(arguments: str='{}') -> str
~~~


Clio connector operation `list_damages` (platform tool `clio.list_damages`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:11585`.

### `clio_list_documents`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_list_documents(arguments: str='{}') -> str
~~~


Clio connector operation `list_documents` (platform tool `clio.list_documents`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:11606`.

### `clio_list_folders`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_list_folders(arguments: str='{}') -> str
~~~


Clio connector operation `list_folders` (platform tool `clio.list_folders`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:11627`.

### `clio_list_grants`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_list_grants(arguments: str='{}') -> str
~~~


Clio connector operation `list_grants` (platform tool `clio.list_grants`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:11648`.

### `clio_list_matters`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_list_matters(status: Optional[str]=None, client_id: Optional[str]=None) -> str
~~~


List Clio matters for the connected firm.

Args:
    status: One of: pending, open, closed.
    client_id: Filter to a specific Clio contact ID.

Source: `lightbulb/mcp_generated_tools.py:11669`.

### `clio_list_medical_records_details`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_list_medical_records_details(arguments: str='{}') -> str
~~~


Clio connector operation `list_medical_records_details` (platform tool `clio.list_medical_records_details`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:11688`.

### `clio_list_notes`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_list_notes(arguments: str='{}') -> str
~~~


Clio connector operation `list_notes` (platform tool `clio.list_notes`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:11709`.

### `clio_list_payment_links`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_list_payment_links(arguments: str='{}') -> str
~~~


Clio connector operation `list_payment_links` (platform tool `clio.list_payment_links`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:11730`.

### `clio_list_payments`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_list_payments(arguments: str='{}') -> str
~~~


Clio connector operation `list_payments` (platform tool `clio.list_payments`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:11751`.

### `clio_list_practice_areas`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_list_practice_areas(arguments: str='{}') -> str
~~~


Clio connector operation `list_practice_areas` (platform tool `clio.list_practice_areas`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:11772`.

### `clio_list_tasks`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_list_tasks(arguments: str='{}') -> str
~~~


Clio connector operation `list_tasks` (platform tool `clio.list_tasks`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:11793`.

### `clio_list_time_entries`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_list_time_entries(arguments: str='{}') -> str
~~~


Clio connector operation `list_time_entries` (platform tool `clio.list_time_entries`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:11814`.

### `clio_list_users`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_list_users(arguments: str='{}') -> str
~~~


Clio connector operation `list_users` (platform tool `clio.list_users`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:11835`.

### `clio_list_webhooks`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_list_webhooks(arguments: str='{}') -> str
~~~


Clio connector operation `list_webhooks` (platform tool `clio.list_webhooks`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:11856`.

### `clio_request`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_request(arguments: str='{}') -> str
~~~


Clio connector operation `request` (platform tool `clio.request`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:11877`.

### `clio_review_only`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_review_only(arguments: str='{}') -> str
~~~


Clio connector operation `review_only` (platform tool `clio.review_only`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:11898`.

### `clio_search`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_search(arguments: str='{}') -> str
~~~


Clio connector operation `search` (platform tool `clio.search`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:11919`.

### `clio_update_custom_action`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_update_custom_action(arguments: str='{}') -> str
~~~


Clio connector operation `update_custom_action` (platform tool `clio.update_custom_action`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:11940`.

### `clio_update_damage`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_update_damage(arguments: str='{}') -> str
~~~


Clio connector operation `update_damage` (platform tool `clio.update_damage`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:11961`.

### `clio_update_grant`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_update_grant(arguments: str='{}') -> str
~~~


Clio connector operation `update_grant` (platform tool `clio.update_grant`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:11982`.

### `clio_update_matter`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_update_matter(arguments: str='{}') -> str
~~~


Clio connector operation `update_matter` (platform tool `clio.update_matter`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:12003`.

### `clio_update_medical_bill`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_update_medical_bill(arguments: str='{}') -> str
~~~


Clio connector operation `update_medical_bill` (platform tool `clio.update_medical_bill`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:12024`.

### `clio_update_medical_record`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_update_medical_record(arguments: str='{}') -> str
~~~


Clio connector operation `update_medical_record` (platform tool `clio.update_medical_record`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:12045`.

### `clio_update_medical_records_detail`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_update_medical_records_detail(arguments: str='{}') -> str
~~~


Clio connector operation `update_medical_records_detail` (platform tool `clio.update_medical_records_detail`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:12066`.

### `clio_update_webhook`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_update_webhook(arguments: str='{}') -> str
~~~


Clio connector operation `update_webhook` (platform tool `clio.update_webhook`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:12087`.

### `clio_upload_document`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_upload_document(arguments: str='{}') -> str
~~~


Clio connector operation `upload_document` (platform tool `clio.upload_document`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:12108`.

### `clio_who_am_i`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_who_am_i(arguments: str='{}') -> str
~~~


Clio connector operation `who_am_i` (platform tool `clio.who_am_i`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:12129`.

### `coding_app_growth_loop_build`

Namespace: `coding`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
coding_app_growth_loop_build(message: str='', inputs: str='{}') -> str
~~~


Run the coding domain agent action `app_growth_loop_build`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:547`.

### `coding_build_codegraph`

Namespace: `coding`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
coding_build_codegraph(message: str='', inputs: str='{}') -> str
~~~


Run the coding domain agent action `build_codegraph`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:220`.

### `coding_build_page`

Namespace: `coding`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
coding_build_page(message: str='', inputs: str='{}') -> str
~~~


Run the coding domain agent action `build_page`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:481`.

### `coding_chat`

Namespace: `coding`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
coding_chat(message: str='', inputs: str='{}') -> str
~~~


Run the coding domain agent action `chat`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:102`.

### `coding_explain_code`

Namespace: `coding`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
coding_explain_code(message: str='', path: Optional[str]=None, audience: str='engineer') -> str
~~~


Explain how a piece of code works, why it's structured this way, and
what its inputs/outputs are. Tunes depth to the requested audience.
    Args:
        message: Free-text objective for the action.
        path (required): File path or symbol to explain.
        audience: One of: engineer, junior, product, executive.

Source: `lightbulb/mcp_generated_tools.py:264`.

### `coding_format_code`

Namespace: `coding`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
coding_format_code(message: str='', inputs: str='{}') -> str
~~~


Run the coding domain agent action `format_code`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:327`.

### `coding_generate_tickets`

Namespace: `coding`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
coding_generate_tickets(message: str='', inputs: str='{}') -> str
~~~


Run the coding domain agent action `generate_tickets`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:349`.

### `coding_get_context`

Namespace: `coding`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
coding_get_context(message: str='', inputs: str='{}') -> str
~~~


Run the coding domain agent action `get_context`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:242`.

### `coding_git_status`

Namespace: `coding`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
coding_git_status(message: str='', inputs: str='{}') -> str
~~~


Run the coding domain agent action `git_status`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:305`.

### `coding_growth_loop_web_development`

Namespace: `coding`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
coding_growth_loop_web_development(message: str='', inputs: str='{}') -> str
~~~


Run the coding domain agent action `growth_loop_web_development`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:569`.

### `coding_page_builder_web_development`

Namespace: `coding`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
coding_page_builder_web_development(message: str='', inputs: str='{}') -> str
~~~


Run the coding domain agent action `page_builder_web_development`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:503`.

### `coding_plan_domain_intelligence`

Namespace: `coding`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
coding_plan_domain_intelligence(message: str='', inputs: str='{}') -> str
~~~


Run the coding domain agent action `plan_domain_intelligence`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:591`.

### `coding_prioritize_backlog`

Namespace: `coding`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
coding_prioritize_backlog(message: str='', inputs: str='{}') -> str
~~~


Run the coding domain agent action `prioritize_backlog`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:371`.

### `coding_process_single_ticket`

Namespace: `coding`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
coding_process_single_ticket(message: str='', inputs: str='{}') -> str
~~~


Run the coding domain agent action `process_single_ticket`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:415`.

### `coding_process_ticket_with_branch`

Namespace: `coding`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
coding_process_ticket_with_branch(message: str='', inputs: str='{}') -> str
~~~


Run the coding domain agent action `process_ticket_with_branch`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:437`.

### `coding_propose_changes`

Namespace: `coding`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
coding_propose_changes(message: str='', inputs: str='{}') -> str
~~~


Run the coding domain agent action `propose_changes`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:283`.

### `coding_read_code`

Namespace: `coding`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
coding_read_code(message: str='', inputs: str='{}') -> str
~~~


Run the coding domain agent action `read_code`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:124`.

### `coding_run_pipeline`

Namespace: `coding`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
coding_run_pipeline(message: str='', inputs: str='{}') -> str
~~~


Run the coding domain agent action `run_pipeline`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:393`.

### `coding_run_tests`

Namespace: `coding`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
coding_run_tests(message: str='', inputs: str='{}') -> str
~~~


Run the coding domain agent action `run_tests`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:198`.

### `coding_search`

Namespace: `coding`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
coding_search(message: str='', inputs: str='{}') -> str
~~~


Run the coding domain agent action `search`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:169`.

### `coding_watch_slack`

Namespace: `coding`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
coding_watch_slack(message: str='', inputs: str='{}') -> str
~~~


Run the coding domain agent action `watch_slack`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:459`.

### `coding_website_growth_loop_build`

Namespace: `coding`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
coding_website_growth_loop_build(message: str='', inputs: str='{}') -> str
~~~


Run the coding domain agent action `website_growth_loop_build`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:525`.

### `coding_write_code`

Namespace: `coding`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
coding_write_code(message: str='', brief: Optional[str]=None, repo_path: Optional[str]=None, run_tests: bool=True) -> str
~~~


Plan and implement a code change end-to-end. Reads the relevant files,
designs the change, writes the code, and runs tests. Returns a diff
summary and test results.
    Args:
        message: Free-text objective for the action.
        brief (required): Plain-English description of the desired change.
        repo_path: Workspace-relative path to scope the change.
        run_tests: Run the test suite after the change.

Source: `lightbulb/mcp_generated_tools.py:146`.

### `commerce_ab_test`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_ab_test(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `ab_test`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:1185`.

### `commerce_assortment_gap_analysis`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_assortment_gap_analysis(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `assortment_gap_analysis`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:899`.

### `commerce_campaign_brief`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_campaign_brief(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `campaign_brief`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:1119`.

### `commerce_cash_position`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_cash_position(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `cash_position`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:1383`.

### `commerce_catalog_sync`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_catalog_sync(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `catalog_sync`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:943`.

### `commerce_category_landscape`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_category_landscape(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `category_landscape`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:811`.

### `commerce_chat`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_chat(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `chat`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:613`.

### `commerce_competitor_watchlist`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_competitor_watchlist(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `competitor_watchlist`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:855`.

### `commerce_connector_health_summary`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_connector_health_summary(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `connector_health_summary`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:1801`.

### `commerce_contract_to_pay`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_contract_to_pay(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `contract_to_pay`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:1669`.

### `commerce_converse`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_converse(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `converse`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:635`.

### `commerce_cross_agent_insight`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_cross_agent_insight(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `cross_agent_insight`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:1163`.

### `commerce_customer_360`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_customer_360(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `customer_360`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:1229`.

### `commerce_customer_profile`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_customer_profile(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `customer_profile`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:1053`.

### `commerce_customer_segment`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_customer_segment(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `customer_segment`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:1031`.

### `commerce_customer_value_summary`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_customer_value_summary(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `customer_value_summary`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:1427`.

### `commerce_dashboard_summary`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_dashboard_summary(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `dashboard_summary`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:1339`.

### `commerce_demand_forecast`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_demand_forecast(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `demand_forecast`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:1735`.

### `commerce_economic_context`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_economic_context(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `economic_context`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:1449`.

### `commerce_external_market_research`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_external_market_research(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `external_market_research`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:789`.

### `commerce_inventory_check`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_inventory_check(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `inventory_check`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:965`.

### `commerce_inventory_valuation`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_inventory_valuation(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `inventory_valuation`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:1295`.

### `commerce_knowledge_build`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_knowledge_build(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `knowledge_build`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:657`.

### `commerce_margin_analysis`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_margin_analysis(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `margin_analysis`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:1273`.

### `commerce_market_observation_ingest`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_market_observation_ingest(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `market_observation_ingest`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:745`.

### `commerce_market_observation_query`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_market_observation_query(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `market_observation_query`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:767`.

### `commerce_order_to_invoice`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_order_to_invoice(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `order_to_invoice`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:1207`.

### `commerce_personalize_campaign`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_personalize_campaign(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `personalize_campaign`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:1097`.

### `commerce_plan_domain_intelligence`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_plan_domain_intelligence(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `plan_domain_intelligence`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:1823`.

### `commerce_po_approval_workflow`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_po_approval_workflow(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `po_approval_workflow`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:1625`.

### `commerce_predict`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_predict(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `predict`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:1075`.

### `commerce_price_optimization_run`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_price_optimization_run(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `price_optimization_run`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:1779`.

### `commerce_pricing_intelligence`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_pricing_intelligence(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `pricing_intelligence`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:1009`.

### `commerce_pricing_landscape`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_pricing_landscape(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `pricing_landscape`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:833`.

### `commerce_procurement_brief`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_procurement_brief(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `procurement_brief`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:1471`.

### `commerce_product_analysis`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_product_analysis(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `product_analysis`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:987`.

### `commerce_product_graph_query`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_product_graph_query(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `product_graph_query`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:1141`.

### `commerce_reconcile_refunds`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_reconcile_refunds(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `reconcile_refunds`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:1317`.

### `commerce_resume_sync`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_resume_sync(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `resume_sync`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:723`.

### `commerce_revenue_by_channel`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_revenue_by_channel(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `revenue_by_channel`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:1361`.

### `commerce_revenue_by_product`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_revenue_by_product(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `revenue_by_product`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:1251`.

### `commerce_service_catalog`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_service_catalog(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `service_catalog`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:921`.

### `commerce_sourcing_brief`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_sourcing_brief(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `sourcing_brief`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:1581`.

### `commerce_spend_analysis`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_spend_analysis(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `spend_analysis`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:1691`.

### `commerce_supplier_evaluation`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_supplier_evaluation(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `supplier_evaluation`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:1647`.

### `commerce_supplier_search`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_supplier_search(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `supplier_search`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:1493`.

### `commerce_supply_chain_analysis`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_supply_chain_analysis(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `supply_chain_analysis`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:1559`.

### `commerce_sync_history`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_sync_history(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `sync_history`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:701`.

### `commerce_sync_status`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_sync_status(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `sync_status`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:679`.

### `commerce_tariff_lookup`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_tariff_lookup(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `tariff_lookup`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:1537`.

### `commerce_top_products_by_margin`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_top_products_by_margin(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `top_products_by_margin`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:1405`.

### `commerce_trade_flow_lookup`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_trade_flow_lookup(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `trade_flow_lookup`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:1515`.

### `commerce_transaction_anomaly_scan`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_transaction_anomaly_scan(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `transaction_anomaly_scan`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:1757`.

### `commerce_trend_synthesis`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_trend_synthesis(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `trend_synthesis`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:877`.

### `commerce_vendor_onboarding`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_vendor_onboarding(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `vendor_onboarding`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:1603`.

### `commerce_vendor_risk_assessment`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_vendor_risk_assessment(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `vendor_risk_assessment`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:1713`.

### `content_analyze_results`

Namespace: `content`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
content_analyze_results(message: str='', inputs: str='{}') -> str
~~~


Run the content domain agent action `analyze_results`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:2153`.

### `content_anonymity_guard`

Namespace: `content`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
content_anonymity_guard(message: str='', inputs: str='{}') -> str
~~~


Run the content domain agent action `anonymity_guard`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:2219`.

### `content_chat`

Namespace: `content`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
content_chat(message: str='', inputs: str='{}') -> str
~~~


Run the content domain agent action `chat`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:1845`.

### `content_competitor_analysis`

Namespace: `content`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
content_competitor_analysis(message: str='', inputs: str='{}') -> str
~~~


Run the content domain agent action `competitor_analysis`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:1999`.

### `content_dispatch`

Namespace: `content`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
content_dispatch(message: str='', inputs: str='{}') -> str
~~~


Run the content domain agent action `dispatch`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:2109`.

### `content_evolve_strategy`

Namespace: `content`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
content_evolve_strategy(message: str='', inputs: str='{}') -> str
~~~


Run the content domain agent action `evolve_strategy`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:2043`.

### `content_full_campaign`

Namespace: `content`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
content_full_campaign(message: str='', inputs: str='{}') -> str
~~~


Run the content domain agent action `full_campaign`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:2175`.

### `content_generate_content`

Namespace: `content`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
content_generate_content(message: str='', inputs: str='{}') -> str
~~~


Run the content domain agent action `generate_content`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:1889`.

### `content_generate_plan`

Namespace: `content`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
content_generate_plan(message: str='', inputs: str='{}') -> str
~~~


Run the content domain agent action `generate_plan`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:1867`.

### `content_generate_variants`

Namespace: `content`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
content_generate_variants(message: str='', inputs: str='{}') -> str
~~~


Run the content domain agent action `generate_variants`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:2131`.

### `content_plan_domain_intelligence`

Namespace: `content`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
content_plan_domain_intelligence(message: str='', inputs: str='{}') -> str
~~~


Run the content domain agent action `plan_domain_intelligence`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:2241`.

### `content_prepare_publish`

Namespace: `content`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
content_prepare_publish(message: str='', inputs: str='{}') -> str
~~~


Run the content domain agent action `prepare_publish`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:1933`.

### `content_refine`

Namespace: `content`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
content_refine(message: str='', inputs: str='{}') -> str
~~~


Run the content domain agent action `refine`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:1911`.

### `content_repurpose`

Namespace: `content`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
content_repurpose(message: str='', inputs: str='{}') -> str
~~~


Run the content domain agent action `repurpose`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:2065`.

### `content_schedule`

Namespace: `content`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
content_schedule(message: str='', inputs: str='{}') -> str
~~~


Run the content domain agent action `schedule`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:2087`.

### `content_seo_optimize`

Namespace: `content`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
content_seo_optimize(message: str='', inputs: str='{}') -> str
~~~


Run the content domain agent action `seo_optimize`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:1977`.

### `content_seo_research`

Namespace: `content`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
content_seo_research(message: str='', inputs: str='{}') -> str
~~~


Run the content domain agent action `seo_research`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:1955`.

### `content_social_content_pipeline`

Namespace: `content`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
content_social_content_pipeline(message: str='', inputs: str='{}') -> str
~~~


Run the content domain agent action `social_content_pipeline`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:2197`.

### `content_sync_analytics`

Namespace: `content`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
content_sync_analytics(message: str='', inputs: str='{}') -> str
~~~


Run the content domain agent action `sync_analytics`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:2021`.

### `approve_runtime_action`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
approve_runtime_action(action_id: str) -> str
~~~


Approve (activate) a pending runtime action so it becomes dispatchable.

ADMIN/TENANT only (POST /api/domain-agents/runtime-actions/{id}/approve).
Requires the backend flag ``agents.runtime-registration.enabled`` (default
OFF → 403 while off).

Args:
    action_id: The runtime action UUID to approve.

Source: `lightbulb/mcp_server.py:3097`.

### `approve_task`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
approve_task(task_id: str, comments: str='') -> str
~~~


Approve a pending HITL task, allowing the agent workflow to continue.

This is a real decision — the agent will proceed with the proposed action.
Review the task details first with get_approval_details.

Args:
    task_id: The approval task UUID
    comments: Optional reason for approval

Source: `lightbulb/mcp_server.py:2813`.

### `approve_voice_action`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
approve_voice_action(execution_id: str, approval_task_id: str, comments: str='') -> str
~~~


Approve a pending in-call voice action.

Source: `lightbulb/mcp_server.py:3660`.

### `ask_document_agent`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
ask_document_agent(message: str, action: str='chat') -> str
~~~


Send a message to the document intelligence agent.

Use this for general document questions, analysis, comparisons,
or any document operation not covered by the specific tools above.

Args:
    message: Your message or question for the document agent
    action: Agent action — "chat", "compare_versions", "export_evidence_pack", etc.

Source: `lightbulb/mcp_server.py:1516`.

### `backbone_execute`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
backbone_execute(objective: str, inputs: str='{}') -> str
~~~


Execute a research, analysis, or code generation task via the backbone agent.

The backbone agent runs **server-side, scoped to your tenant** — it has a
Python REPL, web search, and access to your account's connectors, all
operating under your JWT and the platform's RBAC. This is *not* local code
execution on the customer's machine; nothing leaves the platform's scope.

Use it for complex multi-step analysis, data processing, or generating
code/scripts.

Args:
    objective: What you want the backbone agent to do
    inputs: Optional JSON string of structured inputs

Source: `lightbulb/mcp_server.py:1920`.

### `code_workspace_add_collaborator`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
code_workspace_add_collaborator(workspace_id: str, email: str='', user_id: str='', role: str='viewer') -> str
~~~


Add a collaborator to a workspace (role: viewer | editor | admin).

Source: `lightbulb/mcp_server.py:3781`.

### `code_workspace_add_note`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
code_workspace_add_note(workspace_id: str, content: str) -> str
~~~


Append a note to a workspace (visible to collaborators).

Source: `lightbulb/mcp_server.py:3855`.

### `code_workspace_approve_access_request`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
code_workspace_approve_access_request(workspace_id: str, request_id: str) -> str
~~~


Approve a pending access request.

Source: `lightbulb/mcp_server.py:3839`.

### `code_workspace_cancel_run`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
code_workspace_cancel_run(workspace_id: str, run_id: str) -> str
~~~


Cancel an in-flight coding run.

Source: `lightbulb/mcp_server.py:3949`.

### `code_workspace_chat`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
code_workspace_chat(workspace_id: str, message: str, action: str='chat', conversation_id: str='', active_file: str='', history: str='[]', attachments: str='[]', context: str='{}', policy: str='{}', preview_mode: bool=False, auto_push: bool=False, idempotency_key: str='', agent_model_selection_id: str='', agent_provider_connection_id: str='', agent_model_id: str='', agent_model_profile_id: str='') -> str
~~~


Send a message to a code workspace — ask it to write code, run commands, analyze files.

Args:
    workspace_id: The workspace ID to interact with
    message: Your instruction or question
    action: Optional coding action such as chat, explain_code, or propose_changes.
        propose_changes is normalized to preview chat mode for backend compatibility.
    conversation_id: Optional conversation/thread ID for continuity
    active_file: Optional active file path to bias the coding agent
    history: Optional JSON array of prior chat messages
    attachments: Optional JSON array of attachments
    context: Optional JSON object with structured coding context
    policy: Optional JSON object with workspace policy overrides
    preview_mode: If true, return proposed changes without mutating files
    auto_push: If true, allow the coding run to auto-push after verification

Source: `lightbulb/mcp_server.py:2168`.

### `code_workspace_claude_session_action`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
code_workspace_claude_session_action(workspace_id: str, session_id: str, action: str, body: str='{}') -> str
~~~


Perform a Claude SDK session action.

Args:
    action: One of: tag, fork, delete, interrupt, mcp/reconnect, mcp/toggle,
        rewind, tasks/stop, compact, rename
    body: JSON object payload (action-specific, e.g. {"tag": "..."} for tag).

Source: `lightbulb/mcp_server.py:3977`.

### `code_workspace_claude_sessions`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
code_workspace_claude_sessions(workspace_id: str) -> str
~~~


List Claude SDK sessions associated with a workspace.

Source: `lightbulb/mcp_server.py:3960`.

### `code_workspace_codex_thread_action`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
code_workspace_codex_thread_action(workspace_id: str, thread_id: str, action: str, body: str='{}') -> str
~~~


Perform a thread-level Codex action.

Args:
    action: One of: rename, archive, unarchive, compact, rollback
    body: JSON object payload.

Source: `lightbulb/mcp_server.py:4020`.

### `code_workspace_codex_threads`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
code_workspace_codex_threads(workspace_id: str, archived: str='') -> str
~~~


List Codex runtime threads for a workspace.

Source: `lightbulb/mcp_server.py:4000`.

### `code_workspace_codex_turn_action`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
code_workspace_codex_turn_action(workspace_id: str, thread_id: str, turn_id: str, action: str, body: str='{}') -> str
~~~


Steer or interrupt a specific Codex turn.

Args:
    action: steer | interrupt
    body: JSON object payload (e.g. {"guidance": "..."}).

Source: `lightbulb/mcp_server.py:4039`.

### `code_workspace_collaboration`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
code_workspace_collaboration(workspace_id: str) -> str
~~~


Get collaboration info (members, share-links, pending requests).

Source: `lightbulb/mcp_server.py:3773`.

### `code_workspace_create_share_link`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
code_workspace_create_share_link(workspace_id: str, role: str='viewer', expires_in_seconds: int=0) -> str
~~~


Create a share-link token granting access to the workspace.

Source: `lightbulb/mcp_server.py:3818`.

### `code_workspace_deny_access_request`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
code_workspace_deny_access_request(workspace_id: str, request_id: str) -> str
~~~


Deny a pending access request.

Source: `lightbulb/mcp_server.py:3847`.

### `code_workspace_get_active_run`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
code_workspace_get_active_run(workspace_id: str) -> str
~~~


Get the active coding run for a workspace, if one exists.

Source: `lightbulb/mcp_server.py:2396`.

### `code_workspace_get_run`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
code_workspace_get_run(workspace_id: str, run_id: str) -> str
~~~


Get the details for a specific coding run.

Source: `lightbulb/mcp_server.py:2407`.

### `code_workspace_proposal_apply`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
code_workspace_proposal_apply(workspace_id: str, proposal_id: str) -> str
~~~


Apply a code-change proposal to workspace files.

Source: `lightbulb/mcp_server.py:3924`.

### `code_workspace_proposal_reject`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
code_workspace_proposal_reject(workspace_id: str, proposal_id: str, reason: str='') -> str
~~~


Reject a code-change proposal.

Source: `lightbulb/mcp_server.py:3932`.

### `code_workspace_proposals`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
code_workspace_proposals(workspace_id: str) -> str
~~~


List code-change proposals for a workspace.

Source: `lightbulb/mcp_server.py:3907`.

### `code_workspace_pull_request`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
code_workspace_pull_request(workspace_id: str, body: str='{}') -> str
~~~


Open a GitHub pull request from the workspace branch.

Source: `lightbulb/mcp_server.py:3940`.

### `code_workspace_remove_collaborator`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
code_workspace_remove_collaborator(workspace_id: str, collaborator_id: str) -> str
~~~


Revoke a collaborator's access.

Source: `lightbulb/mcp_server.py:3809`.

### `code_workspace_revoke_share_link`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
code_workspace_revoke_share_link(workspace_id: str, link_id: str) -> str
~~~


Revoke a share link.

Source: `lightbulb/mcp_server.py:3830`.

### `code_workspace_run_review`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
code_workspace_run_review(workspace_id: str, run_id: str, verdict: str, feedback: str='') -> str
~~~


Submit a human review verdict for a run (accept | reject | request_changes).

Source: `lightbulb/mcp_server.py:3891`.

### `code_workspace_run_review_apply`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
code_workspace_run_review_apply(workspace_id: str, run_id: str) -> str
~~~


Apply review-suggested changes to the workspace.

Source: `lightbulb/mcp_server.py:3899`.

### `code_workspace_runs`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
code_workspace_runs(workspace_id: str, limit: int=20) -> str
~~~


List historical coding runs for a workspace.

Source: `lightbulb/mcp_server.py:3866`.

### `code_workspace_runs_insights`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
code_workspace_runs_insights(workspace_id: str) -> str
~~~


Aggregate run-quality insights for a workspace.

Source: `lightbulb/mcp_server.py:3883`.

### `code_workspace_update_collaborator`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
code_workspace_update_collaborator(workspace_id: str, collaborator_id: str, role: str) -> str
~~~


Change a collaborator's role.

Source: `lightbulb/mcp_server.py:3801`.

### `code_workspace_wait_for_run`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
code_workspace_wait_for_run(workspace_id: str, run_id: str='', timeout_seconds: int=60, poll_interval_seconds: int=2) -> str
~~~


Wait for a coding run to finish and return its latest status.

If run_id is omitted, the tool waits for the current active run.

Source: `lightbulb/mcp_server.py:2416`.

### `coding_run_command`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
coding_run_command(workspace_id: str='', cmd: str='', cwd: str='.', timeout_ms: int=60000, message: str='', inputs: str='{}') -> str
~~~


Run a shell command in a code workspace and get back its real output.

Executes the command **synchronously** against the workspace's sandboxed
runner via the proven ``exec.run`` tool and returns the command's
``exit_code``, ``stdout`` and ``stderr`` inline — there is no separate run
to poll. Scoped to your JWT / tenant / company; the workspace's command
allow-list and sandbox still apply (this does not widen exec capability).

Typical call:
    coding_run_command(workspace_id="<uuid>", cmd="python3 --version")

Args:
    workspace_id: The code workspace ID (UUID) to run the command in. Required.
    cmd: The shell command to execute, e.g. ``"python3 --version"`` or
        ``"pytest -q"``. Required.
    cwd: Working directory relative to the workspace root (default ``"."``).
    timeout_ms: Command timeout in milliseconds (default 60000).
    message: Back-compat alias for ``cmd`` (used only if ``cmd`` is empty).
    inputs: Back-compat JSON object that may carry
        ``{"workspace_id","cmd","cwd","timeout_ms"}`` (used only to fill
        args left empty above).

Returns:
    The command's exit_code plus its stdout and stderr.

Source: `lightbulb/mcp_server.py:2313`.

### `create_approval_auto_accept`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
create_approval_auto_accept(task_id: str, body: str='{}') -> str
~~~


Create an auto-accept rule from an existing approval task's shape.

Source: `lightbulb/mcp_server.py:4370`.

### `create_code_workspace`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
create_code_workspace(name: str='', repository_url: str='', branch: str='', repo_connection_id: str='', company_id: str='', source: str='', label: str='') -> str
~~~


Create a new code workspace so you can start a fresh coding / agent task.

A code workspace is a persistent sandboxed environment (file system, git,
command execution) that ``coding_run_command`` and ``code_workspace_chat``
operate against. Use this when no suitable workspace exists yet — it returns
the new workspace **id**, which you then pass to those tools.

Args:
    name: Human-friendly label for the workspace (alias for ``label``).
    repository_url: Git/source URL or path to clone into the workspace
        (alias for ``source``). Leave blank for an empty workspace.
    branch: Branch to check out (optional).
    repo_connection_id: UUID of a pre-configured repo OAuth connection to
        clone from instead of a raw URL (optional).
    company_id: Company UUID to scope the workspace to (optional; resolved
        from your active company when blank).
    source: Explicit source URL/path (takes precedence over
        ``repository_url`` when both are given).
    label: Explicit label (takes precedence over ``name`` when both given).

Returns:
    The new workspace id plus a short status line.

Source: `lightbulb/mcp_server.py:2108`.

### `create_crm_task`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
create_crm_task(body: str, tenant_id: str='') -> str
~~~


Create a CRM task. Body is JSON (title, status, assigneeId, dueDate, contactId, dealId, ...).

Source: `lightbulb/mcp_server.py:4323`.

### `create_document`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
create_document(title: str, body: str, format: str='docx', target_suite: str='internal_library') -> str
~~~


Create a new document (report, memo, brief, etc.).

Generates and stores a document in the specified format and target.

Args:
    title: Document title
    body: Document content/body text
    format: Output format — "docx", "pdf", "xlsx", "pptx", "gdoc", "gsheet", "gslides", "md"
    target_suite: Where to store — "internal_library", "google_workspace", "microsoft_365"

Source: `lightbulb/mcp_server.py:1471`.

### `create_project`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
create_project(name: str, instructions: str='', workspace_id: str='', repo_connection_id: str='', idempotency_key: str='') -> str
~~~


Create a Lightbulb project — the deterministic way to set up a project space.

Creates a persisted Project (POST /api/projects) that the consulting /
product-machine flow and ``get_product_machine_plan`` operate on. ``name`` is
required. Optionally bind an existing code workspace and/or repo connection.

Args:
    name: Project name. Required.
    instructions: Optional standing instructions / objective for the project.
    workspace_id: Optional code workspace UUID to attach.
    repo_connection_id: Optional repo OAuth connection UUID to attach.
    idempotency_key: Optional key — a retried create with the same key
        returns the existing project instead of duplicating it.

Returns:
    The new project id, name and status.

Source: `lightbulb/mcp_server.py:2916`.

### `create_slide_deck`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
create_slide_deck(title: str, body: str='', target_suite: str='internal_library') -> str
~~~


Create a new presentation / slide deck.

Args:
    title: Presentation title
    body: Optional content description or outline
    target_suite: Where to store — "internal_library", "google_workspace", "microsoft_365"

Source: `lightbulb/mcp_server.py:1502`.

### `create_spreadsheet`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
create_spreadsheet(title: str, body: str='', target_suite: str='internal_library') -> str
~~~


Create a new spreadsheet.

Args:
    title: Spreadsheet title
    body: Optional initial content or description
    target_suite: Where to store — "internal_library", "google_workspace", "microsoft_365"

Source: `lightbulb/mcp_server.py:1488`.

### `delete_approval_preference`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
delete_approval_preference(preference_id: str) -> str
~~~


Remove an auto-accept rule.

Source: `lightbulb/mcp_server.py:4379`.

### `delete_crm_task`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
delete_crm_task(task_id: str, tenant_id: str='') -> str
~~~


Delete a CRM task.

Source: `lightbulb/mcp_server.py:4341`.

### `dispatch_domain_agent`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
dispatch_domain_agent(domain: str, message: str, action: str='chat', inputs: str='{}') -> str
~~~


Dispatch a message to any domain agent on the platform.

Available domains: finance, crm, engineering, legal, hr, it_ops,
content, commerce, product, document_intelligence.

Args:
    domain: The domain agent to talk to
    message: Your message or objective
    action: The action to perform (default "chat")
    inputs: Optional JSON string of additional structured inputs

Source: `lightbulb/mcp_server.py:1532`.

### `doc_builder_add_collaborator`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
doc_builder_add_collaborator(session_id: str, email: str='', user_id: str='', role: str='viewer') -> str
~~~


Add a collaborator to a document builder session.

Source: `lightbulb/mcp_server.py:4529`.

### `doc_builder_collaboration`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
doc_builder_collaboration(session_id: str) -> str
~~~


Collaboration info for a document builder session.

Source: `lightbulb/mcp_server.py:4521`.

### `doc_builder_create_share_link`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
doc_builder_create_share_link(session_id: str, role: str='viewer', expires_in_seconds: int=0) -> str
~~~


Create a share-link token for a document builder session.

Source: `lightbulb/mcp_server.py:4549`.

### `doc_builder_get_messages`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
doc_builder_get_messages(session_id: str, limit: int=50) -> str
~~~


Get message history for a document builder session.

Source: `lightbulb/mcp_server.py:4561`.

### `doc_builder_save`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
doc_builder_save(session_id: str, body: str='{}') -> str
~~~


Save the current state of a document builder session.

Source: `lightbulb/mcp_server.py:4569`.

### `get_aoc_decision`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
get_aoc_decision(decision_id: str) -> str
~~~


Get a specific AutoCompany decision.

Source: `lightbulb/mcp_server.py:4171`.

### `get_aoc_run`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
get_aoc_run(run_id: str) -> str
~~~


Get an AutoCompany run detail.

Source: `lightbulb/mcp_server.py:4082`.

### `get_aoc_task`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
get_aoc_task(task_id: str) -> str
~~~


Get an AutoCompany task detail.

Source: `lightbulb/mcp_server.py:4126`.

### `get_aoc_tick`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
get_aoc_tick(tick_id: str) -> str
~~~


Get a single AutoCompany tick.

Source: `lightbulb/mcp_server.py:4206`.

### `get_approval_details`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
get_approval_details(task_id: str) -> str
~~~


Get full details of a pending approval task before deciding.

Shows the agent's reasoning, proposed action, risk assessment,
and any supporting evidence.

Args:
    task_id: The approval task UUID

Source: `lightbulb/mcp_server.py:2797`.

### `get_artifact`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
get_artifact(artifact_id: str) -> str
~~~


Get the full content of a specific artifact.

Args:
    artifact_id: The artifact UUID

Source: `lightbulb/mcp_server.py:2477`.

### `get_crm_task`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
get_crm_task(task_id: str, tenant_id: str='') -> str
~~~


Get a CRM task detail.

Source: `lightbulb/mcp_server.py:4315`.

### `get_product_machine_plan`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
get_product_machine_plan(project_id: str) -> str
~~~


Get a project's product-machine plan and deliverables
(GET /api/projects/{id}/product-machine/plan).

This is what the consulting flow produces — the structured plan, artifacts
and deliverables for the project.

Args:
    project_id: The project UUID.

Source: `lightbulb/mcp_server.py:2990`.

### `get_project`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
get_project(project_id: str) -> str
~~~


Get a single Lightbulb project's detail (GET /api/projects/{id}).

Args:
    project_id: The project UUID.

Source: `lightbulb/mcp_server.py:2978`.

### `get_voice_execution`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
get_voice_execution(execution_id: str) -> str
~~~


Get a voice execution detail (transcript, status, agent decisions).

Source: `lightbulb/mcp_server.py:3634`.

### `grep_documents`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
grep_documents(pattern: str, regex: bool=True, case_sensitive: bool=False, folder_path: str='', top_k: int=20) -> str
~~~


Grep across document content using pattern matching (like ripgrep).

Use this to find exact text matches, regex patterns, or specific strings
across all documents. Returns line-level matches with context.

Args:
    pattern: The search pattern (regex by default, or exact string)
    regex: Whether to use regex matching (default True)
    case_sensitive: Whether the search is case-sensitive (default False)
    folder_path: Optional folder path to scope the search
    top_k: Max number of chunk results to return (default 20)

Source: `lightbulb/mcp_server.py:1415`.

### `hr_live_advance_application`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
hr_live_advance_application(application_id: str, body: str='{}') -> str
~~~


Advance a Greenhouse candidate to the next stage (HITL-gated).

Source: `lightbulb/mcp_server.py:3744`.

### `hr_live_cases`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
hr_live_cases() -> str
~~~


HR case-board items from Monday.com.

Source: `lightbulb/mcp_server.py:3712`.

### `hr_live_health`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
hr_live_health() -> str
~~~


Health check for HR connector tokens (BambooHR / Greenhouse / Monday).

Source: `lightbulb/mcp_server.py:3762`.

### `hr_live_leave_balance`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
hr_live_leave_balance(bamboo_employee_id: str) -> str
~~~


BambooHR leave balance for an employee.

Source: `lightbulb/mcp_server.py:3696`.

### `hr_live_monday_board`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
hr_live_monday_board(checklist_id: str) -> str
~~~


Monday.com board for an HR onboarding checklist.

Source: `lightbulb/mcp_server.py:3704`.

### `hr_live_recruiting_applications`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
hr_live_recruiting_applications(job_id: str='', status: str='') -> str
~~~


List Greenhouse applications.

Source: `lightbulb/mcp_server.py:3731`.

### `hr_live_recruiting_jobs`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
hr_live_recruiting_jobs(status: str='') -> str
~~~


List Greenhouse jobs.

Source: `lightbulb/mcp_server.py:3720`.

### `hr_live_reject_application`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
hr_live_reject_application(application_id: str, body: str='{}') -> str
~~~


Reject a Greenhouse application (HITL-gated).

Source: `lightbulb/mcp_server.py:3753`.

### `hr_live_whos_out`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
hr_live_whos_out() -> str
~~~


BambooHR who's-out roster (current and upcoming time-off).

Source: `lightbulb/mcp_server.py:3688`.

### `invoke_tool`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
invoke_tool(tool_name: str, arguments: str='{}') -> str
~~~


Invoke a platform tool directly by name.

Tools include connector operations (e.g. "hubspot.list_contacts"),
utility tools, and more. Use list_connectors to see available tools.

Args:
    tool_name: The tool to invoke (e.g. "slack.post_message")
    arguments: JSON string of tool arguments

Source: `lightbulb/mcp_server.py:2662`.

### `it_ops_live_github`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
it_ops_live_github() -> str
~~~


Live GitHub data passthrough for the IT-Ops workspace.

Source: `lightbulb/mcp_server.py:4457`.

### `it_ops_live_jira`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
it_ops_live_jira() -> str
~~~


Live Jira data passthrough for the IT-Ops workspace.

Source: `lightbulb/mcp_server.py:4441`.

### `it_ops_live_notion`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
it_ops_live_notion() -> str
~~~


Live Notion data passthrough for the IT-Ops workspace.

Source: `lightbulb/mcp_server.py:4465`.

### `it_ops_live_slack`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
it_ops_live_slack() -> str
~~~


Live Slack data passthrough for the IT-Ops workspace.

Source: `lightbulb/mcp_server.py:4449`.

### `it_ops_mcp_manifest`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
it_ops_mcp_manifest() -> str
~~~


Get the IT-Ops workspace MCP manifest.

Source: `lightbulb/mcp_server.py:4473`.

### `list_aoc_decisions`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
list_aoc_decisions(status: str='', limit: int=20) -> str
~~~


List AutoCompany decisions (pending or resolved).

Source: `lightbulb/mcp_server.py:4151`.

### `list_aoc_runs`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
list_aoc_runs(status: str='', limit: int=20) -> str
~~~


List AutoCompany cognitive-loop runs.

Source: `lightbulb/mcp_server.py:4062`.

### `list_aoc_task_events`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
list_aoc_task_events(task_id: str) -> str
~~~


List events recorded against an AutoCompany task.

Source: `lightbulb/mcp_server.py:4134`.

### `list_aoc_tasks`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
list_aoc_tasks(run_id: str='', limit: int=20) -> str
~~~


List AutoCompany tasks (optionally scoped to a run).

Source: `lightbulb/mcp_server.py:4106`.

### `list_aoc_ticks`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
list_aoc_ticks(run_id: str='', limit: int=20) -> str
~~~


List the cognitive-loop ticks for an AutoCompany control run.

The backend scopes ticks to a control run, so ``run_id`` is required (it is
sent as the backend's ``controlRunId`` query param). Get a run id from
``list_aoc_runs`` first.

Args:
    run_id: The AutoCompany control run UUID to list ticks for. Required.
    limit: Max ticks to return (default 20).

Source: `lightbulb/mcp_server.py:4179`.

### `list_approval_preferences`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
list_approval_preferences() -> str
~~~


List the user's HITL auto-accept rules.

Source: `lightbulb/mcp_server.py:4353`.

### `list_artifacts`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
list_artifacts(artifact_type: str='') -> str
~~~


List artifacts — charts, reports, analyses, code, and other outputs from agent runs.

Args:
    artifact_type: Optional filter by type (e.g. "chart", "report", "code", "csv")

Source: `lightbulb/mcp_server.py:2454`.

### `list_code_workspaces`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
list_code_workspaces() -> str
~~~


List all code workspaces available to you.

Code workspaces are persistent environments with file systems, git, and
execution capabilities.

Source: `lightbulb/mcp_server.py:2077`.

### `list_companies`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
list_companies() -> str
~~~


List companies in the user's tenant.

ADMIN and TENANT users need to select a company before using domain agents,
CRM, finance, or other company-scoped operations. COMPANY users already
have a company set automatically.

Source: `lightbulb/mcp_server.py:3158`.

### `list_connected_integrations`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
list_connected_integrations() -> str
~~~


List connected integrations for the current company context.

Shows what data sources are connected — QuickBooks, Stripe, HubSpot,
Google Drive, Slack, etc. Helps you understand what data is available
before running domain agent actions.

Source: `lightbulb/mcp_server.py:3257`.

### `list_connectors`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
list_connectors() -> str
~~~


List all available connectors and their connection status.

Shows which integrations (Slack, HubSpot, Stripe, etc.) are connected.

Source: `lightbulb/mcp_server.py:2643`.

### `list_crm_contacts`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
list_crm_contacts(search: str='', limit: int=20) -> str
~~~


List CRM contacts, optionally filtered by search query.

Args:
    search: Optional search term to filter contacts
    limit: Max results (default 20)

Source: `lightbulb/mcp_server.py:2690`.

### `list_crm_deals`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
list_crm_deals(search: str='', limit: int=20) -> str
~~~


List CRM deals/opportunities.

Args:
    search: Optional search term
    limit: Max results (default 20)

Source: `lightbulb/mcp_server.py:2720`.

### `list_crm_tasks`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
list_crm_tasks(tenant_id: str='', limit: int=20) -> str
~~~


List CRM tasks (defaults to authed tenant).

Source: `lightbulb/mcp_server.py:4298`.

### `list_domain_actions`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
list_domain_actions(domain: str) -> str
~~~


List available actions for a specific domain agent.

Args:
    domain: The domain name (e.g. "finance", "crm", "legal")

Source: `lightbulb/mcp_server.py:3314`.

### `list_domains`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
list_domains() -> str
~~~


List all available domain agents and their capabilities.

Shows every domain agent on the platform with their supported actions.

Source: `lightbulb/mcp_server.py:3291`.

### `list_folder`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
list_folder(folder_path: str='/', source_system: str='', max_items: int=100) -> str
~~~


List documents in a folder or the entire document library.

Use this to browse the document library, see what files exist,
and explore folder structures.

Args:
    folder_path: Folder path to list (default "/" for root)
    source_system: Filter by source (e.g. "google_drive", "microsoft_graph", "workspace")
    max_items: Max number of items to return (default 100)

Source: `lightbulb/mcp_server.py:1435`.

### `list_notifications`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
list_notifications(limit: int=20) -> str
~~~


List recent notifications — HITL decisions, workflow alerts, system messages.

Args:
    limit: Max results (default 20)

Source: `lightbulb/mcp_server.py:2747`.

### `list_pending_approvals`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
list_pending_approvals() -> str
~~~


List all pending approval tasks waiting for your decision.

These are human-in-the-loop (HITL) decisions from agent workflows —
things like purchase approvals, content sign-offs, or deployment gates
that require a human to approve or reject before the agent continues.

Source: `lightbulb/mcp_server.py:2769`.

### `list_projects`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
list_projects() -> str
~~~


List the Lightbulb projects you can access (GET /api/projects).

Source: `lightbulb/mcp_server.py:2960`.

### `list_runtime_actions`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
list_runtime_actions(status: str='active') -> str
~~~


List custom runtime-authored domain actions by status.

GET /api/domain-agents/runtime-actions?status=. Requires the backend flag
``agents.runtime-registration.enabled`` (default OFF → 403 while off).

Args:
    status: Filter — ``active`` (default), ``pending_approval``, ``rejected``.

Source: `lightbulb/mcp_server.py:3131`.

### `list_voice_executions`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
list_voice_executions(status: str='', limit: int=20) -> str
~~~


List voice agent executions (live and historical phone calls).

Args:
    status: Optional filter (active, completed, failed, transferred)
    limit: Max results

Source: `lightbulb/mcp_server.py:3601`.

### `list_voice_pending_approvals`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
list_voice_pending_approvals() -> str
~~~


List in-call HITL approvals waiting for caller-side decision.

Source: `lightbulb/mcp_server.py:3643`.

### `list_workflows`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
list_workflows() -> str
~~~


List workflow definitions available on the platform.

Source: `lightbulb/mcp_server.py:2560`.

### `mark_all_notifications_read`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
mark_all_notifications_read() -> str
~~~


Mark all notifications as read.

Source: `lightbulb/mcp_server.py:4406`.

### `mark_notification_read`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
mark_notification_read(notification_id: str) -> str
~~~


Mark a notification as read.

Source: `lightbulb/mcp_server.py:4398`.

### `memory_graph`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
memory_graph(focus: str='', depth: int=0) -> str
~~~


Read the memory graph (or a filtered subgraph).

Source: `lightbulb/mcp_server.py:4250`.

### `memory_graph_node`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
memory_graph_node(node_id: str) -> str
~~~


Get a single node from the memory graph.

Source: `lightbulb/mcp_server.py:4263`.

### `memory_list_entries`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
memory_list_entries(limit: int=50) -> str
~~~


List structured memory entries.

Source: `lightbulb/mcp_server.py:4217`.

### `memory_list_events`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
memory_list_events(limit: int=50) -> str
~~~


List memory events (timeline of state changes).

Source: `lightbulb/mcp_server.py:4279`.

### `memory_list_identity`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
memory_list_identity() -> str
~~~


List identity records in the memory graph.

Source: `lightbulb/mcp_server.py:4271`.

### `memory_list_skills`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
memory_list_skills() -> str
~~~


List skills/capabilities recorded in memory.

Source: `lightbulb/mcp_server.py:4287`.

### `memory_projection_memory`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
memory_projection_memory() -> str
~~~


Memory-structure projection of the agent.

Source: `lightbulb/mcp_server.py:4242`.

### `memory_projection_soul`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
memory_projection_soul() -> str
~~~


Identity / personality projection of the agent.

Source: `lightbulb/mcp_server.py:4234`.

### `memory_query`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
memory_query(body: str) -> str
~~~


Run a structured memory query (filters, time-windows, semantic). Body is JSON.

Source: `lightbulb/mcp_server.py:4225`.

### `memory_recall`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
memory_recall(key: str, namespace: str='default') -> str
~~~


Recall a value from agent memory.

Args:
    key: Memory key to recall
    namespace: Memory namespace (default "default")

Source: `lightbulb/mcp_server.py:2869`.

### `memory_search`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
memory_search(query: str, namespace: str='default', top_k: int=5) -> str
~~~


Search agent memory semantically.

Args:
    query: What to search for
    namespace: Memory namespace (default "default")
    top_k: Number of results (default 5)

Source: `lightbulb/mcp_server.py:2884`.

### `memory_store`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
memory_store(key: str, value: str, namespace: str='default') -> str
~~~


Store a value in the platform's agent memory.

Use this to persist information across conversations and sessions.

Args:
    key: Memory key (e.g. "user_preferences", "project_context")
    value: The value to store
    namespace: Memory namespace (default "default")

Source: `lightbulb/mcp_server.py:2852`.

### `modify_voice_action`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
modify_voice_action(execution_id: str, approval_task_id: str, modifications: str) -> str
~~~


Approve a voice action with modifications. modifications is a JSON object.

Source: `lightbulb/mcp_server.py:3676`.

### `page_builder_capabilities`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
page_builder_capabilities(session_id: str) -> str
~~~


List page capabilities (forms, search, auth, etc.).

Source: `lightbulb/mcp_server.py:4493`.

### `page_builder_chat`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
page_builder_chat(session_id: str, message: str) -> str
~~~


Send a message to a page builder session to design or modify pages.

The page builder agent generates HTML/CSS/JS for your website.
Use iterative messages to refine the design.

Args:
    session_id: The session ID from page_builder_create
    message: Your instruction (e.g. "Add a pricing section with 3 tiers")

Source: `lightbulb/mcp_server.py:1861`.

### `page_builder_create`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
page_builder_create(brand_name: str='', initial_prompt: str='', force_page_builder: bool=False) -> str
~~~


Create a new page builder session to build a website or landing page.

Returns a session ID you can use with page_builder_chat to iteratively
design and build pages.

Args:
    brand_name: The brand/company name for the site
    initial_prompt: Optional initial instruction (e.g. "Build a landing page for our SaaS product")
    force_page_builder: If true, create a pure Page Builder design session instead of routing project-build intent to consulting workflow.

Source: `lightbulb/mcp_server.py:1808`.

### `page_builder_deploy`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
page_builder_deploy(session_id: str, page_key: str='') -> str
~~~


Deploy a page builder session to make the site live.

Args:
    session_id: The session ID
    page_key: Optional specific page to deploy (deploys all if empty)

Source: `lightbulb/mcp_server.py:1885`.

### `page_builder_install_artifact`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
page_builder_install_artifact(session_id: str, body: str) -> str
~~~


Install a component artifact into the page session. Body is JSON.

Source: `lightbulb/mcp_server.py:4501`.

### `page_builder_list_sessions`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
page_builder_list_sessions() -> str
~~~


List existing page builder sessions.

Source: `lightbulb/mcp_server.py:1844`.

### `page_builder_preview`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
page_builder_preview(session_id: str) -> str
~~~


Get the preview URL for a page builder session.

Args:
    session_id: The session ID

Source: `lightbulb/mcp_server.py:1902`.

### `page_builder_unpublish`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
page_builder_unpublish(session_id: str) -> str
~~~


Unpublish a deployed page builder session.

Source: `lightbulb/mcp_server.py:4510`.

### `page_builder_workspace_automation`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
page_builder_workspace_automation(session_id: str, body: str='{}') -> str
~~~


Run the page-builder workspace automation (auto-wire pages → agents → backend).

Source: `lightbulb/mcp_server.py:4484`.

### `post_aoc_task_event`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
post_aoc_task_event(task_id: str, body: str) -> str
~~~


Post a new event onto an AutoCompany task. Body is JSON.

Source: `lightbulb/mcp_server.py:4142`.

### `rag_query`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
rag_query(question: str, top_k: int=5) -> str
~~~


Query the RAG knowledge base directly with a question.

Returns relevant passages from indexed documents with citations.

Args:
    question: Your question
    top_k: Number of results to return (default 5)

Source: `lightbulb/mcp_server.py:2599`.

### `rag_upload`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
rag_upload(filename: str, content: str) -> str
~~~


Upload a document to the RAG knowledge base for indexing.

Args:
    filename: The filename (e.g. "meeting-notes.md")
    content: The document content (text)

Source: `lightbulb/mcp_server.py:2626`.

### `register_external_artifact`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
register_external_artifact(type: str, title: str='', summary: str='', uri: str='', content: str='', project_id: str='', source_agent: str='external_agent', attach_workspace: bool=False) -> str
~~~


Register an artifact you created OUTSIDE Lightbulb so Lightbulb's domain agents can
discover, reference, and work on it.

Use this whenever you (Claude, Claude Code, ChatGPT, Codex, Hermes, etc.) produce something
external while orchestrating Lightbulb — a code repository, document, slide deck, spreadsheet,
report, or any URL — and you want it to become a first-class, discoverable Lightbulb artifact
(searchable via list_artifacts and routable to domain agents / code workspaces).

Args:
    type: Artifact class — one of: codebase, document, slide_deck, spreadsheet, report, url.
    title: Human-readable title.
    summary: Short description of what it is and why it matters.
    uri: External reference (e.g. a GitHub repo URL, Google Doc URL, file link). Provide this
         OR content.
    content: Inline text content (for documents/reports) when there is no external URL.
    project_id: Optional Lightbulb project UUID to associate the artifact with.
    source_agent: The agent that created it (e.g. "claude_code", "codex", "chatgpt", "hermes").
    attach_workspace: For a codebase artifact with a repo uri, also clone it into a Lightbulb
        Code Workspace so domain agents can work on it (not just discover it).

Source: `lightbulb/mcp_server.py:2490`.

### `register_runtime_action`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
register_runtime_action(domain: str, action: str, description: str='', agent_spec: str='{}', component_ids: str='[]', workflow_type: str='') -> str
~~~


Author a custom agent action via the dynamic-agent factory.

Registers a new (domain, action) (POST /api/domain-agents/runtime-actions).
It lands as ``pending_approval`` and is NOT dispatchable until an ADMIN/TENANT
calls ``approve_runtime_action``. Provide an ``agent_spec`` to author a
brand-new agent (``domain`` may be ``"custom"``); without one, ``domain`` must
be an existing contract domain and this adds an action to it.

NOTE: this whole factory surface is gated behind the backend flag
``agents.runtime-registration.enabled`` (default OFF) — while it is off these
calls return 403. The tool is wired correctly; the flag is a separate backend
config change.

Args:
    domain: Target domain (an existing domain, or ``"custom"`` for a new agent).
    action: Action name to register.
    description: Human-readable description of what the action does.
    agent_spec: JSON object (as a string) describing the agent to author
        (model, prompt, tools, …). Pass ``"{}"`` to register a plain action
        on an existing domain instead.
    component_ids: JSON array (as a string) of component ids the action uses.
    workflow_type: Optional workflow type to bind the action to.

Returns:
    The registered action id, status and identity.

Source: `lightbulb/mcp_server.py:3031`.

### `reject_runtime_action`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
reject_runtime_action(action_id: str) -> str
~~~


Reject a pending runtime action.

ADMIN/TENANT only (POST /api/domain-agents/runtime-actions/{id}/reject).
Requires the backend flag ``agents.runtime-registration.enabled`` (default
OFF → 403 while off).

Args:
    action_id: The runtime action UUID to reject.

Source: `lightbulb/mcp_server.py:3114`.

### `reject_task`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
reject_task(task_id: str, comments: str='') -> str
~~~


Reject a pending HITL task, stopping the agent workflow.

The agent will not proceed with the proposed action.

Args:
    task_id: The approval task UUID
    comments: Reason for rejection

Source: `lightbulb/mcp_server.py:2832`.

### `reject_voice_action`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
reject_voice_action(execution_id: str, approval_task_id: str, comments: str='') -> str
~~~


Reject a pending in-call voice action.

Source: `lightbulb/mcp_server.py:3668`.

### `search_documents`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
search_documents(query: str, folder_path: str='', top_k: int=10) -> str
~~~


Search across all documents using semantic search.

Use this to find documents relevant to a topic, question, or keyword.
Returns ranked results with snippets and source paths.

Args:
    query: The search query (natural language or keywords)
    folder_path: Optional folder path to scope the search (e.g. "/contracts")
    top_k: Max number of results to return (default 10)

Source: `lightbulb/mcp_server.py:1397`.

### `search_folder`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
search_folder(query: str, folder_path: str='/', search_mode: str='semantic') -> str
~~~


Search within a specific folder using semantic or keyword matching.

Combines folder-scoped search with AI-synthesized answers.
Good for asking questions about documents in a specific folder.

Args:
    query: The search query or question
    folder_path: Folder path to search within
    search_mode: "semantic" (default) or "exact" or "regex"

Source: `lightbulb/mcp_server.py:1453`.

### `select_company`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
select_company(company_id: str) -> str
~~~


Select a company context for subsequent operations.

ADMIN and TENANT users must select a company before using domain agents
or other company-scoped features. This determines which CRM data,
financial accounts, connectors, etc. you're working with.

Args:
    company_id: The company UUID from list_companies

Source: `lightbulb/mcp_server.py:3184`.

### `set_approval_preference_state`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
set_approval_preference_state(preference_id: str, enabled: bool=True) -> str
~~~


Enable or disable an auto-accept rule.

Source: `lightbulb/mcp_server.py:4387`.

### `software_delivery_context`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
software_delivery_context(repository: str='', workspace_id: str='', project_key: str='', include_live: bool=True, include_memory: bool=True) -> str
~~~


Get the Lightbulb software-delivery context packet before editing code.

Use this from Claude Code, Codex, or Cursor before making a repo change. It
gathers IT/Ops, coding workspace, project-management, deployment, CloudOps,
connector, memory, and approval context under the authenticated user's RBAC
scope.

Source: `lightbulb/mcp_server.py:1563`.

### `software_delivery_loop`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
software_delivery_loop(request: str, workspace_id: str='', repository: str='', github_owner: str='', github_repo: str='', project_key: str='', environment: str='staging', mode: str='feedback_to_code', execute_coding: bool=True, open_pr: bool=False, auto_push: bool=False, trigger_deploy: bool=False, extra_inputs: str='{}') -> str
~~~


Run the governed software loop from MCP: feedback/SDLC -> coding -> PR -> deploy.

This is the main bridge for external coding tools. It routes through
Lightbulb's IT/Ops orchestrator so repo binding, SDLC context, CloudOps,
GitHub, HITL, tests, container release, and deployment gates travel
together.

Source: `lightbulb/mcp_server.py:1624`.

### `software_spot_weld_fix`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
software_spot_weld_fix(request: str, workspace_id: str, repository: str='', github_owner: str='', github_repo: str='', project_key: str='', environment: str='staging', scope: str='code', severity: str='high', preview_mode: bool=True, open_pr: bool=True, auto_push: bool=False, trigger_deploy: bool=False, extra_inputs: str='{}') -> str
~~~


Request a bounded urgent production/cloud fix through the Lightbulb loop.

Defaults are intentionally conservative: preview mode on, PR on, deploy off.
Production or cloud-impacting fixes are routed with approval gates and
CloudOps/deployment context rather than direct mutation.

Source: `lightbulb/mcp_server.py:1710`.

### `start_consulting_project_workflow`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
start_consulting_project_workflow(objective: str, project_context: str='{}', project_id: str='', source: str='mcp') -> str
~~~


Start or continue the Lightbulb consulting project workflow through Backbone.

Use this instead of jumping directly to coding, GitHub, deployment, connector
mutation, or external communications when a user has a project idea, custom
agent request, workflow automation request, SOP/process change, modernization
request, or build request that still needs discovery, requirements, scope,
SOP impact or referenced SOPs, approval gates, and execution work packets.

Args:
    objective: The project idea or business outcome the user wants to achieve.
    project_context: Optional JSON object with known facts, current systems,
        requirements, constraints, uploaded-doc references, or host context.
    project_id: Optional existing Lightbulb project identifier to continue.
    source: Host/source string such as codex, claude_code, chatgpt, cursor, or mcp.

Source: `lightbulb/mcp_server.py:1948`.

### `stop_aoc_run`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
stop_aoc_run(run_id: str) -> str
~~~


Stop an in-flight AutoCompany cognitive-loop run.

Source: `lightbulb/mcp_server.py:4090`.

### `stripe_account_health`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
stripe_account_health() -> str
~~~


Composite health score per connected Stripe account, plus the
at-risk subset (score < 60) for direct triage.

Source: `lightbulb/mcp_server.py:3446`.

### `stripe_approve`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
stripe_approve(approval_id: str) -> str
~~~


Approve a pending Stripe orchestrator decision so it can execute.

Source: `lightbulb/mcp_server.py:3413`.

### `stripe_dispatch`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
stripe_dispatch(resource: str, verb: str, op_inputs: str='{}', stripe_account_id: str='') -> str
~~~


Run any Stripe-orchestrator (resource, verb) op.

Routes through the policy → simulator → Merkle audit → execute/queue
chokepoint, exactly like our internal agents.

Args:
    resource: e.g. "customers", "subscriptions", "refunds", "tax_calculations"
    verb: e.g. "create", "retrieve", "update", "list", "cancel"
    op_inputs: JSON object of operation inputs as string.
    stripe_account_id: Optional connected-account id.

Source: `lightbulb/mcp_server.py:3342`.

### `stripe_execute_approved`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
stripe_execute_approved(approval_id: str) -> str
~~~


Execute a previously-approved Stripe decision (idempotent replay safe).

Source: `lightbulb/mcp_server.py:3429`.

### `stripe_forecast_snapshot`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
stripe_forecast_snapshot() -> str
~~~


Predictive forecast for the merchant: MRR, failed-payment rate,
dispute risk band, payout cashflow band. Server-computed; no Stripe RTT.

Source: `lightbulb/mcp_server.py:3437`.

### `stripe_list_pending_approvals`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
stripe_list_pending_approvals() -> str
~~~


List Stripe-orchestrator approvals waiting for human action.

Source: `lightbulb/mcp_server.py:3405`.

### `stripe_raw_api_request`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
stripe_raw_api_request(api_path: str, method: str='GET', params: str='{}', stripe_account_id: str='', base_address: str='') -> str
~~~


Governed long-tail Stripe API request for /v1 or /v2 endpoints.

Non-GET requests still route through the platform's simulator, audit,
idempotency, and human-approval gate before execution.

Args:
    api_path: Stripe API path, e.g. "/v1/setup_intents".
    method: GET, POST, or DELETE.
    params: JSON object of request parameters.
    stripe_account_id: Optional connected-account id.
    base_address: Optional Stripe base address, e.g. "api", "connect", "files".

Source: `lightbulb/mcp_server.py:3365`.

### `stripe_reject`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
stripe_reject(approval_id: str, reason: str='') -> str
~~~


Reject a pending Stripe orchestrator decision.

Source: `lightbulb/mcp_server.py:3421`.

### `stripe_run_workflow`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
stripe_run_workflow(workflow: str) -> str
~~~


Run a high-level composite workflow.

Args:
    workflow: One of workflow.failed_payment_recovery,
              workflow.churn_save_outreach,
              workflow.dispute_evidence_drafting,
              workflow.subscription_health_audit

Source: `lightbulb/mcp_server.py:3455`.

### `stripe_twin_list`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
stripe_twin_list(resource_kind: str, limit: int=50) -> str
~~~


Fast Postgres-backed read of the Stripe Digital Twin (no Stripe RTT).

Args:
    resource_kind: e.g. "customer", "subscription", "invoice", "charge"
    limit: Max rows to return (default 50, cap 100).

Source: `lightbulb/mcp_server.py:3392`.

### `trigger_workflow`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
trigger_workflow(workflow_type: str, objective: str, inputs: str='{}') -> str
~~~


Trigger a workflow execution.

Args:
    workflow_type: The workflow type to trigger (e.g. "enterprise_document_intelligence")
    objective: What the workflow should accomplish
    inputs: Optional JSON string of structured inputs

Source: `lightbulb/mcp_server.py:2576`.

### `update_crm_task`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
update_crm_task(task_id: str, body: str, tenant_id: str='') -> str
~~~


Update a CRM task. Body is JSON of fields to change.

Source: `lightbulb/mcp_server.py:4332`.

### `update_product_machine_plan`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
update_product_machine_plan(project_id: str, plan: str) -> str
~~~


Replace a project's product-machine plan
(PUT /api/projects/{id}/product-machine/plan).

Args:
    project_id: The project UUID.
    plan: A JSON object (as a string) with the new product-machine plan.

Source: `lightbulb/mcp_server.py:3006`.

### `validate_aoc_run_config`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
validate_aoc_run_config(run_id: str) -> str
~~~


Validate an AutoCompany run's configuration.

Source: `lightbulb/mcp_server.py:4098`.

### `whoami`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
whoami() -> str
~~~


Show your identity, role, tenant, company, and what you can access.

Use this to understand your current context — especially useful for
debugging permission issues or confirming which company is selected.

Source: `lightbulb/mcp_server.py:3214`.

### `workspace_bundle`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
workspace_bundle(domain: str) -> str
~~~


Get a domain workspace data bundle (state, surfaces, recent runs).

Source: `lightbulb/mcp_server.py:4417`.

### `workspace_surface`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
workspace_surface(domain: str, surface: str) -> str
~~~


Read a domain workspace surface (e.g. internal_suite).

Source: `lightbulb/mcp_server.py:4433`.

### `workspace_trace`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
workspace_trace(domain: str, trace_id: str) -> str
~~~


Get a workspace trace (full agent execution log).

Source: `lightbulb/mcp_server.py:4425`.

### `xero_agent_approve_proposal`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_agent_approve_proposal(proposal_id: str, body: str='{}') -> str
~~~


Approve a Xero proposal so it can execute.

Source: `lightbulb/mcp_server.py:3513`.

### `xero_agent_create_proposal`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_agent_create_proposal(body: str) -> str
~~~


Create a Xero proposal (queues an HITL approval). Body is JSON.

Source: `lightbulb/mcp_server.py:3504`.

### `xero_agent_org_profile`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_agent_org_profile(xero_tenant_id: str) -> str
~~~


Get the Xero org profile (chart of accounts, tax rates, branding).

Source: `lightbulb/mcp_server.py:3554`.

### `xero_agent_proposals`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_agent_proposals(body: str='{}') -> str
~~~


Generate Xero proposals (reconciliation, AP, payroll, etc.).

Args:
    body: Optional JSON object (e.g. {"kind": "bank_reconciliation"})

Source: `lightbulb/mcp_server.py:3491`.

### `xero_agent_reject_proposal`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_agent_reject_proposal(proposal_id: str, reason: str='') -> str
~~~


Reject a Xero proposal.

Source: `lightbulb/mcp_server.py:3522`.

### `xero_agent_run_playbook`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_agent_run_playbook(playbook_id: str, body: str='{}') -> str
~~~


Run a Xero playbook.

Args:
    playbook_id: month_end_close, ar_followup, ap_intake_to_pay,
        bank_reconciliation, payroll_trueup, reporting_pack, consolidation.
    body: Optional JSON object of inputs.

Source: `lightbulb/mcp_server.py:3539`.

### `xero_agent_run_sync`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_agent_run_sync(body: str='{}') -> str
~~~


Trigger a Xero data sync (orgs, AR/AP, payroll, ledger).

Source: `lightbulb/mcp_server.py:3530`.

### `xero_agent_snapshot`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_agent_snapshot(body: str='{}') -> str
~~~


Multi-org Xero financial snapshot (cash, AR, AP, payroll, taxes).

Args:
    body: Optional JSON object of filters (e.g. {"xero_tenant_ids": ["..."]})

Source: `lightbulb/mcp_server.py:3478`.

### `xero_intake_bill`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_intake_bill(body: str) -> str
~~~


Propose an AP bill into Xero (HITL-gated). Body is JSON.

Source: `lightbulb/mcp_server.py:3571`.

### `xero_intake_invoice`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_intake_invoice(body: str) -> str
~~~


Propose an AR invoice into Xero (HITL-gated). Body is JSON.

Source: `lightbulb/mcp_server.py:3562`.

### `xero_intake_journal`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_intake_journal(body: str) -> str
~~~


Propose a manual journal into Xero (HITL-gated). Body is JSON.

Source: `lightbulb/mcp_server.py:3580`.

### `xero_intake_payroll_trueup`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_intake_payroll_trueup(body: str) -> str
~~~


Propose a payroll true-up into Xero (HITL-gated). Body is JSON.

Source: `lightbulb/mcp_server.py:3589`.

### `crm_agentic_plan`

Namespace: `crm`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
crm_agentic_plan(message: str='', inputs: str='{}') -> str
~~~


Run the crm domain agent action `agentic_plan`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:2702`.

### `crm_assess_pipeline`

Namespace: `crm`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
crm_assess_pipeline(message: str='', owner_email: Optional[str]=None, min_amount_usd: Optional[float]=None) -> str
~~~


Audit your active sales pipeline. Flags stalled deals, missing
next-steps, optimistic close dates, and stage-fit mismatches; returns
a prioritised action list for the rep and manager.
    Args:
        message: Free-text objective for the action.
        owner_email: Pipeline owner; empty = whole team.
        min_amount_usd: Filter to deals above this amount.

Source: `lightbulb/mcp_generated_tools.py:2484`.

### `crm_autonomous_source`

Namespace: `crm`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
crm_autonomous_source(message: str='', inputs: str='{}') -> str
~~~


Run the crm domain agent action `autonomous_source`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:2504`.

### `crm_book_meeting`

Namespace: `crm`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
crm_book_meeting(message: str='', inputs: str='{}') -> str
~~~


Run the crm domain agent action `book_meeting`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:2680`.

### `crm_chat`

Namespace: `crm`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
crm_chat(message: str='', inputs: str='{}') -> str
~~~


Run the crm domain agent action `chat`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:2263`.

### `crm_classify_reply`

Namespace: `crm`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
crm_classify_reply(message: str='', inputs: str='{}') -> str
~~~


Run the crm domain agent action `classify_reply`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:2570`.

### `crm_competitive_positioning`

Namespace: `crm`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
crm_competitive_positioning(message: str='', inputs: str='{}') -> str
~~~


Run the crm domain agent action `competitive_positioning`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:2423`.

### `crm_customer_health_risk`

Namespace: `crm`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
crm_customer_health_risk(message: str='', account_id: Optional[str]=None, lookback_days: int=90) -> str
~~~


Score post-sale customer health and surface churn risks. Combines
product usage, support tickets, billing, and CRM activity into a
0-100 score with the top 3 risk drivers and recommended actions.
    Args:
        message: Free-text objective for the action.
        account_id (required): CRM account ID.
        lookback_days: Activity window for the score.

Source: `lightbulb/mcp_generated_tools.py:2445`.

### `crm_enrich_contact`

Namespace: `crm`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
crm_enrich_contact(message: str='', inputs: str='{}') -> str
~~~


Run the crm domain agent action `enrich_contact`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:2614`.

### `crm_enrich_leads`

Namespace: `crm`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
crm_enrich_leads(message: str='', inputs: str='{}') -> str
~~~


Run the crm domain agent action `enrich_leads`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:2636`.

### `crm_expansion_upsell`

Namespace: `crm`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
crm_expansion_upsell(message: str='', account_id: Optional[str]=None, min_arr_usd: Optional[float]=None) -> str
~~~


Identify expansion and upsell opportunities for an account based on
current product usage, peer benchmarks, and unmet jobs-to-be-done.
    Args:
        message: Free-text objective for the action.
        account_id (required): CRM account ID.
        min_arr_usd: Skip accounts below this ARR threshold.

Source: `lightbulb/mcp_generated_tools.py:2465`.

### `crm_icp_intelligence`

Namespace: `crm`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
crm_icp_intelligence(message: str='', inputs: str='{}') -> str
~~~


Run the crm domain agent action `icp_intelligence`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:2401`.

### `crm_lead_narrative_advance`

Namespace: `crm`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
crm_lead_narrative_advance(message: str='', inputs: str='{}') -> str
~~~


Run the crm domain agent action `lead_narrative_advance`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:2746`.

### `crm_lead_narrative_load`

Namespace: `crm`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
crm_lead_narrative_load(message: str='', inputs: str='{}') -> str
~~~


Run the crm domain agent action `lead_narrative_load`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:2724`.

### `crm_lead_qualification`

Namespace: `crm`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
crm_lead_qualification(message: str='', lead_id: Optional[str]=None, lead_email: Optional[str]=None, company_domain: Optional[str]=None) -> str
~~~


Qualify a lead against your ICP and grade it (A/B/C/D). Pulls firmographic
data, intent signals, and prior interactions; returns a fit score, the
reasoning, and a suggested next-best-action.
    Args:
        message: Free-text objective for the action.
        lead_id: CRM lead/contact ID.
        lead_email: Lead email (alternative to lead_id).
        company_domain: Company domain to enrich from.

Source: `lightbulb/mcp_generated_tools.py:2307`.

### `crm_objection_handling`

Namespace: `crm`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
crm_objection_handling(message: str='', inputs: str='{}') -> str
~~~


Run the crm domain agent action `objection_handling`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:2379`.

### `crm_outbound_messaging`

Namespace: `crm`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
crm_outbound_messaging(message: str='', contact_id: Optional[str]=None, channel: str='email', intent: Optional[str]=None, tone: Optional[str]=None) -> str
~~~


Draft a personalised outbound message to a prospect (cold email,
LinkedIn, follow-up, etc) tailored to your ICP, value props, and the
prospect's role and recent activity.
    Args:
        message: Free-text objective for the action.
        contact_id: CRM contact ID.
        channel: One of: email, linkedin, sms.
        intent: Goal of the message: intro, demo_book, follow_up, reactivation, expansion.
        tone: Tone hint: warm, direct, technical, executive.

Source: `lightbulb/mcp_generated_tools.py:2330`.

### `crm_plan_domain_intelligence`

Namespace: `crm`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
crm_plan_domain_intelligence(message: str='', inputs: str='{}') -> str
~~~


Run the crm domain agent action `plan_domain_intelligence`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:2768`.

### `crm_plan_sequence`

Namespace: `crm`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
crm_plan_sequence(message: str='', inputs: str='{}') -> str
~~~


Run the crm domain agent action `plan_sequence`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:2548`.

### `crm_propose_meeting_slots`

Namespace: `crm`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
crm_propose_meeting_slots(message: str='', inputs: str='{}') -> str
~~~


Run the crm domain agent action `propose_meeting_slots`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:2658`.

### `crm_query_data`

Namespace: `crm`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
crm_query_data(message: str='', inputs: str='{}') -> str
~~~


Run the crm domain agent action `query_data`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:2285`.

### `crm_sales_call_intelligence`

Namespace: `crm`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
crm_sales_call_intelligence(message: str='', call_id: Optional[str]=None, transcript_url: Optional[str]=None, framework: str='MEDDPICC') -> str
~~~


Analyse a sales call recording or transcript. Identifies stakeholders,
objections, commitments, MEDDPICC signals, and produces a recap email
draft plus next-step proposals.
    Args:
        message: Free-text objective for the action.
        call_id: Call ID from your dialer / recording platform.
        transcript_url: URL to the call transcript (alternative to call_id).
        framework: Sales framework: MEDDPICC, BANT, SPICED.

Source: `lightbulb/mcp_generated_tools.py:2356`.

### `crm_strategize_lead`

Namespace: `crm`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
crm_strategize_lead(message: str='', inputs: str='{}') -> str
~~~


Run the crm domain agent action `strategize_lead`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:2526`.

### `crm_verify_lead`

Namespace: `crm`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
crm_verify_lead(message: str='', inputs: str='{}') -> str
~~~


Run the crm domain agent action `verify_lead`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:2592`.

### `customer_success_billing_inquiry_status`

Namespace: `customer_success`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
customer_success_billing_inquiry_status(message: str='', inputs: str='{}') -> str
~~~


Run the customer_success domain agent action `billing_inquiry_status`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:2988`.

### `customer_success_billing_triage`

Namespace: `customer_success`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
customer_success_billing_triage(message: str='', inputs: str='{}') -> str
~~~


Run the customer_success domain agent action `billing_triage`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:2966`.

### `customer_success_chat`

Namespace: `customer_success`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
customer_success_chat(message: str='', inputs: str='{}') -> str
~~~


Run the customer_success domain agent action `chat`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:2790`.

### `customer_success_churn_risk_scan`

Namespace: `customer_success`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
customer_success_churn_risk_scan(message: str='', inputs: str='{}') -> str
~~~


Run the customer_success domain agent action `churn_risk_scan`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:2812`.

### `customer_success_cs_agentic_plan`

Namespace: `customer_success`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
customer_success_cs_agentic_plan(message: str='', inputs: str='{}') -> str
~~~


Run the customer_success domain agent action `cs_agentic_plan`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:2944`.

### `customer_success_expansion_playbook`

Namespace: `customer_success`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
customer_success_expansion_playbook(message: str='', inputs: str='{}') -> str
~~~


Run the customer_success domain agent action `expansion_playbook`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:2900`.

### `customer_success_finance_subscription_renewal_status`

Namespace: `customer_success`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
customer_success_finance_subscription_renewal_status(message: str='', inputs: str='{}') -> str
~~~


Run the customer_success domain agent action `finance_subscription_renewal_status`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:3032`.

### `customer_success_finance_subscription_renewal_sweep`

Namespace: `customer_success`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
customer_success_finance_subscription_renewal_sweep(message: str='', inputs: str='{}') -> str
~~~


Run the customer_success domain agent action `finance_subscription_renewal_sweep`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:3010`.

### `customer_success_health_score_report`

Namespace: `customer_success`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
customer_success_health_score_report(message: str='', inputs: str='{}') -> str
~~~


Run the customer_success domain agent action `health_score_report`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:2922`.

### `customer_success_nps_action_loop`

Namespace: `customer_success`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
customer_success_nps_action_loop(message: str='', inputs: str='{}') -> str
~~~


Run the customer_success domain agent action `nps_action_loop`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:2856`.

### `customer_success_onboarding_health`

Namespace: `customer_success`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
customer_success_onboarding_health(message: str='', inputs: str='{}') -> str
~~~


Run the customer_success domain agent action `onboarding_health`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:2878`.

### `customer_success_plan_domain_intelligence`

Namespace: `customer_success`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
customer_success_plan_domain_intelligence(message: str='', inputs: str='{}') -> str
~~~


Run the customer_success domain agent action `plan_domain_intelligence`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:3054`.

### `customer_success_renewal_pipeline`

Namespace: `customer_success`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
customer_success_renewal_pipeline(message: str='', inputs: str='{}') -> str
~~~


Run the customer_success domain agent action `renewal_pipeline`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:2834`.

### `deep_research_chat`

Namespace: `deep_research`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
deep_research_chat(message: str='', inputs: str='{}') -> str
~~~


Run the deep_research domain agent action `chat`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:3076`.

### `deep_research_plan_domain_intelligence`

Namespace: `deep_research`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
deep_research_plan_domain_intelligence(message: str='', inputs: str='{}') -> str
~~~


Run the deep_research domain agent action `plan_domain_intelligence`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:3142`.

### `deep_research_research_query`

Namespace: `deep_research`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
deep_research_research_query(message: str='', inputs: str='{}') -> str
~~~


Run the deep_research domain agent action `research_query`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:3120`.

### `deep_research_synthesize`

Namespace: `deep_research`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
deep_research_synthesize(message: str='', inputs: str='{}') -> str
~~~


Run the deep_research domain agent action `synthesize`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:3098`.

### `document_intelligence_chat`

Namespace: `document_intelligence`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
document_intelligence_chat(message: str='', inputs: str='{}') -> str
~~~


Run the document_intelligence domain agent action `chat`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:3164`.

### `document_intelligence_create_marketing_collateral`

Namespace: `document_intelligence`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
document_intelligence_create_marketing_collateral(message: str='', inputs: str='{}') -> str
~~~


Run the document_intelligence domain agent action `create_marketing_collateral`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:3340`.

### `document_intelligence_create_marketing_document`

Namespace: `document_intelligence`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
document_intelligence_create_marketing_document(message: str='', inputs: str='{}') -> str
~~~


Run the document_intelligence domain agent action `create_marketing_document`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:3318`.

### `document_intelligence_create_report`

Namespace: `document_intelligence`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
document_intelligence_create_report(message: str='', inputs: str='{}') -> str
~~~


Run the document_intelligence domain agent action `create_report`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:3296`.

### `document_intelligence_create_sales_collateral`

Namespace: `document_intelligence`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
document_intelligence_create_sales_collateral(message: str='', inputs: str='{}') -> str
~~~


Run the document_intelligence domain agent action `create_sales_collateral`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:3362`.

### `document_intelligence_create_slide_deck`

Namespace: `document_intelligence`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
document_intelligence_create_slide_deck(message: str='', inputs: str='{}') -> str
~~~


Run the document_intelligence domain agent action `create_slide_deck`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:3406`.

### `document_intelligence_create_spreadsheet`

Namespace: `document_intelligence`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
document_intelligence_create_spreadsheet(message: str='', inputs: str='{}') -> str
~~~


Run the document_intelligence domain agent action `create_spreadsheet`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:3384`.

### `document_intelligence_grep_content`

Namespace: `document_intelligence`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
document_intelligence_grep_content(message: str='', inputs: str='{}') -> str
~~~


Run the document_intelligence domain agent action `grep_content`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:3208`.

### `document_intelligence_list_folder`

Namespace: `document_intelligence`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
document_intelligence_list_folder(message: str='', inputs: str='{}') -> str
~~~


Run the document_intelligence domain agent action `list_folder`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:3230`.

### `document_intelligence_plan_domain_intelligence`

Namespace: `document_intelligence`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
document_intelligence_plan_domain_intelligence(message: str='', inputs: str='{}') -> str
~~~


Run the document_intelligence domain agent action `plan_domain_intelligence`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:3472`.

### `document_intelligence_publish_document`

Namespace: `document_intelligence`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
document_intelligence_publish_document(message: str='', inputs: str='{}') -> str
~~~


Run the document_intelligence domain agent action `publish_document`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:3450`.

### `document_intelligence_search_documents`

Namespace: `document_intelligence`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
document_intelligence_search_documents(message: str='', inputs: str='{}') -> str
~~~


Run the document_intelligence domain agent action `search_documents`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:3186`.

### `document_intelligence_search_folder`

Namespace: `document_intelligence`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
document_intelligence_search_folder(message: str='', inputs: str='{}') -> str
~~~


Run the document_intelligence domain agent action `search_folder`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:3252`.

### `document_intelligence_update_document`

Namespace: `document_intelligence`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
document_intelligence_update_document(message: str='', inputs: str='{}') -> str
~~~


Run the document_intelligence domain agent action `update_document`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:3428`.

### `document_intelligence_write_document`

Namespace: `document_intelligence`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
document_intelligence_write_document(message: str='', inputs: str='{}') -> str
~~~


Run the document_intelligence domain agent action `write_document`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:3274`.

### `engineering_chat`

Namespace: `engineering`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
engineering_chat(message: str='', inputs: str='{}') -> str
~~~


Run the engineering domain agent action `chat`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:3494`.

### `engineering_compare_model_versions`

Namespace: `engineering`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
engineering_compare_model_versions(message: str='', inputs: str='{}') -> str
~~~


Run the engineering domain agent action `compare_model_versions`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:3604`.

### `engineering_create_spec`

Namespace: `engineering`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
engineering_create_spec(message: str='', inputs: str='{}') -> str
~~~


Run the engineering domain agent action `create_spec`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:3516`.

### `engineering_design_loop`

Namespace: `engineering`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
engineering_design_loop(message: str='', inputs: str='{}') -> str
~~~


Run the engineering domain agent action `engineering_design_loop`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:3538`.

### `engineering_plan_domain_intelligence`

Namespace: `engineering`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
engineering_plan_domain_intelligence(message: str='', inputs: str='{}') -> str
~~~


Run the engineering domain agent action `plan_domain_intelligence`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:3670`.

### `engineering_query_analytics`

Namespace: `engineering`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
engineering_query_analytics(message: str='', inputs: str='{}') -> str
~~~


Run the engineering domain agent action `query_analytics`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:3648`.

### `engineering_run_clash_analysis`

Namespace: `engineering`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
engineering_run_clash_analysis(message: str='', inputs: str='{}') -> str
~~~


Run the engineering domain agent action `run_clash_analysis`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:3560`.

### `engineering_search_project_drawings`

Namespace: `engineering`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
engineering_search_project_drawings(message: str='', inputs: str='{}') -> str
~~~


Run the engineering domain agent action `search_project_drawings`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:3626`.

### `engineering_sensor_anomaly_detection`

Namespace: `engineering`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
engineering_sensor_anomaly_detection(message: str='', inputs: str='{}') -> str
~~~


Run the engineering domain agent action `sensor_anomaly_detection`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:3582`.

### `excel_add_worksheet`

Namespace: `excel`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
excel_add_worksheet(arguments: str='{}') -> str
~~~


Excel connector operation `add_worksheet` (platform tool `excel.add_worksheet`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:12150`.

### `excel_get_range`

Namespace: `excel`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
excel_get_range(arguments: str='{}') -> str
~~~


Excel connector operation `get_range` (platform tool `excel.get_range`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:12171`.

### `excel_list_worksheets`

Namespace: `excel`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
excel_list_worksheets(arguments: str='{}') -> str
~~~


Excel connector operation `list_worksheets` (platform tool `excel.list_worksheets`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:12192`.

### `excel_update_range`

Namespace: `excel`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
excel_update_range(arguments: str='{}') -> str
~~~


Excel connector operation `update_range` (platform tool `excel.update_range`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:12213`.

### `expensify_list_expenses`

Namespace: `expensify`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
expensify_list_expenses(arguments: str='{}') -> str
~~~


Expensify connector operation `list_expenses` (platform tool `expensify.list_expenses`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:12234`.

### `expensify_list_policies`

Namespace: `expensify`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
expensify_list_policies(arguments: str='{}') -> str
~~~


Expensify connector operation `list_policies` (platform tool `expensify.list_policies`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:12255`.

### `expensify_list_reports`

Namespace: `expensify`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
expensify_list_reports(arguments: str='{}') -> str
~~~


Expensify connector operation `list_reports` (platform tool `expensify.list_reports`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:12276`.

### `finance_aging`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_aging(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_aging`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:3893`.

### `finance_anomaly_fraud_case_file`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_anomaly_fraud_case_file(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_anomaly_fraud_case_file`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:4113`.

### `finance_anomaly_investigation`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_anomaly_investigation(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_anomaly_investigation`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:4644`.

### `finance_ap_invoice_intake`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_ap_invoice_intake(message: str='', invoice_url: Optional[str]=None, invoice_text: Optional[str]=None, expected_vendor: Optional[str]=None) -> str
~~~


Ingest an accounts-payable invoice (PDF, image, or email body) and
extract a structured payable: vendor, line items, totals, GL coding,
due date, payment terms, and any anomalies (duplicate, off-contract,
amount drift).
    Args:
        message: Free-text objective for the action.
        invoice_url: Signed URL or platform artifact URI for the invoice file.
        invoice_text: Raw invoice text (alternative to invoice_url).
        expected_vendor: Optional vendor name to validate against.

Source: `lightbulb/mcp_generated_tools.py:4531`.

### `finance_autocompany_finance_loop`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_autocompany_finance_loop(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `autocompany_finance_loop`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:4953`.

### `finance_automl_forecast`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_automl_forecast(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_automl_forecast`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:3915`.

### `finance_autonomous_finance_loop`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_autonomous_finance_loop(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `autonomous_finance_loop`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:4931`.

### `finance_board_dashboard_page`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_board_dashboard_page(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `board_dashboard_page`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:4179`.

### `finance_board_meeting_packet_generation`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_board_meeting_packet_generation(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `board_meeting_packet_generation`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:4201`.

### `finance_board_pack`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_board_pack(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_board_pack`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:4157`.

### `finance_board_pack_operating_loop`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_board_pack_operating_loop(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_board_pack_operating_loop`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:5617`.

### `finance_capital_allocation_analysis`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_capital_allocation_analysis(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `capital_allocation_analysis`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:4843`.

### `finance_capital_allocation_loop`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_capital_allocation_loop(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `capital_allocation_loop`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:4865`.

### `finance_capital_structure_cost_of_capital`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_capital_structure_cost_of_capital(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_capital_structure_cost_of_capital`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:4465`.

### `finance_chat`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_chat(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `chat`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:3692`.

### `finance_close_governance_loop`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_close_governance_loop(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_close_governance_loop`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:5595`.

### `finance_collections_priority`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_collections_priority(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `collections_priority`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:3871`.

### `finance_collections_to_crm_tasks`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_collections_to_crm_tasks(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_collections_to_crm_tasks`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:4267`.

### `finance_corporate_issuers_review`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_corporate_issuers_review(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_corporate_issuers_review`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:4755`.

### `finance_credit_risk_to_crm_health`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_credit_risk_to_crm_health(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_credit_risk_to_crm_health`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:4333`.

### `finance_data_room_collation_packet`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_data_room_collation_packet(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `data_room_collation_packet`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:5019`.

### `finance_dcf_lbo_spreadsheet`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_dcf_lbo_spreadsheet(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_dcf_lbo_spreadsheet`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:4069`.

### `finance_deep_research_due_diligence`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_deep_research_due_diligence(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_deep_research_due_diligence`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:3937`.

### `finance_domain_artifact_handoff`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_domain_artifact_handoff(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `domain_artifact_handoff`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:4245`.

### `finance_due_diligence`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_due_diligence(message: str='', target_company: Optional[str]=None, data_room_url: Optional[str]=None, focus_areas: Optional[list[str]]=None) -> str
~~~


Run a finance due-diligence pass across a target's financials,
uncovering quality-of-earnings adjustments, working-capital trends,
customer concentration, and red flags. Produces a banker-grade memo.
    Args:
        message: Free-text objective for the action.
        target_company (required): Target company name.
        data_room_url: VDR root URL (Datasite, Intralinks, Drive, etc).
        focus_areas: Optional list of areas to emphasise.

Source: `lightbulb/mcp_generated_tools.py:4688`.

### `finance_due_diligence_packet`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_due_diligence_packet(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_due_diligence_packet`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:4047`.

### `finance_dunning_outreach`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_dunning_outreach(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_dunning_outreach`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:4289`.

### `finance_equity_research_macro_synthesis`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_equity_research_macro_synthesis(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `equity_research_macro_synthesis`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:3959`.

### `finance_finops_attribution`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_finops_attribution(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_finops_attribution`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:4003`.

### `finance_forecast_interpretation`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_forecast_interpretation(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_forecast_interpretation`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:4600`.

### `finance_forecast_sensitivity`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_forecast_sensitivity(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_forecast_sensitivity`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:4487`.

### `finance_forecasting`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_forecasting(message: str='', horizon_months: int=12, scenario: Optional[str]=None, driver_overrides: Optional[dict]=None) -> str
~~~


Build a rolling cash and P&L forecast from your ledger data and
company drivers. Returns a month-by-month projection, scenario
comparisons, and a written interpretation of inflection points.
    Args:
        message: Free-text objective for the action.
        horizon_months: Forecast horizon (default 12 months).
        scenario: Scenario name: base, bull, bear, or a custom label.
        driver_overrides: Override drivers as JSON dict (e.g. {"revenue_growth": 0.15}).

Source: `lightbulb/mcp_generated_tools.py:4577`.

### `finance_fraud_investigation`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_fraud_investigation(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_fraud_investigation`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:4666`.

### `finance_fsa_review`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_fsa_review(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_fsa_review`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:4733`.

### `finance_fund_metrics`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_fund_metrics(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_fund_metrics`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:5419`.

### `finance_funding_program_intake`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_funding_program_intake(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `funding_program_intake`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:5041`.

### `finance_funding_readiness_assessment`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_funding_readiness_assessment(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `funding_readiness_assessment`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:4975`.

### `finance_funding_readiness_loop`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_funding_readiness_loop(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `funding_readiness_loop`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:4997`.

### `finance_goal_execute_wave`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_goal_execute_wave(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `goal_execute_wave`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:5217`.

### `finance_goal_full_lifecycle_loop`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_goal_full_lifecycle_loop(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `goal_full_lifecycle_loop`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:5283`.

### `finance_goal_plan`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_goal_plan(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `goal_plan`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:5195`.

### `finance_goal_record_task_result`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_goal_record_task_result(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `goal_record_task_result`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:5239`.

### `finance_goal_replan`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_goal_replan(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `goal_replan`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:5261`.

### `finance_goal_understand`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_goal_understand(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `goal_understand`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:5173`.

### `finance_grant_application_compile`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_grant_application_compile(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `grant_application_compile`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:5107`.

### `finance_grant_application_completion`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_grant_application_completion(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `grant_application_completion`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:5129`.

### `finance_grant_application_extraction`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_grant_application_extraction(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `grant_application_extraction`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:5085`.

### `finance_grant_full_lifecycle_loop`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_grant_full_lifecycle_loop(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `grant_full_lifecycle_loop`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:5151`.

### `finance_grant_program_discovery`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_grant_program_discovery(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `grant_program_discovery`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:5063`.

### `finance_growth_equity_valuation`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_growth_equity_valuation(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_growth_equity_valuation`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:5371`.

### `finance_human_capital_cloud_margin`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_human_capital_cloud_margin(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_human_capital_cloud_margin`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:5661`.

### `finance_ic_memo_doc`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_ic_memo_doc(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_ic_memo_doc`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:4025`.

### `finance_investment_committee_memo`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_investment_committee_memo(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_investment_committee_memo`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:5441`.

### `finance_lbo_model`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_lbo_model(message: str='', target_company: Optional[str]=None, entry_multiple: Optional[float]=None, leverage_ratio: Optional[float]=None, hold_period_years: int=5) -> str
~~~


Build a leveraged buyout model for a target company. Outputs sources
& uses, debt schedule, returns waterfall (IRR, MOIC), sensitivity
tables, and an investment-committee-ready summary memo.
    Args:
        message: Free-text objective for the action.
        target_company (required): Target company name or ticker.
        entry_multiple: Entry EV/EBITDA multiple.
        leverage_ratio: Net debt / EBITDA at close.
        hold_period_years: Investment hold period (default 5 years).

Source: `lightbulb/mcp_generated_tools.py:5393`.

### `finance_ledger_event_consumer`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_ledger_event_consumer(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_ledger_event_consumer`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:3981`.

### `finance_list_cross_domain_scenarios`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_list_cross_domain_scenarios(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `list_cross_domain_scenarios`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:5327`.

### `finance_ma_integration_forensic`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_ma_integration_forensic(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_ma_integration_forensic`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:5639`.

### `finance_mna_pro_forma`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_mna_pro_forma(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_mna_pro_forma`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:4777`.

### `finance_payroll`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_payroll(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_payroll`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:5529`.

### `finance_peer_valuation_multiples`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_peer_valuation_multiples(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_peer_valuation_multiples`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:4509`.

### `finance_plan_domain_intelligence`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_plan_domain_intelligence(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `plan_domain_intelligence`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:6012`.

### `finance_portfolio_monitoring`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_portfolio_monitoring(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_portfolio_monitoring`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:5463`.

### `finance_pricing_decomposition`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_pricing_decomposition(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_pricing_decomposition`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:4399`.

### `finance_private_company_valuation`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_private_company_valuation(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_private_company_valuation`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:4799`.

### `finance_product_finance_analysis`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_product_finance_analysis(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `product_finance_analysis`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:4909`.

### `finance_project_finance_analysis`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_project_finance_analysis(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `project_finance_analysis`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:4887`.

### `finance_project_valuation`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_project_valuation(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_project_valuation`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:4821`.

### `finance_qoe_workbook`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_qoe_workbook(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_qoe_workbook`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:4091`.

### `finance_qoe_working_capital`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_qoe_working_capital(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_qoe_working_capital`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:5349`.

### `finance_quarterly_ir_pack`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_quarterly_ir_pack(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_quarterly_ir_pack`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:4135`.

### `finance_query_data`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_query_data(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `query_data`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:3714`.

### `finance_ratio_dupont_analysis`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_ratio_dupont_analysis(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_ratio_dupont_analysis`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:4421`.

### `finance_reconciliation_exceptions`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_reconciliation_exceptions(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_reconciliation_exceptions`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:5990`.

### `finance_reconciliation_sweep`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_reconciliation_sweep(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_reconciliation_sweep`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:5968`.

### `finance_revenue_leakage`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_revenue_leakage(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_revenue_leakage`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:5485`.

### `finance_risk_monitoring`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_risk_monitoring(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_risk_monitoring`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:4622`.

### `finance_run_cross_domain_scenario`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_run_cross_domain_scenario(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `run_cross_domain_scenario`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:5305`.

### `finance_saas_board_pack`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_saas_board_pack(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_saas_board_pack`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:5902`.

### `finance_saas_metrics`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_saas_metrics(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_saas_metrics`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:5880`.

### `finance_spreadsheet_tie_out`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_spreadsheet_tie_out(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_spreadsheet_tie_out`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:4555`.

### `finance_statement_ingest`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_statement_ingest(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_statement_ingest`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:4711`.

### `finance_story_discovery`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_story_discovery(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_story_discovery`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:4377`.

### `finance_stripe_dunning_recovery`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_stripe_dunning_recovery(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_stripe_dunning_recovery`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:3827`.

### `finance_stripe_failed_payment_recovery`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_stripe_failed_payment_recovery(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_stripe_failed_payment_recovery`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:3805`.

### `finance_stripe_ledger_reconciliation`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_stripe_ledger_reconciliation(message: str='', month: Optional[str]=None, statement_url: Optional[str]=None, materiality_threshold_usd: Optional[float]=None) -> str
~~~


Reconcile Stripe payment activity against your accounting ledger.

Surfaces missing entries, amount mismatches, and timing variances
between Stripe payouts and your bookkeeping. Outputs a reconciliation
summary plus an itemised exceptions list.
    Args:
        message: Free-text objective for the action.
        month: Period to reconcile (YYYY-MM).
        statement_url: Optional bank/ledger statement URL to tie out against.
        materiality_threshold_usd: Skip differences smaller than this threshold.

Source: `lightbulb/mcp_generated_tools.py:3736`.

### `finance_stripe_orchestrator`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_stripe_orchestrator(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_stripe_orchestrator`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:3761`.

### `finance_stripe_revenue_audit`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_stripe_revenue_audit(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_stripe_revenue_audit`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:3783`.

### `finance_stripe_subscription_health`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_stripe_subscription_health(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_stripe_subscription_health`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:3849`.

### `finance_stripe_xero_writeback_fanout`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_stripe_xero_writeback_fanout(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `stripe_xero_writeback_fanout`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:4311`.

### `finance_subscription_health_to_expansion`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_subscription_health_to_expansion(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_subscription_health_to_expansion`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:4355`.

### `finance_subscription_renewal_status`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_subscription_renewal_status(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_subscription_renewal_status`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:5946`.

### `finance_subscription_renewal_sweep`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_subscription_renewal_sweep(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_subscription_renewal_sweep`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:5924`.

### `finance_tax_workflow`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_tax_workflow(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_tax_workflow`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:5551`.

### `finance_treasury_risk_loop`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_treasury_risk_loop(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_treasury_risk_loop`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:5573`.

### `finance_treasury_runway_dashboard`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_treasury_runway_dashboard(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `treasury_runway_dashboard`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:4223`.

### `finance_treasury_support`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_treasury_support(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_treasury_support`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:5507`.

### `finance_working_capital_efficiency`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_working_capital_efficiency(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_working_capital_efficiency`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:4443`.

### `finance_xero_ap_intake_to_pay`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_xero_ap_intake_to_pay(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `xero_ap_intake_to_pay`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:5748`.

### `finance_xero_ar_followup`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_xero_ar_followup(message: str='', aging_bucket: Optional[str]=None, min_amount_usd: Optional[float]=None, send: bool=False) -> str
~~~


Triage Xero accounts receivable and draft customer-facing follow-up
messages for overdue invoices. Tone, urgency, and channel are tuned
to the customer's payment history.
    Args:
        message: Free-text objective for the action.
        aging_bucket: One of: '1-30', '31-60', '61-90', '90+'. Empty = all overdue.
        min_amount_usd: Only follow up on invoices above this amount.
        send: If true, send messages directly; otherwise return drafts for review.

Source: `lightbulb/mcp_generated_tools.py:5725`.

### `finance_xero_bank_reconciliation`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_xero_bank_reconciliation(message: str='', account_id: Optional[str]=None, from_date: Optional[str]=None, to_date: Optional[str]=None) -> str
~~~


Reconcile Xero bank-feed transactions against the ledger. Auto-matches
where confidence is high; surfaces ambiguous matches for review.
    Args:
        message: Free-text objective for the action.
        account_id: Xero bank account ID; empty = all bank accounts.
        from_date: Start date (YYYY-MM-DD).
        to_date: End date (YYYY-MM-DD).

Source: `lightbulb/mcp_generated_tools.py:5770`.

### `finance_xero_close_books`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_xero_close_books(message: str='', period: Optional[str]=None, auto_post_threshold_usd: Optional[float]=None) -> str
~~~


Run a month-end close on the connected Xero org. Reviews unreconciled
transactions, accruals, prepayments, and intercompany eliminations,
then proposes adjusting journals for human approval.
    Args:
        message: Free-text objective for the action.
        period: Period to close (YYYY-MM); defaults to last month.
        auto_post_threshold_usd: Auto-post journals smaller than this; queue larger ones for approval.

Source: `lightbulb/mcp_generated_tools.py:5705`.

### `finance_xero_consolidation`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_xero_consolidation(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `xero_consolidation`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:5836`.

### `finance_xero_org_overview`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_xero_org_overview(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `xero_org_overview`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:5683`.

### `finance_xero_payroll_trueup`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_xero_payroll_trueup(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `xero_payroll_trueup`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:5792`.

### `finance_xero_reconciliation_review`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_xero_reconciliation_review(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `xero_reconciliation_review`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:5858`.

### `finance_xero_reporting_pack`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_xero_reporting_pack(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `xero_reporting_pack`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:5814`.

### `freshbooks_list_clients`

Namespace: `freshbooks`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
freshbooks_list_clients(arguments: str='{}') -> str
~~~


Freshbooks connector operation `list_clients` (platform tool `freshbooks.list_clients`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:12297`.

### `freshbooks_list_expenses`

Namespace: `freshbooks`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
freshbooks_list_expenses(arguments: str='{}') -> str
~~~


Freshbooks connector operation `list_expenses` (platform tool `freshbooks.list_expenses`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:12318`.

### `freshbooks_list_invoices`

Namespace: `freshbooks`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
freshbooks_list_invoices(arguments: str='{}') -> str
~~~


Freshbooks connector operation `list_invoices` (platform tool `freshbooks.list_invoices`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:12339`.

### `freshbooks_list_payments`

Namespace: `freshbooks`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
freshbooks_list_payments(arguments: str='{}') -> str
~~~


Freshbooks connector operation `list_payments` (platform tool `freshbooks.list_payments`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:12360`.

### `github_add_labels_to_issue`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_add_labels_to_issue(arguments: str='{}') -> str
~~~


Github connector operation `add_labels_to_issue` (platform tool `github.add_labels_to_issue`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:12381`.

### `github_auto_link_pr_to_jira`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_auto_link_pr_to_jira(arguments: str='{}') -> str
~~~


Github connector operation `auto_link_pr_to_jira` (platform tool `github.auto_link_pr_to_jira`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:12402`.

### `github_branch_prefix`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_branch_prefix(arguments: str='{}') -> str
~~~


Github connector operation `branch_prefix` (platform tool `github.branch_prefix`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:12423`.

### `github_cancel_workflow_run`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_cancel_workflow_run(arguments: str='{}') -> str
~~~


Github connector operation `cancel_workflow_run` (platform tool `github.cancel_workflow_run`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:12444`.

### `github_compare_commits`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_compare_commits(arguments: str='{}') -> str
~~~


Github connector operation `compare_commits` (platform tool `github.compare_commits`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:12465`.

### `github_create_branch_ref`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_create_branch_ref(arguments: str='{}') -> str
~~~


Github connector operation `create_branch_ref` (platform tool `github.create_branch_ref`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:12486`.

### `github_create_check_run`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_create_check_run(arguments: str='{}') -> str
~~~


Github connector operation `create_check_run` (platform tool `github.create_check_run`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:12507`.

### `github_create_deployment_status`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_create_deployment_status(arguments: str='{}') -> str
~~~


Github connector operation `create_deployment_status` (platform tool `github.create_deployment_status`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:12528`.

### `github_create_environment`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_create_environment(arguments: str='{}') -> str
~~~


Github connector operation `create_environment` (platform tool `github.create_environment`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:12549`.

### `github_create_issue`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_create_issue(repo: Optional[str]=None, title: Optional[str]=None, body: Optional[str]=None, labels: Optional[list[str]]=None, assignees: Optional[list[str]]=None) -> str
~~~


Create an issue in a repo.

Args:
    repo (required): owner/repo format.
    title (required): 
    body: Issue body markdown.
    labels: Labels to apply.
    assignees: Usernames to assign.

Source: `lightbulb/mcp_generated_tools.py:12570`.

### `github_create_issue_comment`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_create_issue_comment(arguments: str='{}') -> str
~~~


Github connector operation `create_issue_comment` (platform tool `github.create_issue_comment`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:12598`.

### `github_create_pull_request`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_create_pull_request(repo: Optional[str]=None, title: Optional[str]=None, head: Optional[str]=None, base: str='main', body: Optional[str]=None) -> str
~~~


Create a pull request from a head branch into a base branch.

Args:
    repo (required): owner/repo format.
    title (required): 
    head (required): Head branch name.
    base: Base branch (default main).
    body: PR body markdown.

Source: `lightbulb/mcp_generated_tools.py:12619`.

### `github_create_release`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_create_release(arguments: str='{}') -> str
~~~


Github connector operation `create_release` (platform tool `github.create_release`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:12647`.

### `github_create_repository`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_create_repository(arguments: str='{}') -> str
~~~


Github connector operation `create_repository` (platform tool `github.create_repository`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:12668`.

### `github_create_ruleset`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_create_ruleset(arguments: str='{}') -> str
~~~


Github connector operation `create_ruleset` (platform tool `github.create_ruleset`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:12689`.

### `github_default_org`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_default_org(arguments: str='{}') -> str
~~~


Github connector operation `default_org` (platform tool `github.default_org`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:12710`.

### `github_default_pr_base_branch`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_default_pr_base_branch(arguments: str='{}') -> str
~~~


Github connector operation `default_pr_base_branch` (platform tool `github.default_pr_base_branch`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:12731`.

### `github_default_repo`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_default_repo(arguments: str='{}') -> str
~~~


Github connector operation `default_repo` (platform tool `github.default_repo`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:12752`.

### `github_default_review_required_teams`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_default_review_required_teams(arguments: str='{}') -> str
~~~


Github connector operation `default_review_required_teams` (platform tool `github.default_review_required_teams`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:12773`.

### `github_delete_branch_ref`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_delete_branch_ref(arguments: str='{}') -> str
~~~


Github connector operation `delete_branch_ref` (platform tool `github.delete_branch_ref`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:12794`.

### `github_dismiss_review`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_dismiss_review(arguments: str='{}') -> str
~~~


Github connector operation `dismiss_review` (platform tool `github.dismiss_review`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:12815`.

### `github_dispatch_workflow`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_dispatch_workflow(arguments: str='{}') -> str
~~~


Github connector operation `dispatch_workflow` (platform tool `github.dispatch_workflow`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:12836`.

### `github_get_branch`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_get_branch(arguments: str='{}') -> str
~~~


Github connector operation `get_branch` (platform tool `github.get_branch`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:12857`.

### `github_get_branch_protection`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_get_branch_protection(arguments: str='{}') -> str
~~~


Github connector operation `get_branch_protection` (platform tool `github.get_branch_protection`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:12878`.

### `github_get_issue`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_get_issue(arguments: str='{}') -> str
~~~


Github connector operation `get_issue` (platform tool `github.get_issue`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:12899`.

### `github_get_pull_request`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_get_pull_request(arguments: str='{}') -> str
~~~


Github connector operation `get_pull_request` (platform tool `github.get_pull_request`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:12920`.

### `github_get_workflow_run`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_get_workflow_run(arguments: str='{}') -> str
~~~


Github connector operation `get_workflow_run` (platform tool `github.get_workflow_run`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:12941`.

### `github_get_workflow_run_logs`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_get_workflow_run_logs(arguments: str='{}') -> str
~~~


Github connector operation `get_workflow_run_logs` (platform tool `github.get_workflow_run_logs`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:12962`.

### `github_list_branches`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_list_branches(arguments: str='{}') -> str
~~~


Github connector operation `list_branches` (platform tool `github.list_branches`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:12983`.

### `github_list_check_runs`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_list_check_runs(arguments: str='{}') -> str
~~~


Github connector operation `list_check_runs` (platform tool `github.list_check_runs`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:13004`.

### `github_list_check_suites`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_list_check_suites(arguments: str='{}') -> str
~~~


Github connector operation `list_check_suites` (platform tool `github.list_check_suites`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:13025`.

### `github_list_code_scanning_alerts`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_list_code_scanning_alerts(arguments: str='{}') -> str
~~~


Github connector operation `list_code_scanning_alerts` (platform tool `github.list_code_scanning_alerts`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:13046`.

### `github_list_commits`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_list_commits(arguments: str='{}') -> str
~~~


Github connector operation `list_commits` (platform tool `github.list_commits`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:13067`.

### `github_list_dependabot_alerts`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_list_dependabot_alerts(arguments: str='{}') -> str
~~~


Github connector operation `list_dependabot_alerts` (platform tool `github.list_dependabot_alerts`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:13088`.

### `github_list_deployments`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_list_deployments(arguments: str='{}') -> str
~~~


Github connector operation `list_deployments` (platform tool `github.list_deployments`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:13109`.

### `github_list_environments`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_list_environments(arguments: str='{}') -> str
~~~


Github connector operation `list_environments` (platform tool `github.list_environments`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:13130`.

### `github_list_issues`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_list_issues(repo: Optional[str]=None, state: str='open', labels: Optional[list[str]]=None) -> str
~~~


List issues for a repo.

Args:
    repo (required): owner/repo format.
    state: One of: open, closed, all.
    labels: Filter to issues with all of these labels.

Source: `lightbulb/mcp_generated_tools.py:13151`.

### `github_list_pull_request_files`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_list_pull_request_files(arguments: str='{}') -> str
~~~


Github connector operation `list_pull_request_files` (platform tool `github.list_pull_request_files`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:13173`.

### `github_list_pull_request_review_comments`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_list_pull_request_review_comments(arguments: str='{}') -> str
~~~


Github connector operation `list_pull_request_review_comments` (platform tool `github.list_pull_request_review_comments`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:13194`.

### `github_list_pull_requests`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_list_pull_requests(repo: Optional[str]=None, state: str='open', author: Optional[str]=None) -> str
~~~


List pull requests for a repo.

Args:
    repo (required): owner/repo format.
    state: One of: open, closed, all.
    author: Filter to PRs by this username.

Source: `lightbulb/mcp_generated_tools.py:13215`.

### `github_list_releases`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_list_releases(arguments: str='{}') -> str
~~~


Github connector operation `list_releases` (platform tool `github.list_releases`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:13237`.

### `github_list_reviews`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_list_reviews(arguments: str='{}') -> str
~~~


Github connector operation `list_reviews` (platform tool `github.list_reviews`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:13258`.

### `github_list_rulesets`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_list_rulesets(arguments: str='{}') -> str
~~~


Github connector operation `list_rulesets` (platform tool `github.list_rulesets`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:13279`.

### `github_list_secret_scanning_alerts`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_list_secret_scanning_alerts(arguments: str='{}') -> str
~~~


Github connector operation `list_secret_scanning_alerts` (platform tool `github.list_secret_scanning_alerts`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:13300`.

### `github_list_workflow_jobs`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_list_workflow_jobs(arguments: str='{}') -> str
~~~


Github connector operation `list_workflow_jobs` (platform tool `github.list_workflow_jobs`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:13321`.

### `github_list_workflow_runs`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_list_workflow_runs(arguments: str='{}') -> str
~~~


Github connector operation `list_workflow_runs` (platform tool `github.list_workflow_runs`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:13342`.

### `github_merge_pull_request`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_merge_pull_request(arguments: str='{}') -> str
~~~


Github connector operation `merge_pull_request` (platform tool `github.merge_pull_request`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:13363`.

### `github_remove_label_from_issue`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_remove_label_from_issue(arguments: str='{}') -> str
~~~


Github connector operation `remove_label_from_issue` (platform tool `github.remove_label_from_issue`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:13384`.

### `github_remove_requested_reviewers`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_remove_requested_reviewers(arguments: str='{}') -> str
~~~


Github connector operation `remove_requested_reviewers` (platform tool `github.remove_requested_reviewers`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:13405`.

### `github_request_reviewers`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_request_reviewers(arguments: str='{}') -> str
~~~


Github connector operation `request_reviewers` (platform tool `github.request_reviewers`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:13426`.

### `github_rerun_workflow_run`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_rerun_workflow_run(arguments: str='{}') -> str
~~~


Github connector operation `rerun_workflow_run` (platform tool `github.rerun_workflow_run`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:13447`.

### `github_submit_review`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_submit_review(arguments: str='{}') -> str
~~~


Github connector operation `submit_review` (platform tool `github.submit_review`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:13468`.

### `github_trigger_workflow`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_trigger_workflow(arguments: str='{}') -> str
~~~


Github connector operation `trigger_workflow` (platform tool `github.trigger_workflow`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:13489`.

### `github_update_branch_protection`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_update_branch_protection(arguments: str='{}') -> str
~~~


Github connector operation `update_branch_protection` (platform tool `github.update_branch_protection`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:13510`.

### `github_update_check_run`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_update_check_run(arguments: str='{}') -> str
~~~


Github connector operation `update_check_run` (platform tool `github.update_check_run`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:13531`.

### `github_update_issue`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_update_issue(arguments: str='{}') -> str
~~~


Github connector operation `update_issue` (platform tool `github.update_issue`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:13552`.

### `github_update_pull_request`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_update_pull_request(arguments: str='{}') -> str
~~~


Github connector operation `update_pull_request` (platform tool `github.update_pull_request`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:13573`.

### `github_update_release`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_update_release(arguments: str='{}') -> str
~~~


Github connector operation `update_release` (platform tool `github.update_release`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:13594`.

### `gmail_get_email`

Namespace: `gmail`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
gmail_get_email(message_id: Optional[str]=None, format: str='full') -> str
~~~


Fetch a single Gmail message by ID, including headers and body.

Args:
    message_id (required): Gmail message ID.
    format: One of: minimal, full, raw, metadata.

Source: `lightbulb/mcp_generated_tools.py:13615`.

### `gmail_list_emails`

Namespace: `gmail`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
gmail_list_emails(query: Optional[str]=None, max_results: int=20, label_ids: Optional[list[str]]=None) -> str
~~~


List / search Gmail messages in the connected mailbox.

Args:
    query: Gmail search query (e.g. 'from:alice has:attachment newer_than:7d').
    max_results: 
    label_ids: Filter to messages with these labels (e.g. ['INBOX']).

Source: `lightbulb/mcp_generated_tools.py:13634`.

### `gmail_modify`

Namespace: `gmail`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
gmail_modify(arguments: str='{}') -> str
~~~


Gmail connector operation `modify` (platform tool `gmail.modify`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:13656`.

### `gmail_send_email`

Namespace: `gmail`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
gmail_send_email(to: Optional[str]=None, subject: Optional[str]=None, body: Optional[str]=None, cc: Optional[str]=None, html: bool=False) -> str
~~~


Send an email from the connected Gmail account.

Args:
    to (required): Recipient address(es), comma-separated.
    subject (required): 
    body (required): Plain-text or HTML body.
    cc: CC address(es), comma-separated.
    html: If true, body is treated as HTML.

Source: `lightbulb/mcp_generated_tools.py:13677`.

### `grc_audit_trail_export`

Namespace: `grc`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
grc_audit_trail_export(message: str='', inputs: str='{}') -> str
~~~


Run the grc domain agent action `audit_trail_export`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:6188`.

### `grc_chat`

Namespace: `grc`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
grc_chat(message: str='', inputs: str='{}') -> str
~~~


Run the grc domain agent action `chat`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:6034`.

### `grc_compliance_audit`

Namespace: `grc`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
grc_compliance_audit(message: str='', inputs: str='{}') -> str
~~~


Run the grc domain agent action `compliance_audit`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:6078`.

### `grc_control_testing`

Namespace: `grc`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
grc_control_testing(message: str='', inputs: str='{}') -> str
~~~


Run the grc domain agent action `control_testing`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:6144`.

### `grc_pci_audit_package`

Namespace: `grc`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
grc_pci_audit_package(message: str='', inputs: str='{}') -> str
~~~


Run the grc domain agent action `pci_audit_package`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:6232`.

### `grc_plan_domain_intelligence`

Namespace: `grc`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
grc_plan_domain_intelligence(message: str='', inputs: str='{}') -> str
~~~


Run the grc domain agent action `plan_domain_intelligence`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:6320`.

### `grc_policy_gap_analysis`

Namespace: `grc`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
grc_policy_gap_analysis(message: str='', inputs: str='{}') -> str
~~~


Run the grc domain agent action `policy_gap_analysis`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:6100`.

### `grc_regulatory_monitoring`

Namespace: `grc`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
grc_regulatory_monitoring(message: str='', inputs: str='{}') -> str
~~~


Run the grc domain agent action `regulatory_monitoring`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:6122`.

### `grc_risk_register_scan`

Namespace: `grc`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
grc_risk_register_scan(message: str='', inputs: str='{}') -> str
~~~


Run the grc domain agent action `risk_register_scan`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:6056`.

### `grc_risk_score_report`

Namespace: `grc`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
grc_risk_score_report(message: str='', inputs: str='{}') -> str
~~~


Run the grc domain agent action `risk_score_report`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:6166`.

### `grc_sox_audit_package`

Namespace: `grc`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
grc_sox_audit_package(message: str='', inputs: str='{}') -> str
~~~


Run the grc domain agent action `sox_audit_package`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:6210`.

### `grc_tax_compliance_report`

Namespace: `grc`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
grc_tax_compliance_report(message: str='', inputs: str='{}') -> str
~~~


Run the grc domain agent action `tax_compliance_report`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:6276`.

### `grc_tax_deadline_alerts`

Namespace: `grc`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
grc_tax_deadline_alerts(message: str='', inputs: str='{}') -> str
~~~


Run the grc domain agent action `tax_deadline_alerts`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:6298`.

### `grc_tax_obligation_scan`

Namespace: `grc`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
grc_tax_obligation_scan(message: str='', inputs: str='{}') -> str
~~~


Run the grc domain agent action `tax_obligation_scan`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:6254`.

### `greenhouse_advance_application`

Namespace: `greenhouse`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
greenhouse_advance_application(arguments: str='{}') -> str
~~~


Greenhouse connector operation `advance_application` (platform tool `greenhouse.advance_application`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:13705`.

### `greenhouse_default_department_id`

Namespace: `greenhouse`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
greenhouse_default_department_id(arguments: str='{}') -> str
~~~


Greenhouse connector operation `default_department_id` (platform tool `greenhouse.default_department_id`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:13726`.

### `greenhouse_default_office_id`

Namespace: `greenhouse`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
greenhouse_default_office_id(arguments: str='{}') -> str
~~~


Greenhouse connector operation `default_office_id` (platform tool `greenhouse.default_office_id`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:13747`.

### `greenhouse_reject_application`

Namespace: `greenhouse`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
greenhouse_reject_application(arguments: str='{}') -> str
~~~


Greenhouse connector operation `reject_application` (platform tool `greenhouse.reject_application`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:13768`.

### `gtm_chat`

Namespace: `gtm`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
gtm_chat(message: str='', inputs: str='{}') -> str
~~~


Run the gtm domain agent action `chat`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:6342`.

### `gtm_competitive_launch_response`

Namespace: `gtm`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
gtm_competitive_launch_response(message: str='', inputs: str='{}') -> str
~~~


Run the gtm domain agent action `competitive_launch_response`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:6474`.

### `gtm_enablement_kit`

Namespace: `gtm`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
gtm_enablement_kit(message: str='', inputs: str='{}') -> str
~~~


Run the gtm domain agent action `enablement_kit`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:6430`.

### `gtm_go_to_market_plan`

Namespace: `gtm`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
gtm_go_to_market_plan(message: str='', inputs: str='{}') -> str
~~~


Run the gtm domain agent action `go_to_market_plan`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:6386`.

### `gtm_intelligence_share`

Namespace: `gtm`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
gtm_intelligence_share(message: str='', inputs: str='{}') -> str
~~~


Run the gtm domain agent action `gtm_intelligence_share`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:6496`.

### `gtm_launch_coordination`

Namespace: `gtm`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
gtm_launch_coordination(message: str='', inputs: str='{}') -> str
~~~


Run the gtm domain agent action `launch_coordination`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:6364`.

### `gtm_launch_readiness`

Namespace: `gtm`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
gtm_launch_readiness(message: str='', inputs: str='{}') -> str
~~~


Run the gtm domain agent action `launch_readiness`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:6408`.

### `gtm_market_entry_analysis`

Namespace: `gtm`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
gtm_market_entry_analysis(message: str='', inputs: str='{}') -> str
~~~


Run the gtm domain agent action `market_entry_analysis`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:6452`.

### `gtm_plan_domain_intelligence`

Namespace: `gtm`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
gtm_plan_domain_intelligence(message: str='', inputs: str='{}') -> str
~~~


Run the gtm domain agent action `plan_domain_intelligence`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:6518`.

### `hr_cases_pulse_loop`

Namespace: `hr`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
hr_cases_pulse_loop(message: str='', inputs: str='{}') -> str
~~~


Run the hr domain agent action `hr_cases_pulse_loop`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:6782`.

### `hr_chat`

Namespace: `hr`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
hr_chat(message: str='', inputs: str='{}') -> str
~~~


Run the hr domain agent action `chat`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:6540`.

### `hr_compliance_check`

Namespace: `hr`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
hr_compliance_check(message: str='', inputs: str='{}') -> str
~~~


Run the hr domain agent action `compliance_check`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:6672`.

### `hr_employee_hire_onboarding_loop`

Namespace: `hr`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
hr_employee_hire_onboarding_loop(message: str='', inputs: str='{}') -> str
~~~


Run the hr domain agent action `employee_hire_onboarding_loop`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:6716`.

### `hr_employee_offboarding_loop`

Namespace: `hr`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
hr_employee_offboarding_loop(message: str='', inputs: str='{}') -> str
~~~


Run the hr domain agent action `employee_offboarding_loop`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:6738`.

### `hr_headcount`

Namespace: `hr`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
hr_headcount(message: str='', as_of_date: Optional[str]=None, group_by: str='team') -> str
~~~


Produce a current-headcount report: active employees by team, role, and
location; flags pending starts and recent departures.
    Args:
        message: Free-text objective for the action.
        as_of_date: Snapshot date (YYYY-MM-DD); defaults to today.
        group_by: One of: team, role, location, manager.

Source: `lightbulb/mcp_generated_tools.py:6653`.

### `hr_leave_planning_loop`

Namespace: `hr`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
hr_leave_planning_loop(message: str='', inputs: str='{}') -> str
~~~


Run the hr domain agent action `leave_planning_loop`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:6804`.

### `hr_leave_request`

Namespace: `hr`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
hr_leave_request(message: str='', inputs: str='{}') -> str
~~~


Run the hr domain agent action `leave_request`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:6584`.

### `hr_lookup`

Namespace: `hr`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
hr_lookup(message: str='', inputs: str='{}') -> str
~~~


Run the hr domain agent action `lookup`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:6562`.

### `hr_offboard`

Namespace: `hr`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
hr_offboard(message: str='', employee_id: Optional[str]=None, last_day: Optional[str]=None, voluntary: bool=True) -> str
~~~


Run employee offboarding: revoke access, transfer ownership, schedule
exit interviews, calculate final pay, archive records.
    Args:
        message: Free-text objective for the action.
        employee_id (required): Employee ID.
        last_day (required): Final day of employment (YYYY-MM-DD).
        voluntary: Voluntary departure (vs termination).

Source: `lightbulb/mcp_generated_tools.py:6631`.

### `hr_onboard`

Namespace: `hr`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
hr_onboard(message: str='', employee_name: Optional[str]=None, role_title: Optional[str]=None, start_date: Optional[str]=None, manager_email: Optional[str]=None) -> str
~~~


Run new-hire onboarding end-to-end: provision accounts, assign equipment,
schedule day-1 meetings, send welcome packet, file employment paperwork.
    Args:
        message: Free-text objective for the action.
        employee_name (required): New hire full name.
        role_title (required): Role title.
        start_date (required): Start date (YYYY-MM-DD).
        manager_email: Reporting manager email.

Source: `lightbulb/mcp_generated_tools.py:6606`.

### `hr_plan_domain_intelligence`

Namespace: `hr`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
hr_plan_domain_intelligence(message: str='', inputs: str='{}') -> str
~~~


Run the hr domain agent action `plan_domain_intelligence`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:6826`.

### `hr_pulse`

Namespace: `hr`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
hr_pulse(message: str='', inputs: str='{}') -> str
~~~


Run the hr domain agent action `hr_pulse`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:6694`.

### `hr_recruiting_pipeline_loop`

Namespace: `hr`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
hr_recruiting_pipeline_loop(message: str='', inputs: str='{}') -> str
~~~


Run the hr domain agent action `recruiting_pipeline_loop`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:6760`.

### `intuit_cash_application_plan`

Namespace: `intuit`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
intuit_cash_application_plan(message: str='', inputs: str='{}') -> str
~~~


Run the intuit domain agent action `cash_application_plan`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:6914`.

### `intuit_close_packet`

Namespace: `intuit`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
intuit_close_packet(message: str='', inputs: str='{}') -> str
~~~


Run the intuit domain agent action `close_packet`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:6936`.

### `intuit_controller_action`

Namespace: `intuit`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
intuit_controller_action(arguments: str='{}') -> str
~~~


Intuit connector operation `controller_action` (platform tool `intuit.controller_action`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:13789`.

### `intuit_controller_review`

Namespace: `intuit`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
intuit_controller_review(message: str='', inputs: str='{}') -> str
~~~


Run the intuit domain agent action `controller_review`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:6870`.

### `intuit_controller_snapshot`

Namespace: `intuit`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
intuit_controller_snapshot(message: str='', inputs: str='{}') -> str
~~~


Run the intuit domain agent action `controller_snapshot`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:6848`.

### `intuit_execute_approved_action`

Namespace: `intuit`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
intuit_execute_approved_action(message: str='', inputs: str='{}') -> str
~~~


Run the intuit domain agent action `execute_approved_action`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:6980`.

### `intuit_health_check`

Namespace: `intuit`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
intuit_health_check(message: str='', inputs: str='{}') -> str
~~~


Run the intuit domain agent action `health_check`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:7002`.

### `intuit_plan_domain_intelligence`

Namespace: `intuit`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
intuit_plan_domain_intelligence(message: str='', inputs: str='{}') -> str
~~~


Run the intuit domain agent action `plan_domain_intelligence`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:7024`.

### `intuit_reconcile_payments`

Namespace: `intuit`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
intuit_reconcile_payments(message: str='', inputs: str='{}') -> str
~~~


Run the intuit domain agent action `reconcile_payments`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:6892`.

### `intuit_writeback_plan`

Namespace: `intuit`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
intuit_writeback_plan(message: str='', inputs: str='{}') -> str
~~~


Run the intuit domain agent action `writeback_plan`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:6958`.

### `it_ops_analysis_review`

Namespace: `it_ops`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
it_ops_analysis_review(message: str='', inputs: str='{}') -> str
~~~


Run the it_ops domain agent action `analysis_review`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:7816`.

### `it_ops_analyze_cost`

Namespace: `it_ops`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
it_ops_analyze_cost(message: str='', inputs: str='{}') -> str
~~~


Run the it_ops domain agent action `analyze_cost`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:7266`.

### `it_ops_autocompany_software_engineering_loop`

Namespace: `it_ops`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
it_ops_autocompany_software_engineering_loop(message: str='', inputs: str='{}') -> str
~~~


Run the it_ops domain agent action `autocompany_software_engineering_loop`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:7530`.

### `it_ops_autonomous_delivery_loop`

Namespace: `it_ops`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
it_ops_autonomous_delivery_loop(message: str='', inputs: str='{}') -> str
~~~


Run the it_ops domain agent action `autonomous_delivery_loop`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:7464`.

### `it_ops_autonomous_it_consultancy`

Namespace: `it_ops`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
it_ops_autonomous_it_consultancy(message: str='', inputs: str='{}') -> str
~~~


Run the it_ops domain agent action `autonomous_it_consultancy`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:7486`.

### `it_ops_aws_account_control`

Namespace: `it_ops`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
it_ops_aws_account_control(message: str='', inputs: str='{}') -> str
~~~


Run the it_ops domain agent action `aws_account_control`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:7200`.

### `it_ops_aws_cli`

Namespace: `it_ops`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
it_ops_aws_cli(message: str='', inputs: str='{}') -> str
~~~


Run the it_ops domain agent action `aws_cli`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:7178`.

### `it_ops_aws_cli_execute`

Namespace: `it_ops`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
it_ops_aws_cli_execute(message: str='', inputs: str='{}') -> str
~~~


Run the it_ops domain agent action `aws_cli_execute`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:7222`.

### `it_ops_chat`

Namespace: `it_ops`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
it_ops_chat(message: str='', inputs: str='{}') -> str
~~~


Run the it_ops domain agent action `chat`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:7046`.

### `it_ops_cloud_delivery_setup`

Namespace: `it_ops`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
it_ops_cloud_delivery_setup(message: str='', inputs: str='{}') -> str
~~~


Run the it_ops domain agent action `cloud_delivery_setup`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:7574`.

### `it_ops_cloud_ops`

Namespace: `it_ops`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
it_ops_cloud_ops(message: str='', inputs: str='{}') -> str
~~~


Run the it_ops domain agent action `cloud_ops`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:7156`.

### `it_ops_deployment`

Namespace: `it_ops`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
it_ops_deployment(message: str='', inputs: str='{}') -> str
~~~


Run the it_ops domain agent action `deployment`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:7420`.

### `it_ops_design_review`

Namespace: `it_ops`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
it_ops_design_review(message: str='', inputs: str='{}') -> str
~~~


Run the it_ops domain agent action `design_review`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:7838`.

### `it_ops_detect_waste`

Namespace: `it_ops`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
it_ops_detect_waste(message: str='', inputs: str='{}') -> str
~~~


Run the it_ops domain agent action `detect_waste`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:7288`.

### `it_ops_development_kickoff`

Namespace: `it_ops`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
it_ops_development_kickoff(message: str='', inputs: str='{}') -> str
~~~


Run the it_ops domain agent action `development_kickoff`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:7860`.

### `it_ops_domain_artifact_handoff`

Namespace: `it_ops`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
it_ops_domain_artifact_handoff(message: str='', inputs: str='{}') -> str
~~~


Run the it_ops domain agent action `domain_artifact_handoff`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:7552`.

### `it_ops_feedback_to_code_loop`

Namespace: `it_ops`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
it_ops_feedback_to_code_loop(message: str='', inputs: str='{}') -> str
~~~


Run the it_ops domain agent action `feedback_to_code_loop`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:7662`.

### `it_ops_feedback_to_sdlc`

Namespace: `it_ops`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
it_ops_feedback_to_sdlc(message: str='', inputs: str='{}') -> str
~~~


Run the it_ops domain agent action `feedback_to_sdlc`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:7640`.

### `it_ops_generate_iac`

Namespace: `it_ops`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
it_ops_generate_iac(message: str='', inputs: str='{}') -> str
~~~


Run the it_ops domain agent action `generate_iac`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:7354`.

### `it_ops_github_repository_search`

Namespace: `it_ops`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
it_ops_github_repository_search(message: str='', inputs: str='{}') -> str
~~~


Run the it_ops domain agent action `github_repository_search`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:7068`.

### `it_ops_incident_response`

Namespace: `it_ops`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
it_ops_incident_response(message: str='', inputs: str='{}') -> str
~~~


Run the it_ops domain agent action `incident_response`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:7112`.

### `it_ops_inventory_cloud`

Namespace: `it_ops`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
it_ops_inventory_cloud(message: str='', inputs: str='{}') -> str
~~~


Run the it_ops domain agent action `inventory_cloud`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:7244`.

### `it_ops_maintenance_cycle`

Namespace: `it_ops`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
it_ops_maintenance_cycle(message: str='', inputs: str='{}') -> str
~~~


Run the it_ops domain agent action `maintenance_cycle`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:7904`.

### `it_ops_monitoring_check`

Namespace: `it_ops`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
it_ops_monitoring_check(message: str='', inputs: str='{}') -> str
~~~


Run the it_ops domain agent action `monitoring_check`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:7926`.

### `it_ops_open_iac_pr`

Namespace: `it_ops`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
it_ops_open_iac_pr(message: str='', inputs: str='{}') -> str
~~~


Run the it_ops domain agent action `open_iac_pr`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:7398`.

### `it_ops_plan_domain_intelligence`

Namespace: `it_ops`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
it_ops_plan_domain_intelligence(message: str='', inputs: str='{}') -> str
~~~


Run the it_ops domain agent action `plan_domain_intelligence`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:7970`.

### `it_ops_plan_iac`

Namespace: `it_ops`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
it_ops_plan_iac(message: str='', inputs: str='{}') -> str
~~~


Run the it_ops domain agent action `plan_iac`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:7376`.

### `it_ops_plan_iteration`

Namespace: `it_ops`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
it_ops_plan_iteration(message: str='', inputs: str='{}') -> str
~~~


Run the it_ops domain agent action `plan_iteration`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:7794`.

### `it_ops_product_requirements_intake`

Namespace: `it_ops`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
it_ops_product_requirements_intake(message: str='', inputs: str='{}') -> str
~~~


Run the it_ops domain agent action `product_requirements_intake`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:7596`.

### `it_ops_project_ops`

Namespace: `it_ops`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
it_ops_project_ops(message: str='', inputs: str='{}') -> str
~~~


Run the it_ops domain agent action `project_ops`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:7090`.

### `it_ops_qa`

Namespace: `it_ops`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
it_ops_qa(message: str='', inputs: str='{}') -> str
~~~


Run the it_ops domain agent action `qa`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:7442`.

### `it_ops_recommend_architecture`

Namespace: `it_ops`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
it_ops_recommend_architecture(message: str='', inputs: str='{}') -> str
~~~


Run the it_ops domain agent action `recommend_architecture`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:7332`.

### `it_ops_requirements_capture`

Namespace: `it_ops`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
it_ops_requirements_capture(message: str='', inputs: str='{}') -> str
~~~


Run the it_ops domain agent action `requirements_capture`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:7772`.

### `it_ops_rightsizing_recommendations`

Namespace: `it_ops`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
it_ops_rightsizing_recommendations(message: str='', inputs: str='{}') -> str
~~~


Run the it_ops domain agent action `rightsizing_recommendations`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:7310`.

### `it_ops_sdlc_engagement_status`

Namespace: `it_ops`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
it_ops_sdlc_engagement_status(message: str='', inputs: str='{}') -> str
~~~


Run the it_ops domain agent action `sdlc_engagement_status`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:7948`.

### `it_ops_service_desk`

Namespace: `it_ops`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
it_ops_service_desk(message: str='', inputs: str='{}') -> str
~~~


Run the it_ops domain agent action `service_desk`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:7134`.

### `it_ops_software_engineering_loop`

Namespace: `it_ops`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
it_ops_software_engineering_loop(message: str='', inputs: str='{}') -> str
~~~


Run the it_ops domain agent action `software_engineering_loop`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:7508`.

### `it_ops_software_feedback_intake`

Namespace: `it_ops`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
it_ops_software_feedback_intake(message: str='', inputs: str='{}') -> str
~~~


Run the it_ops domain agent action `software_feedback_intake`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:7618`.

### `it_ops_testing_review`

Namespace: `it_ops`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
it_ops_testing_review(message: str='', inputs: str='{}') -> str
~~~


Run the it_ops domain agent action `testing_review`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:7882`.

### `it_ops_triage_growth_loop_to_sdlc`

Namespace: `it_ops`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
it_ops_triage_growth_loop_to_sdlc(message: str='', inputs: str='{}') -> str
~~~


Run the it_ops domain agent action `triage_growth_loop_to_sdlc`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:7750`.

### `it_ops_triage_sdlc_intake`

Namespace: `it_ops`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
it_ops_triage_sdlc_intake(message: str='', inputs: str='{}') -> str
~~~


Run the it_ops domain agent action `triage_sdlc_intake`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:7706`.

### `it_ops_website_growth_loop_to_sdlc`

Namespace: `it_ops`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
it_ops_website_growth_loop_to_sdlc(message: str='', inputs: str='{}') -> str
~~~


Run the it_ops domain agent action `website_growth_loop_to_sdlc`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:7728`.

### `it_ops_website_sdlc_intake`

Namespace: `it_ops`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
it_ops_website_sdlc_intake(message: str='', inputs: str='{}') -> str
~~~


Run the it_ops domain agent action `website_sdlc_intake`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:7684`.

### `jira_add_attachment`

Namespace: `jira`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
jira_add_attachment(arguments: str='{}') -> str
~~~


Jira connector operation `add_attachment` (platform tool `jira.add_attachment`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:13810`.

### `jira_add_comment`

Namespace: `jira`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
jira_add_comment(arguments: str='{}') -> str
~~~


Jira connector operation `add_comment` (platform tool `jira.add_comment`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:13831`.

### `jira_add_to_sprint`

Namespace: `jira`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
jira_add_to_sprint(arguments: str='{}') -> str
~~~


Jira connector operation `add_to_sprint` (platform tool `jira.add_to_sprint`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:13852`.

### `jira_assign_issue`

Namespace: `jira`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
jira_assign_issue(arguments: str='{}') -> str
~~~


Jira connector operation `assign_issue` (platform tool `jira.assign_issue`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:13873`.

### `jira_bulk_transition`

Namespace: `jira`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
jira_bulk_transition(arguments: str='{}') -> str
~~~


Jira connector operation `bulk_transition` (platform tool `jira.bulk_transition`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:13894`.

### `jira_close_sprint`

Namespace: `jira`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
jira_close_sprint(arguments: str='{}') -> str
~~~


Jira connector operation `close_sprint` (platform tool `jira.close_sprint`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:13915`.

### `jira_create_automation_rule`

Namespace: `jira`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
jira_create_automation_rule(arguments: str='{}') -> str
~~~


Jira connector operation `create_automation_rule` (platform tool `jira.create_automation_rule`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:13936`.

### `jira_create_issue`

Namespace: `jira`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
jira_create_issue(project_key: Optional[str]=None, summary: Optional[str]=None, issue_type: str='Task', description: Optional[str]=None, assignee: Optional[str]=None) -> str
~~~


Create a Jira issue in a project.

Args:
    project_key (required): Project key (e.g. 'ENG').
    summary (required): 
    issue_type: One of the project's configured issue types.
    description: 
    assignee: Username or accountId.

Source: `lightbulb/mcp_generated_tools.py:13957`.

### `jira_create_sprint`

Namespace: `jira`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
jira_create_sprint(arguments: str='{}') -> str
~~~


Jira connector operation `create_sprint` (platform tool `jira.create_sprint`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:13985`.

### `jira_create_subtask`

Namespace: `jira`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
jira_create_subtask(arguments: str='{}') -> str
~~~


Jira connector operation `create_subtask` (platform tool `jira.create_subtask`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:14006`.

### `jira_default_board_id`

Namespace: `jira`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
jira_default_board_id(arguments: str='{}') -> str
~~~


Jira connector operation `default_board_id` (platform tool `jira.default_board_id`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:14027`.

### `jira_default_project_key`

Namespace: `jira`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
jira_default_project_key(arguments: str='{}') -> str
~~~


Jira connector operation `default_project_key` (platform tool `jira.default_project_key`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:14048`.

### `jira_delete_automation_rule`

Namespace: `jira`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
jira_delete_automation_rule(arguments: str='{}') -> str
~~~


Jira connector operation `delete_automation_rule` (platform tool `jira.delete_automation_rule`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:14069`.

### `jira_delete_issue`

Namespace: `jira`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
jira_delete_issue(arguments: str='{}') -> str
~~~


Jira connector operation `delete_issue` (platform tool `jira.delete_issue`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:14090`.

### `jira_delete_webhook`

Namespace: `jira`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
jira_delete_webhook(arguments: str='{}') -> str
~~~


Jira connector operation `delete_webhook` (platform tool `jira.delete_webhook`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:14111`.

### `jira_get_board_sprints`

Namespace: `jira`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
jira_get_board_sprints(arguments: str='{}') -> str
~~~


Jira connector operation `get_board_sprints` (platform tool `jira.get_board_sprints`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:14132`.

### `jira_get_issue`

Namespace: `jira`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
jira_get_issue(arguments: str='{}') -> str
~~~


Jira connector operation `get_issue` (platform tool `jira.get_issue`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:14153`.

### `jira_get_project`

Namespace: `jira`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
jira_get_project(arguments: str='{}') -> str
~~~


Jira connector operation `get_project` (platform tool `jira.get_project`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:14174`.

### `jira_get_sprint_issues`

Namespace: `jira`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
jira_get_sprint_issues(arguments: str='{}') -> str
~~~


Jira connector operation `get_sprint_issues` (platform tool `jira.get_sprint_issues`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:14195`.

### `jira_link_issues`

Namespace: `jira`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
jira_link_issues(arguments: str='{}') -> str
~~~


Jira connector operation `link_issues` (platform tool `jira.link_issues`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:14216`.

### `jira_list_automation_rules`

Namespace: `jira`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
jira_list_automation_rules(arguments: str='{}') -> str
~~~


Jira connector operation `list_automation_rules` (platform tool `jira.list_automation_rules`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:14237`.

### `jira_list_issue_types`

Namespace: `jira`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
jira_list_issue_types(arguments: str='{}') -> str
~~~


Jira connector operation `list_issue_types` (platform tool `jira.list_issue_types`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:14258`.

### `jira_list_projects`

Namespace: `jira`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
jira_list_projects(arguments: str='{}') -> str
~~~


Jira connector operation `list_projects` (platform tool `jira.list_projects`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:14279`.

### `jira_list_transitions`

Namespace: `jira`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
jira_list_transitions(arguments: str='{}') -> str
~~~


Jira connector operation `list_transitions` (platform tool `jira.list_transitions`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:14300`.

### `jira_list_users`

Namespace: `jira`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
jira_list_users(arguments: str='{}') -> str
~~~


Jira connector operation `list_users` (platform tool `jira.list_users`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:14321`.

### `jira_list_webhooks`

Namespace: `jira`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
jira_list_webhooks(arguments: str='{}') -> str
~~~


Jira connector operation `list_webhooks` (platform tool `jira.list_webhooks`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:14342`.

### `jira_log_work`

Namespace: `jira`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
jira_log_work(arguments: str='{}') -> str
~~~


Jira connector operation `log_work` (platform tool `jira.log_work`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:14363`.

### `jira_rank_backlog`

Namespace: `jira`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
jira_rank_backlog(arguments: str='{}') -> str
~~~


Jira connector operation `rank_backlog` (platform tool `jira.rank_backlog`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:14384`.

### `jira_search_issues`

Namespace: `jira`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
jira_search_issues(jql: Optional[str]=None, max_results: int=50) -> str
~~~


Search Jira issues with JQL.

Args:
    jql (required): JQL query (e.g. 'project = ENG AND status = "In Progress"').
    max_results:

Source: `lightbulb/mcp_generated_tools.py:14405`.

### `jira_start_sprint`

Namespace: `jira`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
jira_start_sprint(arguments: str='{}') -> str
~~~


Jira connector operation `start_sprint` (platform tool `jira.start_sprint`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:14424`.

### `jira_subscribe_webhook`

Namespace: `jira`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
jira_subscribe_webhook(arguments: str='{}') -> str
~~~


Jira connector operation `subscribe_webhook` (platform tool `jira.subscribe_webhook`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:14445`.

### `jira_transition_issue`

Namespace: `jira`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
jira_transition_issue(arguments: str='{}') -> str
~~~


Jira connector operation `transition_issue` (platform tool `jira.transition_issue`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:14466`.

### `jira_update_custom_fields`

Namespace: `jira`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
jira_update_custom_fields(arguments: str='{}') -> str
~~~


Jira connector operation `update_custom_fields` (platform tool `jira.update_custom_fields`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:14487`.

### `jira_update_issue`

Namespace: `jira`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
jira_update_issue(arguments: str='{}') -> str
~~~


Jira connector operation `update_issue` (platform tool `jira.update_issue`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:14508`.

### `legal_breach_response`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_breach_response(message: str='', inputs: str='{}') -> str
~~~


Run the legal domain agent action `breach_response`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:8413`.

### `legal_cert_upload`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_cert_upload(message: str='', inputs: str='{}') -> str
~~~


Run the legal domain agent action `cert_upload`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:8831`.

### `legal_compliance_monitoring`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_compliance_monitoring(message: str='', jurisdictions: Optional[list[str]]=None, topics: Optional[list[str]]=None, since: Optional[str]=None) -> str
~~~


Monitor regulatory and compliance changes relevant to the firm/client
and produce a digest of new obligations, deadlines, and action items.
    Args:
        message: Free-text objective for the action.
        jurisdictions: Jurisdictions to monitor.
        topics: Topic filters (e.g. 'privacy', 'AML', 'employment').
        since: Lookback start date (YYYY-MM-DD).

Source: `lightbulb/mcp_generated_tools.py:8038`.

### `legal_compliance_scan_loop`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_compliance_scan_loop(message: str='', inputs: str='{}') -> str
~~~


Run the legal domain agent action `compliance_scan_loop`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:8963`.

### `legal_content_compliance_review_loop`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_content_compliance_review_loop(message: str='', inputs: str='{}') -> str
~~~


Run the legal domain agent action `content_compliance_review_loop`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:9029`.

### `legal_contract_review`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_contract_review(message: str='', contract_url: Optional[str]=None, playbook: Optional[str]=None, counterparty_name: Optional[str]=None) -> str
~~~


Review a contract and produce a redline-ready memo: deviations from
your playbook, missing clauses, risk-flagged terms, and proposed
edits with rationale.
    Args:
        message: Free-text objective for the action.
        contract_url (required): URL or platform artifact URI for the contract.
        playbook: Playbook label: 'enterprise_sales', 'partnership', 'employment', 'nda'.
        counterparty_name: Counterparty name for the memo.

Source: `lightbulb/mcp_generated_tools.py:8015`.

### `legal_cookie_audit`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_cookie_audit(message: str='', inputs: str='{}') -> str
~~~


Run the legal domain agent action `cookie_audit`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:8457`.

### `legal_document_drafting`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_document_drafting(message: str='', document_type: Optional[str]=None, brief: Optional[str]=None, counterparty: Optional[str]=None) -> str
~~~


Draft a legal document (NDA, MSA, side letter, employment agreement,
policy) from a brief plus your firm's templates and house style.
    Args:
        message: Free-text objective for the action.
        document_type (required): Document type label.
        brief (required): Plain-English brief of what the document needs to cover.
        counterparty: Counterparty name.

Source: `lightbulb/mcp_generated_tools.py:8060`.

### `legal_dpa_review`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_dpa_review(message: str='', inputs: str='{}') -> str
~~~


Run the legal domain agent action `dpa_review`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:8391`.

### `legal_dpia`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_dpia(message: str='', inputs: str='{}') -> str
~~~


Run the legal domain agent action `dpia`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:8435`.

### `legal_dsar_fulfill`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_dsar_fulfill(message: str='', inputs: str='{}') -> str
~~~


Run the legal domain agent action `dsar_fulfill`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:8369`.

### `legal_dsar_intake`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_dsar_intake(message: str='', inputs: str='{}') -> str
~~~


Run the legal domain agent action `dsar_intake`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:8347`.

### `legal_ediscovery`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_ediscovery(message: str='', inputs: str='{}') -> str
~~~


Run the legal domain agent action `ediscovery`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:8325`.

### `legal_employment_agreement_packet`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_employment_agreement_packet(message: str='', inputs: str='{}') -> str
~~~


Run the legal domain agent action `employment_agreement_packet`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:8215`.

### `legal_enterprise_customer_onboarding_loop`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_enterprise_customer_onboarding_loop(message: str='', inputs: str='{}') -> str
~~~


Run the legal domain agent action `enterprise_customer_onboarding_loop`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:8897`.

### `legal_horizon_digest`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_horizon_digest(message: str='', inputs: str='{}') -> str
~~~


Run the legal domain agent action `horizon_digest`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:8633`.

### `legal_horizon_scan`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_horizon_scan(message: str='', inputs: str='{}') -> str
~~~


Run the legal domain agent action `horizon_scan`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:8589`.

### `legal_horizon_subscribe`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_horizon_subscribe(message: str='', inputs: str='{}') -> str
~~~


Run the legal domain agent action `horizon_subscribe`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:8611`.

### `legal_hr_onboarding_packet`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_hr_onboarding_packet(message: str='', inputs: str='{}') -> str
~~~


Run the legal domain agent action `hr_onboarding_packet`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:8193`.

### `legal_incorporation_legal_setup_loop`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_incorporation_legal_setup_loop(message: str='', inputs: str='{}') -> str
~~~


Run the legal domain agent action `incorporation_legal_setup_loop`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:9117`.

### `legal_incorporation_readiness`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_incorporation_readiness(message: str='', inputs: str='{}') -> str
~~~


Run the legal domain agent action `incorporation_readiness`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:8171`.

### `legal_ip_deadline_check`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_ip_deadline_check(message: str='', inputs: str='{}') -> str
~~~


Run the legal domain agent action `ip_deadline_check`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:8677`.

### `legal_ip_docket_sync`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_ip_docket_sync(message: str='', inputs: str='{}') -> str
~~~


Run the legal domain agent action `ip_docket_sync`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:8655`.

### `legal_ip_protection_loop`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_ip_protection_loop(message: str='', inputs: str='{}') -> str
~~~


Run the legal domain agent action `ip_protection_loop`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:9073`.

### `legal_knowledge_assistant`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_knowledge_assistant(message: str='', inputs: str='{}') -> str
~~~


Run the legal domain agent action `knowledge_assistant`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:8303`.

### `legal_law_firm_growth_loop`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_law_firm_growth_loop(message: str='', inputs: str='{}') -> str
~~~


Run the legal domain agent action `law_firm_growth_loop`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:8875`.

### `legal_litigation_hold_issue`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_litigation_hold_issue(message: str='', inputs: str='{}') -> str
~~~


Run the legal domain agent action `litigation_hold_issue`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:8479`.

### `legal_litigation_hold_loop`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_litigation_hold_loop(message: str='', inputs: str='{}') -> str
~~~


Run the legal domain agent action `litigation_hold_loop`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:9051`.

### `legal_litigation_hold_refresh`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_litigation_hold_refresh(message: str='', inputs: str='{}') -> str
~~~


Run the legal domain agent action `litigation_hold_refresh`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:8501`.

### `legal_litigation_hold_release`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_litigation_hold_release(message: str='', inputs: str='{}') -> str
~~~


Run the legal domain agent action `litigation_hold_release`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:8523`.

### `legal_matter_intake`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_matter_intake(message: str='', client_message: Optional[str]=None, attachments: Optional[list[str]]=None, jurisdiction: Optional[str]=None) -> str
~~~


Run a new-matter intake from a client message or file. Classifies
matter type, conflicts-checks, drafts the engagement letter scope,
and proposes a fee structure.
    Args:
        message: Free-text objective for the action.
        client_message: Initial client message or summary.
        attachments: URLs of supporting documents.
        jurisdiction: Governing jurisdiction (e.g. 'NSW' or 'Delaware').

Source: `lightbulb/mcp_generated_tools.py:7992`.

### `legal_nda_packet`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_nda_packet(message: str='', variant: str='mutual', counterparty: Optional[str]=None, term_months: int=24) -> str
~~~


Generate a complete NDA packet (mutual or unilateral): NDA itself,
side letter if needed, intake form, and an executive summary for
the requesting party.
    Args:
        message: Free-text objective for the action.
        variant: One of: mutual, unilateral, employee_confidentiality.
        counterparty (required): Counterparty name.
        term_months: Confidentiality term length.

Source: `lightbulb/mcp_generated_tools.py:8148`.

### `legal_partnership_agreement_packet`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_partnership_agreement_packet(message: str='', inputs: str='{}') -> str
~~~


Run the legal domain agent action `partnership_agreement_packet`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:8104`.

### `legal_partnership_onboarding_loop`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_partnership_onboarding_loop(message: str='', inputs: str='{}') -> str
~~~


Run the legal domain agent action `partnership_onboarding_loop`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:8941`.

### `legal_plan_domain_intelligence`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_plan_domain_intelligence(message: str='', inputs: str='{}') -> str
~~~


Run the legal domain agent action `plan_domain_intelligence`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:9205`.

### `legal_privacy_incident_response_loop`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_privacy_incident_response_loop(message: str='', inputs: str='{}') -> str
~~~


Run the legal domain agent action `privacy_incident_response_loop`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:8985`.

### `legal_privilege_log_generate`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_privilege_log_generate(message: str='', inputs: str='{}') -> str
~~~


Run the legal domain agent action `privilege_log_generate`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:8567`.

### `legal_regulatory_horizon_to_policy_loop`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_regulatory_horizon_to_policy_loop(message: str='', inputs: str='{}') -> str
~~~


Run the legal domain agent action `regulatory_horizon_to_policy_loop`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:9007`.

### `legal_risk_contract_protection_loop`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_risk_contract_protection_loop(message: str='', inputs: str='{}') -> str
~~~


Run the legal domain agent action `risk_contract_protection_loop`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:9095`.

### `legal_sales_agreement_packet`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_sales_agreement_packet(message: str='', inputs: str='{}') -> str
~~~


Run the legal domain agent action `sales_agreement_packet`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:8082`.

### `legal_service_agreement_packet`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_service_agreement_packet(message: str='', inputs: str='{}') -> str
~~~


Run the legal domain agent action `service_agreement_packet`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:8126`.

### `legal_smokeball_account_sync`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_smokeball_account_sync(message: str='', inputs: str='{}') -> str
~~~


Run the legal domain agent action `smokeball_account_sync`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:8259`.

### `legal_smokeball_matter_operations`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_smokeball_matter_operations(message: str='', inputs: str='{}') -> str
~~~


Run the legal domain agent action `smokeball_matter_operations`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:8281`.

### `legal_smokeball_orchestration`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_smokeball_orchestration(message: str='', inputs: str='{}') -> str
~~~


Run the legal domain agent action `smokeball_orchestration`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:8237`.

### `legal_subpoena_route`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_subpoena_route(message: str='', inputs: str='{}') -> str
~~~


Run the legal domain agent action `subpoena_route`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:8545`.

### `legal_tax_compliance_report`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_tax_compliance_report(message: str='', inputs: str='{}') -> str
~~~


Run the legal domain agent action `tax_compliance_report`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:9161`.

### `legal_tax_deadline_alerts`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_tax_deadline_alerts(message: str='', inputs: str='{}') -> str
~~~


Run the legal domain agent action `tax_deadline_alerts`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:9183`.

### `legal_tax_obligation_scan`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_tax_obligation_scan(message: str='', inputs: str='{}') -> str
~~~


Run the legal domain agent action `tax_obligation_scan`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:9139`.

### `legal_tm_clearance_search`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_tm_clearance_search(message: str='', inputs: str='{}') -> str
~~~


Run the legal domain agent action `tm_clearance_search`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:8699`.

### `legal_tm_opposition_draft`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_tm_opposition_draft(message: str='', inputs: str='{}') -> str
~~~


Run the legal domain agent action `tm_opposition_draft`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:8721`.

### `legal_trade_secret_register`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_trade_secret_register(message: str='', inputs: str='{}') -> str
~~~


Run the legal domain agent action `trade_secret_register`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:8743`.

### `legal_vendor_onboard`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_vendor_onboard(message: str='', inputs: str='{}') -> str
~~~


Run the legal domain agent action `vendor_onboard`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:8765`.

### `legal_vendor_onboarding_legal_loop`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_vendor_onboarding_legal_loop(message: str='', inputs: str='{}') -> str
~~~


Run the legal domain agent action `vendor_onboarding_legal_loop`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:8919`.

### `legal_vendor_renew`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_vendor_renew(message: str='', inputs: str='{}') -> str
~~~


Run the legal domain agent action `vendor_renew`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:8809`.

### `legal_vendor_risk_score`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_vendor_risk_score(message: str='', inputs: str='{}') -> str
~~~


Run the legal domain agent action `vendor_risk_score`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:8853`.

### `legal_vendor_screen`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_vendor_screen(message: str='', inputs: str='{}') -> str
~~~


Run the legal domain agent action `vendor_screen`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:8787`.

### `microsoft_download_file`

Namespace: `microsoft`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
microsoft_download_file(arguments: str='{}') -> str
~~~


Microsoft connector operation `download_file` (platform tool `microsoft.download_file`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:14529`.

### `microsoft_list_channel_messages`

Namespace: `microsoft`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
microsoft_list_channel_messages(arguments: str='{}') -> str
~~~


Microsoft connector operation `list_channel_messages` (platform tool `microsoft.list_channel_messages`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:14550`.

### `microsoft_list_chat_messages`

Namespace: `microsoft`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
microsoft_list_chat_messages(arguments: str='{}') -> str
~~~


Microsoft connector operation `list_chat_messages` (platform tool `microsoft.list_chat_messages`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:14571`.

### `microsoft_list_chats`

Namespace: `microsoft`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
microsoft_list_chats(arguments: str='{}') -> str
~~~


Microsoft connector operation `list_chats` (platform tool `microsoft.list_chats`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:14592`.

### `microsoft_list_drive_files`

Namespace: `microsoft`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
microsoft_list_drive_files(arguments: str='{}') -> str
~~~


Microsoft connector operation `list_drive_files` (platform tool `microsoft.list_drive_files`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:14613`.

### `microsoft_list_emails`

Namespace: `microsoft`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
microsoft_list_emails(folder: str='Inbox', top: int=25, filter: Optional[str]=None) -> str
~~~


List Outlook messages in the connected Microsoft 365 mailbox.

Args:
    folder: Mailbox folder name.
    top: Max messages to return.
    filter: OData filter expression.

Source: `lightbulb/mcp_generated_tools.py:14634`.

### `microsoft_list_events`

Namespace: `microsoft`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
microsoft_list_events(start: Optional[str]=None, end: Optional[str]=None, top: int=50) -> str
~~~


List Outlook calendar events on the connected Microsoft 365 calendar.

Args:
    start: Window start (ISO 8601).
    end: Window end (ISO 8601).
    top:

Source: `lightbulb/mcp_generated_tools.py:14656`.

### `microsoft_list_sharepoint_drive_items`

Namespace: `microsoft`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
microsoft_list_sharepoint_drive_items(arguments: str='{}') -> str
~~~


Microsoft connector operation `list_sharepoint_drive_items` (platform tool `microsoft.list_sharepoint_drive_items`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:14678`.

### `microsoft_list_sharepoint_drives`

Namespace: `microsoft`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
microsoft_list_sharepoint_drives(arguments: str='{}') -> str
~~~


Microsoft connector operation `list_sharepoint_drives` (platform tool `microsoft.list_sharepoint_drives`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:14699`.

### `microsoft_list_sharepoint_sites`

Namespace: `microsoft`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
microsoft_list_sharepoint_sites(arguments: str='{}') -> str
~~~


Microsoft connector operation `list_sharepoint_sites` (platform tool `microsoft.list_sharepoint_sites`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:14720`.

### `microsoft_list_team_channels`

Namespace: `microsoft`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
microsoft_list_team_channels(arguments: str='{}') -> str
~~~


Microsoft connector operation `list_team_channels` (platform tool `microsoft.list_team_channels`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:14741`.

### `microsoft_list_teams`

Namespace: `microsoft`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
microsoft_list_teams(arguments: str='{}') -> str
~~~


Microsoft connector operation `list_teams` (platform tool `microsoft.list_teams`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:14762`.

### `microsoft_post_channel_message`

Namespace: `microsoft`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
microsoft_post_channel_message(arguments: str='{}') -> str
~~~


Microsoft connector operation `post_channel_message` (platform tool `microsoft.post_channel_message`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:14783`.

### `microsoft_post_chat_message`

Namespace: `microsoft`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
microsoft_post_chat_message(arguments: str='{}') -> str
~~~


Microsoft connector operation `post_chat_message` (platform tool `microsoft.post_chat_message`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:14804`.

### `microsoft_send_email`

Namespace: `microsoft`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
microsoft_send_email(to: Optional[str]=None, subject: Optional[str]=None, body: Optional[str]=None, cc: Optional[str]=None) -> str
~~~


Send an email from the connected Microsoft 365 mailbox.

Args:
    to (required): Recipient address(es), comma-separated.
    subject (required): 
    body (required): HTML body.
    cc: CC address(es), comma-separated.

Source: `lightbulb/mcp_generated_tools.py:14825`.

### `microsoft_update_file`

Namespace: `microsoft`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
microsoft_update_file(arguments: str='{}') -> str
~~~


Microsoft connector operation `update_file` (platform tool `microsoft.update_file`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:14850`.

### `microsoft_upload_file`

Namespace: `microsoft`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
microsoft_upload_file(arguments: str='{}') -> str
~~~


Microsoft connector operation `upload_file` (platform tool `microsoft.upload_file`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:14871`.

### `monday_archive_board`

Namespace: `monday`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
monday_archive_board(arguments: str='{}') -> str
~~~


Monday connector operation `archive_board` (platform tool `monday.archive_board`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:14892`.

### `monday_archive_item`

Namespace: `monday`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
monday_archive_item(arguments: str='{}') -> str
~~~


Monday connector operation `archive_item` (platform tool `monday.archive_item`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:14913`.

### `monday_change_column_value`

Namespace: `monday`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
monday_change_column_value(arguments: str='{}') -> str
~~~


Monday connector operation `change_column_value` (platform tool `monday.change_column_value`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:14934`.

### `monday_create_board`

Namespace: `monday`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
monday_create_board(arguments: str='{}') -> str
~~~


Monday connector operation `create_board` (platform tool `monday.create_board`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:14955`.

### `monday_create_group`

Namespace: `monday`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
monday_create_group(arguments: str='{}') -> str
~~~


Monday connector operation `create_group` (platform tool `monday.create_group`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:14976`.

### `monday_create_item`

Namespace: `monday`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
monday_create_item(arguments: str='{}') -> str
~~~


Monday connector operation `create_item` (platform tool `monday.create_item`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:14997`.

### `monday_create_subitem`

Namespace: `monday`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
monday_create_subitem(arguments: str='{}') -> str
~~~


Monday connector operation `create_subitem` (platform tool `monday.create_subitem`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:15018`.

### `monday_create_update`

Namespace: `monday`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
monday_create_update(arguments: str='{}') -> str
~~~


Monday connector operation `create_update` (platform tool `monday.create_update`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:15039`.

### `monday_create_webhook`

Namespace: `monday`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
monday_create_webhook(arguments: str='{}') -> str
~~~


Monday connector operation `create_webhook` (platform tool `monday.create_webhook`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:15060`.

### `monday_delete_item`

Namespace: `monday`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
monday_delete_item(arguments: str='{}') -> str
~~~


Monday connector operation `delete_item` (platform tool `monday.delete_item`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:15081`.

### `monday_delete_webhook`

Namespace: `monday`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
monday_delete_webhook(arguments: str='{}') -> str
~~~


Monday connector operation `delete_webhook` (platform tool `monday.delete_webhook`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:15102`.

### `monday_duplicate_board`

Namespace: `monday`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
monday_duplicate_board(arguments: str='{}') -> str
~~~


Monday connector operation `duplicate_board` (platform tool `monday.duplicate_board`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:15123`.

### `monday_get_board`

Namespace: `monday`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
monday_get_board(arguments: str='{}') -> str
~~~


Monday connector operation `get_board` (platform tool `monday.get_board`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:15144`.

### `monday_get_item`

Namespace: `monday`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
monday_get_item(arguments: str='{}') -> str
~~~


Monday connector operation `get_item` (platform tool `monday.get_item`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:15165`.

### `monday_get_me`

Namespace: `monday`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
monday_get_me(arguments: str='{}') -> str
~~~


Monday connector operation `get_me` (platform tool `monday.get_me`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:15186`.

### `monday_hr_cases_board_id`

Namespace: `monday`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
monday_hr_cases_board_id(arguments: str='{}') -> str
~~~


Monday connector operation `hr_cases_board_id` (platform tool `monday.hr_cases_board_id`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:15207`.

### `monday_list_boards`

Namespace: `monday`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
monday_list_boards(arguments: str='{}') -> str
~~~


Monday connector operation `list_boards` (platform tool `monday.list_boards`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:15228`.

### `monday_list_docs`

Namespace: `monday`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
monday_list_docs(arguments: str='{}') -> str
~~~


Monday connector operation `list_docs` (platform tool `monday.list_docs`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:15249`.

### `monday_list_items`

Namespace: `monday`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
monday_list_items(arguments: str='{}') -> str
~~~


Monday connector operation `list_items` (platform tool `monday.list_items`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:15270`.

### `monday_list_subitems`

Namespace: `monday`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
monday_list_subitems(arguments: str='{}') -> str
~~~


Monday connector operation `list_subitems` (platform tool `monday.list_subitems`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:15291`.

### `monday_list_teams`

Namespace: `monday`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
monday_list_teams(arguments: str='{}') -> str
~~~


Monday connector operation `list_teams` (platform tool `monday.list_teams`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:15312`.

### `monday_list_updates`

Namespace: `monday`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
monday_list_updates(arguments: str='{}') -> str
~~~


Monday connector operation `list_updates` (platform tool `monday.list_updates`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:15333`.

### `monday_list_users`

Namespace: `monday`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
monday_list_users(arguments: str='{}') -> str
~~~


Monday connector operation `list_users` (platform tool `monday.list_users`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:15354`.

### `monday_list_workspaces`

Namespace: `monday`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
monday_list_workspaces(arguments: str='{}') -> str
~~~


Monday connector operation `list_workspaces` (platform tool `monday.list_workspaces`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:15375`.

### `monday_move_item_to_group`

Namespace: `monday`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
monday_move_item_to_group(arguments: str='{}') -> str
~~~


Monday connector operation `move_item_to_group` (platform tool `monday.move_item_to_group`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:15396`.

### `monday_offboarding_template_board_id`

Namespace: `monday`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
monday_offboarding_template_board_id(arguments: str='{}') -> str
~~~


Monday connector operation `offboarding_template_board_id` (platform tool `monday.offboarding_template_board_id`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:15417`.

### `monday_onboarding_template_board_id`

Namespace: `monday`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
monday_onboarding_template_board_id(arguments: str='{}') -> str
~~~


Monday connector operation `onboarding_template_board_id` (platform tool `monday.onboarding_template_board_id`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:15438`.

### `monday_query_data`

Namespace: `monday`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
monday_query_data(arguments: str='{}') -> str
~~~


Monday connector operation `query_data` (platform tool `monday.query_data`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:15459`.

### `monday_search_items`

Namespace: `monday`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
monday_search_items(arguments: str='{}') -> str
~~~


Monday connector operation `search_items` (platform tool `monday.search_items`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:15480`.

### `monday_update_item`

Namespace: `monday`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
monday_update_item(arguments: str='{}') -> str
~~~


Monday connector operation `update_item` (platform tool `monday.update_item`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:15501`.

### `monday_workspace_id`

Namespace: `monday`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
monday_workspace_id(arguments: str='{}') -> str
~~~


Monday connector operation `workspace_id` (platform tool `monday.workspace_id`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:15522`.

### `myob_create_bill`

Namespace: `myob`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
myob_create_bill(arguments: str='{}') -> str
~~~


Myob connector operation `create_bill` (platform tool `myob.create_bill`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:15543`.

### `myob_list_accounts`

Namespace: `myob`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
myob_list_accounts(arguments: str='{}') -> str
~~~


Myob connector operation `list_accounts` (platform tool `myob.list_accounts`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:15564`.

### `myob_list_contacts`

Namespace: `myob`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
myob_list_contacts(arguments: str='{}') -> str
~~~


Myob connector operation `list_contacts` (platform tool `myob.list_contacts`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:15585`.

### `myob_list_invoices`

Namespace: `myob`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
myob_list_invoices(arguments: str='{}') -> str
~~~


Myob connector operation `list_invoices` (platform tool `myob.list_invoices`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:15606`.

### `myob_list_payments`

Namespace: `myob`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
myob_list_payments(arguments: str='{}') -> str
~~~


Myob connector operation `list_payments` (platform tool `myob.list_payments`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:15627`.

### `notion_append_block_children`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_append_block_children(arguments: str='{}') -> str
~~~


Notion connector operation `append_block_children` (platform tool `notion.append_block_children`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:15648`.

### `notion_archive_page`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_archive_page(arguments: str='{}') -> str
~~~


Notion connector operation `archive_page` (platform tool `notion.archive_page`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:15669`.

### `notion_bulk_property_update`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_bulk_property_update(message: str='', inputs: str='{}') -> str
~~~


Run the notion domain agent action `bulk_property_update`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:9579`.

### `notion_bulk_status_update`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_bulk_status_update(message: str='', inputs: str='{}') -> str
~~~


Run the notion domain agent action `bulk_status_update`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:9557`.

### `notion_bulk_update_pages`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_bulk_update_pages(arguments: str='{}') -> str
~~~


Notion connector operation `bulk_update_pages` (platform tool `notion.bulk_update_pages`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:15690`.

### `notion_chat`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_chat(message: str='', inputs: str='{}') -> str
~~~


Run the notion domain agent action `chat`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:9227`.

### `notion_comment_orchestrator`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_comment_orchestrator(message: str='', inputs: str='{}') -> str
~~~


Run the notion domain agent action `comment_orchestrator`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:9513`.

### `notion_complete_file_upload`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_complete_file_upload(arguments: str='{}') -> str
~~~


Notion connector operation `complete_file_upload` (platform tool `notion.complete_file_upload`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:15711`.

### `notion_create_comment`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_create_comment(arguments: str='{}') -> str
~~~


Notion connector operation `create_comment` (platform tool `notion.create_comment`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:15732`.

### `notion_create_dashboard`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_create_dashboard(message: str='', inputs: str='{}') -> str
~~~


Run the notion domain agent action `create_dashboard`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:9623`.

### `notion_create_data_source`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_create_data_source(arguments: str='{}') -> str
~~~


Notion connector operation `create_data_source` (platform tool `notion.create_data_source`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:15753`.

### `notion_create_database`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_create_database(arguments: str='{}') -> str
~~~


Notion connector operation `create_database` (platform tool `notion.create_database`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:15774`.

### `notion_create_file_upload`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_create_file_upload(arguments: str='{}') -> str
~~~


Notion connector operation `create_file_upload` (platform tool `notion.create_file_upload`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:15795`.

### `notion_create_page`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_create_page(parent_id: Optional[str]=None, title: Optional[str]=None, content_markdown: Optional[str]=None) -> str
~~~


Create a new Notion page in the given parent (database or page).

Args:
    parent_id (required): Parent page or database ID.
    title (required): 
    content_markdown: Page content in Markdown (will be converted to Notion blocks).

Source: `lightbulb/mcp_generated_tools.py:15816`.

### `notion_create_view`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_create_view(arguments: str='{}') -> str
~~~


Notion connector operation `create_view` (platform tool `notion.create_view`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:15838`.

### `notion_create_webhook`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_create_webhook(arguments: str='{}') -> str
~~~


Notion connector operation `create_webhook` (platform tool `notion.create_webhook`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:15859`.

### `notion_delete_block`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_delete_block(arguments: str='{}') -> str
~~~


Notion connector operation `delete_block` (platform tool `notion.delete_block`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:15880`.

### `notion_delete_comment`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_delete_comment(arguments: str='{}') -> str
~~~


Notion connector operation `delete_comment` (platform tool `notion.delete_comment`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:15901`.

### `notion_delete_view`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_delete_view(arguments: str='{}') -> str
~~~


Notion connector operation `delete_view` (platform tool `notion.delete_view`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:15922`.

### `notion_delete_webhook`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_delete_webhook(arguments: str='{}') -> str
~~~


Notion connector operation `delete_webhook` (platform tool `notion.delete_webhook`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:15943`.

### `notion_get_block`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_get_block(arguments: str='{}') -> str
~~~


Notion connector operation `get_block` (platform tool `notion.get_block`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:15964`.

### `notion_get_comment`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_get_comment(arguments: str='{}') -> str
~~~


Notion connector operation `get_comment` (platform tool `notion.get_comment`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:15985`.

### `notion_get_file_upload`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_get_file_upload(arguments: str='{}') -> str
~~~


Notion connector operation `get_file_upload` (platform tool `notion.get_file_upload`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:16006`.

### `notion_get_page`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_get_page(arguments: str='{}') -> str
~~~


Notion connector operation `get_page` (platform tool `notion.get_page`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:16027`.

### `notion_get_page_markdown`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_get_page_markdown(arguments: str='{}') -> str
~~~


Notion connector operation `get_page_markdown` (platform tool `notion.get_page_markdown`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:16048`.

### `notion_get_self`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_get_self(arguments: str='{}') -> str
~~~


Notion connector operation `get_self` (platform tool `notion.get_self`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:16069`.

### `notion_get_user`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_get_user(arguments: str='{}') -> str
~~~


Notion connector operation `get_user` (platform tool `notion.get_user`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:16090`.

### `notion_get_view`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_get_view(arguments: str='{}') -> str
~~~


Notion connector operation `get_view` (platform tool `notion.get_view`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:16111`.

### `notion_kb_author`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_kb_author(message: str='', inputs: str='{}') -> str
~~~


Run the notion domain agent action `kb_author`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:9381`.

### `notion_link_review`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_link_review(message: str='', inputs: str='{}') -> str
~~~


Run the notion domain agent action `link_review`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:9535`.

### `notion_list_block_children`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_list_block_children(arguments: str='{}') -> str
~~~


Notion connector operation `list_block_children` (platform tool `notion.list_block_children`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:16132`.

### `notion_list_comments`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_list_comments(arguments: str='{}') -> str
~~~


Notion connector operation `list_comments` (platform tool `notion.list_comments`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:16153`.

### `notion_list_data_source_templates`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_list_data_source_templates(arguments: str='{}') -> str
~~~


Notion connector operation `list_data_source_templates` (platform tool `notion.list_data_source_templates`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:16174`.

### `notion_list_data_sources`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_list_data_sources(arguments: str='{}') -> str
~~~


Notion connector operation `list_data_sources` (platform tool `notion.list_data_sources`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:16195`.

### `notion_list_databases`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_list_databases(arguments: str='{}') -> str
~~~


Notion connector operation `list_databases` (platform tool `notion.list_databases`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:16216`.

### `notion_list_file_uploads`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_list_file_uploads(arguments: str='{}') -> str
~~~


Notion connector operation `list_file_uploads` (platform tool `notion.list_file_uploads`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:16237`.

### `notion_list_users`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_list_users(arguments: str='{}') -> str
~~~


Notion connector operation `list_users` (platform tool `notion.list_users`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:16258`.

### `notion_list_views`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_list_views(arguments: str='{}') -> str
~~~


Notion connector operation `list_views` (platform tool `notion.list_views`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:16279`.

### `notion_list_webhooks`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_list_webhooks(arguments: str='{}') -> str
~~~


Notion connector operation `list_webhooks` (platform tool `notion.list_webhooks`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:16300`.

### `notion_meeting_notes_capture`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_meeting_notes_capture(message: str='', inputs: str='{}') -> str
~~~


Run the notion domain agent action `meeting_notes_capture`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:9359`.

### `notion_move_page`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_move_page(arguments: str='{}') -> str
~~~


Notion connector operation `move_page` (platform tool `notion.move_page`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:16321`.

### `notion_oauth_introspect`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_oauth_introspect(arguments: str='{}') -> str
~~~


Notion connector operation `oauth_introspect` (platform tool `notion.oauth_introspect`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:16342`.

### `notion_oauth_revoke`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_oauth_revoke(arguments: str='{}') -> str
~~~


Notion connector operation `oauth_revoke` (platform tool `notion.oauth_revoke`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:16363`.

### `notion_okr_progress`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_okr_progress(message: str='', inputs: str='{}') -> str
~~~


Run the notion domain agent action `okr_progress`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:9469`.

### `notion_page_summarize`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_page_summarize(message: str='', inputs: str='{}') -> str
~~~


Run the notion domain agent action `page_summarize`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:9337`.

### `notion_plan_domain_intelligence`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_plan_domain_intelligence(message: str='', inputs: str='{}') -> str
~~~


Run the notion domain agent action `plan_domain_intelligence`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:9645`.

### `notion_query_data`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_query_data(message: str='', inputs: str='{}') -> str
~~~


Run the notion domain agent action `query_data`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:9249`.

### `notion_query_data_source`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_query_data_source(arguments: str='{}') -> str
~~~


Notion connector operation `query_data_source` (platform tool `notion.query_data_source`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:16384`.

### `notion_query_database`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_query_database(database_id: Optional[str]=None, filter_json: Optional[str]=None, sorts_json: Optional[str]=None, page_size: int=100) -> str
~~~


Query rows in a Notion database with filters and sorts.

Args:
    database_id (required): Notion database ID.
    filter_json: Notion filter object as a JSON string.
    sorts_json: Notion sorts array as a JSON string.
    page_size:

Source: `lightbulb/mcp_generated_tools.py:16405`.

### `notion_query_view`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_query_view(arguments: str='{}') -> str
~~~


Notion connector operation `query_view` (platform tool `notion.query_view`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:16430`.

### `notion_replace_page_markdown`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_replace_page_markdown(arguments: str='{}') -> str
~~~


Notion connector operation `replace_page_markdown` (platform tool `notion.replace_page_markdown`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:16451`.

### `notion_schema_intelligence`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_schema_intelligence(message: str='', inputs: str='{}') -> str
~~~


Run the notion domain agent action `schema_intelligence`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:9293`.

### `notion_search`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_search(query: Optional[str]=None, filter_type: Optional[str]=None) -> str
~~~


Search Notion pages and databases the integration has access to.

Args:
    query (required): Search text.
    filter_type: One of: page, database.

Source: `lightbulb/mcp_generated_tools.py:16472`.

### `notion_search_by_title`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_search_by_title(arguments: str='{}') -> str
~~~


Notion connector operation `search_by_title` (platform tool `notion.search_by_title`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:16491`.

### `notion_search_intelligent`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_search_intelligent(message: str='', inputs: str='{}') -> str
~~~


Run the notion domain agent action `search_intelligent`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:9315`.

### `notion_send_file_upload`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_send_file_upload(arguments: str='{}') -> str
~~~


Notion connector operation `send_file_upload` (platform tool `notion.send_file_upload`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:16512`.

### `notion_sprint_plan`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_sprint_plan(message: str='', inputs: str='{}') -> str
~~~


Run the notion domain agent action `sprint_plan`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:9425`.

### `notion_template_runner`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_template_runner(message: str='', inputs: str='{}') -> str
~~~


Run the notion domain agent action `template_runner`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:9601`.

### `notion_trash_page`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_trash_page(arguments: str='{}') -> str
~~~


Notion connector operation `trash_page` (platform tool `notion.trash_page`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:16533`.

### `notion_triage_backlog`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_triage_backlog(message: str='', inputs: str='{}') -> str
~~~


Run the notion domain agent action `triage_backlog`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:9403`.

### `notion_update_block`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_update_block(arguments: str='{}') -> str
~~~


Notion connector operation `update_block` (platform tool `notion.update_block`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:16554`.

### `notion_update_comment`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_update_comment(arguments: str='{}') -> str
~~~


Notion connector operation `update_comment` (platform tool `notion.update_comment`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:16575`.

### `notion_update_data_source_properties`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_update_data_source_properties(arguments: str='{}') -> str
~~~


Notion connector operation `update_data_source_properties` (platform tool `notion.update_data_source_properties`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:16596`.

### `notion_update_database`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_update_database(arguments: str='{}') -> str
~~~


Notion connector operation `update_database` (platform tool `notion.update_database`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:16617`.

### `notion_update_database_properties`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_update_database_properties(arguments: str='{}') -> str
~~~


Notion connector operation `update_database_properties` (platform tool `notion.update_database_properties`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:16638`.

### `notion_update_page`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_update_page(arguments: str='{}') -> str
~~~


Notion connector operation `update_page` (platform tool `notion.update_page`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:16659`.

### `notion_update_page_markdown`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_update_page_markdown(arguments: str='{}') -> str
~~~


Notion connector operation `update_page_markdown` (platform tool `notion.update_page_markdown`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:16680`.

### `notion_update_view`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_update_view(arguments: str='{}') -> str
~~~


Notion connector operation `update_view` (platform tool `notion.update_view`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:16701`.

### `notion_view_designer`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_view_designer(message: str='', inputs: str='{}') -> str
~~~


Run the notion domain agent action `view_designer`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:9491`.

### `notion_weekly_status_report`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_weekly_status_report(message: str='', inputs: str='{}') -> str
~~~


Run the notion domain agent action `weekly_status_report`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:9447`.

### `notion_workspace_inventory`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_workspace_inventory(message: str='', inputs: str='{}') -> str
~~~


Run the notion domain agent action `workspace_inventory`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:9271`.

### `paypal_list_disputes`

Namespace: `paypal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
paypal_list_disputes(arguments: str='{}') -> str
~~~


Paypal connector operation `list_disputes` (platform tool `paypal.list_disputes`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:16722`.

### `paypal_list_invoices`

Namespace: `paypal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
paypal_list_invoices(arguments: str='{}') -> str
~~~


Paypal connector operation `list_invoices` (platform tool `paypal.list_invoices`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:16743`.

### `paypal_list_payouts`

Namespace: `paypal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
paypal_list_payouts(arguments: str='{}') -> str
~~~


Paypal connector operation `list_payouts` (platform tool `paypal.list_payouts`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:16764`.

### `paypal_list_transactions`

Namespace: `paypal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
paypal_list_transactions(arguments: str='{}') -> str
~~~


Paypal connector operation `list_transactions` (platform tool `paypal.list_transactions`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:16785`.

### `procurement_chat`

Namespace: `procurement`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
procurement_chat(message: str='', inputs: str='{}') -> str
~~~


Run the procurement domain agent action `chat`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:9667`.

### `procurement_contract_to_pay`

Namespace: `procurement`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
procurement_contract_to_pay(message: str='', inputs: str='{}') -> str
~~~


Run the procurement domain agent action `contract_to_pay`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:9755`.

### `procurement_plan_domain_intelligence`

Namespace: `procurement`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
procurement_plan_domain_intelligence(message: str='', inputs: str='{}') -> str
~~~


Run the procurement domain agent action `plan_domain_intelligence`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:9821`.

### `procurement_po_approval_workflow`

Namespace: `procurement`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
procurement_po_approval_workflow(message: str='', inputs: str='{}') -> str
~~~


Run the procurement domain agent action `po_approval_workflow`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:9711`.

### `procurement_spend_analysis`

Namespace: `procurement`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
procurement_spend_analysis(message: str='', inputs: str='{}') -> str
~~~


Run the procurement domain agent action `spend_analysis`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:9777`.

### `procurement_supplier_evaluation`

Namespace: `procurement`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
procurement_supplier_evaluation(message: str='', inputs: str='{}') -> str
~~~


Run the procurement domain agent action `supplier_evaluation`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:9733`.

### `procurement_vendor_onboarding`

Namespace: `procurement`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
procurement_vendor_onboarding(message: str='', inputs: str='{}') -> str
~~~


Run the procurement domain agent action `vendor_onboarding`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:9689`.

### `procurement_vendor_risk_assessment`

Namespace: `procurement`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
procurement_vendor_risk_assessment(message: str='', inputs: str='{}') -> str
~~~


Run the procurement domain agent action `vendor_risk_assessment`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:9799`.

### `product_analysis`

Namespace: `product`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
product_analysis(message: str='', inputs: str='{}') -> str
~~~


Run the product domain agent action `product_analysis`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:10063`.

### `product_assortment_gap_analysis`

Namespace: `product`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
product_assortment_gap_analysis(message: str='', inputs: str='{}') -> str
~~~


Run the product domain agent action `assortment_gap_analysis`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:10129`.

### `product_chat`

Namespace: `product`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
product_chat(message: str='', inputs: str='{}') -> str
~~~


Run the product domain agent action `chat`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:9843`.

### `product_competitor_watchlist`

Namespace: `product`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
product_competitor_watchlist(message: str='', inputs: str='{}') -> str
~~~


Run the product domain agent action `competitor_watchlist`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:10107`.

### `product_customer_segment`

Namespace: `product`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
product_customer_segment(message: str='', inputs: str='{}') -> str
~~~


Run the product domain agent action `customer_segment`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:10019`.

### `product_experiment_design`

Namespace: `product`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
product_experiment_design(message: str='', inputs: str='{}') -> str
~~~


Run the product domain agent action `experiment_design`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:9909`.

### `product_experimentation`

Namespace: `product`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
product_experimentation(message: str='', inputs: str='{}') -> str
~~~


Run the product domain agent action `experimentation`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:9887`.

### `product_feature_adoption`

Namespace: `product`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
product_feature_adoption(message: str='', inputs: str='{}') -> str
~~~


Run the product domain agent action `feature_adoption`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:9865`.

### `product_feedback_synthesis`

Namespace: `product`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
product_feedback_synthesis(message: str='', inputs: str='{}') -> str
~~~


Run the product domain agent action `feedback_synthesis`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:9931`.

### `product_plan_domain_intelligence`

Namespace: `product`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
product_plan_domain_intelligence(message: str='', inputs: str='{}') -> str
~~~


Run the product domain agent action `plan_domain_intelligence`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:10151`.

### `product_predict`

Namespace: `product`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
product_predict(message: str='', inputs: str='{}') -> str
~~~


Run the product domain agent action `predict`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:10041`.

### `product_pricing_intelligence`

Namespace: `product`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
product_pricing_intelligence(message: str='', inputs: str='{}') -> str
~~~


Run the product domain agent action `pricing_intelligence`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:9997`.

### `product_roadmap_plan`

Namespace: `product`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
product_roadmap_plan(message: str='', inputs: str='{}') -> str
~~~


Run the product domain agent action `roadmap_plan`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:9975`.

### `product_roadmap_prioritize`

Namespace: `product`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
product_roadmap_prioritize(message: str='', inputs: str='{}') -> str
~~~


Run the product domain agent action `roadmap_prioritize`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:9953`.

### `product_trend_synthesis`

Namespace: `product`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
product_trend_synthesis(message: str='', inputs: str='{}') -> str
~~~


Run the product domain agent action `trend_synthesis`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:10085`.

### `quickbooks_aged_payable_report`

Namespace: `quickbooks`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
quickbooks_aged_payable_report(as_of_date: Optional[str]=None, start_date: Optional[str]=None, end_date: Optional[str]=None, columns: Optional[list[str]]=None) -> str
~~~


Fetch the QuickBooks aged payables report for AP aging and vendor cash planning.

Args:
    as_of_date: Aging as-of date (YYYY-MM-DD).
    start_date: Optional start date (YYYY-MM-DD).
    end_date: Optional end date (YYYY-MM-DD).
    columns: Optional report columns to request.

Source: `lightbulb/mcp_generated_tools.py:16806`.

### `quickbooks_aged_receivable_report`

Namespace: `quickbooks`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
quickbooks_aged_receivable_report(as_of_date: Optional[str]=None, start_date: Optional[str]=None, end_date: Optional[str]=None, columns: Optional[list[str]]=None) -> str
~~~


Fetch the QuickBooks aged receivables report for AR aging and collections analysis.

Args:
    as_of_date: Aging as-of date (YYYY-MM-DD).
    start_date: Optional start date (YYYY-MM-DD).
    end_date: Optional end date (YYYY-MM-DD).
    columns: Optional report columns to request.

Source: `lightbulb/mcp_generated_tools.py:16831`.

### `quickbooks_balance_sheet_report`

Namespace: `quickbooks`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
quickbooks_balance_sheet_report(as_of_date: Optional[str]=None, accounting_method: Optional[str]=None, summarize_column_by: Optional[str]=None, columns: Optional[list[str]]=None) -> str
~~~


Fetch the QuickBooks balance sheet report as of a date.

Args:
    as_of_date: Report as-of date (YYYY-MM-DD).
    accounting_method: Accounting method: Accrual or Cash.
    summarize_column_by: Optional QuickBooks summarize_column_by parameter.
    columns: Optional report columns to request.

Source: `lightbulb/mcp_generated_tools.py:16856`.

### `quickbooks_cash_flow_report`

Namespace: `quickbooks`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
quickbooks_cash_flow_report(start_date: Optional[str]=None, end_date: Optional[str]=None, accounting_method: Optional[str]=None, summarize_column_by: Optional[str]=None, columns: Optional[list[str]]=None) -> str
~~~


Fetch the QuickBooks statement of cash flows for cash-flow analysis.

Args:
    start_date: Report start date (YYYY-MM-DD).
    end_date: Report end date (YYYY-MM-DD).
    accounting_method: Accounting method: Accrual or Cash.
    summarize_column_by: Optional QuickBooks summarize_column_by parameter.
    columns: Optional report columns to request.

Source: `lightbulb/mcp_generated_tools.py:16881`.

### `quickbooks_company_info`

Namespace: `quickbooks`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
quickbooks_company_info() -> str
~~~


Fetch QuickBooks company information for the active company.

Source: `lightbulb/mcp_generated_tools.py:16909`.

### `quickbooks_controller_snapshot`

Namespace: `quickbooks`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
quickbooks_controller_snapshot(reports: Optional[list[str]]=None, start_date: Optional[str]=None, end_date: Optional[str]=None, as_of_date: Optional[str]=None) -> str
~~~


Build a QuickBooks controller snapshot with company info, preferences, and core financial reports.

Args:
    reports: Reports to include; defaults to core controller reports.
    start_date: Report start date (YYYY-MM-DD).
    end_date: Report end date (YYYY-MM-DD).
    as_of_date: Report as-of date (YYYY-MM-DD).

Source: `lightbulb/mcp_generated_tools.py:16920`.

### `quickbooks_create_bill`

Namespace: `quickbooks`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
quickbooks_create_bill(arguments: str='{}') -> str
~~~


Quickbooks connector operation `create_bill` (platform tool `quickbooks.create_bill`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:16945`.

### `quickbooks_create_entity`

Namespace: `quickbooks`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
quickbooks_create_entity(arguments: str='{}') -> str
~~~


Quickbooks connector operation `create_entity` (platform tool `quickbooks.create_entity`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:16966`.

### `quickbooks_create_invoice`

Namespace: `quickbooks`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
quickbooks_create_invoice(customer_id: Optional[str]=None, line_items: Optional[list[str]]=None, due_date: Optional[str]=None) -> str
~~~


Create a draft QuickBooks invoice for a customer.

Args:
    customer_id (required): QuickBooks customer ID.
    line_items (required): JSON-string list of line items.
    due_date: Due date (YYYY-MM-DD).

Source: `lightbulb/mcp_generated_tools.py:16987`.

### `quickbooks_create_journal_entry`

Namespace: `quickbooks`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
quickbooks_create_journal_entry(arguments: str='{}') -> str
~~~


Quickbooks connector operation `create_journal_entry` (platform tool `quickbooks.create_journal_entry`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:17009`.

### `quickbooks_deep_sync`

Namespace: `quickbooks`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
quickbooks_deep_sync(arguments: str='{}') -> str
~~~


Quickbooks connector operation `deep_sync` (platform tool `quickbooks.deep_sync`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:17030`.

### `quickbooks_get_company_info`

Namespace: `quickbooks`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
quickbooks_get_company_info() -> str
~~~


Fetch QuickBooks company information for the active company.

Source: `lightbulb/mcp_generated_tools.py:17051`.

### `quickbooks_get_entity`

Namespace: `quickbooks`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
quickbooks_get_entity(arguments: str='{}') -> str
~~~


Quickbooks connector operation `get_entity` (platform tool `quickbooks.get_entity`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:17062`.

### `quickbooks_get_invoice`

Namespace: `quickbooks`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
quickbooks_get_invoice(arguments: str='{}') -> str
~~~


Quickbooks connector operation `get_invoice` (platform tool `quickbooks.get_invoice`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:17083`.

### `quickbooks_list_accounts`

Namespace: `quickbooks`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
quickbooks_list_accounts(account_type: Optional[str]=None, max_results: int=500) -> str
~~~


List the QuickBooks chart of accounts for GL and statement analysis.

Args:
    account_type: Optional QuickBooks account type filter.
    max_results: Maximum number of accounts to return.

Source: `lightbulb/mcp_generated_tools.py:17104`.

### `quickbooks_list_bills`

Namespace: `quickbooks`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
quickbooks_list_bills(status: Optional[str]=None, from_date: Optional[str]=None, to_date: Optional[str]=None, max_results: int=100) -> str
~~~


List QuickBooks vendor bills for AP analysis.

Args:
    status: Optional bill status filter.
    from_date: Start date (YYYY-MM-DD).
    to_date: End date (YYYY-MM-DD).
    max_results: Maximum number of bills to return.

Source: `lightbulb/mcp_generated_tools.py:17123`.

### `quickbooks_list_classes`

Namespace: `quickbooks`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
quickbooks_list_classes(arguments: str='{}') -> str
~~~


Quickbooks connector operation `list_classes` (platform tool `quickbooks.list_classes`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:17148`.

### `quickbooks_list_credit_memos`

Namespace: `quickbooks`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
quickbooks_list_credit_memos(arguments: str='{}') -> str
~~~


Quickbooks connector operation `list_credit_memos` (platform tool `quickbooks.list_credit_memos`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:17169`.

### `quickbooks_list_customers`

Namespace: `quickbooks`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
quickbooks_list_customers(query: Optional[str]=None, max_results: int=100) -> str
~~~


List QuickBooks customers for the active company.

Args:
    query: Optional name/email search filter.
    max_results: Maximum number of customers to return.

Source: `lightbulb/mcp_generated_tools.py:17190`.

### `quickbooks_list_departments`

Namespace: `quickbooks`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
quickbooks_list_departments(arguments: str='{}') -> str
~~~


Quickbooks connector operation `list_departments` (platform tool `quickbooks.list_departments`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:17209`.

### `quickbooks_list_deposits`

Namespace: `quickbooks`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
quickbooks_list_deposits(arguments: str='{}') -> str
~~~


Quickbooks connector operation `list_deposits` (platform tool `quickbooks.list_deposits`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:17230`.

### `quickbooks_list_entities`

Namespace: `quickbooks`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
quickbooks_list_entities(arguments: str='{}') -> str
~~~


Quickbooks connector operation `list_entities` (platform tool `quickbooks.list_entities`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:17251`.

### `quickbooks_list_invoices`

Namespace: `quickbooks`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
quickbooks_list_invoices(status: Optional[str]=None, from_date: Optional[str]=None, to_date: Optional[str]=None, max_results: int=100) -> str
~~~


List QuickBooks invoices for the active company.

Args:
    status: Filter by status (e.g. 'Open', 'Paid').
    from_date: Start date (YYYY-MM-DD).
    to_date: End date (YYYY-MM-DD).
    max_results: Maximum number of invoices to return.

Source: `lightbulb/mcp_generated_tools.py:17272`.

### `quickbooks_list_items`

Namespace: `quickbooks`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
quickbooks_list_items(arguments: str='{}') -> str
~~~


Quickbooks connector operation `list_items` (platform tool `quickbooks.list_items`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:17297`.

### `quickbooks_list_payment_methods`

Namespace: `quickbooks`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
quickbooks_list_payment_methods(arguments: str='{}') -> str
~~~


Quickbooks connector operation `list_payment_methods` (platform tool `quickbooks.list_payment_methods`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:17318`.

### `quickbooks_list_payments`

Namespace: `quickbooks`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
quickbooks_list_payments(from_date: Optional[str]=None, to_date: Optional[str]=None, max_results: int=100) -> str
~~~


List QuickBooks payments for cash movement and reconciliation analysis.

Args:
    from_date: Start date (YYYY-MM-DD).
    to_date: End date (YYYY-MM-DD).
    max_results: Maximum number of payments to return.

Source: `lightbulb/mcp_generated_tools.py:17339`.

### `quickbooks_list_purchase_orders`

Namespace: `quickbooks`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
quickbooks_list_purchase_orders(arguments: str='{}') -> str
~~~


Quickbooks connector operation `list_purchase_orders` (platform tool `quickbooks.list_purchase_orders`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:17361`.

### `quickbooks_list_purchases`

Namespace: `quickbooks`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
quickbooks_list_purchases(arguments: str='{}') -> str
~~~


Quickbooks connector operation `list_purchases` (platform tool `quickbooks.list_purchases`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:17382`.

### `quickbooks_list_refund_receipts`

Namespace: `quickbooks`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
quickbooks_list_refund_receipts(arguments: str='{}') -> str
~~~


Quickbooks connector operation `list_refund_receipts` (platform tool `quickbooks.list_refund_receipts`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:17403`.

### `quickbooks_list_sales_receipts`

Namespace: `quickbooks`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
quickbooks_list_sales_receipts(arguments: str='{}') -> str
~~~


Quickbooks connector operation `list_sales_receipts` (platform tool `quickbooks.list_sales_receipts`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:17424`.

### `quickbooks_list_tax_codes`

Namespace: `quickbooks`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
quickbooks_list_tax_codes(arguments: str='{}') -> str
~~~


Quickbooks connector operation `list_tax_codes` (platform tool `quickbooks.list_tax_codes`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:17445`.

### `quickbooks_list_tax_rates`

Namespace: `quickbooks`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
quickbooks_list_tax_rates(arguments: str='{}') -> str
~~~


Quickbooks connector operation `list_tax_rates` (platform tool `quickbooks.list_tax_rates`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:17466`.

### `quickbooks_list_terms`

Namespace: `quickbooks`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
quickbooks_list_terms(arguments: str='{}') -> str
~~~


Quickbooks connector operation `list_terms` (platform tool `quickbooks.list_terms`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:17487`.

### `quickbooks_list_vendor_credits`

Namespace: `quickbooks`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
quickbooks_list_vendor_credits(arguments: str='{}') -> str
~~~


Quickbooks connector operation `list_vendor_credits` (platform tool `quickbooks.list_vendor_credits`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:17508`.

### `quickbooks_list_vendors`

Namespace: `quickbooks`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
quickbooks_list_vendors(query: Optional[str]=None, max_results: int=100) -> str
~~~


List QuickBooks vendors for the active company.

Args:
    query: Optional vendor name search filter.
    max_results: Maximum number of vendors to return.

Source: `lightbulb/mcp_generated_tools.py:17529`.

### `quickbooks_pay_bill`

Namespace: `quickbooks`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
quickbooks_pay_bill(arguments: str='{}') -> str
~~~


Quickbooks connector operation `pay_bill` (platform tool `quickbooks.pay_bill`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:17548`.

### `quickbooks_payroll_company_info`

Namespace: `quickbooks`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
quickbooks_payroll_company_info(arguments: str='{}') -> str
~~~


Quickbooks connector operation `payroll_company_info` (platform tool `quickbooks.payroll_company_info`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:17569`.

### `quickbooks_payroll_employees`

Namespace: `quickbooks`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
quickbooks_payroll_employees(arguments: str='{}') -> str
~~~


Quickbooks connector operation `payroll_employees` (platform tool `quickbooks.payroll_employees`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:17590`.

### `quickbooks_payroll_payslips`

Namespace: `quickbooks`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
quickbooks_payroll_payslips(arguments: str='{}') -> str
~~~


Quickbooks connector operation `payroll_payslips` (platform tool `quickbooks.payroll_payslips`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:17611`.

### `quickbooks_profit_loss_report`

Namespace: `quickbooks`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
quickbooks_profit_loss_report(start_date: Optional[str]=None, end_date: Optional[str]=None, accounting_method: Optional[str]=None, summarize_column_by: Optional[str]=None, columns: Optional[list[str]]=None) -> str
~~~


Fetch the QuickBooks profit and loss report for income statement analysis.

Args:
    start_date: Report start date (YYYY-MM-DD).
    end_date: Report end date (YYYY-MM-DD).
    accounting_method: Accounting method: Accrual or Cash.
    summarize_column_by: Optional QuickBooks summarize_column_by parameter.
    columns: Optional report columns to request.

Source: `lightbulb/mcp_generated_tools.py:17632`.

### `quickbooks_query`

Namespace: `quickbooks`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
quickbooks_query(arguments: str='{}') -> str
~~~


Quickbooks connector operation `query` (platform tool `quickbooks.query`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:17660`.

### `quickbooks_report`

Namespace: `quickbooks`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
quickbooks_report(report_name: Optional[str]=None, start_date: Optional[str]=None, end_date: Optional[str]=None, as_of_date: Optional[str]=None, accounting_method: Optional[str]=None, summarize_column_by: Optional[str]=None, columns: Optional[list[str]]=None) -> str
~~~


Fetch a named QuickBooks report such as profit_loss, balance_sheet, cash_flow, trial_balance, ar_aging, or ap_aging.

Args:
    report_name (required): QuickBooks report name or alias.
    start_date: Report start date (YYYY-MM-DD).
    end_date: Report end date (YYYY-MM-DD).
    as_of_date: Report as-of date for balance/aging reports (YYYY-MM-DD).
    accounting_method: Accounting method: Accrual or Cash.
    summarize_column_by: Optional QuickBooks summarize_column_by parameter.
    columns: Optional report columns to request.

Source: `lightbulb/mcp_generated_tools.py:17681`.

### `quickbooks_trial_balance_report`

Namespace: `quickbooks`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
quickbooks_trial_balance_report(start_date: Optional[str]=None, end_date: Optional[str]=None, accounting_method: Optional[str]=None, columns: Optional[list[str]]=None) -> str
~~~


Fetch the QuickBooks trial balance report for GL tie-out and close review.

Args:
    start_date: Report start date (YYYY-MM-DD).
    end_date: Report end date (YYYY-MM-DD).
    accounting_method: Accounting method: Accrual or Cash.
    columns: Optional report columns to request.

Source: `lightbulb/mcp_generated_tools.py:17715`.

### `quickbooks_update_entity`

Namespace: `quickbooks`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
quickbooks_update_entity(arguments: str='{}') -> str
~~~


Quickbooks connector operation `update_entity` (platform tool `quickbooks.update_entity`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:17740`.

### `ramp_list_receipts`

Namespace: `ramp`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
ramp_list_receipts(arguments: str='{}') -> str
~~~


Ramp connector operation `list_receipts` (platform tool `ramp.list_receipts`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:17761`.

### `ramp_list_reimbursements`

Namespace: `ramp`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
ramp_list_reimbursements(arguments: str='{}') -> str
~~~


Ramp connector operation `list_reimbursements` (platform tool `ramp.list_reimbursements`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:17782`.

### `ramp_list_transactions`

Namespace: `ramp`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
ramp_list_transactions(arguments: str='{}') -> str
~~~


Ramp connector operation `list_transactions` (platform tool `ramp.list_transactions`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:17803`.

### `salesforce_bulk_ingest_close`

Namespace: `salesforce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
salesforce_bulk_ingest_close(arguments: str='{}') -> str
~~~


Salesforce connector operation `bulk_ingest_close` (platform tool `salesforce.bulk_ingest_close`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:17824`.

### `salesforce_bulk_ingest_create`

Namespace: `salesforce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
salesforce_bulk_ingest_create(arguments: str='{}') -> str
~~~


Salesforce connector operation `bulk_ingest_create` (platform tool `salesforce.bulk_ingest_create`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:17845`.

### `salesforce_bulk_ingest_results`

Namespace: `salesforce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
salesforce_bulk_ingest_results(arguments: str='{}') -> str
~~~


Salesforce connector operation `bulk_ingest_results` (platform tool `salesforce.bulk_ingest_results`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:17866`.

### `salesforce_bulk_ingest_status`

Namespace: `salesforce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
salesforce_bulk_ingest_status(arguments: str='{}') -> str
~~~


Salesforce connector operation `bulk_ingest_status` (platform tool `salesforce.bulk_ingest_status`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:17887`.

### `salesforce_bulk_ingest_upload`

Namespace: `salesforce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
salesforce_bulk_ingest_upload(arguments: str='{}') -> str
~~~


Salesforce connector operation `bulk_ingest_upload` (platform tool `salesforce.bulk_ingest_upload`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:17908`.

### `salesforce_bulk_query_create`

Namespace: `salesforce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
salesforce_bulk_query_create(arguments: str='{}') -> str
~~~


Salesforce connector operation `bulk_query_create` (platform tool `salesforce.bulk_query_create`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:17929`.

### `salesforce_bulk_query_results`

Namespace: `salesforce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
salesforce_bulk_query_results(arguments: str='{}') -> str
~~~


Salesforce connector operation `bulk_query_results` (platform tool `salesforce.bulk_query_results`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:17950`.

### `salesforce_bulk_query_status`

Namespace: `salesforce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
salesforce_bulk_query_status(arguments: str='{}') -> str
~~~


Salesforce connector operation `bulk_query_status` (platform tool `salesforce.bulk_query_status`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:17971`.

### `salesforce_pipeline_report`

Namespace: `salesforce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
salesforce_pipeline_report(arguments: str='{}') -> str
~~~


Salesforce connector operation `pipeline_report` (platform tool `salesforce.pipeline_report`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:17992`.

### `shopify_analytics_query`

Namespace: `shopify`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
shopify_analytics_query(query: Optional[str]=None) -> str
~~~


Run a ShopifyQL analytics query against the shop's analytics warehouse.
Use for revenue, AOV, sessions, conversion, and grouped time-series metrics.
Defaults to net_sales + order_count by day for the last 30d when query is omitted.

    Args:
        query: ShopifyQL statement. Example: 'FROM sales SHOW sum(net_sales), count(orders) SINCE -14d UNTIL today GROUP BY week'.

Source: `lightbulb/mcp_generated_tools.py:18013`.

### `shopify_bulk_operation_create`

Namespace: `shopify`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
shopify_bulk_operation_create(query: Optional[str]=None) -> str
~~~


Submit a Shopify bulk-operation query to the asynchronous job runner.
Returns a bulk operation ID; poll via shopify.bulk_operation_status.

    Args:
        query (required): Bulk-operation GraphQL query (Shopify bulk-operation syntax).

Source: `lightbulb/mcp_generated_tools.py:18031`.

### `shopify_bulk_operation_result`

Namespace: `shopify`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
shopify_bulk_operation_result(bulk_operation_id: Optional[str]=None) -> str
~~~


Fetch the JSONL result file of a completed Shopify bulk operation.

Args:
    bulk_operation_id: Optional bulk-operation GID. Defaults to the latest completed.

Source: `lightbulb/mcp_generated_tools.py:18048`.

### `shopify_bulk_operation_status`

Namespace: `shopify`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
shopify_bulk_operation_status(bulk_operation_id: Optional[str]=None) -> str
~~~


Get the current status of the most recent (or a specific) Shopify bulk operation.

Args:
    bulk_operation_id: Optional bulk-operation GID. Defaults to the latest.

Source: `lightbulb/mcp_generated_tools.py:18064`.

### `shopify_create_price_rule`

Namespace: `shopify`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
shopify_create_price_rule(title: Optional[str]=None, value_type: Optional[str]=None, value: Optional[str]=None, starts_at: Optional[str]=None, ends_at: Optional[str]=None, usage_limit: Optional[int]=None) -> str
~~~


Create a Shopify price rule (the engine behind a discount code). Use to roll
out a targeted promotion for a segment after tagging.

    Args:
        title (required): Internal price-rule title.
        value_type (required): One of: percentage, fixed_amount.
        value (required): Discount value as a string (e.g. '-15' for 15% off, '-10.00' for $10 off).
        starts_at: ISO-8601 start datetime (defaults to now).
        ends_at: ISO-8601 end datetime (omit for open-ended).
        usage_limit: Maximum total uses across all customers.

Source: `lightbulb/mcp_generated_tools.py:18080`.

### `shopify_get_metafields`

Namespace: `shopify`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
shopify_get_metafields(owner_type: Optional[str]=None, owner_id: Optional[str]=None, namespace: Optional[str]=None, limit: int=30) -> str
~~~


Read metafields on a Shopify resource (product, customer, order, variant, collection, or shop).

Args:
    owner_type: One of: PRODUCT, CUSTOMER, ORDER, VARIANT, COLLECTION, SHOP. Defaults to PRODUCT.
    owner_id: Resource ID (numeric or GID). Required unless owner_type=SHOP.
    namespace: Optional metafield namespace filter.
    limit: Maximum metafields to return (1-250).

Source: `lightbulb/mcp_generated_tools.py:18112`.

### `shopify_get_shop_info`

Namespace: `shopify`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
shopify_get_shop_info() -> str
~~~


Fetch the connected Shopify shop's basic info (name, domain, currency, plan, timezone).

Source: `lightbulb/mcp_generated_tools.py:18137`.

### `shopify_list_abandoned_checkouts`

Namespace: `shopify`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
shopify_list_abandoned_checkouts(limit: int=20, query: Optional[str]=None) -> str
~~~


List the shop's recent abandoned checkouts with cart subtotals and customer
context. Use to compute abandoned-revenue at risk and prioritise recovery.

    Args:
        limit: Maximum checkouts to return (1-250).
        query: Optional Shopify search query (e.g. 'created_at:>=2026-04-01').

Source: `lightbulb/mcp_generated_tools.py:18148`.

### `shopify_list_collections`

Namespace: `shopify`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
shopify_list_collections(limit: int=50) -> str
~~~


List Shopify product collections (smart and custom).

Args:
    limit: Maximum collections to return (1-250).

Source: `lightbulb/mcp_generated_tools.py:18168`.

### `shopify_list_discounts`

Namespace: `shopify`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
shopify_list_discounts(limit: int=50) -> str
~~~


List active and historical discount codes / automatic discounts in the shop.

Args:
    limit: Maximum discounts to return (1-250).

Source: `lightbulb/mcp_generated_tools.py:18184`.

### `shopify_list_draft_orders`

Namespace: `shopify`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
shopify_list_draft_orders(limit: int=50, status: Optional[str]=None) -> str
~~~


List draft orders from the connected Shopify store.

Args:
    limit: 
    status: One of: open, invoice_sent, completed.

Source: `lightbulb/mcp_generated_tools.py:18200`.

### `shopify_list_fulfillment_orders`

Namespace: `shopify`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
shopify_list_fulfillment_orders(order_id: Optional[str]=None) -> str
~~~


List the fulfillment orders associated with a Shopify order, including locations and tracking.

Args:
    order_id (required): Shopify order ID (numeric or GID).

Source: `lightbulb/mcp_generated_tools.py:18219`.

### `shopify_list_locations`

Namespace: `shopify`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
shopify_list_locations(limit: int=20) -> str
~~~


List the Shopify shop's locations (warehouses, retail locations, fulfillment centres).

Args:
    limit: Maximum locations to return (1-50).

Source: `lightbulb/mcp_generated_tools.py:18235`.

### `shopify_list_metafield_definitions`

Namespace: `shopify`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
shopify_list_metafield_definitions(owner_type: Optional[str]=None, limit: int=50) -> str
~~~


List declared metafield definitions for a given owner type.

Args:
    owner_type (required): One of: PRODUCT, CUSTOMER, ORDER, VARIANT, COLLECTION, SHOP.
    limit: Maximum definitions to return (1-250).

Source: `lightbulb/mcp_generated_tools.py:18251`.

### `shopify_list_refunds`

Namespace: `shopify`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
shopify_list_refunds(limit: int=50, order_id: Optional[str]=None) -> str
~~~


List recent order refunds in the shop.

Args:
    limit: Maximum refunds to return (1-250).
    order_id: Optional order ID to scope refunds to a single order.

Source: `lightbulb/mcp_generated_tools.py:18270`.

### `shopify_list_transactions`

Namespace: `shopify`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
shopify_list_transactions(order_id: Optional[str]=None) -> str
~~~


List order transactions (authorisations, captures, voids, sales) for an order.

Args:
    order_id (required): Shopify order ID (numeric or GID).

Source: `lightbulb/mcp_generated_tools.py:18289`.

### `shopify_tag_customers_bulk`

Namespace: `shopify`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
shopify_tag_customers_bulk(customer_ids: Optional[list[str]]=None, tags: Optional[list[str]]=None) -> str
~~~


Apply tags to a batch of customers in a single call. Use after RFM/segment
analysis to mark a cohort (e.g. 'segment:champion', 'campaign:spring-launch').

    Args:
        customer_ids (required): Customer IDs (numeric or GIDs).
        tags (required): Tags to apply.

Source: `lightbulb/mcp_generated_tools.py:18305`.

### `shopify_update_metafield`

Namespace: `shopify`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
shopify_update_metafield(owner_type: Optional[str]=None, owner_id: Optional[str]=None, namespace: Optional[str]=None, key: Optional[str]=None, value: Optional[str]=None, type: Optional[str]=None) -> str
~~~


Create or update a metafield on a Shopify resource.

Args:
    owner_type: One of: PRODUCT, CUSTOMER, ORDER, VARIANT, COLLECTION. Defaults to PRODUCT.
    owner_id (required): Resource ID (numeric or GID).
    namespace (required): Metafield namespace.
    key (required): Metafield key.
    value (required): Metafield value (string-encoded per the type).
    type: Metafield type (e.g. single_line_text_field, number_integer, json). Defaults to single_line_text_field.

Source: `lightbulb/mcp_generated_tools.py:18325`.

### `slack_access_canvas`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_access_canvas(arguments: str='{}') -> str
~~~


Slack connector operation `access_canvas` (platform tool `slack.access_canvas`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:18356`.

### `slack_add_reaction`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_add_reaction(arguments: str='{}') -> str
~~~


Slack connector operation `add_reaction` (platform tool `slack.add_reaction`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:18377`.

### `slack_app_mention`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_app_mention(arguments: str='{}') -> str
~~~


Slack connector operation `app_mention` (platform tool `slack.app_mention`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:18398`.

### `slack_archive_channel`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_archive_channel(arguments: str='{}') -> str
~~~


Slack connector operation `archive_channel` (platform tool `slack.archive_channel`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:18419`.

### `slack_assistant_set_status`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_assistant_set_status(arguments: str='{}') -> str
~~~


Slack connector operation `assistant_set_status` (platform tool `slack.assistant_set_status`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:18440`.

### `slack_assistant_set_suggested_prompts`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_assistant_set_suggested_prompts(arguments: str='{}') -> str
~~~


Slack connector operation `assistant_set_suggested_prompts` (platform tool `slack.assistant_set_suggested_prompts`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:18461`.

### `slack_assistant_set_title`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_assistant_set_title(arguments: str='{}') -> str
~~~


Slack connector operation `assistant_set_title` (platform tool `slack.assistant_set_title`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:18482`.

### `slack_canvas_section_lookup`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_canvas_section_lookup(arguments: str='{}') -> str
~~~


Slack connector operation `canvas_section_lookup` (platform tool `slack.canvas_section_lookup`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:18503`.

### `slack_create_canvas`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_create_canvas(arguments: str='{}') -> str
~~~


Slack connector operation `create_canvas` (platform tool `slack.create_canvas`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:18524`.

### `slack_create_channel`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_create_channel(arguments: str='{}') -> str
~~~


Slack connector operation `create_channel` (platform tool `slack.create_channel`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:18545`.

### `slack_create_conversation_canvas`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_create_conversation_canvas(arguments: str='{}') -> str
~~~


Slack connector operation `create_conversation_canvas` (platform tool `slack.create_conversation_canvas`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:18566`.

### `slack_default_channel`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_default_channel(arguments: str='{}') -> str
~~~


Slack connector operation `default_channel` (platform tool `slack.default_channel`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:18587`.

### `slack_delete_canvas`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_delete_canvas(arguments: str='{}') -> str
~~~


Slack connector operation `delete_canvas` (platform tool `slack.delete_canvas`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:18608`.

### `slack_delete_message`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_delete_message(arguments: str='{}') -> str
~~~


Slack connector operation `delete_message` (platform tool `slack.delete_message`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:18629`.

### `slack_delete_scheduled_message`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_delete_scheduled_message(arguments: str='{}') -> str
~~~


Slack connector operation `delete_scheduled_message` (platform tool `slack.delete_scheduled_message`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:18650`.

### `slack_edit_canvas`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_edit_canvas(arguments: str='{}') -> str
~~~


Slack connector operation `edit_canvas` (platform tool `slack.edit_canvas`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:18671`.

### `slack_files_complete_upload_external`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_files_complete_upload_external(arguments: str='{}') -> str
~~~


Slack connector operation `files_complete_upload_external` (platform tool `slack.files_complete_upload_external`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:18692`.

### `slack_files_delete`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_files_delete(arguments: str='{}') -> str
~~~


Slack connector operation `files_delete` (platform tool `slack.files_delete`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:18713`.

### `slack_files_get_upload_url_external`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_files_get_upload_url_external(arguments: str='{}') -> str
~~~


Slack connector operation `files_get_upload_url_external` (platform tool `slack.files_get_upload_url_external`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:18734`.

### `slack_files_info`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_files_info(arguments: str='{}') -> str
~~~


Slack connector operation `files_info` (platform tool `slack.files_info`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:18755`.

### `slack_get_channel_history`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_get_channel_history(channel: Optional[str]=None, limit: int=50, oldest: Optional[str]=None) -> str
~~~


Fetch recent messages from a Slack channel.

Args:
    channel (required): Channel ID.
    limit: Max messages.
    oldest: Lower-bound timestamp (Slack ts format).

Source: `lightbulb/mcp_generated_tools.py:18776`.

### `slack_get_thread_replies`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_get_thread_replies(arguments: str='{}') -> str
~~~


Slack connector operation `get_thread_replies` (platform tool `slack.get_thread_replies`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:18798`.

### `slack_invite_to_channel`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_invite_to_channel(arguments: str='{}') -> str
~~~


Slack connector operation `invite_to_channel` (platform tool `slack.invite_to_channel`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:18819`.

### `slack_join_channel`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_join_channel(channel: Optional[str]=None) -> str
~~~


Join a public Slack channel the bot can access.

Args:
    channel (required): Channel ID or name.

Source: `lightbulb/mcp_generated_tools.py:18840`.

### `slack_kick_from_channel`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_kick_from_channel(arguments: str='{}') -> str
~~~


Slack connector operation `kick_from_channel` (platform tool `slack.kick_from_channel`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:18856`.

### `slack_list_channel_members`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_list_channel_members(arguments: str='{}') -> str
~~~


Slack connector operation `list_channel_members` (platform tool `slack.list_channel_members`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:18877`.

### `slack_list_channels`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_list_channels(types: str='public_channel', exclude_archived: bool=True) -> str
~~~


List channels the Slack workspace bot can see.

Args:
    types: Comma-separated: public_channel, private_channel, mpim, im.
    exclude_archived:

Source: `lightbulb/mcp_generated_tools.py:18898`.

### `slack_list_files`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_list_files(arguments: str='{}') -> str
~~~


Slack connector operation `list_files` (platform tool `slack.list_files`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:18917`.

### `slack_list_reactions`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_list_reactions(arguments: str='{}') -> str
~~~


Slack connector operation `list_reactions` (platform tool `slack.list_reactions`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:18938`.

### `slack_list_scheduled_messages`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_list_scheduled_messages(arguments: str='{}') -> str
~~~


Slack connector operation `list_scheduled_messages` (platform tool `slack.list_scheduled_messages`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:18959`.

### `slack_list_users`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_list_users(arguments: str='{}') -> str
~~~


Slack connector operation `list_users` (platform tool `slack.list_users`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:18980`.

### `slack_lookup_user`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_lookup_user(arguments: str='{}') -> str
~~~


Slack connector operation `lookup_user` (platform tool `slack.lookup_user`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:19001`.

### `slack_me_message`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_me_message(arguments: str='{}') -> str
~~~


Slack connector operation `me_message` (platform tool `slack.me_message`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:19022`.

### `slack_open_dm`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_open_dm(arguments: str='{}') -> str
~~~


Slack connector operation `open_dm` (platform tool `slack.open_dm`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:19043`.

### `slack_open_modal`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_open_modal(arguments: str='{}') -> str
~~~


Slack connector operation `open_modal` (platform tool `slack.open_modal`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:19064`.

### `slack_pins_add`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_pins_add(arguments: str='{}') -> str
~~~


Slack connector operation `pins_add` (platform tool `slack.pins_add`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:19085`.

### `slack_pins_remove`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_pins_remove(arguments: str='{}') -> str
~~~


Slack connector operation `pins_remove` (platform tool `slack.pins_remove`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:19106`.

### `slack_post_ephemeral`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_post_ephemeral(arguments: str='{}') -> str
~~~


Slack connector operation `post_ephemeral` (platform tool `slack.post_ephemeral`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:19127`.

### `slack_post_message`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_post_message(channel: Optional[str]=None, text: Optional[str]=None, thread_ts: Optional[str]=None) -> str
~~~


Post a message to a Slack channel or DM under the bot's identity.

Args:
    channel (required): Channel ID (Cxxx), name (#channel), or user ID (Uxxx) for DM.
    text (required): Message body. Slack mrkdwn supported.
    thread_ts: Thread timestamp to reply to (omit for top-level).

Source: `lightbulb/mcp_generated_tools.py:19148`.

### `slack_remove_reaction`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_remove_reaction(arguments: str='{}') -> str
~~~


Slack connector operation `remove_reaction` (platform tool `slack.remove_reaction`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:19170`.

### `slack_schedule_message`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_schedule_message(arguments: str='{}') -> str
~~~


Slack connector operation `schedule_message` (platform tool `slack.schedule_message`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:19191`.

### `slack_sdlc_canvas_template_id`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_sdlc_canvas_template_id(arguments: str='{}') -> str
~~~


Slack connector operation `sdlc_canvas_template_id` (platform tool `slack.sdlc_canvas_template_id`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:19212`.

### `slack_search_messages`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_search_messages(query: Optional[str]=None, count: int=20) -> str
~~~


Search Slack messages across channels the bot can see.

Args:
    query (required): Slack search query (supports operators: from:, in:, after:, before:).
    count: Max results.

Source: `lightbulb/mcp_generated_tools.py:19233`.

### `slack_set_channel_purpose`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_set_channel_purpose(arguments: str='{}') -> str
~~~


Slack connector operation `set_channel_purpose` (platform tool `slack.set_channel_purpose`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:19252`.

### `slack_set_channel_topic`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_set_channel_topic(arguments: str='{}') -> str
~~~


Slack connector operation `set_channel_topic` (platform tool `slack.set_channel_topic`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:19273`.

### `slack_team_info`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_team_info(arguments: str='{}') -> str
~~~


Slack connector operation `team_info` (platform tool `slack.team_info`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:19294`.

### `slack_unarchive_channel`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_unarchive_channel(arguments: str='{}') -> str
~~~


Slack connector operation `unarchive_channel` (platform tool `slack.unarchive_channel`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:19315`.

### `slack_unfurl_link`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_unfurl_link(arguments: str='{}') -> str
~~~


Slack connector operation `unfurl_link` (platform tool `slack.unfurl_link`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:19336`.

### `slack_update_message`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_update_message(arguments: str='{}') -> str
~~~


Slack connector operation `update_message` (platform tool `slack.update_message`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:19357`.

### `slack_usergroups_list`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_usergroups_list(arguments: str='{}') -> str
~~~


Slack connector operation `usergroups_list` (platform tool `slack.usergroups_list`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:19378`.

### `slack_usergroups_users_list`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_usergroups_users_list(arguments: str='{}') -> str
~~~


Slack connector operation `usergroups_users_list` (platform tool `slack.usergroups_users_list`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:19399`.

### `slack_users_info`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_users_info(arguments: str='{}') -> str
~~~


Slack connector operation `users_info` (platform tool `slack.users_info`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:19420`.

### `slack_users_set_presence`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_users_set_presence(arguments: str='{}') -> str
~~~


Slack connector operation `users_set_presence` (platform tool `slack.users_set_presence`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:19441`.

### `slack_views_open`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_views_open(arguments: str='{}') -> str
~~~


Slack connector operation `views_open` (platform tool `slack.views_open`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:19462`.

### `slack_views_publish`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_views_publish(arguments: str='{}') -> str
~~~


Slack connector operation `views_publish` (platform tool `slack.views_publish`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:19483`.

### `slack_views_push`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_views_push(arguments: str='{}') -> str
~~~


Slack connector operation `views_push` (platform tool `slack.views_push`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:19504`.

### `slack_views_update`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_views_update(arguments: str='{}') -> str
~~~


Slack connector operation `views_update` (platform tool `slack.views_update`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:19525`.

### `slack_workflows_step_completed`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_workflows_step_completed(arguments: str='{}') -> str
~~~


Slack connector operation `workflows_step_completed` (platform tool `slack.workflows_step_completed`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:19546`.

### `slack_workflows_step_failed`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_workflows_step_failed(arguments: str='{}') -> str
~~~


Slack connector operation `workflows_step_failed` (platform tool `slack.workflows_step_failed`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:19567`.

### `smarthome_automation_review`

Namespace: `smarthome`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
smarthome_automation_review(message: str='', inputs: str='{}') -> str
~~~


Run the smarthome domain agent action `automation_review`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:10261`.

### `smarthome_chat`

Namespace: `smarthome`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
smarthome_chat(message: str='', inputs: str='{}') -> str
~~~


Run the smarthome domain agent action `chat`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:10173`.

### `smarthome_command_plan`

Namespace: `smarthome`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
smarthome_command_plan(message: str='', inputs: str='{}') -> str
~~~


Run the smarthome domain agent action `command_plan`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:10217`.

### `smarthome_event_review`

Namespace: `smarthome`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
smarthome_event_review(message: str='', inputs: str='{}') -> str
~~~


Run the smarthome domain agent action `event_review`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:10239`.

### `smarthome_plan_domain_intelligence`

Namespace: `smarthome`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
smarthome_plan_domain_intelligence(message: str='', inputs: str='{}') -> str
~~~


Run the smarthome domain agent action `plan_domain_intelligence`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:10305`.

### `smarthome_scene_assist`

Namespace: `smarthome`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
smarthome_scene_assist(message: str='', inputs: str='{}') -> str
~~~


Run the smarthome domain agent action `scene_assist`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:10283`.

### `smarthome_status_report`

Namespace: `smarthome`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
smarthome_status_report(message: str='', inputs: str='{}') -> str
~~~


Run the smarthome domain agent action `status_report`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:10195`.

### `smokeball_add_layout_contact`

Namespace: `smokeball`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
smokeball_add_layout_contact(arguments: str='{}') -> str
~~~


Smokeball connector operation `add_layout_contact` (platform tool `smokeball.add_layout_contact`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:19588`.

### `smokeball_api_request`

Namespace: `smokeball`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
smokeball_api_request(arguments: str='{}') -> str
~~~


Smokeball connector operation `api_request` (platform tool `smokeball.api_request`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:19609`.

### `smokeball_create_bill`

Namespace: `smokeball`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
smokeball_create_bill(arguments: str='{}') -> str
~~~


Smokeball connector operation `create_bill` (platform tool `smokeball.create_bill`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:19630`.

### `smokeball_create_contact`

Namespace: `smokeball`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
smokeball_create_contact(arguments: str='{}') -> str
~~~


Smokeball connector operation `create_contact` (platform tool `smokeball.create_contact`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:19651`.

### `smokeball_create_file_upload`

Namespace: `smokeball`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
smokeball_create_file_upload(arguments: str='{}') -> str
~~~


Smokeball connector operation `create_file_upload` (platform tool `smokeball.create_file_upload`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:19672`.

### `smokeball_create_folder`

Namespace: `smokeball`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
smokeball_create_folder(arguments: str='{}') -> str
~~~


Smokeball connector operation `create_folder` (platform tool `smokeball.create_folder`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:19693`.

### `smokeball_create_layout`

Namespace: `smokeball`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
smokeball_create_layout(arguments: str='{}') -> str
~~~


Smokeball connector operation `create_layout` (platform tool `smokeball.create_layout`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:19714`.

### `smokeball_create_lead`

Namespace: `smokeball`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
smokeball_create_lead(arguments: str='{}') -> str
~~~


Smokeball connector operation `create_lead` (platform tool `smokeball.create_lead`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:19735`.

### `smokeball_create_matter`

Namespace: `smokeball`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
smokeball_create_matter(arguments: str='{}') -> str
~~~


Smokeball connector operation `create_matter` (platform tool `smokeball.create_matter`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:19756`.

### `smokeball_create_task`

Namespace: `smokeball`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
smokeball_create_task(arguments: str='{}') -> str
~~~


Smokeball connector operation `create_task` (platform tool `smokeball.create_task`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:19777`.

### `smokeball_create_time_entry`

Namespace: `smokeball`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
smokeball_create_time_entry(arguments: str='{}') -> str
~~~


Smokeball connector operation `create_time_entry` (platform tool `smokeball.create_time_entry`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:19798`.

### `smokeball_delete_layout`

Namespace: `smokeball`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
smokeball_delete_layout(arguments: str='{}') -> str
~~~


Smokeball connector operation `delete_layout` (platform tool `smokeball.delete_layout`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:19819`.

### `smokeball_get_contact`

Namespace: `smokeball`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
smokeball_get_contact(arguments: str='{}') -> str
~~~


Smokeball connector operation `get_contact` (platform tool `smokeball.get_contact`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:19840`.

### `smokeball_get_file`

Namespace: `smokeball`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
smokeball_get_file(arguments: str='{}') -> str
~~~


Smokeball connector operation `get_file` (platform tool `smokeball.get_file`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:19861`.

### `smokeball_get_file_download_url`

Namespace: `smokeball`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
smokeball_get_file_download_url(arguments: str='{}') -> str
~~~


Smokeball connector operation `get_file_download_url` (platform tool `smokeball.get_file_download_url`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:19882`.

### `smokeball_get_file_upload_url`

Namespace: `smokeball`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
smokeball_get_file_upload_url(arguments: str='{}') -> str
~~~


Smokeball connector operation `get_file_upload_url` (platform tool `smokeball.get_file_upload_url`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:19903`.

### `smokeball_get_layout`

Namespace: `smokeball`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
smokeball_get_layout(arguments: str='{}') -> str
~~~


Smokeball connector operation `get_layout` (platform tool `smokeball.get_layout`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:19924`.

### `smokeball_get_layout_contacts`

Namespace: `smokeball`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
smokeball_get_layout_contacts(arguments: str='{}') -> str
~~~


Smokeball connector operation `get_layout_contacts` (platform tool `smokeball.get_layout_contacts`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:19945`.

### `smokeball_get_layout_design`

Namespace: `smokeball`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
smokeball_get_layout_design(arguments: str='{}') -> str
~~~


Smokeball connector operation `get_layout_design` (platform tool `smokeball.get_layout_design`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:19966`.

### `smokeball_get_matter`

Namespace: `smokeball`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
smokeball_get_matter(arguments: str='{}') -> str
~~~


Smokeball connector operation `get_matter` (platform tool `smokeball.get_matter`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:19987`.

### `smokeball_get_matter_items`

Namespace: `smokeball`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
smokeball_get_matter_items(arguments: str='{}') -> str
~~~


Smokeball connector operation `get_matter_items` (platform tool `smokeball.get_matter_items`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:20008`.

### `smokeball_get_matter_type`

Namespace: `smokeball`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
smokeball_get_matter_type(arguments: str='{}') -> str
~~~


Smokeball connector operation `get_matter_type` (platform tool `smokeball.get_matter_type`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:20029`.

### `smokeball_integrated_search`

Namespace: `smokeball`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
smokeball_integrated_search(arguments: str='{}') -> str
~~~


Smokeball connector operation `integrated_search` (platform tool `smokeball.integrated_search`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:20050`.

### `smokeball_list_activities`

Namespace: `smokeball`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
smokeball_list_activities(arguments: str='{}') -> str
~~~


Smokeball connector operation `list_activities` (platform tool `smokeball.list_activities`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:20071`.

### `smokeball_list_bills`

Namespace: `smokeball`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
smokeball_list_bills(arguments: str='{}') -> str
~~~


Smokeball connector operation `list_bills` (platform tool `smokeball.list_bills`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:20092`.

### `smokeball_list_contacts`

Namespace: `smokeball`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
smokeball_list_contacts(arguments: str='{}') -> str
~~~


Smokeball connector operation `list_contacts` (platform tool `smokeball.list_contacts`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:20113`.

### `smokeball_list_files`

Namespace: `smokeball`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
smokeball_list_files(arguments: str='{}') -> str
~~~


Smokeball connector operation `list_files` (platform tool `smokeball.list_files`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:20134`.

### `smokeball_list_folders`

Namespace: `smokeball`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
smokeball_list_folders(arguments: str='{}') -> str
~~~


Smokeball connector operation `list_folders` (platform tool `smokeball.list_folders`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:20155`.

### `smokeball_list_layouts`

Namespace: `smokeball`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
smokeball_list_layouts(arguments: str='{}') -> str
~~~


Smokeball connector operation `list_layouts` (platform tool `smokeball.list_layouts`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:20176`.

### `smokeball_list_leads`

Namespace: `smokeball`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
smokeball_list_leads(arguments: str='{}') -> str
~~~


Smokeball connector operation `list_leads` (platform tool `smokeball.list_leads`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:20197`.

### `smokeball_list_matter_types`

Namespace: `smokeball`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
smokeball_list_matter_types(arguments: str='{}') -> str
~~~


Smokeball connector operation `list_matter_types` (platform tool `smokeball.list_matter_types`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:20218`.

### `smokeball_list_matters`

Namespace: `smokeball`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
smokeball_list_matters(arguments: str='{}') -> str
~~~


Smokeball connector operation `list_matters` (platform tool `smokeball.list_matters`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:20239`.

### `smokeball_list_staff`

Namespace: `smokeball`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
smokeball_list_staff(arguments: str='{}') -> str
~~~


Smokeball connector operation `list_staff` (platform tool `smokeball.list_staff`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:20260`.

### `smokeball_list_tasks`

Namespace: `smokeball`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
smokeball_list_tasks(arguments: str='{}') -> str
~~~


Smokeball connector operation `list_tasks` (platform tool `smokeball.list_tasks`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:20281`.

### `smokeball_list_time_entries`

Namespace: `smokeball`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
smokeball_list_time_entries(arguments: str='{}') -> str
~~~


Smokeball connector operation `list_time_entries` (platform tool `smokeball.list_time_entries`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:20302`.

### `smokeball_request`

Namespace: `smokeball`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
smokeball_request(arguments: str='{}') -> str
~~~


Smokeball connector operation `request` (platform tool `smokeball.request`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:20323`.

### `smokeball_search`

Namespace: `smokeball`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
smokeball_search(arguments: str='{}') -> str
~~~


Smokeball connector operation `search` (platform tool `smokeball.search`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:20344`.

### `smokeball_update_layout`

Namespace: `smokeball`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
smokeball_update_layout(arguments: str='{}') -> str
~~~


Smokeball connector operation `update_layout` (platform tool `smokeball.update_layout`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:20365`.

### `smokeball_update_matter`

Namespace: `smokeball`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
smokeball_update_matter(arguments: str='{}') -> str
~~~


Smokeball connector operation `update_matter` (platform tool `smokeball.update_matter`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:20386`.

### `solver_assign_resources`

Namespace: `solver`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
solver_assign_resources(message: str='', inputs: str='{}') -> str
~~~


Run the solver domain agent action `assign_resources`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:10393`.

### `solver_chat`

Namespace: `solver`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
solver_chat(message: str='', inputs: str='{}') -> str
~~~


Run the solver domain agent action `chat`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:10327`.

### `solver_constraint_satisfaction`

Namespace: `solver`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
solver_constraint_satisfaction(message: str='', inputs: str='{}') -> str
~~~


Run the solver domain agent action `constraint_satisfaction`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:10415`.

### `solver_plan_domain_intelligence`

Namespace: `solver`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
solver_plan_domain_intelligence(message: str='', inputs: str='{}') -> str
~~~


Run the solver domain agent action `plan_domain_intelligence`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:10437`.

### `solver_schedule_optimization`

Namespace: `solver`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
solver_schedule_optimization(message: str='', inputs: str='{}') -> str
~~~


Run the solver domain agent action `schedule_optimization`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:10371`.

### `solver_solve_optimization`

Namespace: `solver`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
solver_solve_optimization(message: str='', inputs: str='{}') -> str
~~~


Run the solver domain agent action `solve_optimization`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:10349`.

### `square_create_invoice`

Namespace: `square`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
square_create_invoice(arguments: str='{}') -> str
~~~


Square connector operation `create_invoice` (platform tool `square.create_invoice`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:20407`.

### `square_create_refund`

Namespace: `square`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
square_create_refund(arguments: str='{}') -> str
~~~


Square connector operation `create_refund` (platform tool `square.create_refund`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:20428`.

### `square_get_catalog_item`

Namespace: `square`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
square_get_catalog_item(arguments: str='{}') -> str
~~~


Square connector operation `get_catalog_item` (platform tool `square.get_catalog_item`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:20449`.

### `square_get_inventory`

Namespace: `square`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
square_get_inventory(catalog_object_ids: Optional[list[str]]=None, location_ids: Optional[list[str]]=None) -> str
~~~


Fetch Square inventory counts for one or more catalog items.

Args:
    catalog_object_ids (required): Catalog object IDs to fetch inventory counts for.
    location_ids: Optional location IDs to restrict counts to.

Source: `lightbulb/mcp_generated_tools.py:20470`.

### `square_get_order`

Namespace: `square`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
square_get_order(arguments: str='{}') -> str
~~~


Square connector operation `get_order` (platform tool `square.get_order`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:20489`.

### `square_get_payment`

Namespace: `square`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
square_get_payment(arguments: str='{}') -> str
~~~


Square connector operation `get_payment` (platform tool `square.get_payment`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:20510`.

### `square_list_appointments`

Namespace: `square`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
square_list_appointments(arguments: str='{}') -> str
~~~


Square connector operation `list_appointments` (platform tool `square.list_appointments`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:20531`.

### `square_list_customers`

Namespace: `square`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
square_list_customers(limit: int=100, cursor: Optional[str]=None) -> str
~~~


List customers in the connected Square account.

Args:
    limit: Maximum customers to return.
    cursor: Pagination cursor from a previous response.

Source: `lightbulb/mcp_generated_tools.py:20552`.

### `square_list_locations`

Namespace: `square`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
square_list_locations(arguments: str='{}') -> str
~~~


Square connector operation `list_locations` (platform tool `square.list_locations`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:20571`.

### `square_list_payments`

Namespace: `square`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
square_list_payments(from_date: Optional[str]=None, to_date: Optional[str]=None, location_id: Optional[str]=None) -> str
~~~


List Square payments for the connected merchant account.

Args:
    from_date: Begin time (RFC 3339).
    to_date: End time (RFC 3339).
    location_id: Filter to a specific location.

Source: `lightbulb/mcp_generated_tools.py:20592`.

### `square_list_payouts`

Namespace: `square`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
square_list_payouts(arguments: str='{}') -> str
~~~


Square connector operation `list_payouts` (platform tool `square.list_payouts`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:20614`.

### `square_list_refunds`

Namespace: `square`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
square_list_refunds(arguments: str='{}') -> str
~~~


Square connector operation `list_refunds` (platform tool `square.list_refunds`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:20635`.

### `square_search_catalog`

Namespace: `square`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
square_search_catalog(object_types: Optional[list[str]]=None, query: Optional[str]=None, limit: int=100) -> str
~~~


Search the Square catalog (items, variations, categories).

Args:
    object_types: Catalog object types to include (e.g. ['ITEM', 'ITEM_VARIATION']).
    query: Free-text search query.
    limit: Maximum objects to return.

Source: `lightbulb/mcp_generated_tools.py:20656`.

### `square_search_orders`

Namespace: `square`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
square_search_orders(location_id: Optional[str]=None, state: Optional[str]=None, start_date: Optional[str]=None, end_date: Optional[str]=None, limit: int=50) -> str
~~~


Search Square orders by location, status, or date range.

Args:
    location_id: Square location ID.
    state: Order state filter: OPEN, COMPLETED, or CANCELED.
    start_date: Created at or after (RFC 3339).
    end_date: Created at or before (RFC 3339).
    limit: Maximum orders to return.

Source: `lightbulb/mcp_generated_tools.py:20678`.

### `stripe_create_invoice`

Namespace: `stripe`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
stripe_create_invoice(arguments: str='{}') -> str
~~~


Stripe connector operation `create_invoice` (platform tool `stripe.create_invoice`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:20706`.

### `stripe_create_refund`

Namespace: `stripe`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
stripe_create_refund(arguments: str='{}') -> str
~~~


Stripe connector operation `create_refund` (platform tool `stripe.create_refund`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:20727`.

### `stripe_get_invoice`

Namespace: `stripe`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
stripe_get_invoice(arguments: str='{}') -> str
~~~


Stripe connector operation `get_invoice` (platform tool `stripe.get_invoice`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:20748`.

### `stripe_list_balance_transactions`

Namespace: `stripe`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
stripe_list_balance_transactions(arguments: str='{}') -> str
~~~


Stripe connector operation `list_balance_transactions` (platform tool `stripe.list_balance_transactions`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:20769`.

### `stripe_list_charges`

Namespace: `stripe`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
stripe_list_charges(customer_id: Optional[str]=None, from_date: Optional[str]=None, limit: int=100) -> str
~~~


List recent Stripe charges.

Args:
    customer_id: Stripe customer ID to filter by.
    from_date: Start date (YYYY-MM-DD).
    limit:

Source: `lightbulb/mcp_generated_tools.py:20790`.

### `stripe_list_customers`

Namespace: `stripe`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
stripe_list_customers(email: Optional[str]=None, limit: int=100) -> str
~~~


List Stripe customers.

Args:
    email: Filter by exact email.
    limit:

Source: `lightbulb/mcp_generated_tools.py:20812`.

### `stripe_list_invoices`

Namespace: `stripe`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
stripe_list_invoices(customer_id: Optional[str]=None, status: Optional[str]=None, limit: int=100) -> str
~~~


List Stripe invoices, optionally scoped to a customer.

Args:
    customer_id: Stripe customer ID.
    status: One of: draft, open, paid, uncollectible, void.
    limit:

Source: `lightbulb/mcp_generated_tools.py:20831`.

### `stripe_list_payouts`

Namespace: `stripe`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
stripe_list_payouts(arguments: str='{}') -> str
~~~


Stripe connector operation `list_payouts` (platform tool `stripe.list_payouts`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:20853`.

### `teams_post_channel_message`

Namespace: `teams`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
teams_post_channel_message(arguments: str='{}') -> str
~~~


Teams connector operation `post_channel_message` (platform tool `teams.post_channel_message`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:20874`.

### `teams_post_chat_message`

Namespace: `teams`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
teams_post_chat_message(arguments: str='{}') -> str
~~~


Teams connector operation `post_chat_message` (platform tool `teams.post_chat_message`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:20895`.

### `wealth_advisory_chat`

Namespace: `wealth_advisory`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
wealth_advisory_chat(message: str='', inputs: str='{}') -> str
~~~


Run the wealth_advisory domain agent action `chat`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:10459`.

### `wealth_advisory_plan_domain_intelligence`

Namespace: `wealth_advisory`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
wealth_advisory_plan_domain_intelligence(message: str='', inputs: str='{}') -> str
~~~


Run the wealth_advisory domain agent action `plan_domain_intelligence`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:10591`.

### `wealth_advisory_wealth_kyc_risk_intake`

Namespace: `wealth_advisory`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
wealth_advisory_wealth_kyc_risk_intake(message: str='', inputs: str='{}') -> str
~~~


Run the wealth_advisory domain agent action `wealth_kyc_risk_intake`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:10481`.

### `wealth_advisory_wealth_monte_carlo_retirement`

Namespace: `wealth_advisory`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
wealth_advisory_wealth_monte_carlo_retirement(message: str='', inputs: str='{}') -> str
~~~


Run the wealth_advisory domain agent action `wealth_monte_carlo_retirement`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:10569`.

### `wealth_advisory_wealth_portfolio_drift`

Namespace: `wealth_advisory`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
wealth_advisory_wealth_portfolio_drift(message: str='', inputs: str='{}') -> str
~~~


Run the wealth_advisory domain agent action `wealth_portfolio_drift`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:10503`.

### `wealth_advisory_wealth_retirement_withdrawal`

Namespace: `wealth_advisory`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
wealth_advisory_wealth_retirement_withdrawal(message: str='', inputs: str='{}') -> str
~~~


Run the wealth_advisory domain agent action `wealth_retirement_withdrawal`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:10547`.

### `wealth_advisory_wealth_tax_loss_harvest`

Namespace: `wealth_advisory`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
wealth_advisory_wealth_tax_loss_harvest(message: str='', inputs: str='{}') -> str
~~~


Run the wealth_advisory domain agent action `wealth_tax_loss_harvest`.

Routes through the platform's domain-agent dispatcher under your JWT,
tenant, and company scope.

Args:
    message: Free-text objective for the action.
    inputs: Optional JSON string of structured inputs for the action.

Source: `lightbulb/mcp_generated_tools.py:10525`.

### `xero_aged_payable_report`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_aged_payable_report(arguments: str='{}') -> str
~~~


Xero connector operation `aged_payable_report` (platform tool `xero.aged_payable_report`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:20916`.

### `xero_aged_receivable_report`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_aged_receivable_report(arguments: str='{}') -> str
~~~


Xero connector operation `aged_receivable_report` (platform tool `xero.aged_receivable_report`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:20937`.

### `xero_api_request`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_api_request(arguments: str='{}') -> str
~~~


Xero connector operation `api_request` (platform tool `xero.api_request`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:20958`.

### `xero_approve_payroll_au_timesheet`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_approve_payroll_au_timesheet(arguments: str='{}') -> str
~~~


Xero connector operation `approve_payroll_au_timesheet` (platform tool `xero.approve_payroll_au_timesheet`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:20979`.

### `xero_balance_sheet_report`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_balance_sheet_report(arguments: str='{}') -> str
~~~


Xero connector operation `balance_sheet_report` (platform tool `xero.balance_sheet_report`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:21000`.

### `xero_bank_summary_report`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_bank_summary_report(arguments: str='{}') -> str
~~~


Xero connector operation `bank_summary_report` (platform tool `xero.bank_summary_report`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:21021`.

### `xero_bas_report`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_bas_report(arguments: str='{}') -> str
~~~


Xero connector operation `bas_report` (platform tool `xero.bas_report`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:21042`.

### `xero_book_depreciation`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_book_depreciation(arguments: str='{}') -> str
~~~


Xero connector operation `book_depreciation` (platform tool `xero.book_depreciation`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:21063`.

### `xero_budget_summary_report`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_budget_summary_report(arguments: str='{}') -> str
~~~


Xero connector operation `budget_summary_report` (platform tool `xero.budget_summary_report`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:21084`.

### `xero_cash_flow_report`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_cash_flow_report(arguments: str='{}') -> str
~~~


Xero connector operation `cash_flow_report` (platform tool `xero.cash_flow_report`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:21105`.

### `xero_create_asset`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_create_asset(arguments: str='{}') -> str
~~~


Xero connector operation `create_asset` (platform tool `xero.create_asset`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:21126`.

### `xero_create_association`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_create_association(arguments: str='{}') -> str
~~~


Xero connector operation `create_association` (platform tool `xero.create_association`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:21147`.

### `xero_create_bank_transaction`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_create_bank_transaction(arguments: str='{}') -> str
~~~


Xero connector operation `create_bank_transaction` (platform tool `xero.create_bank_transaction`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:21168`.

### `xero_create_bill`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_create_bill(arguments: str='{}') -> str
~~~


Xero connector operation `create_bill` (platform tool `xero.create_bill`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:21189`.

### `xero_create_contact`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_create_contact(arguments: str='{}') -> str
~~~


Xero connector operation `create_contact` (platform tool `xero.create_contact`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:21210`.

### `xero_create_credit_note`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_create_credit_note(arguments: str='{}') -> str
~~~


Xero connector operation `create_credit_note` (platform tool `xero.create_credit_note`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:21231`.

### `xero_create_expense_claim`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_create_expense_claim(arguments: str='{}') -> str
~~~


Xero connector operation `create_expense_claim` (platform tool `xero.create_expense_claim`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:21252`.

### `xero_create_feed_connection`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_create_feed_connection(arguments: str='{}') -> str
~~~


Xero connector operation `create_feed_connection` (platform tool `xero.create_feed_connection`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:21273`.

### `xero_create_folder`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_create_folder(arguments: str='{}') -> str
~~~


Xero connector operation `create_folder` (platform tool `xero.create_folder`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:21294`.

### `xero_create_history_note`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_create_history_note(arguments: str='{}') -> str
~~~


Xero connector operation `create_history_note` (platform tool `xero.create_history_note`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:21315`.

### `xero_create_invoice`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_create_invoice(contact_id: Optional[str]=None, line_items: Optional[list[str]]=None, due_date: Optional[str]=None, reference: Optional[str]=None) -> str
~~~


Create a draft invoice in Xero. Use the contact ID from xero.list_contacts; line items reference Xero account codes.

Args:
    contact_id (required): Xero contact ID.
    line_items (required): JSON-string list of line items: [{description, quantity, unit_amount, account_code}].
    due_date: Due date (YYYY-MM-DD).
    reference: Customer-facing invoice reference.

Source: `lightbulb/mcp_generated_tools.py:21336`.

### `xero_create_item`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_create_item(arguments: str='{}') -> str
~~~


Xero connector operation `create_item` (platform tool `xero.create_item`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:21361`.

### `xero_create_manual_journal`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_create_manual_journal(arguments: str='{}') -> str
~~~


Xero connector operation `create_manual_journal` (platform tool `xero.create_manual_journal`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:21382`.

### `xero_create_payment`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_create_payment(arguments: str='{}') -> str
~~~


Xero connector operation `create_payment` (platform tool `xero.create_payment`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:21403`.

### `xero_create_payroll_au_timesheet`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_create_payroll_au_timesheet(arguments: str='{}') -> str
~~~


Xero connector operation `create_payroll_au_timesheet` (platform tool `xero.create_payroll_au_timesheet`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:21424`.

### `xero_create_project`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_create_project(arguments: str='{}') -> str
~~~


Xero connector operation `create_project` (platform tool `xero.create_project`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:21445`.

### `xero_create_purchase_order`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_create_purchase_order(arguments: str='{}') -> str
~~~


Xero connector operation `create_purchase_order` (platform tool `xero.create_purchase_order`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:21466`.

### `xero_create_quote`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_create_quote(arguments: str='{}') -> str
~~~


Xero connector operation `create_quote` (platform tool `xero.create_quote`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:21487`.

### `xero_create_receipt`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_create_receipt(arguments: str='{}') -> str
~~~


Xero connector operation `create_receipt` (platform tool `xero.create_receipt`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:21508`.

### `xero_create_repeating_invoice`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_create_repeating_invoice(arguments: str='{}') -> str
~~~


Xero connector operation `create_repeating_invoice` (platform tool `xero.create_repeating_invoice`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:21529`.

### `xero_create_statement`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_create_statement(arguments: str='{}') -> str
~~~


Xero connector operation `create_statement` (platform tool `xero.create_statement`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:21550`.

### `xero_create_task`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_create_task(arguments: str='{}') -> str
~~~


Xero connector operation `create_task` (platform tool `xero.create_task`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:21571`.

### `xero_create_time_entry`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_create_time_entry(arguments: str='{}') -> str
~~~


Xero connector operation `create_time_entry` (platform tool `xero.create_time_entry`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:21592`.

### `xero_create_tracking_category`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_create_tracking_category(arguments: str='{}') -> str
~~~


Xero connector operation `create_tracking_category` (platform tool `xero.create_tracking_category`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:21613`.

### `xero_create_tracking_option`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_create_tracking_option(arguments: str='{}') -> str
~~~


Xero connector operation `create_tracking_option` (platform tool `xero.create_tracking_option`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:21634`.

### `xero_delete_feed_connection`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_delete_feed_connection(arguments: str='{}') -> str
~~~


Xero connector operation `delete_feed_connection` (platform tool `xero.delete_feed_connection`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:21655`.

### `xero_dispose_asset`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_dispose_asset(arguments: str='{}') -> str
~~~


Xero connector operation `dispose_asset` (platform tool `xero.dispose_asset`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:21676`.

### `xero_executive_summary_report`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_executive_summary_report(arguments: str='{}') -> str
~~~


Xero connector operation `executive_summary_report` (platform tool `xero.executive_summary_report`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:21697`.

### `xero_get_asset`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_get_asset(arguments: str='{}') -> str
~~~


Xero connector operation `get_asset` (platform tool `xero.get_asset`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:21718`.

### `xero_get_attachment`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_get_attachment(arguments: str='{}') -> str
~~~


Xero connector operation `get_attachment` (platform tool `xero.get_attachment`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:21739`.

### `xero_get_budget`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_get_budget(arguments: str='{}') -> str
~~~


Xero connector operation `get_budget` (platform tool `xero.get_budget`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:21760`.

### `xero_get_file`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_get_file(arguments: str='{}') -> str
~~~


Xero connector operation `get_file` (platform tool `xero.get_file`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:21781`.

### `xero_get_invoice`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_get_invoice(arguments: str='{}') -> str
~~~


Xero connector operation `get_invoice` (platform tool `xero.get_invoice`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:21802`.

### `xero_get_organisation`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_get_organisation(arguments: str='{}') -> str
~~~


Xero connector operation `get_organisation` (platform tool `xero.get_organisation`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:21823`.

### `xero_get_payroll_au_timesheet`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_get_payroll_au_timesheet(arguments: str='{}') -> str
~~~


Xero connector operation `get_payroll_au_timesheet` (platform tool `xero.get_payroll_au_timesheet`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:21844`.

### `xero_get_project`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_get_project(arguments: str='{}') -> str
~~~


Xero connector operation `get_project` (platform tool `xero.get_project`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:21865`.

### `xero_get_purchase_order`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_get_purchase_order(arguments: str='{}') -> str
~~~


Xero connector operation `get_purchase_order` (platform tool `xero.get_purchase_order`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:21886`.

### `xero_gst_report`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_gst_report(arguments: str='{}') -> str
~~~


Xero connector operation `gst_report` (platform tool `xero.gst_report`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:21907`.

### `xero_list_accounts`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_list_accounts(arguments: str='{}') -> str
~~~


Xero connector operation `list_accounts` (platform tool `xero.list_accounts`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:21928`.

### `xero_list_asset_types`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_list_asset_types(arguments: str='{}') -> str
~~~


Xero connector operation `list_asset_types` (platform tool `xero.list_asset_types`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:21949`.

### `xero_list_assets`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_list_assets(arguments: str='{}') -> str
~~~


Xero connector operation `list_assets` (platform tool `xero.list_assets`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:21970`.

### `xero_list_associations`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_list_associations(arguments: str='{}') -> str
~~~


Xero connector operation `list_associations` (platform tool `xero.list_associations`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:21991`.

### `xero_list_attachments`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_list_attachments(arguments: str='{}') -> str
~~~


Xero connector operation `list_attachments` (platform tool `xero.list_attachments`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:22012`.

### `xero_list_bank_transactions`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_list_bank_transactions(bank_account_id: Optional[str]=None, from_date: Optional[str]=None, to_date: Optional[str]=None) -> str
~~~


List bank-feed transactions on a Xero bank account.

Args:
    bank_account_id (required): Xero bank account ID.
    from_date: Start date (YYYY-MM-DD).
    to_date: End date (YYYY-MM-DD).

Source: `lightbulb/mcp_generated_tools.py:22033`.

### `xero_list_branding_themes`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_list_branding_themes(arguments: str='{}') -> str
~~~


Xero connector operation `list_branding_themes` (platform tool `xero.list_branding_themes`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:22055`.

### `xero_list_budgets`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_list_budgets(arguments: str='{}') -> str
~~~


Xero connector operation `list_budgets` (platform tool `xero.list_budgets`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:22076`.

### `xero_list_contact_groups`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_list_contact_groups(arguments: str='{}') -> str
~~~


Xero connector operation `list_contact_groups` (platform tool `xero.list_contact_groups`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:22097`.

### `xero_list_contacts`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_list_contacts(arguments: str='{}') -> str
~~~


Xero connector operation `list_contacts` (platform tool `xero.list_contacts`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:22118`.

### `xero_list_credit_notes`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_list_credit_notes(arguments: str='{}') -> str
~~~


Xero connector operation `list_credit_notes` (platform tool `xero.list_credit_notes`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:22139`.

### `xero_list_currencies`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_list_currencies(arguments: str='{}') -> str
~~~


Xero connector operation `list_currencies` (platform tool `xero.list_currencies`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:22160`.

### `xero_list_employees_accounting`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_list_employees_accounting(arguments: str='{}') -> str
~~~


Xero connector operation `list_employees_accounting` (platform tool `xero.list_employees_accounting`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:22181`.

### `xero_list_expense_claims`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_list_expense_claims(arguments: str='{}') -> str
~~~


Xero connector operation `list_expense_claims` (platform tool `xero.list_expense_claims`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:22202`.

### `xero_list_feed_connections`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_list_feed_connections(arguments: str='{}') -> str
~~~


Xero connector operation `list_feed_connections` (platform tool `xero.list_feed_connections`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:22223`.

### `xero_list_files`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_list_files(arguments: str='{}') -> str
~~~


Xero connector operation `list_files` (platform tool `xero.list_files`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:22244`.

### `xero_list_folders`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_list_folders(arguments: str='{}') -> str
~~~


Xero connector operation `list_folders` (platform tool `xero.list_folders`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:22265`.

### `xero_list_history`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_list_history(arguments: str='{}') -> str
~~~


Xero connector operation `list_history` (platform tool `xero.list_history`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:22286`.

### `xero_list_invoices`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_list_invoices(status: Optional[str]=None, contact_id: Optional[str]=None, from_date: Optional[str]=None, to_date: Optional[str]=None) -> str
~~~


List invoices in the connected Xero organisation. Supports filtering by status, contact, and date range.

Args:
    status: One of: DRAFT, SUBMITTED, AUTHORISED, PAID, VOIDED.
    contact_id: Filter to a specific Xero contact ID.
    from_date: Start of date range (YYYY-MM-DD).
    to_date: End of date range (YYYY-MM-DD).

Source: `lightbulb/mcp_generated_tools.py:22307`.

### `xero_list_items`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_list_items(arguments: str='{}') -> str
~~~


Xero connector operation `list_items` (platform tool `xero.list_items`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:22332`.

### `xero_list_linked_transactions`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_list_linked_transactions(arguments: str='{}') -> str
~~~


Xero connector operation `list_linked_transactions` (platform tool `xero.list_linked_transactions`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:22353`.

### `xero_list_manual_journals`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_list_manual_journals(arguments: str='{}') -> str
~~~


Xero connector operation `list_manual_journals` (platform tool `xero.list_manual_journals`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:22374`.

### `xero_list_overpayments`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_list_overpayments(arguments: str='{}') -> str
~~~


Xero connector operation `list_overpayments` (platform tool `xero.list_overpayments`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:22395`.

### `xero_list_payments`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_list_payments(arguments: str='{}') -> str
~~~


Xero connector operation `list_payments` (platform tool `xero.list_payments`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:22416`.

### `xero_list_payroll_au_employee_leave`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_list_payroll_au_employee_leave(arguments: str='{}') -> str
~~~


Xero connector operation `list_payroll_au_employee_leave` (platform tool `xero.list_payroll_au_employee_leave`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:22437`.

### `xero_list_payroll_au_employee_leave_balances`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_list_payroll_au_employee_leave_balances(arguments: str='{}') -> str
~~~


Xero connector operation `list_payroll_au_employee_leave_balances` (platform tool `xero.list_payroll_au_employee_leave_balances`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:22458`.

### `xero_list_payroll_au_employees`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_list_payroll_au_employees(arguments: str='{}') -> str
~~~


Xero connector operation `list_payroll_au_employees` (platform tool `xero.list_payroll_au_employees`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:22479`.

### `xero_list_payroll_au_leave_periods`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_list_payroll_au_leave_periods(arguments: str='{}') -> str
~~~


Xero connector operation `list_payroll_au_leave_periods` (platform tool `xero.list_payroll_au_leave_periods`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:22500`.

### `xero_list_payroll_au_leave_types`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_list_payroll_au_leave_types(arguments: str='{}') -> str
~~~


Xero connector operation `list_payroll_au_leave_types` (platform tool `xero.list_payroll_au_leave_types`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:22521`.

### `xero_list_payroll_au_payitems`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_list_payroll_au_payitems(arguments: str='{}') -> str
~~~


Xero connector operation `list_payroll_au_payitems` (platform tool `xero.list_payroll_au_payitems`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:22542`.

### `xero_list_payroll_au_payruns`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_list_payroll_au_payruns(arguments: str='{}') -> str
~~~


Xero connector operation `list_payroll_au_payruns` (platform tool `xero.list_payroll_au_payruns`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:22563`.

### `xero_list_payroll_au_superfunds`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_list_payroll_au_superfunds(arguments: str='{}') -> str
~~~


Xero connector operation `list_payroll_au_superfunds` (platform tool `xero.list_payroll_au_superfunds`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:22584`.

### `xero_list_payroll_au_timesheets`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_list_payroll_au_timesheets(arguments: str='{}') -> str
~~~


Xero connector operation `list_payroll_au_timesheets` (platform tool `xero.list_payroll_au_timesheets`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:22605`.

### `xero_list_prepayments`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_list_prepayments(arguments: str='{}') -> str
~~~


Xero connector operation `list_prepayments` (platform tool `xero.list_prepayments`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:22626`.

### `xero_list_project_users`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_list_project_users(arguments: str='{}') -> str
~~~


Xero connector operation `list_project_users` (platform tool `xero.list_project_users`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:22647`.

### `xero_list_projects`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_list_projects(arguments: str='{}') -> str
~~~


Xero connector operation `list_projects` (platform tool `xero.list_projects`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:22668`.

### `xero_list_purchase_orders`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_list_purchase_orders(arguments: str='{}') -> str
~~~


Xero connector operation `list_purchase_orders` (platform tool `xero.list_purchase_orders`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:22689`.

### `xero_list_quotes`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_list_quotes(arguments: str='{}') -> str
~~~


Xero connector operation `list_quotes` (platform tool `xero.list_quotes`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:22710`.

### `xero_list_receipts`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_list_receipts(arguments: str='{}') -> str
~~~


Xero connector operation `list_receipts` (platform tool `xero.list_receipts`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:22731`.

### `xero_list_repeating_invoices`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_list_repeating_invoices(arguments: str='{}') -> str
~~~


Xero connector operation `list_repeating_invoices` (platform tool `xero.list_repeating_invoices`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:22752`.

### `xero_list_statements`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_list_statements(arguments: str='{}') -> str
~~~


Xero connector operation `list_statements` (platform tool `xero.list_statements`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:22773`.

### `xero_list_tasks`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_list_tasks(arguments: str='{}') -> str
~~~


Xero connector operation `list_tasks` (platform tool `xero.list_tasks`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:22794`.

### `xero_list_tax_rates`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_list_tax_rates(arguments: str='{}') -> str
~~~


Xero connector operation `list_tax_rates` (platform tool `xero.list_tax_rates`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:22815`.

### `xero_list_time_entries`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_list_time_entries(arguments: str='{}') -> str
~~~


Xero connector operation `list_time_entries` (platform tool `xero.list_time_entries`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:22836`.

### `xero_list_tracking_categories`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_list_tracking_categories(arguments: str='{}') -> str
~~~


Xero connector operation `list_tracking_categories` (platform tool `xero.list_tracking_categories`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:22857`.

### `xero_pay_bill`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_pay_bill(arguments: str='{}') -> str
~~~


Xero connector operation `pay_bill` (platform tool `xero.pay_bill`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:22878`.

### `xero_payroll_summary_report`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_payroll_summary_report(arguments: str='{}') -> str
~~~


Xero connector operation `payroll_summary_report` (platform tool `xero.payroll_summary_report`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:22899`.

### `xero_profit_loss_report`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_profit_loss_report(arguments: str='{}') -> str
~~~


Xero connector operation `profit_loss_report` (platform tool `xero.profit_loss_report`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:22920`.

### `xero_revert_payroll_au_timesheet`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_revert_payroll_au_timesheet(arguments: str='{}') -> str
~~~


Xero connector operation `revert_payroll_au_timesheet` (platform tool `xero.revert_payroll_au_timesheet`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:22941`.

### `xero_trial_balance_report`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_trial_balance_report(arguments: str='{}') -> str
~~~


Xero connector operation `trial_balance_report` (platform tool `xero.trial_balance_report`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:22962`.

### `xero_update_asset`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_update_asset(arguments: str='{}') -> str
~~~


Xero connector operation `update_asset` (platform tool `xero.update_asset`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:22983`.

### `xero_update_bank_transaction`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_update_bank_transaction(arguments: str='{}') -> str
~~~


Xero connector operation `update_bank_transaction` (platform tool `xero.update_bank_transaction`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:23004`.

### `xero_update_contact`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_update_contact(arguments: str='{}') -> str
~~~


Xero connector operation `update_contact` (platform tool `xero.update_contact`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:23025`.

### `xero_update_credit_note`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_update_credit_note(arguments: str='{}') -> str
~~~


Xero connector operation `update_credit_note` (platform tool `xero.update_credit_note`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:23046`.

### `xero_update_expense_claim`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_update_expense_claim(arguments: str='{}') -> str
~~~


Xero connector operation `update_expense_claim` (platform tool `xero.update_expense_claim`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:23067`.

### `xero_update_invoice`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_update_invoice(arguments: str='{}') -> str
~~~


Xero connector operation `update_invoice` (platform tool `xero.update_invoice`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:23088`.

### `xero_update_item`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_update_item(arguments: str='{}') -> str
~~~


Xero connector operation `update_item` (platform tool `xero.update_item`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:23109`.

### `xero_update_manual_journal`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_update_manual_journal(arguments: str='{}') -> str
~~~


Xero connector operation `update_manual_journal` (platform tool `xero.update_manual_journal`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:23130`.

### `xero_update_project`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_update_project(arguments: str='{}') -> str
~~~


Xero connector operation `update_project` (platform tool `xero.update_project`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:23151`.

### `xero_update_purchase_order`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_update_purchase_order(arguments: str='{}') -> str
~~~


Xero connector operation `update_purchase_order` (platform tool `xero.update_purchase_order`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:23172`.

### `xero_update_quote`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_update_quote(arguments: str='{}') -> str
~~~


Xero connector operation `update_quote` (platform tool `xero.update_quote`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:23193`.

### `xero_update_receipt`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_update_receipt(arguments: str='{}') -> str
~~~


Xero connector operation `update_receipt` (platform tool `xero.update_receipt`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:23214`.

### `xero_update_repeating_invoice`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_update_repeating_invoice(arguments: str='{}') -> str
~~~


Xero connector operation `update_repeating_invoice` (platform tool `xero.update_repeating_invoice`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:23235`.

### `xero_update_tracking_category`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_update_tracking_category(arguments: str='{}') -> str
~~~


Xero connector operation `update_tracking_category` (platform tool `xero.update_tracking_category`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:23256`.

### `xero_update_tracking_options`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_update_tracking_options(arguments: str='{}') -> str
~~~


Xero connector operation `update_tracking_options` (platform tool `xero.update_tracking_options`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:23277`.

### `xero_upload_attachment`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_upload_attachment(arguments: str='{}') -> str
~~~


Xero connector operation `upload_attachment` (platform tool `xero.upload_attachment`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:23298`.

### `xero_upload_file`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_upload_file(arguments: str='{}') -> str
~~~


Xero connector operation `upload_file` (platform tool `xero.upload_file`).

Routes through `/api/tools/invoke` under your JWT, tenant, and company scope.

Args:
    arguments: JSON string of arguments for the connector operation.

Source: `lightbulb/mcp_generated_tools.py:23319`.

# 0.15 release candidate — Lightbulb 0.15.0

Unreleased · default deny

Exact Git revision: `acdf94f90c2ca26076099d16fba9c22fc6a306b9`  
Source-tree SHA-256: `ea7eaffb6089914d757a6552c721342d50f3f4e85fc07f3001c9cd847ddf57cf`

Released-authority manifest: `lightbulb.released_authority_manifest.v2` v2.0.0, digest `14070891292af484c798d35c5a9a1817abed177484a389129b874b6a30a01222`.

Documentation coverage: Full source docstrings: `sdk.modules.lightbulb.sdk`. Bounded source summaries (up to 520 characters): `sdk.syncMethods, sdk.asyncMethods, sdk.modules.legacy, mcp.tools`. Names, signatures, export inventories, counts, and provenance remain complete for this exact revision.

## Surface counts

- Synchronous client methods: 345
- Async client members: 135
- Awaitable async-client methods: 126
- Typed modules: 159
- Typed callable/type symbols: 1772
- Class and resource methods: 1171
- Declared public exports: 2548
- Root package exports: 2537
- Stable SDK facade exports: 11
- Public MCP tools: 1513
- MCP namespaces: 53

## Synchronous Python client

### `__enter__`



~~~python
def __enter__() -> 'LightbulbClient'
~~~


Open the persistent HTTP session and return this client.

Source: `lightbulb/client.py:2668`.

### `__exit__`



~~~python
def __exit__(exc_type: Any, exc: Any, tb: Any) -> None
~~~


Source: `lightbulb/client.py:2673`.

### `activate_marketplace_action`



~~~python
def activate_marketplace_action(installation_id: str, *, idempotency_key: str) -> Dict[str, Any]
~~~


Activate an installed action; this never approves execution policy.

Source: `lightbulb/client.py:8262`.

### `active_company_id`



~~~python
@property
def active_company_id() -> str | None
~~~


The currently selected company context (needed for write operations).

Source: `lightbulb/client.py:2684`.

### `active_company_id`



~~~python
@active_company_id.setter
def active_company_id(value: str | None) -> None
~~~


Source: `lightbulb/client.py:2689`.

### `add_project_coding_harness`



~~~python
def add_project_coding_harness(project_id: str, harness: str, *, make_primary: bool=False) -> Dict[str, Any]
~~~


Attach another harness without removing any existing project harness.

Source: `lightbulb/client.py:2793`.

### `admit_project_learning_run`



~~~python
def admit_project_learning_run(project_id: str, learning_run_id: str, *, runtime: str, capacity_admission: Mapping[str, Any], operator_approved: bool=False, confirm_admission: bool=False, idempotency_key: str | None=None) -> Dict[str, Any]
~~~


Reserve budget and admit a queued run; this still executes no training.

Source: `lightbulb/client.py:4080`.

### `apply_aoc_tick`



~~~python
def apply_aoc_tick(tick_id: str, body: Dict[str, Any] | None=None) -> Dict[str, Any]
~~~


Apply a previously-computed AutoCompany tick (committing its decisions).

Source: `lightbulb/client.py:9570`.

### `apply_code_workspace_proposal`



~~~python
def apply_code_workspace_proposal(workspace_id: str, proposal_id: str) -> Dict[str, Any]
~~~


Apply a previously-submitted proposal to the workspace files.

Source: `lightbulb/client.py:8998`.

### `approve_runtime_domain_action`



~~~python
def approve_runtime_domain_action(runtime_action_id: str, *, project_id: str, company_id: str | None=None) -> Dict[str, Any]
~~~


Approve a reviewed action and return its governed recursive reference.

Source: `lightbulb/client.py:7923`.

### `approve_task`



~~~python
def approve_task(task_id: str, *, comments: str='') -> Dict[str, Any]
~~~


Approve a pending HITL task.

Source: `lightbulb/client.py:6961`.

### `approve_voice_action`



~~~python
def approve_voice_action(execution_id: str, approval_task_id: str, *, comments: str='') -> Dict[str, Any]
~~~


Approve a pending in-call action (e.g. transfer, wire info, commit booking).

Source: `lightbulb/client.py:8613`.

### `archive_marketplace_action`



~~~python
def archive_marketplace_action(listing_id: str, *, idempotency_key: str, reason: str='') -> Dict[str, Any]
~~~


Archive a publisher-owned listing with a replay-safe mutation.

Source: `lightbulb/client.py:8173`.

### `author_agentic_workflow`



~~~python
def author_agentic_workflow(prompt: str, *, name: str | None=None, workflow_type: str | None=None, preferred_domains: List[str] | None=None, include_approval_gates: bool=True, publish: bool=True, company_id: str | None=None, site_project_id: str | None=None, definition: Mapping[str, Any] | None=None) -> Dict[str, Any]
~~~


Compile once, then publish its exact executable projection through governance.

Source: `lightbulb/client.py:6772`.

### `author_workflow_definition`



~~~python
def author_workflow_definition(definition: Mapping[str, Any], *, prompt: str='', name: str | None=None, workflow_type: str | None=None, site_project_id: str | None=None, category: str | None=None, change_notes: str | None=None, company_id: str | None=None) -> Dict[str, Any]
~~~


Publish one exact executable workflow projection through governance.

Source: `lightbulb/client.py:6624`.

### `author_workflow_trigger`



~~~python
def author_workflow_trigger(workflow_definition_id: str, *, trigger_type: str='schedule', schedule: str | None=None, event_type: str | None=None, event_filter: Mapping[str, Any] | None=None, name: str | None=None, description: str | None=None, site_project_id: str | None=None, configuration: Mapping[str, Any] | None=None, enabled: bool=False, company_id: str | None=None) -> Dict[str, Any]
~~~


Create a principal-scoped schedule or event trigger for a workflow.

Source: `lightbulb/client.py:6679`.

### `backbone_execute`



~~~python
def backbone_execute(objective: str, *, inputs: Dict[str, Any] | None=None) -> Dict[str, Any]
~~~


Execute a task through the backbone agent (research, analysis, code generation).

Source: `lightbulb/client.py:5125`.

### `bind_project_mission_action`



~~~python
def bind_project_mission_action(project_id: str, mission_run_receipt_id: Any, action_event_id: Any, *, confirm_bind: bool=False, binding_id: Any=None, note: Any=None, idempotency_key: str | None=None) -> Dict[str, Any]
~~~


Bind a later event to a mission; this proves timing and scope only.

Source: `lightbulb/client.py:3915`.

### `build_durable_project_runtime`



~~~python
def build_durable_project_runtime(project: Any, *, registry: Any=None, checkpoint_store: Any=None) -> Any
~~~


Build a durable runtime, using hosted checkpoints when possible.

Source: `lightbulb/client.py:5258`.

### `build_dynamic_workflow_runtime`



~~~python
def build_dynamic_workflow_runtime(*, project_ref: str, hosted_project_id: str | None=None, hosted_company_id: str | None=None, checkpoint_store: Any=None) -> Any
~~~


Build the local planner/builder/evaluator state-machine runtime.

Source: `lightbulb/client.py:5611`.

### `build_project_runtime`



~~~python
def build_project_runtime(project: Any, *, registry: Any=None) -> Any
~~~


Build a runtime using authenticated reads and safe connector previews.

Source: `lightbulb/client.py:5239`.

### `cancel_code_workspace_run`



~~~python
def cancel_code_workspace_run(workspace_id: str, run_id: str) -> Dict[str, Any]
~~~


Cancel an in-flight coding run.

Source: `lightbulb/client.py:9050`.

### `cancel_codex_account_link`



~~~python
def cancel_codex_account_link(session_id: str) -> Dict[str, Any]
~~~


Cancel a Codex device-auth session.

Source: `lightbulb/client.py:3214`.

### `cancel_recursive_agent_execution`



~~~python
def cancel_recursive_agent_execution(execution_id: str) -> Dict[str, Any]
~~~


Cancel one exact user-owned recursive execution tree.

Source: `lightbulb/client.py:6599`.

### `cancel_workflow_instance`



~~~python
def cancel_workflow_instance(trace_id: str, *, company_id: str | None=None) -> Dict[str, Any]
~~~


Cancel a scoped workflow run, including one waiting for approval.

Source: `lightbulb/client.py:6557`.

### `claim_project_coding_handoff`



~~~python
def claim_project_coding_handoff(project_id: str, *, harness: str, handoff_payload_id: str, host_session_ref: str | None=None) -> Dict[str, Any]
~~~


Record routing of an approved handoff to the user's selected harness.

Source: `lightbulb/client.py:2837`.

### `claim_sdk_project_checkpoint`



~~~python
def claim_sdk_project_checkpoint(project_id: str, *, worker_ref: str, ready_at: str, lease_seconds: int=60, company_id: str | None=None) -> Dict[str, Any] | None
~~~


Source: `lightbulb/client.py:5723`.

### `claude_session_action`



~~~python
def claude_session_action(workspace_id: str, session_id: str, action: str, body: Dict[str, Any] | None=None) -> Dict[str, Any]
~~~


Perform an action on a Claude SDK session.

Source: `lightbulb/client.py:9286`.

### `close`



~~~python
def close() -> None
~~~


Close the persistent HTTP session, if one is open.

Source: `lightbulb/client.py:2676`.

### `code_workspace_add_collaborator`



~~~python
def code_workspace_add_collaborator(workspace_id: str, *, email: str | None=None, user_id: str | None=None, role: str='viewer') -> Dict[str, Any]
~~~


Add a collaborator to a code workspace (role: viewer | editor | admin).

Source: `lightbulb/client.py:8776`.

### `code_workspace_add_note`



~~~python
def code_workspace_add_note(workspace_id: str, content: str) -> Dict[str, Any]
~~~


Append a workspace note (visible to collaborators).

Source: `lightbulb/client.py:8889`.

### `code_workspace_approve_access_request`



~~~python
def code_workspace_approve_access_request(workspace_id: str, request_id: str) -> Dict[str, Any]
~~~


Approve a pending workspace access request.

Source: `lightbulb/client.py:8863`.

### `code_workspace_chat`



~~~python
def code_workspace_chat(workspace_id: str, message: str, **kwargs) -> Dict[str, Any]
~~~


Send a chat message to a code workspace.

Source: `lightbulb/client.py:5083`.

### `code_workspace_clear_policy`



~~~python
def code_workspace_clear_policy(workspace_id: str, request_family: str) -> Dict[str, Any]
~~~


Clear cached policy decisions for a request family.

Source: `lightbulb/client.py:9229`.

### `code_workspace_collaboration`



~~~python
def code_workspace_collaboration(workspace_id: str) -> Dict[str, Any]
~~~


Get collaboration info (members, share links, pending requests).

Source: `lightbulb/client.py:8766`.

### `code_workspace_create_pull_request`



~~~python
def code_workspace_create_pull_request(workspace_id: str, body: Dict[str, Any] | None=None) -> Dict[str, Any]
~~~


Open a GitHub pull request from the workspace branch.

Source: `lightbulb/client.py:9024`.

### `code_workspace_create_share_link`



~~~python
def code_workspace_create_share_link(workspace_id: str, *, role: str='viewer', expires_in_seconds: int | None=None) -> Dict[str, Any]
~~~


Create a share-link token granting access to the workspace.

Source: `lightbulb/client.py:8823`.

### `code_workspace_deny_access_request`



~~~python
def code_workspace_deny_access_request(workspace_id: str, request_id: str) -> Dict[str, Any]
~~~


Deny a pending workspace access request.

Source: `lightbulb/client.py:8876`.

### `code_workspace_evals`



~~~python
def code_workspace_evals(workspace_id: str) -> Dict[str, Any]
~~~


Get accumulated eval rollups for a workspace's runs.

Source: `lightbulb/client.py:9206`.

### `code_workspace_invoke_tool`



~~~python
def code_workspace_invoke_tool(workspace_id: str, tool_key: str, arguments: Dict[str, Any] | None=None) -> Dict[str, Any]
~~~


Invoke a workspace-scoped tool (read/write files, run commands, git ops).

Source: `lightbulb/client.py:9065`.

### `code_workspace_link_repository`



~~~python
def code_workspace_link_repository(workspace_id: str, body: Dict[str, Any]) -> Dict[str, Any]
~~~


Link a GitHub repository to the workspace.

Source: `lightbulb/client.py:9037`.

### `code_workspace_policy_replay`



~~~python
def code_workspace_policy_replay(workspace_id: str, **filters: Any) -> Dict[str, Any]
~~~


Replay a policy decision over historical runs (debug helper).

Source: `lightbulb/client.py:9216`.

### `code_workspace_preview`



~~~python
def code_workspace_preview(workspace_id: str) -> Dict[str, Any]
~~~


Get the current preview state (URL, status, last build).

Source: `lightbulb/client.py:9139`.

### `code_workspace_preview_proxy`



~~~python
def code_workspace_preview_proxy(workspace_id: str, path: str='', *, method: str='GET', body: Any=None, headers: Dict[str, str] | None=None) -> httpx.Response
~~~


Proxy an HTTP call through the workspace preview.

Source: `lightbulb/client.py:9160`.

### `code_workspace_preview_start`



~~~python
def code_workspace_preview_start(workspace_id: str, body: Dict[str, Any] | None=None) -> Dict[str, Any]
~~~


Start the workspace preview server (renders the in-progress code).

Source: `lightbulb/client.py:9124`.

### `code_workspace_preview_stop`



~~~python
def code_workspace_preview_stop(workspace_id: str) -> Dict[str, Any]
~~~


Stop the workspace preview server.

Source: `lightbulb/client.py:9149`.

### `code_workspace_promote_policy`



~~~python
def code_workspace_promote_policy(workspace_id: str, body: Dict[str, Any]) -> Dict[str, Any]
~~~


Promote workspace-scoped policy to a higher scope (company/tenant).

Source: `lightbulb/client.py:9242`.

### `code_workspace_redeem_share_link`



~~~python
def code_workspace_redeem_share_link(token: str) -> Dict[str, Any]
~~~


Redeem a workspace share-link token to gain access.

Source: `lightbulb/client.py:8852`.

### `code_workspace_register_runtime_tools`



~~~python
def code_workspace_register_runtime_tools(workspace_id: str, body: Dict[str, Any]) -> Dict[str, Any]
~~~


Register or update workspace runtime tools.

Source: `lightbulb/client.py:9107`.

### `code_workspace_remove_collaborator`



~~~python
def code_workspace_remove_collaborator(workspace_id: str, collaborator_id: str) -> None
~~~


Revoke a collaborator's access.

Source: `lightbulb/client.py:8812`.

### `code_workspace_revoke_share_link`



~~~python
def code_workspace_revoke_share_link(workspace_id: str, link_id: str) -> None
~~~


Revoke a share link.

Source: `lightbulb/client.py:8843`.

### `code_workspace_run_review`



~~~python
def code_workspace_run_review(workspace_id: str, run_id: str, *, verdict: str, feedback: str='') -> Dict[str, Any]
~~~


Submit a human review verdict (accept | reject | request_changes) for a run.

Source: `lightbulb/client.py:8943`.

### `code_workspace_run_review_apply`



~~~python
def code_workspace_run_review_apply(workspace_id: str, run_id: str) -> Dict[str, Any]
~~~


Apply review-suggested changes to the workspace.

Source: `lightbulb/client.py:8961`.

### `code_workspace_run_telemetry`



~~~python
def code_workspace_run_telemetry(workspace_id: str, **filters: Any) -> Dict[str, Any]
~~~


Raw telemetry rows for a workspace's runs.

Source: `lightbulb/client.py:8930`.

### `code_workspace_runs_insights`



~~~python
def code_workspace_runs_insights(workspace_id: str) -> Dict[str, Any]
~~~


Aggregate run-quality insights for a workspace (cost, latency, success rate).

Source: `lightbulb/client.py:8920`.

### `code_workspace_runtime_catalog`



~~~python
def code_workspace_runtime_catalog(workspace_id: str) -> Dict[str, Any]
~~~


Read the workspace's runtime tool catalog (which tool keys are available).

Source: `lightbulb/client.py:9097`.

### `code_workspace_update_collaborator`



~~~python
def code_workspace_update_collaborator(workspace_id: str, collaborator_id: str, *, role: str) -> Dict[str, Any]
~~~


Change a collaborator's role.

Source: `lightbulb/client.py:8799`.

### `codex_thread_action`



~~~python
def codex_thread_action(workspace_id: str, thread_id: str, action: str, body: Dict[str, Any] | None=None) -> Dict[str, Any]
~~~


Perform a thread-level action (rename | archive | unarchive | compact | rollback).

Source: `lightbulb/client.py:9346`.

### `codex_turn_action`



~~~python
def codex_turn_action(workspace_id: str, thread_id: str, turn_id: str, action: str, body: Dict[str, Any] | None=None) -> Dict[str, Any]
~~~


Steer or interrupt a specific Codex turn (action: steer | interrupt).

Source: `lightbulb/client.py:9370`.

### `compile_business_workflow`



~~~python
def compile_business_workflow(objective: str, *, primitive_ids: List[str] | None=None, inputs: Dict[str, Any] | None=None, workflow_name: str | None=None, workflow_type: str | None=None, trigger_event: str | None=None, owner_role: str='workflow_owner', loop: bool=False, max_iterations: int | None=None, source: str='sdk') -> Dict[str, Any]
~~~


Compile a portable, governed workflow draft without network calls.

Source: `lightbulb/client.py:5892`.

### `compose_business_workflow`



~~~python
def compose_business_workflow(objective: str, *, primitive_ids: List[str] | None=None, inputs: Dict[str, Any] | None=None, loop: bool=False, max_iterations: int | None=None, workflow_name: str | None=None, workflow_type: str | None=None, trigger_event: str | None=None, owner_role: str='workflow_owner', publish: bool=False, source: str='sdk') -> Dict[str, Any]
~~~


Draft an Agent Builder workflow from business primitive blocks.

Source: `lightbulb/client.py:5859`.

### `compute_aoc_tick`



~~~python
def compute_aoc_tick(body: Dict[str, Any] | None=None) -> Dict[str, Any]
~~~


Run a one-shot AutoCompany tick computation.

Source: `lightbulb/client.py:9559`.

### `configure_backbone_agent_surface`



~~~python
def configure_backbone_agent_surface(backbone_surface: str, *, model_provider: str | None=None, model_id: str | None=None, provider_connection_id: str | None=None, scope: str='USER', company_id: str | None=None, request_overrides: Dict[str, Any] | None=None) -> Dict[str, Any]
~~~


Configure the preferred Backbone host surface, such as ChatGPT MCP.

Source: `lightbulb/client.py:3119`.

### `configure_coding_agent_runtime`



~~~python
def configure_coding_agent_runtime(runtime_backend: str, *, model_provider: str | None=None, model_id: str | None=None, provider_connection_id: str | None=None, use_codex_account: bool | None=None, scope: str='USER', company_id: str | None=None, request_overrides: Dict[str, Any] | None=None) -> Dict[str, Any]
~~~


Configure Codex, Claude Code, or another coding harness for this account.

Source: `lightbulb/client.py:3078`.

### `context_archive`



~~~python
def context_archive(context_ref: str, *, project_id: str | None=None, company_id: str | None=None) -> Dict[str, Any]
~~~


Archive a private Context Space and close its host bindings.

Source: `lightbulb/client.py:7607`.

### `context_checkpoint`



~~~python
def context_checkpoint(context_ref: str, *, binding_ref: str, base_revision: int, idempotency_key: str, events: Sequence[Mapping[str, Any]] | None=None, state: Mapping[str, Any] | None=None, project_id: str | None=None, company_id: str | None=None) -> Dict[str, Any]
~~~


Append host deltas and structured state with optimistic concurrency.

Source: `lightbulb/client.py:7474`.

### `context_company_id`



~~~python
@property
def context_company_id() -> str | None
~~~


Company used only by Context Broker calls; defaults to the active company.

Source: `lightbulb/client.py:2695`.

### `context_company_id`



~~~python
@context_company_id.setter
def context_company_id(value: str | None) -> None
~~~


Source: `lightbulb/client.py:2704`.

### `context_delete`



~~~python
def context_delete(context_ref: str, *, project_id: str | None=None, company_id: str | None=None) -> Dict[str, Any]
~~~


Request scoped physical deletion after the server's grace period.

Source: `lightbulb/client.py:7630`.

### `context_export`



~~~python
def context_export(context_ref: str, *, project_id: str | None=None, company_id: str | None=None, event_after_sequence: int=0, checkpoint_after_revision: int=0, limit: int=50, max_bytes: int=1048576) -> Dict[str, Any]
~~~


Export a bounded page from a private Context Space for user custody.

Source: `lightbulb/client.py:7552`.

### `context_open`



~~~python
def context_open(host: str, *, host_session_ref: str | None=None, model: str | None=None, context_ref: str | None=None, project_id: str | None=None, company_id: str | None=None, token_budget: int=_CONTEXT_TOKEN_BUDGET_DEFAULT, query: str | None=None, repository: Mapping[str, Any] | None=None) -> Dict[str, Any]
~~~


Open or resume a private cross-host context binding.

Source: `lightbulb/client.py:7289`.

### `context_pack`



~~~python
def context_pack(context_ref: str, *, binding_ref: str | None=None, query: str | None=None, project_id: str | None=None, company_id: str | None=None, token_budget: int=_CONTEXT_TOKEN_BUDGET_DEFAULT, max_items: int=12) -> Dict[str, Any]
~~~


Build a bounded, prompt-aware working pack from durable context.

Source: `lightbulb/client.py:7345`.

### `context_read`



~~~python
def context_read(context_ref: str, refs: Sequence[str], *, project_id: str | None=None, company_id: str | None=None, token_budget: int=_CONTEXT_TOKEN_BUDGET_DEFAULT) -> Dict[str, Any]
~~~


Read exact opaque context items under a bounded token budget.

Source: `lightbulb/client.py:7434`.

### `context_search`



~~~python
def context_search(context_ref: str, query: str, *, project_id: str | None=None, company_id: str | None=None, token_budget: int=_CONTEXT_TOKEN_BUDGET_DEFAULT, max_items: int=10, kinds: Sequence[str] | None=None) -> Dict[str, Any]
~~~


Search a Context Space without placing its full corpus in-model.

Source: `lightbulb/client.py:7384`.

### `context_status`



~~~python
def context_status(context_ref: str, *, binding_ref: str | None=None, project_id: str | None=None, company_id: str | None=None) -> Dict[str, Any]
~~~


Inspect one Context Space or one exact host-session binding.

Source: `lightbulb/client.py:7523`.

### `create_account_shell_customization_draft`



~~~python
def create_account_shell_customization_draft(document: Mapping[str, Any], *, base_revision_id: str | None) -> Dict[str, Any]
~~~


Create an immutable draft from one exact base revision.

Source: `lightbulb/client.py:7726`.

### `create_aoc_run`



~~~python
def create_aoc_run(body: Dict[str, Any]) -> Dict[str, Any]
~~~


Create a new AutoCompany run.

Source: `lightbulb/client.py:9412`.

### `create_aoc_task`



~~~python
def create_aoc_task(body: Dict[str, Any]) -> Dict[str, Any]
~~~


Create an AutoCompany task.

Source: `lightbulb/client.py:9465`.

### `create_approval_auto_accept`



~~~python
def create_approval_auto_accept(task_id: str, body: Dict[str, Any] | None=None) -> Dict[str, Any]
~~~


Create an auto-accept rule keyed off the shape of an existing approval task.

Source: `lightbulb/client.py:9920`.

### `create_code_workspace`



~~~python
def create_code_workspace(*, source: str | None=None, repo_connection_id: str | None=None, branch: str | None=None, depth: int | None=None, label: str | None=None, metadata: Dict[str, Any] | None=None, company_id: str | None=None) -> Dict[str, Any]
~~~


Create a code workspace.

Source: `lightbulb/client.py:5037`.

### `create_conversation`



~~~python
def create_conversation(domain: str) -> Dict[str, Any]
~~~


Create a new conversation for a domain.

Source: `lightbulb/client.py:4790`.

### `create_crm_task`



~~~python
def create_crm_task(body: Dict[str, Any], tenant_id: str | None=None) -> Dict[str, Any]
~~~


Create a CRM task.

Source: `lightbulb/client.py:9869`.

### `create_document`



~~~python
def create_document(title: str, body: str, *, format: str='docx', target_suite: str='internal_library') -> DispatchResult
~~~


Create a new document.

Source: `lightbulb/client.py:4909`.

### `create_document_session`



~~~python
def create_document_session(*, document_type: str='general', document_title: str='Untitled Document') -> Dict[str, Any]
~~~


Create a new document builder session.

Source: `lightbulb/client.py:4809`.

### `create_page_builder_session`



~~~python
def create_page_builder_session(brand_name: str='', initial_prompt: str='') -> Dict[str, Any]
~~~


Create a new page builder session.

Source: `lightbulb/client.py:4962`.

### `create_project_from_preflight`



~~~python
def create_project_from_preflight(receipt: ProjectCreationPreflightReceipt, *, coding_harness: str, confirm_create: bool=False, confirm_open_questions: bool=False, workspace_id: str | None=None, repo_connection_id: str | None=None, idempotency_key: str | None=None, play_style: str | None=None) -> Dict[str, Any]
~~~


Create exactly the draft bound to a validated preflight receipt.

Source: `lightbulb/client.py:4516`.

### `create_server_workflow_improvement_packet`



~~~python
def create_server_workflow_improvement_packet(packet: Dict[str, Any], *, source_run_id: str | None=None) -> Dict[str, Any]
~~~


Source: `lightbulb/client.py:6147`.

### `create_slide_deck`



~~~python
def create_slide_deck(title: str, body: str='', *, target_suite: str='internal_library') -> DispatchResult
~~~


Create a new slide deck.

Source: `lightbulb/client.py:4945`.

### `create_spreadsheet`



~~~python
def create_spreadsheet(title: str, body: str='', *, target_suite: str='internal_library') -> DispatchResult
~~~


Create a new spreadsheet.

Source: `lightbulb/client.py:4930`.

### `decide_project_learning_result_admission`



~~~python
def decide_project_learning_result_admission(project_id: str, evaluation_receipt_id: str, *, decision: Any, rationale: Any, confirm_admission: bool=False, idempotency_key: str | None=None) -> Dict[str, Any]
~~~


Human admit/reject; never apply or promote the candidate.

Source: `lightbulb/client.py:4137`.

### `decide_workflow_improvement_packet`



~~~python
def decide_workflow_improvement_packet(packet_id: str, *, approval_scope: str, decision: str, rationale: str='', evidence: Dict[str, Any] | None=None) -> Dict[str, Any]
~~~


Source: `lightbulb/client.py:6214`.

### `delete_approval_preference`



~~~python
def delete_approval_preference(preference_id: str) -> Dict[str, Any]
~~~


Remove an auto-accept rule.

Source: `lightbulb/client.py:9933`.

### `delete_conversation`



~~~python
def delete_conversation(domain: str, conversation_id: str) -> None
~~~


Delete a conversation.

Source: `lightbulb/client.py:4799`.

### `delete_crm_task`



~~~python
def delete_crm_task(task_id: str, tenant_id: str | None=None) -> None
~~~


Delete a CRM task.

Source: `lightbulb/client.py:9897`.

### `delete_workflow`



~~~python
def delete_workflow(workflow_id: str, *, company_id: str | None=None) -> None
~~~


Soft-delete a workflow through the authenticated designer API.

Source: `lightbulb/client.py:6541`.

### `dispatch`



~~~python
def dispatch(domain: str, *, action: str='chat', message: str='', objective: str='', inputs: Dict[str, Any] | None=None, conversation_id: str | None=None, company_id: str | None=None) -> DispatchResult
~~~


Dispatch a one-shot action to a domain agent and wait for the result.

Source: `lightbulb/client.py:3512`.

### `document_builder_add_collaborator`



~~~python
def document_builder_add_collaborator(session_id: str, *, email: str | None=None, user_id: str | None=None, role: str='viewer') -> Dict[str, Any]
~~~


Add a collaborator to a document builder session.

Source: `lightbulb/client.py:10169`.

### `document_builder_add_note`



~~~python
def document_builder_add_note(session_id: str, content: str) -> Dict[str, Any]
~~~


Add a note to a document builder session.

Source: `lightbulb/client.py:10342`.

### `document_builder_collaboration`



~~~python
def document_builder_collaboration(session_id: str) -> Dict[str, Any]
~~~


Collaboration info for a document builder session.

Source: `lightbulb/client.py:10159`.

### `document_builder_create_share_link`



~~~python
def document_builder_create_share_link(session_id: str, *, role: str='viewer', expires_in_seconds: int | None=None) -> Dict[str, Any]
~~~


Create a share-link token for a document builder session.

Source: `lightbulb/client.py:10192`.

### `document_builder_get_messages`



~~~python
def document_builder_get_messages(session_id: str, **filters: Any) -> List[Dict[str, Any]]
~~~


Get the message history for a document builder session.

Source: `lightbulb/client.py:10225`.

### `document_builder_redeem_share_link`



~~~python
def document_builder_redeem_share_link(session_id: str, token: str) -> Dict[str, Any]
~~~


Redeem a document builder share link.

Source: `lightbulb/client.py:10212`.

### `document_builder_save`



~~~python
def document_builder_save(session_id: str, body: Dict[str, Any] | None=None) -> Dict[str, Any]
~~~


Save a document builder session's current state.

Source: `lightbulb/client.py:10243`.

### `drain_runtime_outcomes`



~~~python
def drain_runtime_outcomes() -> List[Dict[str, Any]]
~~~


Atomically consume outcomes in improvement-loop wire format.

Source: `lightbulb/client.py:5975`.

### `dynamic_workflow_attach`



~~~python
def dynamic_workflow_attach(*, company_ref: str, project_ref: str, run_ref: str, host: str, host_session_ref: str, host_role: str, expected_revision: int, idempotency_key: str) -> Dict[str, Any]
~~~


Attach fresh role custody to an existing authoritative run.

Source: `lightbulb/client.py:5382`.

### `dynamic_workflow_cancel`



~~~python
def dynamic_workflow_cancel(*, company_ref: str, project_ref: str, run_ref: str, host_binding_ref: str, session_receipt: str, host_role: str, expected_revision: int, idempotency_key: str, reason: str) -> Dict[str, Any]
~~~


Cancel a non-terminal workflow using exact optimistic concurrency.

Source: `lightbulb/client.py:5582`.

### `dynamic_workflow_next_assignment`



~~~python
def dynamic_workflow_next_assignment(*, company_ref: str, project_ref: str, run_ref: str, host_binding_ref: str, session_receipt: str, host_role: str, expected_revision: int, idempotency_key: str) -> Dict[str, Any]
~~~


Lease the next assignment from the dedicated workflow authority.

Source: `lightbulb/client.py:5432`.

### `dynamic_workflow_start`



~~~python
def dynamic_workflow_start(*, company_ref: str, project_ref: str, objective: str, acceptance_criteria: Sequence[Mapping[str, Any]], host: str, expected_revision: int, idempotency_key: str, host_session_ref: str | None=None, acceptance_policy: str='distinct_binding', workflow_spec: Mapping[str, Any] | None=None, inputs: Mapping[str, Any] | None=None) -> Dict[str, Any]
~~~


Start an authoritative planner/builder/evaluator workflow.

Source: `lightbulb/client.py:5348`.

### `dynamic_workflow_status`



~~~python
def dynamic_workflow_status(*, company_ref: str, project_ref: str, run_ref: str, host_binding_ref: str, session_receipt: str, host_role: str) -> Dict[str, Any]
~~~


Read bounded status using a role-bound continuation receipt.

Source: `lightbulb/client.py:5409`.

### `dynamic_workflow_submit_builder_result`



~~~python
def dynamic_workflow_submit_builder_result(*, company_ref: str, project_ref: str, run_ref: str, host_binding_ref: str, session_receipt: str, host_role: str, assignment_ref: str, assignment_receipt: str, expected_revision: int, idempotency_key: str, outcome: str, summary: str, plan_digest: str, iteration: int, evidence_refs: Sequence[Mapping[str, Any]], progress_digest: str) -> Dict[str, Any]
~~~


Submit content-addressed builder evidence under its assignment lease.

Source: `lightbulb/client.py:5494`.

### `dynamic_workflow_submit_evaluator_verdict`



~~~python
def dynamic_workflow_submit_evaluator_verdict(*, company_ref: str, project_ref: str, run_ref: str, host_binding_ref: str, session_receipt: str, host_role: str, assignment_ref: str, assignment_receipt: str, expected_revision: int, idempotency_key: str, decision: str, accepted: bool, summary: str, plan_digest: str, builder_result_digest: str, required_criterion_ids: Sequence[str], criterion_results: Sequence[Mapping[str, Any]]) -> Dict[str, Any]
~~~


Submit a default-fail evaluator verdict under fresh role custody.

Source: `lightbulb/client.py:5537`.

### `dynamic_workflow_submit_plan`



~~~python
def dynamic_workflow_submit_plan(*, company_ref: str, project_ref: str, run_ref: str, host_binding_ref: str, session_receipt: str, host_role: str, assignment_ref: str, assignment_receipt: str, expected_revision: int, idempotency_key: str, required_criterion_ids: Sequence[str], plan: Mapping[str, Any]) -> Dict[str, Any]
~~~


Submit a planner result under its exact assignment lease.

Source: `lightbulb/client.py:5459`.

### `evaluate_project_offline_policy`



~~~python
def evaluate_project_offline_policy(project_id: str, *, behavior_policy_id: Any, candidate_policy_id: Any, metric_id: Any, pairs: Sequence[Mapping[str, Any]], confirm_evaluate: bool=False, evaluation_id: Any=None, note: Any=None, idempotency_key: str | None=None) -> Dict[str, Any]
~~~


Estimate a candidate from verified receipts; never admit learning.

Source: `lightbulb/client.py:4414`.

### `flush_runtime_outcomes`



~~~python
def flush_runtime_outcomes(*, idempotency_key: str | None=None) -> Dict[str, Any]
~~~


Upload queued outcomes, restoring them locally when upload fails.

Source: `lightbulb/client.py:6001`.

### `from_verified_envelope`



~~~python
def from_verified_envelope(base_url: str, envelope: Any, *, enforce_https: bool=True, connect_timeout: float=_CONNECT_TIMEOUT, read_timeout: float=_READ_TIMEOUT, outcome_recorder: Any=None) -> 'LightbulbClient'
~~~


Build a worker-only client without a JWT or shared API credential.

Source: `lightbulb/client.py:2609`.

### `get_account_shell_customization`



~~~python
def get_account_shell_customization() -> Dict[str, Any]
~~~


Read the effective governed account-shell customization.

Source: `lightbulb/client.py:7716`.

### `get_agent_runtime_config`



~~~python
def get_agent_runtime_config(agent_type: str='coding', *, company_id: str | None=None) -> Dict[str, Any]
~~~


Get the effective Codex/Claude Code/Backbone runtime config for this account.

Source: `lightbulb/client.py:3055`.

### `get_aoc_decision`



~~~python
def get_aoc_decision(decision_id: str) -> Dict[str, Any]
~~~


Get a specific AutoCompany decision.

Source: `lightbulb/client.py:9525`.

### `get_aoc_run`



~~~python
def get_aoc_run(run_id: str) -> Dict[str, Any]
~~~


Get an AutoCompany run detail.

Source: `lightbulb/client.py:9421`.

### `get_aoc_task`



~~~python
def get_aoc_task(task_id: str) -> Dict[str, Any]
~~~


Get an AutoCompany task detail.

Source: `lightbulb/client.py:9474`.

### `get_aoc_tick`



~~~python
def get_aoc_tick(tick_id: str) -> Dict[str, Any]
~~~


Get a single AutoCompany tick.

Source: `lightbulb/client.py:9549`.

### `get_approval`



~~~python
def get_approval(task_id: str) -> Dict[str, Any]
~~~


Get full details of an approval task.

Source: `lightbulb/client.py:6951`.

### `get_artifact`



~~~python
def get_artifact(artifact_id: str) -> Dict[str, Any]
~~~


Get a specific artifact by ID.

Source: `lightbulb/client.py:6408`.

### `get_code_workspace_active_run`



~~~python
def get_code_workspace_active_run(workspace_id: str) -> Dict[str, Any] | None
~~~


Get the currently active run for a code workspace, if one exists.

Source: `lightbulb/client.py:5101`.

### `get_code_workspace_claude_session`



~~~python
def get_code_workspace_claude_session(workspace_id: str, session_id: str) -> Dict[str, Any]
~~~


Get a single Claude SDK session.

Source: `lightbulb/client.py:9274`.

### `get_code_workspace_codex_thread`



~~~python
def get_code_workspace_codex_thread(workspace_id: str, thread_id: str) -> Dict[str, Any]
~~~


Get a Codex thread (turns, status, metadata).

Source: `lightbulb/client.py:9334`.

### `get_code_workspace_run`



~~~python
def get_code_workspace_run(workspace_id: str, run_id: str) -> Dict[str, Any]
~~~


Get a specific code workspace run.

Source: `lightbulb/client.py:5113`.

### `get_codex_account_link_status`



~~~python
def get_codex_account_link_status(session_id: str) -> Dict[str, Any]
~~~


Poll a Codex device-auth session.

Source: `lightbulb/client.py:3203`.

### `get_conversation`



~~~python
def get_conversation(domain: str, conversation_id: str) -> Dict[str, Any]
~~~


Get conversation history.

Source: `lightbulb/client.py:4781`.

### `get_crm_task`



~~~python
def get_crm_task(task_id: str, tenant_id: str | None=None) -> Dict[str, Any]
~~~


Get a single CRM task.

Source: `lightbulb/client.py:9856`.

### `get_document_schemas`



~~~python
def get_document_schemas(session_id: str) -> Dict[str, Any]
~~~


Get the document schemas for a session.

Source: `lightbulb/client.py:4839`.

### `get_document_session`



~~~python
def get_document_session(session_id: str) -> Dict[str, Any]
~~~


Get a document builder session.

Source: `lightbulb/client.py:4831`.

### `get_finance_reconciliation_run`



~~~python
def get_finance_reconciliation_run(run_id: str, *, company_id: str | None=None) -> FinanceReconciliationRunDetails
~~~


Get one exact reconciliation run and validate its stored envelope.

Source: `lightbulb/client.py:3490`.

### `get_marketplace_action_publication`



~~~python
def get_marketplace_action_publication(publication_id: str) -> Dict[str, Any]
~~~


Get governed publication and security-scan status by publication UUID.

Source: `lightbulb/client.py:8131`.

### `get_marketplace_installation`



~~~python
def get_marketplace_installation(installation_id: str) -> Dict[str, Any]
~~~


Get one marketplace installation for the selected active company.

Source: `lightbulb/client.py:8222`.

### `get_marketplace_invocation_receipt`



~~~python
def get_marketplace_invocation_receipt(invocation_id: str) -> Dict[str, Any]
~~~


Get the immutable audit receipt for one marketplace invocation.

Source: `lightbulb/client.py:8399`.

### `get_marketplace_invocation_status`



~~~python
def get_marketplace_invocation_status(invocation_id: str) -> Dict[str, Any]
~~~


Get current invocation state for the selected company.

Source: `lightbulb/client.py:8387`.

### `get_marketplace_listing`



~~~python
def get_marketplace_listing(listing_id: str, *, revision_id: str | None=None, include_inputs: bool=True) -> Dict[str, Any]
~~~


Get one persisted marketplace listing and optional immutable revision.

Source: `lightbulb/client.py:8037`.

### `get_project_coding_handoff`



~~~python
def get_project_coding_handoff(project_id: str, harness: str) -> Dict[str, Any]
~~~


Read the selected Project Agent handoff for a connected harness.

Source: `lightbulb/client.py:2818`.

### `get_project_coding_harnesses`



~~~python
def get_project_coding_harnesses(project_id: str) -> Dict[str, Any]
~~~


Read the durable additive harness selection for one project.

Source: `lightbulb/client.py:2780`.

### `get_project_connector_route_descriptor`



~~~python
def get_project_connector_route_descriptor(project_id: str, connector_account_ref: str, tool_name: str, *, company_id: str | None=None) -> Dict[str, Any]
~~~


Resolve exact governed execution coordinates for one project account Tool.

Source: `lightbulb/client.py:3001`.

### `get_project_game_snapshot`



~~~python
def get_project_game_snapshot(project_id: str) -> Dict[str, Any]
~~~


Fetch one server-owned, exact-scoped project snapshot.

Source: `lightbulb/client.py:3714`.

### `get_recursive_agent_execution_status`



~~~python
def get_recursive_agent_execution_status(execution_id: str) -> Dict[str, Any]
~~~


Read privacy-minimized status for one exact user-owned recursive tree.

Source: `lightbulb/client.py:6610`.

### `get_runtime_domain_action`



~~~python
def get_runtime_domain_action(runtime_action_id: str, *, project_id: str, company_id: str | None=None) -> Dict[str, Any]
~~~


Review one exact-scope registration without changing its lifecycle.

Source: `lightbulb/client.py:7905`.

### `get_sdk_project_checkpoint`



~~~python
def get_sdk_project_checkpoint(project_id: str, run_ref: str, *, company_id: str | None=None) -> Dict[str, Any] | None
~~~


Source: `lightbulb/client.py:5690`.

### `get_server_workflow_improvement_packet`



~~~python
def get_server_workflow_improvement_packet(packet_id: str) -> Dict[str, Any]
~~~


Read one exact tenant/company-scoped workflow improvement packet.

Source: `lightbulb/client.py:6204`.

### `get_server_workflow_improvement_status`



~~~python
def get_server_workflow_improvement_status() -> Dict[str, Any]
~~~


Source: `lightbulb/client.py:6178`.

### `get_training_pair_status`



~~~python
def get_training_pair_status(pair_handle: str, *, project_id: str | None=None) -> Dict[str, Any]
~~~


Read the privacy-minimized status for one exact owned pair handle.

Source: `lightbulb/client.py:8547`.

### `get_voice_execution`



~~~python
def get_voice_execution(execution_id: str) -> Dict[str, Any]
~~~


Get a voice execution detail (transcripts, status, agent decisions).

Source: `lightbulb/client.py:8592`.

### `get_workflow`



~~~python
def get_workflow(workflow_id: str) -> Dict[str, Any]
~~~


Get a workflow by ID.

Source: `lightbulb/client.py:6475`.

### `get_workflow_improvement_audit`



~~~python
def get_workflow_improvement_audit(packet_id: str) -> List[Dict[str, Any]]
~~~


Source: `lightbulb/client.py:6239`.

### `get_workflow_improvement_delivery`



~~~python
def get_workflow_improvement_delivery(delivery_id: str) -> Dict[str, Any]
~~~


Source: `lightbulb/client.py:6294`.

### `get_workflow_improvement_status`



~~~python
def get_workflow_improvement_status(output_dir: str | os.PathLike[str] | None=None) -> Dict[str, Any]
~~~


Read local continuous-improvement state without network calls.

Source: `lightbulb/client.py:6033`.

### `get_workflow_instance`



~~~python
def get_workflow_instance(trace_id: str, *, company_id: str | None=None) -> Dict[str, Any]
~~~


Get a workflow instance through the authenticated public API.

Source: `lightbulb/client.py:3564`.

### `get_workflow_trigger_catalog`



~~~python
def get_workflow_trigger_catalog() -> Dict[str, Any]
~~~


List the schedule literals and event types accepted by authoring.

Source: `lightbulb/client.py:6759`.

### `grep_documents`



~~~python
def grep_documents(pattern: str, *, regex: bool=True, case_sensitive: bool=False, folder_path: str | None=None, top_k: int=20) -> DispatchResult
~~~


Grep across document content using pattern matching.

Source: `lightbulb/client.py:4867`.

### `hr_live_advance_application`



~~~python
def hr_live_advance_application(application_id: str, *, body: Dict[str, Any] | None=None) -> Dict[str, Any]
~~~


Advance a Greenhouse candidate to the next stage (HITL-gated).

Source: `lightbulb/client.py:8729`.

### `hr_live_cases`



~~~python
def hr_live_cases(**filters: Any) -> Dict[str, Any]
~~~


HR case board items from Monday.com.

Source: `lightbulb/client.py:8696`.

### `hr_live_health`



~~~python
def hr_live_health() -> Dict[str, Any]
~~~


Health check for HR connector tokens (BambooHR / Greenhouse / Monday).

Source: `lightbulb/client.py:8755`.

### `hr_live_leave_balance`



~~~python
def hr_live_leave_balance(bamboo_employee_id: str) -> Dict[str, Any]
~~~


BambooHR leave balance for an employee.

Source: `lightbulb/client.py:8676`.

### `hr_live_monday_onboarding_board`



~~~python
def hr_live_monday_onboarding_board(checklist_id: str) -> Dict[str, Any]
~~~


Monday.com board view for an HR onboarding checklist.

Source: `lightbulb/client.py:8686`.

### `hr_live_recruiting_applications`



~~~python
def hr_live_recruiting_applications(**filters: Any) -> Dict[str, Any]
~~~


Greenhouse applications.

Source: `lightbulb/client.py:8718`.

### `hr_live_recruiting_jobs`



~~~python
def hr_live_recruiting_jobs(**filters: Any) -> Dict[str, Any]
~~~


Greenhouse job listings.

Source: `lightbulb/client.py:8707`.

### `hr_live_reject_application`



~~~python
def hr_live_reject_application(application_id: str, *, body: Dict[str, Any] | None=None) -> Dict[str, Any]
~~~


Reject a Greenhouse application (HITL-gated).

Source: `lightbulb/client.py:8742`.

### `hr_live_whos_out`



~~~python
def hr_live_whos_out(**filters: Any) -> Dict[str, Any]
~~~


BambooHR who's-out roster (current and upcoming time-off).

Source: `lightbulb/client.py:8665`.

### `ingest_sdk_project_event`



~~~python
def ingest_sdk_project_event(project_id: str, event: Dict[str, Any], *, company_id: str | None=None) -> Dict[str, Any]
~~~


Source: `lightbulb/client.py:5768`.

### `inspect_project_creation_world_ready`



~~~python
def inspect_project_creation_world_ready(name: str, instructions: str='', *, participant_role: str='agent_worker', experience_lens: str='agent_protocol', play_style: str='guided_human_in_the_loop') -> dict[str, Any]
~~~


Inspect project-review readiness locally without network activity.

Source: `lightbulb/client.py:4454`.

### `inspect_project_game_campaign`



~~~python
def inspect_project_game_campaign(*, project: dict[str, Any] | None=None, plan: dict[str, Any] | None=None, business_cockpit: dict[str, Any] | None=None) -> dict[str, Any]
~~~


Inspect the human/agent project campaign locally without network activity.

Source: `lightbulb/client.py:3761`.

### `inspect_training_pair_input_custody`



~~~python
def inspect_training_pair_input_custody(installation_id: str, revision_id: str, *, project_id: str | None=None) -> Dict[str, Any]
~~~


Inspect exact-owner input custody without returning raw evidence.

Source: `lightbulb/client.py:8445`.

### `inspect_training_pair_readiness`



~~~python
def inspect_training_pair_readiness(installation_id: str, revision_id: str, *, project_id: str | None=None) -> Dict[str, Any]
~~~


Inspect structured source, authority, stage, and lane readiness.

Source: `lightbulb/client.py:8413`.

### `inspect_workflow_learning_candidate_attestation`



~~~python
def inspect_workflow_learning_candidate_attestation(delivery_id: str) -> Dict[str, Any]
~~~


Revalidate the exact candidate producer attestation using current keys.

Source: `lightbulb/client.py:6303`.

### `install_marketplace_action`



~~~python
def install_marketplace_action(listing_id: str, revision_id: str, *, idempotency_key: str, deployment_targets: Sequence[str] | None=None) -> Dict[str, Any]
~~~


Install a pinned revision and bind its explicit agent targets.

Source: `lightbulb/client.py:8234`.

### `invoke_marketplace_action`



~~~python
def invoke_marketplace_action(installation_id: str, inputs: Dict[str, Any] | None=None, *, idempotency_key: str, message: str='', objective: str='', dry_run: bool=True, preview_invocation_id: str | None=None, confirm_live: bool=False) -> Dict[str, Any]
~~~


Preview an installed action, or explicitly confirm an exact preview for live use.

Source: `lightbulb/client.py:8340`.

### `invoke_tool`



~~~python
def invoke_tool(tool_name: str, arguments: Dict[str, Any], *, project_id: str | None=None, project_ref: str | None=None, connector_account_ref: str | None=None, idempotency_key: str | None=None, approval_ref: str | None=None, workflow_id: str | None=None, step_id: str | None=None, workflow_instance_id: str | None=None, workflow_step_generation: int | None=None, runtime_context: Dict[str, Any] | None=None, effect: str | None=None, _runtime_authority: Any=None) -> Dict[str, Any]
~~~


Invoke a platform tool by name (e.g. connector tools, utility tools).

Source: `lightbulb/client.py:7045`.

### `it_ops_live_connector`



~~~python
def it_ops_live_connector(connector: str, **filters: Any) -> Dict[str, Any]
~~~


Pass-through to a live IT-Ops connector (jira | slack | github | notion).

Source: `lightbulb/client.py:10032`.

### `it_ops_mcp_manifest`



~~~python
def it_ops_mcp_manifest() -> Dict[str, Any]
~~~


Get the IT-Ops workspace MCP manifest.

Source: `lightbulb/client.py:10046`.

### `list_agent_runtime_options`



~~~python
def list_agent_runtime_options(agent_type: str | None=None) -> Dict[str, Any]
~~~


List coding-agent runtimes and Backbone host surfaces available to the account.

Source: `lightbulb/client.py:3039`.

### `list_aoc_decisions`



~~~python
def list_aoc_decisions(**filters: Any) -> List[Dict[str, Any]]
~~~


List AutoCompany decisions awaiting or post-resolution.

Source: `lightbulb/client.py:9509`.

### `list_aoc_runs`



~~~python
def list_aoc_runs(**filters: Any) -> List[Dict[str, Any]]
~~~


List AutoCompany cognitive-loop runs.

Source: `lightbulb/client.py:9398`.

### `list_aoc_task_events`



~~~python
def list_aoc_task_events(task_id: str) -> List[Dict[str, Any]]
~~~


List events recorded against an AutoCompany task.

Source: `lightbulb/client.py:9483`.

### `list_aoc_tasks`



~~~python
def list_aoc_tasks(**filters: Any) -> List[Dict[str, Any]]
~~~


List AutoCompany tasks.

Source: `lightbulb/client.py:9451`.

### `list_aoc_ticks`



~~~python
def list_aoc_ticks(**filters: Any) -> List[Dict[str, Any]]
~~~


List AutoCompany cognitive-loop ticks.

Source: `lightbulb/client.py:9535`.

### `list_approval_preferences`



~~~python
def list_approval_preferences() -> List[Dict[str, Any]]
~~~


List the user's HITL auto-accept rules.

Source: `lightbulb/client.py:9909`.

### `list_artifacts`



~~~python
def list_artifacts(**filters) -> List[Dict[str, Any]]
~~~


List artifacts (charts, reports, analyses, etc.).

Source: `lightbulb/client.py:6392`.

### `list_available_project_connector_accounts`



~~~python
def list_available_project_connector_accounts(project_id: str, provider: str, *, company_id: str | None=None) -> List[Dict[str, Any]]
~~~


List provider accounts eligible for binding to one accessible project.

Source: `lightbulb/client.py:2965`.

### `list_business_primitives`



~~~python
def list_business_primitives(*, category: str | None=None, query: str | None=None, include_inputs: bool=True) -> List[Dict[str, Any]]
~~~


List user-facing business primitives exposed by the SDK/MCP layer.

Source: `lightbulb/client.py:5815`.

### `list_code_workspace_claude_sessions`



~~~python
def list_code_workspace_claude_sessions(workspace_id: str) -> List[Dict[str, Any]]
~~~


List Claude SDK sessions associated with a workspace.

Source: `lightbulb/client.py:9257`.

### `list_code_workspace_codex_threads`



~~~python
def list_code_workspace_codex_threads(workspace_id: str, **filters: Any) -> List[Dict[str, Any]]
~~~


List Codex runtime threads attached to a workspace.

Source: `lightbulb/client.py:9316`.

### `list_code_workspace_proposals`



~~~python
def list_code_workspace_proposals(workspace_id: str) -> List[Dict[str, Any]]
~~~


List code-change proposals submitted to the workspace.

Source: `lightbulb/client.py:8974`.

### `list_code_workspace_runs`



~~~python
def list_code_workspace_runs(workspace_id: str, **filters: Any) -> List[Dict[str, Any]]
~~~


List historical coding runs for a workspace.

Source: `lightbulb/client.py:8904`.

### `list_code_workspaces`



~~~python
def list_code_workspaces() -> List[Dict[str, Any]]
~~~


List code workspaces.

Source: `lightbulb/client.py:5074`.

### `list_companies`



~~~python
def list_companies() -> List[Dict[str, Any]]
~~~


List companies the user has access to within their tenant.

Source: `lightbulb/client.py:2734`.

### `list_connected_integrations`



~~~python
def list_connected_integrations(company_id: str | None=None) -> List[Dict[str, Any]]
~~~


List connected integrations (OAuth connections) for the current company scope.

Source: `lightbulb/client.py:2716`.

### `list_connectors`



~~~python
def list_connectors() -> List[Dict[str, Any]]
~~~


List available connectors and their status.

Source: `lightbulb/client.py:7015`.

### `list_contacts`



~~~python
def list_contacts(**filters) -> List[Dict[str, Any]]
~~~


List CRM contacts.

Source: `lightbulb/client.py:7243`.

### `list_conversations`



~~~python
def list_conversations(domain: str) -> List[Dict[str, Any]]
~~~


List all conversations for a domain.

Source: `lightbulb/client.py:4772`.

### `list_crm_tasks`



~~~python
def list_crm_tasks(tenant_id: str | None=None, **filters: Any) -> List[Dict[str, Any]]
~~~


List CRM tasks scoped to a tenant (defaults to authed tenant).

Source: `lightbulb/client.py:9839`.

### `list_deals`



~~~python
def list_deals(**filters) -> List[Dict[str, Any]]
~~~


List CRM deals/opportunities.

Source: `lightbulb/client.py:7255`.

### `list_document_sessions`



~~~python
def list_document_sessions() -> List[Dict[str, Any]]
~~~


List document builder sessions.

Source: `lightbulb/client.py:4823`.

### `list_domain_actions`



~~~python
def list_domain_actions(domain: str) -> List[Dict[str, Any]]
~~~


List available actions for a specific domain agent.

Source: `lightbulb/client.py:7703`.

### `list_domains`



~~~python
def list_domains() -> Dict[str, Dict[str, Any]] | List[Dict[str, Any]]
~~~


List all available domain agents and their capabilities.

Source: `lightbulb/client.py:7694`.

### `list_executable_business_primitives`



~~~python
def list_executable_business_primitives(*, query: str='', include_schemas: bool=True, offset: int=0, limit: int | None=None) -> Dict[str, Any]
~~~


List SDK primitive implementations, optionally as bounded pages.

Source: `lightbulb/client.py:5145`.

### `list_finance_reconciliation_runs`



~~~python
def list_finance_reconciliation_runs(*, company_id: str | None=None, limit: int=50) -> tuple[FinanceReconciliationRunSummary, ...]
~~~


List bounded reconciliation run summaries under one Spring scope.

Source: `lightbulb/client.py:3466`.

### `list_folder`



~~~python
def list_folder(folder_path: str='', *, source_system: str | None=None, max_items: int=100) -> DispatchResult
~~~


List documents in a folder.

Source: `lightbulb/client.py:4892`.

### `list_marketplace_installations`



~~~python
def list_marketplace_installations(*, status: str | None=None, cursor: str | None=None, limit: int=50) -> Dict[str, Any]
~~~


List marketplace installations for the selected active company.

Source: `lightbulb/client.py:8199`.

### `list_marketplace_listings`



~~~python
def list_marketplace_listings(*, query: str | None=None, kind: str | None=None, domain: str | None=None, cursor: str | None=None, limit: int=50, include_inputs: bool=True) -> Dict[str, Any]
~~~


List persisted lifecycle listings and authoritative UUID IDs.

Source: `lightbulb/client.py:8005`.

### `list_notifications`



~~~python
def list_notifications(**filters) -> List[Dict[str, Any]]
~~~


List notifications (HITL decisions, workflow alerts, system messages).

Source: `lightbulb/client.py:7269`.

### `list_page_builder_sessions`



~~~python
def list_page_builder_sessions() -> List[Dict[str, Any]]
~~~


List page builder sessions.

Source: `lightbulb/client.py:4980`.

### `list_pending_approvals`



~~~python
def list_pending_approvals() -> List[Dict[str, Any]]
~~~


List pending HITL approval tasks waiting for your decision.

Source: `lightbulb/client.py:6942`.

### `list_project_business_outcomes`



~~~python
def list_project_business_outcomes(project_id: str, *, limit: int=25) -> Dict[str, Any]
~~~


Read the authenticated score ledger for one accessible project.

Source: `lightbulb/client.py:4248`.

### `list_project_connector_accounts`



~~~python
def list_project_connector_accounts(project_id: str, *, company_id: str | None=None) -> List[Dict[str, Any]]
~~~


List connector accounts already bound to one accessible project.

Source: `lightbulb/client.py:2934`.

### `list_project_learning_result_evaluations`



~~~python
def list_project_learning_result_evaluations(project_id: str, *, limit: int=25) -> Dict[str, Any]
~~~


Read independent technical results and separate human decisions.

Source: `lightbulb/client.py:4118`.

### `list_project_learning_reviews`



~~~python
def list_project_learning_reviews(project_id: str, *, limit: int=25) -> Dict[str, Any]
~~~


Read human after-action decisions and admitted shadow observations.

Source: `lightbulb/client.py:3951`.

### `list_project_learning_runs`



~~~python
def list_project_learning_runs(project_id: str, *, limit: int=25) -> Dict[str, Any]
~~~


Read receipt-backed Training Quest state without inferring missing execution.

Source: `lightbulb/client.py:4005`.

### `list_project_mission_runs`



~~~python
def list_project_mission_runs(project_id: str, *, limit: int=25) -> Dict[str, Any]
~~~


Read briefing locks and action bindings for one accessible project.

Source: `lightbulb/client.py:3857`.

### `list_project_policy_assignments`



~~~python
def list_project_policy_assignments(project_id: str, *, limit: int=25) -> Dict[str, Any]
~~~


Read immutable decision-time probability assignments for one project.

Source: `lightbulb/client.py:4322`.

### `list_project_policy_evaluations`



~~~python
def list_project_policy_evaluations(project_id: str, *, limit: int=25) -> Dict[str, Any]
~~~


Read offline-policy receipts and their explicit truth boundary.

Source: `lightbulb/client.py:4396`.

### `list_project_science_evidence`



~~~python
def list_project_science_evidence(project_id: str, *, limit: int=50) -> Dict[str, Any]
~~~


Read the scope-verified hypothesis-to-policy context spine.

Source: `lightbulb/client.py:3775`.

### `list_project_shadow_learner_updates`



~~~python
def list_project_shadow_learner_updates(project_id: str, *, limit: int=25) -> Dict[str, Any]
~~~


Read bounded shadow update/rollback receipts; this grants no authority.

Source: `lightbulb/client.py:4176`.

### `list_project_skill_matches`



~~~python
def list_project_skill_matches(project_id: str, *, limit: int=25) -> Dict[str, Any]
~~~


Read the project's worker-verified shadow Training Arena ledger.

Source: `lightbulb/client.py:3969`.

### `list_project_training_packs`



~~~python
def list_project_training_packs(project_id: str, *, limit: int=25) -> Dict[str, Any]
~~~


Read exact Arena + human-lesson packs before any learning-run admission.

Source: `lightbulb/client.py:3987`.

### `list_projects`



~~~python
def list_projects(*, company_id: str | None=None) -> List[Dict[str, Any]]
~~~


List projects visible in one authenticated company scope.

Source: `lightbulb/client.py:2750`.

### `list_ready_sdk_project_checkpoints`



~~~python
def list_ready_sdk_project_checkpoints(project_id: str, *, ready_at: str, limit: int=100, company_id: str | None=None) -> List[Dict[str, Any]]
~~~


Source: `lightbulb/client.py:5706`.

### `list_runtime_domain_actions`



~~~python
def list_runtime_domain_actions(*, project_id: str, status: str='pending_approval', company_id: str | None=None) -> Dict[str, Any]
~~~


List one explicit lifecycle state for the selected company.

Source: `lightbulb/client.py:7886`.

### `list_runtime_outcomes`



~~~python
def list_runtime_outcomes() -> List[Dict[str, Any]]
~~~


Return sanitized outcomes recorded by this SDK process.

Source: `lightbulb/client.py:5971`.

### `list_server_workflow_improvement_packets`



~~~python
def list_server_workflow_improvement_packets(*, status: str | None=None, limit: int=50) -> List[Dict[str, Any]]
~~~


Source: `lightbulb/client.py:6186`.

### `list_tool_contracts`



~~~python
def list_tool_contracts() -> List[Dict[str, Any]]
~~~


List hosted Tool schemas used for connector drift detection.

Source: `lightbulb/client.py:7025`.

### `list_voice_executions`



~~~python
def list_voice_executions(**filters: Any) -> List[Dict[str, Any]]
~~~


List voice agent executions (live and historical phone calls).

Source: `lightbulb/client.py:8576`.

### `list_voice_pending_approvals`



~~~python
def list_voice_pending_approvals() -> List[Dict[str, Any]]
~~~


List in-call HITL approvals waiting for caller-side decision.

Source: `lightbulb/client.py:8602`.

### `list_workflow_improvement_packets`



~~~python
def list_workflow_improvement_packets(output_dir: str | os.PathLike[str] | None=None, *, status: str | None=None) -> List[Dict[str, Any]]
~~~


List approval-gated workflow improvement packets.

Source: `lightbulb/client.py:6042`.

### `list_workflows`



~~~python
def list_workflows(*, company_id: str | None=None) -> List[Dict[str, Any]]
~~~


List active workflow definitions in the authenticated company scope.

Source: `lightbulb/client.py:6463`.

### `mark_all_notifications_read`



~~~python
def mark_all_notifications_read() -> Dict[str, Any]
~~~


Mark all notifications as read.

Source: `lightbulb/client.py:9970`.

### `mark_notification_read`



~~~python
def mark_notification_read(notification_id: str) -> Dict[str, Any]
~~~


Mark a single notification as read.

Source: `lightbulb/client.py:9959`.

### `marketing_add_website_analytics_site`



~~~python
def marketing_add_website_analytics_site(body: Dict[str, Any]) -> Dict[str, Any]
~~~


Register a website with the analytics setup.

Source: `lightbulb/client.py:10282`.

### `marketing_content_configure_provider`



~~~python
def marketing_content_configure_provider(provider: str, body: Dict[str, Any]) -> Dict[str, Any]
~~~


Configure a marketing-content provider (e.g. ga4, segment, plausible).

Source: `lightbulb/client.py:10268`.

### `marketing_content_setup`



~~~python
def marketing_content_setup() -> Dict[str, Any]
~~~


Get the marketing content connector setup state.

Source: `lightbulb/client.py:10258`.

### `marketing_install_website_analytics`



~~~python
def marketing_install_website_analytics(workspace_id: str, body: Dict[str, Any] | None=None) -> Dict[str, Any]
~~~


Install website analytics into a code workspace.

Source: `lightbulb/client.py:10329`.

### `marketing_remove_website_analytics_site`



~~~python
def marketing_remove_website_analytics_site(site_id: str) -> Dict[str, Any]
~~~


Remove a registered analytics site.

Source: `lightbulb/client.py:10306`.

### `marketing_select_website_analytics_site`



~~~python
def marketing_select_website_analytics_site(site_id: str) -> Dict[str, Any]
~~~


Activate a registered analytics site.

Source: `lightbulb/client.py:10295`.

### `marketing_verify_website_analytics`



~~~python
def marketing_verify_website_analytics(body: Dict[str, Any] | None=None) -> Dict[str, Any]
~~~


Verify the website analytics setup is wired correctly.

Source: `lightbulb/client.py:10316`.

### `memory_add_skill`



~~~python
def memory_add_skill(body: Dict[str, Any]) -> Dict[str, Any]
~~~


Record a new skill / capability.

Source: `lightbulb/client.py:9828`.

### `memory_create_entry`



~~~python
def memory_create_entry(body: Dict[str, Any]) -> Dict[str, Any]
~~~


Create a structured memory entry.

Source: `lightbulb/client.py:9611`.

### `memory_create_identity`



~~~python
def memory_create_identity(body: Dict[str, Any]) -> Dict[str, Any]
~~~


Create an identity record.

Source: `lightbulb/client.py:9753`.

### `memory_create_link`



~~~python
def memory_create_link(body: Dict[str, Any]) -> Dict[str, Any]
~~~


Create a memory link between two entities.

Source: `lightbulb/client.py:9809`.

### `memory_get_entry`



~~~python
def memory_get_entry(entry_id: str) -> Dict[str, Any]
~~~


Get a specific memory entry.

Source: `lightbulb/client.py:9601`.

### `memory_get_identity`



~~~python
def memory_get_identity(doc_id: str) -> Dict[str, Any]
~~~


Get an identity record by doc id.

Source: `lightbulb/client.py:9762`.

### `memory_graph`



~~~python
def memory_graph(**filters: Any) -> Dict[str, Any]
~~~


Full memory graph (or filtered subgraph).

Source: `lightbulb/client.py:9721`.

### `memory_graph_node`



~~~python
def memory_graph_node(node_id: str) -> Dict[str, Any]
~~~


Get a single node from the memory graph.

Source: `lightbulb/client.py:9732`.

### `memory_list_entries`



~~~python
def memory_list_entries(**filters: Any) -> List[Dict[str, Any]]
~~~


List memory entries (structured records).

Source: `lightbulb/client.py:9585`.

### `memory_list_events`



~~~python
def memory_list_events(**filters: Any) -> List[Dict[str, Any]]
~~~


List memory events (timeline of state changes).

Source: `lightbulb/client.py:9772`.

### `memory_list_identity`



~~~python
def memory_list_identity() -> List[Dict[str, Any]]
~~~


List identity records in the memory graph.

Source: `lightbulb/client.py:9743`.

### `memory_list_links`



~~~python
def memory_list_links(**filters: Any) -> List[Dict[str, Any]]
~~~


List entity links in the memory graph.

Source: `lightbulb/client.py:9797`.

### `memory_list_skills`



~~~python
def memory_list_skills() -> List[Dict[str, Any]]
~~~


List skills/capabilities recorded in memory.

Source: `lightbulb/client.py:9818`.

### `memory_projection_memory`



~~~python
def memory_projection_memory() -> Dict[str, Any]
~~~


Memory-structure projection of the agent.

Source: `lightbulb/client.py:9638`.

### `memory_projection_soul`



~~~python
def memory_projection_soul() -> Dict[str, Any]
~~~


Identity / personality projection of the agent.

Source: `lightbulb/client.py:9629`.

### `memory_query`



~~~python
def memory_query(body: Dict[str, Any]) -> Dict[str, Any]
~~~


Run a structured memory query (filters, time-windows, semantic).

Source: `lightbulb/client.py:9620`.

### `memory_recall`



~~~python
def memory_recall(key: str, *, namespace: str='default') -> Dict[str, Any]
~~~


Recall a value from agent memory.

Source: `lightbulb/client.py:7668`.

### `memory_record_event`



~~~python
def memory_record_event(body: Dict[str, Any]) -> Dict[str, Any]
~~~


Record a memory event.

Source: `lightbulb/client.py:9788`.

### `memory_regulate`



~~~python
def memory_regulate(*, idempotency_key: str | None=None, project_id: str | None=None, budget: int | None=None, categories: Sequence[str] | None=None, dry_run: bool=True, max_summary_chars: int=900, empirical_success_floor_ppm: int | None=None, empirical_success_min_samples: int=20, empirical_success_lookback_days: int=90, optimize_for_least_active_memory: bool=False, held_out_task_evaluation: Mapping[str, Any] | None=None) -> Dict[str, Any]
~~~


Preview or execute bounded, success-evidence-aware compaction.

Source: `lightbulb/client.py:9666`.

### `memory_regulation_storage_status`



~~~python
def memory_regulation_storage_status() -> Dict[str, Any]
~~~


Inspect finite company, tenant, and platform receipt admission.

Source: `lightbulb/client.py:9656`.

### `memory_search`



~~~python
def memory_search(query: str, *, namespace: str='default', top_k: int=5) -> List[Dict[str, Any]]
~~~


Search agent memory semantically.

Source: `lightbulb/client.py:7678`.

### `memory_status`



~~~python
def memory_status() -> Dict[str, Any]
~~~


Health / capacity status of the memory subsystem.

Source: `lightbulb/client.py:9647`.

### `memory_store`



~~~python
def memory_store(key: str, value: str, *, namespace: str='default') -> Dict[str, Any]
~~~


Store a value in agent memory.

Source: `lightbulb/client.py:7655`.

### `modify_voice_action`



~~~python
def modify_voice_action(execution_id: str, approval_task_id: str, modifications: Dict[str, Any]) -> Dict[str, Any]
~~~


Approve a voice action with modifications to the proposed payload.

Source: `lightbulb/client.py:8647`.

### `page_builder_capabilities`



~~~python
def page_builder_capabilities(session_id: str) -> Dict[str, Any]
~~~


List page capabilities (forms, search, auth, etc.).

Source: `lightbulb/client.py:10110`.

### `page_builder_deploy`



~~~python
def page_builder_deploy(session_id: str, page_key: str='') -> Dict[str, Any]
~~~


Deploy a page builder session.

Source: `lightbulb/client.py:5013`.

### `page_builder_get_preview`



~~~python
def page_builder_get_preview(session_id: str) -> Dict[str, Any]
~~~


Get the preview URL for a page builder session.

Source: `lightbulb/client.py:5025`.

### `page_builder_get_schemas`



~~~python
def page_builder_get_schemas(session_id: str) -> Dict[str, Any]
~~~


Get the current page schemas for a session.

Source: `lightbulb/client.py:5003`.

### `page_builder_install_artifact`



~~~python
def page_builder_install_artifact(session_id: str, body: Dict[str, Any]) -> Dict[str, Any]
~~~


Install a component artifact into the page session.

Source: `lightbulb/client.py:10097`.

### `page_builder_promote_install_bundle`



~~~python
def page_builder_promote_install_bundle(session_id: str, body: Dict[str, Any]) -> Dict[str, Any]
~~~


Promote an install bundle to the workspace.

Source: `lightbulb/client.py:10084`.

### `page_builder_promote_section`



~~~python
def page_builder_promote_section(session_id: str, body: Dict[str, Any]) -> Dict[str, Any]
~~~


Promote a section artifact to the install bundle.

Source: `lightbulb/client.py:10071`.

### `page_builder_save_backend_contract`



~~~python
def page_builder_save_backend_contract(session_id: str, body: Dict[str, Any]) -> Dict[str, Any]
~~~


Define a backend contract for a page (data shape + agent binding).

Source: `lightbulb/client.py:10133`.

### `page_builder_save_capability`



~~~python
def page_builder_save_capability(session_id: str, body: Dict[str, Any]) -> Dict[str, Any]
~~~


Save a capability to the page session.

Source: `lightbulb/client.py:10120`.

### `page_builder_send_message`



~~~python
def page_builder_send_message(session_id: str, content: str) -> Dict[str, Any]
~~~


Send a message to a page builder session (non-streaming).

Source: `lightbulb/client.py:4990`.

### `page_builder_unpublish`



~~~python
def page_builder_unpublish(session_id: str) -> Dict[str, Any]
~~~


Unpublish a deployed page builder session.

Source: `lightbulb/client.py:10146`.

### `page_builder_workspace_automation`



~~~python
def page_builder_workspace_automation(session_id: str, body: Dict[str, Any] | None=None) -> Dict[str, Any]
~~~


Run the page-builder workspace automation (auto-wire pages → agents → backend).

Source: `lightbulb/client.py:10058`.

### `pin_marketplace_action`



~~~python
def pin_marketplace_action(installation_id: str, revision_id: str, *, idempotency_key: str, expected_revision_id: str | None=None) -> Dict[str, Any]
~~~


Pin an installation to an immutable listing revision.

Source: `lightbulb/client.py:8311`.

### `post_aoc_task_event`



~~~python
def post_aoc_task_event(task_id: str, body: Dict[str, Any]) -> Dict[str, Any]
~~~


Post a new event onto an AutoCompany task.

Source: `lightbulb/client.py:9498`.

### `preflight_project_creation`



~~~python
def preflight_project_creation(name: str, instructions: str='') -> ProjectCreationPreflightReceipt
~~~


Review a project draft without creating or mutating anything.

Source: `lightbulb/client.py:4476`.

### `preflight_training_pair`



~~~python
def preflight_training_pair(installation_id: str, revision_id: str, *, project_id: str | None=None) -> Dict[str, Any]
~~~


Read readiness for one exact installed action revision.

Source: `lightbulb/client.py:8477`.

### `prepare_project_learning_run`



~~~python
def prepare_project_learning_run(project_id: str, *, training_pack_receipt_id: Any, primary_metric: Any, runtime: str='automl', request_id: Any=None, direction: str='maximize', minimum_improvement: Any='0.010000', max_cost_usd: Any='0.000000', max_platform_cost_usd: Any='5.000000', max_gpu_seconds: Any=3600, max_tokens: Any=100000, max_steps: Any=10000, provider_account_fingerprint: Any=None, provider_binding_expires_at: Any=None, max_attempts: Any=3, lease_seconds: Any=300, preemptible: bool=True, confirm_prepare: bool=False, idempotency_key: str | None=None) -> Dict[str, Any]
~~~


Publish exact dataset custody and create a queued durable Memory run.

Source: `lightbulb/client.py:4023`.

### `prepare_workflow_learning_handoff`



~~~python
def prepare_workflow_learning_handoff(packet_id: str, delivery_id: str, installation_id: str, revision_id: str, *, candidate_manifest: Dict[str, Any], episode_manifest: Dict[str, Any] | None=None, project_id: str | None=None) -> Dict[str, Any]
~~~


Bind a validated delivery to read-only paired-learning readiness.

Source: `lightbulb/client.py:6319`.

### `preview_account_shell_customization`



~~~python
def preview_account_shell_customization(draft_revision_id: str) -> Dict[str, Any]
~~~


Compile a draft into a non-publishing preview receipt.

Source: `lightbulb/client.py:7752`.

### `preview_marketplace_action_publication`



~~~python
def preview_marketplace_action_publication(*, slug: str, name: str, version: str, domain: str, action: str, visibility: str='PRIVATE', pricing_model: str='INCLUDED', changelog: str='') -> Dict[str, Any]
~~~


Preview a server-derived immutable action contract without publishing it.

Source: `lightbulb/client.py:8060`.

### `publish_account_shell_customization`



~~~python
def publish_account_shell_customization(draft_revision_id: str, *, preview_receipt_id: str, expected_current_revision_id: str | None, idempotency_key: str) -> Dict[str, Any]
~~~


Publish the exact previewed draft with optimistic concurrency.

Source: `lightbulb/client.py:7775`.

### `publish_marketplace_action`



~~~python
def publish_marketplace_action(*, slug: str, name: str, version: str, domain: str, action: str, expected_contract_digest: str, idempotency_key: str, visibility: str='PRIVATE', pricing_model: str='INCLUDED', changelog: str='') -> Dict[str, Any]
~~~


Publish the exact action contract approved by a prior preview.

Source: `lightbulb/client.py:8092`.

### `put_sdk_project_checkpoint`



~~~python
def put_sdk_project_checkpoint(project_id: str, run_ref: str, checkpoint: Dict[str, Any], *, expected_revision: int | None, company_id: str | None=None) -> Dict[str, Any]
~~~


Source: `lightbulb/client.py:5668`.

### `rag_query`



~~~python
def rag_query(question: str, *, top_k: int=5, document_ids: List[str] | None=None) -> Dict[str, Any]
~~~


Query the RAG knowledge base directly.

Source: `lightbulb/client.py:6985`.

### `rag_upload_document`



~~~python
def rag_upload_document(filename: str, content: str, **metadata) -> Dict[str, Any]
~~~


Upload a document to the RAG library.

Source: `lightbulb/client.py:6999`.

### `record_project_business_outcome`



~~~python
def record_project_business_outcome(project_id: str, *, metric_id: Any, metric_label: Any, direction: Any, baseline_value: Any, observed_value: Any, confirm_record: bool=False, unit: Any=None, observed_at: Any=None, observation_id: Any=None, source_kind: str='human_attestation', source_event_id: Any=None, evidence_refs: Sequence[Any] | None=None, links: Mapping[str, Any] | None=None, note: Any=None, idempotency_key: str | None=None) -> Dict[str, Any]
~~~


Append one scoped metric observation; never admit learning or promotion.

Source: `lightbulb/client.py:4267`.

### `record_project_coding_harness_result`



~~~python
def record_project_coding_harness_result(project_id: str, *, harness: str, handoff_payload_id: str, status: str, summary: str, report_id: str | None=None, host_session_ref: str | None=None, changed_files: Sequence[str] | None=None, test_commands_and_results: Sequence[str] | None=None, unresolved_requirements_or_acceptance_gaps: str | None=None, pull_request_url: str | None=None, commit_sha: str | None=None) -> Dict[str, Any]
~~~


Return bounded coding evidence to the Project Agent delivery loop.

Source: `lightbulb/client.py:2880`.

### `record_project_learning_review`



~~~python
def record_project_learning_review(project_id: str, *, mission_run_receipt_id: Any, mission_action_receipt_id: Any, outcome_receipt_id: Any, decision: Any, skill_trial_arm: Any, selected_skill_ids: Sequence[Any] | None, label: Any, reason: Any, confirm_record: bool=False, review_id: Any=None, evidence_refs: Sequence[Any] | None=None, idempotency_key: str | None=None) -> Dict[str, Any]
~~~


Human-review one exact chain for shadow training; no live learner mutation.

Source: `lightbulb/client.py:4200`.

### `record_project_policy_assignment`



~~~python
def record_project_policy_assignment(project_id: str, *, metric_id: Any, direction: Any, actions: Sequence[Mapping[str, Any]], chosen_action_id: Any, behavior_policy: Mapping[str, Any], candidate_policies: Sequence[Mapping[str, Any]], confirm_record: bool=False, assignment_id: Any=None, unit: Any=None, decided_at: Any=None, source_kind: str='human_attestation', source_event_id: Any=None, evidence_refs: Sequence[Any] | None=None, links: Mapping[str, Any] | None=None, note: Any=None, idempotency_key: str | None=None) -> Dict[str, Any]
~~~


Log propensities before an outcome; this never executes an action.

Source: `lightbulb/client.py:4340`.

### `record_project_science_evidence`



~~~python
def record_project_science_evidence(project_id: str, *, stage: Any, summary: Any, business_metric_id: Any, expected_direction: Any, artifact_kind: Any, artifact_system: Any, artifact_reference: Any, artifact_digest_sha256: Any, producer_role: Any, confirm_record: bool=False, tool_names: Sequence[Any] | None=None, skill_ids: Sequence[Any] | None=None, parent_receipt_ids: Sequence[Any] | None=None, artifact_schema: Any=None, observed_at: Any=None, evidence_id: Any=None, source_kind: str='human_attestation', source_event_id: Any=None, evidence_refs: Sequence[Any] | None=None, idempotency_key: str | None=None) -> Dict[str, Any]
~~~


Append scientific lineage evidence; never authorize the underlying action.

Source: `lightbulb/client.py:3793`.

### `record_server_runtime_outcomes`



~~~python
def record_server_runtime_outcomes(outcomes: List[Dict[str, Any]], *, idempotency_key: str | None=None) -> Dict[str, Any]
~~~


Persist a batch in the authenticated tenant/company runtime ledger.

Source: `lightbulb/client.py:5981`.

### `record_server_workflow_improvement_run`



~~~python
def record_server_workflow_improvement_run(*, idempotency_key: str, contract_score: float, primitive_count: int, check_count: int, passed_check_count: int, trend_direction: str, source_run_id: str | None=None, outcomes: List[Dict[str, Any]] | None=None, metrics: Dict[str, Any] | None=None) -> Dict[str, Any]
~~~


Source: `lightbulb/client.py:6114`.

### `record_workflow_improvement_delivery_event`



~~~python
def record_workflow_improvement_delivery_event(delivery_id: str, event_type: str, *, rationale: str='', evidence: Dict[str, Any] | None=None) -> Dict[str, Any]
~~~


Source: `lightbulb/client.py:6271`.

### `recursive_agent_execute`



~~~python
def recursive_agent_execute(objective: str, *, inputs: Dict[str, Any] | None=None, policy: Any=None, execution_id: str | None=None) -> Dict[str, Any]
~~~


Run a governed recursive objective with finite subagent and REPL limits.

Source: `lightbulb/client.py:6574`.

### `refine_project_creation_preflight`



~~~python
def refine_project_creation_preflight(receipt: ProjectCreationPreflightReceipt, answer: str) -> ProjectCreationPreflightReceipt
~~~


Apply one explicit answer to the receipt's authoritative next question.

Source: `lightbulb/client.py:4589`.

### `refresh_auth`



~~~python
def refresh_auth() -> bool
~~~


Run the configured ``auth_refresh`` callback and swap in fresh auth.

Source: `lightbulb/client.py:3251`.

### `register_external_artifact`



~~~python
def register_external_artifact(*, type: str, title: str='', summary: str='', uri: str='', content: str='', project_id: Optional[str]=None, source_agent: str='external_agent', metadata: Optional[Dict[str, Any]]=None, attach_workspace: bool=False) -> Dict[str, Any]
~~~


Register an external artifact (codebase/document/slide deck/spreadsheet/url) created by a general agent so Lightbulb domain agents can discover and work on it.

Source: `lightbulb/client.py:6418`.

### `register_runtime_domain_action`



~~~python
def register_runtime_domain_action(domain: str, action: str, *, project_id: str, idempotency_key: str, description: str='', component_ids: Sequence[str] | None=None, agent_spec: Dict[str, Any] | None=None, execution_policy: Dict[str, Any] | None=None, company_id: str | None=None) -> Dict[str, Any]
~~~


Register a company-scoped action as ``pending_approval``.

Source: `lightbulb/client.py:7844`.

### `reject_code_workspace_proposal`



~~~python
def reject_code_workspace_proposal(workspace_id: str, proposal_id: str, *, reason: str='') -> Dict[str, Any]
~~~


Reject a proposal.

Source: `lightbulb/client.py:9011`.

### `reject_runtime_domain_action`



~~~python
def reject_runtime_domain_action(runtime_action_id: str, *, project_id: str, company_id: str | None=None) -> Dict[str, Any]
~~~


Reject one reviewed pending registration without executing it.

Source: `lightbulb/client.py:7946`.

### `reject_task`



~~~python
def reject_task(task_id: str, *, comments: str='') -> Dict[str, Any]
~~~


Reject a pending HITL task.

Source: `lightbulb/client.py:6972`.

### `reject_voice_action`



~~~python
def reject_voice_action(execution_id: str, approval_task_id: str, *, comments: str='') -> Dict[str, Any]
~~~


Reject a pending in-call action.

Source: `lightbulb/client.py:8630`.

### `renew_sdk_project_checkpoint_lease`



~~~python
def renew_sdk_project_checkpoint_lease(project_id: str, run_ref: str, *, worker_ref: str, expected_revision: int, lease_seconds: int=60, company_id: str | None=None) -> Dict[str, Any]
~~~


Source: `lightbulb/client.py:5746`.

### `request_training_pair_admission`



~~~python
def request_training_pair_admission(installation_id: str, revision_id: str, *, idempotency_key: str, project_id: str | None=None) -> Dict[str, Any]
~~~


Request admission and preserve the gateway's structured hard 503.

Source: `lightbulb/client.py:8509`.

### `rollback_account_shell_customization`



~~~python
def rollback_account_shell_customization(target_revision_id: str, *, expected_current_revision_id: str | None, idempotency_key: str) -> Dict[str, Any]
~~~


Roll back to an immutable revision with optimistic concurrency.

Source: `lightbulb/client.py:7811`.

### `run_business_primitive`



~~~python
def run_business_primitive(primitive_id: str, inputs: Dict[str, Any] | None=None, *, source: str='sdk', mode: str | None=None, preview_only: bool=True, request: str='') -> Dict[str, Any]
~~~


Run a business primitive through Backbone/domain orchestration.

Source: `lightbulb/client.py:5831`.

### `run_connector_conformance`



~~~python
def run_connector_conformance(*, check_live_schemas: bool=False) -> Dict[str, Any]
~~~


Verify every primitive provider and optionally compare hosted schemas.

Source: `lightbulb/client.py:7036`.

### `run_finance_reconciliation`



~~~python
def run_finance_reconciliation(request: FinanceReconciliationRequest | Mapping[str, Any] | None=None, *, company_id: str | None=None) -> FinanceReconciliationResult
~~~


Run the governed Stripe/ledger reconciliation in Spring.

Source: `lightbulb/client.py:3438`.

### `run_sdk_business_primitive`



~~~python
def run_sdk_business_primitive(primitive_id: str, inputs: Dict[str, Any] | None=None, *, project_ref: str, project_id: str | None=None, preview_only: bool=True, approval_refs: Dict[str, str] | None=None, connector_account_refs: Dict[str, str] | None=None, run_ref: str | None=None, idempotency_key: str | None=None) -> Dict[str, Any]
~~~


Run SDK code with hosted reads, previews, and governed writes.

Source: `lightbulb/client.py:5165`.

### `run_sdk_project_workflow`



~~~python
def run_sdk_project_workflow(project: Any, workflow_key: str, inputs: Dict[str, Any] | None=None, *, preview_only: bool | None=None, approval_refs: Dict[str, str] | None=None, connector_account_refs: Dict[str, str] | None=None, run_ref: str | None=None, registry: Any=None) -> Dict[str, Any]
~~~


Run a project workflow; hosted connector writes remain fail-closed.

Source: `lightbulb/client.py:5791`.

### `run_workflow_improvement_cycle`



~~~python
def run_workflow_improvement_cycle(output_dir: str | os.PathLike[str] | None=None, *, observed_outcomes: List[Dict[str, Any]] | None=None) -> Dict[str, Any]
~~~


Evaluate local workflow contracts and persist proposal-only work packets.

Source: `lightbulb/client.py:5946`.

### `search_agent_marketplace`



~~~python
def search_agent_marketplace(*, query: str | None=None, kind: str | None=None, domain: str | None=None, limit: int=50, include_inputs: bool=True) -> Dict[str, Any]
~~~


Discover normalized Lightbulb action and worker listings.

Source: `lightbulb/client.py:7964`.

### `search_documents`



~~~python
def search_documents(query: str, *, folder_path: str | None=None, top_k: int=10) -> DispatchResult
~~~


Search across all documents using semantic search.

Source: `lightbulb/client.py:4849`.

### `set_approval_preference_state`



~~~python
def set_approval_preference_state(preference_id: str, *, enabled: bool) -> Dict[str, Any]
~~~


Enable or disable an auto-accept rule.

Source: `lightbulb/client.py:9944`.

### `simulate_business_workflow`



~~~python
def simulate_business_workflow(definition: Dict[str, Any], *, events: List[str] | None=None, approvals: Dict[str, Any] | None=None, loop_iterations: int | None=None) -> Dict[str, Any]
~~~


Dry-run a workflow within its bound without invoking live systems.

Source: `lightbulb/client.py:5928`.

### `start_codex_account_link`



~~~python
def start_codex_account_link(*, company_id: str | None=None) -> Dict[str, Any]
~~~


Start the Codex device-auth flow for the current Lightbulb account.

Source: `lightbulb/client.py:3186`.

### `start_project_mission_run`



~~~python
def start_project_mission_run(project_id: str, mission_briefing: Mapping[str, Any], *, confirm_start: bool=False, run_id: Any=None, play_style_id: Any=None, skill_trial_arm: Any=None, selected_skill_ids: Sequence[Any] | None=None, context_source_refs: Sequence[Any] | None=None, note: Any=None, idempotency_key: str | None=None) -> Dict[str, Any]
~~~


Lock an exact briefing before action; this never dispatches a worker.

Source: `lightbulb/client.py:3875`.

### `start_workflow_improvement_delivery`



~~~python
def start_workflow_improvement_delivery(packet_id: str, *, environment: str, repository_ref: str | None=None, base_branch: str='main') -> Dict[str, Any]
~~~


Source: `lightbulb/client.py:6249`.

### `stop_aoc_run`



~~~python
def stop_aoc_run(run_id: str) -> Dict[str, Any]
~~~


Stop an in-flight AutoCompany cognitive-loop run.

Source: `lightbulb/client.py:9430`.

### `stream_chat`



~~~python
def stream_chat(domain: str, *, message: str, action: str | None=None, inputs: Dict[str, Any] | None=None, conversation_id: str | None=None, company_id: str | None=None) -> Generator[SSEEvent, None, None]
~~~


Stream a domain agent chat via Server-Sent Events.

Source: `lightbulb/client.py:3611`.

### `stream_code_workspace_chat`



~~~python
def stream_code_workspace_chat(workspace_id: str, message: str, **kwargs: Any) -> Generator[SSEEvent, None, None]
~~~


Stream a coding agent chat as Server-Sent Events.

Source: `lightbulb/client.py:4685`.

### `stream_document_builder_message`



~~~python
def stream_document_builder_message(session_id: str, content: str) -> Generator[SSEEvent, None, None]
~~~


Stream a document builder message via SSE.

Source: `lightbulb/client.py:4751`.

### `stream_page_builder_message`



~~~python
def stream_page_builder_message(session_id: str, content: str) -> Generator[SSEEvent, None, None]
~~~


Stream a page builder message via SSE (token-by-token output).

Source: `lightbulb/client.py:4714`.

### `stream_page_builder_workspace_automation`



~~~python
def stream_page_builder_workspace_automation(session_id: str, body: Dict[str, Any] | None=None) -> Generator[SSEEvent, None, None]
~~~


Stream the page-builder workspace automation pipeline.

Source: `lightbulb/client.py:4733`.

### `submit_code_workspace_proposal`



~~~python
def submit_code_workspace_proposal(workspace_id: str, body: Dict[str, Any]) -> Dict[str, Any]
~~~


Submit a code-change proposal (diff + summary).

Source: `lightbulb/client.py:8985`.

### `submit_project_creation_preflight_feedback`



~~~python
def submit_project_creation_preflight_feedback(receipt: ProjectCreationPreflightReceipt, *, helpfulness: SemanticFeedbackValue, calibrated_criticality: SemanticFeedbackValue, factual_grounding: SemanticFeedbackValue, idempotency_key: str) -> ProjectPreflightSemanticFeedbackReceipt
~~~


Submit one explicit human judgment for this preflight's episode.

Source: `lightbulb/client.py:4634`.

### `sync_workflow_improvement_report`



~~~python
def sync_workflow_improvement_report(report: Dict[str, Any], *, idempotency_key: str | None=None) -> Dict[str, Any]
~~~


Persist one local evaluator report in the authenticated scoped ledger.

Source: `lightbulb/client.py:6053`.

### `test_agent_runtime_config`



~~~python
def test_agent_runtime_config(agent_type: str='coding', *, message: str | None=None, company_id: str | None=None) -> Dict[str, Any]
~~~


Resolve the configured runtime path without performing code or connector writes.

Source: `lightbulb/client.py:3157`.

### `trigger_workflow`



~~~python
def trigger_workflow(workflow_type: str, objective: str, *, inputs: Dict[str, Any] | None=None, company_id: str | None=None) -> Dict[str, Any]
~~~


Run a published workflow resolved by its public ``workflowType`` ref.

Source: `lightbulb/client.py:6486`.

### `uninstall_marketplace_action`



~~~python
def uninstall_marketplace_action(installation_id: str, *, idempotency_key: str, reason: str='') -> Dict[str, Any]
~~~


Uninstall an action from the selected company.

Source: `lightbulb/client.py:8285`.

### `update_crm_task`



~~~python
def update_crm_task(task_id: str, body: Dict[str, Any], tenant_id: str | None=None) -> Dict[str, Any]
~~~


Update a CRM task.

Source: `lightbulb/client.py:9883`.

### `validate_aoc_run_config`



~~~python
def validate_aoc_run_config(run_id: str) -> Dict[str, Any]
~~~


Validate an AutoCompany run's configuration.

Source: `lightbulb/client.py:9441`.

### `validate_business_workflow`



~~~python
def validate_business_workflow(definition: Dict[str, Any]) -> Dict[str, Any]
~~~


Validate a portable workflow definition without network calls.

Source: `lightbulb/client.py:5922`.

### `validate_sdk_project`



~~~python
def validate_sdk_project(project: Any, *, registry: Any=None) -> Dict[str, Any]
~~~


Validate a custom project against executable primitive implementations.

Source: `lightbulb/client.py:5783`.

### `wait_for_marketplace_action_publication`



~~~python
def wait_for_marketplace_action_publication(publication_id: str, *, timeout_seconds: float=120.0, poll_interval_seconds: float=2.0) -> Dict[str, Any]
~~~


Poll until publication is READY, FAILED, or ARCHIVED, within hard bounds.

Source: `lightbulb/client.py:8142`.

### `wait_for_workflow_instance`



~~~python
def wait_for_workflow_instance(trace_id: str, *, company_id: str | None=None, timeout: float=300.0, poll_interval: float=1.0) -> Dict[str, Any]
~~~


Poll a workflow until it stops or requires human approval.

Source: `lightbulb/client.py:3581`.

### `whoami`



~~~python
def whoami() -> Dict[str, Any]
~~~


Get the current user's identity, role, tenant, company, and permissions.

Source: `lightbulb/client.py:2709`.

### `workspace_bundle`



~~~python
def workspace_bundle(domain: str) -> Dict[str, Any]
~~~


Get a domain workspace data bundle (state, surfaces, recent runs).

Source: `lightbulb/client.py:9983`.

### `workspace_conversation`



~~~python
def workspace_conversation(domain: str, conversation_id: str) -> Dict[str, Any]
~~~


Get a domain workspace conversation.

Source: `lightbulb/client.py:10005`.

### `workspace_surface`



~~~python
def workspace_surface(domain: str, surface: str, **filters: Any) -> Dict[str, Any]
~~~


Read a domain workspace surface (e.g. internal_suite, live connector).

Source: `lightbulb/client.py:10018`.

### `workspace_trace`



~~~python
def workspace_trace(domain: str, trace_id: str) -> Dict[str, Any]
~~~


Get a workspace trace (full agent execution log).

Source: `lightbulb/client.py:9994`.

## Asynchronous Python client

### `__aenter__`



~~~python
async def __aenter__() -> 'AsyncLightbulbClient'
~~~


Source: `lightbulb/async_client.py:231`.

### `__aexit__`



~~~python
async def __aexit__(exc_type, exc, tb) -> None
~~~


Source: `lightbulb/async_client.py:235`.

### `activate_marketplace_action`



~~~python
async def activate_marketplace_action(installation_id: str, *, idempotency_key: str) -> Dict[str, Any]
~~~


Activate an installed action; this never approves execution policy.

Source: `lightbulb/async_client.py:1819`.

### `active_company_id`



~~~python
@property
def active_company_id() -> str | None
~~~


Source: `lightbulb/async_client.py:275`.

### `active_company_id`



~~~python
@active_company_id.setter
def active_company_id(value: str | None) -> None
~~~


Source: `lightbulb/async_client.py:279`.

### `add_project_coding_harness`



~~~python
async def add_project_coding_harness(project_id: str, harness: str, *, make_primary: bool=False) -> Dict[str, Any]
~~~


Attach another harness without removing existing project harnesses.

Source: `lightbulb/async_client.py:777`.

### `admit_project_learning_run`



~~~python
async def admit_project_learning_run(project_id: str, learning_run_id: str, *, runtime: str, capacity_admission: Mapping[str, Any], operator_approved: bool=False, confirm_admission: bool=False, idempotency_key: str | None=None) -> Dict[str, Any]
~~~


Reserve budget and admit a queued run; this still executes no training.

Source: `lightbulb/async_client.py:2879`.

### `approve_runtime_domain_action`



~~~python
async def approve_runtime_domain_action(runtime_action_id: str, *, project_id: str, company_id: str | None=None) -> Dict[str, Any]
~~~


Approve a reviewed action and return its governed recursive reference.

Source: `lightbulb/async_client.py:1493`.

### `approve_task`



~~~python
async def approve_task(task_id: str, *, comments: str='') -> Dict[str, Any]
~~~


Source: `lightbulb/async_client.py:3721`.

### `approve_voice_action`



~~~python
async def approve_voice_action(execution_id: str, approval_task_id: str, *, comments: str='') -> Dict[str, Any]
~~~


Source: `lightbulb/async_client.py:3764`.

### `archive_marketplace_action`



~~~python
async def archive_marketplace_action(listing_id: str, *, idempotency_key: str, reason: str='') -> Dict[str, Any]
~~~


Archive a publisher-owned listing with a replay-safe mutation.

Source: `lightbulb/async_client.py:1730`.

### `async_parity_report`



~~~python
def async_parity_report() -> Dict[str, Any]
~~~


Source: `lightbulb/async_client.py:338`.

### `author_agentic_workflow`



~~~python
async def author_agentic_workflow(prompt: str, *, name: str | None=None, workflow_type: str | None=None, preferred_domains: List[str] | None=None, include_approval_gates: bool=True, publish: bool=True, company_id: str | None=None, site_project_id: str | None=None, definition: Mapping[str, Any] | None=None) -> Dict[str, Any]
~~~


Async compile-once authoring with exact executable-projection fidelity.

Source: `lightbulb/async_client.py:1082`.

### `author_workflow_definition`



~~~python
async def author_workflow_definition(definition: Mapping[str, Any], *, prompt: str='', name: str | None=None, workflow_type: str | None=None, site_project_id: str | None=None, category: str | None=None, change_notes: str | None=None, company_id: str | None=None) -> Dict[str, Any]
~~~


Publish one exact executable workflow projection through governance.

Source: `lightbulb/async_client.py:934`.

### `author_workflow_trigger`



~~~python
async def author_workflow_trigger(workflow_definition_id: str, *, trigger_type: str='schedule', schedule: str | None=None, event_type: str | None=None, event_filter: Mapping[str, Any] | None=None, name: str | None=None, description: str | None=None, site_project_id: str | None=None, configuration: Mapping[str, Any] | None=None, enabled: bool=False, company_id: str | None=None) -> Dict[str, Any]
~~~


Create a principal-scoped schedule or event trigger for a workflow.

Source: `lightbulb/async_client.py:985`.

### `backbone_execute`



~~~python
async def backbone_execute(objective: str, *, inputs: Dict[str, Any] | None=None) -> Dict[str, Any]
~~~


Execute a task through the tenant-scoped backbone agent.

Source: `lightbulb/async_client.py:3602`.

### `bind_project_mission_action`



~~~python
async def bind_project_mission_action(project_id: str, mission_run_receipt_id: Any, action_event_id: Any, *, confirm_bind: bool=False, binding_id: Any=None, note: Any=None, idempotency_key: str | None=None) -> Dict[str, Any]
~~~


Bind a later event to a mission; this proves timing and scope only.

Source: `lightbulb/async_client.py:2708`.

### `cancel_recursive_agent_execution`



~~~python
async def cancel_recursive_agent_execution(execution_id: str) -> Dict[str, Any]
~~~


Cancel one exact user-owned recursive execution tree.

Source: `lightbulb/async_client.py:3651`.

### `claim_project_coding_handoff`



~~~python
async def claim_project_coding_handoff(project_id: str, *, harness: str, handoff_payload_id: str, host_session_ref: str | None=None) -> Dict[str, Any]
~~~


Record routing of an approved handoff to the selected harness.

Source: `lightbulb/async_client.py:823`.

### `close`



~~~python
async def close() -> None
~~~


Source: `lightbulb/async_client.py:243`.

### `code_workspace_chat`



~~~python
async def code_workspace_chat(workspace_id: str, message: str, **kwargs: Any) -> Dict[str, Any]
~~~


Source: `lightbulb/async_client.py:3565`.

### `context_company_id`



~~~python
@property
def context_company_id() -> str | None
~~~


Company used only by forwarded Context Broker calls.

Source: `lightbulb/async_client.py:285`.

### `context_company_id`



~~~python
@context_company_id.setter
def context_company_id(value: str | None) -> None
~~~


Source: `lightbulb/async_client.py:294`.

### `create_account_shell_customization_draft`



~~~python
async def create_account_shell_customization_draft(document: Mapping[str, Any], *, base_revision_id: str | None) -> Dict[str, Any]
~~~


Create an immutable draft from one exact base revision.

Source: `lightbulb/async_client.py:1309`.

### `create_project_from_preflight`



~~~python
async def create_project_from_preflight(receipt: ProjectCreationPreflightReceipt, *, coding_harness: str, confirm_create: bool=False, confirm_open_questions: bool=False, workspace_id: str | None=None, repo_connection_id: str | None=None, idempotency_key: str | None=None, play_style: str | None=None) -> Dict[str, Any]
~~~


Create exactly the draft bound to a validated preflight receipt.

Source: `lightbulb/async_client.py:3314`.

### `create_server_workflow_improvement_packet`



~~~python
async def create_server_workflow_improvement_packet(payload: Dict[str, Any]) -> Dict[str, Any]
~~~


Source: `lightbulb/async_client.py:2136`.

### `decide_project_learning_result_admission`



~~~python
async def decide_project_learning_result_admission(project_id: str, evaluation_receipt_id: str, *, decision: Any, rationale: Any, confirm_admission: bool=False, idempotency_key: str | None=None) -> Dict[str, Any]
~~~


Human admit/reject; never apply or promote the candidate.

Source: `lightbulb/async_client.py:2938`.

### `decide_workflow_improvement_packet`



~~~python
async def decide_workflow_improvement_packet(packet_id: str, *, approval_scope: str, decision: str, rationale: str='', evidence: Dict[str, Any] | None=None) -> Dict[str, Any]
~~~


Source: `lightbulb/async_client.py:2184`.

### `dispatch`



~~~python
async def dispatch(domain: str, *, action: str='chat', message: str='', objective: str='', inputs: Dict[str, Any] | None=None, conversation_id: str | None=None, company_id: str | None=None) -> DispatchResult
~~~


Source: `lightbulb/async_client.py:2371`.

### `document_builder_get_messages`



~~~python
async def document_builder_get_messages(session_id: str, **filters: Any) -> List[Dict[str, Any]]
~~~


Source: `lightbulb/async_client.py:3699`.

### `dynamic_workflow_attach`



~~~python
async def dynamic_workflow_attach(*, company_ref: str, project_ref: str, run_ref: str, host: str, host_session_ref: str, host_role: str, expected_revision: int, idempotency_key: str) -> Dict[str, Any]
~~~


Source: `lightbulb/async_client.py:522`.

### `dynamic_workflow_cancel`



~~~python
async def dynamic_workflow_cancel(*, company_ref: str, project_ref: str, run_ref: str, host_binding_ref: str, session_receipt: str, host_role: str, expected_revision: int, idempotency_key: str, reason: str) -> Dict[str, Any]
~~~


Source: `lightbulb/async_client.py:716`.

### `dynamic_workflow_next_assignment`



~~~python
async def dynamic_workflow_next_assignment(*, company_ref: str, project_ref: str, run_ref: str, host_binding_ref: str, session_receipt: str, host_role: str, expected_revision: int, idempotency_key: str) -> Dict[str, Any]
~~~


Source: `lightbulb/async_client.py:570`.

### `dynamic_workflow_start`



~~~python
async def dynamic_workflow_start(*, company_ref: str, project_ref: str, objective: str, acceptance_criteria: Sequence[Mapping[str, Any]], host: str, expected_revision: int, idempotency_key: str, host_session_ref: str | None=None, acceptance_policy: str='distinct_binding', workflow_spec: Mapping[str, Any] | None=None, inputs: Mapping[str, Any] | None=None) -> Dict[str, Any]
~~~


Source: `lightbulb/async_client.py:489`.

### `dynamic_workflow_status`



~~~python
async def dynamic_workflow_status(*, company_ref: str, project_ref: str, run_ref: str, host_binding_ref: str, session_receipt: str, host_role: str) -> Dict[str, Any]
~~~


Source: `lightbulb/async_client.py:548`.

### `dynamic_workflow_submit_builder_result`



~~~python
async def dynamic_workflow_submit_builder_result(*, company_ref: str, project_ref: str, run_ref: str, host_binding_ref: str, session_receipt: str, host_role: str, assignment_ref: str, assignment_receipt: str, expected_revision: int, idempotency_key: str, outcome: str, summary: str, plan_digest: str, iteration: int, evidence_refs: Sequence[Mapping[str, Any]], progress_digest: str) -> Dict[str, Any]
~~~


Source: `lightbulb/async_client.py:630`.

### `dynamic_workflow_submit_evaluator_verdict`



~~~python
async def dynamic_workflow_submit_evaluator_verdict(*, company_ref: str, project_ref: str, run_ref: str, host_binding_ref: str, session_receipt: str, host_role: str, assignment_ref: str, assignment_receipt: str, expected_revision: int, idempotency_key: str, decision: str, accepted: bool, summary: str, plan_digest: str, builder_result_digest: str, required_criterion_ids: Sequence[str], criterion_results: Sequence[Mapping[str, Any]]) -> Dict[str, Any]
~~~


Source: `lightbulb/async_client.py:672`.

### `dynamic_workflow_submit_plan`



~~~python
async def dynamic_workflow_submit_plan(*, company_ref: str, project_ref: str, run_ref: str, host_binding_ref: str, session_receipt: str, host_role: str, assignment_ref: str, assignment_receipt: str, expected_revision: int, idempotency_key: str, required_criterion_ids: Sequence[str], plan: Mapping[str, Any]) -> Dict[str, Any]
~~~


Source: `lightbulb/async_client.py:596`.

### `evaluate_project_offline_policy`



~~~python
async def evaluate_project_offline_policy(project_id: str, *, behavior_policy_id: Any, candidate_policy_id: Any, metric_id: Any, pairs: Sequence[Mapping[str, Any]], confirm_evaluate: bool=False, evaluation_id: Any=None, note: Any=None, idempotency_key: str | None=None) -> Dict[str, Any]
~~~


Estimate a candidate from verified receipts; never admit learning.

Source: `lightbulb/async_client.py:3219`.

### `forwarded_sync_methods`



~~~python
def forwarded_sync_methods() -> list[str]
~~~


Public sync operations supplied by the managed thread bridge.

Source: `lightbulb/async_client.py:328`.

### `get_account_shell_customization`



~~~python
async def get_account_shell_customization() -> Dict[str, Any]
~~~


Read the effective governed account-shell customization.

Source: `lightbulb/async_client.py:1299`.

### `get_code_workspace_active_run`



~~~python
async def get_code_workspace_active_run(workspace_id: str) -> Dict[str, Any] | None
~~~


Source: `lightbulb/async_client.py:3589`.

### `get_code_workspace_run`



~~~python
async def get_code_workspace_run(workspace_id: str, run_id: str) -> Dict[str, Any]
~~~


Source: `lightbulb/async_client.py:3580`.

### `get_marketplace_action_publication`



~~~python
async def get_marketplace_action_publication(publication_id: str) -> Dict[str, Any]
~~~


Get governed publication and security-scan status by publication UUID.

Source: `lightbulb/async_client.py:1690`.

### `get_marketplace_installation`



~~~python
async def get_marketplace_installation(installation_id: str) -> Dict[str, Any]
~~~


Get one marketplace installation for the selected active company.

Source: `lightbulb/async_client.py:1779`.

### `get_marketplace_invocation_receipt`



~~~python
async def get_marketplace_invocation_receipt(invocation_id: str) -> Dict[str, Any]
~~~


Get the immutable audit receipt for one marketplace invocation.

Source: `lightbulb/async_client.py:1950`.

### `get_marketplace_invocation_status`



~~~python
async def get_marketplace_invocation_status(invocation_id: str) -> Dict[str, Any]
~~~


Get current invocation state for the selected company.

Source: `lightbulb/async_client.py:1938`.

### `get_marketplace_listing`



~~~python
async def get_marketplace_listing(listing_id: str, *, revision_id: str | None=None, include_inputs: bool=True) -> Dict[str, Any]
~~~


Get one persisted marketplace listing and optional immutable revision.

Source: `lightbulb/async_client.py:1598`.

### `get_project_coding_handoff`



~~~python
async def get_project_coding_handoff(project_id: str, harness: str) -> Dict[str, Any]
~~~


Read the selected Project Agent handoff for a connected harness.

Source: `lightbulb/async_client.py:803`.

### `get_project_coding_harnesses`



~~~python
async def get_project_coding_harnesses(project_id: str) -> Dict[str, Any]
~~~


Read the durable additive harness selection for one project.

Source: `lightbulb/async_client.py:763`.

### `get_project_game_snapshot`



~~~python
async def get_project_game_snapshot(project_id: str) -> Dict[str, Any]
~~~


Fetch and validate one server-owned, exact-scoped project snapshot.

Source: `lightbulb/async_client.py:2506`.

### `get_recursive_agent_execution_status`



~~~python
async def get_recursive_agent_execution_status(execution_id: str) -> Dict[str, Any]
~~~


Read privacy-minimized status for one exact user-owned recursive tree.

Source: `lightbulb/async_client.py:3664`.

### `get_runtime_domain_action`



~~~python
async def get_runtime_domain_action(runtime_action_id: str, *, project_id: str, company_id: str | None=None) -> Dict[str, Any]
~~~


Review one exact-scope registration without changing its lifecycle.

Source: `lightbulb/async_client.py:1475`.

### `get_server_workflow_improvement_packet`



~~~python
async def get_server_workflow_improvement_packet(packet_id: str) -> Dict[str, Any]
~~~


Read one exact tenant/company-scoped workflow improvement packet.

Source: `lightbulb/async_client.py:2171`.

### `get_server_workflow_improvement_status`



~~~python
async def get_server_workflow_improvement_status() -> Dict[str, Any]
~~~


Source: `lightbulb/async_client.py:2146`.

### `get_training_pair_status`



~~~python
async def get_training_pair_status(pair_handle: str, *, project_id: str | None=None) -> Dict[str, Any]
~~~


Read the privacy-minimized status for one exact owned pair handle.

Source: `lightbulb/async_client.py:2081`.

### `get_workflow_improvement_audit`



~~~python
async def get_workflow_improvement_audit(packet_id: str) -> List[Dict[str, Any]]
~~~


Read the immutable scoped audit trail for one workflow packet.

Source: `lightbulb/async_client.py:2254`.

### `get_workflow_improvement_delivery`



~~~python
async def get_workflow_improvement_delivery(delivery_id: str) -> Dict[str, Any]
~~~


Read one exact scoped workflow-improvement delivery.

Source: `lightbulb/async_client.py:2268`.

### `get_workflow_instance`



~~~python
async def get_workflow_instance(trace_id: str, *, company_id: str | None=None) -> Dict[str, Any]
~~~


Get a workflow instance through the authenticated public API.

Source: `lightbulb/async_client.py:2419`.

### `get_workflow_trigger_catalog`



~~~python
async def get_workflow_trigger_catalog() -> Dict[str, Any]
~~~


List the schedule literals and event types accepted by authoring.

Source: `lightbulb/async_client.py:1069`.

### `inspect_project_creation_world_ready`



~~~python
def inspect_project_creation_world_ready(name: str, instructions: str='', *, participant_role: str='agent_worker', experience_lens: str='agent_protocol', play_style: str='guided_human_in_the_loop') -> dict[str, Any]
~~~


Inspect project-review readiness locally without network activity.

Source: `lightbulb/async_client.py:3260`.

### `inspect_project_game_campaign`



~~~python
def inspect_project_game_campaign(*, project: dict[str, Any] | None=None, plan: dict[str, Any] | None=None, business_cockpit: dict[str, Any] | None=None) -> dict[str, Any]
~~~


Inspect the human/agent project campaign locally without network activity.

Source: `lightbulb/async_client.py:2550`.

### `inspect_training_pair_input_custody`



~~~python
async def inspect_training_pair_input_custody(installation_id: str, revision_id: str, *, project_id: str | None=None) -> Dict[str, Any]
~~~


Inspect exact-owner input custody without widening authority.

Source: `lightbulb/async_client.py:1992`.

### `inspect_training_pair_readiness`



~~~python
async def inspect_training_pair_readiness(installation_id: str, revision_id: str, *, project_id: str | None=None) -> Dict[str, Any]
~~~


Inspect structured readiness without admitting or launching training.

Source: `lightbulb/async_client.py:1964`.

### `inspect_workflow_learning_candidate_attestation`



~~~python
async def inspect_workflow_learning_candidate_attestation(delivery_id: str) -> Dict[str, Any]
~~~


Revalidate the exact candidate producer attestation using current keys.

Source: `lightbulb/async_client.py:2281`.

### `install_marketplace_action`



~~~python
async def install_marketplace_action(listing_id: str, revision_id: str, *, idempotency_key: str, deployment_targets: Sequence[str] | None=None) -> Dict[str, Any]
~~~


Install a pinned revision and bind its explicit agent targets.

Source: `lightbulb/async_client.py:1791`.

### `invoke_marketplace_action`



~~~python
async def invoke_marketplace_action(installation_id: str, inputs: Dict[str, Any] | None=None, *, idempotency_key: str, message: str='', objective: str='', dry_run: bool=True, preview_invocation_id: str | None=None, confirm_live: bool=False) -> Dict[str, Any]
~~~


Preview an installed action, or explicitly confirm an exact preview for live use.

Source: `lightbulb/async_client.py:1893`.

### `invoke_tool`



~~~python
async def invoke_tool(tool_name: str, arguments: Dict[str, Any], *, project_id: str | None=None, project_ref: str | None=None, connector_account_ref: str | None=None, idempotency_key: str | None=None, approval_ref: str | None=None, workflow_id: str | None=None, step_id: str | None=None, workflow_instance_id: str | None=None, workflow_step_generation: int | None=None, runtime_context: Dict[str, Any] | None=None, effect: str | None=None) -> Dict[str, Any]
~~~


Invoke a utility through legacy routing or a connector through exact custody.

Source: `lightbulb/async_client.py:3799`.

### `list_aoc_runs`



~~~python
async def list_aoc_runs(**filters: Any) -> List[Dict[str, Any]]
~~~


Source: `lightbulb/async_client.py:3776`.

### `list_business_primitives`



~~~python
async def list_business_primitives(*, category: str | None=None, query: str | None=None, include_inputs: bool=True) -> List[Dict[str, Any]]
~~~


List local business-primitive contracts without a network call.

Source: `lightbulb/async_client.py:918`.

### `list_code_workspaces`



~~~python
async def list_code_workspaces() -> List[Dict[str, Any]]
~~~


Source: `lightbulb/async_client.py:3559`.

### `list_companies`



~~~python
async def list_companies() -> List[Dict[str, Any]]
~~~


Source: `lightbulb/async_client.py:752`.

### `list_connected_integrations`



~~~python
async def list_connected_integrations(company_id: str | None=None) -> List[Dict[str, Any]]
~~~


Source: `lightbulb/async_client.py:2110`.

### `list_domain_actions`



~~~python
async def list_domain_actions(domain: str) -> List[Dict[str, Any]]
~~~


List authenticated, RBAC-visible actions for one domain.

Source: `lightbulb/async_client.py:1234`.

### `list_domains`



~~~python
async def list_domains() -> Dict[str, Dict[str, Any]] | List[Dict[str, Any]]
~~~


Source: `lightbulb/async_client.py:1225`.

### `list_marketplace_installations`



~~~python
async def list_marketplace_installations(*, status: str | None=None, cursor: str | None=None, limit: int=50) -> Dict[str, Any]
~~~


List marketplace installations for the selected active company.

Source: `lightbulb/async_client.py:1756`.

### `list_marketplace_listings`



~~~python
async def list_marketplace_listings(*, query: str | None=None, kind: str | None=None, domain: str | None=None, cursor: str | None=None, limit: int=50, include_inputs: bool=True) -> Dict[str, Any]
~~~


List persisted lifecycle listings and authoritative UUID IDs.

Source: `lightbulb/async_client.py:1566`.

### `list_pending_approvals`



~~~python
async def list_pending_approvals() -> List[Dict[str, Any]]
~~~


Source: `lightbulb/async_client.py:3712`.

### `list_project_business_outcomes`



~~~python
async def list_project_business_outcomes(project_id: str, *, limit: int=25) -> Dict[str, Any]
~~~


Read the authenticated score ledger for one accessible project.

Source: `lightbulb/async_client.py:3052`.

### `list_project_learning_result_evaluations`



~~~python
async def list_project_learning_result_evaluations(project_id: str, *, limit: int=25) -> Dict[str, Any]
~~~


Read independent technical results and separate human decisions.

Source: `lightbulb/async_client.py:2918`.

### `list_project_learning_reviews`



~~~python
async def list_project_learning_reviews(project_id: str, *, limit: int=25) -> Dict[str, Any]
~~~


Read human after-action decisions and admitted shadow observations.

Source: `lightbulb/async_client.py:2745`.

### `list_project_learning_runs`



~~~python
async def list_project_learning_runs(project_id: str, *, limit: int=25) -> Dict[str, Any]
~~~


Read receipt-backed Training Quest state without inferring missing execution.

Source: `lightbulb/async_client.py:2802`.

### `list_project_mission_runs`



~~~python
async def list_project_mission_runs(project_id: str, *, limit: int=25) -> Dict[str, Any]
~~~


Read briefing locks and action bindings for one accessible project.

Source: `lightbulb/async_client.py:2646`.

### `list_project_policy_assignments`



~~~python
async def list_project_policy_assignments(project_id: str, *, limit: int=25) -> Dict[str, Any]
~~~


Read immutable decision-time probability assignments for one project.

Source: `lightbulb/async_client.py:3124`.

### `list_project_policy_evaluations`



~~~python
async def list_project_policy_evaluations(project_id: str, *, limit: int=25) -> Dict[str, Any]
~~~


Read offline-policy receipts and their explicit truth boundary.

Source: `lightbulb/async_client.py:3200`.

### `list_project_science_evidence`



~~~python
async def list_project_science_evidence(project_id: str, *, limit: int=50) -> Dict[str, Any]
~~~


Read the scope-verified hypothesis-to-policy context spine.

Source: `lightbulb/async_client.py:2564`.

### `list_project_shadow_learner_updates`



~~~python
async def list_project_shadow_learner_updates(project_id: str, *, limit: int=25) -> Dict[str, Any]
~~~


Read bounded shadow update/rollback receipts; this grants no authority.

Source: `lightbulb/async_client.py:2978`.

### `list_project_skill_matches`



~~~python
async def list_project_skill_matches(project_id: str, *, limit: int=25) -> Dict[str, Any]
~~~


Read the project's worker-verified shadow Training Arena ledger.

Source: `lightbulb/async_client.py:2764`.

### `list_project_training_packs`



~~~python
async def list_project_training_packs(project_id: str, *, limit: int=25) -> Dict[str, Any]
~~~


Read exact Arena + human-lesson packs before any learning-run admission.

Source: `lightbulb/async_client.py:2783`.

### `list_runtime_domain_actions`



~~~python
async def list_runtime_domain_actions(*, project_id: str, status: str='pending_approval', company_id: str | None=None) -> Dict[str, Any]
~~~


List one explicit lifecycle state for the selected company.

Source: `lightbulb/async_client.py:1456`.

### `list_server_workflow_improvement_packets`



~~~python
async def list_server_workflow_improvement_packets(*, status: str | None=None, limit: int=50) -> List[Dict[str, Any]]
~~~


Source: `lightbulb/async_client.py:2155`.

### `list_voice_executions`



~~~python
async def list_voice_executions(**filters: Any) -> List[Dict[str, Any]]
~~~


Source: `lightbulb/async_client.py:3743`.

### `list_voice_pending_approvals`



~~~python
async def list_voice_pending_approvals() -> List[Dict[str, Any]]
~~~


Source: `lightbulb/async_client.py:3754`.

### `memory_regulate`



~~~python
async def memory_regulate(*, idempotency_key: str | None=None, project_id: str | None=None, budget: int | None=None, categories: Sequence[str] | None=None, dry_run: bool=True, max_summary_chars: int=900, empirical_success_floor_ppm: int | None=None, empirical_success_min_samples: int=20, empirical_success_lookback_days: int=90, optimize_for_least_active_memory: bool=False, held_out_task_evaluation: Mapping[str, Any] | None=None) -> Dict[str, Any]
~~~


Preview or execute success-evidence-aware Memory compaction.

Source: `lightbulb/async_client.py:1257`.

### `memory_regulation_storage_status`



~~~python
async def memory_regulation_storage_status() -> Dict[str, Any]
~~~


Inspect finite compaction-receipt admission without mutation.

Source: `lightbulb/async_client.py:1247`.

### `native_async_methods`



~~~python
def native_async_methods() -> list[str]
~~~


Public operations implemented directly with async I/O.

Source: `lightbulb/async_client.py:318`.

### `page_builder_send_message`



~~~python
async def page_builder_send_message(session_id: str, content: str) -> Dict[str, Any]
~~~


Source: `lightbulb/async_client.py:3689`.

### `pin_marketplace_action`



~~~python
async def pin_marketplace_action(installation_id: str, revision_id: str, *, idempotency_key: str, expected_revision_id: str | None=None) -> Dict[str, Any]
~~~


Pin an installation to an immutable listing revision.

Source: `lightbulb/async_client.py:1864`.

### `preflight_project_creation`



~~~python
async def preflight_project_creation(name: str, instructions: str='') -> ProjectCreationPreflightReceipt
~~~


Run the typed, shadow/read-only project-creation preflight.

Source: `lightbulb/async_client.py:3282`.

### `preflight_training_pair`



~~~python
async def preflight_training_pair(installation_id: str, revision_id: str, *, project_id: str | None=None) -> Dict[str, Any]
~~~


Read readiness without admitting, scheduling, or launching training.

Source: `lightbulb/async_client.py:2020`.

### `prepare_project_learning_run`



~~~python
async def prepare_project_learning_run(project_id: str, *, training_pack_receipt_id: Any, primary_metric: Any, runtime: str='automl', request_id: Any=None, direction: str='maximize', minimum_improvement: Any='0.010000', max_cost_usd: Any='0.000000', max_platform_cost_usd: Any='5.000000', max_gpu_seconds: Any=3600, max_tokens: Any=100000, max_steps: Any=10000, provider_account_fingerprint: Any=None, provider_binding_expires_at: Any=None, max_attempts: Any=3, lease_seconds: Any=300, preemptible: bool=True, confirm_prepare: bool=False, idempotency_key: str | None=None) -> Dict[str, Any]
~~~


Publish exact dataset custody and create a queued durable Memory run.

Source: `lightbulb/async_client.py:2821`.

### `prepare_workflow_learning_handoff`



~~~python
async def prepare_workflow_learning_handoff(packet_id: str, delivery_id: str, installation_id: str, revision_id: str, *, candidate_manifest: Dict[str, Any], episode_manifest: Dict[str, Any] | None=None, project_id: str | None=None) -> Dict[str, Any]
~~~


Bind a validated delivery to read-only paired-learning readiness.

Source: `lightbulb/async_client.py:2300`.

### `preview_account_shell_customization`



~~~python
async def preview_account_shell_customization(draft_revision_id: str) -> Dict[str, Any]
~~~


Compile a draft into a non-publishing preview receipt.

Source: `lightbulb/async_client.py:1333`.

### `preview_marketplace_action_publication`



~~~python
async def preview_marketplace_action_publication(*, slug: str, name: str, version: str, domain: str, action: str, visibility: str='PRIVATE', pricing_model: str='INCLUDED', changelog: str='') -> Dict[str, Any]
~~~


Preview a server-derived immutable action contract without publishing it.

Source: `lightbulb/async_client.py:1619`.

### `publish_account_shell_customization`



~~~python
async def publish_account_shell_customization(draft_revision_id: str, *, preview_receipt_id: str, expected_current_revision_id: str | None, idempotency_key: str) -> Dict[str, Any]
~~~


Publish the exact previewed draft with optimistic concurrency.

Source: `lightbulb/async_client.py:1354`.

### `publish_marketplace_action`



~~~python
async def publish_marketplace_action(*, slug: str, name: str, version: str, domain: str, action: str, expected_contract_digest: str, idempotency_key: str, visibility: str='PRIVATE', pricing_model: str='INCLUDED', changelog: str='') -> Dict[str, Any]
~~~


Publish the exact action contract approved by a prior preview.

Source: `lightbulb/async_client.py:1651`.

### `record_project_business_outcome`



~~~python
async def record_project_business_outcome(project_id: str, *, metric_id: Any, metric_label: Any, direction: Any, baseline_value: Any, observed_value: Any, confirm_record: bool=False, unit: Any=None, observed_at: Any=None, observation_id: Any=None, source_kind: str='human_attestation', source_event_id: Any=None, evidence_refs: Sequence[Any] | None=None, links: Mapping[str, Any] | None=None, note: Any=None, idempotency_key: str | None=None) -> Dict[str, Any]
~~~


Append one scoped metric observation; never admit learning or promotion.

Source: `lightbulb/async_client.py:3071`.

### `record_project_coding_harness_result`



~~~python
async def record_project_coding_harness_result(project_id: str, *, harness: str, handoff_payload_id: str, status: str, summary: str, report_id: str | None=None, host_session_ref: str | None=None, changed_files: Sequence[str] | None=None, test_commands_and_results: Sequence[str] | None=None, unresolved_requirements_or_acceptance_gaps: str | None=None, pull_request_url: str | None=None, commit_sha: str | None=None) -> Dict[str, Any]
~~~


Return bounded coding evidence to the Project Agent delivery loop.

Source: `lightbulb/async_client.py:865`.

### `record_project_learning_review`



~~~python
async def record_project_learning_review(project_id: str, *, mission_run_receipt_id: Any, mission_action_receipt_id: Any, outcome_receipt_id: Any, decision: Any, skill_trial_arm: Any, selected_skill_ids: Sequence[Any] | None, label: Any, reason: Any, confirm_record: bool=False, review_id: Any=None, evidence_refs: Sequence[Any] | None=None, idempotency_key: str | None=None) -> Dict[str, Any]
~~~


Human-review one exact chain for shadow training; no live learner mutation.

Source: `lightbulb/async_client.py:3003`.

### `record_project_policy_assignment`



~~~python
async def record_project_policy_assignment(project_id: str, *, metric_id: Any, direction: Any, actions: Sequence[Mapping[str, Any]], chosen_action_id: Any, behavior_policy: Mapping[str, Any], candidate_policies: Sequence[Mapping[str, Any]], confirm_record: bool=False, assignment_id: Any=None, unit: Any=None, decided_at: Any=None, source_kind: str='human_attestation', source_event_id: Any=None, evidence_refs: Sequence[Any] | None=None, links: Mapping[str, Any] | None=None, note: Any=None, idempotency_key: str | None=None) -> Dict[str, Any]
~~~


Log propensities before an outcome; this never executes an action.

Source: `lightbulb/async_client.py:3143`.

### `record_project_science_evidence`



~~~python
async def record_project_science_evidence(project_id: str, *, stage: Any, summary: Any, business_metric_id: Any, expected_direction: Any, artifact_kind: Any, artifact_system: Any, artifact_reference: Any, artifact_digest_sha256: Any, producer_role: Any, confirm_record: bool=False, tool_names: Sequence[Any] | None=None, skill_ids: Sequence[Any] | None=None, parent_receipt_ids: Sequence[Any] | None=None, artifact_schema: Any=None, observed_at: Any=None, evidence_id: Any=None, source_kind: str='human_attestation', source_event_id: Any=None, evidence_refs: Sequence[Any] | None=None, idempotency_key: str | None=None) -> Dict[str, Any]
~~~


Append scientific lineage evidence; never authorize the underlying action.

Source: `lightbulb/async_client.py:2583`.

### `record_server_workflow_improvement_run`



~~~python
async def record_server_workflow_improvement_run(payload: Dict[str, Any]) -> Dict[str, Any]
~~~


Persist a pre-sanitized evaluator run in the authenticated company scope.

Source: `lightbulb/async_client.py:2125`.

### `record_workflow_improvement_delivery_event`



~~~python
async def record_workflow_improvement_delivery_event(delivery_id: str, event_type: str, *, rationale: str='', evidence: Dict[str, Any] | None=None) -> Dict[str, Any]
~~~


Source: `lightbulb/async_client.py:2234`.

### `recursive_agent_execute`



~~~python
async def recursive_agent_execute(objective: str, *, inputs: Dict[str, Any] | None=None, policy: Any=None, execution_id: str | None=None) -> Dict[str, Any]
~~~


Run a governed recursive objective with finite subagent and REPL limits.

Source: `lightbulb/async_client.py:3627`.

### `refine_project_creation_preflight`



~~~python
async def refine_project_creation_preflight(receipt: ProjectCreationPreflightReceipt, answer: str) -> ProjectCreationPreflightReceipt
~~~


Async parity for one explicit, receipt-bound preflight answer.

Source: `lightbulb/async_client.py:3376`.

### `refresh_auth`



~~~python
async def refresh_auth() -> bool
~~~


Async equivalent of :meth:`LightbulbClient.refresh_auth`.

Source: `lightbulb/async_client.py:253`.

### `register_runtime_domain_action`



~~~python
async def register_runtime_domain_action(domain: str, action: str, *, project_id: str, idempotency_key: str, description: str='', component_ids: Sequence[str] | None=None, agent_spec: Dict[str, Any] | None=None, execution_policy: Dict[str, Any] | None=None, company_id: str | None=None) -> Dict[str, Any]
~~~


Register a company-scoped action as ``pending_approval`` only.

Source: `lightbulb/async_client.py:1419`.

### `reject_runtime_domain_action`



~~~python
async def reject_runtime_domain_action(runtime_action_id: str, *, project_id: str, company_id: str | None=None) -> Dict[str, Any]
~~~


Reject one reviewed pending registration without executing it.

Source: `lightbulb/async_client.py:1516`.

### `reject_task`



~~~python
async def reject_task(task_id: str, *, comments: str='') -> Dict[str, Any]
~~~


Source: `lightbulb/async_client.py:3731`.

### `request_training_pair_admission`



~~~python
async def request_training_pair_admission(installation_id: str, revision_id: str, *, idempotency_key: str, project_id: str | None=None) -> Dict[str, Any]
~~~


Request admission while preserving only the structured hard-503 body.

Source: `lightbulb/async_client.py:2048`.

### `rollback_account_shell_customization`



~~~python
async def rollback_account_shell_customization(target_revision_id: str, *, expected_current_revision_id: str | None, idempotency_key: str) -> Dict[str, Any]
~~~


Roll back to an immutable revision with optimistic concurrency.

Source: `lightbulb/async_client.py:1388`.

### `search_agent_marketplace`



~~~python
async def search_agent_marketplace(*, query: str | None=None, kind: str | None=None, domain: str | None=None, limit: int=50, include_inputs: bool=True) -> Dict[str, Any]
~~~


Discover synthetic rows; use the persisted list for lifecycle UUIDs.

Source: `lightbulb/async_client.py:1534`.

### `search_documents`



~~~python
async def search_documents(query: str, *, top_k: int=10) -> Dict[str, Any]
~~~


Source: `lightbulb/async_client.py:3680`.

### `start_project_mission_run`



~~~python
async def start_project_mission_run(project_id: str, mission_briefing: Mapping[str, Any], *, confirm_start: bool=False, run_id: Any=None, play_style_id: Any=None, skill_trial_arm: Any=None, selected_skill_ids: Sequence[Any] | None=None, context_source_refs: Sequence[Any] | None=None, note: Any=None, idempotency_key: str | None=None) -> Dict[str, Any]
~~~


Lock an exact briefing before action; this never dispatches a worker.

Source: `lightbulb/async_client.py:2665`.

### `start_workflow_improvement_delivery`



~~~python
async def start_workflow_improvement_delivery(packet_id: str, *, environment: str, repository_ref: str | None=None, base_branch: str='main') -> Dict[str, Any]
~~~


Source: `lightbulb/async_client.py:2210`.

### `stop_aoc_run`



~~~python
async def stop_aoc_run(run_id: str) -> Dict[str, Any]
~~~


Source: `lightbulb/async_client.py:3787`.

### `stream_chat`



~~~python
async def stream_chat(domain: str, *, message: str, action: str | None=None, inputs: Dict[str, Any] | None=None, conversation_id: str | None=None, company_id: str | None=None) -> AsyncGenerator[SSEEvent, None]
~~~


Source: `lightbulb/async_client.py:2469`.

### `stream_code_workspace_chat`



~~~python
async def stream_code_workspace_chat(workspace_id: str, message: str, **kwargs: Any) -> AsyncGenerator[SSEEvent, None]
~~~


Source: `lightbulb/async_client.py:3463`.

### `stream_document_builder_message`



~~~python
async def stream_document_builder_message(session_id: str, content: str) -> AsyncGenerator[SSEEvent, None]
~~~


Source: `lightbulb/async_client.py:3492`.

### `stream_page_builder_message`



~~~python
async def stream_page_builder_message(session_id: str, content: str) -> AsyncGenerator[SSEEvent, None]
~~~


Source: `lightbulb/async_client.py:3481`.

### `submit_project_creation_preflight_feedback`



~~~python
async def submit_project_creation_preflight_feedback(receipt: ProjectCreationPreflightReceipt, *, helpfulness: SemanticFeedbackValue, calibrated_criticality: SemanticFeedbackValue, factual_grounding: SemanticFeedbackValue, idempotency_key: str) -> ProjectPreflightSemanticFeedbackReceipt
~~~


Async parity for explicit project-preflight semantic feedback.

Source: `lightbulb/async_client.py:3420`.

### `uninstall_marketplace_action`



~~~python
async def uninstall_marketplace_action(installation_id: str, *, idempotency_key: str, reason: str='') -> Dict[str, Any]
~~~


Uninstall an action from the selected company.

Source: `lightbulb/async_client.py:1840`.

### `wait_for_marketplace_action_publication`



~~~python
async def wait_for_marketplace_action_publication(publication_id: str, *, timeout_seconds: float=120.0, poll_interval_seconds: float=2.0) -> Dict[str, Any]
~~~


Poll until publication is READY, FAILED, or ARCHIVED, within hard bounds.

Source: `lightbulb/async_client.py:1701`.

### `wait_for_workflow_instance`



~~~python
async def wait_for_workflow_instance(trace_id: str, *, company_id: str | None=None, timeout: float=300.0, poll_interval: float=1.0) -> Dict[str, Any]
~~~


Poll a workflow until it stops or requires human approval.

Source: `lightbulb/async_client.py:2438`.

### `whoami`



~~~python
async def whoami() -> Dict[str, Any]
~~~


Source: `lightbulb/async_client.py:746`.

## Typed modules and callable/type symbols

## Module `lightbulb.abandoned_recovery`

Consent-safe abandoned-revenue recovery on the governed profit rail.

### `lightbulb.abandoned_recovery.recovery_recipient_digest`

function. Source: `lightbulb/abandoned_recovery.py:203`.



~~~python
recovery_recipient_digest(value: str) -> str
~~~


Canonical privacy commitment for a resolved mailbox.

### `lightbulb.abandoned_recovery.recovery_url_digest`

function. Source: `lightbulb/abandoned_recovery.py:212`.



~~~python
recovery_url_digest(value: str) -> str
~~~


Canonical privacy commitment for a resolved recovery URL.

### `lightbulb.abandoned_recovery.recovery_discount_code_digest`

function. Source: `lightbulb/abandoned_recovery.py:221`.



~~~python
recovery_discount_code_digest(value: str) -> str
~~~


Canonical privacy commitment for a one-time discount code.

### `lightbulb.abandoned_recovery.AbandonedRecoveryCaseInput`

class. Source: `lightbulb/abandoned_recovery.py:230`.

Fields:
- `case_ref: str = Field(pattern='^[a-z][a-z0-9_-]{0,63}$')`
- `launch_ref: str = Field(pattern='^[a-z][a-z0-9_-]{0,63}$')`
- `checkout_ref: str = Field(min_length=1, max_length=200)`
- `customer_ref: str = Field(min_length=1, max_length=200)`
- `shopify_account_ref: str = Field(min_length=1, max_length=200)`
- `gmail_account_ref: str = Field(min_length=1, max_length=200)`
- `recipient_sha256: str = Field(pattern='^[0-9a-f]{64}$')`
- `recovery_url_sha256: str = Field(pattern='^[0-9a-f]{64}$')`
- `discount_code_sha256: str | None = Field(default=None, pattern='^[0-9a-f]{64}$')`
- `abandoned_at: str`
- `observed_at: str`
- `expires_at: str`
- `consent_status: ConsentStatus`
- `cohort: RecoveryCohort`
- `inventory_available: bool`
- `prior_recovery_contacts: int = Field(ge=0, le=100)`
- `frequency_cap: int = Field(default=2, ge=1, le=5)`
- `baseline: ProfitContributionLedger`
- `historical_recovery_ledger: ProfitContributionLedger`
- `historical_sample_size: int = Field(ge=1, le=1000000000)`
- `historical_window_start: str`
- `historical_window_end: str`
- `evidence_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `expected_incremental_revenue: Decimal = Field(ge=0, le=1000000000)`
- `expected_incremental_cost: Decimal = Field(ge=0, le=1000000000)`
- `expected_confidence: Decimal = Field(gt=0, le=1)`
- `target_recovered_profit: Decimal = Field(ge=0, le=1000000000)`
- `minimum_margin_rate: Decimal = Field(default=Decimal('0.10'), ge=0, le=1)`
- `discount_percentage: Decimal | None = Field(default=None, gt=0, le=50)`
- `discount_expires_at: str | None = None`
- `email_subject: str = Field(min_length=1, max_length=998)`
- `reminder_body_template: str = Field(min_length=1, max_length=20000)`
- `incentive_body_template: str | None = Field(default=None, min_length=1, max_length=20000)`
- `measurement_window_hours: int = Field(default=72, ge=1, le=720)`
- `minimum_sample_size: int = Field(default=1, ge=1, le=1000000000)`
- `max_observation_age_hours: int = Field(default=168, ge=1, le=8760)`
- `max_iterations: int = Field(default=2, ge=1, le=4)`

### `lightbulb.abandoned_recovery.AbandonedRecoveryCase`

class. Source: `lightbulb/abandoned_recovery.py:388`.

Fields:
- `schema_id: Literal['lightbulb.abandoned_recovery_case.v1'] = Field(default=ABANDONED_RECOVERY_CASE_SCHEMA, alias='schema')`
- `case_ref: str = Field(pattern='^[a-z][a-z0-9_-]{0,63}$')`
- `launch_ref: str = Field(pattern='^[a-z][a-z0-9_-]{0,63}$')`
- `checkout_ref: str`
- `customer_ref: str`
- `account_bindings: tuple[ProfitConnectorAccountBinding, ProfitConnectorAccountBinding]`
- `recipient_sha256: str = Field(pattern='^[0-9a-f]{64}$')`
- `recovery_url_sha256: str = Field(pattern='^[0-9a-f]{64}$')`
- `discount_code_sha256: str | None = Field(default=None, pattern='^[0-9a-f]{64}$')`
- `abandoned_at: str`
- `observed_at: str`
- `expires_at: str`
- `consent_status: ConsentStatus`
- `cohort: RecoveryCohort`
- `inventory_available: bool`
- `prior_recovery_contacts: int`
- `frequency_cap: int`
- `baseline: ProfitContributionLedger`
- `historical_recovery_ledger: ProfitContributionLedger`
- `historical_sample_size: int`
- `historical_window_start: str`
- `historical_window_end: str`
- `evidence_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `expected_incremental_revenue: Decimal`
- `expected_incremental_cost: Decimal`
- `expected_confidence: Decimal`
- `target_recovered_profit: Decimal`
- `minimum_margin_rate: Decimal`
- `discount_percentage: Decimal | None = None`
- `discount_expires_at: str | None = None`
- `email_subject: str`
- `reminder_body_template: str`
- `incentive_body_template: str | None = None`
- `measurement_window_hours: int`
- `minimum_sample_size: int`
- `max_observation_age_hours: int`
- `max_iterations: int`
- `receipt_key_id: str = Field(min_length=8, max_length=80)`
- `exact_scope_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `case_hmac: str = Field(pattern='^[0-9a-f]{64}$')`
- `case_digest: str = Field(default='0' * 64, pattern='^[0-9a-f]{64}$')`

#### Methods

##### `lightbulb.abandoned_recovery.AbandonedRecoveryCase.hmac_payload`



~~~python
def hmac_payload() -> dict[str, Any]
~~~


Source: `lightbulb/abandoned_recovery.py:468`.

### `lightbulb.abandoned_recovery.RecoveryDispatchAttestation`

class. Source: `lightbulb/abandoned_recovery.py:477`.

Short-lived host proof that consequential recovery gates are still true.

Fields:
- `schema_id: Literal['lightbulb.abandoned_recovery_dispatch_attestation.v1'] = Field(default=ABANDONED_RECOVERY_DISPATCH_ATTESTATION_SCHEMA, alias='schema')`
- `case_ref: str = Field(pattern='^[a-z][a-z0-9_-]{0,63}$')`
- `case_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `plan_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `consent_status: ConsentStatus`
- `inventory_available: bool`
- `prior_recovery_contacts: int = Field(ge=0, le=100)`
- `observed_at: str`
- `valid_until: str`
- `receipt_key_id: str = Field(min_length=8, max_length=80)`
- `exact_scope_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `attestation_hmac: str = Field(pattern='^[0-9a-f]{64}$')`

#### Methods

##### `lightbulb.abandoned_recovery.RecoveryDispatchAttestation.hmac_payload`



~~~python
def hmac_payload() -> dict[str, Any]
~~~


Source: `lightbulb/abandoned_recovery.py:509`.

### `lightbulb.abandoned_recovery.RecoveryContactReservationRequest`

class. Source: `lightbulb/abandoned_recovery.py:517`.

Exact contact slot a host must serialize before recovery writes.

Fields:
- `schema_id: Literal['lightbulb.recovery_contact_reservation_request.v1'] = Field(default=RECOVERY_CONTACT_RESERVATION_REQUEST_SCHEMA, alias='schema')`
- `case_ref: str = Field(pattern='^[a-z][a-z0-9_-]{0,63}$')`
- `case_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `plan_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `recipient_sha256: str = Field(pattern='^[0-9a-f]{64}$')`
- `action_operation_refs: tuple[str, ...] = Field(min_length=1, max_length=2)`
- `run_ref: str = Field(min_length=1, max_length=200)`
- `iteration: int = Field(ge=1, le=4)`
- `receipt_key_id: str = Field(min_length=8, max_length=80)`
- `exact_scope_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `request_digest: str = Field(default='0' * 64, pattern='^[0-9a-f]{64}$')`

#### Methods

##### `lightbulb.abandoned_recovery.RecoveryContactReservationRequest.slot_digest`



~~~python
@property
def slot_digest() -> str
~~~


Run-independent slot; concurrent run refs contend for this identity.

Source: `lightbulb/abandoned_recovery.py:556`.

### `lightbulb.abandoned_recovery.RecoveryContactReservation`

class. Source: `lightbulb/abandoned_recovery.py:571`.

Short-lived HMAC proof registered by a transactional host authority.

Fields:
- `schema_id: Literal['lightbulb.recovery_contact_reservation.v1'] = Field(default=RECOVERY_CONTACT_RESERVATION_SCHEMA, alias='schema')`
- `reservation_ref: str = Field(min_length=1, max_length=200)`
- `request: RecoveryContactReservationRequest`
- `slot_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `reserved_at: str`
- `valid_until: str`
- `reservation_hmac: str = Field(pattern='^[0-9a-f]{64}$')`

#### Methods

##### `lightbulb.abandoned_recovery.RecoveryContactReservation.hmac_payload`



~~~python
def hmac_payload() -> dict[str, Any]
~~~


Source: `lightbulb/abandoned_recovery.py:600`.

### `lightbulb.abandoned_recovery.RecoveryContactReservationConsumption`

class. Source: `lightbulb/abandoned_recovery.py:608`.

Idempotent proof that one exact reservation owns the contact slot.

Fields:
- `schema_id: Literal['lightbulb.recovery_contact_reservation_consumption.v1'] = Field(default=RECOVERY_CONTACT_RESERVATION_CONSUMPTION_SCHEMA, alias='schema')`
- `consumption_ref: str = Field(min_length=1, max_length=200)`
- `reservation_ref: str = Field(min_length=1, max_length=200)`
- `request_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `slot_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `consumed_at: str`
- `receipt_key_id: str = Field(min_length=8, max_length=80)`
- `exact_scope_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `consumption_hmac: str = Field(pattern='^[0-9a-f]{64}$')`

#### Methods

##### `lightbulb.abandoned_recovery.RecoveryContactReservationConsumption.hmac_payload`



~~~python
def hmac_payload() -> dict[str, Any]
~~~


Source: `lightbulb/abandoned_recovery.py:629`.

### `lightbulb.abandoned_recovery.RecoveryContactReservationConflict`

class. Source: `lightbulb/abandoned_recovery.py:633`.

Another run owns or has consumed the exact recipient/case/action slot.

### `lightbulb.abandoned_recovery.RecoveryContactReservationAuthority`

class. Source: `lightbulb/abandoned_recovery.py:638`.

Host transaction boundary; production implementations must be durable.

#### Methods

##### `lightbulb.abandoned_recovery.RecoveryContactReservationAuthority.consume`



~~~python
def consume(reservation: RecoveryContactReservation, *, request: RecoveryContactReservationRequest, consumed_at: datetime) -> RecoveryContactReservationConsumption
~~~


Source: `lightbulb/abandoned_recovery.py:649`.

##### `lightbulb.abandoned_recovery.RecoveryContactReservationAuthority.reserve`



~~~python
def reserve(request: RecoveryContactReservationRequest, *, reserved_at: datetime, valid_until: datetime) -> RecoveryContactReservation
~~~


Source: `lightbulb/abandoned_recovery.py:641`.

### `lightbulb.abandoned_recovery.RecoveryResolvedSecrets`

class. Source: `lightbulb/abandoned_recovery.py:658`.

Fields:
- `recipient: str = Field(min_length=3, max_length=998, repr=False)`
- `recovery_url: str = Field(min_length=9, max_length=2048, repr=False)`
- `discount_code: str | None = Field(default=None, min_length=4, max_length=64, repr=False)`

### `lightbulb.abandoned_recovery.RecoveryActionBrief`

class. Source: `lightbulb/abandoned_recovery.py:677`.

Fields:
- `operation_ref: str`
- `capability: Literal['ecommerce.create_discount', 'gmail.send_email']`
- `connector_account_ref: str`
- `connector_arguments_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `depends_on: tuple[str, ...] = ()`

### `lightbulb.abandoned_recovery.AbandonedRecoveryPlan`

class. Source: `lightbulb/abandoned_recovery.py:690`.

Fields:
- `schema_id: Literal['lightbulb.abandoned_recovery_plan.v1'] = Field(default=ABANDONED_RECOVERY_PLAN_SCHEMA, alias='schema')`
- `status: RecoveryPlanningStatus`
- `case_ref: str`
- `case_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `analysis_as_of: str`
- `suppression_codes: tuple[RecoverySuppressionCode, ...] = ()`
- `profit_plan: ProfitWorkflowPlan | None = None`
- `actions: tuple[RecoveryActionBrief, ...] = ()`
- `discount_included: bool = False`
- `summary: str = Field(min_length=1, max_length=1000)`

### `lightbulb.abandoned_recovery.AbandonedRecoveryRun`

class. Source: `lightbulb/abandoned_recovery.py:736`.

Fields:
- `schema_id: Literal['lightbulb.abandoned_recovery_run.v1'] = Field(default=ABANDONED_RECOVERY_RUN_SCHEMA, alias='schema')`
- `status: RecoveryRunStatus`
- `case_ref: str`
- `case_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `plan_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `run_ref: str`
- `iteration: int = Field(ge=1, le=4)`
- `action_results: tuple[ProfitActionMaterializationResult, ...]`
- `receipts: tuple[ProfitActionExecutionReceipt, ...]`
- `observation_due_at: str | None = None`
- `causal_claim_ready: Literal[False] = False`
- `summary: str = Field(min_length=1, max_length=1000)`

### `lightbulb.abandoned_recovery.mint_abandoned_recovery_case`

function. Source: `lightbulb/abandoned_recovery.py:786`.



~~~python
mint_abandoned_recovery_case(value: AbandonedRecoveryCaseInput | Mapping[str, Any], *, scope: DynamicWorkflowScope | Mapping[str, Any], scope_keyring: ProfitScopeKeyRing, scope_key_id: str | None=None) -> AbandonedRecoveryCase
~~~


Host-seal one privacy-minimised recovery case and exact account route.

### `lightbulb.abandoned_recovery.verify_abandoned_recovery_case`

function. Source: `lightbulb/abandoned_recovery.py:845`.



~~~python
verify_abandoned_recovery_case(value: AbandonedRecoveryCase | Mapping[str, Any], *, scope: DynamicWorkflowScope | Mapping[str, Any], scope_keyring: ProfitScopeKeyRing) -> AbandonedRecoveryCase
~~~


### `lightbulb.abandoned_recovery.build_recovery_contact_reservation_request`

function. Source: `lightbulb/abandoned_recovery.py:884`.



~~~python
build_recovery_contact_reservation_request(recovery_plan_value: AbandonedRecoveryPlan | Mapping[str, Any], case_value: AbandonedRecoveryCase | Mapping[str, Any], *, run_ref: str, iteration: int=1) -> RecoveryContactReservationRequest
~~~


Bind one run to the complete recovery action graph and recipient hash.

### `lightbulb.abandoned_recovery.mint_recovery_contact_reservation`

function. Source: `lightbulb/abandoned_recovery.py:922`.



~~~python
mint_recovery_contact_reservation(request_value: RecoveryContactReservationRequest | Mapping[str, Any], *, reservation_ref: str, reserved_at: datetime, valid_until: datetime, scope: DynamicWorkflowScope | Mapping[str, Any], scope_keyring: ProfitScopeKeyRing) -> RecoveryContactReservation
~~~


### `lightbulb.abandoned_recovery.verify_recovery_contact_reservation`

function. Source: `lightbulb/abandoned_recovery.py:964`.



~~~python
verify_recovery_contact_reservation(value: RecoveryContactReservation | Mapping[str, Any], *, request: RecoveryContactReservationRequest, at: datetime, scope: DynamicWorkflowScope | Mapping[str, Any], scope_keyring: ProfitScopeKeyRing) -> RecoveryContactReservation
~~~


### `lightbulb.abandoned_recovery.mint_recovery_contact_reservation_consumption`

function. Source: `lightbulb/abandoned_recovery.py:1001`.



~~~python
mint_recovery_contact_reservation_consumption(reservation: RecoveryContactReservation, *, consumed_at: datetime, scope: DynamicWorkflowScope | Mapping[str, Any], scope_keyring: ProfitScopeKeyRing) -> RecoveryContactReservationConsumption
~~~


### `lightbulb.abandoned_recovery.verify_recovery_contact_reservation_consumption`

function. Source: `lightbulb/abandoned_recovery.py:1040`.



~~~python
verify_recovery_contact_reservation_consumption(value: RecoveryContactReservationConsumption | Mapping[str, Any], *, reservation: RecoveryContactReservation, request: RecoveryContactReservationRequest, scope: DynamicWorkflowScope | Mapping[str, Any], scope_keyring: ProfitScopeKeyRing) -> RecoveryContactReservationConsumption
~~~


### `lightbulb.abandoned_recovery.InMemoryRecoveryContactReservationAuthority`

class. Source: `lightbulb/abandoned_recovery.py:1076`.

Atomic reference authority; production hosts need durable transactions.

#### Methods

##### `lightbulb.abandoned_recovery.InMemoryRecoveryContactReservationAuthority.consume`



~~~python
def consume(reservation: RecoveryContactReservation, *, request: RecoveryContactReservationRequest, consumed_at: datetime) -> RecoveryContactReservationConsumption
~~~


Source: `lightbulb/abandoned_recovery.py:1126`.

##### `lightbulb.abandoned_recovery.InMemoryRecoveryContactReservationAuthority.reserve`



~~~python
def reserve(request: RecoveryContactReservationRequest, *, reserved_at: datetime, valid_until: datetime) -> RecoveryContactReservation
~~~


Source: `lightbulb/abandoned_recovery.py:1092`.

### `lightbulb.abandoned_recovery.mint_recovery_dispatch_attestation`

function. Source: `lightbulb/abandoned_recovery.py:1167`.



~~~python
mint_recovery_dispatch_attestation(recovery_plan_value: AbandonedRecoveryPlan | Mapping[str, Any], case_value: AbandonedRecoveryCase | Mapping[str, Any], *, consent_status: ConsentStatus, inventory_available: bool, prior_recovery_contacts: int, observed_at: datetime, valid_until: datetime, scope: DynamicWorkflowScope | Mapping[str, Any], scope_keyring: ProfitScopeKeyRing) -> RecoveryDispatchAttestation
~~~


Host-seal a short-lived recheck immediately before connector dispatch.

### `lightbulb.abandoned_recovery.verify_recovery_dispatch_attestation`

function. Source: `lightbulb/abandoned_recovery.py:1242`.



~~~python
verify_recovery_dispatch_attestation(value: RecoveryDispatchAttestation | Mapping[str, Any], *, recovery_plan: AbandonedRecoveryPlan, case: AbandonedRecoveryCase, dispatch_at: datetime, scope: DynamicWorkflowScope | Mapping[str, Any], scope_keyring: ProfitScopeKeyRing) -> RecoveryDispatchAttestation
~~~


Verify exact scope, freshness, and mutable safety gates before I/O.

### `lightbulb.abandoned_recovery.plan_abandoned_revenue_recovery`

function. Source: `lightbulb/abandoned_recovery.py:1399`.



~~~python
plan_abandoned_revenue_recovery(case_value: AbandonedRecoveryCase | Mapping[str, Any], *, resolved_secrets: RecoveryResolvedSecrets | Mapping[str, Any], analysis_as_of: datetime, scope: DynamicWorkflowScope | Mapping[str, Any], scope_keyring: ProfitScopeKeyRing) -> AbandonedRecoveryPlan
~~~


Compile a deterministic holdout/suppression/action decision for one case.

### `lightbulb.abandoned_recovery.run_abandoned_revenue_recovery`

function. Source: `lightbulb/abandoned_recovery.py:1629`.



~~~python
run_abandoned_revenue_recovery(recovery_plan_value: AbandonedRecoveryPlan | Mapping[str, Any], case_value: AbandonedRecoveryCase | Mapping[str, Any], *, resolved_secrets: RecoveryResolvedSecrets | Mapping[str, Any], scope: DynamicWorkflowScope | Mapping[str, Any], scope_keyring: ProfitScopeKeyRing, execution_scope: ExecutionScope | Mapping[str, Any], executor: ConnectorExecutor, run_ref: str, iteration: int=1, preview_only: bool=True, dispatch_at: datetime | None=None, dispatch_attestation: RecoveryDispatchAttestation | Mapping[str, Any] | None=None, contact_reservation: RecoveryContactReservation | Mapping[str, Any] | None=None, contact_reservation_authority: RecoveryContactReservationAuthority | None=None, approval_grants: Mapping[str, ProfitActionApprovalGrant | Mapping[str, Any]] | None=None, existing_receipts: Iterable[ProfitActionExecutionReceipt | Mapping[str, Any]]=()) -> AbandonedRecoveryRun
~~~


Run the recovery DAG until preview, approval wait, failure, or completion.

### `lightbulb.abandoned_recovery.schedule_abandoned_recovery_observation`

function. Source: `lightbulb/abandoned_recovery.py:1870`.



~~~python
schedule_abandoned_recovery_observation(recovery_plan_value: AbandonedRecoveryPlan | Mapping[str, Any], recovery_run_value: AbandonedRecoveryRun | Mapping[str, Any], *, runtime: 'ObservationRuntime', scope: DynamicWorkflowScope | Mapping[str, Any], project_id: UUID, experiment_ref: str, expected_reader_version: int=1, previous_evaluation: 'ProfitWorkflowEvaluation | None'=None) -> 'WorkflowCheckpoint'
~~~


Schedule the privacy-minimised randomized-holdout recovery evaluation.

## Module `lightbulb.accountant_loop`

The AI accountant's operating loop: one routine over the whole layer.

### `lightbulb.accountant_loop.AccountantLoopValidationError`

class. Source: `lightbulb/accountant_loop.py:92`.

The cycle inputs cannot produce an honest agenda.

### `lightbulb.accountant_loop.AccountantAction`

class. Source: `lightbulb/accountant_loop.py:160`.

One ranked next action, traceable to the artifact that justified it.

Fields:
- `rank: int = Field(ge=1, le=50)`
- `kind: AccountantActionKind`
- `title: ShortText`
- `rationale: ShortText`
- `source_digest: Sha256Digest`

### `lightbulb.accountant_loop.AccountantAgenda`

class. Source: `lightbulb/accountant_loop.py:170`.

One accountant cycle: the financial state and the ranked next actions.

Fields:
- `schema_id: Literal['lightbulb.accountant_agenda.v2'] = Field(default=ACCOUNTANT_AGENDA_SCHEMA, alias='schema')`
- `cycle_ref: PortableRef`
- `as_of: str`
- `currency: CurrencyCode`
- `runway_status: Literal['burning', 'not_burning', 'unknown']`
- `runway_months: Decimal | None = None`
- `budget_status: Literal['healthy_surplus', 'at_floor', 'below_floor', 'not_burning', 'unknown']`
- `severity: AccountantSeverity`
- `runway_digest: Sha256Digest`
- `assessment_digest: Sha256Digest`
- `funding_gate_verdict: Literal['deploy_permitted', 'hold_at_floor', 'defer_protect_runway', 'unknown'] | None = None`
- `funding_gate_digest: Sha256Digest | None = None`
- `grant_matches: int | None = None`
- `grant_match_digest: Sha256Digest | None = None`
- `default_alive_verdict: Literal['already_profitable', 'default_alive', 'default_dead'] | None = None`
- `default_alive_digest: Sha256Digest | None = None`
- `tax_set_aside: Decimal | None = None`
- `spendable_cash_net_of_tax: Decimal | None = None`
- `tax_provision_digest: Sha256Digest | None = None`
- `receivables_outstanding: Decimal | None = None`
- `receivables_overdue: Decimal | None = None`
- `receivables_dso_days: Decimal | None = None`
- `collections_within_horizon: Decimal | None = None`
- `receivables_digest: Sha256Digest | None = None`
- `payables_outstanding: Decimal | None = None`
- `payables_overdue: Decimal | None = None`
- `payables_dpo_days: Decimal | None = None`
- `payables_are_floor: bool | None = None`
- `payments_within_horizon: Decimal | None = None`
- `payables_digest: Sha256Digest | None = None`
- `forecast_horizon_weeks: int | None = None`
- `forecast_closing_cash: Decimal | None = None`
- `forecast_lowest_cash: Decimal | None = None`
- `forecast_first_negative_week: int | None = None`
- `forecast_reliability: Literal['projection', 'optimistic_ceiling'] | None = None`
- `forecast_digest: Sha256Digest | None = None`
- `actions: tuple[AccountantAction, ...] = Field(default_factory=tuple)`
- `notes: tuple[ShortText, ...] = Field(default_factory=tuple, max_length=20)`
- `agenda_digest: Sha256Digest = '0' * 64`

#### Methods

##### `lightbulb.accountant_loop.AccountantAgenda.to_dict`



~~~python
def to_dict() -> dict[str, Any]
~~~


Source: `lightbulb/accountant_loop.py:235`.

### `lightbulb.accountant_loop.AccountantCycleInput`

class. Source: `lightbulb/accountant_loop.py:239`.

Fields:
- `cycle_ref: PortableRef`
- `as_of: str`
- `currency: CurrencyCode`
- `cash_evidence: tuple[CashLedgerEvidence, ...] = Field(min_length=1, max_length=200)`
- `runway_floor_months: Decimal = Field(default=Decimal('12'), gt=0, le=Decimal('120'))`
- `caution_threshold_months: Decimal = Field(default=Decimal('18'), gt=0, le=Decimal('120'))`
- `cash_on_hand_override: Decimal | None = None`
- `staleness_policy: CashStalenessPolicy = Field(default_factory=CashStalenessPolicy)`
- `grant_profile: CompanyGrantProfile | None = None`
- `objective_assessment: ObjectiveAssessment | None = None`
- `tax_provision: TaxProvision | None = None`
- `default_alive: DefaultAliveAssessment | None = None`
- `receivables: ReceivablesAssessment | None = None`
- `payables: PayablesAssessment | None = None`
- `forecast_weeks: int | None = Field(default=None, ge=1, le=52)`
- `scheduled_cash_events: tuple[ScheduledCashEvent, ...] = Field(default_factory=tuple, max_length=500)`
- `assumed_weekly_operating_outflow: Decimal | None = None`
- `scheduled_events_complete: bool = False`

### `lightbulb.accountant_loop.run_accountant_cycle`

function. Source: `lightbulb/accountant_loop.py:292`.



~~~python
run_accountant_cycle(inputs: AccountantCycleInput | Mapping[str, Any]) -> AccountantAgenda
~~~


Run one accountant cycle and emit its prioritized agenda.

### `lightbulb.accountant_loop.RunAccountantCyclePrimitive`

class. Source: `lightbulb/accountant_loop.py:1000`.

Run the accountant's routine and emit a survival-first agenda.

## Module `lightbulb.agent_ops`

Bounded contracts for the governed training-pair gateway.

### `lightbulb.agent_ops.AgentOpsProtocolError`

class. Source: `lightbulb/agent_ops.py:134`.

The agent-ops gateway returned a malformed or unexpected v1 contract.

## Module `lightbulb.async_client`

Async Lightbulb platform client with complete sync-SDK parity.

### `lightbulb.async_client.AsyncLightbulbClient`

class. Source: `lightbulb/async_client.py:181`.

Async client for the Lightbulb platform API.

#### Methods

##### `lightbulb.async_client.AsyncLightbulbClient.__aenter__`



~~~python
async def __aenter__() -> 'AsyncLightbulbClient'
~~~


Source: `lightbulb/async_client.py:231`.

##### `lightbulb.async_client.AsyncLightbulbClient.__aexit__`



~~~python
async def __aexit__(exc_type, exc, tb) -> None
~~~


Source: `lightbulb/async_client.py:235`.

##### `lightbulb.async_client.AsyncLightbulbClient.activate_marketplace_action`



~~~python
async def activate_marketplace_action(installation_id: str, *, idempotency_key: str) -> Dict[str, Any]
~~~


Activate an installed action; this never approves execution policy.

Source: `lightbulb/async_client.py:1819`.

##### `lightbulb.async_client.AsyncLightbulbClient.active_company_id`



~~~python
@property
def active_company_id() -> str | None
~~~


Source: `lightbulb/async_client.py:275`.

##### `lightbulb.async_client.AsyncLightbulbClient.active_company_id`



~~~python
@active_company_id.setter
def active_company_id(value: str | None) -> None
~~~


Source: `lightbulb/async_client.py:279`.

##### `lightbulb.async_client.AsyncLightbulbClient.add_project_coding_harness`



~~~python
async def add_project_coding_harness(project_id: str, harness: str, *, make_primary: bool=False) -> Dict[str, Any]
~~~


Attach another harness without removing existing project harnesses.

Source: `lightbulb/async_client.py:777`.

##### `lightbulb.async_client.AsyncLightbulbClient.admit_project_learning_run`



~~~python
async def admit_project_learning_run(project_id: str, learning_run_id: str, *, runtime: str, capacity_admission: Mapping[str, Any], operator_approved: bool=False, confirm_admission: bool=False, idempotency_key: str | None=None) -> Dict[str, Any]
~~~


Reserve budget and admit a queued run; this still executes no training.

Source: `lightbulb/async_client.py:2879`.

##### `lightbulb.async_client.AsyncLightbulbClient.approve_runtime_domain_action`



~~~python
async def approve_runtime_domain_action(runtime_action_id: str, *, project_id: str, company_id: str | None=None) -> Dict[str, Any]
~~~


Approve a reviewed action and return its governed recursive reference.

Source: `lightbulb/async_client.py:1493`.

##### `lightbulb.async_client.AsyncLightbulbClient.approve_task`



~~~python
async def approve_task(task_id: str, *, comments: str='') -> Dict[str, Any]
~~~


Source: `lightbulb/async_client.py:3721`.

##### `lightbulb.async_client.AsyncLightbulbClient.approve_voice_action`



~~~python
async def approve_voice_action(execution_id: str, approval_task_id: str, *, comments: str='') -> Dict[str, Any]
~~~


Source: `lightbulb/async_client.py:3764`.

##### `lightbulb.async_client.AsyncLightbulbClient.archive_marketplace_action`



~~~python
async def archive_marketplace_action(listing_id: str, *, idempotency_key: str, reason: str='') -> Dict[str, Any]
~~~


Archive a publisher-owned listing with a replay-safe mutation.

Source: `lightbulb/async_client.py:1730`.

##### `lightbulb.async_client.AsyncLightbulbClient.async_parity_report`



~~~python
def async_parity_report() -> Dict[str, Any]
~~~


Source: `lightbulb/async_client.py:338`.

##### `lightbulb.async_client.AsyncLightbulbClient.author_agentic_workflow`



~~~python
async def author_agentic_workflow(prompt: str, *, name: str | None=None, workflow_type: str | None=None, preferred_domains: List[str] | None=None, include_approval_gates: bool=True, publish: bool=True, company_id: str | None=None, site_project_id: str | None=None, definition: Mapping[str, Any] | None=None) -> Dict[str, Any]
~~~


Async compile-once authoring with exact executable-projection fidelity.

Source: `lightbulb/async_client.py:1082`.

##### `lightbulb.async_client.AsyncLightbulbClient.author_workflow_definition`



~~~python
async def author_workflow_definition(definition: Mapping[str, Any], *, prompt: str='', name: str | None=None, workflow_type: str | None=None, site_project_id: str | None=None, category: str | None=None, change_notes: str | None=None, company_id: str | None=None) -> Dict[str, Any]
~~~


Publish one exact executable workflow projection through governance.

Source: `lightbulb/async_client.py:934`.

##### `lightbulb.async_client.AsyncLightbulbClient.author_workflow_trigger`



~~~python
async def author_workflow_trigger(workflow_definition_id: str, *, trigger_type: str='schedule', schedule: str | None=None, event_type: str | None=None, event_filter: Mapping[str, Any] | None=None, name: str | None=None, description: str | None=None, site_project_id: str | None=None, configuration: Mapping[str, Any] | None=None, enabled: bool=False, company_id: str | None=None) -> Dict[str, Any]
~~~


Create a principal-scoped schedule or event trigger for a workflow.

Source: `lightbulb/async_client.py:985`.

##### `lightbulb.async_client.AsyncLightbulbClient.backbone_execute`



~~~python
async def backbone_execute(objective: str, *, inputs: Dict[str, Any] | None=None) -> Dict[str, Any]
~~~


Execute a task through the tenant-scoped backbone agent.

Source: `lightbulb/async_client.py:3602`.

##### `lightbulb.async_client.AsyncLightbulbClient.bind_project_mission_action`



~~~python
async def bind_project_mission_action(project_id: str, mission_run_receipt_id: Any, action_event_id: Any, *, confirm_bind: bool=False, binding_id: Any=None, note: Any=None, idempotency_key: str | None=None) -> Dict[str, Any]
~~~


Bind a later event to a mission; this proves timing and scope only.

Source: `lightbulb/async_client.py:2708`.

##### `lightbulb.async_client.AsyncLightbulbClient.cancel_recursive_agent_execution`



~~~python
async def cancel_recursive_agent_execution(execution_id: str) -> Dict[str, Any]
~~~


Cancel one exact user-owned recursive execution tree.

Source: `lightbulb/async_client.py:3651`.

##### `lightbulb.async_client.AsyncLightbulbClient.claim_project_coding_handoff`



~~~python
async def claim_project_coding_handoff(project_id: str, *, harness: str, handoff_payload_id: str, host_session_ref: str | None=None) -> Dict[str, Any]
~~~


Record routing of an approved handoff to the selected harness.

Source: `lightbulb/async_client.py:823`.

##### `lightbulb.async_client.AsyncLightbulbClient.close`



~~~python
async def close() -> None
~~~


Source: `lightbulb/async_client.py:243`.

##### `lightbulb.async_client.AsyncLightbulbClient.code_workspace_chat`



~~~python
async def code_workspace_chat(workspace_id: str, message: str, **kwargs: Any) -> Dict[str, Any]
~~~


Source: `lightbulb/async_client.py:3565`.

##### `lightbulb.async_client.AsyncLightbulbClient.context_company_id`



~~~python
@property
def context_company_id() -> str | None
~~~


Company used only by forwarded Context Broker calls.

Source: `lightbulb/async_client.py:285`.

##### `lightbulb.async_client.AsyncLightbulbClient.context_company_id`



~~~python
@context_company_id.setter
def context_company_id(value: str | None) -> None
~~~


Source: `lightbulb/async_client.py:294`.

##### `lightbulb.async_client.AsyncLightbulbClient.create_account_shell_customization_draft`



~~~python
async def create_account_shell_customization_draft(document: Mapping[str, Any], *, base_revision_id: str | None) -> Dict[str, Any]
~~~


Create an immutable draft from one exact base revision.

Source: `lightbulb/async_client.py:1309`.

##### `lightbulb.async_client.AsyncLightbulbClient.create_project_from_preflight`



~~~python
async def create_project_from_preflight(receipt: ProjectCreationPreflightReceipt, *, coding_harness: str, confirm_create: bool=False, confirm_open_questions: bool=False, workspace_id: str | None=None, repo_connection_id: str | None=None, idempotency_key: str | None=None, play_style: str | None=None) -> Dict[str, Any]
~~~


Create exactly the draft bound to a validated preflight receipt.

Source: `lightbulb/async_client.py:3314`.

##### `lightbulb.async_client.AsyncLightbulbClient.create_server_workflow_improvement_packet`



~~~python
async def create_server_workflow_improvement_packet(payload: Dict[str, Any]) -> Dict[str, Any]
~~~


Source: `lightbulb/async_client.py:2136`.

##### `lightbulb.async_client.AsyncLightbulbClient.decide_project_learning_result_admission`



~~~python
async def decide_project_learning_result_admission(project_id: str, evaluation_receipt_id: str, *, decision: Any, rationale: Any, confirm_admission: bool=False, idempotency_key: str | None=None) -> Dict[str, Any]
~~~


Human admit/reject; never apply or promote the candidate.

Source: `lightbulb/async_client.py:2938`.

##### `lightbulb.async_client.AsyncLightbulbClient.decide_workflow_improvement_packet`



~~~python
async def decide_workflow_improvement_packet(packet_id: str, *, approval_scope: str, decision: str, rationale: str='', evidence: Dict[str, Any] | None=None) -> Dict[str, Any]
~~~


Source: `lightbulb/async_client.py:2184`.

##### `lightbulb.async_client.AsyncLightbulbClient.dispatch`



~~~python
async def dispatch(domain: str, *, action: str='chat', message: str='', objective: str='', inputs: Dict[str, Any] | None=None, conversation_id: str | None=None, company_id: str | None=None) -> DispatchResult
~~~


Source: `lightbulb/async_client.py:2371`.

##### `lightbulb.async_client.AsyncLightbulbClient.document_builder_get_messages`



~~~python
async def document_builder_get_messages(session_id: str, **filters: Any) -> List[Dict[str, Any]]
~~~


Source: `lightbulb/async_client.py:3699`.

##### `lightbulb.async_client.AsyncLightbulbClient.dynamic_workflow_attach`



~~~python
async def dynamic_workflow_attach(*, company_ref: str, project_ref: str, run_ref: str, host: str, host_session_ref: str, host_role: str, expected_revision: int, idempotency_key: str) -> Dict[str, Any]
~~~


Source: `lightbulb/async_client.py:522`.

##### `lightbulb.async_client.AsyncLightbulbClient.dynamic_workflow_cancel`



~~~python
async def dynamic_workflow_cancel(*, company_ref: str, project_ref: str, run_ref: str, host_binding_ref: str, session_receipt: str, host_role: str, expected_revision: int, idempotency_key: str, reason: str) -> Dict[str, Any]
~~~


Source: `lightbulb/async_client.py:716`.

##### `lightbulb.async_client.AsyncLightbulbClient.dynamic_workflow_next_assignment`



~~~python
async def dynamic_workflow_next_assignment(*, company_ref: str, project_ref: str, run_ref: str, host_binding_ref: str, session_receipt: str, host_role: str, expected_revision: int, idempotency_key: str) -> Dict[str, Any]
~~~


Source: `lightbulb/async_client.py:570`.

##### `lightbulb.async_client.AsyncLightbulbClient.dynamic_workflow_start`



~~~python
async def dynamic_workflow_start(*, company_ref: str, project_ref: str, objective: str, acceptance_criteria: Sequence[Mapping[str, Any]], host: str, expected_revision: int, idempotency_key: str, host_session_ref: str | None=None, acceptance_policy: str='distinct_binding', workflow_spec: Mapping[str, Any] | None=None, inputs: Mapping[str, Any] | None=None) -> Dict[str, Any]
~~~


Source: `lightbulb/async_client.py:489`.

##### `lightbulb.async_client.AsyncLightbulbClient.dynamic_workflow_status`



~~~python
async def dynamic_workflow_status(*, company_ref: str, project_ref: str, run_ref: str, host_binding_ref: str, session_receipt: str, host_role: str) -> Dict[str, Any]
~~~


Source: `lightbulb/async_client.py:548`.

##### `lightbulb.async_client.AsyncLightbulbClient.dynamic_workflow_submit_builder_result`



~~~python
async def dynamic_workflow_submit_builder_result(*, company_ref: str, project_ref: str, run_ref: str, host_binding_ref: str, session_receipt: str, host_role: str, assignment_ref: str, assignment_receipt: str, expected_revision: int, idempotency_key: str, outcome: str, summary: str, plan_digest: str, iteration: int, evidence_refs: Sequence[Mapping[str, Any]], progress_digest: str) -> Dict[str, Any]
~~~


Source: `lightbulb/async_client.py:630`.

##### `lightbulb.async_client.AsyncLightbulbClient.dynamic_workflow_submit_evaluator_verdict`



~~~python
async def dynamic_workflow_submit_evaluator_verdict(*, company_ref: str, project_ref: str, run_ref: str, host_binding_ref: str, session_receipt: str, host_role: str, assignment_ref: str, assignment_receipt: str, expected_revision: int, idempotency_key: str, decision: str, accepted: bool, summary: str, plan_digest: str, builder_result_digest: str, required_criterion_ids: Sequence[str], criterion_results: Sequence[Mapping[str, Any]]) -> Dict[str, Any]
~~~


Source: `lightbulb/async_client.py:672`.

##### `lightbulb.async_client.AsyncLightbulbClient.dynamic_workflow_submit_plan`



~~~python
async def dynamic_workflow_submit_plan(*, company_ref: str, project_ref: str, run_ref: str, host_binding_ref: str, session_receipt: str, host_role: str, assignment_ref: str, assignment_receipt: str, expected_revision: int, idempotency_key: str, required_criterion_ids: Sequence[str], plan: Mapping[str, Any]) -> Dict[str, Any]
~~~


Source: `lightbulb/async_client.py:596`.

##### `lightbulb.async_client.AsyncLightbulbClient.evaluate_project_offline_policy`



~~~python
async def evaluate_project_offline_policy(project_id: str, *, behavior_policy_id: Any, candidate_policy_id: Any, metric_id: Any, pairs: Sequence[Mapping[str, Any]], confirm_evaluate: bool=False, evaluation_id: Any=None, note: Any=None, idempotency_key: str | None=None) -> Dict[str, Any]
~~~


Estimate a candidate from verified receipts; never admit learning.

Source: `lightbulb/async_client.py:3219`.

##### `lightbulb.async_client.AsyncLightbulbClient.forwarded_sync_methods`



~~~python
def forwarded_sync_methods() -> list[str]
~~~


Public sync operations supplied by the managed thread bridge.

Source: `lightbulb/async_client.py:328`.

##### `lightbulb.async_client.AsyncLightbulbClient.get_account_shell_customization`



~~~python
async def get_account_shell_customization() -> Dict[str, Any]
~~~


Read the effective governed account-shell customization.

Source: `lightbulb/async_client.py:1299`.

##### `lightbulb.async_client.AsyncLightbulbClient.get_code_workspace_active_run`



~~~python
async def get_code_workspace_active_run(workspace_id: str) -> Dict[str, Any] | None
~~~


Source: `lightbulb/async_client.py:3589`.

##### `lightbulb.async_client.AsyncLightbulbClient.get_code_workspace_run`



~~~python
async def get_code_workspace_run(workspace_id: str, run_id: str) -> Dict[str, Any]
~~~


Source: `lightbulb/async_client.py:3580`.

##### `lightbulb.async_client.AsyncLightbulbClient.get_marketplace_action_publication`



~~~python
async def get_marketplace_action_publication(publication_id: str) -> Dict[str, Any]
~~~


Get governed publication and security-scan status by publication UUID.

Source: `lightbulb/async_client.py:1690`.

##### `lightbulb.async_client.AsyncLightbulbClient.get_marketplace_installation`



~~~python
async def get_marketplace_installation(installation_id: str) -> Dict[str, Any]
~~~


Get one marketplace installation for the selected active company.

Source: `lightbulb/async_client.py:1779`.

##### `lightbulb.async_client.AsyncLightbulbClient.get_marketplace_invocation_receipt`



~~~python
async def get_marketplace_invocation_receipt(invocation_id: str) -> Dict[str, Any]
~~~


Get the immutable audit receipt for one marketplace invocation.

Source: `lightbulb/async_client.py:1950`.

##### `lightbulb.async_client.AsyncLightbulbClient.get_marketplace_invocation_status`



~~~python
async def get_marketplace_invocation_status(invocation_id: str) -> Dict[str, Any]
~~~


Get current invocation state for the selected company.

Source: `lightbulb/async_client.py:1938`.

##### `lightbulb.async_client.AsyncLightbulbClient.get_marketplace_listing`



~~~python
async def get_marketplace_listing(listing_id: str, *, revision_id: str | None=None, include_inputs: bool=True) -> Dict[str, Any]
~~~


Get one persisted marketplace listing and optional immutable revision.

Source: `lightbulb/async_client.py:1598`.

##### `lightbulb.async_client.AsyncLightbulbClient.get_project_coding_handoff`



~~~python
async def get_project_coding_handoff(project_id: str, harness: str) -> Dict[str, Any]
~~~


Read the selected Project Agent handoff for a connected harness.

Source: `lightbulb/async_client.py:803`.

##### `lightbulb.async_client.AsyncLightbulbClient.get_project_coding_harnesses`



~~~python
async def get_project_coding_harnesses(project_id: str) -> Dict[str, Any]
~~~


Read the durable additive harness selection for one project.

Source: `lightbulb/async_client.py:763`.

##### `lightbulb.async_client.AsyncLightbulbClient.get_project_game_snapshot`



~~~python
async def get_project_game_snapshot(project_id: str) -> Dict[str, Any]
~~~


Fetch and validate one server-owned, exact-scoped project snapshot.

Source: `lightbulb/async_client.py:2506`.

##### `lightbulb.async_client.AsyncLightbulbClient.get_recursive_agent_execution_status`



~~~python
async def get_recursive_agent_execution_status(execution_id: str) -> Dict[str, Any]
~~~


Read privacy-minimized status for one exact user-owned recursive tree.

Source: `lightbulb/async_client.py:3664`.

##### `lightbulb.async_client.AsyncLightbulbClient.get_runtime_domain_action`



~~~python
async def get_runtime_domain_action(runtime_action_id: str, *, project_id: str, company_id: str | None=None) -> Dict[str, Any]
~~~


Review one exact-scope registration without changing its lifecycle.

Source: `lightbulb/async_client.py:1475`.

##### `lightbulb.async_client.AsyncLightbulbClient.get_server_workflow_improvement_packet`



~~~python
async def get_server_workflow_improvement_packet(packet_id: str) -> Dict[str, Any]
~~~


Read one exact tenant/company-scoped workflow improvement packet.

Source: `lightbulb/async_client.py:2171`.

##### `lightbulb.async_client.AsyncLightbulbClient.get_server_workflow_improvement_status`



~~~python
async def get_server_workflow_improvement_status() -> Dict[str, Any]
~~~


Source: `lightbulb/async_client.py:2146`.

##### `lightbulb.async_client.AsyncLightbulbClient.get_training_pair_status`



~~~python
async def get_training_pair_status(pair_handle: str, *, project_id: str | None=None) -> Dict[str, Any]
~~~


Read the privacy-minimized status for one exact owned pair handle.

Source: `lightbulb/async_client.py:2081`.

##### `lightbulb.async_client.AsyncLightbulbClient.get_workflow_improvement_audit`



~~~python
async def get_workflow_improvement_audit(packet_id: str) -> List[Dict[str, Any]]
~~~


Read the immutable scoped audit trail for one workflow packet.

Source: `lightbulb/async_client.py:2254`.

##### `lightbulb.async_client.AsyncLightbulbClient.get_workflow_improvement_delivery`



~~~python
async def get_workflow_improvement_delivery(delivery_id: str) -> Dict[str, Any]
~~~


Read one exact scoped workflow-improvement delivery.

Source: `lightbulb/async_client.py:2268`.

##### `lightbulb.async_client.AsyncLightbulbClient.get_workflow_instance`



~~~python
async def get_workflow_instance(trace_id: str, *, company_id: str | None=None) -> Dict[str, Any]
~~~


Get a workflow instance through the authenticated public API.

Source: `lightbulb/async_client.py:2419`.

##### `lightbulb.async_client.AsyncLightbulbClient.get_workflow_trigger_catalog`



~~~python
async def get_workflow_trigger_catalog() -> Dict[str, Any]
~~~


List the schedule literals and event types accepted by authoring.

Source: `lightbulb/async_client.py:1069`.

##### `lightbulb.async_client.AsyncLightbulbClient.inspect_project_creation_world_ready`



~~~python
def inspect_project_creation_world_ready(name: str, instructions: str='', *, participant_role: str='agent_worker', experience_lens: str='agent_protocol', play_style: str='guided_human_in_the_loop') -> dict[str, Any]
~~~


Inspect project-review readiness locally without network activity.

Source: `lightbulb/async_client.py:3260`.

##### `lightbulb.async_client.AsyncLightbulbClient.inspect_project_game_campaign`



~~~python
def inspect_project_game_campaign(*, project: dict[str, Any] | None=None, plan: dict[str, Any] | None=None, business_cockpit: dict[str, Any] | None=None) -> dict[str, Any]
~~~


Inspect the human/agent project campaign locally without network activity.

Source: `lightbulb/async_client.py:2550`.

##### `lightbulb.async_client.AsyncLightbulbClient.inspect_training_pair_input_custody`



~~~python
async def inspect_training_pair_input_custody(installation_id: str, revision_id: str, *, project_id: str | None=None) -> Dict[str, Any]
~~~


Inspect exact-owner input custody without widening authority.

Source: `lightbulb/async_client.py:1992`.

##### `lightbulb.async_client.AsyncLightbulbClient.inspect_training_pair_readiness`



~~~python
async def inspect_training_pair_readiness(installation_id: str, revision_id: str, *, project_id: str | None=None) -> Dict[str, Any]
~~~


Inspect structured readiness without admitting or launching training.

Source: `lightbulb/async_client.py:1964`.

##### `lightbulb.async_client.AsyncLightbulbClient.inspect_workflow_learning_candidate_attestation`



~~~python
async def inspect_workflow_learning_candidate_attestation(delivery_id: str) -> Dict[str, Any]
~~~


Revalidate the exact candidate producer attestation using current keys.

Source: `lightbulb/async_client.py:2281`.

##### `lightbulb.async_client.AsyncLightbulbClient.install_marketplace_action`



~~~python
async def install_marketplace_action(listing_id: str, revision_id: str, *, idempotency_key: str, deployment_targets: Sequence[str] | None=None) -> Dict[str, Any]
~~~


Install a pinned revision and bind its explicit agent targets.

Source: `lightbulb/async_client.py:1791`.

##### `lightbulb.async_client.AsyncLightbulbClient.invoke_marketplace_action`



~~~python
async def invoke_marketplace_action(installation_id: str, inputs: Dict[str, Any] | None=None, *, idempotency_key: str, message: str='', objective: str='', dry_run: bool=True, preview_invocation_id: str | None=None, confirm_live: bool=False) -> Dict[str, Any]
~~~


Preview an installed action, or explicitly confirm an exact preview for live use.

Source: `lightbulb/async_client.py:1893`.

##### `lightbulb.async_client.AsyncLightbulbClient.invoke_tool`



~~~python
async def invoke_tool(tool_name: str, arguments: Dict[str, Any], *, project_id: str | None=None, project_ref: str | None=None, connector_account_ref: str | None=None, idempotency_key: str | None=None, approval_ref: str | None=None, workflow_id: str | None=None, step_id: str | None=None, workflow_instance_id: str | None=None, workflow_step_generation: int | None=None, runtime_context: Dict[str, Any] | None=None, effect: str | None=None) -> Dict[str, Any]
~~~


Invoke a utility through legacy routing or a connector through exact custody.

Source: `lightbulb/async_client.py:3799`.

##### `lightbulb.async_client.AsyncLightbulbClient.list_aoc_runs`



~~~python
async def list_aoc_runs(**filters: Any) -> List[Dict[str, Any]]
~~~


Source: `lightbulb/async_client.py:3776`.

##### `lightbulb.async_client.AsyncLightbulbClient.list_business_primitives`



~~~python
async def list_business_primitives(*, category: str | None=None, query: str | None=None, include_inputs: bool=True) -> List[Dict[str, Any]]
~~~


List local business-primitive contracts without a network call.

Source: `lightbulb/async_client.py:918`.

##### `lightbulb.async_client.AsyncLightbulbClient.list_code_workspaces`



~~~python
async def list_code_workspaces() -> List[Dict[str, Any]]
~~~


Source: `lightbulb/async_client.py:3559`.

##### `lightbulb.async_client.AsyncLightbulbClient.list_companies`



~~~python
async def list_companies() -> List[Dict[str, Any]]
~~~


Source: `lightbulb/async_client.py:752`.

##### `lightbulb.async_client.AsyncLightbulbClient.list_connected_integrations`



~~~python
async def list_connected_integrations(company_id: str | None=None) -> List[Dict[str, Any]]
~~~


Source: `lightbulb/async_client.py:2110`.

##### `lightbulb.async_client.AsyncLightbulbClient.list_domain_actions`



~~~python
async def list_domain_actions(domain: str) -> List[Dict[str, Any]]
~~~


List authenticated, RBAC-visible actions for one domain.

Source: `lightbulb/async_client.py:1234`.

##### `lightbulb.async_client.AsyncLightbulbClient.list_domains`



~~~python
async def list_domains() -> Dict[str, Dict[str, Any]] | List[Dict[str, Any]]
~~~


Source: `lightbulb/async_client.py:1225`.

##### `lightbulb.async_client.AsyncLightbulbClient.list_marketplace_installations`



~~~python
async def list_marketplace_installations(*, status: str | None=None, cursor: str | None=None, limit: int=50) -> Dict[str, Any]
~~~


List marketplace installations for the selected active company.

Source: `lightbulb/async_client.py:1756`.

##### `lightbulb.async_client.AsyncLightbulbClient.list_marketplace_listings`



~~~python
async def list_marketplace_listings(*, query: str | None=None, kind: str | None=None, domain: str | None=None, cursor: str | None=None, limit: int=50, include_inputs: bool=True) -> Dict[str, Any]
~~~


List persisted lifecycle listings and authoritative UUID IDs.

Source: `lightbulb/async_client.py:1566`.

##### `lightbulb.async_client.AsyncLightbulbClient.list_pending_approvals`



~~~python
async def list_pending_approvals() -> List[Dict[str, Any]]
~~~


Source: `lightbulb/async_client.py:3712`.

##### `lightbulb.async_client.AsyncLightbulbClient.list_project_business_outcomes`



~~~python
async def list_project_business_outcomes(project_id: str, *, limit: int=25) -> Dict[str, Any]
~~~


Read the authenticated score ledger for one accessible project.

Source: `lightbulb/async_client.py:3052`.

##### `lightbulb.async_client.AsyncLightbulbClient.list_project_learning_result_evaluations`



~~~python
async def list_project_learning_result_evaluations(project_id: str, *, limit: int=25) -> Dict[str, Any]
~~~


Read independent technical results and separate human decisions.

Source: `lightbulb/async_client.py:2918`.

##### `lightbulb.async_client.AsyncLightbulbClient.list_project_learning_reviews`



~~~python
async def list_project_learning_reviews(project_id: str, *, limit: int=25) -> Dict[str, Any]
~~~


Read human after-action decisions and admitted shadow observations.

Source: `lightbulb/async_client.py:2745`.

##### `lightbulb.async_client.AsyncLightbulbClient.list_project_learning_runs`



~~~python
async def list_project_learning_runs(project_id: str, *, limit: int=25) -> Dict[str, Any]
~~~


Read receipt-backed Training Quest state without inferring missing execution.

Source: `lightbulb/async_client.py:2802`.

##### `lightbulb.async_client.AsyncLightbulbClient.list_project_mission_runs`



~~~python
async def list_project_mission_runs(project_id: str, *, limit: int=25) -> Dict[str, Any]
~~~


Read briefing locks and action bindings for one accessible project.

Source: `lightbulb/async_client.py:2646`.

##### `lightbulb.async_client.AsyncLightbulbClient.list_project_policy_assignments`



~~~python
async def list_project_policy_assignments(project_id: str, *, limit: int=25) -> Dict[str, Any]
~~~


Read immutable decision-time probability assignments for one project.

Source: `lightbulb/async_client.py:3124`.

##### `lightbulb.async_client.AsyncLightbulbClient.list_project_policy_evaluations`



~~~python
async def list_project_policy_evaluations(project_id: str, *, limit: int=25) -> Dict[str, Any]
~~~


Read offline-policy receipts and their explicit truth boundary.

Source: `lightbulb/async_client.py:3200`.

##### `lightbulb.async_client.AsyncLightbulbClient.list_project_science_evidence`



~~~python
async def list_project_science_evidence(project_id: str, *, limit: int=50) -> Dict[str, Any]
~~~


Read the scope-verified hypothesis-to-policy context spine.

Source: `lightbulb/async_client.py:2564`.

##### `lightbulb.async_client.AsyncLightbulbClient.list_project_shadow_learner_updates`



~~~python
async def list_project_shadow_learner_updates(project_id: str, *, limit: int=25) -> Dict[str, Any]
~~~


Read bounded shadow update/rollback receipts; this grants no authority.

Source: `lightbulb/async_client.py:2978`.

##### `lightbulb.async_client.AsyncLightbulbClient.list_project_skill_matches`



~~~python
async def list_project_skill_matches(project_id: str, *, limit: int=25) -> Dict[str, Any]
~~~


Read the project's worker-verified shadow Training Arena ledger.

Source: `lightbulb/async_client.py:2764`.

##### `lightbulb.async_client.AsyncLightbulbClient.list_project_training_packs`



~~~python
async def list_project_training_packs(project_id: str, *, limit: int=25) -> Dict[str, Any]
~~~


Read exact Arena + human-lesson packs before any learning-run admission.

Source: `lightbulb/async_client.py:2783`.

##### `lightbulb.async_client.AsyncLightbulbClient.list_runtime_domain_actions`



~~~python
async def list_runtime_domain_actions(*, project_id: str, status: str='pending_approval', company_id: str | None=None) -> Dict[str, Any]
~~~


List one explicit lifecycle state for the selected company.

Source: `lightbulb/async_client.py:1456`.

##### `lightbulb.async_client.AsyncLightbulbClient.list_server_workflow_improvement_packets`



~~~python
async def list_server_workflow_improvement_packets(*, status: str | None=None, limit: int=50) -> List[Dict[str, Any]]
~~~


Source: `lightbulb/async_client.py:2155`.

##### `lightbulb.async_client.AsyncLightbulbClient.list_voice_executions`



~~~python
async def list_voice_executions(**filters: Any) -> List[Dict[str, Any]]
~~~


Source: `lightbulb/async_client.py:3743`.

##### `lightbulb.async_client.AsyncLightbulbClient.list_voice_pending_approvals`



~~~python
async def list_voice_pending_approvals() -> List[Dict[str, Any]]
~~~


Source: `lightbulb/async_client.py:3754`.

##### `lightbulb.async_client.AsyncLightbulbClient.memory_regulate`



~~~python
async def memory_regulate(*, idempotency_key: str | None=None, project_id: str | None=None, budget: int | None=None, categories: Sequence[str] | None=None, dry_run: bool=True, max_summary_chars: int=900, empirical_success_floor_ppm: int | None=None, empirical_success_min_samples: int=20, empirical_success_lookback_days: int=90, optimize_for_least_active_memory: bool=False, held_out_task_evaluation: Mapping[str, Any] | None=None) -> Dict[str, Any]
~~~


Preview or execute success-evidence-aware Memory compaction.

Source: `lightbulb/async_client.py:1257`.

##### `lightbulb.async_client.AsyncLightbulbClient.memory_regulation_storage_status`



~~~python
async def memory_regulation_storage_status() -> Dict[str, Any]
~~~


Inspect finite compaction-receipt admission without mutation.

Source: `lightbulb/async_client.py:1247`.

##### `lightbulb.async_client.AsyncLightbulbClient.native_async_methods`



~~~python
def native_async_methods() -> list[str]
~~~


Public operations implemented directly with async I/O.

Source: `lightbulb/async_client.py:318`.

##### `lightbulb.async_client.AsyncLightbulbClient.page_builder_send_message`



~~~python
async def page_builder_send_message(session_id: str, content: str) -> Dict[str, Any]
~~~


Source: `lightbulb/async_client.py:3689`.

##### `lightbulb.async_client.AsyncLightbulbClient.pin_marketplace_action`



~~~python
async def pin_marketplace_action(installation_id: str, revision_id: str, *, idempotency_key: str, expected_revision_id: str | None=None) -> Dict[str, Any]
~~~


Pin an installation to an immutable listing revision.

Source: `lightbulb/async_client.py:1864`.

##### `lightbulb.async_client.AsyncLightbulbClient.preflight_project_creation`



~~~python
async def preflight_project_creation(name: str, instructions: str='') -> ProjectCreationPreflightReceipt
~~~


Run the typed, shadow/read-only project-creation preflight.

Source: `lightbulb/async_client.py:3282`.

##### `lightbulb.async_client.AsyncLightbulbClient.preflight_training_pair`



~~~python
async def preflight_training_pair(installation_id: str, revision_id: str, *, project_id: str | None=None) -> Dict[str, Any]
~~~


Read readiness without admitting, scheduling, or launching training.

Source: `lightbulb/async_client.py:2020`.

##### `lightbulb.async_client.AsyncLightbulbClient.prepare_project_learning_run`



~~~python
async def prepare_project_learning_run(project_id: str, *, training_pack_receipt_id: Any, primary_metric: Any, runtime: str='automl', request_id: Any=None, direction: str='maximize', minimum_improvement: Any='0.010000', max_cost_usd: Any='0.000000', max_platform_cost_usd: Any='5.000000', max_gpu_seconds: Any=3600, max_tokens: Any=100000, max_steps: Any=10000, provider_account_fingerprint: Any=None, provider_binding_expires_at: Any=None, max_attempts: Any=3, lease_seconds: Any=300, preemptible: bool=True, confirm_prepare: bool=False, idempotency_key: str | None=None) -> Dict[str, Any]
~~~


Publish exact dataset custody and create a queued durable Memory run.

Source: `lightbulb/async_client.py:2821`.

##### `lightbulb.async_client.AsyncLightbulbClient.prepare_workflow_learning_handoff`



~~~python
async def prepare_workflow_learning_handoff(packet_id: str, delivery_id: str, installation_id: str, revision_id: str, *, candidate_manifest: Dict[str, Any], episode_manifest: Dict[str, Any] | None=None, project_id: str | None=None) -> Dict[str, Any]
~~~


Bind a validated delivery to read-only paired-learning readiness.

Source: `lightbulb/async_client.py:2300`.

##### `lightbulb.async_client.AsyncLightbulbClient.preview_account_shell_customization`



~~~python
async def preview_account_shell_customization(draft_revision_id: str) -> Dict[str, Any]
~~~


Compile a draft into a non-publishing preview receipt.

Source: `lightbulb/async_client.py:1333`.

##### `lightbulb.async_client.AsyncLightbulbClient.preview_marketplace_action_publication`



~~~python
async def preview_marketplace_action_publication(*, slug: str, name: str, version: str, domain: str, action: str, visibility: str='PRIVATE', pricing_model: str='INCLUDED', changelog: str='') -> Dict[str, Any]
~~~


Preview a server-derived immutable action contract without publishing it.

Source: `lightbulb/async_client.py:1619`.

##### `lightbulb.async_client.AsyncLightbulbClient.publish_account_shell_customization`



~~~python
async def publish_account_shell_customization(draft_revision_id: str, *, preview_receipt_id: str, expected_current_revision_id: str | None, idempotency_key: str) -> Dict[str, Any]
~~~


Publish the exact previewed draft with optimistic concurrency.

Source: `lightbulb/async_client.py:1354`.

##### `lightbulb.async_client.AsyncLightbulbClient.publish_marketplace_action`



~~~python
async def publish_marketplace_action(*, slug: str, name: str, version: str, domain: str, action: str, expected_contract_digest: str, idempotency_key: str, visibility: str='PRIVATE', pricing_model: str='INCLUDED', changelog: str='') -> Dict[str, Any]
~~~


Publish the exact action contract approved by a prior preview.

Source: `lightbulb/async_client.py:1651`.

##### `lightbulb.async_client.AsyncLightbulbClient.record_project_business_outcome`



~~~python
async def record_project_business_outcome(project_id: str, *, metric_id: Any, metric_label: Any, direction: Any, baseline_value: Any, observed_value: Any, confirm_record: bool=False, unit: Any=None, observed_at: Any=None, observation_id: Any=None, source_kind: str='human_attestation', source_event_id: Any=None, evidence_refs: Sequence[Any] | None=None, links: Mapping[str, Any] | None=None, note: Any=None, idempotency_key: str | None=None) -> Dict[str, Any]
~~~


Append one scoped metric observation; never admit learning or promotion.

Source: `lightbulb/async_client.py:3071`.

##### `lightbulb.async_client.AsyncLightbulbClient.record_project_coding_harness_result`



~~~python
async def record_project_coding_harness_result(project_id: str, *, harness: str, handoff_payload_id: str, status: str, summary: str, report_id: str | None=None, host_session_ref: str | None=None, changed_files: Sequence[str] | None=None, test_commands_and_results: Sequence[str] | None=None, unresolved_requirements_or_acceptance_gaps: str | None=None, pull_request_url: str | None=None, commit_sha: str | None=None) -> Dict[str, Any]
~~~


Return bounded coding evidence to the Project Agent delivery loop.

Source: `lightbulb/async_client.py:865`.

##### `lightbulb.async_client.AsyncLightbulbClient.record_project_learning_review`



~~~python
async def record_project_learning_review(project_id: str, *, mission_run_receipt_id: Any, mission_action_receipt_id: Any, outcome_receipt_id: Any, decision: Any, skill_trial_arm: Any, selected_skill_ids: Sequence[Any] | None, label: Any, reason: Any, confirm_record: bool=False, review_id: Any=None, evidence_refs: Sequence[Any] | None=None, idempotency_key: str | None=None) -> Dict[str, Any]
~~~


Human-review one exact chain for shadow training; no live learner mutation.

Source: `lightbulb/async_client.py:3003`.

##### `lightbulb.async_client.AsyncLightbulbClient.record_project_policy_assignment`



~~~python
async def record_project_policy_assignment(project_id: str, *, metric_id: Any, direction: Any, actions: Sequence[Mapping[str, Any]], chosen_action_id: Any, behavior_policy: Mapping[str, Any], candidate_policies: Sequence[Mapping[str, Any]], confirm_record: bool=False, assignment_id: Any=None, unit: Any=None, decided_at: Any=None, source_kind: str='human_attestation', source_event_id: Any=None, evidence_refs: Sequence[Any] | None=None, links: Mapping[str, Any] | None=None, note: Any=None, idempotency_key: str | None=None) -> Dict[str, Any]
~~~


Log propensities before an outcome; this never executes an action.

Source: `lightbulb/async_client.py:3143`.

##### `lightbulb.async_client.AsyncLightbulbClient.record_project_science_evidence`



~~~python
async def record_project_science_evidence(project_id: str, *, stage: Any, summary: Any, business_metric_id: Any, expected_direction: Any, artifact_kind: Any, artifact_system: Any, artifact_reference: Any, artifact_digest_sha256: Any, producer_role: Any, confirm_record: bool=False, tool_names: Sequence[Any] | None=None, skill_ids: Sequence[Any] | None=None, parent_receipt_ids: Sequence[Any] | None=None, artifact_schema: Any=None, observed_at: Any=None, evidence_id: Any=None, source_kind: str='human_attestation', source_event_id: Any=None, evidence_refs: Sequence[Any] | None=None, idempotency_key: str | None=None) -> Dict[str, Any]
~~~


Append scientific lineage evidence; never authorize the underlying action.

Source: `lightbulb/async_client.py:2583`.

##### `lightbulb.async_client.AsyncLightbulbClient.record_server_workflow_improvement_run`



~~~python
async def record_server_workflow_improvement_run(payload: Dict[str, Any]) -> Dict[str, Any]
~~~


Persist a pre-sanitized evaluator run in the authenticated company scope.

Source: `lightbulb/async_client.py:2125`.

##### `lightbulb.async_client.AsyncLightbulbClient.record_workflow_improvement_delivery_event`



~~~python
async def record_workflow_improvement_delivery_event(delivery_id: str, event_type: str, *, rationale: str='', evidence: Dict[str, Any] | None=None) -> Dict[str, Any]
~~~


Source: `lightbulb/async_client.py:2234`.

##### `lightbulb.async_client.AsyncLightbulbClient.recursive_agent_execute`



~~~python
async def recursive_agent_execute(objective: str, *, inputs: Dict[str, Any] | None=None, policy: Any=None, execution_id: str | None=None) -> Dict[str, Any]
~~~


Run a governed recursive objective with finite subagent and REPL limits.

Source: `lightbulb/async_client.py:3627`.

##### `lightbulb.async_client.AsyncLightbulbClient.refine_project_creation_preflight`



~~~python
async def refine_project_creation_preflight(receipt: ProjectCreationPreflightReceipt, answer: str) -> ProjectCreationPreflightReceipt
~~~


Async parity for one explicit, receipt-bound preflight answer.

Source: `lightbulb/async_client.py:3376`.

##### `lightbulb.async_client.AsyncLightbulbClient.refresh_auth`



~~~python
async def refresh_auth() -> bool
~~~


Async equivalent of :meth:`LightbulbClient.refresh_auth`.

Source: `lightbulb/async_client.py:253`.

##### `lightbulb.async_client.AsyncLightbulbClient.register_runtime_domain_action`



~~~python
async def register_runtime_domain_action(domain: str, action: str, *, project_id: str, idempotency_key: str, description: str='', component_ids: Sequence[str] | None=None, agent_spec: Dict[str, Any] | None=None, execution_policy: Dict[str, Any] | None=None, company_id: str | None=None) -> Dict[str, Any]
~~~


Register a company-scoped action as ``pending_approval`` only.

Source: `lightbulb/async_client.py:1419`.

##### `lightbulb.async_client.AsyncLightbulbClient.reject_runtime_domain_action`



~~~python
async def reject_runtime_domain_action(runtime_action_id: str, *, project_id: str, company_id: str | None=None) -> Dict[str, Any]
~~~


Reject one reviewed pending registration without executing it.

Source: `lightbulb/async_client.py:1516`.

##### `lightbulb.async_client.AsyncLightbulbClient.reject_task`



~~~python
async def reject_task(task_id: str, *, comments: str='') -> Dict[str, Any]
~~~


Source: `lightbulb/async_client.py:3731`.

##### `lightbulb.async_client.AsyncLightbulbClient.request_training_pair_admission`



~~~python
async def request_training_pair_admission(installation_id: str, revision_id: str, *, idempotency_key: str, project_id: str | None=None) -> Dict[str, Any]
~~~


Request admission while preserving only the structured hard-503 body.

Source: `lightbulb/async_client.py:2048`.

##### `lightbulb.async_client.AsyncLightbulbClient.rollback_account_shell_customization`



~~~python
async def rollback_account_shell_customization(target_revision_id: str, *, expected_current_revision_id: str | None, idempotency_key: str) -> Dict[str, Any]
~~~


Roll back to an immutable revision with optimistic concurrency.

Source: `lightbulb/async_client.py:1388`.

##### `lightbulb.async_client.AsyncLightbulbClient.search_agent_marketplace`



~~~python
async def search_agent_marketplace(*, query: str | None=None, kind: str | None=None, domain: str | None=None, limit: int=50, include_inputs: bool=True) -> Dict[str, Any]
~~~


Discover synthetic rows; use the persisted list for lifecycle UUIDs.

Source: `lightbulb/async_client.py:1534`.

##### `lightbulb.async_client.AsyncLightbulbClient.search_documents`



~~~python
async def search_documents(query: str, *, top_k: int=10) -> Dict[str, Any]
~~~


Source: `lightbulb/async_client.py:3680`.

##### `lightbulb.async_client.AsyncLightbulbClient.start_project_mission_run`



~~~python
async def start_project_mission_run(project_id: str, mission_briefing: Mapping[str, Any], *, confirm_start: bool=False, run_id: Any=None, play_style_id: Any=None, skill_trial_arm: Any=None, selected_skill_ids: Sequence[Any] | None=None, context_source_refs: Sequence[Any] | None=None, note: Any=None, idempotency_key: str | None=None) -> Dict[str, Any]
~~~


Lock an exact briefing before action; this never dispatches a worker.

Source: `lightbulb/async_client.py:2665`.

##### `lightbulb.async_client.AsyncLightbulbClient.start_workflow_improvement_delivery`



~~~python
async def start_workflow_improvement_delivery(packet_id: str, *, environment: str, repository_ref: str | None=None, base_branch: str='main') -> Dict[str, Any]
~~~


Source: `lightbulb/async_client.py:2210`.

##### `lightbulb.async_client.AsyncLightbulbClient.stop_aoc_run`



~~~python
async def stop_aoc_run(run_id: str) -> Dict[str, Any]
~~~


Source: `lightbulb/async_client.py:3787`.

##### `lightbulb.async_client.AsyncLightbulbClient.stream_chat`



~~~python
async def stream_chat(domain: str, *, message: str, action: str | None=None, inputs: Dict[str, Any] | None=None, conversation_id: str | None=None, company_id: str | None=None) -> AsyncGenerator[SSEEvent, None]
~~~


Source: `lightbulb/async_client.py:2469`.

##### `lightbulb.async_client.AsyncLightbulbClient.stream_code_workspace_chat`



~~~python
async def stream_code_workspace_chat(workspace_id: str, message: str, **kwargs: Any) -> AsyncGenerator[SSEEvent, None]
~~~


Source: `lightbulb/async_client.py:3463`.

##### `lightbulb.async_client.AsyncLightbulbClient.stream_document_builder_message`



~~~python
async def stream_document_builder_message(session_id: str, content: str) -> AsyncGenerator[SSEEvent, None]
~~~


Source: `lightbulb/async_client.py:3492`.

##### `lightbulb.async_client.AsyncLightbulbClient.stream_page_builder_message`



~~~python
async def stream_page_builder_message(session_id: str, content: str) -> AsyncGenerator[SSEEvent, None]
~~~


Source: `lightbulb/async_client.py:3481`.

##### `lightbulb.async_client.AsyncLightbulbClient.submit_project_creation_preflight_feedback`



~~~python
async def submit_project_creation_preflight_feedback(receipt: ProjectCreationPreflightReceipt, *, helpfulness: SemanticFeedbackValue, calibrated_criticality: SemanticFeedbackValue, factual_grounding: SemanticFeedbackValue, idempotency_key: str) -> ProjectPreflightSemanticFeedbackReceipt
~~~


Async parity for explicit project-preflight semantic feedback.

Source: `lightbulb/async_client.py:3420`.

##### `lightbulb.async_client.AsyncLightbulbClient.uninstall_marketplace_action`



~~~python
async def uninstall_marketplace_action(installation_id: str, *, idempotency_key: str, reason: str='') -> Dict[str, Any]
~~~


Uninstall an action from the selected company.

Source: `lightbulb/async_client.py:1840`.

##### `lightbulb.async_client.AsyncLightbulbClient.wait_for_marketplace_action_publication`



~~~python
async def wait_for_marketplace_action_publication(publication_id: str, *, timeout_seconds: float=120.0, poll_interval_seconds: float=2.0) -> Dict[str, Any]
~~~


Poll until publication is READY, FAILED, or ARCHIVED, within hard bounds.

Source: `lightbulb/async_client.py:1701`.

##### `lightbulb.async_client.AsyncLightbulbClient.wait_for_workflow_instance`



~~~python
async def wait_for_workflow_instance(trace_id: str, *, company_id: str | None=None, timeout: float=300.0, poll_interval: float=1.0) -> Dict[str, Any]
~~~


Poll a workflow until it stops or requires human approval.

Source: `lightbulb/async_client.py:2438`.

##### `lightbulb.async_client.AsyncLightbulbClient.whoami`



~~~python
async def whoami() -> Dict[str, Any]
~~~


Source: `lightbulb/async_client.py:746`.

## Module `lightbulb.async_runtime`

Reusable async execution and partitioned streaming contracts.

### `lightbulb.async_runtime.asyncify`

function. Source: `lightbulb/async_runtime.py:58`.



~~~python
asyncify(operation: Callable[P, R] | Callable[P, Awaitable[R]]) -> Callable[P, Awaitable[R]]
~~~


Return an async callable, offloading synchronous work to a worker thread.

### `lightbulb.async_runtime.BatchExecutionError`

class. Source: `lightbulb/async_runtime.py:81`.

One item failed during bounded batch execution.

### `lightbulb.async_runtime.BatchItemResult`

class. Source: `lightbulb/async_runtime.py:92`.

Per-item result returned when ``return_exceptions`` is enabled.

Fields:
- `index: int`
- `item: T`
- `value: R | None = None`
- `error: Exception | None = None`

#### Methods

##### `lightbulb.async_runtime.BatchItemResult.succeeded`



~~~python
@property
def succeeded() -> bool
~~~


Source: `lightbulb/async_runtime.py:107`.

### `lightbulb.async_runtime.bounded_map`

function. Source: `lightbulb/async_runtime.py:112`.



~~~python
bounded_map(operation: Callable[[T], R | Awaitable[R]], items: Iterable[T], *, concurrency: int=8, return_exceptions: Literal[False]=False) -> list[R]
~~~


### `lightbulb.async_runtime.bounded_map`

function. Source: `lightbulb/async_runtime.py:122`.



~~~python
bounded_map(operation: Callable[[T], R | Awaitable[R]], items: Iterable[T], *, concurrency: int=8, return_exceptions: Literal[True]) -> list[BatchItemResult[T, R]]
~~~


### `lightbulb.async_runtime.bounded_map`

function. Source: `lightbulb/async_runtime.py:131`.



~~~python
bounded_map(operation: Callable[[T], R | Awaitable[R]], items: Iterable[T], *, concurrency: int=8, return_exceptions: bool=False) -> list[R] | list[BatchItemResult[T, R]]
~~~


Apply ``operation`` with bounded concurrency while preserving input order.

### `lightbulb.async_runtime.ReplayMode`

class. Source: `lightbulb/async_runtime.py:197`.

### `lightbulb.async_runtime.BackpressureStrategy`

class. Source: `lightbulb/async_runtime.py:203`.

### `lightbulb.async_runtime.StreamCursor`

class. Source: `lightbulb/async_runtime.py:209`.

Monotonic offset within exactly one logical stream partition.

Fields:
- `schema_id: str = Field(default=STREAM_CURSOR_SCHEMA, alias='schema')`
- `partition: str = Field(min_length=1, max_length=160, pattern='^[A-Za-z0-9._:-]+$')`
- `offset: int = Field(ge=0)`

### `lightbulb.async_runtime.StreamPartition`

class. Source: `lightbulb/async_runtime.py:219`.

Stable identity and placement of one partition in a partition set.

Fields:
- `partition_id: str = Field(min_length=1, max_length=160, pattern='^[A-Za-z0-9._:-]+$')`
- `ordinal: int = Field(ge=0)`
- `partition_count: int = Field(ge=1)`

### `lightbulb.async_runtime.ReplayPolicy`

class. Source: `lightbulb/async_runtime.py:239`.

Fields:
- `mode: ReplayMode = ReplayMode.LIVE`
- `after: StreamCursor | None = None`

### `lightbulb.async_runtime.BackpressurePolicy`

class. Source: `lightbulb/async_runtime.py:254`.

Fields:
- `max_buffered_records: int = Field(default=64, ge=1, le=100000)`
- `strategy: BackpressureStrategy = BackpressureStrategy.BLOCK`

### `lightbulb.async_runtime.PartitionedStreamContract`

class. Source: `lightbulb/async_runtime.py:261`.

Consumer-visible contract for replayable, cursor-bearing delivery.

Fields:
- `schema_id: str = Field(default=STREAM_CONTRACT_SCHEMA, alias='schema')`
- `partition: StreamPartition`
- `replay: ReplayPolicy = Field(default_factory=ReplayPolicy)`
- `backpressure: BackpressurePolicy = Field(default_factory=BackpressurePolicy)`
- `cursor_monotonic: Literal[True] = True`

### `lightbulb.async_runtime.StreamRecord`

class. Source: `lightbulb/async_runtime.py:280`.

A payload bound to its durable partition cursor.

Fields:
- `cursor: StreamCursor`
- `value: T`

### `lightbulb.async_runtime.PartitionedAsyncStream`

class. Source: `lightbulb/async_runtime.py:290`.

Protocol implemented by transports that honor a stream contract.

#### Methods

##### `lightbulb.async_runtime.PartitionedAsyncStream.read`



~~~python
def read(contract: PartitionedStreamContract) -> AsyncIterator[StreamRecord[T]]
~~~


Source: `lightbulb/async_runtime.py:293`.

### `lightbulb.async_runtime.StreamContractError`

class. Source: `lightbulb/async_runtime.py:299`.

A source record violates its declared partition or cursor contract.

### `lightbulb.async_runtime.StreamBackpressureError`

class. Source: `lightbulb/async_runtime.py:303`.

The producer exceeded an error-on-overflow buffer policy.

### `lightbulb.async_runtime.buffered_stream`

function. Source: `lightbulb/async_runtime.py:315`.



~~~python
buffered_stream(source: AsyncIterable[StreamRecord[T]], contract: PartitionedStreamContract) -> AsyncIterator[StreamRecord[T]]
~~~


Validate and buffer a partitioned stream under its backpressure policy.

## Module `lightbulb.auth`

Authentication strategies for the Lightbulb API.

### `lightbulb.auth.ApiKeyAuth`

class. Source: `lightbulb/auth.py:88`.

Authenticate with a service API key + tenant context.

#### Methods

##### `lightbulb.auth.ApiKeyAuth.apply`



~~~python
def apply(headers: Dict[str, str]) -> Dict[str, str]
~~~


Source: `lightbulb/auth.py:110`.

##### `lightbulb.auth.ApiKeyAuth.company_id`



~~~python
@property
def company_id() -> str | None
~~~


Source: `lightbulb/auth.py:124`.

##### `lightbulb.auth.ApiKeyAuth.tenant_id`



~~~python
@property
def tenant_id() -> str
~~~


Source: `lightbulb/auth.py:120`.

##### `lightbulb.auth.ApiKeyAuth.user_id`



~~~python
@property
def user_id() -> str | None
~~~


Source: `lightbulb/auth.py:128`.

### `lightbulb.auth.JwtAuth`

class. Source: `lightbulb/auth.py:135`.

Authenticate with a JWT Bearer token.

#### Methods

##### `lightbulb.auth.JwtAuth.apply`



~~~python
def apply(headers: Dict[str, str]) -> Dict[str, str]
~~~


Source: `lightbulb/auth.py:154`.

##### `lightbulb.auth.JwtAuth.company_id`



~~~python
@property
def company_id() -> str | None
~~~


Source: `lightbulb/auth.py:167`.

##### `lightbulb.auth.JwtAuth.tenant_id`



~~~python
@property
def tenant_id() -> str
~~~


Source: `lightbulb/auth.py:163`.

### `lightbulb.auth.TwoFactorRequired`

class. Source: `lightbulb/auth.py:174`.

Raised by login() when the user has 2FA enabled and no code was provided.

### `lightbulb.auth.login`

function. Source: `lightbulb/auth.py:193`.



~~~python
login(base_url: str, email: str, password: str, *, code: str | None=None, timeout: float=15.0, interactive: bool=False) -> JwtAuth
~~~


Authenticate with email/password and return a JwtAuth with the user's real permissions.

### `lightbulb.auth.complete_2fa_login`

function. Source: `lightbulb/auth.py:323`.



~~~python
complete_2fa_login(base_url: str, email: str, code: str, *, timeout: float=15.0) -> JwtAuth
~~~


Complete a two-factor login challenge.

### `lightbulb.auth.sso_redirect_url`

function. Source: `lightbulb/auth.py:559`.



~~~python
sso_redirect_url(base_url: str, provider: str='google', *, timeout: float=5.0) -> str
~~~


Resolve the OAuth2 SSO start URL for the given provider.

### `lightbulb.auth.device_login`

function. Source: `lightbulb/auth.py:597`.



~~~python
device_login(base_url: str, client_id: str='claude-code', *, poll_interval: float=5.0, open_browser: bool=True, timeout: float=15.0) -> tuple[JwtAuth, int]
~~~


Authenticate via OAuth2 Device Authorization Grant (RFC 8628).

## Module `lightbulb.business_allocation`

Business allocation: where the runway floor governs growth ambition.

### `lightbulb.business_allocation.BusinessAllocationValidationError`

class. Source: `lightbulb/business_allocation.py:85`.

Inputs cannot produce an honest funding gate.

### `lightbulb.business_allocation.FundingGatePolicy`

class. Source: `lightbulb/business_allocation.py:178`.

How much of the envelope's capacity may be aimed at growth.

Fields:
- `deploy_fraction: Decimal = Field(default=Decimal('1.000000'), gt=0, le=Decimal('1'), multiple_of=_RATE_QUANTUM)`

### `lightbulb.business_allocation.ObjectiveFundingGate`

class. Source: `lightbulb/business_allocation.py:196`.

One deterministic answer to 'may we spend to chase this objective?'.

Fields:
- `schema_id: Literal['lightbulb.objective_funding_gate.v1'] = Field(default=OBJECTIVE_FUNDING_GATE_SCHEMA, alias='schema')`
- `gate_ref: PortableRef`
- `as_of: str`
- `currency: CurrencyCode`
- `objective_ref: PortableRef`
- `objective_verdict: Literal['on_track', 'at_risk', 'off_track', 'achieved', 'expired_missed']`
- `assessment_digest: Sha256Digest`
- `runway_digest: Sha256Digest`
- `runway_status: Literal['burning', 'not_burning', 'unknown']`
- `verdict: FundingGateVerdict`
- `zero_cost_levers_only: bool`
- `monthly_contribution_gap: Decimal = Field(ge=0, multiple_of=_MONEY_QUANTUM)`
- `current_runway_months: Decimal | None = None`
- `runway_floor_months: Decimal = Field(gt=0)`
- `deployable_monthly: Decimal | None = None`
- `deployable_one_time: Decimal | None = None`
- `rationale: ShortText`
- `notes: tuple[ShortText, ...] = Field(default_factory=tuple, max_length=10)`
- `gate_digest: Sha256Digest = '0' * 64`

### `lightbulb.business_allocation.GateObjectiveFundingInput`

class. Source: `lightbulb/business_allocation.py:263`.

Fields:
- `gate_ref: PortableRef`
- `as_of: str`
- `objective_assessment: ObjectiveAssessment`
- `budget_envelope: CashBudgetEnvelope`
- `policy: FundingGatePolicy = Field(default_factory=FundingGatePolicy)`

### `lightbulb.business_allocation.gate_objective_funding`

function. Source: `lightbulb/business_allocation.py:276`.



~~~python
gate_objective_funding(inputs: GateObjectiveFundingInput | Mapping[str, Any]) -> ObjectiveFundingGate
~~~


Decide whether — and how much — paid growth the runway floor allows.

### `lightbulb.business_allocation.GateObjectiveFundingPrimitive`

class. Source: `lightbulb/business_allocation.py:504`.

Let the runway floor govern whether paid growth is affordable.

## Module `lightbulb.business_primitives`

Business primitive catalog and executor helpers for Lightbulb MCP hosts.

### `lightbulb.business_primitives.PrimitiveField`

class. Source: `lightbulb/business_primitives.py:183`.

Fields:
- `name: str`
- `type: str = 'string'`
- `description: str = ''`
- `required: bool = False`

#### Methods

##### `lightbulb.business_primitives.PrimitiveField.to_dict`



~~~python
def to_dict() -> Dict[str, Any]
~~~


Source: `lightbulb/business_primitives.py:189`.

### `lightbulb.business_primitives.BusinessPrimitive`

class. Source: `lightbulb/business_primitives.py:199`.

Fields:
- `id: str`
- `title: str`
- `category: str`
- `summary: str`
- `description: str`
- `risk_level: str = 'low'`
- `approval_required: bool = False`
- `default_mode: str = 'draft'`
- `domain: str = ''`
- `action: str = 'chat'`
- `connector_tools: Tuple[str, ...] = field(default_factory=tuple)`
- `capability_hints: Tuple[str, ...] = field(default_factory=tuple)`
- `additional_inputs_allowed: bool = True`
- `setup_requirements: Tuple[str, ...] = field(default_factory=tuple)`
- `trigger_events: Tuple[str, ...] = field(default_factory=tuple)`
- `emits: Tuple[str, ...] = field(default_factory=tuple)`
- `follow_up_primitives: Tuple[str, ...] = field(default_factory=tuple)`
- `agent_builder_guidance: str = ''`
- `input_fields: Tuple[PrimitiveField, ...] = field(default_factory=tuple)`
- `example_prompt: str = ''`
- `backbone_fallback_available: bool = True`

#### Methods

##### `lightbulb.business_primitives.BusinessPrimitive.to_dict`



~~~python
def to_dict(*, include_inputs: bool=True) -> Dict[str, Any]
~~~


Source: `lightbulb/business_primitives.py:222`.

### `lightbulb.business_primitives.primitive_runtime_contract`

function. Source: `lightbulb/business_primitives.py:272`.



~~~python
primitive_runtime_contract(primitive: BusinessPrimitive, *, include_inputs: bool=True) -> Dict[str, Any]
~~~


Return the versioned runtime contract for a business primitive.

### `lightbulb.business_primitives.get_business_primitive`

function. Source: `lightbulb/business_primitives.py:4051`.



~~~python
get_business_primitive(primitive_id: str) -> BusinessPrimitive
~~~


### `lightbulb.business_primitives.list_business_primitives`

function. Source: `lightbulb/business_primitives.py:4059`.



~~~python
list_business_primitives(*, category: str | None=None, query: str | None=None, include_inputs: bool=True) -> List[Dict[str, Any]]
~~~


### `lightbulb.business_primitives.business_primitive_catalog`

function. Source: `lightbulb/business_primitives.py:4105`.



~~~python
business_primitive_catalog(*, category: str | None=None, query: str | None=None, include_inputs: bool=True, summary_only: bool=False, offset: int=0, limit: int | None=None) -> Dict[str, Any]
~~~


### `lightbulb.business_primitives.business_primitive_capability_projection`

function. Source: `lightbulb/business_primitives.py:4339`.



~~~python
business_primitive_capability_projection(primitive: BusinessPrimitive) -> Dict[str, Any]
~~~


Project one catalog primitive with its exact executable metadata.

### `lightbulb.business_primitives.business_primitive_capability_projections`

function. Source: `lightbulb/business_primitives.py:4350`.



~~~python
business_primitive_capability_projections(*, category: str | None=None, query: str | None=None) -> List[Dict[str, Any]]
~~~


Return MCP-ready descriptors for matching catalog primitives.

### `lightbulb.business_primitives.sdk_only_business_primitive_capability_projections`

function. Source: `lightbulb/business_primitives.py:4455`.



~~~python
sdk_only_business_primitive_capability_projections() -> List[Dict[str, Any]]
~~~


Expose typed SDK primitives that intentionally lack Backbone catalog routes.

### `lightbulb.business_primitives.execute_business_primitive`

function. Source: `lightbulb/business_primitives.py:4564`.



~~~python
execute_business_primitive(client: Any, primitive_id: str, inputs: Dict[str, Any] | None=None, *, source: str='sdk', mode: str | None=None, preview_only: bool=True, request: str='') -> Dict[str, Any]
~~~


### `lightbulb.business_primitives.business_workflow_builder_context`

function. Source: `lightbulb/business_primitives.py:4589`.



~~~python
business_workflow_builder_context(objective: str, *, primitive_ids: Iterable[str] | None=None, inputs: Dict[str, Any] | None=None, loop: bool=False, source: str='sdk') -> Dict[str, Any]
~~~


### `lightbulb.business_primitives.workflow_compiler_contract`

function. Source: `lightbulb/business_primitives.py:4644`.



~~~python
workflow_compiler_contract(objective: str, primitives: Iterable[BusinessPrimitive], *, inputs: Dict[str, Any] | None=None, loop: bool=False, source: str='sdk') -> Dict[str, Any]
~~~


Return the versioned contract Agent Builder must satisfy when composing primitives.

### `lightbulb.business_primitives.recommend_business_primitives`

function. Source: `lightbulb/business_primitives.py:4747`.



~~~python
recommend_business_primitives(objective: str, *, limit: int=5) -> List[Dict[str, Any]]
~~~


Rank catalog primitives for a plain-language business objective.

### `lightbulb.business_primitives.compile_business_workflow_definition`

function. Source: `lightbulb/business_primitives.py:4816`.



~~~python
compile_business_workflow_definition(objective: str, *, primitive_ids: Iterable[str] | None=None, inputs: Dict[str, Any] | None=None, workflow_name: str | None=None, workflow_type: str | None=None, trigger_event: str | None=None, owner_role: str='workflow_owner', loop: bool=False, max_iterations: int | None=None, source: str='sdk') -> Dict[str, Any]
~~~


Compile primitives into a portable, validated draft workflow definition.

### `lightbulb.business_primitives.validate_business_workflow_definition`

function. Source: `lightbulb/business_primitives.py:5232`.



~~~python
validate_business_workflow_definition(definition: Any) -> Dict[str, Any]
~~~


Validate a workflow draft without making network calls or changing state.

### `lightbulb.business_primitives.simulate_business_workflow`

function. Source: `lightbulb/business_primitives.py:5943`.



~~~python
simulate_business_workflow(definition: Any, *, events: Iterable[str] | None=None, approvals: Dict[str, Any] | None=None, loop_iterations: int | None=None) -> Dict[str, Any]
~~~


Dry-run a workflow within its declared bounds without invoking live systems.

### `lightbulb.business_primitives.business_workflow_builder_prompt`

function. Source: `lightbulb/business_primitives.py:6286`.



~~~python
business_workflow_builder_prompt(context: Dict[str, Any]) -> str
~~~


### `lightbulb.business_primitives.compose_business_workflow`

function. Source: `lightbulb/business_primitives.py:6304`.



~~~python
compose_business_workflow(client: Any, objective: str, *, primitive_ids: Iterable[str] | None=None, inputs: Dict[str, Any] | None=None, loop: bool=False, max_iterations: int | None=None, workflow_name: str | None=None, workflow_type: str | None=None, trigger_event: str | None=None, owner_role: str='workflow_owner', publish: bool=False, source: str='sdk') -> Dict[str, Any]
~~~


## Module `lightbulb.cash_forecast`

The 13-week cash-flow forecast: the CFO's operating liquidity calendar.

### `lightbulb.cash_forecast.CashForecastError`

class. Source: `lightbulb/cash_forecast.py:66`.

The forecast inputs cannot produce an honest cash calendar.

### `lightbulb.cash_forecast.ScheduledCashEvent`

class. Source: `lightbulb/cash_forecast.py:169`.

One known, dated cash movement: a receipt or a payment in a given week.

Fields:
- `event_ref: ShortText`
- `week_index: int = Field(ge=1, le=52)`
- `direction: CashEventDirection`
- `amount: Decimal = Field(gt=0)`
- `category: ShortText | None = None`

### `lightbulb.cash_forecast.CashFlowForecastInput`

class. Source: `lightbulb/cash_forecast.py:184`.

Fields:
- `forecast_ref: PortableRef`
- `as_of: str`
- `currency: CurrencyCode`
- `opening_cash: Decimal = Field(ge=0)`
- `horizon_weeks: int = Field(default=13, ge=1, le=52)`
- `scheduled_events: tuple[ScheduledCashEvent, ...] = Field(default_factory=tuple, max_length=500)`
- `assumed_weekly_operating_outflow: Decimal | None = None`
- `events_are_complete: bool = False`

### `lightbulb.cash_forecast.WeekProjection`

class. Source: `lightbulb/cash_forecast.py:230`.

Fields:
- `week_index: int = Field(ge=1, le=52)`
- `week_ending: str`
- `inflows: Decimal = Field(ge=0)`
- `outflows: Decimal = Field(ge=0)`
- `net_change: Decimal`
- `ending_cash: Decimal`

### `lightbulb.cash_forecast.CashFlowForecast`

class. Source: `lightbulb/cash_forecast.py:249`.

A dated, week-by-week cash calendar with an honest reliability flag.

Fields:
- `schema_id: Literal['lightbulb.cash_flow_forecast.v1'] = Field(default=CASH_FLOW_FORECAST_SCHEMA, alias='schema')`
- `forecast_ref: PortableRef`
- `as_of: str`
- `currency: CurrencyCode`
- `opening_cash: Decimal = Field(ge=0)`
- `horizon_weeks: int = Field(ge=1, le=52)`
- `weeks: tuple[WeekProjection, ...] = Field(default_factory=tuple)`
- `closing_cash: Decimal`
- `total_inflows: Decimal = Field(ge=0)`
- `total_outflows: Decimal = Field(ge=0)`
- `lowest_cash: Decimal`
- `lowest_cash_week: int | None = None`
- `first_negative_week: int | None = None`
- `coverage: ForecastCoverage`
- `reliability: ForecastReliability`
- `assumed_weekly_operating_outflow: Decimal | None = None`
- `notes: tuple[ShortText, ...] = Field(default_factory=tuple, max_length=12)`
- `forecast_digest: str = '0' * 64`

#### Methods

##### `lightbulb.cash_forecast.CashFlowForecast.to_dict`



~~~python
def to_dict() -> dict[str, Any]
~~~


Source: `lightbulb/cash_forecast.py:301`.

### `lightbulb.cash_forecast.build_cash_flow_forecast`

function. Source: `lightbulb/cash_forecast.py:305`.



~~~python
build_cash_flow_forecast(inputs: CashFlowForecastInput | Mapping[str, Any]) -> CashFlowForecast
~~~


Project opening cash forward, week by week, over the scheduled events.

### `lightbulb.cash_forecast.BuildCashFlowForecastPrimitive`

class. Source: `lightbulb/cash_forecast.py:437`.

Build the 13-week cash-flow forecast — the CFO's liquidity calendar.

## Module `lightbulb.cash_ingestion`

Cash evidence ingestion: the front door to the runway engine.

### `lightbulb.cash_ingestion.CashIngestionError`

class. Source: `lightbulb/cash_ingestion.py:76`.

A connector response cannot be normalized into cash evidence.

### `lightbulb.cash_ingestion.CashCoverage`

class. Source: `lightbulb/cash_ingestion.py:121`.

An honest account of what cash ingestion did and did not map.

Fields:
- `provider: CashProvider`
- `source_capability: str`
- `populated_metrics: tuple[str, ...]`
- `source_fields_used: tuple[str, ...]`
- `unrecognized_response_fields: tuple[str, ...]`

### `lightbulb.cash_ingestion.CashIngestionResult`

class. Source: `lightbulb/cash_ingestion.py:131`.

Fields:
- `schema_id: Literal['lightbulb.cash_ingestion_result.v1'] = Field(default=CASH_INGESTION_RESULT_SCHEMA, alias='schema')`
- `evidence: CashLedgerEvidence`
- `coverage: CashCoverage`

#### Methods

##### `lightbulb.cash_ingestion.CashIngestionResult.to_dict`



~~~python
def to_dict() -> dict[str, Any]
~~~


Source: `lightbulb/cash_ingestion.py:139`.

### `lightbulb.cash_ingestion.normalize_cash_response`

function. Source: `lightbulb/cash_ingestion.py:166`.



~~~python
normalize_cash_response(*, source_capability: str, response: Mapping[str, Any], observation_ref: str, connector_account_ref: str, currency: str, window_start: str, window_end: str, observed_at: str) -> CashIngestionResult
~~~


Normalize one raw cash response into sealable cash evidence.

### `lightbulb.cash_ingestion.cash_ingestion_capabilities`

function. Source: `lightbulb/cash_ingestion.py:252`.



~~~python
cash_ingestion_capabilities() -> tuple[dict[str, Any], ...]
~~~


Discoverable list of cash-ingestion capabilities and their status.

## Module `lightbulb.cash_payables`

Accounts payable: the cash you owe, aged, and its payment calendar.

### `lightbulb.cash_payables.PayablesError`

class. Source: `lightbulb/cash_payables.py:92`.

The payables inputs cannot produce an honest assessment.

### `lightbulb.cash_payables.EarlyPaymentDiscount`

class. Source: `lightbulb/cash_payables.py:191`.

Pay by `pay_by` and the vendor takes `discount_percent` off.

Fields:
- `discount_percent: Decimal = Field(gt=0, lt=100)`
- `pay_by: str`

### `lightbulb.cash_payables.OutstandingBill`

class. Source: `lightbulb/cash_payables.py:214`.

One unpaid bill: an amount owed, when it's due, when it's expected to go out.

Fields:
- `bill_ref: ShortText`
- `vendor: ShortText`
- `amount: Decimal = Field(gt=0)`
- `due_at: str`
- `scheduled_payment_at: str | None = None`
- `on_hold: bool = False`
- `trade_credit: bool | None = None`
- `critical_vendor: bool = False`
- `early_payment_discount: EarlyPaymentDiscount | None = None`

### `lightbulb.cash_payables.AssessPayablesInput`

class. Source: `lightbulb/cash_payables.py:263`.

Fields:
- `assessment_ref: PortableRef`
- `as_of: str`
- `currency: CurrencyCode`
- `bills: tuple[OutstandingBill, ...] = Field(min_length=1, max_length=1000)`
- `credit_purchases_in_period: Decimal | None = None`
- `period_days: int | None = Field(default=None, ge=1, le=366)`
- `horizon_weeks: int = Field(default=13, ge=1, le=52)`
- `book_completeness: Literal['invoices_only', 'invoices_and_commitments'] = 'invoices_only'`

### `lightbulb.cash_payables.AgingBuckets`

class. Source: `lightbulb/cash_payables.py:317`.

Fields:
- `not_yet_due: Decimal = Field(ge=0)`
- `days_0_30: Decimal = Field(ge=0)`
- `days_31_60: Decimal = Field(ge=0)`
- `days_61_90: Decimal = Field(ge=0)`
- `days_90_plus: Decimal = Field(ge=0)`

### `lightbulb.cash_payables.ExpectedPayment`

class. Source: `lightbulb/cash_payables.py:333`.

Fields:
- `bill_ref: ShortText`
- `vendor: ShortText`
- `amount: Decimal = Field(gt=0)`
- `expected_week: int = Field(ge=1, le=520)`
- `within_horizon: bool`
- `is_overdue: bool`
- `on_hold: bool = False`
- `critical_vendor: bool = False`

### `lightbulb.cash_payables.DiscountOpportunity`

class. Source: `lightbulb/cash_payables.py:351`.

An early-payment discount still open at `as_of`.

Fields:
- `bill_ref: ShortText`
- `vendor: ShortText`
- `amount: Decimal = Field(gt=0)`
- `discount_amount: Decimal = Field(gt=0)`
- `pay_by: str`
- `days_accelerated: Decimal = Field(gt=0)`
- `implied_annual_return_percent: Decimal = Field(ge=0)`

### `lightbulb.cash_payables.PayablesAssessment`

class. Source: `lightbulb/cash_payables.py:389`.

AP aged and scheduled: what's owed, how late, how fast paid, when due out.

Fields:
- `schema_id: Literal['lightbulb.payables_assessment.v2'] = Field(default=PAYABLES_ASSESSMENT_SCHEMA, alias='schema')`
- `assessment_ref: PortableRef`
- `as_of: str`
- `currency: CurrencyCode`
- `total_outstanding: Decimal = Field(ge=0)`
- `overdue_total: Decimal = Field(ge=0)`
- `on_hold_total: Decimal = Field(ge=0)`
- `on_hold_overdue_total: Decimal = Field(ge=0)`
- `trade_payables_outstanding: Decimal | None = Field(default=None, ge=0)`
- `obligations_are_floor: bool`
- `aging: AgingBuckets`
- `dpo_days: Decimal | None = None`
- `largest_vendor: ShortText | None = None`
- `largest_vendor_share: Decimal | None = None`
- `concentration_flag: bool = False`
- `horizon_weeks: int = Field(ge=1, le=52)`
- `payments_within_horizon: Decimal = Field(ge=0)`
- `expected_payments: tuple[ExpectedPayment, ...] = Field(default_factory=tuple)`
- `discount_opportunities: tuple[DiscountOpportunity, ...] = Field(default_factory=tuple)`
- `critical_vendors_overdue: tuple[ShortText, ...] = Field(default_factory=tuple, max_length=50)`
- `critical_vendors_overdue_count: int = Field(ge=0)`
- `critical_vendor_overdue_total: Decimal = Field(ge=0)`
- `critical_vendors_on_hold: tuple[ShortText, ...] = Field(default_factory=tuple, max_length=50)`
- `critical_vendors_on_hold_count: int = Field(ge=0)`
- `notes: tuple[ShortText, ...] = Field(default_factory=tuple, max_length=16)`
- `assessment_digest: str = '0' * 64`

#### Methods

##### `lightbulb.cash_payables.PayablesAssessment.to_dict`



~~~python
def to_dict() -> dict[str, Any]
~~~


Source: `lightbulb/cash_payables.py:479`.

### `lightbulb.cash_payables.build_payables_assessment`

function. Source: `lightbulb/cash_payables.py:489`.



~~~python
build_payables_assessment(inputs: AssessPayablesInput | Mapping[str, Any]) -> PayablesAssessment
~~~


Age the payables, compute DPO, and schedule expected payments.

### `lightbulb.cash_payables.AssessPayablesPrimitive`

class. Source: `lightbulb/cash_payables.py:809`.

Age accounts payable, compute DPO, and schedule expected payments.

## Module `lightbulb.cash_receivables`

Accounts receivable: the cash you're owed, aged, and its collection calendar.

### `lightbulb.cash_receivables.ReceivablesError`

class. Source: `lightbulb/cash_receivables.py:64`.

The receivables inputs cannot produce an honest assessment.

### `lightbulb.cash_receivables.OutstandingInvoice`

class. Source: `lightbulb/cash_receivables.py:163`.

One unpaid invoice: an amount owed, when it's due, when it's expected.

Fields:
- `invoice_ref: ShortText`
- `customer: ShortText`
- `amount: Decimal = Field(gt=0)`
- `due_at: str`
- `expected_payment_at: str | None = None`
- `uncollectible: bool = False`

### `lightbulb.cash_receivables.AssessReceivablesInput`

class. Source: `lightbulb/cash_receivables.py:193`.

Fields:
- `assessment_ref: PortableRef`
- `as_of: str`
- `currency: CurrencyCode`
- `invoices: tuple[OutstandingInvoice, ...] = Field(min_length=1, max_length=1000)`
- `credit_sales_in_period: Decimal | None = None`
- `period_days: int | None = Field(default=None, ge=1, le=366)`
- `horizon_weeks: int = Field(default=13, ge=1, le=52)`

### `lightbulb.cash_receivables.AgingBuckets`

class. Source: `lightbulb/cash_receivables.py:227`.

Fields:
- `not_yet_due: Decimal = Field(ge=0)`
- `days_0_30: Decimal = Field(ge=0)`
- `days_31_60: Decimal = Field(ge=0)`
- `days_61_90: Decimal = Field(ge=0)`
- `days_90_plus: Decimal = Field(ge=0)`

### `lightbulb.cash_receivables.ExpectedCollection`

class. Source: `lightbulb/cash_receivables.py:243`.

Fields:
- `invoice_ref: ShortText`
- `customer: ShortText`
- `amount: Decimal = Field(gt=0)`
- `expected_week: int = Field(ge=1, le=520)`
- `within_horizon: bool`
- `is_overdue: bool`

### `lightbulb.cash_receivables.ReceivablesAssessment`

class. Source: `lightbulb/cash_receivables.py:257`.

AR aged and scheduled: what's owed, how late, how fast collected, when due.

Fields:
- `schema_id: Literal['lightbulb.receivables_assessment.v1'] = Field(default=RECEIVABLES_ASSESSMENT_SCHEMA, alias='schema')`
- `assessment_ref: PortableRef`
- `as_of: str`
- `currency: CurrencyCode`
- `total_outstanding: Decimal = Field(ge=0)`
- `overdue_total: Decimal = Field(ge=0)`
- `written_off_excluded: Decimal = Field(ge=0)`
- `aging: AgingBuckets`
- `dso_days: Decimal | None = None`
- `largest_customer: ShortText | None = None`
- `largest_customer_share: Decimal | None = None`
- `concentration_flag: bool = False`
- `horizon_weeks: int = Field(ge=1, le=52)`
- `collections_within_horizon: Decimal = Field(ge=0)`
- `expected_collections: tuple[ExpectedCollection, ...] = Field(default_factory=tuple)`
- `notes: tuple[ShortText, ...] = Field(default_factory=tuple, max_length=12)`
- `assessment_digest: str = '0' * 64`

#### Methods

##### `lightbulb.cash_receivables.ReceivablesAssessment.to_dict`



~~~python
def to_dict() -> dict[str, Any]
~~~


Source: `lightbulb/cash_receivables.py:313`.

### `lightbulb.cash_receivables.build_receivables_assessment`

function. Source: `lightbulb/cash_receivables.py:323`.



~~~python
build_receivables_assessment(inputs: AssessReceivablesInput | Mapping[str, Any]) -> ReceivablesAssessment
~~~


Age the receivables, compute DSO, and schedule expected collections.

### `lightbulb.cash_receivables.AssessReceivablesPrimitive`

class. Source: `lightbulb/cash_receivables.py:485`.

Age accounts receivable, compute DSO, and schedule expected collections.

## Module `lightbulb.cash_runway`

Cash & runway engine: the financial guardrail of the AI business.

### `lightbulb.cash_runway.CashRunwayValidationError`

class. Source: `lightbulb/cash_runway.py:193`.

Cash evidence, a runway snapshot, or a budget envelope broke the contract.

### `lightbulb.cash_runway.CashFlowMetrics`

class. Source: `lightbulb/cash_runway.py:354`.

Normalized cash-basis values for one observation window.

Fields:
- `cash_inflows: Decimal | None = Field(default=None, ge=0)`
- `cash_outflows: Decimal | None = Field(default=None, ge=0)`
- `ending_cash_balance: Decimal | None = Field(default=None, ge=0)`

### `lightbulb.cash_runway.CashLedgerEvidence`

class. Source: `lightbulb/cash_runway.py:385`.

One sealed connector cash observation admissible into a runway snapshot.

Fields:
- `observation_ref: PortableRef`
- `connector_account_ref: OperationRef`
- `provider: CashProvider`
- `source_capability: str = Field(min_length=3, max_length=160, pattern='^[a-z][a-z0-9_-]{0,63}\\.[a-z][a-z0-9_.-]{0,127}$')`
- `currency: CurrencyCode`
- `observed_at: str`
- `window_start: str`
- `window_end: str`
- `metrics: CashFlowMetrics`
- `evidence_digest: Sha256Digest`
- `receipt_key_id: str | None = Field(default=None, min_length=8, max_length=80, pattern='^[A-Za-z0-9][A-Za-z0-9._-]{7,79}$')`
- `exact_scope_digest: Sha256Digest | None = None`
- `evidence_hmac: Sha256Digest | None = None`

#### Methods

##### `lightbulb.cash_runway.CashLedgerEvidence.hmac_payload`



~~~python
def hmac_payload() -> dict[str, Any]
~~~


Return the complete canonical observation covered by host HMAC.

Source: `lightbulb/cash_runway.py:443`.

##### `lightbulb.cash_runway.CashLedgerEvidence.is_attested`



~~~python
@property
def is_attested() -> bool
~~~


Source: `lightbulb/cash_runway.py:440`.

### `lightbulb.cash_runway.mint_cash_ledger_evidence`

function. Source: `lightbulb/cash_runway.py:453`.



~~~python
mint_cash_ledger_evidence(value: CashLedgerEvidence | Mapping[str, Any], *, scope: DynamicWorkflowScope | Mapping[str, Any], scope_keyring: ExactScopeDigestProvider, scope_key_id: str | None=None) -> CashLedgerEvidence
~~~


Seal one host-verified cash observation for runway use.

### `lightbulb.cash_runway.verify_cash_ledger_evidence`

function. Source: `lightbulb/cash_runway.py:524`.



~~~python
verify_cash_ledger_evidence(value: CashLedgerEvidence | Mapping[str, Any], *, scope: DynamicWorkflowScope | Mapping[str, Any], scope_keyring: ExactScopeDigestProvider) -> CashLedgerEvidence
~~~


Re-validate and verify one sealed cash envelope; raise on failure.

### `lightbulb.cash_runway.CashStalenessPolicy`

class. Source: `lightbulb/cash_runway.py:554`.

Admission budget for evidence age and verification requirements.

Fields:
- `max_evidence_age_hours: int = Field(default=1440, ge=1, le=8760)`
- `require_verified_evidence: bool = False`

### `lightbulb.cash_runway.RunwayComponent`

class. Source: `lightbulb/cash_runway.py:561`.

One derived cash fact with explicit completeness and provenance.

Fields:
- `name: RunwayComponentName`
- `unit: Literal['money', 'money_per_month', 'multiple']`
- `value: Decimal`
- `complete: bool`
- `missing_inputs: tuple[CashMetricName, ...] = Field(default_factory=tuple)`
- `note: ShortText | None = None`

### `lightbulb.cash_runway.BurnBand`

class. Source: `lightbulb/cash_runway.py:598`.

A measured best/worst runway range, or a single-estimate marker.

Fields:
- `basis: BurnBandBasis`
- `period_count: int = Field(ge=1)`
- `best_runway_months: Decimal | None = None`
- `worst_runway_months: Decimal | None = None`

### `lightbulb.cash_runway.CashRunwaySnapshot`

class. Source: `lightbulb/cash_runway.py:656`.

Sealed runway state derived from admissible cash evidence.

Fields:
- `schema_id: Literal['lightbulb.cash_runway_snapshot.v1'] = Field(default=CASH_RUNWAY_SNAPSHOT_SCHEMA, alias='schema')`
- `runway_ref: PortableRef`
- `analysis_as_of: str`
- `currency: CurrencyCode`
- `evidence_scope_status: EvidenceScopeStatus`
- `staleness_policy: CashStalenessPolicy`
- `status: RunwayStatus`
- `observed_window_days: int = Field(ge=0)`
- `cash_on_hand_source: CashOnHandSource`
- `metric_presence: tuple[CashMetricPresence, ...]`
- `components: tuple[RunwayComponent, ...] = Field(default_factory=tuple)`
- `burn_band: BurnBand | None = None`
- `data_quality_notes: tuple[ShortText, ...] = Field(default_factory=tuple)`
- `admitted_evidence: tuple[AdmittedCashEvidence, ...] = Field(default_factory=tuple)`
- `excluded_evidence: tuple[ExcludedCashEvidence, ...] = Field(default_factory=tuple)`
- `runway_digest: Sha256Digest = '0' * 64`
- `receipt_key_id: str | None = Field(default=None, min_length=8, max_length=80, pattern='^[A-Za-z0-9][A-Za-z0-9._-]{7,79}$')`
- `exact_scope_digest: Sha256Digest | None = None`
- `runway_hmac: Sha256Digest | None = None`

#### Methods

##### `lightbulb.cash_runway.CashRunwaySnapshot.component`



~~~python
def component(name: RunwayComponentName) -> RunwayComponent | None
~~~


Source: `lightbulb/cash_runway.py:735`.

##### `lightbulb.cash_runway.CashRunwaySnapshot.hmac_payload`



~~~python
def hmac_payload() -> dict[str, Any]
~~~


Source: `lightbulb/cash_runway.py:741`.

##### `lightbulb.cash_runway.CashRunwaySnapshot.is_sealed`



~~~python
@property
def is_sealed() -> bool
~~~


Source: `lightbulb/cash_runway.py:732`.

### `lightbulb.cash_runway.BuildRunwayInput`

class. Source: `lightbulb/cash_runway.py:749`.

Fields:
- `analysis_as_of: str`
- `runway_ref: PortableRef`
- `currency: CurrencyCode`
- `evidence: tuple[CashLedgerEvidence, ...] = Field(min_length=1, max_length=_MAX_CASH_EVIDENCE)`
- `cash_on_hand_override: Decimal | None = Field(default=None, ge=0)`
- `staleness_policy: CashStalenessPolicy = Field(default_factory=CashStalenessPolicy)`

### `lightbulb.cash_runway.build_runway_snapshot`

function. Source: `lightbulb/cash_runway.py:855`.



~~~python
build_runway_snapshot(inputs: BuildRunwayInput | Mapping[str, Any], *, scope: DynamicWorkflowScope | Mapping[str, Any] | None=None, scope_keyring: ExactScopeDigestProvider | None=None, scope_key_id: str | None=None) -> CashRunwaySnapshot
~~~


Compute one sealed runway snapshot from admissible cash evidence.

### `lightbulb.cash_runway.verify_cash_runway_snapshot`

function. Source: `lightbulb/cash_runway.py:1240`.



~~~python
verify_cash_runway_snapshot(value: CashRunwaySnapshot | Mapping[str, Any], *, scope: DynamicWorkflowScope | Mapping[str, Any], scope_keyring: ExactScopeDigestProvider) -> CashRunwaySnapshot
~~~


Re-validate and verify one sealed runway snapshot; raise on failure.

### `lightbulb.cash_runway.CashBudgetEnvelope`

class. Source: `lightbulb/cash_runway.py:1283`.

The discretionary spend that keeps runway at or above a floor.

Fields:
- `schema_id: Literal['lightbulb.cash_budget_envelope.v1'] = Field(default=CASH_BUDGET_ENVELOPE_SCHEMA, alias='schema')`
- `envelope_ref: PortableRef`
- `analysis_as_of: str`
- `currency: CurrencyCode`
- `runway_digest: Sha256Digest`
- `runway_floor_months: Decimal = Field(gt=0)`
- `status: BudgetStatus`
- `current_runway_months: Decimal | None = None`
- `cash_on_hand: Decimal | None = None`
- `net_monthly_burn: Decimal | None = None`
- `affordable_incremental_monthly_burn: Decimal | None = None`
- `one_time_discretionary_capacity: Decimal | None = None`
- `runway_shortfall_months: Decimal | None = None`
- `complete: bool`
- `rationale: ShortText`
- `receipt_key_id: str | None = Field(default=None, min_length=8, max_length=80, pattern='^[A-Za-z0-9][A-Za-z0-9._-]{7,79}$')`
- `exact_scope_digest: Sha256Digest | None = None`
- `envelope_hmac: Sha256Digest | None = None`

#### Methods

##### `lightbulb.cash_runway.CashBudgetEnvelope.hmac_payload`



~~~python
def hmac_payload() -> dict[str, Any]
~~~


Source: `lightbulb/cash_runway.py:1361`.

##### `lightbulb.cash_runway.CashBudgetEnvelope.is_sealed`



~~~python
@property
def is_sealed() -> bool
~~~


Source: `lightbulb/cash_runway.py:1358`.

### `lightbulb.cash_runway.DeriveBudgetEnvelopeInput`

class. Source: `lightbulb/cash_runway.py:1365`.

Fields:
- `envelope_ref: PortableRef`
- `analysis_as_of: str`
- `runway_snapshot: CashRunwaySnapshot`
- `runway_floor_months: Decimal = Field(gt=0, le=Decimal('120'))`

### `lightbulb.cash_runway.derive_budget_envelope`

function. Source: `lightbulb/cash_runway.py:1382`.



~~~python
derive_budget_envelope(inputs: DeriveBudgetEnvelopeInput | Mapping[str, Any], *, scope: DynamicWorkflowScope | Mapping[str, Any] | None=None, scope_keyring: ExactScopeDigestProvider | None=None, scope_key_id: str | None=None) -> CashBudgetEnvelope
~~~


Size the discretionary spend that keeps runway at or above the floor.

### `lightbulb.cash_runway.RunwayOpportunity`

class. Source: `lightbulb/cash_runway.py:1519`.

Fields:
- `rank: int = Field(ge=1)`
- `kind: RunwayOpportunityKind`
- `title: ShortText`
- `mechanism: ShortText`
- `reference_quality: ReferenceQuality`

### `lightbulb.cash_runway.RunwayAssessment`

class. Source: `lightbulb/cash_runway.py:1527`.

Deterministic 'how healthy is the runway, and what next' answer.

Fields:
- `schema_id: Literal['lightbulb.cash_runway_assessment.v1'] = Field(default=CASH_RUNWAY_ASSESSMENT_SCHEMA, alias='schema')`
- `assessment_ref: PortableRef`
- `analysis_as_of: str`
- `runway_digest: Sha256Digest`
- `severity: RunwaySeverity`
- `runway_floor_months: Decimal = Field(gt=0)`
- `caution_threshold_months: Decimal = Field(gt=0)`
- `current_runway_months: Decimal | None = None`
- `status: RunwayStatus`
- `opportunities: tuple[RunwayOpportunity, ...] = Field(default_factory=tuple)`
- `notes: tuple[ShortText, ...] = Field(default_factory=tuple)`
- `assessment_digest: Sha256Digest = '0' * 64`

### `lightbulb.cash_runway.AssessRunwayInput`

class. Source: `lightbulb/cash_runway.py:1569`.

Fields:
- `assessment_ref: PortableRef`
- `analysis_as_of: str`
- `runway_snapshot: CashRunwaySnapshot`
- `runway_floor_months: Decimal = Field(default=Decimal('12'), gt=0, le=Decimal('120'))`
- `caution_threshold_months: Decimal = Field(default=Decimal('18'), gt=0, le=Decimal('120'))`

### `lightbulb.cash_runway.assess_runway`

function. Source: `lightbulb/cash_runway.py:1597`.



~~~python
assess_runway(inputs: AssessRunwayInput | Mapping[str, Any]) -> RunwayAssessment
~~~


Classify runway health and emit ranked, honestly-labeled next actions.

### `lightbulb.cash_runway.BuildRunwaySnapshotPrimitive`

class. Source: `lightbulb/cash_runway.py:1779`.

Compute observed net burn, cash on hand, and runway from cash evidence.

### `lightbulb.cash_runway.DeriveBudgetEnvelopePrimitive`

class. Source: `lightbulb/cash_runway.py:1847`.

Size the discretionary spend that holds runway at or above a floor.

### `lightbulb.cash_runway.AssessRunwayPrimitive`

class. Source: `lightbulb/cash_runway.py:1920`.

Classify runway health and emit ranked, honestly-labeled next actions.

## Module `lightbulb.client`

Lightbulb platform API client.

### `lightbulb.client.LightbulbClient`

class. Source: `lightbulb/client.py:2563`.

Synchronous client for the Lightbulb platform API.

#### Methods

##### `lightbulb.client.LightbulbClient.__enter__`



~~~python
def __enter__() -> 'LightbulbClient'
~~~


Open the persistent HTTP session and return this client.

Source: `lightbulb/client.py:2668`.

##### `lightbulb.client.LightbulbClient.__exit__`



~~~python
def __exit__(exc_type: Any, exc: Any, tb: Any) -> None
~~~


Source: `lightbulb/client.py:2673`.

##### `lightbulb.client.LightbulbClient.activate_marketplace_action`



~~~python
def activate_marketplace_action(installation_id: str, *, idempotency_key: str) -> Dict[str, Any]
~~~


Activate an installed action; this never approves execution policy.

Source: `lightbulb/client.py:8262`.

##### `lightbulb.client.LightbulbClient.active_company_id`



~~~python
@property
def active_company_id() -> str | None
~~~


The currently selected company context (needed for write operations).

Source: `lightbulb/client.py:2684`.

##### `lightbulb.client.LightbulbClient.active_company_id`



~~~python
@active_company_id.setter
def active_company_id(value: str | None) -> None
~~~


Source: `lightbulb/client.py:2689`.

##### `lightbulb.client.LightbulbClient.add_project_coding_harness`



~~~python
def add_project_coding_harness(project_id: str, harness: str, *, make_primary: bool=False) -> Dict[str, Any]
~~~


Attach another harness without removing any existing project harness.

Source: `lightbulb/client.py:2793`.

##### `lightbulb.client.LightbulbClient.admit_project_learning_run`



~~~python
def admit_project_learning_run(project_id: str, learning_run_id: str, *, runtime: str, capacity_admission: Mapping[str, Any], operator_approved: bool=False, confirm_admission: bool=False, idempotency_key: str | None=None) -> Dict[str, Any]
~~~


Reserve budget and admit a queued run; this still executes no training.

Source: `lightbulb/client.py:4080`.

##### `lightbulb.client.LightbulbClient.apply_aoc_tick`



~~~python
def apply_aoc_tick(tick_id: str, body: Dict[str, Any] | None=None) -> Dict[str, Any]
~~~


Apply a previously-computed AutoCompany tick (committing its decisions).

Source: `lightbulb/client.py:9570`.

##### `lightbulb.client.LightbulbClient.apply_code_workspace_proposal`



~~~python
def apply_code_workspace_proposal(workspace_id: str, proposal_id: str) -> Dict[str, Any]
~~~


Apply a previously-submitted proposal to the workspace files.

Source: `lightbulb/client.py:8998`.

##### `lightbulb.client.LightbulbClient.approve_runtime_domain_action`



~~~python
def approve_runtime_domain_action(runtime_action_id: str, *, project_id: str, company_id: str | None=None) -> Dict[str, Any]
~~~


Approve a reviewed action and return its governed recursive reference.

Source: `lightbulb/client.py:7923`.

##### `lightbulb.client.LightbulbClient.approve_task`



~~~python
def approve_task(task_id: str, *, comments: str='') -> Dict[str, Any]
~~~


Approve a pending HITL task.

Source: `lightbulb/client.py:6961`.

##### `lightbulb.client.LightbulbClient.approve_voice_action`



~~~python
def approve_voice_action(execution_id: str, approval_task_id: str, *, comments: str='') -> Dict[str, Any]
~~~


Approve a pending in-call action (e.g. transfer, wire info, commit booking).

Source: `lightbulb/client.py:8613`.

##### `lightbulb.client.LightbulbClient.archive_marketplace_action`



~~~python
def archive_marketplace_action(listing_id: str, *, idempotency_key: str, reason: str='') -> Dict[str, Any]
~~~


Archive a publisher-owned listing with a replay-safe mutation.

Source: `lightbulb/client.py:8173`.

##### `lightbulb.client.LightbulbClient.author_agentic_workflow`



~~~python
def author_agentic_workflow(prompt: str, *, name: str | None=None, workflow_type: str | None=None, preferred_domains: List[str] | None=None, include_approval_gates: bool=True, publish: bool=True, company_id: str | None=None, site_project_id: str | None=None, definition: Mapping[str, Any] | None=None) -> Dict[str, Any]
~~~


Compile once, then publish its exact executable projection through governance.

Source: `lightbulb/client.py:6772`.

##### `lightbulb.client.LightbulbClient.author_workflow_definition`



~~~python
def author_workflow_definition(definition: Mapping[str, Any], *, prompt: str='', name: str | None=None, workflow_type: str | None=None, site_project_id: str | None=None, category: str | None=None, change_notes: str | None=None, company_id: str | None=None) -> Dict[str, Any]
~~~


Publish one exact executable workflow projection through governance.

Source: `lightbulb/client.py:6624`.

##### `lightbulb.client.LightbulbClient.author_workflow_trigger`



~~~python
def author_workflow_trigger(workflow_definition_id: str, *, trigger_type: str='schedule', schedule: str | None=None, event_type: str | None=None, event_filter: Mapping[str, Any] | None=None, name: str | None=None, description: str | None=None, site_project_id: str | None=None, configuration: Mapping[str, Any] | None=None, enabled: bool=False, company_id: str | None=None) -> Dict[str, Any]
~~~


Create a principal-scoped schedule or event trigger for a workflow.

Source: `lightbulb/client.py:6679`.

##### `lightbulb.client.LightbulbClient.backbone_execute`



~~~python
def backbone_execute(objective: str, *, inputs: Dict[str, Any] | None=None) -> Dict[str, Any]
~~~


Execute a task through the backbone agent (research, analysis, code generation).

Source: `lightbulb/client.py:5125`.

##### `lightbulb.client.LightbulbClient.bind_project_mission_action`



~~~python
def bind_project_mission_action(project_id: str, mission_run_receipt_id: Any, action_event_id: Any, *, confirm_bind: bool=False, binding_id: Any=None, note: Any=None, idempotency_key: str | None=None) -> Dict[str, Any]
~~~


Bind a later event to a mission; this proves timing and scope only.

Source: `lightbulb/client.py:3915`.

##### `lightbulb.client.LightbulbClient.build_durable_project_runtime`



~~~python
def build_durable_project_runtime(project: Any, *, registry: Any=None, checkpoint_store: Any=None) -> Any
~~~


Build a durable runtime, using hosted checkpoints when possible.

Source: `lightbulb/client.py:5258`.

##### `lightbulb.client.LightbulbClient.build_dynamic_workflow_runtime`



~~~python
def build_dynamic_workflow_runtime(*, project_ref: str, hosted_project_id: str | None=None, hosted_company_id: str | None=None, checkpoint_store: Any=None) -> Any
~~~


Build the local planner/builder/evaluator state-machine runtime.

Source: `lightbulb/client.py:5611`.

##### `lightbulb.client.LightbulbClient.build_project_runtime`



~~~python
def build_project_runtime(project: Any, *, registry: Any=None) -> Any
~~~


Build a runtime using authenticated reads and safe connector previews.

Source: `lightbulb/client.py:5239`.

##### `lightbulb.client.LightbulbClient.cancel_code_workspace_run`



~~~python
def cancel_code_workspace_run(workspace_id: str, run_id: str) -> Dict[str, Any]
~~~


Cancel an in-flight coding run.

Source: `lightbulb/client.py:9050`.

##### `lightbulb.client.LightbulbClient.cancel_codex_account_link`



~~~python
def cancel_codex_account_link(session_id: str) -> Dict[str, Any]
~~~


Cancel a Codex device-auth session.

Source: `lightbulb/client.py:3214`.

##### `lightbulb.client.LightbulbClient.cancel_recursive_agent_execution`



~~~python
def cancel_recursive_agent_execution(execution_id: str) -> Dict[str, Any]
~~~


Cancel one exact user-owned recursive execution tree.

Source: `lightbulb/client.py:6599`.

##### `lightbulb.client.LightbulbClient.cancel_workflow_instance`



~~~python
def cancel_workflow_instance(trace_id: str, *, company_id: str | None=None) -> Dict[str, Any]
~~~


Cancel a scoped workflow run, including one waiting for approval.

Source: `lightbulb/client.py:6557`.

##### `lightbulb.client.LightbulbClient.claim_project_coding_handoff`



~~~python
def claim_project_coding_handoff(project_id: str, *, harness: str, handoff_payload_id: str, host_session_ref: str | None=None) -> Dict[str, Any]
~~~


Record routing of an approved handoff to the user's selected harness.

Source: `lightbulb/client.py:2837`.

##### `lightbulb.client.LightbulbClient.claim_sdk_project_checkpoint`



~~~python
def claim_sdk_project_checkpoint(project_id: str, *, worker_ref: str, ready_at: str, lease_seconds: int=60, company_id: str | None=None) -> Dict[str, Any] | None
~~~


Source: `lightbulb/client.py:5723`.

##### `lightbulb.client.LightbulbClient.claude_session_action`



~~~python
def claude_session_action(workspace_id: str, session_id: str, action: str, body: Dict[str, Any] | None=None) -> Dict[str, Any]
~~~


Perform an action on a Claude SDK session.

Source: `lightbulb/client.py:9286`.

##### `lightbulb.client.LightbulbClient.close`



~~~python
def close() -> None
~~~


Close the persistent HTTP session, if one is open.

Source: `lightbulb/client.py:2676`.

##### `lightbulb.client.LightbulbClient.code_workspace_add_collaborator`



~~~python
def code_workspace_add_collaborator(workspace_id: str, *, email: str | None=None, user_id: str | None=None, role: str='viewer') -> Dict[str, Any]
~~~


Add a collaborator to a code workspace (role: viewer | editor | admin).

Source: `lightbulb/client.py:8776`.

##### `lightbulb.client.LightbulbClient.code_workspace_add_note`



~~~python
def code_workspace_add_note(workspace_id: str, content: str) -> Dict[str, Any]
~~~


Append a workspace note (visible to collaborators).

Source: `lightbulb/client.py:8889`.

##### `lightbulb.client.LightbulbClient.code_workspace_approve_access_request`



~~~python
def code_workspace_approve_access_request(workspace_id: str, request_id: str) -> Dict[str, Any]
~~~


Approve a pending workspace access request.

Source: `lightbulb/client.py:8863`.

##### `lightbulb.client.LightbulbClient.code_workspace_chat`



~~~python
def code_workspace_chat(workspace_id: str, message: str, **kwargs) -> Dict[str, Any]
~~~


Send a chat message to a code workspace.

Source: `lightbulb/client.py:5083`.

##### `lightbulb.client.LightbulbClient.code_workspace_clear_policy`



~~~python
def code_workspace_clear_policy(workspace_id: str, request_family: str) -> Dict[str, Any]
~~~


Clear cached policy decisions for a request family.

Source: `lightbulb/client.py:9229`.

##### `lightbulb.client.LightbulbClient.code_workspace_collaboration`



~~~python
def code_workspace_collaboration(workspace_id: str) -> Dict[str, Any]
~~~


Get collaboration info (members, share links, pending requests).

Source: `lightbulb/client.py:8766`.

##### `lightbulb.client.LightbulbClient.code_workspace_create_pull_request`



~~~python
def code_workspace_create_pull_request(workspace_id: str, body: Dict[str, Any] | None=None) -> Dict[str, Any]
~~~


Open a GitHub pull request from the workspace branch.

Source: `lightbulb/client.py:9024`.

##### `lightbulb.client.LightbulbClient.code_workspace_create_share_link`



~~~python
def code_workspace_create_share_link(workspace_id: str, *, role: str='viewer', expires_in_seconds: int | None=None) -> Dict[str, Any]
~~~


Create a share-link token granting access to the workspace.

Source: `lightbulb/client.py:8823`.

##### `lightbulb.client.LightbulbClient.code_workspace_deny_access_request`



~~~python
def code_workspace_deny_access_request(workspace_id: str, request_id: str) -> Dict[str, Any]
~~~


Deny a pending workspace access request.

Source: `lightbulb/client.py:8876`.

##### `lightbulb.client.LightbulbClient.code_workspace_evals`



~~~python
def code_workspace_evals(workspace_id: str) -> Dict[str, Any]
~~~


Get accumulated eval rollups for a workspace's runs.

Source: `lightbulb/client.py:9206`.

##### `lightbulb.client.LightbulbClient.code_workspace_invoke_tool`



~~~python
def code_workspace_invoke_tool(workspace_id: str, tool_key: str, arguments: Dict[str, Any] | None=None) -> Dict[str, Any]
~~~


Invoke a workspace-scoped tool (read/write files, run commands, git ops).

Source: `lightbulb/client.py:9065`.

##### `lightbulb.client.LightbulbClient.code_workspace_link_repository`



~~~python
def code_workspace_link_repository(workspace_id: str, body: Dict[str, Any]) -> Dict[str, Any]
~~~


Link a GitHub repository to the workspace.

Source: `lightbulb/client.py:9037`.

##### `lightbulb.client.LightbulbClient.code_workspace_policy_replay`



~~~python
def code_workspace_policy_replay(workspace_id: str, **filters: Any) -> Dict[str, Any]
~~~


Replay a policy decision over historical runs (debug helper).

Source: `lightbulb/client.py:9216`.

##### `lightbulb.client.LightbulbClient.code_workspace_preview`



~~~python
def code_workspace_preview(workspace_id: str) -> Dict[str, Any]
~~~


Get the current preview state (URL, status, last build).

Source: `lightbulb/client.py:9139`.

##### `lightbulb.client.LightbulbClient.code_workspace_preview_proxy`



~~~python
def code_workspace_preview_proxy(workspace_id: str, path: str='', *, method: str='GET', body: Any=None, headers: Dict[str, str] | None=None) -> httpx.Response
~~~


Proxy an HTTP call through the workspace preview.

Source: `lightbulb/client.py:9160`.

##### `lightbulb.client.LightbulbClient.code_workspace_preview_start`



~~~python
def code_workspace_preview_start(workspace_id: str, body: Dict[str, Any] | None=None) -> Dict[str, Any]
~~~


Start the workspace preview server (renders the in-progress code).

Source: `lightbulb/client.py:9124`.

##### `lightbulb.client.LightbulbClient.code_workspace_preview_stop`



~~~python
def code_workspace_preview_stop(workspace_id: str) -> Dict[str, Any]
~~~


Stop the workspace preview server.

Source: `lightbulb/client.py:9149`.

##### `lightbulb.client.LightbulbClient.code_workspace_promote_policy`



~~~python
def code_workspace_promote_policy(workspace_id: str, body: Dict[str, Any]) -> Dict[str, Any]
~~~


Promote workspace-scoped policy to a higher scope (company/tenant).

Source: `lightbulb/client.py:9242`.

##### `lightbulb.client.LightbulbClient.code_workspace_redeem_share_link`



~~~python
def code_workspace_redeem_share_link(token: str) -> Dict[str, Any]
~~~


Redeem a workspace share-link token to gain access.

Source: `lightbulb/client.py:8852`.

##### `lightbulb.client.LightbulbClient.code_workspace_register_runtime_tools`



~~~python
def code_workspace_register_runtime_tools(workspace_id: str, body: Dict[str, Any]) -> Dict[str, Any]
~~~


Register or update workspace runtime tools.

Source: `lightbulb/client.py:9107`.

##### `lightbulb.client.LightbulbClient.code_workspace_remove_collaborator`



~~~python
def code_workspace_remove_collaborator(workspace_id: str, collaborator_id: str) -> None
~~~


Revoke a collaborator's access.

Source: `lightbulb/client.py:8812`.

##### `lightbulb.client.LightbulbClient.code_workspace_revoke_share_link`



~~~python
def code_workspace_revoke_share_link(workspace_id: str, link_id: str) -> None
~~~


Revoke a share link.

Source: `lightbulb/client.py:8843`.

##### `lightbulb.client.LightbulbClient.code_workspace_run_review`



~~~python
def code_workspace_run_review(workspace_id: str, run_id: str, *, verdict: str, feedback: str='') -> Dict[str, Any]
~~~


Submit a human review verdict (accept | reject | request_changes) for a run.

Source: `lightbulb/client.py:8943`.

##### `lightbulb.client.LightbulbClient.code_workspace_run_review_apply`



~~~python
def code_workspace_run_review_apply(workspace_id: str, run_id: str) -> Dict[str, Any]
~~~


Apply review-suggested changes to the workspace.

Source: `lightbulb/client.py:8961`.

##### `lightbulb.client.LightbulbClient.code_workspace_run_telemetry`



~~~python
def code_workspace_run_telemetry(workspace_id: str, **filters: Any) -> Dict[str, Any]
~~~


Raw telemetry rows for a workspace's runs.

Source: `lightbulb/client.py:8930`.

##### `lightbulb.client.LightbulbClient.code_workspace_runs_insights`



~~~python
def code_workspace_runs_insights(workspace_id: str) -> Dict[str, Any]
~~~


Aggregate run-quality insights for a workspace (cost, latency, success rate).

Source: `lightbulb/client.py:8920`.

##### `lightbulb.client.LightbulbClient.code_workspace_runtime_catalog`



~~~python
def code_workspace_runtime_catalog(workspace_id: str) -> Dict[str, Any]
~~~


Read the workspace's runtime tool catalog (which tool keys are available).

Source: `lightbulb/client.py:9097`.

##### `lightbulb.client.LightbulbClient.code_workspace_update_collaborator`



~~~python
def code_workspace_update_collaborator(workspace_id: str, collaborator_id: str, *, role: str) -> Dict[str, Any]
~~~


Change a collaborator's role.

Source: `lightbulb/client.py:8799`.

##### `lightbulb.client.LightbulbClient.codex_thread_action`



~~~python
def codex_thread_action(workspace_id: str, thread_id: str, action: str, body: Dict[str, Any] | None=None) -> Dict[str, Any]
~~~


Perform a thread-level action (rename | archive | unarchive | compact | rollback).

Source: `lightbulb/client.py:9346`.

##### `lightbulb.client.LightbulbClient.codex_turn_action`



~~~python
def codex_turn_action(workspace_id: str, thread_id: str, turn_id: str, action: str, body: Dict[str, Any] | None=None) -> Dict[str, Any]
~~~


Steer or interrupt a specific Codex turn (action: steer | interrupt).

Source: `lightbulb/client.py:9370`.

##### `lightbulb.client.LightbulbClient.compile_business_workflow`



~~~python
def compile_business_workflow(objective: str, *, primitive_ids: List[str] | None=None, inputs: Dict[str, Any] | None=None, workflow_name: str | None=None, workflow_type: str | None=None, trigger_event: str | None=None, owner_role: str='workflow_owner', loop: bool=False, max_iterations: int | None=None, source: str='sdk') -> Dict[str, Any]
~~~


Compile a portable, governed workflow draft without network calls.

Source: `lightbulb/client.py:5892`.

##### `lightbulb.client.LightbulbClient.compose_business_workflow`



~~~python
def compose_business_workflow(objective: str, *, primitive_ids: List[str] | None=None, inputs: Dict[str, Any] | None=None, loop: bool=False, max_iterations: int | None=None, workflow_name: str | None=None, workflow_type: str | None=None, trigger_event: str | None=None, owner_role: str='workflow_owner', publish: bool=False, source: str='sdk') -> Dict[str, Any]
~~~


Draft an Agent Builder workflow from business primitive blocks.

Source: `lightbulb/client.py:5859`.

##### `lightbulb.client.LightbulbClient.compute_aoc_tick`



~~~python
def compute_aoc_tick(body: Dict[str, Any] | None=None) -> Dict[str, Any]
~~~


Run a one-shot AutoCompany tick computation.

Source: `lightbulb/client.py:9559`.

##### `lightbulb.client.LightbulbClient.configure_backbone_agent_surface`



~~~python
def configure_backbone_agent_surface(backbone_surface: str, *, model_provider: str | None=None, model_id: str | None=None, provider_connection_id: str | None=None, scope: str='USER', company_id: str | None=None, request_overrides: Dict[str, Any] | None=None) -> Dict[str, Any]
~~~


Configure the preferred Backbone host surface, such as ChatGPT MCP.

Source: `lightbulb/client.py:3119`.

##### `lightbulb.client.LightbulbClient.configure_coding_agent_runtime`



~~~python
def configure_coding_agent_runtime(runtime_backend: str, *, model_provider: str | None=None, model_id: str | None=None, provider_connection_id: str | None=None, use_codex_account: bool | None=None, scope: str='USER', company_id: str | None=None, request_overrides: Dict[str, Any] | None=None) -> Dict[str, Any]
~~~


Configure Codex, Claude Code, or another coding harness for this account.

Source: `lightbulb/client.py:3078`.

##### `lightbulb.client.LightbulbClient.context_archive`



~~~python
def context_archive(context_ref: str, *, project_id: str | None=None, company_id: str | None=None) -> Dict[str, Any]
~~~


Archive a private Context Space and close its host bindings.

Source: `lightbulb/client.py:7607`.

##### `lightbulb.client.LightbulbClient.context_checkpoint`



~~~python
def context_checkpoint(context_ref: str, *, binding_ref: str, base_revision: int, idempotency_key: str, events: Sequence[Mapping[str, Any]] | None=None, state: Mapping[str, Any] | None=None, project_id: str | None=None, company_id: str | None=None) -> Dict[str, Any]
~~~


Append host deltas and structured state with optimistic concurrency.

Source: `lightbulb/client.py:7474`.

##### `lightbulb.client.LightbulbClient.context_company_id`



~~~python
@property
def context_company_id() -> str | None
~~~


Company used only by Context Broker calls; defaults to the active company.

Source: `lightbulb/client.py:2695`.

##### `lightbulb.client.LightbulbClient.context_company_id`



~~~python
@context_company_id.setter
def context_company_id(value: str | None) -> None
~~~


Source: `lightbulb/client.py:2704`.

##### `lightbulb.client.LightbulbClient.context_delete`



~~~python
def context_delete(context_ref: str, *, project_id: str | None=None, company_id: str | None=None) -> Dict[str, Any]
~~~


Request scoped physical deletion after the server's grace period.

Source: `lightbulb/client.py:7630`.

##### `lightbulb.client.LightbulbClient.context_export`



~~~python
def context_export(context_ref: str, *, project_id: str | None=None, company_id: str | None=None, event_after_sequence: int=0, checkpoint_after_revision: int=0, limit: int=50, max_bytes: int=1048576) -> Dict[str, Any]
~~~


Export a bounded page from a private Context Space for user custody.

Source: `lightbulb/client.py:7552`.

##### `lightbulb.client.LightbulbClient.context_open`



~~~python
def context_open(host: str, *, host_session_ref: str | None=None, model: str | None=None, context_ref: str | None=None, project_id: str | None=None, company_id: str | None=None, token_budget: int=_CONTEXT_TOKEN_BUDGET_DEFAULT, query: str | None=None, repository: Mapping[str, Any] | None=None) -> Dict[str, Any]
~~~


Open or resume a private cross-host context binding.

Source: `lightbulb/client.py:7289`.

##### `lightbulb.client.LightbulbClient.context_pack`



~~~python
def context_pack(context_ref: str, *, binding_ref: str | None=None, query: str | None=None, project_id: str | None=None, company_id: str | None=None, token_budget: int=_CONTEXT_TOKEN_BUDGET_DEFAULT, max_items: int=12) -> Dict[str, Any]
~~~


Build a bounded, prompt-aware working pack from durable context.

Source: `lightbulb/client.py:7345`.

##### `lightbulb.client.LightbulbClient.context_read`



~~~python
def context_read(context_ref: str, refs: Sequence[str], *, project_id: str | None=None, company_id: str | None=None, token_budget: int=_CONTEXT_TOKEN_BUDGET_DEFAULT) -> Dict[str, Any]
~~~


Read exact opaque context items under a bounded token budget.

Source: `lightbulb/client.py:7434`.

##### `lightbulb.client.LightbulbClient.context_search`



~~~python
def context_search(context_ref: str, query: str, *, project_id: str | None=None, company_id: str | None=None, token_budget: int=_CONTEXT_TOKEN_BUDGET_DEFAULT, max_items: int=10, kinds: Sequence[str] | None=None) -> Dict[str, Any]
~~~


Search a Context Space without placing its full corpus in-model.

Source: `lightbulb/client.py:7384`.

##### `lightbulb.client.LightbulbClient.context_status`



~~~python
def context_status(context_ref: str, *, binding_ref: str | None=None, project_id: str | None=None, company_id: str | None=None) -> Dict[str, Any]
~~~


Inspect one Context Space or one exact host-session binding.

Source: `lightbulb/client.py:7523`.

##### `lightbulb.client.LightbulbClient.create_account_shell_customization_draft`



~~~python
def create_account_shell_customization_draft(document: Mapping[str, Any], *, base_revision_id: str | None) -> Dict[str, Any]
~~~


Create an immutable draft from one exact base revision.

Source: `lightbulb/client.py:7726`.

##### `lightbulb.client.LightbulbClient.create_aoc_run`



~~~python
def create_aoc_run(body: Dict[str, Any]) -> Dict[str, Any]
~~~


Create a new AutoCompany run.

Source: `lightbulb/client.py:9412`.

##### `lightbulb.client.LightbulbClient.create_aoc_task`



~~~python
def create_aoc_task(body: Dict[str, Any]) -> Dict[str, Any]
~~~


Create an AutoCompany task.

Source: `lightbulb/client.py:9465`.

##### `lightbulb.client.LightbulbClient.create_approval_auto_accept`



~~~python
def create_approval_auto_accept(task_id: str, body: Dict[str, Any] | None=None) -> Dict[str, Any]
~~~


Create an auto-accept rule keyed off the shape of an existing approval task.

Source: `lightbulb/client.py:9920`.

##### `lightbulb.client.LightbulbClient.create_code_workspace`



~~~python
def create_code_workspace(*, source: str | None=None, repo_connection_id: str | None=None, branch: str | None=None, depth: int | None=None, label: str | None=None, metadata: Dict[str, Any] | None=None, company_id: str | None=None) -> Dict[str, Any]
~~~


Create a code workspace.

Source: `lightbulb/client.py:5037`.

##### `lightbulb.client.LightbulbClient.create_conversation`



~~~python
def create_conversation(domain: str) -> Dict[str, Any]
~~~


Create a new conversation for a domain.

Source: `lightbulb/client.py:4790`.

##### `lightbulb.client.LightbulbClient.create_crm_task`



~~~python
def create_crm_task(body: Dict[str, Any], tenant_id: str | None=None) -> Dict[str, Any]
~~~


Create a CRM task.

Source: `lightbulb/client.py:9869`.

##### `lightbulb.client.LightbulbClient.create_document`



~~~python
def create_document(title: str, body: str, *, format: str='docx', target_suite: str='internal_library') -> DispatchResult
~~~


Create a new document.

Source: `lightbulb/client.py:4909`.

##### `lightbulb.client.LightbulbClient.create_document_session`



~~~python
def create_document_session(*, document_type: str='general', document_title: str='Untitled Document') -> Dict[str, Any]
~~~


Create a new document builder session.

Source: `lightbulb/client.py:4809`.

##### `lightbulb.client.LightbulbClient.create_page_builder_session`



~~~python
def create_page_builder_session(brand_name: str='', initial_prompt: str='') -> Dict[str, Any]
~~~


Create a new page builder session.

Source: `lightbulb/client.py:4962`.

##### `lightbulb.client.LightbulbClient.create_project_from_preflight`



~~~python
def create_project_from_preflight(receipt: ProjectCreationPreflightReceipt, *, coding_harness: str, confirm_create: bool=False, confirm_open_questions: bool=False, workspace_id: str | None=None, repo_connection_id: str | None=None, idempotency_key: str | None=None, play_style: str | None=None) -> Dict[str, Any]
~~~


Create exactly the draft bound to a validated preflight receipt.

Source: `lightbulb/client.py:4516`.

##### `lightbulb.client.LightbulbClient.create_server_workflow_improvement_packet`



~~~python
def create_server_workflow_improvement_packet(packet: Dict[str, Any], *, source_run_id: str | None=None) -> Dict[str, Any]
~~~


Source: `lightbulb/client.py:6147`.

##### `lightbulb.client.LightbulbClient.create_slide_deck`



~~~python
def create_slide_deck(title: str, body: str='', *, target_suite: str='internal_library') -> DispatchResult
~~~


Create a new slide deck.

Source: `lightbulb/client.py:4945`.

##### `lightbulb.client.LightbulbClient.create_spreadsheet`



~~~python
def create_spreadsheet(title: str, body: str='', *, target_suite: str='internal_library') -> DispatchResult
~~~


Create a new spreadsheet.

Source: `lightbulb/client.py:4930`.

##### `lightbulb.client.LightbulbClient.decide_project_learning_result_admission`



~~~python
def decide_project_learning_result_admission(project_id: str, evaluation_receipt_id: str, *, decision: Any, rationale: Any, confirm_admission: bool=False, idempotency_key: str | None=None) -> Dict[str, Any]
~~~


Human admit/reject; never apply or promote the candidate.

Source: `lightbulb/client.py:4137`.

##### `lightbulb.client.LightbulbClient.decide_workflow_improvement_packet`



~~~python
def decide_workflow_improvement_packet(packet_id: str, *, approval_scope: str, decision: str, rationale: str='', evidence: Dict[str, Any] | None=None) -> Dict[str, Any]
~~~


Source: `lightbulb/client.py:6214`.

##### `lightbulb.client.LightbulbClient.delete_approval_preference`



~~~python
def delete_approval_preference(preference_id: str) -> Dict[str, Any]
~~~


Remove an auto-accept rule.

Source: `lightbulb/client.py:9933`.

##### `lightbulb.client.LightbulbClient.delete_conversation`



~~~python
def delete_conversation(domain: str, conversation_id: str) -> None
~~~


Delete a conversation.

Source: `lightbulb/client.py:4799`.

##### `lightbulb.client.LightbulbClient.delete_crm_task`



~~~python
def delete_crm_task(task_id: str, tenant_id: str | None=None) -> None
~~~


Delete a CRM task.

Source: `lightbulb/client.py:9897`.

##### `lightbulb.client.LightbulbClient.delete_workflow`



~~~python
def delete_workflow(workflow_id: str, *, company_id: str | None=None) -> None
~~~


Soft-delete a workflow through the authenticated designer API.

Source: `lightbulb/client.py:6541`.

##### `lightbulb.client.LightbulbClient.dispatch`



~~~python
def dispatch(domain: str, *, action: str='chat', message: str='', objective: str='', inputs: Dict[str, Any] | None=None, conversation_id: str | None=None, company_id: str | None=None) -> DispatchResult
~~~


Dispatch a one-shot action to a domain agent and wait for the result.

Source: `lightbulb/client.py:3512`.

##### `lightbulb.client.LightbulbClient.document_builder_add_collaborator`



~~~python
def document_builder_add_collaborator(session_id: str, *, email: str | None=None, user_id: str | None=None, role: str='viewer') -> Dict[str, Any]
~~~


Add a collaborator to a document builder session.

Source: `lightbulb/client.py:10169`.

##### `lightbulb.client.LightbulbClient.document_builder_add_note`



~~~python
def document_builder_add_note(session_id: str, content: str) -> Dict[str, Any]
~~~


Add a note to a document builder session.

Source: `lightbulb/client.py:10342`.

##### `lightbulb.client.LightbulbClient.document_builder_collaboration`



~~~python
def document_builder_collaboration(session_id: str) -> Dict[str, Any]
~~~


Collaboration info for a document builder session.

Source: `lightbulb/client.py:10159`.

##### `lightbulb.client.LightbulbClient.document_builder_create_share_link`



~~~python
def document_builder_create_share_link(session_id: str, *, role: str='viewer', expires_in_seconds: int | None=None) -> Dict[str, Any]
~~~


Create a share-link token for a document builder session.

Source: `lightbulb/client.py:10192`.

##### `lightbulb.client.LightbulbClient.document_builder_get_messages`



~~~python
def document_builder_get_messages(session_id: str, **filters: Any) -> List[Dict[str, Any]]
~~~


Get the message history for a document builder session.

Source: `lightbulb/client.py:10225`.

##### `lightbulb.client.LightbulbClient.document_builder_redeem_share_link`



~~~python
def document_builder_redeem_share_link(session_id: str, token: str) -> Dict[str, Any]
~~~


Redeem a document builder share link.

Source: `lightbulb/client.py:10212`.

##### `lightbulb.client.LightbulbClient.document_builder_save`



~~~python
def document_builder_save(session_id: str, body: Dict[str, Any] | None=None) -> Dict[str, Any]
~~~


Save a document builder session's current state.

Source: `lightbulb/client.py:10243`.

##### `lightbulb.client.LightbulbClient.drain_runtime_outcomes`



~~~python
def drain_runtime_outcomes() -> List[Dict[str, Any]]
~~~


Atomically consume outcomes in improvement-loop wire format.

Source: `lightbulb/client.py:5975`.

##### `lightbulb.client.LightbulbClient.dynamic_workflow_attach`



~~~python
def dynamic_workflow_attach(*, company_ref: str, project_ref: str, run_ref: str, host: str, host_session_ref: str, host_role: str, expected_revision: int, idempotency_key: str) -> Dict[str, Any]
~~~


Attach fresh role custody to an existing authoritative run.

Source: `lightbulb/client.py:5382`.

##### `lightbulb.client.LightbulbClient.dynamic_workflow_cancel`



~~~python
def dynamic_workflow_cancel(*, company_ref: str, project_ref: str, run_ref: str, host_binding_ref: str, session_receipt: str, host_role: str, expected_revision: int, idempotency_key: str, reason: str) -> Dict[str, Any]
~~~


Cancel a non-terminal workflow using exact optimistic concurrency.

Source: `lightbulb/client.py:5582`.

##### `lightbulb.client.LightbulbClient.dynamic_workflow_next_assignment`



~~~python
def dynamic_workflow_next_assignment(*, company_ref: str, project_ref: str, run_ref: str, host_binding_ref: str, session_receipt: str, host_role: str, expected_revision: int, idempotency_key: str) -> Dict[str, Any]
~~~


Lease the next assignment from the dedicated workflow authority.

Source: `lightbulb/client.py:5432`.

##### `lightbulb.client.LightbulbClient.dynamic_workflow_start`



~~~python
def dynamic_workflow_start(*, company_ref: str, project_ref: str, objective: str, acceptance_criteria: Sequence[Mapping[str, Any]], host: str, expected_revision: int, idempotency_key: str, host_session_ref: str | None=None, acceptance_policy: str='distinct_binding', workflow_spec: Mapping[str, Any] | None=None, inputs: Mapping[str, Any] | None=None) -> Dict[str, Any]
~~~


Start an authoritative planner/builder/evaluator workflow.

Source: `lightbulb/client.py:5348`.

##### `lightbulb.client.LightbulbClient.dynamic_workflow_status`



~~~python
def dynamic_workflow_status(*, company_ref: str, project_ref: str, run_ref: str, host_binding_ref: str, session_receipt: str, host_role: str) -> Dict[str, Any]
~~~


Read bounded status using a role-bound continuation receipt.

Source: `lightbulb/client.py:5409`.

##### `lightbulb.client.LightbulbClient.dynamic_workflow_submit_builder_result`



~~~python
def dynamic_workflow_submit_builder_result(*, company_ref: str, project_ref: str, run_ref: str, host_binding_ref: str, session_receipt: str, host_role: str, assignment_ref: str, assignment_receipt: str, expected_revision: int, idempotency_key: str, outcome: str, summary: str, plan_digest: str, iteration: int, evidence_refs: Sequence[Mapping[str, Any]], progress_digest: str) -> Dict[str, Any]
~~~


Submit content-addressed builder evidence under its assignment lease.

Source: `lightbulb/client.py:5494`.

##### `lightbulb.client.LightbulbClient.dynamic_workflow_submit_evaluator_verdict`



~~~python
def dynamic_workflow_submit_evaluator_verdict(*, company_ref: str, project_ref: str, run_ref: str, host_binding_ref: str, session_receipt: str, host_role: str, assignment_ref: str, assignment_receipt: str, expected_revision: int, idempotency_key: str, decision: str, accepted: bool, summary: str, plan_digest: str, builder_result_digest: str, required_criterion_ids: Sequence[str], criterion_results: Sequence[Mapping[str, Any]]) -> Dict[str, Any]
~~~


Submit a default-fail evaluator verdict under fresh role custody.

Source: `lightbulb/client.py:5537`.

##### `lightbulb.client.LightbulbClient.dynamic_workflow_submit_plan`



~~~python
def dynamic_workflow_submit_plan(*, company_ref: str, project_ref: str, run_ref: str, host_binding_ref: str, session_receipt: str, host_role: str, assignment_ref: str, assignment_receipt: str, expected_revision: int, idempotency_key: str, required_criterion_ids: Sequence[str], plan: Mapping[str, Any]) -> Dict[str, Any]
~~~


Submit a planner result under its exact assignment lease.

Source: `lightbulb/client.py:5459`.

##### `lightbulb.client.LightbulbClient.evaluate_project_offline_policy`



~~~python
def evaluate_project_offline_policy(project_id: str, *, behavior_policy_id: Any, candidate_policy_id: Any, metric_id: Any, pairs: Sequence[Mapping[str, Any]], confirm_evaluate: bool=False, evaluation_id: Any=None, note: Any=None, idempotency_key: str | None=None) -> Dict[str, Any]
~~~


Estimate a candidate from verified receipts; never admit learning.

Source: `lightbulb/client.py:4414`.

##### `lightbulb.client.LightbulbClient.flush_runtime_outcomes`



~~~python
def flush_runtime_outcomes(*, idempotency_key: str | None=None) -> Dict[str, Any]
~~~


Upload queued outcomes, restoring them locally when upload fails.

Source: `lightbulb/client.py:6001`.

##### `lightbulb.client.LightbulbClient.from_verified_envelope`



~~~python
def from_verified_envelope(base_url: str, envelope: Any, *, enforce_https: bool=True, connect_timeout: float=_CONNECT_TIMEOUT, read_timeout: float=_READ_TIMEOUT, outcome_recorder: Any=None) -> 'LightbulbClient'
~~~


Build a worker-only client without a JWT or shared API credential.

Source: `lightbulb/client.py:2609`.

##### `lightbulb.client.LightbulbClient.get_account_shell_customization`



~~~python
def get_account_shell_customization() -> Dict[str, Any]
~~~


Read the effective governed account-shell customization.

Source: `lightbulb/client.py:7716`.

##### `lightbulb.client.LightbulbClient.get_agent_runtime_config`



~~~python
def get_agent_runtime_config(agent_type: str='coding', *, company_id: str | None=None) -> Dict[str, Any]
~~~


Get the effective Codex/Claude Code/Backbone runtime config for this account.

Source: `lightbulb/client.py:3055`.

##### `lightbulb.client.LightbulbClient.get_aoc_decision`



~~~python
def get_aoc_decision(decision_id: str) -> Dict[str, Any]
~~~


Get a specific AutoCompany decision.

Source: `lightbulb/client.py:9525`.

##### `lightbulb.client.LightbulbClient.get_aoc_run`



~~~python
def get_aoc_run(run_id: str) -> Dict[str, Any]
~~~


Get an AutoCompany run detail.

Source: `lightbulb/client.py:9421`.

##### `lightbulb.client.LightbulbClient.get_aoc_task`



~~~python
def get_aoc_task(task_id: str) -> Dict[str, Any]
~~~


Get an AutoCompany task detail.

Source: `lightbulb/client.py:9474`.

##### `lightbulb.client.LightbulbClient.get_aoc_tick`



~~~python
def get_aoc_tick(tick_id: str) -> Dict[str, Any]
~~~


Get a single AutoCompany tick.

Source: `lightbulb/client.py:9549`.

##### `lightbulb.client.LightbulbClient.get_approval`



~~~python
def get_approval(task_id: str) -> Dict[str, Any]
~~~


Get full details of an approval task.

Source: `lightbulb/client.py:6951`.

##### `lightbulb.client.LightbulbClient.get_artifact`



~~~python
def get_artifact(artifact_id: str) -> Dict[str, Any]
~~~


Get a specific artifact by ID.

Source: `lightbulb/client.py:6408`.

##### `lightbulb.client.LightbulbClient.get_code_workspace_active_run`



~~~python
def get_code_workspace_active_run(workspace_id: str) -> Dict[str, Any] | None
~~~


Get the currently active run for a code workspace, if one exists.

Source: `lightbulb/client.py:5101`.

##### `lightbulb.client.LightbulbClient.get_code_workspace_claude_session`



~~~python
def get_code_workspace_claude_session(workspace_id: str, session_id: str) -> Dict[str, Any]
~~~


Get a single Claude SDK session.

Source: `lightbulb/client.py:9274`.

##### `lightbulb.client.LightbulbClient.get_code_workspace_codex_thread`



~~~python
def get_code_workspace_codex_thread(workspace_id: str, thread_id: str) -> Dict[str, Any]
~~~


Get a Codex thread (turns, status, metadata).

Source: `lightbulb/client.py:9334`.

##### `lightbulb.client.LightbulbClient.get_code_workspace_run`



~~~python
def get_code_workspace_run(workspace_id: str, run_id: str) -> Dict[str, Any]
~~~


Get a specific code workspace run.

Source: `lightbulb/client.py:5113`.

##### `lightbulb.client.LightbulbClient.get_codex_account_link_status`



~~~python
def get_codex_account_link_status(session_id: str) -> Dict[str, Any]
~~~


Poll a Codex device-auth session.

Source: `lightbulb/client.py:3203`.

##### `lightbulb.client.LightbulbClient.get_conversation`



~~~python
def get_conversation(domain: str, conversation_id: str) -> Dict[str, Any]
~~~


Get conversation history.

Source: `lightbulb/client.py:4781`.

##### `lightbulb.client.LightbulbClient.get_crm_task`



~~~python
def get_crm_task(task_id: str, tenant_id: str | None=None) -> Dict[str, Any]
~~~


Get a single CRM task.

Source: `lightbulb/client.py:9856`.

##### `lightbulb.client.LightbulbClient.get_document_schemas`



~~~python
def get_document_schemas(session_id: str) -> Dict[str, Any]
~~~


Get the document schemas for a session.

Source: `lightbulb/client.py:4839`.

##### `lightbulb.client.LightbulbClient.get_document_session`



~~~python
def get_document_session(session_id: str) -> Dict[str, Any]
~~~


Get a document builder session.

Source: `lightbulb/client.py:4831`.

##### `lightbulb.client.LightbulbClient.get_finance_reconciliation_run`



~~~python
def get_finance_reconciliation_run(run_id: str, *, company_id: str | None=None) -> FinanceReconciliationRunDetails
~~~


Get one exact reconciliation run and validate its stored envelope.

Source: `lightbulb/client.py:3490`.

##### `lightbulb.client.LightbulbClient.get_marketplace_action_publication`



~~~python
def get_marketplace_action_publication(publication_id: str) -> Dict[str, Any]
~~~


Get governed publication and security-scan status by publication UUID.

Source: `lightbulb/client.py:8131`.

##### `lightbulb.client.LightbulbClient.get_marketplace_installation`



~~~python
def get_marketplace_installation(installation_id: str) -> Dict[str, Any]
~~~


Get one marketplace installation for the selected active company.

Source: `lightbulb/client.py:8222`.

##### `lightbulb.client.LightbulbClient.get_marketplace_invocation_receipt`



~~~python
def get_marketplace_invocation_receipt(invocation_id: str) -> Dict[str, Any]
~~~


Get the immutable audit receipt for one marketplace invocation.

Source: `lightbulb/client.py:8399`.

##### `lightbulb.client.LightbulbClient.get_marketplace_invocation_status`



~~~python
def get_marketplace_invocation_status(invocation_id: str) -> Dict[str, Any]
~~~


Get current invocation state for the selected company.

Source: `lightbulb/client.py:8387`.

##### `lightbulb.client.LightbulbClient.get_marketplace_listing`



~~~python
def get_marketplace_listing(listing_id: str, *, revision_id: str | None=None, include_inputs: bool=True) -> Dict[str, Any]
~~~


Get one persisted marketplace listing and optional immutable revision.

Source: `lightbulb/client.py:8037`.

##### `lightbulb.client.LightbulbClient.get_project_coding_handoff`



~~~python
def get_project_coding_handoff(project_id: str, harness: str) -> Dict[str, Any]
~~~


Read the selected Project Agent handoff for a connected harness.

Source: `lightbulb/client.py:2818`.

##### `lightbulb.client.LightbulbClient.get_project_coding_harnesses`



~~~python
def get_project_coding_harnesses(project_id: str) -> Dict[str, Any]
~~~


Read the durable additive harness selection for one project.

Source: `lightbulb/client.py:2780`.

##### `lightbulb.client.LightbulbClient.get_project_connector_route_descriptor`



~~~python
def get_project_connector_route_descriptor(project_id: str, connector_account_ref: str, tool_name: str, *, company_id: str | None=None) -> Dict[str, Any]
~~~


Resolve exact governed execution coordinates for one project account Tool.

Source: `lightbulb/client.py:3001`.

##### `lightbulb.client.LightbulbClient.get_project_game_snapshot`



~~~python
def get_project_game_snapshot(project_id: str) -> Dict[str, Any]
~~~


Fetch one server-owned, exact-scoped project snapshot.

Source: `lightbulb/client.py:3714`.

##### `lightbulb.client.LightbulbClient.get_recursive_agent_execution_status`



~~~python
def get_recursive_agent_execution_status(execution_id: str) -> Dict[str, Any]
~~~


Read privacy-minimized status for one exact user-owned recursive tree.

Source: `lightbulb/client.py:6610`.

##### `lightbulb.client.LightbulbClient.get_runtime_domain_action`



~~~python
def get_runtime_domain_action(runtime_action_id: str, *, project_id: str, company_id: str | None=None) -> Dict[str, Any]
~~~


Review one exact-scope registration without changing its lifecycle.

Source: `lightbulb/client.py:7905`.

##### `lightbulb.client.LightbulbClient.get_sdk_project_checkpoint`



~~~python
def get_sdk_project_checkpoint(project_id: str, run_ref: str, *, company_id: str | None=None) -> Dict[str, Any] | None
~~~


Source: `lightbulb/client.py:5690`.

##### `lightbulb.client.LightbulbClient.get_server_workflow_improvement_packet`



~~~python
def get_server_workflow_improvement_packet(packet_id: str) -> Dict[str, Any]
~~~


Read one exact tenant/company-scoped workflow improvement packet.

Source: `lightbulb/client.py:6204`.

##### `lightbulb.client.LightbulbClient.get_server_workflow_improvement_status`



~~~python
def get_server_workflow_improvement_status() -> Dict[str, Any]
~~~


Source: `lightbulb/client.py:6178`.

##### `lightbulb.client.LightbulbClient.get_training_pair_status`



~~~python
def get_training_pair_status(pair_handle: str, *, project_id: str | None=None) -> Dict[str, Any]
~~~


Read the privacy-minimized status for one exact owned pair handle.

Source: `lightbulb/client.py:8547`.

##### `lightbulb.client.LightbulbClient.get_voice_execution`



~~~python
def get_voice_execution(execution_id: str) -> Dict[str, Any]
~~~


Get a voice execution detail (transcripts, status, agent decisions).

Source: `lightbulb/client.py:8592`.

##### `lightbulb.client.LightbulbClient.get_workflow`



~~~python
def get_workflow(workflow_id: str) -> Dict[str, Any]
~~~


Get a workflow by ID.

Source: `lightbulb/client.py:6475`.

##### `lightbulb.client.LightbulbClient.get_workflow_improvement_audit`



~~~python
def get_workflow_improvement_audit(packet_id: str) -> List[Dict[str, Any]]
~~~


Source: `lightbulb/client.py:6239`.

##### `lightbulb.client.LightbulbClient.get_workflow_improvement_delivery`



~~~python
def get_workflow_improvement_delivery(delivery_id: str) -> Dict[str, Any]
~~~


Source: `lightbulb/client.py:6294`.

##### `lightbulb.client.LightbulbClient.get_workflow_improvement_status`



~~~python
def get_workflow_improvement_status(output_dir: str | os.PathLike[str] | None=None) -> Dict[str, Any]
~~~


Read local continuous-improvement state without network calls.

Source: `lightbulb/client.py:6033`.

##### `lightbulb.client.LightbulbClient.get_workflow_instance`



~~~python
def get_workflow_instance(trace_id: str, *, company_id: str | None=None) -> Dict[str, Any]
~~~


Get a workflow instance through the authenticated public API.

Source: `lightbulb/client.py:3564`.

##### `lightbulb.client.LightbulbClient.get_workflow_trigger_catalog`



~~~python
def get_workflow_trigger_catalog() -> Dict[str, Any]
~~~


List the schedule literals and event types accepted by authoring.

Source: `lightbulb/client.py:6759`.

##### `lightbulb.client.LightbulbClient.grep_documents`



~~~python
def grep_documents(pattern: str, *, regex: bool=True, case_sensitive: bool=False, folder_path: str | None=None, top_k: int=20) -> DispatchResult
~~~


Grep across document content using pattern matching.

Source: `lightbulb/client.py:4867`.

##### `lightbulb.client.LightbulbClient.hr_live_advance_application`



~~~python
def hr_live_advance_application(application_id: str, *, body: Dict[str, Any] | None=None) -> Dict[str, Any]
~~~


Advance a Greenhouse candidate to the next stage (HITL-gated).

Source: `lightbulb/client.py:8729`.

##### `lightbulb.client.LightbulbClient.hr_live_cases`



~~~python
def hr_live_cases(**filters: Any) -> Dict[str, Any]
~~~


HR case board items from Monday.com.

Source: `lightbulb/client.py:8696`.

##### `lightbulb.client.LightbulbClient.hr_live_health`



~~~python
def hr_live_health() -> Dict[str, Any]
~~~


Health check for HR connector tokens (BambooHR / Greenhouse / Monday).

Source: `lightbulb/client.py:8755`.

##### `lightbulb.client.LightbulbClient.hr_live_leave_balance`



~~~python
def hr_live_leave_balance(bamboo_employee_id: str) -> Dict[str, Any]
~~~


BambooHR leave balance for an employee.

Source: `lightbulb/client.py:8676`.

##### `lightbulb.client.LightbulbClient.hr_live_monday_onboarding_board`



~~~python
def hr_live_monday_onboarding_board(checklist_id: str) -> Dict[str, Any]
~~~


Monday.com board view for an HR onboarding checklist.

Source: `lightbulb/client.py:8686`.

##### `lightbulb.client.LightbulbClient.hr_live_recruiting_applications`



~~~python
def hr_live_recruiting_applications(**filters: Any) -> Dict[str, Any]
~~~


Greenhouse applications.

Source: `lightbulb/client.py:8718`.

##### `lightbulb.client.LightbulbClient.hr_live_recruiting_jobs`



~~~python
def hr_live_recruiting_jobs(**filters: Any) -> Dict[str, Any]
~~~


Greenhouse job listings.

Source: `lightbulb/client.py:8707`.

##### `lightbulb.client.LightbulbClient.hr_live_reject_application`



~~~python
def hr_live_reject_application(application_id: str, *, body: Dict[str, Any] | None=None) -> Dict[str, Any]
~~~


Reject a Greenhouse application (HITL-gated).

Source: `lightbulb/client.py:8742`.

##### `lightbulb.client.LightbulbClient.hr_live_whos_out`



~~~python
def hr_live_whos_out(**filters: Any) -> Dict[str, Any]
~~~


BambooHR who's-out roster (current and upcoming time-off).

Source: `lightbulb/client.py:8665`.

##### `lightbulb.client.LightbulbClient.ingest_sdk_project_event`



~~~python
def ingest_sdk_project_event(project_id: str, event: Dict[str, Any], *, company_id: str | None=None) -> Dict[str, Any]
~~~


Source: `lightbulb/client.py:5768`.

##### `lightbulb.client.LightbulbClient.inspect_project_creation_world_ready`



~~~python
def inspect_project_creation_world_ready(name: str, instructions: str='', *, participant_role: str='agent_worker', experience_lens: str='agent_protocol', play_style: str='guided_human_in_the_loop') -> dict[str, Any]
~~~


Inspect project-review readiness locally without network activity.

Source: `lightbulb/client.py:4454`.

##### `lightbulb.client.LightbulbClient.inspect_project_game_campaign`



~~~python
def inspect_project_game_campaign(*, project: dict[str, Any] | None=None, plan: dict[str, Any] | None=None, business_cockpit: dict[str, Any] | None=None) -> dict[str, Any]
~~~


Inspect the human/agent project campaign locally without network activity.

Source: `lightbulb/client.py:3761`.

##### `lightbulb.client.LightbulbClient.inspect_training_pair_input_custody`



~~~python
def inspect_training_pair_input_custody(installation_id: str, revision_id: str, *, project_id: str | None=None) -> Dict[str, Any]
~~~


Inspect exact-owner input custody without returning raw evidence.

Source: `lightbulb/client.py:8445`.

##### `lightbulb.client.LightbulbClient.inspect_training_pair_readiness`



~~~python
def inspect_training_pair_readiness(installation_id: str, revision_id: str, *, project_id: str | None=None) -> Dict[str, Any]
~~~


Inspect structured source, authority, stage, and lane readiness.

Source: `lightbulb/client.py:8413`.

##### `lightbulb.client.LightbulbClient.inspect_workflow_learning_candidate_attestation`



~~~python
def inspect_workflow_learning_candidate_attestation(delivery_id: str) -> Dict[str, Any]
~~~


Revalidate the exact candidate producer attestation using current keys.

Source: `lightbulb/client.py:6303`.

##### `lightbulb.client.LightbulbClient.install_marketplace_action`



~~~python
def install_marketplace_action(listing_id: str, revision_id: str, *, idempotency_key: str, deployment_targets: Sequence[str] | None=None) -> Dict[str, Any]
~~~


Install a pinned revision and bind its explicit agent targets.

Source: `lightbulb/client.py:8234`.

##### `lightbulb.client.LightbulbClient.invoke_marketplace_action`



~~~python
def invoke_marketplace_action(installation_id: str, inputs: Dict[str, Any] | None=None, *, idempotency_key: str, message: str='', objective: str='', dry_run: bool=True, preview_invocation_id: str | None=None, confirm_live: bool=False) -> Dict[str, Any]
~~~


Preview an installed action, or explicitly confirm an exact preview for live use.

Source: `lightbulb/client.py:8340`.

##### `lightbulb.client.LightbulbClient.invoke_tool`



~~~python
def invoke_tool(tool_name: str, arguments: Dict[str, Any], *, project_id: str | None=None, project_ref: str | None=None, connector_account_ref: str | None=None, idempotency_key: str | None=None, approval_ref: str | None=None, workflow_id: str | None=None, step_id: str | None=None, workflow_instance_id: str | None=None, workflow_step_generation: int | None=None, runtime_context: Dict[str, Any] | None=None, effect: str | None=None, _runtime_authority: Any=None) -> Dict[str, Any]
~~~


Invoke a platform tool by name (e.g. connector tools, utility tools).

Source: `lightbulb/client.py:7045`.

##### `lightbulb.client.LightbulbClient.it_ops_live_connector`



~~~python
def it_ops_live_connector(connector: str, **filters: Any) -> Dict[str, Any]
~~~


Pass-through to a live IT-Ops connector (jira | slack | github | notion).

Source: `lightbulb/client.py:10032`.

##### `lightbulb.client.LightbulbClient.it_ops_mcp_manifest`



~~~python
def it_ops_mcp_manifest() -> Dict[str, Any]
~~~


Get the IT-Ops workspace MCP manifest.

Source: `lightbulb/client.py:10046`.

##### `lightbulb.client.LightbulbClient.list_agent_runtime_options`



~~~python
def list_agent_runtime_options(agent_type: str | None=None) -> Dict[str, Any]
~~~


List coding-agent runtimes and Backbone host surfaces available to the account.

Source: `lightbulb/client.py:3039`.

##### `lightbulb.client.LightbulbClient.list_aoc_decisions`



~~~python
def list_aoc_decisions(**filters: Any) -> List[Dict[str, Any]]
~~~


List AutoCompany decisions awaiting or post-resolution.

Source: `lightbulb/client.py:9509`.

##### `lightbulb.client.LightbulbClient.list_aoc_runs`



~~~python
def list_aoc_runs(**filters: Any) -> List[Dict[str, Any]]
~~~


List AutoCompany cognitive-loop runs.

Source: `lightbulb/client.py:9398`.

##### `lightbulb.client.LightbulbClient.list_aoc_task_events`



~~~python
def list_aoc_task_events(task_id: str) -> List[Dict[str, Any]]
~~~


List events recorded against an AutoCompany task.

Source: `lightbulb/client.py:9483`.

##### `lightbulb.client.LightbulbClient.list_aoc_tasks`



~~~python
def list_aoc_tasks(**filters: Any) -> List[Dict[str, Any]]
~~~


List AutoCompany tasks.

Source: `lightbulb/client.py:9451`.

##### `lightbulb.client.LightbulbClient.list_aoc_ticks`



~~~python
def list_aoc_ticks(**filters: Any) -> List[Dict[str, Any]]
~~~


List AutoCompany cognitive-loop ticks.

Source: `lightbulb/client.py:9535`.

##### `lightbulb.client.LightbulbClient.list_approval_preferences`



~~~python
def list_approval_preferences() -> List[Dict[str, Any]]
~~~


List the user's HITL auto-accept rules.

Source: `lightbulb/client.py:9909`.

##### `lightbulb.client.LightbulbClient.list_artifacts`



~~~python
def list_artifacts(**filters) -> List[Dict[str, Any]]
~~~


List artifacts (charts, reports, analyses, etc.).

Source: `lightbulb/client.py:6392`.

##### `lightbulb.client.LightbulbClient.list_available_project_connector_accounts`



~~~python
def list_available_project_connector_accounts(project_id: str, provider: str, *, company_id: str | None=None) -> List[Dict[str, Any]]
~~~


List provider accounts eligible for binding to one accessible project.

Source: `lightbulb/client.py:2965`.

##### `lightbulb.client.LightbulbClient.list_business_primitives`



~~~python
def list_business_primitives(*, category: str | None=None, query: str | None=None, include_inputs: bool=True) -> List[Dict[str, Any]]
~~~


List user-facing business primitives exposed by the SDK/MCP layer.

Source: `lightbulb/client.py:5815`.

##### `lightbulb.client.LightbulbClient.list_code_workspace_claude_sessions`



~~~python
def list_code_workspace_claude_sessions(workspace_id: str) -> List[Dict[str, Any]]
~~~


List Claude SDK sessions associated with a workspace.

Source: `lightbulb/client.py:9257`.

##### `lightbulb.client.LightbulbClient.list_code_workspace_codex_threads`



~~~python
def list_code_workspace_codex_threads(workspace_id: str, **filters: Any) -> List[Dict[str, Any]]
~~~


List Codex runtime threads attached to a workspace.

Source: `lightbulb/client.py:9316`.

##### `lightbulb.client.LightbulbClient.list_code_workspace_proposals`



~~~python
def list_code_workspace_proposals(workspace_id: str) -> List[Dict[str, Any]]
~~~


List code-change proposals submitted to the workspace.

Source: `lightbulb/client.py:8974`.

##### `lightbulb.client.LightbulbClient.list_code_workspace_runs`



~~~python
def list_code_workspace_runs(workspace_id: str, **filters: Any) -> List[Dict[str, Any]]
~~~


List historical coding runs for a workspace.

Source: `lightbulb/client.py:8904`.

##### `lightbulb.client.LightbulbClient.list_code_workspaces`



~~~python
def list_code_workspaces() -> List[Dict[str, Any]]
~~~


List code workspaces.

Source: `lightbulb/client.py:5074`.

##### `lightbulb.client.LightbulbClient.list_companies`



~~~python
def list_companies() -> List[Dict[str, Any]]
~~~


List companies the user has access to within their tenant.

Source: `lightbulb/client.py:2734`.

##### `lightbulb.client.LightbulbClient.list_connected_integrations`



~~~python
def list_connected_integrations(company_id: str | None=None) -> List[Dict[str, Any]]
~~~


List connected integrations (OAuth connections) for the current company scope.

Source: `lightbulb/client.py:2716`.

##### `lightbulb.client.LightbulbClient.list_connectors`



~~~python
def list_connectors() -> List[Dict[str, Any]]
~~~


List available connectors and their status.

Source: `lightbulb/client.py:7015`.

##### `lightbulb.client.LightbulbClient.list_contacts`



~~~python
def list_contacts(**filters) -> List[Dict[str, Any]]
~~~


List CRM contacts.

Source: `lightbulb/client.py:7243`.

##### `lightbulb.client.LightbulbClient.list_conversations`



~~~python
def list_conversations(domain: str) -> List[Dict[str, Any]]
~~~


List all conversations for a domain.

Source: `lightbulb/client.py:4772`.

##### `lightbulb.client.LightbulbClient.list_crm_tasks`



~~~python
def list_crm_tasks(tenant_id: str | None=None, **filters: Any) -> List[Dict[str, Any]]
~~~


List CRM tasks scoped to a tenant (defaults to authed tenant).

Source: `lightbulb/client.py:9839`.

##### `lightbulb.client.LightbulbClient.list_deals`



~~~python
def list_deals(**filters) -> List[Dict[str, Any]]
~~~


List CRM deals/opportunities.

Source: `lightbulb/client.py:7255`.

##### `lightbulb.client.LightbulbClient.list_document_sessions`



~~~python
def list_document_sessions() -> List[Dict[str, Any]]
~~~


List document builder sessions.

Source: `lightbulb/client.py:4823`.

##### `lightbulb.client.LightbulbClient.list_domain_actions`



~~~python
def list_domain_actions(domain: str) -> List[Dict[str, Any]]
~~~


List available actions for a specific domain agent.

Source: `lightbulb/client.py:7703`.

##### `lightbulb.client.LightbulbClient.list_domains`



~~~python
def list_domains() -> Dict[str, Dict[str, Any]] | List[Dict[str, Any]]
~~~


List all available domain agents and their capabilities.

Source: `lightbulb/client.py:7694`.

##### `lightbulb.client.LightbulbClient.list_executable_business_primitives`



~~~python
def list_executable_business_primitives(*, query: str='', include_schemas: bool=True, offset: int=0, limit: int | None=None) -> Dict[str, Any]
~~~


List SDK primitive implementations, optionally as bounded pages.

Source: `lightbulb/client.py:5145`.

##### `lightbulb.client.LightbulbClient.list_finance_reconciliation_runs`



~~~python
def list_finance_reconciliation_runs(*, company_id: str | None=None, limit: int=50) -> tuple[FinanceReconciliationRunSummary, ...]
~~~


List bounded reconciliation run summaries under one Spring scope.

Source: `lightbulb/client.py:3466`.

##### `lightbulb.client.LightbulbClient.list_folder`



~~~python
def list_folder(folder_path: str='', *, source_system: str | None=None, max_items: int=100) -> DispatchResult
~~~


List documents in a folder.

Source: `lightbulb/client.py:4892`.

##### `lightbulb.client.LightbulbClient.list_marketplace_installations`



~~~python
def list_marketplace_installations(*, status: str | None=None, cursor: str | None=None, limit: int=50) -> Dict[str, Any]
~~~


List marketplace installations for the selected active company.

Source: `lightbulb/client.py:8199`.

##### `lightbulb.client.LightbulbClient.list_marketplace_listings`



~~~python
def list_marketplace_listings(*, query: str | None=None, kind: str | None=None, domain: str | None=None, cursor: str | None=None, limit: int=50, include_inputs: bool=True) -> Dict[str, Any]
~~~


List persisted lifecycle listings and authoritative UUID IDs.

Source: `lightbulb/client.py:8005`.

##### `lightbulb.client.LightbulbClient.list_notifications`



~~~python
def list_notifications(**filters) -> List[Dict[str, Any]]
~~~


List notifications (HITL decisions, workflow alerts, system messages).

Source: `lightbulb/client.py:7269`.

##### `lightbulb.client.LightbulbClient.list_page_builder_sessions`



~~~python
def list_page_builder_sessions() -> List[Dict[str, Any]]
~~~


List page builder sessions.

Source: `lightbulb/client.py:4980`.

##### `lightbulb.client.LightbulbClient.list_pending_approvals`



~~~python
def list_pending_approvals() -> List[Dict[str, Any]]
~~~


List pending HITL approval tasks waiting for your decision.

Source: `lightbulb/client.py:6942`.

##### `lightbulb.client.LightbulbClient.list_project_business_outcomes`



~~~python
def list_project_business_outcomes(project_id: str, *, limit: int=25) -> Dict[str, Any]
~~~


Read the authenticated score ledger for one accessible project.

Source: `lightbulb/client.py:4248`.

##### `lightbulb.client.LightbulbClient.list_project_connector_accounts`



~~~python
def list_project_connector_accounts(project_id: str, *, company_id: str | None=None) -> List[Dict[str, Any]]
~~~


List connector accounts already bound to one accessible project.

Source: `lightbulb/client.py:2934`.

##### `lightbulb.client.LightbulbClient.list_project_learning_result_evaluations`



~~~python
def list_project_learning_result_evaluations(project_id: str, *, limit: int=25) -> Dict[str, Any]
~~~


Read independent technical results and separate human decisions.

Source: `lightbulb/client.py:4118`.

##### `lightbulb.client.LightbulbClient.list_project_learning_reviews`



~~~python
def list_project_learning_reviews(project_id: str, *, limit: int=25) -> Dict[str, Any]
~~~


Read human after-action decisions and admitted shadow observations.

Source: `lightbulb/client.py:3951`.

##### `lightbulb.client.LightbulbClient.list_project_learning_runs`



~~~python
def list_project_learning_runs(project_id: str, *, limit: int=25) -> Dict[str, Any]
~~~


Read receipt-backed Training Quest state without inferring missing execution.

Source: `lightbulb/client.py:4005`.

##### `lightbulb.client.LightbulbClient.list_project_mission_runs`



~~~python
def list_project_mission_runs(project_id: str, *, limit: int=25) -> Dict[str, Any]
~~~


Read briefing locks and action bindings for one accessible project.

Source: `lightbulb/client.py:3857`.

##### `lightbulb.client.LightbulbClient.list_project_policy_assignments`



~~~python
def list_project_policy_assignments(project_id: str, *, limit: int=25) -> Dict[str, Any]
~~~


Read immutable decision-time probability assignments for one project.

Source: `lightbulb/client.py:4322`.

##### `lightbulb.client.LightbulbClient.list_project_policy_evaluations`



~~~python
def list_project_policy_evaluations(project_id: str, *, limit: int=25) -> Dict[str, Any]
~~~


Read offline-policy receipts and their explicit truth boundary.

Source: `lightbulb/client.py:4396`.

##### `lightbulb.client.LightbulbClient.list_project_science_evidence`



~~~python
def list_project_science_evidence(project_id: str, *, limit: int=50) -> Dict[str, Any]
~~~


Read the scope-verified hypothesis-to-policy context spine.

Source: `lightbulb/client.py:3775`.

##### `lightbulb.client.LightbulbClient.list_project_shadow_learner_updates`



~~~python
def list_project_shadow_learner_updates(project_id: str, *, limit: int=25) -> Dict[str, Any]
~~~


Read bounded shadow update/rollback receipts; this grants no authority.

Source: `lightbulb/client.py:4176`.

##### `lightbulb.client.LightbulbClient.list_project_skill_matches`



~~~python
def list_project_skill_matches(project_id: str, *, limit: int=25) -> Dict[str, Any]
~~~


Read the project's worker-verified shadow Training Arena ledger.

Source: `lightbulb/client.py:3969`.

##### `lightbulb.client.LightbulbClient.list_project_training_packs`



~~~python
def list_project_training_packs(project_id: str, *, limit: int=25) -> Dict[str, Any]
~~~


Read exact Arena + human-lesson packs before any learning-run admission.

Source: `lightbulb/client.py:3987`.

##### `lightbulb.client.LightbulbClient.list_projects`



~~~python
def list_projects(*, company_id: str | None=None) -> List[Dict[str, Any]]
~~~


List projects visible in one authenticated company scope.

Source: `lightbulb/client.py:2750`.

##### `lightbulb.client.LightbulbClient.list_ready_sdk_project_checkpoints`



~~~python
def list_ready_sdk_project_checkpoints(project_id: str, *, ready_at: str, limit: int=100, company_id: str | None=None) -> List[Dict[str, Any]]
~~~


Source: `lightbulb/client.py:5706`.

##### `lightbulb.client.LightbulbClient.list_runtime_domain_actions`



~~~python
def list_runtime_domain_actions(*, project_id: str, status: str='pending_approval', company_id: str | None=None) -> Dict[str, Any]
~~~


List one explicit lifecycle state for the selected company.

Source: `lightbulb/client.py:7886`.

##### `lightbulb.client.LightbulbClient.list_runtime_outcomes`



~~~python
def list_runtime_outcomes() -> List[Dict[str, Any]]
~~~


Return sanitized outcomes recorded by this SDK process.

Source: `lightbulb/client.py:5971`.

##### `lightbulb.client.LightbulbClient.list_server_workflow_improvement_packets`



~~~python
def list_server_workflow_improvement_packets(*, status: str | None=None, limit: int=50) -> List[Dict[str, Any]]
~~~


Source: `lightbulb/client.py:6186`.

##### `lightbulb.client.LightbulbClient.list_tool_contracts`



~~~python
def list_tool_contracts() -> List[Dict[str, Any]]
~~~


List hosted Tool schemas used for connector drift detection.

Source: `lightbulb/client.py:7025`.

##### `lightbulb.client.LightbulbClient.list_voice_executions`



~~~python
def list_voice_executions(**filters: Any) -> List[Dict[str, Any]]
~~~


List voice agent executions (live and historical phone calls).

Source: `lightbulb/client.py:8576`.

##### `lightbulb.client.LightbulbClient.list_voice_pending_approvals`



~~~python
def list_voice_pending_approvals() -> List[Dict[str, Any]]
~~~


List in-call HITL approvals waiting for caller-side decision.

Source: `lightbulb/client.py:8602`.

##### `lightbulb.client.LightbulbClient.list_workflow_improvement_packets`



~~~python
def list_workflow_improvement_packets(output_dir: str | os.PathLike[str] | None=None, *, status: str | None=None) -> List[Dict[str, Any]]
~~~


List approval-gated workflow improvement packets.

Source: `lightbulb/client.py:6042`.

##### `lightbulb.client.LightbulbClient.list_workflows`



~~~python
def list_workflows(*, company_id: str | None=None) -> List[Dict[str, Any]]
~~~


List active workflow definitions in the authenticated company scope.

Source: `lightbulb/client.py:6463`.

##### `lightbulb.client.LightbulbClient.mark_all_notifications_read`



~~~python
def mark_all_notifications_read() -> Dict[str, Any]
~~~


Mark all notifications as read.

Source: `lightbulb/client.py:9970`.

##### `lightbulb.client.LightbulbClient.mark_notification_read`



~~~python
def mark_notification_read(notification_id: str) -> Dict[str, Any]
~~~


Mark a single notification as read.

Source: `lightbulb/client.py:9959`.

##### `lightbulb.client.LightbulbClient.marketing_add_website_analytics_site`



~~~python
def marketing_add_website_analytics_site(body: Dict[str, Any]) -> Dict[str, Any]
~~~


Register a website with the analytics setup.

Source: `lightbulb/client.py:10282`.

##### `lightbulb.client.LightbulbClient.marketing_content_configure_provider`



~~~python
def marketing_content_configure_provider(provider: str, body: Dict[str, Any]) -> Dict[str, Any]
~~~


Configure a marketing-content provider (e.g. ga4, segment, plausible).

Source: `lightbulb/client.py:10268`.

##### `lightbulb.client.LightbulbClient.marketing_content_setup`



~~~python
def marketing_content_setup() -> Dict[str, Any]
~~~


Get the marketing content connector setup state.

Source: `lightbulb/client.py:10258`.

##### `lightbulb.client.LightbulbClient.marketing_install_website_analytics`



~~~python
def marketing_install_website_analytics(workspace_id: str, body: Dict[str, Any] | None=None) -> Dict[str, Any]
~~~


Install website analytics into a code workspace.

Source: `lightbulb/client.py:10329`.

##### `lightbulb.client.LightbulbClient.marketing_remove_website_analytics_site`



~~~python
def marketing_remove_website_analytics_site(site_id: str) -> Dict[str, Any]
~~~


Remove a registered analytics site.

Source: `lightbulb/client.py:10306`.

##### `lightbulb.client.LightbulbClient.marketing_select_website_analytics_site`



~~~python
def marketing_select_website_analytics_site(site_id: str) -> Dict[str, Any]
~~~


Activate a registered analytics site.

Source: `lightbulb/client.py:10295`.

##### `lightbulb.client.LightbulbClient.marketing_verify_website_analytics`



~~~python
def marketing_verify_website_analytics(body: Dict[str, Any] | None=None) -> Dict[str, Any]
~~~


Verify the website analytics setup is wired correctly.

Source: `lightbulb/client.py:10316`.

##### `lightbulb.client.LightbulbClient.memory_add_skill`



~~~python
def memory_add_skill(body: Dict[str, Any]) -> Dict[str, Any]
~~~


Record a new skill / capability.

Source: `lightbulb/client.py:9828`.

##### `lightbulb.client.LightbulbClient.memory_create_entry`



~~~python
def memory_create_entry(body: Dict[str, Any]) -> Dict[str, Any]
~~~


Create a structured memory entry.

Source: `lightbulb/client.py:9611`.

##### `lightbulb.client.LightbulbClient.memory_create_identity`



~~~python
def memory_create_identity(body: Dict[str, Any]) -> Dict[str, Any]
~~~


Create an identity record.

Source: `lightbulb/client.py:9753`.

##### `lightbulb.client.LightbulbClient.memory_create_link`



~~~python
def memory_create_link(body: Dict[str, Any]) -> Dict[str, Any]
~~~


Create a memory link between two entities.

Source: `lightbulb/client.py:9809`.

##### `lightbulb.client.LightbulbClient.memory_get_entry`



~~~python
def memory_get_entry(entry_id: str) -> Dict[str, Any]
~~~


Get a specific memory entry.

Source: `lightbulb/client.py:9601`.

##### `lightbulb.client.LightbulbClient.memory_get_identity`



~~~python
def memory_get_identity(doc_id: str) -> Dict[str, Any]
~~~


Get an identity record by doc id.

Source: `lightbulb/client.py:9762`.

##### `lightbulb.client.LightbulbClient.memory_graph`



~~~python
def memory_graph(**filters: Any) -> Dict[str, Any]
~~~


Full memory graph (or filtered subgraph).

Source: `lightbulb/client.py:9721`.

##### `lightbulb.client.LightbulbClient.memory_graph_node`



~~~python
def memory_graph_node(node_id: str) -> Dict[str, Any]
~~~


Get a single node from the memory graph.

Source: `lightbulb/client.py:9732`.

##### `lightbulb.client.LightbulbClient.memory_list_entries`



~~~python
def memory_list_entries(**filters: Any) -> List[Dict[str, Any]]
~~~


List memory entries (structured records).

Source: `lightbulb/client.py:9585`.

##### `lightbulb.client.LightbulbClient.memory_list_events`



~~~python
def memory_list_events(**filters: Any) -> List[Dict[str, Any]]
~~~


List memory events (timeline of state changes).

Source: `lightbulb/client.py:9772`.

##### `lightbulb.client.LightbulbClient.memory_list_identity`



~~~python
def memory_list_identity() -> List[Dict[str, Any]]
~~~


List identity records in the memory graph.

Source: `lightbulb/client.py:9743`.

##### `lightbulb.client.LightbulbClient.memory_list_links`



~~~python
def memory_list_links(**filters: Any) -> List[Dict[str, Any]]
~~~


List entity links in the memory graph.

Source: `lightbulb/client.py:9797`.

##### `lightbulb.client.LightbulbClient.memory_list_skills`



~~~python
def memory_list_skills() -> List[Dict[str, Any]]
~~~


List skills/capabilities recorded in memory.

Source: `lightbulb/client.py:9818`.

##### `lightbulb.client.LightbulbClient.memory_projection_memory`



~~~python
def memory_projection_memory() -> Dict[str, Any]
~~~


Memory-structure projection of the agent.

Source: `lightbulb/client.py:9638`.

##### `lightbulb.client.LightbulbClient.memory_projection_soul`



~~~python
def memory_projection_soul() -> Dict[str, Any]
~~~


Identity / personality projection of the agent.

Source: `lightbulb/client.py:9629`.

##### `lightbulb.client.LightbulbClient.memory_query`



~~~python
def memory_query(body: Dict[str, Any]) -> Dict[str, Any]
~~~


Run a structured memory query (filters, time-windows, semantic).

Source: `lightbulb/client.py:9620`.

##### `lightbulb.client.LightbulbClient.memory_recall`



~~~python
def memory_recall(key: str, *, namespace: str='default') -> Dict[str, Any]
~~~


Recall a value from agent memory.

Source: `lightbulb/client.py:7668`.

##### `lightbulb.client.LightbulbClient.memory_record_event`



~~~python
def memory_record_event(body: Dict[str, Any]) -> Dict[str, Any]
~~~


Record a memory event.

Source: `lightbulb/client.py:9788`.

##### `lightbulb.client.LightbulbClient.memory_regulate`



~~~python
def memory_regulate(*, idempotency_key: str | None=None, project_id: str | None=None, budget: int | None=None, categories: Sequence[str] | None=None, dry_run: bool=True, max_summary_chars: int=900, empirical_success_floor_ppm: int | None=None, empirical_success_min_samples: int=20, empirical_success_lookback_days: int=90, optimize_for_least_active_memory: bool=False, held_out_task_evaluation: Mapping[str, Any] | None=None) -> Dict[str, Any]
~~~


Preview or execute bounded, success-evidence-aware compaction.

Source: `lightbulb/client.py:9666`.

##### `lightbulb.client.LightbulbClient.memory_regulation_storage_status`



~~~python
def memory_regulation_storage_status() -> Dict[str, Any]
~~~


Inspect finite company, tenant, and platform receipt admission.

Source: `lightbulb/client.py:9656`.

##### `lightbulb.client.LightbulbClient.memory_search`



~~~python
def memory_search(query: str, *, namespace: str='default', top_k: int=5) -> List[Dict[str, Any]]
~~~


Search agent memory semantically.

Source: `lightbulb/client.py:7678`.

##### `lightbulb.client.LightbulbClient.memory_status`



~~~python
def memory_status() -> Dict[str, Any]
~~~


Health / capacity status of the memory subsystem.

Source: `lightbulb/client.py:9647`.

##### `lightbulb.client.LightbulbClient.memory_store`



~~~python
def memory_store(key: str, value: str, *, namespace: str='default') -> Dict[str, Any]
~~~


Store a value in agent memory.

Source: `lightbulb/client.py:7655`.

##### `lightbulb.client.LightbulbClient.modify_voice_action`



~~~python
def modify_voice_action(execution_id: str, approval_task_id: str, modifications: Dict[str, Any]) -> Dict[str, Any]
~~~


Approve a voice action with modifications to the proposed payload.

Source: `lightbulb/client.py:8647`.

##### `lightbulb.client.LightbulbClient.page_builder_capabilities`



~~~python
def page_builder_capabilities(session_id: str) -> Dict[str, Any]
~~~


List page capabilities (forms, search, auth, etc.).

Source: `lightbulb/client.py:10110`.

##### `lightbulb.client.LightbulbClient.page_builder_deploy`



~~~python
def page_builder_deploy(session_id: str, page_key: str='') -> Dict[str, Any]
~~~


Deploy a page builder session.

Source: `lightbulb/client.py:5013`.

##### `lightbulb.client.LightbulbClient.page_builder_get_preview`



~~~python
def page_builder_get_preview(session_id: str) -> Dict[str, Any]
~~~


Get the preview URL for a page builder session.

Source: `lightbulb/client.py:5025`.

##### `lightbulb.client.LightbulbClient.page_builder_get_schemas`



~~~python
def page_builder_get_schemas(session_id: str) -> Dict[str, Any]
~~~


Get the current page schemas for a session.

Source: `lightbulb/client.py:5003`.

##### `lightbulb.client.LightbulbClient.page_builder_install_artifact`



~~~python
def page_builder_install_artifact(session_id: str, body: Dict[str, Any]) -> Dict[str, Any]
~~~


Install a component artifact into the page session.

Source: `lightbulb/client.py:10097`.

##### `lightbulb.client.LightbulbClient.page_builder_promote_install_bundle`



~~~python
def page_builder_promote_install_bundle(session_id: str, body: Dict[str, Any]) -> Dict[str, Any]
~~~


Promote an install bundle to the workspace.

Source: `lightbulb/client.py:10084`.

##### `lightbulb.client.LightbulbClient.page_builder_promote_section`



~~~python
def page_builder_promote_section(session_id: str, body: Dict[str, Any]) -> Dict[str, Any]
~~~


Promote a section artifact to the install bundle.

Source: `lightbulb/client.py:10071`.

##### `lightbulb.client.LightbulbClient.page_builder_save_backend_contract`



~~~python
def page_builder_save_backend_contract(session_id: str, body: Dict[str, Any]) -> Dict[str, Any]
~~~


Define a backend contract for a page (data shape + agent binding).

Source: `lightbulb/client.py:10133`.

##### `lightbulb.client.LightbulbClient.page_builder_save_capability`



~~~python
def page_builder_save_capability(session_id: str, body: Dict[str, Any]) -> Dict[str, Any]
~~~


Save a capability to the page session.

Source: `lightbulb/client.py:10120`.

##### `lightbulb.client.LightbulbClient.page_builder_send_message`



~~~python
def page_builder_send_message(session_id: str, content: str) -> Dict[str, Any]
~~~


Send a message to a page builder session (non-streaming).

Source: `lightbulb/client.py:4990`.

##### `lightbulb.client.LightbulbClient.page_builder_unpublish`



~~~python
def page_builder_unpublish(session_id: str) -> Dict[str, Any]
~~~


Unpublish a deployed page builder session.

Source: `lightbulb/client.py:10146`.

##### `lightbulb.client.LightbulbClient.page_builder_workspace_automation`



~~~python
def page_builder_workspace_automation(session_id: str, body: Dict[str, Any] | None=None) -> Dict[str, Any]
~~~


Run the page-builder workspace automation (auto-wire pages → agents → backend).

Source: `lightbulb/client.py:10058`.

##### `lightbulb.client.LightbulbClient.pin_marketplace_action`



~~~python
def pin_marketplace_action(installation_id: str, revision_id: str, *, idempotency_key: str, expected_revision_id: str | None=None) -> Dict[str, Any]
~~~


Pin an installation to an immutable listing revision.

Source: `lightbulb/client.py:8311`.

##### `lightbulb.client.LightbulbClient.post_aoc_task_event`



~~~python
def post_aoc_task_event(task_id: str, body: Dict[str, Any]) -> Dict[str, Any]
~~~


Post a new event onto an AutoCompany task.

Source: `lightbulb/client.py:9498`.

##### `lightbulb.client.LightbulbClient.preflight_project_creation`



~~~python
def preflight_project_creation(name: str, instructions: str='') -> ProjectCreationPreflightReceipt
~~~


Review a project draft without creating or mutating anything.

Source: `lightbulb/client.py:4476`.

##### `lightbulb.client.LightbulbClient.preflight_training_pair`



~~~python
def preflight_training_pair(installation_id: str, revision_id: str, *, project_id: str | None=None) -> Dict[str, Any]
~~~


Read readiness for one exact installed action revision.

Source: `lightbulb/client.py:8477`.

##### `lightbulb.client.LightbulbClient.prepare_project_learning_run`



~~~python
def prepare_project_learning_run(project_id: str, *, training_pack_receipt_id: Any, primary_metric: Any, runtime: str='automl', request_id: Any=None, direction: str='maximize', minimum_improvement: Any='0.010000', max_cost_usd: Any='0.000000', max_platform_cost_usd: Any='5.000000', max_gpu_seconds: Any=3600, max_tokens: Any=100000, max_steps: Any=10000, provider_account_fingerprint: Any=None, provider_binding_expires_at: Any=None, max_attempts: Any=3, lease_seconds: Any=300, preemptible: bool=True, confirm_prepare: bool=False, idempotency_key: str | None=None) -> Dict[str, Any]
~~~


Publish exact dataset custody and create a queued durable Memory run.

Source: `lightbulb/client.py:4023`.

##### `lightbulb.client.LightbulbClient.prepare_workflow_learning_handoff`



~~~python
def prepare_workflow_learning_handoff(packet_id: str, delivery_id: str, installation_id: str, revision_id: str, *, candidate_manifest: Dict[str, Any], episode_manifest: Dict[str, Any] | None=None, project_id: str | None=None) -> Dict[str, Any]
~~~


Bind a validated delivery to read-only paired-learning readiness.

Source: `lightbulb/client.py:6319`.

##### `lightbulb.client.LightbulbClient.preview_account_shell_customization`



~~~python
def preview_account_shell_customization(draft_revision_id: str) -> Dict[str, Any]
~~~


Compile a draft into a non-publishing preview receipt.

Source: `lightbulb/client.py:7752`.

##### `lightbulb.client.LightbulbClient.preview_marketplace_action_publication`



~~~python
def preview_marketplace_action_publication(*, slug: str, name: str, version: str, domain: str, action: str, visibility: str='PRIVATE', pricing_model: str='INCLUDED', changelog: str='') -> Dict[str, Any]
~~~


Preview a server-derived immutable action contract without publishing it.

Source: `lightbulb/client.py:8060`.

##### `lightbulb.client.LightbulbClient.publish_account_shell_customization`



~~~python
def publish_account_shell_customization(draft_revision_id: str, *, preview_receipt_id: str, expected_current_revision_id: str | None, idempotency_key: str) -> Dict[str, Any]
~~~


Publish the exact previewed draft with optimistic concurrency.

Source: `lightbulb/client.py:7775`.

##### `lightbulb.client.LightbulbClient.publish_marketplace_action`



~~~python
def publish_marketplace_action(*, slug: str, name: str, version: str, domain: str, action: str, expected_contract_digest: str, idempotency_key: str, visibility: str='PRIVATE', pricing_model: str='INCLUDED', changelog: str='') -> Dict[str, Any]
~~~


Publish the exact action contract approved by a prior preview.

Source: `lightbulb/client.py:8092`.

##### `lightbulb.client.LightbulbClient.put_sdk_project_checkpoint`



~~~python
def put_sdk_project_checkpoint(project_id: str, run_ref: str, checkpoint: Dict[str, Any], *, expected_revision: int | None, company_id: str | None=None) -> Dict[str, Any]
~~~


Source: `lightbulb/client.py:5668`.

##### `lightbulb.client.LightbulbClient.rag_query`



~~~python
def rag_query(question: str, *, top_k: int=5, document_ids: List[str] | None=None) -> Dict[str, Any]
~~~


Query the RAG knowledge base directly.

Source: `lightbulb/client.py:6985`.

##### `lightbulb.client.LightbulbClient.rag_upload_document`



~~~python
def rag_upload_document(filename: str, content: str, **metadata) -> Dict[str, Any]
~~~


Upload a document to the RAG library.

Source: `lightbulb/client.py:6999`.

##### `lightbulb.client.LightbulbClient.record_project_business_outcome`



~~~python
def record_project_business_outcome(project_id: str, *, metric_id: Any, metric_label: Any, direction: Any, baseline_value: Any, observed_value: Any, confirm_record: bool=False, unit: Any=None, observed_at: Any=None, observation_id: Any=None, source_kind: str='human_attestation', source_event_id: Any=None, evidence_refs: Sequence[Any] | None=None, links: Mapping[str, Any] | None=None, note: Any=None, idempotency_key: str | None=None) -> Dict[str, Any]
~~~


Append one scoped metric observation; never admit learning or promotion.

Source: `lightbulb/client.py:4267`.

##### `lightbulb.client.LightbulbClient.record_project_coding_harness_result`



~~~python
def record_project_coding_harness_result(project_id: str, *, harness: str, handoff_payload_id: str, status: str, summary: str, report_id: str | None=None, host_session_ref: str | None=None, changed_files: Sequence[str] | None=None, test_commands_and_results: Sequence[str] | None=None, unresolved_requirements_or_acceptance_gaps: str | None=None, pull_request_url: str | None=None, commit_sha: str | None=None) -> Dict[str, Any]
~~~


Return bounded coding evidence to the Project Agent delivery loop.

Source: `lightbulb/client.py:2880`.

##### `lightbulb.client.LightbulbClient.record_project_learning_review`



~~~python
def record_project_learning_review(project_id: str, *, mission_run_receipt_id: Any, mission_action_receipt_id: Any, outcome_receipt_id: Any, decision: Any, skill_trial_arm: Any, selected_skill_ids: Sequence[Any] | None, label: Any, reason: Any, confirm_record: bool=False, review_id: Any=None, evidence_refs: Sequence[Any] | None=None, idempotency_key: str | None=None) -> Dict[str, Any]
~~~


Human-review one exact chain for shadow training; no live learner mutation.

Source: `lightbulb/client.py:4200`.

##### `lightbulb.client.LightbulbClient.record_project_policy_assignment`



~~~python
def record_project_policy_assignment(project_id: str, *, metric_id: Any, direction: Any, actions: Sequence[Mapping[str, Any]], chosen_action_id: Any, behavior_policy: Mapping[str, Any], candidate_policies: Sequence[Mapping[str, Any]], confirm_record: bool=False, assignment_id: Any=None, unit: Any=None, decided_at: Any=None, source_kind: str='human_attestation', source_event_id: Any=None, evidence_refs: Sequence[Any] | None=None, links: Mapping[str, Any] | None=None, note: Any=None, idempotency_key: str | None=None) -> Dict[str, Any]
~~~


Log propensities before an outcome; this never executes an action.

Source: `lightbulb/client.py:4340`.

##### `lightbulb.client.LightbulbClient.record_project_science_evidence`



~~~python
def record_project_science_evidence(project_id: str, *, stage: Any, summary: Any, business_metric_id: Any, expected_direction: Any, artifact_kind: Any, artifact_system: Any, artifact_reference: Any, artifact_digest_sha256: Any, producer_role: Any, confirm_record: bool=False, tool_names: Sequence[Any] | None=None, skill_ids: Sequence[Any] | None=None, parent_receipt_ids: Sequence[Any] | None=None, artifact_schema: Any=None, observed_at: Any=None, evidence_id: Any=None, source_kind: str='human_attestation', source_event_id: Any=None, evidence_refs: Sequence[Any] | None=None, idempotency_key: str | None=None) -> Dict[str, Any]
~~~


Append scientific lineage evidence; never authorize the underlying action.

Source: `lightbulb/client.py:3793`.

##### `lightbulb.client.LightbulbClient.record_server_runtime_outcomes`



~~~python
def record_server_runtime_outcomes(outcomes: List[Dict[str, Any]], *, idempotency_key: str | None=None) -> Dict[str, Any]
~~~


Persist a batch in the authenticated tenant/company runtime ledger.

Source: `lightbulb/client.py:5981`.

##### `lightbulb.client.LightbulbClient.record_server_workflow_improvement_run`



~~~python
def record_server_workflow_improvement_run(*, idempotency_key: str, contract_score: float, primitive_count: int, check_count: int, passed_check_count: int, trend_direction: str, source_run_id: str | None=None, outcomes: List[Dict[str, Any]] | None=None, metrics: Dict[str, Any] | None=None) -> Dict[str, Any]
~~~


Source: `lightbulb/client.py:6114`.

##### `lightbulb.client.LightbulbClient.record_workflow_improvement_delivery_event`



~~~python
def record_workflow_improvement_delivery_event(delivery_id: str, event_type: str, *, rationale: str='', evidence: Dict[str, Any] | None=None) -> Dict[str, Any]
~~~


Source: `lightbulb/client.py:6271`.

##### `lightbulb.client.LightbulbClient.recursive_agent_execute`



~~~python
def recursive_agent_execute(objective: str, *, inputs: Dict[str, Any] | None=None, policy: Any=None, execution_id: str | None=None) -> Dict[str, Any]
~~~


Run a governed recursive objective with finite subagent and REPL limits.

Source: `lightbulb/client.py:6574`.

##### `lightbulb.client.LightbulbClient.refine_project_creation_preflight`



~~~python
def refine_project_creation_preflight(receipt: ProjectCreationPreflightReceipt, answer: str) -> ProjectCreationPreflightReceipt
~~~


Apply one explicit answer to the receipt's authoritative next question.

Source: `lightbulb/client.py:4589`.

##### `lightbulb.client.LightbulbClient.refresh_auth`



~~~python
def refresh_auth() -> bool
~~~


Run the configured ``auth_refresh`` callback and swap in fresh auth.

Source: `lightbulb/client.py:3251`.

##### `lightbulb.client.LightbulbClient.register_external_artifact`



~~~python
def register_external_artifact(*, type: str, title: str='', summary: str='', uri: str='', content: str='', project_id: Optional[str]=None, source_agent: str='external_agent', metadata: Optional[Dict[str, Any]]=None, attach_workspace: bool=False) -> Dict[str, Any]
~~~


Register an external artifact (codebase/document/slide deck/spreadsheet/url) created by a general agent so Lightbulb domain agents can discover and work on it.

Source: `lightbulb/client.py:6418`.

##### `lightbulb.client.LightbulbClient.register_runtime_domain_action`



~~~python
def register_runtime_domain_action(domain: str, action: str, *, project_id: str, idempotency_key: str, description: str='', component_ids: Sequence[str] | None=None, agent_spec: Dict[str, Any] | None=None, execution_policy: Dict[str, Any] | None=None, company_id: str | None=None) -> Dict[str, Any]
~~~


Register a company-scoped action as ``pending_approval``.

Source: `lightbulb/client.py:7844`.

##### `lightbulb.client.LightbulbClient.reject_code_workspace_proposal`



~~~python
def reject_code_workspace_proposal(workspace_id: str, proposal_id: str, *, reason: str='') -> Dict[str, Any]
~~~


Reject a proposal.

Source: `lightbulb/client.py:9011`.

##### `lightbulb.client.LightbulbClient.reject_runtime_domain_action`



~~~python
def reject_runtime_domain_action(runtime_action_id: str, *, project_id: str, company_id: str | None=None) -> Dict[str, Any]
~~~


Reject one reviewed pending registration without executing it.

Source: `lightbulb/client.py:7946`.

##### `lightbulb.client.LightbulbClient.reject_task`



~~~python
def reject_task(task_id: str, *, comments: str='') -> Dict[str, Any]
~~~


Reject a pending HITL task.

Source: `lightbulb/client.py:6972`.

##### `lightbulb.client.LightbulbClient.reject_voice_action`



~~~python
def reject_voice_action(execution_id: str, approval_task_id: str, *, comments: str='') -> Dict[str, Any]
~~~


Reject a pending in-call action.

Source: `lightbulb/client.py:8630`.

##### `lightbulb.client.LightbulbClient.renew_sdk_project_checkpoint_lease`



~~~python
def renew_sdk_project_checkpoint_lease(project_id: str, run_ref: str, *, worker_ref: str, expected_revision: int, lease_seconds: int=60, company_id: str | None=None) -> Dict[str, Any]
~~~


Source: `lightbulb/client.py:5746`.

##### `lightbulb.client.LightbulbClient.request_training_pair_admission`



~~~python
def request_training_pair_admission(installation_id: str, revision_id: str, *, idempotency_key: str, project_id: str | None=None) -> Dict[str, Any]
~~~


Request admission and preserve the gateway's structured hard 503.

Source: `lightbulb/client.py:8509`.

##### `lightbulb.client.LightbulbClient.rollback_account_shell_customization`



~~~python
def rollback_account_shell_customization(target_revision_id: str, *, expected_current_revision_id: str | None, idempotency_key: str) -> Dict[str, Any]
~~~


Roll back to an immutable revision with optimistic concurrency.

Source: `lightbulb/client.py:7811`.

##### `lightbulb.client.LightbulbClient.run_business_primitive`



~~~python
def run_business_primitive(primitive_id: str, inputs: Dict[str, Any] | None=None, *, source: str='sdk', mode: str | None=None, preview_only: bool=True, request: str='') -> Dict[str, Any]
~~~


Run a business primitive through Backbone/domain orchestration.

Source: `lightbulb/client.py:5831`.

##### `lightbulb.client.LightbulbClient.run_connector_conformance`



~~~python
def run_connector_conformance(*, check_live_schemas: bool=False) -> Dict[str, Any]
~~~


Verify every primitive provider and optionally compare hosted schemas.

Source: `lightbulb/client.py:7036`.

##### `lightbulb.client.LightbulbClient.run_finance_reconciliation`



~~~python
def run_finance_reconciliation(request: FinanceReconciliationRequest | Mapping[str, Any] | None=None, *, company_id: str | None=None) -> FinanceReconciliationResult
~~~


Run the governed Stripe/ledger reconciliation in Spring.

Source: `lightbulb/client.py:3438`.

##### `lightbulb.client.LightbulbClient.run_sdk_business_primitive`



~~~python
def run_sdk_business_primitive(primitive_id: str, inputs: Dict[str, Any] | None=None, *, project_ref: str, project_id: str | None=None, preview_only: bool=True, approval_refs: Dict[str, str] | None=None, connector_account_refs: Dict[str, str] | None=None, run_ref: str | None=None, idempotency_key: str | None=None) -> Dict[str, Any]
~~~


Run SDK code with hosted reads, previews, and governed writes.

Source: `lightbulb/client.py:5165`.

##### `lightbulb.client.LightbulbClient.run_sdk_project_workflow`



~~~python
def run_sdk_project_workflow(project: Any, workflow_key: str, inputs: Dict[str, Any] | None=None, *, preview_only: bool | None=None, approval_refs: Dict[str, str] | None=None, connector_account_refs: Dict[str, str] | None=None, run_ref: str | None=None, registry: Any=None) -> Dict[str, Any]
~~~


Run a project workflow; hosted connector writes remain fail-closed.

Source: `lightbulb/client.py:5791`.

##### `lightbulb.client.LightbulbClient.run_workflow_improvement_cycle`



~~~python
def run_workflow_improvement_cycle(output_dir: str | os.PathLike[str] | None=None, *, observed_outcomes: List[Dict[str, Any]] | None=None) -> Dict[str, Any]
~~~


Evaluate local workflow contracts and persist proposal-only work packets.

Source: `lightbulb/client.py:5946`.

##### `lightbulb.client.LightbulbClient.search_agent_marketplace`



~~~python
def search_agent_marketplace(*, query: str | None=None, kind: str | None=None, domain: str | None=None, limit: int=50, include_inputs: bool=True) -> Dict[str, Any]
~~~


Discover normalized Lightbulb action and worker listings.

Source: `lightbulb/client.py:7964`.

##### `lightbulb.client.LightbulbClient.search_documents`



~~~python
def search_documents(query: str, *, folder_path: str | None=None, top_k: int=10) -> DispatchResult
~~~


Search across all documents using semantic search.

Source: `lightbulb/client.py:4849`.

##### `lightbulb.client.LightbulbClient.set_approval_preference_state`



~~~python
def set_approval_preference_state(preference_id: str, *, enabled: bool) -> Dict[str, Any]
~~~


Enable or disable an auto-accept rule.

Source: `lightbulb/client.py:9944`.

##### `lightbulb.client.LightbulbClient.simulate_business_workflow`



~~~python
def simulate_business_workflow(definition: Dict[str, Any], *, events: List[str] | None=None, approvals: Dict[str, Any] | None=None, loop_iterations: int | None=None) -> Dict[str, Any]
~~~


Dry-run a workflow within its bound without invoking live systems.

Source: `lightbulb/client.py:5928`.

##### `lightbulb.client.LightbulbClient.start_codex_account_link`



~~~python
def start_codex_account_link(*, company_id: str | None=None) -> Dict[str, Any]
~~~


Start the Codex device-auth flow for the current Lightbulb account.

Source: `lightbulb/client.py:3186`.

##### `lightbulb.client.LightbulbClient.start_project_mission_run`



~~~python
def start_project_mission_run(project_id: str, mission_briefing: Mapping[str, Any], *, confirm_start: bool=False, run_id: Any=None, play_style_id: Any=None, skill_trial_arm: Any=None, selected_skill_ids: Sequence[Any] | None=None, context_source_refs: Sequence[Any] | None=None, note: Any=None, idempotency_key: str | None=None) -> Dict[str, Any]
~~~


Lock an exact briefing before action; this never dispatches a worker.

Source: `lightbulb/client.py:3875`.

##### `lightbulb.client.LightbulbClient.start_workflow_improvement_delivery`



~~~python
def start_workflow_improvement_delivery(packet_id: str, *, environment: str, repository_ref: str | None=None, base_branch: str='main') -> Dict[str, Any]
~~~


Source: `lightbulb/client.py:6249`.

##### `lightbulb.client.LightbulbClient.stop_aoc_run`



~~~python
def stop_aoc_run(run_id: str) -> Dict[str, Any]
~~~


Stop an in-flight AutoCompany cognitive-loop run.

Source: `lightbulb/client.py:9430`.

##### `lightbulb.client.LightbulbClient.stream_chat`



~~~python
def stream_chat(domain: str, *, message: str, action: str | None=None, inputs: Dict[str, Any] | None=None, conversation_id: str | None=None, company_id: str | None=None) -> Generator[SSEEvent, None, None]
~~~


Stream a domain agent chat via Server-Sent Events.

Source: `lightbulb/client.py:3611`.

##### `lightbulb.client.LightbulbClient.stream_code_workspace_chat`



~~~python
def stream_code_workspace_chat(workspace_id: str, message: str, **kwargs: Any) -> Generator[SSEEvent, None, None]
~~~


Stream a coding agent chat as Server-Sent Events.

Source: `lightbulb/client.py:4685`.

##### `lightbulb.client.LightbulbClient.stream_document_builder_message`



~~~python
def stream_document_builder_message(session_id: str, content: str) -> Generator[SSEEvent, None, None]
~~~


Stream a document builder message via SSE.

Source: `lightbulb/client.py:4751`.

##### `lightbulb.client.LightbulbClient.stream_page_builder_message`



~~~python
def stream_page_builder_message(session_id: str, content: str) -> Generator[SSEEvent, None, None]
~~~


Stream a page builder message via SSE (token-by-token output).

Source: `lightbulb/client.py:4714`.

##### `lightbulb.client.LightbulbClient.stream_page_builder_workspace_automation`



~~~python
def stream_page_builder_workspace_automation(session_id: str, body: Dict[str, Any] | None=None) -> Generator[SSEEvent, None, None]
~~~


Stream the page-builder workspace automation pipeline.

Source: `lightbulb/client.py:4733`.

##### `lightbulb.client.LightbulbClient.submit_code_workspace_proposal`



~~~python
def submit_code_workspace_proposal(workspace_id: str, body: Dict[str, Any]) -> Dict[str, Any]
~~~


Submit a code-change proposal (diff + summary).

Source: `lightbulb/client.py:8985`.

##### `lightbulb.client.LightbulbClient.submit_project_creation_preflight_feedback`



~~~python
def submit_project_creation_preflight_feedback(receipt: ProjectCreationPreflightReceipt, *, helpfulness: SemanticFeedbackValue, calibrated_criticality: SemanticFeedbackValue, factual_grounding: SemanticFeedbackValue, idempotency_key: str) -> ProjectPreflightSemanticFeedbackReceipt
~~~


Submit one explicit human judgment for this preflight's episode.

Source: `lightbulb/client.py:4634`.

##### `lightbulb.client.LightbulbClient.sync_workflow_improvement_report`



~~~python
def sync_workflow_improvement_report(report: Dict[str, Any], *, idempotency_key: str | None=None) -> Dict[str, Any]
~~~


Persist one local evaluator report in the authenticated scoped ledger.

Source: `lightbulb/client.py:6053`.

##### `lightbulb.client.LightbulbClient.test_agent_runtime_config`



~~~python
def test_agent_runtime_config(agent_type: str='coding', *, message: str | None=None, company_id: str | None=None) -> Dict[str, Any]
~~~


Resolve the configured runtime path without performing code or connector writes.

Source: `lightbulb/client.py:3157`.

##### `lightbulb.client.LightbulbClient.trigger_workflow`



~~~python
def trigger_workflow(workflow_type: str, objective: str, *, inputs: Dict[str, Any] | None=None, company_id: str | None=None) -> Dict[str, Any]
~~~


Run a published workflow resolved by its public ``workflowType`` ref.

Source: `lightbulb/client.py:6486`.

##### `lightbulb.client.LightbulbClient.uninstall_marketplace_action`



~~~python
def uninstall_marketplace_action(installation_id: str, *, idempotency_key: str, reason: str='') -> Dict[str, Any]
~~~


Uninstall an action from the selected company.

Source: `lightbulb/client.py:8285`.

##### `lightbulb.client.LightbulbClient.update_crm_task`



~~~python
def update_crm_task(task_id: str, body: Dict[str, Any], tenant_id: str | None=None) -> Dict[str, Any]
~~~


Update a CRM task.

Source: `lightbulb/client.py:9883`.

##### `lightbulb.client.LightbulbClient.validate_aoc_run_config`



~~~python
def validate_aoc_run_config(run_id: str) -> Dict[str, Any]
~~~


Validate an AutoCompany run's configuration.

Source: `lightbulb/client.py:9441`.

##### `lightbulb.client.LightbulbClient.validate_business_workflow`



~~~python
def validate_business_workflow(definition: Dict[str, Any]) -> Dict[str, Any]
~~~


Validate a portable workflow definition without network calls.

Source: `lightbulb/client.py:5922`.

##### `lightbulb.client.LightbulbClient.validate_sdk_project`



~~~python
def validate_sdk_project(project: Any, *, registry: Any=None) -> Dict[str, Any]
~~~


Validate a custom project against executable primitive implementations.

Source: `lightbulb/client.py:5783`.

##### `lightbulb.client.LightbulbClient.wait_for_marketplace_action_publication`



~~~python
def wait_for_marketplace_action_publication(publication_id: str, *, timeout_seconds: float=120.0, poll_interval_seconds: float=2.0) -> Dict[str, Any]
~~~


Poll until publication is READY, FAILED, or ARCHIVED, within hard bounds.

Source: `lightbulb/client.py:8142`.

##### `lightbulb.client.LightbulbClient.wait_for_workflow_instance`



~~~python
def wait_for_workflow_instance(trace_id: str, *, company_id: str | None=None, timeout: float=300.0, poll_interval: float=1.0) -> Dict[str, Any]
~~~


Poll a workflow until it stops or requires human approval.

Source: `lightbulb/client.py:3581`.

##### `lightbulb.client.LightbulbClient.whoami`



~~~python
def whoami() -> Dict[str, Any]
~~~


Get the current user's identity, role, tenant, company, and permissions.

Source: `lightbulb/client.py:2709`.

##### `lightbulb.client.LightbulbClient.workspace_bundle`



~~~python
def workspace_bundle(domain: str) -> Dict[str, Any]
~~~


Get a domain workspace data bundle (state, surfaces, recent runs).

Source: `lightbulb/client.py:9983`.

##### `lightbulb.client.LightbulbClient.workspace_conversation`



~~~python
def workspace_conversation(domain: str, conversation_id: str) -> Dict[str, Any]
~~~


Get a domain workspace conversation.

Source: `lightbulb/client.py:10005`.

##### `lightbulb.client.LightbulbClient.workspace_surface`



~~~python
def workspace_surface(domain: str, surface: str, **filters: Any) -> Dict[str, Any]
~~~


Read a domain workspace surface (e.g. internal_suite, live connector).

Source: `lightbulb/client.py:10018`.

##### `lightbulb.client.LightbulbClient.workspace_trace`



~~~python
def workspace_trace(domain: str, trace_id: str) -> Dict[str, Any]
~~~


Get a workspace trace (full agent execution log).

Source: `lightbulb/client.py:9994`.

## Module `lightbulb.commercial_controls`

Deterministic commercial controls for quote-to-revenue workflows.

### `lightbulb.commercial_controls.CommercialControlPolicy`

class. Source: `lightbulb/commercial_controls.py:261`.

Fields:
- `evidence: CommercialEvidencePolicy = Field(default_factory=CommercialEvidencePolicy)`
- `quote_approval_discount_threshold: Decimal = Field(default=Decimal('0.250000'), ge=0, le=1)`
- `amount_tolerance: Decimal = Field(default=Decimal('0.000000'), ge=0)`
- `renewal_horizon_days: int = Field(default=120, ge=1, le=730)`
- `require_partner_deal_registration: bool = True`

### `lightbulb.commercial_controls.QuoteOrderContractControlsInput`

class. Source: `lightbulb/commercial_controls.py:834`.

Fields:
- `schema_id: Literal['lightbulb.commercial_quote_order_contract_controls_input.v1'] = Field(default=COMMERCIAL_CONTROL_INPUT_SCHEMA, alias='schema')`
- `evaluation_ref: OpaqueRef`
- `analysis_as_of: str`
- `account_ref: OpaqueRef`
- `configuration: CommercialConfigurationSnapshot`
- `quote: CommercialQuoteSnapshot`
- `order: CommercialOrderSnapshot`
- `contract: CommercialContractSnapshot`
- `subscription: CommercialSubscriptionSnapshot`
- `usage_billing: CommercialUsageBillingSnapshot`
- `renewal: CommercialRenewalSnapshot`
- `channel_authorization: CommercialChannelAuthorizationSnapshot`
- `commission_basis: CommercialCommissionBasisSnapshot`
- `revenue_ops_handoff: CommercialRevenueOpsHandoffSnapshot`
- `policy: CommercialControlPolicy = Field(default_factory=CommercialControlPolicy)`
- `evidence_refs: tuple[PrimitiveEvidenceRef, ...] = Field(default_factory=tuple, max_length=500)`

### `lightbulb.commercial_controls.CommercialEffectBoundary`

class. Source: `lightbulb/commercial_controls.py:910`.

Fields:
- `connector_reads: Literal[0] = 0`
- `connector_writes: Literal[0] = 0`
- `approvals_consumed: Literal[0] = 0`
- `quote_mutated: Literal[False] = False`
- `order_mutated: Literal[False] = False`
- `contract_mutated: Literal[False] = False`
- `billing_mutated: Literal[False] = False`
- `entitlement_mutated: Literal[False] = False`
- `commission_mutated: Literal[False] = False`
- `renewal_mutated: Literal[False] = False`
- `partner_authorization_mutated: Literal[False] = False`
- `revenue_ops_handoff_mutated: Literal[False] = False`
- `quote_authorized: Literal[False] = False`
- `order_authorized: Literal[False] = False`
- `contract_authorized: Literal[False] = False`
- `billing_authorized: Literal[False] = False`
- `entitlement_authorized: Literal[False] = False`
- `commission_authorized: Literal[False] = False`
- `external_systems_changed: Literal[False] = False`
- `spring_system_of_record_authority_required: Literal[True] = True`
- `spring_rbac_approval_audit_required: Literal[True] = True`

### `lightbulb.commercial_controls.QuoteOrderContractControlsProposal`

class. Source: `lightbulb/commercial_controls.py:945`.

Fields:
- `schema_id: Literal['lightbulb.commercial_quote_order_contract_controls_proposal.v1'] = Field(default=COMMERCIAL_CONTROL_PROPOSAL_SCHEMA, alias='schema')`
- `evaluation_ref: OpaqueRef`
- `account_ref: OpaqueRef`
- `evaluated_at: str`
- `proposed_disposition: CommercialDisposition`
- `gates: tuple[CommercialGateResult, ...]`
- `findings: tuple[CommercialControlFinding, ...] = Field(max_length=5000)`
- `pass_gate_count: int = Field(ge=0, le=len(_GATE_ORDER))`
- `review_gate_count: int = Field(ge=0, le=len(_GATE_ORDER))`
- `fail_gate_count: int = Field(ge=0, le=len(_GATE_ORDER))`
- `indeterminate_gate_count: int = Field(ge=0, le=len(_GATE_ORDER))`
- `next_actions: tuple[ShortText, ...] = Field(default_factory=tuple, max_length=50)`
- `source_snapshot_digests: dict[str, Sha256Digest]`
- `evidence_refs: tuple[PrimitiveEvidenceRef, ...] = Field(max_length=500)`
- `operation_spec: PrimitiveOperationSpec`
- `operation_digest: Sha256Digest`
- `evidence_digest: Sha256Digest`
- `quote_mutated: Literal[False] = False`
- `order_mutated: Literal[False] = False`
- `contract_mutated: Literal[False] = False`
- `billing_mutated: Literal[False] = False`
- `entitlement_mutated: Literal[False] = False`
- `commission_mutated: Literal[False] = False`
- `quote_authorized: Literal[False] = False`
- `order_authorized: Literal[False] = False`
- `contract_authorized: Literal[False] = False`
- `billing_authorized: Literal[False] = False`
- `entitlement_authorized: Literal[False] = False`
- `commission_authorized: Literal[False] = False`
- `effect_boundary: CommercialEffectBoundary = Field(default_factory=CommercialEffectBoundary)`
- `proposal_digest: Sha256Digest = _ZERO_DIGEST`

### `lightbulb.commercial_controls.evaluate_quote_order_contract_controls`

function. Source: `lightbulb/commercial_controls.py:2558`.



~~~python
evaluate_quote_order_contract_controls(value: QuoteOrderContractControlsInput | Mapping[str, Any]) -> QuoteOrderContractControlsProposal
~~~


Evaluate quote-to-revenue controls without mutation or authorization.

### `lightbulb.commercial_controls.EvaluateQuoteOrderContractControlsPrimitive`

class. Source: `lightbulb/commercial_controls.py:2890`.

#### Methods

##### `lightbulb.commercial_controls.EvaluateQuoteOrderContractControlsPrimitive.implementation_contract`



~~~python
def implementation_contract() -> dict[str, Any]
~~~


Source: `lightbulb/commercial_controls.py:2914`.

## Module `lightbulb.commercial_operations_lifecycle`

Deterministic commercial-operations lifecycle materialization.

### `lightbulb.commercial_operations_lifecycle.CommercialLifecycleScope`

class. Source: `lightbulb/commercial_operations_lifecycle.py:367`.

Exact portable identity fence; Spring authenticates every value.

Fields:
- `tenant_ref: OpaqueRef`
- `company_ref: OpaqueRef`
- `project_ref: OpaqueRef`
- `project_id: UUID`
- `customer_ref: OpaqueRef`
- `product_ref: OpaqueRef`
- `currency: CurrencyCode`

### `lightbulb.commercial_operations_lifecycle.commercial_scope_digest`

function. Source: `lightbulb/commercial_operations_lifecycle.py:394`.



~~~python
commercial_scope_digest(scope: CommercialLifecycleScope) -> str
~~~


### `lightbulb.commercial_operations_lifecycle.ProposeQuoteCommand`

class. Source: `lightbulb/commercial_operations_lifecycle.py:578`.

Fields:
- `schema_id: Literal['lightbulb.commercial_propose_quote_command.v1'] = Field(default='lightbulb.commercial_propose_quote_command.v1', alias='schema')`
- `kind: Literal['propose_quote'] = 'propose_quote'`
- `configuration: _ControlledConfiguration`
- `quote: _ControlledQuote`
- `configured_by_ref: OpaqueRef`
- `configuration_evidence_ref: OpaqueRef`
- `pricing_evidence_ref: OpaqueRef`

### `lightbulb.commercial_operations_lifecycle.ReviewContractOrderCommand`

class. Source: `lightbulb/commercial_operations_lifecycle.py:691`.

Fields:
- `schema_id: Literal['lightbulb.commercial_review_contract_order_command.v1'] = Field(default='lightbulb.commercial_review_contract_order_command.v1', alias='schema')`
- `kind: Literal['review_contract_order'] = 'review_contract_order'`
- `reviewed_quote: _ControlledQuote`
- `order: _ControlledOrder`
- `contract: _ControlledContract`
- `quote_approved_by_ref: OpaqueRef`
- `order_reviewed_by_ref: OpaqueRef`
- `contract_reviewed_by_ref: OpaqueRef`
- `quote_approval_evidence_ref: OpaqueRef`
- `order_review_evidence_ref: OpaqueRef`
- `contract_signature_evidence_ref: OpaqueRef`

### `lightbulb.commercial_operations_lifecycle.ActivateSubscriptionCommand`

class. Source: `lightbulb/commercial_operations_lifecycle.py:780`.

Fields:
- `schema_id: Literal['lightbulb.commercial_activate_subscription_command.v2'] = Field(default='lightbulb.commercial_activate_subscription_command.v2', alias='schema')`
- `kind: Literal['activate_subscription'] = 'activate_subscription'`
- `subscription_revision: int = Field(ge=1)`
- `subscription: _ControlledSubscription`
- `hybrid_recurring_basis: Literal['flat', 'seat'] | None = None`
- `activated_by_ref: OpaqueRef`
- `entitlement_reviewed_by_ref: OpaqueRef`
- `entitlement_evidence_ref: OpaqueRef`

### `lightbulb.commercial_operations_lifecycle.CommercialRecurringBillingLine`

class. Source: `lightbulb/commercial_operations_lifecycle.py:827`.

One deterministic fixed or seat component linked to an order line.

Fields:
- `billing_line_ref: OpaqueRef`
- `order_line_ref: OpaqueRef`
- `quantity: Decimal = Field(gt=0)`
- `unit_rate: Decimal = Field(ge=0)`
- `amount: Decimal = Field(ge=0)`

### `lightbulb.commercial_operations_lifecycle.CommercialRecurringBillingProposal`

class. Source: `lightbulb/commercial_operations_lifecycle.py:850`.

Closed-period recurring proposal; never an invoice or authoritative write.

Fields:
- `schema_id: Literal['lightbulb.commercial_recurring_billing_proposal.v1'] = Field(default='lightbulb.commercial_recurring_billing_proposal.v1', alias='schema')`
- `billing_ref: OpaqueRef`
- `subscription_ref: OpaqueRef`
- `order_ref: OpaqueRef`
- `account_ref: OpaqueRef`
- `billing_basis: Literal['flat', 'seat']`
- `period_start: str`
- `period_end: str`
- `status: Literal['validated']`
- `currency: CurrencyCode`
- `lines: tuple[CommercialRecurringBillingLine, ...] = Field(min_length=1, max_length=5000)`
- `total: Decimal = Field(ge=0)`
- `evidence_refs: tuple[OpaqueRef, ...] = Field(min_length=2, max_length=20)`

### `lightbulb.commercial_operations_lifecycle.ProposeUsageBillingCommand`

class. Source: `lightbulb/commercial_operations_lifecycle.py:940`.

Fields:
- `schema_id: Literal['lightbulb.commercial_propose_usage_billing_command.v2'] = Field(default='lightbulb.commercial_propose_usage_billing_command.v2', alias='schema')`
- `kind: Literal['propose_usage_billing'] = 'propose_usage_billing'`
- `usage_batch_revision: int = Field(ge=1)`
- `usage_billing: _ControlledUsage`
- `recurring_billing_revision: int | None = Field(default=None, ge=1)`
- `recurring_billing: _ControlledRecurringBilling | None = None`
- `source_event_bindings: tuple[UsageSourceBinding, ...] = Field(min_length=1, max_length=20000)`
- `usage_recorded_by_ref: OpaqueRef`
- `rated_by_ref: OpaqueRef`
- `billing_reviewed_by_ref: OpaqueRef`
- `recurring_priced_by_ref: OpaqueRef | None = None`
- `usage_source_evidence_ref: OpaqueRef`
- `rating_evidence_ref: OpaqueRef`
- `recurring_pricing_evidence_ref: OpaqueRef | None = None`

### `lightbulb.commercial_operations_lifecycle.ProposeRecurringBillingCommand`

class. Source: `lightbulb/commercial_operations_lifecycle.py:1132`.

Fields:
- `schema_id: Literal['lightbulb.commercial_propose_recurring_billing_command.v1'] = Field(default='lightbulb.commercial_propose_recurring_billing_command.v1', alias='schema')`
- `kind: Literal['propose_recurring_billing'] = 'propose_recurring_billing'`
- `billing_revision: int = Field(ge=1)`
- `recurring_billing: _ControlledRecurringBilling`
- `priced_by_ref: OpaqueRef`
- `billing_reviewed_by_ref: OpaqueRef`
- `pricing_evidence_ref: OpaqueRef`
- `billing_evidence_ref: OpaqueRef`

### `lightbulb.commercial_operations_lifecycle.PrepareRenewalCommand`

class. Source: `lightbulb/commercial_operations_lifecycle.py:1196`.

Fields:
- `schema_id: Literal['lightbulb.commercial_prepare_renewal_command.v1'] = Field(default='lightbulb.commercial_prepare_renewal_command.v1', alias='schema')`
- `kind: Literal['prepare_renewal'] = 'prepare_renewal'`
- `renewal_revision: int = Field(ge=1)`
- `renewal: _ControlledRenewal`
- `renewal_configuration: _ControlledConfiguration`
- `renewal_quote: _ControlledQuote`
- `proposed_renewal_total: Decimal = Field(ge=0)`
- `currency: CurrencyCode`
- `prepared_by_ref: OpaqueRef`
- `reviewed_by_ref: OpaqueRef`
- `renewal_pricing_evidence_ref: OpaqueRef`
- `renewal_review_evidence_ref: OpaqueRef`

### `lightbulb.commercial_operations_lifecycle.AttributeChannelCommand`

class. Source: `lightbulb/commercial_operations_lifecycle.py:1330`.

Fields:
- `schema_id: Literal['lightbulb.commercial_attribute_channel_command.v1'] = Field(default='lightbulb.commercial_attribute_channel_command.v1', alias='schema')`
- `kind: Literal['attribute_channel'] = 'attribute_channel'`
- `attribution_revision: int = Field(ge=1)`
- `channel_authorization: _ControlledChannel`
- `attribution_ratio: Decimal = Field(gt=0, le=1)`
- `attributed_by_ref: OpaqueRef`
- `authorized_by_ref: OpaqueRef`
- `channel_evidence_ref: OpaqueRef`

### `lightbulb.commercial_operations_lifecycle.PrepareCommissionRevOpsHandoffCommand`

class. Source: `lightbulb/commercial_operations_lifecycle.py:1373`.

Fields:
- `schema_id: Literal['lightbulb.commercial_prepare_commission_revops_handoff_command.v1'] = Field(default='lightbulb.commercial_prepare_commission_revops_handoff_command.v1', alias='schema')`
- `kind: Literal['prepare_commission_revops_handoff'] = 'prepare_commission_revops_handoff'`
- `commission_revision: int = Field(ge=1)`
- `handoff_revision: int = Field(ge=1)`
- `commission_basis: _ControlledCommission`
- `commission_rate: Decimal = Field(ge=0, le=1)`
- `proposed_commission_amount: Decimal = Field(ge=0)`
- `revenue_ops_handoff: _ControlledHandoff`
- `commission_prepared_by_ref: OpaqueRef`
- `commission_approved_by_ref: OpaqueRef`
- `commission_plan_evidence_ref: OpaqueRef`
- `commission_evidence_ref: OpaqueRef`
- `handoff_evidence_ref: OpaqueRef`

### `lightbulb.commercial_operations_lifecycle.commercial_command_evidence_digest`

function. Source: `lightbulb/commercial_operations_lifecycle.py:1544`.



~~~python
commercial_command_evidence_digest(command: BaseModel | Mapping[str, Any]) -> str
~~~


Digest normalized command content without its circular evidence envelope.

### `lightbulb.commercial_operations_lifecycle.commercial_command_digest`

function. Source: `lightbulb/commercial_operations_lifecycle.py:1572`.



~~~python
commercial_command_digest(command: BaseModel | Mapping[str, Any]) -> str
~~~


Digest every normalized command field except its self-describing digest.

### `lightbulb.commercial_operations_lifecycle.seal_commercial_command`

function. Source: `lightbulb/commercial_operations_lifecycle.py:1594`.



~~~python
seal_commercial_command(command: Mapping[str, Any]) -> dict[str, Any]
~~~


Normalize and validate a command, then seal its exact request digest.

### `lightbulb.commercial_operations_lifecycle.CommercialTransitionCandidate`

class. Source: `lightbulb/commercial_operations_lifecycle.py:1623`.

Fields:
- `schema_id: Literal['lightbulb.commercial_transition_candidate.v2'] = Field(default='lightbulb.commercial_transition_candidate.v2', alias='schema')`
- `to_version: int = Field(ge=1, le=MAX_COMMERCIAL_TRANSITIONS)`
- `scope_digest: Sha256Digest`
- `command_content_digest: Sha256Digest`
- `evidence_digest: Sha256Digest`
- `command: CommercialLifecycleCommand`

### `lightbulb.commercial_operations_lifecycle.CommercialOperationsLifecycleSnapshot`

class. Source: `lightbulb/commercial_operations_lifecycle.py:1723`.

Fields:
- `schema_id: Literal['lightbulb.commercial_operations_lifecycle_snapshot.v2'] = Field(default=COMMERCIAL_LIFECYCLE_SNAPSHOT_SCHEMA, alias='schema')`
- `scope: CommercialLifecycleScope`
- `status: CommercialLifecycleStatus`
- `version: int = Field(ge=1, le=MAX_COMMERCIAL_TRANSITIONS)`
- `transition_history: tuple[CommercialTransitionCandidate, ...] = Field(min_length=1, max_length=MAX_COMMERCIAL_TRANSITIONS)`
- `configuration: _ControlledConfiguration`
- `quote: _ControlledQuote`
- `order: _ControlledOrder | None = None`
- `contract: _ControlledContract | None = None`
- `subscription: _ControlledSubscription | None = None`
- `recurring_billing_proposal: _ControlledRecurringBilling | None = None`
- `usage_billing_proposal: _ControlledUsage | None = None`
- `renewal: _ControlledRenewal | None = None`
- `renewal_configuration: _ControlledConfiguration | None = None`
- `renewal_quote: _ControlledQuote | None = None`
- `channel_attribution: _ControlledChannel | None = None`
- `commission_basis_proposal: _ControlledCommission | None = None`
- `revenue_ops_handoff_proposal: _ControlledHandoff | None = None`
- `state_digest: Sha256Digest`

### `lightbulb.commercial_operations_lifecycle.CommercialOperationsLifecycleInput`

class. Source: `lightbulb/commercial_operations_lifecycle.py:1846`.

Fields:
- `schema_id: Literal['lightbulb.commercial_operations_lifecycle_input.v2'] = Field(default=COMMERCIAL_LIFECYCLE_INPUT_SCHEMA, alias='schema')`
- `scope: CommercialLifecycleScope`
- `command: CommercialLifecycleCommand`
- `current_snapshot: CommercialOperationsLifecycleSnapshot | None = None`

### `lightbulb.commercial_operations_lifecycle.CommercialTransitionRecovery`

class. Source: `lightbulb/commercial_operations_lifecycle.py:1880`.

Fields:
- `disposition: RecoveryDisposition`
- `automatic_retry_allowed: Literal[False] = False`
- `instructions: str | None = Field(default=None, min_length=1, max_length=500)`

### `lightbulb.commercial_operations_lifecycle.CommercialTransitionReceipt`

class. Source: `lightbulb/commercial_operations_lifecycle.py:1896`.

Fields:
- `schema_id: Literal['lightbulb.commercial_operations_transition_receipt.v2'] = Field(default=COMMERCIAL_TRANSITION_RECEIPT_SCHEMA, alias='schema')`
- `transition_ref: OpaqueRef`
- `idempotency_key: OpaqueRef`
- `request_digest: Sha256Digest`
- `command_kind: str`
- `status: Literal['candidate_materialized', 'rejected', 'in_doubt']`
- `from_version: int = Field(ge=0, le=MAX_COMMERCIAL_TRANSITIONS)`
- `to_version: int = Field(ge=0, le=MAX_COMMERCIAL_TRANSITIONS)`
- `from_snapshot_digest: Sha256Digest`
- `to_snapshot_digest: Sha256Digest`
- `evidence_digest: Sha256Digest`
- `rejection_code: str | None = Field(default=None, min_length=1, max_length=120)`
- `recovery: CommercialTransitionRecovery`
- `live_systems_changed: Literal[False] = False`
- `authoritative_write_authorized: Literal[False] = False`
- `pricing_or_booking_written: Literal[False] = False`
- `contract_or_billing_written: Literal[False] = False`
- `commission_written: Literal[False] = False`

### `lightbulb.commercial_operations_lifecycle.CommercialOperationsLifecycleResult`

class. Source: `lightbulb/commercial_operations_lifecycle.py:1948`.

Fields:
- `schema_id: Literal['lightbulb.commercial_operations_lifecycle_result.v2'] = Field(default=COMMERCIAL_LIFECYCLE_RESULT_SCHEMA, alias='schema')`
- `candidate_validated: bool`
- `evaluated_command: CommercialLifecycleCommand`
- `snapshot: CommercialOperationsLifecycleSnapshot | None = None`
- `transition_receipt: CommercialTransitionReceipt`

### `lightbulb.commercial_operations_lifecycle.materialize_commercial_operations_candidate`

function. Source: `lightbulb/commercial_operations_lifecycle.py:3153`.



~~~python
materialize_commercial_operations_candidate(inputs: CommercialOperationsLifecycleInput | Mapping[str, Any]) -> CommercialOperationsLifecycleResult
~~~


Materialize exactly one bounded SDK-only commercial transition.

### `lightbulb.commercial_operations_lifecycle.ProposeCommercialOperationsTransitionPrimitive`

class. Source: `lightbulb/commercial_operations_lifecycle.py:3353`.

Fields:
- `example_inputs: Mapping[str, Any] = _commercial_lifecycle_example_inputs()`

#### Methods

##### `lightbulb.commercial_operations_lifecycle.ProposeCommercialOperationsTransitionPrimitive.execute`



~~~python
def execute(context: PrimitiveExecutionContext, inputs: CommercialOperationsLifecycleInput | Mapping[str, Any]) -> PrimitiveExecutionResult[CommercialOperationsLifecycleResult]
~~~


Keep canonical nested Decimal validation independent of host context.

Source: `lightbulb/commercial_operations_lifecycle.py:3379`.

##### `lightbulb.commercial_operations_lifecycle.ProposeCommercialOperationsTransitionPrimitive.implementation_contract`



~~~python
def implementation_contract() -> dict[str, Any]
~~~


Source: `lightbulb/commercial_operations_lifecycle.py:3389`.

## Module `lightbulb.communication_channel_observation`

Fresh bounded Slack/Teams observation on the shared communication rail.

### `lightbulb.communication_channel_observation.SlackConversationMessage`

class. Source: `lightbulb/communication_channel_observation.py:93`.

Fields:
- `message_ts: str = Field(alias='messageTs', pattern='^[0-9]{1,20}\\.[0-9]{6}$')`
- `thread_ts: str = Field(alias='threadTs', pattern='^[0-9]{1,20}\\.[0-9]{6}$')`
- `sender_kind: Literal['user', 'bot'] = Field(alias='senderKind')`
- `sender_ref: str = Field(alias='senderRef', min_length=1, max_length=64)`
- `text: str = Field(max_length=2000)`
- `text_sha256: str = Field(alias='textSha256', pattern='^[0-9a-f]{64}$')`
- `text_truncated: bool = Field(alias='textTruncated')`

### `lightbulb.communication_channel_observation.SlackConversationThreadOutput`

class. Source: `lightbulb/communication_channel_observation.py:103`.

Fields:
- `schema_id: Literal['lightbulb.slack_conversation_thread.v1'] = Field(alias='schema')`
- `channel_id: str = Field(alias='channelId', pattern='^C[A-Z0-9]{1,31}$')`
- `thread_ts: str = Field(alias='threadTs', pattern='^[0-9]{1,20}\\.[0-9]{6}$')`
- `returned_message_count: int = Field(alias='returnedMessageCount', ge=1, le=10)`
- `truncated: bool`
- `private_data: Literal[True] = Field(alias='privateData')`
- `retention: Literal['ephemeral_response_only']`
- `messages: tuple[SlackConversationMessage, ...] = Field(min_length=1, max_length=10)`

### `lightbulb.communication_channel_observation.TeamsChannelMessage`

class. Source: `lightbulb/communication_channel_observation.py:132`.

Fields:
- `message_id: str = Field(alias='messageId', min_length=1, max_length=512)`
- `thread_message_id: str = Field(alias='threadMessageId', min_length=1, max_length=512)`
- `turn_kind: Literal['root', 'reply'] = Field(alias='turnKind')`
- `sender_kind: Literal['user', 'application', 'device'] = Field(alias='senderKind')`
- `sender_ref: str = Field(alias='senderRef', min_length=1, max_length=512)`
- `content_type: Literal['text', 'html'] = Field(alias='contentType')`
- `content: str = Field(max_length=2000)`
- `content_sha256: str = Field(alias='contentSha256', pattern='^[0-9a-f]{64}$')`
- `content_truncated: bool = Field(alias='contentTruncated')`
- `created_date_time: str | None = Field(default=None, alias='createdDateTime', min_length=1, max_length=128)`

### `lightbulb.communication_channel_observation.TeamsChannelThreadOutput`

class. Source: `lightbulb/communication_channel_observation.py:167`.

Fields:
- `schema_id: Literal['lightbulb.teams_channel_thread.v1'] = Field(alias='schema')`
- `team_id: str = Field(alias='teamId')`
- `channel_id: str = Field(alias='channelId', min_length=1, max_length=512)`
- `thread_message_id: str = Field(alias='threadMessageId', min_length=1, max_length=512)`
- `returned_message_count: int = Field(alias='returnedMessageCount', ge=1, le=10)`
- `truncated: bool`
- `private_data: Literal[True] = Field(alias='privateData')`
- `retention: Literal['ephemeral_response_only']`
- `messages: tuple[TeamsChannelMessage, ...] = Field(min_length=1, max_length=10)`

### `lightbulb.communication_channel_observation.CommunicationChannelObservationStatus`

class. Source: `lightbulb/communication_channel_observation.py:219`.

### `lightbulb.communication_channel_observation.CommunicationChannelObservationResult`

class. Source: `lightbulb/communication_channel_observation.py:224`.

Fields:
- `schema_id: Literal['lightbulb.communication_channel_observation_result.v1'] = Field(default=COMMUNICATION_CHANNEL_OBSERVATION_RESULT_SCHEMA, alias='schema')`
- `platform: CommunicationChannel`
- `status: CommunicationChannelObservationStatus`
- `read_request_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `read_provenance_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `read_receipt_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `read_completed_at: str`
- `provider_message_count: int = Field(ge=1, le=10)`
- `returned_message_count: int = Field(ge=1, le=10)`
- `outbound_observed: Literal[True] = True`
- `human_read_claimed: Literal[False] = False`
- `delivery_claimed: Literal[False] = False`
- `provider_event: CommunicationProviderEvent | None = None`
- `trace: CommunicationTraceResult | None = None`

### `lightbulb.communication_channel_observation.SlackCommunicationObserver`

class. Source: `lightbulb/communication_channel_observation.py:812`.

### `lightbulb.communication_channel_observation.TeamsCommunicationObserver`

class. Source: `lightbulb/communication_channel_observation.py:817`.

## Module `lightbulb.communication_channels`

Sealed Slack and Teams turns on the shared communication authority rail.

### `lightbulb.communication_channels.communication_channel_private_identifier_commitment`

function. Source: `lightbulb/communication_channels.py:118`.



~~~python
communication_channel_private_identifier_commitment(*, scope: DynamicWorkflowScope, key_id: str, scope_keyring: CommunicationScopeKeyRing, platform: CommunicationChannel, identifier_kind: str, value: str) -> str
~~~


Return an unlinkable tenant/company-scoped provider-ID commitment.

### `lightbulb.communication_channels.communication_channel_endpoint_address_commitment`

function. Source: `lightbulb/communication_channels.py:148`.



~~~python
communication_channel_endpoint_address_commitment(*, scope: DynamicWorkflowScope, endpoint_ref: str, address: str, channel: CommunicationChannel, key_id: str, scope_keyring: CommunicationScopeKeyRing) -> str
~~~


Bind one private provider actor ID to a sealed channel endpoint.

### `lightbulb.communication_channels.communication_channel_private_value_commitment`

function. Source: `lightbulb/communication_channels.py:176`.



~~~python
communication_channel_private_value_commitment(*, scope: DynamicWorkflowScope, key_id: str, scope_keyring: CommunicationScopeKeyRing, platform: CommunicationChannel, value_kind: str, value: str) -> str
~~~


Key a bounded private payload/content commitment by tenant and company.

### `lightbulb.communication_channels.communication_channel_target_digest`

function. Source: `lightbulb/communication_channels.py:245`.



~~~python
communication_channel_target_digest(*, platform: CommunicationChannel, team_commitment: str | None, channel_commitment: str, root_message_commitment: str) -> str
~~~


### `lightbulb.communication_channels.communication_channel_message_digest`

function. Source: `lightbulb/communication_channels.py:263`.



~~~python
communication_channel_message_digest(message_commitment: str) -> str
~~~


### `lightbulb.communication_channels.CommunicationChannelWriteRoute`

class. Source: `lightbulb/communication_channels.py:272`.

Fields:
- `schema_id: Literal['lightbulb.communication_channel_write_route.v1'] = Field(default=COMMUNICATION_CHANNEL_WRITE_ROUTE_SCHEMA, alias='schema')`
- `platform: CommunicationChannel`
- `project_id: UUID`
- `project_ref: str = Field(min_length=1, max_length=160)`
- `connector_account_ref: str = Field(min_length=1, max_length=200)`
- `tenant_connector_id: UUID`
- `route_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `tool: str`
- `tool_version: int = Field(ge=1)`

### `lightbulb.communication_channels.CommunicationChannelReadRoute`

class. Source: `lightbulb/communication_channels.py:301`.

Fields:
- `schema_id: Literal['lightbulb.communication_channel_read_route.v1'] = Field(default=COMMUNICATION_CHANNEL_READ_ROUTE_SCHEMA, alias='schema')`
- `platform: CommunicationChannel`
- `project_id: UUID`
- `project_ref: str = Field(min_length=1, max_length=160)`
- `connector_account_ref: str = Field(min_length=1, max_length=200)`
- `tenant_connector_id: UUID`
- `route_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `tool: str`
- `tool_version: int = Field(ge=1)`

### `lightbulb.communication_channels.CommunicationChannelTurnBinding`

class. Source: `lightbulb/communication_channels.py:330`.

Sealed exact target, audience, content, and read/write route authority.

Fields:
- `schema_id: Literal['lightbulb.communication_channel_turn_binding.v1'] = Field(default=COMMUNICATION_CHANNEL_TURN_BINDING_SCHEMA, alias='schema')`
- `binding_ref: str = Field(min_length=1, max_length=200)`
- `platform: CommunicationChannel`
- `thread_ref: str = Field(min_length=1, max_length=200)`
- `thread_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `thread_version: int = Field(ge=1)`
- `thread_state: CommunicationThreadState`
- `thread_participant_party_refs: tuple[str, ...] = Field(min_length=2, max_length=100)`
- `draft_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `sender_endpoint_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `audience_party_ref: str = Field(min_length=1, max_length=200)`
- `audience_party_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `audience_endpoint_ref: str = Field(min_length=1, max_length=200)`
- `audience_endpoint_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `body_sha256: str = Field(pattern='^[0-9a-f]{64}$')`
- `project_id: UUID`
- `project_ref: str = Field(min_length=1, max_length=160)`
- `connector_account_ref: str = Field(min_length=1, max_length=200)`
- `tenant_connector_id: UUID`
- `write_route_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `read_route_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `write_tool: str`
- `write_tool_version: int = Field(ge=1)`
- `read_tool: str`
- `read_tool_version: int = Field(ge=1)`
- `provider_commitment_key_id: str = Field(min_length=8, max_length=80)`
- `team_id_hmac: str | None = Field(default=None, pattern='^[0-9a-f]{64}$')`
- `channel_id_hmac: str = Field(pattern='^[0-9a-f]{64}$')`
- `root_message_id_hmac: str = Field(pattern='^[0-9a-f]{64}$')`
- `provider_target_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `parent_message_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `bound_at: str`
- `human_read_claimed: Literal[False] = False`
- `delivery_claimed: Literal[False] = False`

### `lightbulb.communication_channels.CommunicationPrivateChannelTurn`

class. Source: `lightbulb/communication_channels.py:429`.

Transient approved content and provider target loaded by the host.

Fields:
- `schema_id: Literal['lightbulb.communication_private_channel_turn.v1'] = Field(default=COMMUNICATION_PRIVATE_CHANNEL_TURN_SCHEMA, alias='schema')`
- `platform: CommunicationChannel`
- `authority_binding_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `provider_target_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `parent_message_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `provider_commitment_key_id: str = Field(min_length=8, max_length=80)`
- `private_content_ref: str = Field(min_length=1, max_length=200)`
- `sender_endpoint_ref: str = Field(min_length=1, max_length=200)`
- `recipient_endpoint_ref: str = Field(min_length=1, max_length=200)`
- `recipient_address: str = Field(min_length=1, max_length=512, repr=False)`
- `team_id: str | None = Field(default=None, max_length=64, repr=False)`
- `channel_id: str = Field(min_length=1, max_length=512, repr=False)`
- `root_message_id: str = Field(min_length=1, max_length=512, repr=False)`
- `body: str = Field(min_length=1, max_length=40000, repr=False)`

### `lightbulb.communication_channels.CommunicationPrivateChannelDispatch`

class. Source: `lightbulb/communication_channels.py:474`.

Encrypted-outbox-only provider write result; never a durable journal value.

Fields:
- `schema_id: Literal['lightbulb.communication_private_channel_dispatch.v1'] = Field(default=COMMUNICATION_PRIVATE_CHANNEL_DISPATCH_SCHEMA, alias='schema')`
- `platform: CommunicationChannel`
- `authority_binding_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `provider_commitment_key_id: str = Field(min_length=8, max_length=80)`
- `provider_target_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `team_id: str | None = Field(default=None, max_length=64, repr=False)`
- `channel_id: str = Field(min_length=1, max_length=512, repr=False)`
- `root_message_id: str = Field(min_length=1, max_length=512, repr=False)`
- `provider_message_id: str = Field(min_length=1, max_length=512, repr=False)`
- `body_sha256: str = Field(pattern='^[0-9a-f]{64}$')`
- `accepted: Literal[True]`
- `provider_observed: Literal[True]`

### `lightbulb.communication_channels.CommunicationChannelPrivateResultCommitments`

class. Source: `lightbulb/communication_channels.py:515`.

Plaintext-safe validator companion for one encrypted private outbox row.

Fields:
- `schema_id: Literal['lightbulb.communication_channel_private_result_commitments.v1'] = Field(default=COMMUNICATION_CHANNEL_PRIVATE_RESULT_COMMITMENTS_SCHEMA, alias='schema')`
- `key_id: str = Field(min_length=8, max_length=80)`
- `platform: CommunicationChannel`
- `authority_binding_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `team_id_hmac: str | None = Field(default=None, pattern='^[0-9a-f]{64}$')`
- `channel_id_hmac: str = Field(pattern='^[0-9a-f]{64}$')`
- `root_message_id_hmac: str = Field(pattern='^[0-9a-f]{64}$')`
- `provider_message_id_hmac: str = Field(pattern='^[0-9a-f]{64}$')`
- `provider_target_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `provider_message_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `body_sha256: str = Field(pattern='^[0-9a-f]{64}$')`

### `lightbulb.communication_channels.communication_channel_private_result_commitments`

function. Source: `lightbulb/communication_channels.py:559`.



~~~python
communication_channel_private_result_commitments(private_dispatch: CommunicationPrivateChannelDispatch, *, authority_binding: CommunicationChannelTurnBinding, scope: DynamicWorkflowScope, scope_keyring: CommunicationScopeKeyRing) -> CommunicationChannelPrivateResultCommitments
~~~


Validate raw outbox plaintext and return only safe durable commitments.

### `lightbulb.communication_channels.communication_channel_private_dispatch_from_effect_output`

function. Source: `lightbulb/communication_channels.py:634`.



~~~python
communication_channel_private_dispatch_from_effect_output(output: Mapping[str, Any], *, authority_binding: CommunicationChannelTurnBinding | Mapping[str, Any], scope: DynamicWorkflowScope | Mapping[str, Any], scope_keyring: CommunicationScopeKeyRing) -> tuple[CommunicationPrivateChannelDispatch, CommunicationChannelPrivateResultCommitments]
~~~


Purely recover one exact encrypted channel dispatch from connector output.

### `lightbulb.communication_channels.CommunicationPrivateChannelInbound`

class. Source: `lightbulb/communication_channels.py:704`.

Transient fresh-read turn plus keyed commitments consumed by runtime.

Fields:
- `schema_id: Literal['lightbulb.communication_private_channel_inbound.v1'] = Field(default=COMMUNICATION_PRIVATE_CHANNEL_INBOUND_SCHEMA, alias='schema')`
- `platform: CommunicationChannel`
- `private_payload_ref: str = Field(min_length=1, max_length=200)`
- `private_content_ref: str = Field(min_length=1, max_length=200)`
- `provider_event_id: str = Field(min_length=1, max_length=512, repr=False)`
- `provider_message_id: str = Field(min_length=1, max_length=512, repr=False)`
- `provider_thread_id: str = Field(pattern='^[0-9a-f]{64}$', repr=False)`
- `in_reply_to_message_id: str = Field(min_length=1, max_length=512, repr=False)`
- `provider_event_hmac: str = Field(pattern='^[0-9a-f]{64}$')`
- `provider_message_hmac_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `parent_message_hmac_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `payload_hmac: str = Field(pattern='^[0-9a-f]{64}$')`
- `content_hmac: str = Field(pattern='^[0-9a-f]{64}$')`
- `sender_endpoint_ref: str = Field(min_length=1, max_length=200)`
- `sender_address: str = Field(min_length=1, max_length=512, repr=False)`
- `recipient_endpoint_ref: str = Field(min_length=1, max_length=200)`
- `recipient_address: str = Field(min_length=1, max_length=512, repr=False)`
- `subject: Literal[''] = ''`
- `body: str = Field(min_length=1, max_length=50000, repr=False)`
- `raw_payload: str = Field(min_length=1, max_length=1048576, repr=False)`
- `provider_occurred_at: str`

#### Methods

##### `lightbulb.communication_channels.CommunicationPrivateChannelInbound.content_digest`



~~~python
def content_digest() -> str
~~~


Source: `lightbulb/communication_channels.py:762`.

##### `lightbulb.communication_channels.CommunicationPrivateChannelInbound.parent_message_commitment`



~~~python
def parent_message_commitment() -> str
~~~


Source: `lightbulb/communication_channels.py:774`.

##### `lightbulb.communication_channels.CommunicationPrivateChannelInbound.payload_digest`



~~~python
def payload_digest() -> str
~~~


Source: `lightbulb/communication_channels.py:759`.

##### `lightbulb.communication_channels.CommunicationPrivateChannelInbound.provider_event_commitment`



~~~python
def provider_event_commitment() -> str
~~~


Source: `lightbulb/communication_channels.py:765`.

##### `lightbulb.communication_channels.CommunicationPrivateChannelInbound.provider_message_commitment`



~~~python
def provider_message_commitment() -> str
~~~


Source: `lightbulb/communication_channels.py:768`.

##### `lightbulb.communication_channels.CommunicationPrivateChannelInbound.provider_thread_commitment`



~~~python
def provider_thread_commitment() -> str
~~~


Source: `lightbulb/communication_channels.py:771`.

### `lightbulb.communication_channels.materialize_slack_communication_turn`

function. Source: `lightbulb/communication_channels.py:1121`.



~~~python
materialize_slack_communication_turn(**arguments: Any) -> CommunicationMaterializationResult
~~~


### `lightbulb.communication_channels.materialize_teams_communication_turn`

function. Source: `lightbulb/communication_channels.py:1128`.



~~~python
materialize_teams_communication_turn(**arguments: Any) -> CommunicationMaterializationResult
~~~


## Module `lightbulb.communication_contracts`

Privacy-minimised contracts for governed business communication.

### `lightbulb.communication_contracts.CommunicationPurpose`

class. Source: `lightbulb/communication_contracts.py:105`.

### `lightbulb.communication_contracts.CommunicationChannel`

class. Source: `lightbulb/communication_contracts.py:119`.

### `lightbulb.communication_contracts.CommunicationPartyKind`

class. Source: `lightbulb/communication_contracts.py:131`.

### `lightbulb.communication_contracts.CommunicationTrustGrade`

class. Source: `lightbulb/communication_contracts.py:140`.

### `lightbulb.communication_contracts.CommunicationAuthenticityGrade`

class. Source: `lightbulb/communication_contracts.py:149`.

### `lightbulb.communication_contracts.CommunicationThreadState`

class. Source: `lightbulb/communication_contracts.py:155`.

### `lightbulb.communication_contracts.CommunicationDataClassification`

class. Source: `lightbulb/communication_contracts.py:162`.

### `lightbulb.communication_contracts.CommunicationPolicyDisposition`

class. Source: `lightbulb/communication_contracts.py:169`.

### `lightbulb.communication_contracts.CommunicationConsentStatus`

class. Source: `lightbulb/communication_contracts.py:175`.

### `lightbulb.communication_contracts.CommunicationSuppressionStatus`

class. Source: `lightbulb/communication_contracts.py:182`.

### `lightbulb.communication_contracts.CommunicationQuietHoursStatus`

class. Source: `lightbulb/communication_contracts.py:188`.

### `lightbulb.communication_contracts.CommunicationFrequencyStatus`

class. Source: `lightbulb/communication_contracts.py:194`.

### `lightbulb.communication_contracts.CommunicationApprovalDisposition`

class. Source: `lightbulb/communication_contracts.py:200`.

### `lightbulb.communication_contracts.CommunicationDispatchState`

class. Source: `lightbulb/communication_contracts.py:205`.

### `lightbulb.communication_contracts.CommunicationProviderEventType`

class. Source: `lightbulb/communication_contracts.py:211`.

### `lightbulb.communication_contracts.CommunicationOutcomeDimension`

class. Source: `lightbulb/communication_contracts.py:225`.

### `lightbulb.communication_contracts.CommunicationTouchpointType`

class. Source: `lightbulb/communication_contracts.py:232`.

### `lightbulb.communication_contracts.CommunicationHandoffEffect`

class. Source: `lightbulb/communication_contracts.py:240`.

### `lightbulb.communication_contracts.communication_canonical_json`

function. Source: `lightbulb/communication_contracts.py:274`.



~~~python
communication_canonical_json(value: Any) -> bytes
~~~


Serialize supported values as deterministic, bounded JSON bytes.

### `lightbulb.communication_contracts.communication_canonical_digest`

function. Source: `lightbulb/communication_contracts.py:286`.



~~~python
communication_canonical_digest(value: Any) -> str
~~~


Return the canonical SHA-256 digest for a communication value.

### `lightbulb.communication_contracts.communication_private_value_digest`

function. Source: `lightbulb/communication_contracts.py:292`.



~~~python
communication_private_value_digest(value: str) -> str
~~~


Commit a private boundary value without retaining it in an artifact.

### `lightbulb.communication_contracts.CommunicationScopeKeyRing`

class. Source: `lightbulb/communication_contracts.py:324`.

Trusted host contract for exact-scope digests and HMAC signatures.

Fields:
- `active_key_id: str`

#### Methods

##### `lightbulb.communication_contracts.CommunicationScopeKeyRing.exact_scope_digest`



~~~python
def exact_scope_digest(*, key_id: str, scope: DynamicWorkflowScope) -> str
~~~


Source: `lightbulb/communication_contracts.py:329`.

##### `lightbulb.communication_contracts.CommunicationScopeKeyRing.sign`



~~~python
def sign(key_id: str, domain: str, payload: Any) -> bytes
~~~


Source: `lightbulb/communication_contracts.py:336`.

### `lightbulb.communication_contracts.CommunicationArtifact`

class. Source: `lightbulb/communication_contracts.py:339`.

Common integrity envelope for every durable communication artifact.

Fields:
- `schema_id: str = Field(alias='schema')`
- `receipt_key_id: str = Field(min_length=8, max_length=80, pattern=_KEY_ID_PATTERN)`
- `exact_scope_digest: Sha256Digest`
- `artifact_digest: Sha256Digest`
- `artifact_hmac: Sha256Digest`

#### Methods

##### `lightbulb.communication_contracts.CommunicationArtifact.digest_payload`



~~~python
def digest_payload() -> dict[str, Any]
~~~


Source: `lightbulb/communication_contracts.py:360`.

##### `lightbulb.communication_contracts.CommunicationArtifact.hmac_payload`



~~~python
def hmac_payload() -> dict[str, Any]
~~~


Source: `lightbulb/communication_contracts.py:367`.

### `lightbulb.communication_contracts.GrowthSourceBinding`

class. Source: `lightbulb/communication_contracts.py:375`.

Opaque provenance link only; no Growth learning or plan content.

Fields:
- `source_ref: OpaqueRef`
- `source_digest: Sha256Digest`

### `lightbulb.communication_contracts.CommunicationPartyRef`

class. Source: `lightbulb/communication_contracts.py:382`.

Fields:
- `schema_id: Literal['lightbulb.communication_party_ref.v1'] = Field(default=COMMUNICATION_PARTY_REF_SCHEMA, alias='schema')`
- `party_ref: OpaqueRef`
- `party_kind: CommunicationPartyKind`
- `identity_claim_digest: Sha256Digest`
- `identity_trust: CommunicationTrustGrade`
- `crm_contact_ref: OpaqueRef | None = None`
- `crm_account_ref: OpaqueRef | None = None`
- `observed_at: str`

### `lightbulb.communication_contracts.CommunicationEndpointBinding`

class. Source: `lightbulb/communication_contracts.py:413`.

Fields:
- `schema_id: Literal['lightbulb.communication_endpoint_binding.v1'] = Field(default=COMMUNICATION_ENDPOINT_BINDING_SCHEMA, alias='schema')`
- `endpoint_ref: OpaqueRef`
- `party_ref: OpaqueRef`
- `party_digest: Sha256Digest`
- `channel: CommunicationChannel`
- `address_sha256: Sha256Digest`
- `connector_account_ref: OpaqueRef | None = None`
- `route_digest: Sha256Digest | None = None`
- `ownership_trust: CommunicationTrustGrade`
- `verification_evidence_digest: Sha256Digest | None = None`
- `verified_at: str | None = None`

### `lightbulb.communication_contracts.CommunicationThreadBinding`

class. Source: `lightbulb/communication_contracts.py:466`.

Fields:
- `schema_id: Literal['lightbulb.communication_thread_binding.v1'] = Field(default=COMMUNICATION_THREAD_BINDING_SCHEMA, alias='schema')`
- `thread_ref: OpaqueRef`
- `purpose: CommunicationPurpose`
- `primary_channel: CommunicationChannel`
- `participant_party_refs: tuple[OpaqueRef, ...] = Field(min_length=2, max_length=100)`
- `crm_trace_binding_digest: Sha256Digest | None = None`
- `provider_thread_sha256: Sha256Digest | None = None`
- `parent_message_sha256: Sha256Digest | None = None`
- `connector_account_ref: OpaqueRef | None = None`
- `route_digest: Sha256Digest | None = None`
- `state: CommunicationThreadState`
- `version: int = Field(ge=1)`
- `created_at: str`
- `last_activity_at: str`

### `lightbulb.communication_contracts.CommunicationContextFact`

class. Source: `lightbulb/communication_contracts.py:522`.

Fields:
- `fact_code: OpaqueCode`
- `value_digest: Sha256Digest`
- `source_ref: OpaqueRef`
- `source_digest: Sha256Digest`
- `observed_at: str`

### `lightbulb.communication_contracts.CommunicationContextSnapshot`

class. Source: `lightbulb/communication_contracts.py:535`.

Fields:
- `schema_id: Literal['lightbulb.communication_context_snapshot.v1'] = Field(default=COMMUNICATION_CONTEXT_SNAPSHOT_SCHEMA, alias='schema')`
- `context_ref: OpaqueRef`
- `thread_ref: OpaqueRef`
- `party_refs: tuple[OpaqueRef, ...] = Field(min_length=1, max_length=100)`
- `facts: tuple[CommunicationContextFact, ...] = Field(max_length=64)`
- `missing_fact_codes: tuple[OpaqueCode, ...] = Field(default=(), max_length=32)`
- `classification: CommunicationDataClassification`
- `observed_at: str`
- `valid_until: str`
- `growth_source: GrowthSourceBinding | None = None`

### `lightbulb.communication_contracts.CommunicationMessageDraft`

class. Source: `lightbulb/communication_contracts.py:580`.

Fields:
- `schema_id: Literal['lightbulb.communication_message_draft.v1'] = Field(default=COMMUNICATION_MESSAGE_DRAFT_SCHEMA, alias='schema')`
- `draft_ref: OpaqueRef`
- `thread_ref: OpaqueRef`
- `thread_digest: Sha256Digest`
- `thread_version: int = Field(ge=1)`
- `thread_state: CommunicationThreadState`
- `thread_participant_party_refs: tuple[OpaqueRef, ...] = Field(min_length=2, max_length=100)`
- `parent_message_sha256: Sha256Digest | None = None`
- `context_digest: Sha256Digest`
- `purpose: CommunicationPurpose`
- `channel: CommunicationChannel`
- `sender_endpoint_ref: OpaqueRef`
- `sender_endpoint_digest: Sha256Digest`
- `recipient_endpoint_refs: tuple[OpaqueRef, ...] = Field(min_length=1, max_length=100)`
- `recipient_endpoint_digests: tuple[Sha256Digest, ...] = Field(min_length=1, max_length=100)`
- `contact_token_key_id: str = Field(min_length=8, max_length=80, pattern=_KEY_ID_PATTERN)`
- `company_contact_scope_digest: Sha256Digest`
- `recipient_contact_digests: tuple[Sha256Digest, ...] = Field(min_length=1, max_length=100)`
- `recipient_address_digests: tuple[Sha256Digest, ...] = Field(min_length=1, max_length=100)`
- `private_content_ref: OpaqueRef`
- `subject_sha256: Sha256Digest | None = None`
- `body_sha256: Sha256Digest`
- `attachment_sha256s: tuple[Sha256Digest, ...] = Field(default=(), max_length=20)`
- `template_ref: OpaqueRef | None = None`
- `template_version: int | None = Field(default=None, ge=1)`
- `template_digest: Sha256Digest | None = None`
- `growth_source: GrowthSourceBinding | None = None`
- `drafted_at: str`

### `lightbulb.communication_contracts.CommunicationContactPolicyDecision`

class. Source: `lightbulb/communication_contracts.py:689`.

Fields:
- `schema_id: Literal['lightbulb.communication_contact_policy_decision.v1'] = Field(default=COMMUNICATION_CONTACT_POLICY_DECISION_SCHEMA, alias='schema')`
- `decision_ref: OpaqueRef`
- `policy_version_ref: OpaqueRef`
- `draft_digest: Sha256Digest`
- `purpose: CommunicationPurpose`
- `channel: CommunicationChannel`
- `recipient_endpoint_digests: tuple[Sha256Digest, ...] = Field(min_length=1, max_length=100)`
- `disposition: CommunicationPolicyDisposition`
- `consent_status: CommunicationConsentStatus`
- `consent_evidence_digest: Sha256Digest | None = None`
- `suppression_status: CommunicationSuppressionStatus`
- `suppression_evidence_digest: Sha256Digest | None = None`
- `quiet_hours_status: CommunicationQuietHoursStatus`
- `quiet_hours_evidence_digest: Sha256Digest | None = None`
- `frequency_status: CommunicationFrequencyStatus`
- `frequency_evidence_digest: Sha256Digest | None = None`
- `reason_codes: tuple[OpaqueCode, ...] = Field(default=(), max_length=16)`
- `observed_at: str`
- `valid_until: str`

### `lightbulb.communication_contracts.CommunicationContactReservationRequest`

class. Source: `lightbulb/communication_contracts.py:773`.

Fields:
- `schema_id: Literal['lightbulb.communication_contact_reservation_request.v1'] = Field(default=COMMUNICATION_CONTACT_RESERVATION_REQUEST_SCHEMA, alias='schema')`
- `request_ref: OpaqueRef`
- `draft_digest: Sha256Digest`
- `policy_decision_digest: Sha256Digest`
- `purpose: CommunicationPurpose`
- `channel: CommunicationChannel`
- `recipient_endpoint_digests: tuple[Sha256Digest, ...] = Field(min_length=1, max_length=100)`
- `contact_token_key_id: str = Field(min_length=8, max_length=80, pattern=_KEY_ID_PATTERN)`
- `company_contact_scope_digest: Sha256Digest`
- `recipient_contact_digests: tuple[Sha256Digest, ...] = Field(min_length=1, max_length=100)`
- `recipient_address_digests: tuple[Sha256Digest, ...] = Field(min_length=1, max_length=100)`
- `contact_window_ref: OpaqueRef`
- `run_ref: OpaqueRef`
- `requested_at: str`
- `slot_digest: Sha256Digest`

### `lightbulb.communication_contracts.CommunicationContactReservation`

class. Source: `lightbulb/communication_contracts.py:851`.

Fields:
- `schema_id: Literal['lightbulb.communication_contact_reservation.v1'] = Field(default=COMMUNICATION_CONTACT_RESERVATION_SCHEMA, alias='schema')`
- `reservation_ref: OpaqueRef`
- `request_digest: Sha256Digest`
- `slot_digest: Sha256Digest`
- `reserved_at: str`
- `valid_until: str`

### `lightbulb.communication_contracts.CommunicationContactReservationConsumption`

class. Source: `lightbulb/communication_contracts.py:878`.

Fields:
- `schema_id: Literal['lightbulb.communication_contact_reservation_consumption.v1'] = Field(default=COMMUNICATION_CONTACT_RESERVATION_CONSUMPTION_SCHEMA, alias='schema')`
- `consumption_ref: OpaqueRef`
- `reservation_ref: OpaqueRef`
- `request_digest: Sha256Digest`
- `slot_digest: Sha256Digest`
- `consumed_at: str`

### `lightbulb.communication_contracts.CommunicationApprovalGrant`

class. Source: `lightbulb/communication_contracts.py:897`.

Fields:
- `schema_id: Literal['lightbulb.communication_approval_grant.v1'] = Field(default=COMMUNICATION_APPROVAL_GRANT_SCHEMA, alias='schema')`
- `approval_ref: OpaqueRef`
- `disposition: CommunicationApprovalDisposition`
- `authenticated_actor_digest: Sha256Digest`
- `authority_evidence_digest: Sha256Digest`
- `draft_digest: Sha256Digest`
- `policy_decision_digest: Sha256Digest`
- `thread_digest: Sha256Digest`
- `thread_version: int = Field(ge=1)`
- `thread_state: CommunicationThreadState`
- `thread_participant_party_refs: tuple[OpaqueRef, ...] = Field(min_length=2, max_length=100)`
- `parent_message_sha256: Sha256Digest | None = None`
- `purpose: CommunicationPurpose`
- `channel: CommunicationChannel`
- `sender_endpoint_digest: Sha256Digest`
- `recipient_endpoint_digests: tuple[Sha256Digest, ...] = Field(min_length=1, max_length=100)`
- `subject_sha256: Sha256Digest | None = None`
- `body_sha256: Sha256Digest`
- `attachment_sha256s: tuple[Sha256Digest, ...] = Field(default=(), max_length=20)`
- `connector_account_ref: OpaqueRef`
- `route_digest: Sha256Digest`
- `schedule_digest: Sha256Digest`
- `approved_at: str`
- `valid_until: str`

### `lightbulb.communication_contracts.CommunicationDispatchReceipt`

class. Source: `lightbulb/communication_contracts.py:965`.

Fields:
- `schema_id: Literal['lightbulb.communication_dispatch_receipt.v1'] = Field(default=COMMUNICATION_DISPATCH_RECEIPT_SCHEMA, alias='schema')`
- `dispatch_ref: OpaqueRef`
- `draft_digest: Sha256Digest`
- `policy_decision_digest: Sha256Digest`
- `approval_digest: Sha256Digest`
- `reservation_consumption_digest: Sha256Digest`
- `thread_ref: OpaqueRef`
- `thread_digest: Sha256Digest`
- `thread_version: int = Field(ge=1)`
- `thread_state: CommunicationThreadState`
- `thread_participant_party_refs: tuple[OpaqueRef, ...] = Field(min_length=2, max_length=100)`
- `parent_message_sha256: Sha256Digest | None = None`
- `purpose: CommunicationPurpose`
- `channel: CommunicationChannel`
- `connector_account_ref: OpaqueRef`
- `route_digest: Sha256Digest`
- `connector_execution_provenance_digest: Sha256Digest`
- `connector_effect_receipt_digest: Sha256Digest`
- `provider_message_sha256: Sha256Digest | None = None`
- `provider_thread_sha256: Sha256Digest | None = None`
- `state: CommunicationDispatchState`
- `attempted_at: str`
- `accepted_at: str | None = None`

### `lightbulb.communication_contracts.CommunicationProviderEvent`

class. Source: `lightbulb/communication_contracts.py:1024`.

Fields:
- `schema_id: Literal['lightbulb.communication_provider_event.v1'] = Field(default=COMMUNICATION_PROVIDER_EVENT_SCHEMA, alias='schema')`
- `event_ref: OpaqueRef`
- `event_type: CommunicationProviderEventType`
- `dispatch_receipt_digest: Sha256Digest | None = None`
- `connector_account_ref: OpaqueRef`
- `route_digest: Sha256Digest`
- `provider_event_sha256: Sha256Digest`
- `provider_message_sha256: Sha256Digest | None = None`
- `provider_thread_sha256: Sha256Digest | None = None`
- `authenticity: CommunicationAuthenticityGrade`
- `authenticity_evidence_digest: Sha256Digest | None = None`
- `private_payload_ref: OpaqueRef`
- `payload_sha256: Sha256Digest`
- `occurred_at: str`
- `received_at: str`

### `lightbulb.communication_contracts.CommunicationInboundMessage`

class. Source: `lightbulb/communication_contracts.py:1063`.

Fields:
- `schema_id: Literal['lightbulb.communication_inbound_message.v1'] = Field(default=COMMUNICATION_INBOUND_MESSAGE_SCHEMA, alias='schema')`
- `inbound_ref: OpaqueRef`
- `thread_ref: OpaqueRef`
- `provider_event_digest: Sha256Digest`
- `sender_endpoint_ref: OpaqueRef`
- `sender_endpoint_digest: Sha256Digest`
- `recipient_endpoint_digests: tuple[Sha256Digest, ...] = Field(min_length=1, max_length=100)`
- `private_content_ref: OpaqueRef`
- `content_sha256: Sha256Digest`
- `provider_message_sha256: Sha256Digest`
- `provider_thread_sha256: Sha256Digest | None = None`
- `in_reply_to_message_sha256: Sha256Digest | None = None`
- `authenticity: CommunicationAuthenticityGrade`
- `identity_trust: CommunicationTrustGrade`
- `received_at: str`

### `lightbulb.communication_contracts.CommunicationIntentScore`

class. Source: `lightbulb/communication_contracts.py:1110`.

Fields:
- `intent_code: OpaqueCode`
- `confidence: float = Field(ge=0.0, le=1.0)`

### `lightbulb.communication_contracts.CommunicationReplyInterpretation`

class. Source: `lightbulb/communication_contracts.py:1115`.

Fields:
- `schema_id: Literal['lightbulb.communication_reply_interpretation.v1'] = Field(default=COMMUNICATION_REPLY_INTERPRETATION_SCHEMA, alias='schema')`
- `interpretation_ref: OpaqueRef`
- `inbound_message_digest: Sha256Digest`
- `taxonomy_ref: OpaqueRef`
- `taxonomy_version: int = Field(ge=1)`
- `intent_scores: tuple[CommunicationIntentScore, ...] = Field(min_length=1, max_length=32)`
- `risk_codes: tuple[OpaqueCode, ...] = Field(default=(), max_length=32)`
- `requires_human_review: bool`
- `proposed_action_capabilities: tuple[CapabilityRef, ...] = Field(default=(), max_length=16)`
- `model_provenance_digest: Sha256Digest`
- `trust: Literal[CommunicationTrustGrade.MODEL_INFERRED] = CommunicationTrustGrade.MODEL_INFERRED`
- `interpreted_at: str`

### `lightbulb.communication_contracts.CrmTouchpointReceipt`

class. Source: `lightbulb/communication_contracts.py:1169`.

Fields:
- `schema_id: Literal['lightbulb.crm_touchpoint_receipt.v1', 'lightbulb.crm_touchpoint_receipt.v2'] = Field(default=CRM_TOUCHPOINT_RECEIPT_SCHEMA, alias='schema')`
- `touchpoint_ref: OpaqueRef`
- `touchpoint_type: CommunicationTouchpointType`
- `channel: CommunicationChannel = CommunicationChannel.EMAIL`
- `crm_contact_ref: OpaqueRef`
- `crm_account_ref: OpaqueRef | None = None`
- `crm_deal_ref: OpaqueRef | None = None`
- `crm_activity_ref: OpaqueRef`
- `thread_ref: OpaqueRef`
- `message_artifact_digest: Sha256Digest`
- `source_evidence_digests: tuple[Sha256Digest, ...] = Field(min_length=1, max_length=16)`
- `recorded_at: str`

#### Methods

##### `lightbulb.communication_contracts.CrmTouchpointReceipt.digest_payload`



~~~python
def digest_payload() -> dict[str, Any]
~~~


Source: `lightbulb/communication_contracts.py:1225`.

##### `lightbulb.communication_contracts.CrmTouchpointReceipt.hmac_payload`



~~~python
def hmac_payload() -> dict[str, Any]
~~~


Source: `lightbulb/communication_contracts.py:1231`.

### `lightbulb.communication_contracts.CommunicationOutcomeFact`

class. Source: `lightbulb/communication_contracts.py:1238`.

Fields:
- `dimension: CommunicationOutcomeDimension`
- `fact_code: OpaqueCode`
- `value_code: OpaqueCode | None = None`
- `numeric_value: float | None = None`
- `boolean_value: bool | None = None`
- `source_evidence_digest: Sha256Digest`

### `lightbulb.communication_contracts.CommunicationOutcomeObservation`

class. Source: `lightbulb/communication_contracts.py:1254`.

Fields:
- `schema_id: Literal['lightbulb.communication_outcome_observation.v1'] = Field(default=COMMUNICATION_OUTCOME_OBSERVATION_SCHEMA, alias='schema')`
- `observation_ref: OpaqueRef`
- `thread_ref: OpaqueRef`
- `dispatch_receipt_digest: Sha256Digest | None = None`
- `inbound_message_digest: Sha256Digest | None = None`
- `touchpoint_receipt_digest: Sha256Digest | None = None`
- `facts: tuple[CommunicationOutcomeFact, ...] = Field(min_length=1, max_length=32)`
- `associated_source_ref: OpaqueRef`
- `associated_source_digest: Sha256Digest`
- `growth_source: GrowthSourceBinding | None = None`
- `observed_at: str`
- `causal_claim_ready: Literal[False] = False`

### `lightbulb.communication_contracts.CommunicationHandoff`

class. Source: `lightbulb/communication_contracts.py:1298`.

Fields:
- `schema_id: Literal['lightbulb.communication_handoff.v1'] = Field(default=COMMUNICATION_HANDOFF_SCHEMA, alias='schema')`
- `handoff_ref: OpaqueRef`
- `sender_party_ref: OpaqueRef`
- `sender_party_digest: Sha256Digest`
- `recipient_party_ref: OpaqueRef`
- `recipient_party_digest: Sha256Digest`
- `private_objective_ref: OpaqueRef`
- `objective_sha256: Sha256Digest`
- `request_schema_ref: OpaqueRef`
- `response_schema_ref: OpaqueRef`
- `artifact_refs: tuple[OpaqueRef, ...] = Field(default=(), max_length=64)`
- `artifact_digests: tuple[Sha256Digest, ...] = Field(default=(), max_length=64)`
- `allowed_capabilities: tuple[CapabilityRef, ...] = Field(default=(), max_length=64)`
- `allowed_effects: tuple[CommunicationHandoffEffect, ...] = Field(default=(), max_length=3)`
- `authority_limit_digest: Sha256Digest`
- `classification: CommunicationDataClassification`
- `deadline_at: str`
- `requires_acknowledgement: bool`
- `trace_ref: OpaqueRef`
- `idempotency_digest: Sha256Digest`
- `created_at: str`

### `lightbulb.communication_contracts.communication_company_contact_scope_digest`

function. Source: `lightbulb/communication_contracts.py:1375`.



~~~python
communication_company_contact_scope_digest(*, scope: DynamicWorkflowScope | Mapping[str, Any], key_id: str, scope_keyring: CommunicationScopeKeyRing) -> str
~~~


Return a host-HMAC tenant/company scope independent of actor/project.

### `lightbulb.communication_contracts.communication_recipient_contact_commitment`

function. Source: `lightbulb/communication_contracts.py:1395`.



~~~python
communication_recipient_contact_commitment(*, company_contact_scope_digest: str, party_ref: str, key_id: str, scope_keyring: CommunicationScopeKeyRing) -> str
~~~


Commit a company-local contact identity without exposing its reference.

### `lightbulb.communication_contracts.communication_recipient_address_commitment`

function. Source: `lightbulb/communication_contracts.py:1415`.



~~~python
communication_recipient_address_commitment(*, company_contact_scope_digest: str, channel: CommunicationChannel, address: str, key_id: str, scope_keyring: CommunicationScopeKeyRing) -> str
~~~


Commit a normalized company-local destination without retaining it.

### `lightbulb.communication_contracts.communication_contact_slot_digest`

function. Source: `lightbulb/communication_contracts.py:1445`.



~~~python
communication_contact_slot_digest(*, contact_token_key_id: str, company_contact_scope_digest: str, recipient_contact_digests: tuple[str, ...], recipient_address_digests: tuple[str, ...], contact_window_ref: str) -> str
~~~


Derive a company/contact/window slot independent of actor and project.

### `lightbulb.communication_contracts.mint_communication_artifact`

function. Source: `lightbulb/communication_contracts.py:1482`.



~~~python
mint_communication_artifact(artifact_type: type[CommunicationArtifactT], payload: Mapping[str, Any], *, scope: DynamicWorkflowScope | Mapping[str, Any], scope_keyring: CommunicationScopeKeyRing, scope_key_id: str | None=None) -> CommunicationArtifactT
~~~


Validate, exact-scope bind, digest, and host-HMAC one artifact.

### `lightbulb.communication_contracts.verify_communication_artifact`

function. Source: `lightbulb/communication_contracts.py:1539`.



~~~python
verify_communication_artifact(value: CommunicationArtifactT | Mapping[str, Any], *, artifact_type: type[CommunicationArtifactT], scope: DynamicWorkflowScope | Mapping[str, Any], scope_keyring: CommunicationScopeKeyRing, at: datetime | None=None) -> CommunicationArtifactT
~~~


Verify canonical digest, exact authenticated scope, HMAC, and freshness.

## Module `lightbulb.communication_dispatch_recovery`

Crash-safe, privacy-minimised finalization for governed dispatches.

### `lightbulb.communication_dispatch_recovery.CommunicationPollPlan`

class. Source: `lightbulb/communication_dispatch_recovery.py:162`.

Concrete bounded schedule approved before the provider effect.

Fields:
- `schema_id: Literal['lightbulb.communication_poll_plan.v1'] = Field(default=COMMUNICATION_POLL_PLAN_SCHEMA, alias='schema')`
- `job_ref: str = Field(min_length=1, max_length=200)`
- `artifacts_ref: str = Field(min_length=1, max_length=200)`
- `not_before_at: str`
- `deadline_at: str`
- `poll_interval_seconds: int = Field(ge=1, le=86400)`
- `max_attempts: int = Field(ge=1, le=100)`
- `max_messages: int = Field(ge=1, le=10)`
- `schedule_digest: str = Field(pattern='^[0-9a-f]{64}$')`

#### Methods

##### `lightbulb.communication_dispatch_recovery.CommunicationPollPlan.digest_payload`



~~~python
def digest_payload() -> dict[str, Any]
~~~


Source: `lightbulb/communication_dispatch_recovery.py:190`.

### `lightbulb.communication_dispatch_recovery.mint_communication_poll_plan`

function. Source: `lightbulb/communication_dispatch_recovery.py:209`.



~~~python
mint_communication_poll_plan(*, job_ref: str, artifacts_ref: str, not_before_at: datetime, deadline_at: datetime, poll_interval_seconds: int, max_attempts: int, max_messages: int) -> CommunicationPollPlan
~~~


### `lightbulb.communication_dispatch_recovery.CommunicationGmailPollTemplate`

class. Source: `lightbulb/communication_dispatch_recovery.py:237`.

Fields:
- `schema_id: Literal['lightbulb.communication_gmail_poll_template.v1'] = Field(default=COMMUNICATION_GMAIL_POLL_TEMPLATE_SCHEMA, alias='schema')`
- `read_route: CommunicationGmailReadRoute`
- `communication_route: CommunicationGmailRoute`
- `thread: CommunicationThreadBinding`
- `outbound_sender_endpoint: CommunicationEndpointBinding`
- `contact_party: CommunicationPartyRef`
- `contact_endpoint: CommunicationEndpointBinding`
- `crm: CommunicationCrmTraceBinding`

### `lightbulb.communication_dispatch_recovery.CommunicationOutlookPollTemplate`

class. Source: `lightbulb/communication_dispatch_recovery.py:256`.

Fields:
- `schema_id: Literal['lightbulb.communication_outlook_poll_template.v1'] = Field(default=COMMUNICATION_OUTLOOK_POLL_TEMPLATE_SCHEMA, alias='schema')`
- `read_route: CommunicationOutlookReadRoute`
- `communication_route: CommunicationOutlookRoute`
- `thread: CommunicationThreadBinding`
- `outbound_sender_endpoint: CommunicationEndpointBinding`
- `contact_party: CommunicationPartyRef`
- `contact_endpoint: CommunicationEndpointBinding`
- `crm: CommunicationCrmTraceBinding`

### `lightbulb.communication_dispatch_recovery.CommunicationChannelPollTemplate`

class. Source: `lightbulb/communication_dispatch_recovery.py:275`.

Provider-neutral Slack/Teams observation seed.

Fields:
- `schema_id: Literal['lightbulb.communication_channel_poll_template.v1'] = Field(default=COMMUNICATION_CHANNEL_POLL_TEMPLATE_SCHEMA, alias='schema')`
- `read_route: CommunicationChannelReadRoute`
- `communication_route: CommunicationChannelWriteRoute`
- `thread: CommunicationThreadBinding`
- `outbound_sender_endpoint: CommunicationEndpointBinding`
- `contact_party: CommunicationPartyRef`
- `contact_endpoint: CommunicationEndpointBinding`
- `crm: CommunicationCrmTraceBinding`
- `channel_binding: CommunicationChannelTurnBinding`

### `lightbulb.communication_dispatch_recovery.CommunicationDispatchRecoveryStageRequest`

class. Source: `lightbulb/communication_dispatch_recovery.py:397`.

Pre-consume seed sent to one atomic durable recovery authority.

Fields:
- `schema_id: Literal['lightbulb.communication_dispatch_recovery_stage_request.v1'] = Field(default=COMMUNICATION_DISPATCH_RECOVERY_STAGE_REQUEST_SCHEMA, alias='schema')`
- `provider: Literal['gmail', 'outlook']`
- `run_ref: str = Field(min_length=1, max_length=160)`
- `schedule_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `idempotency_key: str = Field(min_length=1, max_length=240)`
- `invocation_request_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `draft: CommunicationMessageDraft`
- `policy_decision: CommunicationContactPolicyDecision`
- `approval_grant: CommunicationApprovalGrant`
- `reservation_request: CommunicationContactReservationRequest`
- `reservation: CommunicationContactReservation`
- `poll_plan: CommunicationPollPlan`
- `poll_template: CommunicationPollTemplate`

### `lightbulb.communication_dispatch_recovery.CommunicationDispatchRecoveryStage`

class. Source: `lightbulb/communication_dispatch_recovery.py:432`.

HMAC-sealed authority and poll plan sufficient for pure finalization.

Fields:
- `schema_id: Literal['lightbulb.communication_dispatch_recovery_stage.v1'] = Field(default=COMMUNICATION_DISPATCH_RECOVERY_STAGE_SCHEMA, alias='schema')`
- `provider: Literal['gmail', 'outlook']`
- `run_ref: str = Field(min_length=1, max_length=160)`
- `schedule_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `idempotency_key: str = Field(min_length=1, max_length=240)`
- `invocation_request_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `draft: CommunicationMessageDraft`
- `policy_decision: CommunicationContactPolicyDecision`
- `approval_grant: CommunicationApprovalGrant`
- `reservation_request: CommunicationContactReservationRequest`
- `reservation: CommunicationContactReservation`
- `reservation_consumption: CommunicationContactReservationConsumption`
- `poll_plan: CommunicationPollPlan`
- `poll_template: CommunicationPollTemplate`

#### Methods

##### `lightbulb.communication_dispatch_recovery.CommunicationDispatchRecoveryStage.as_request`



~~~python
def as_request() -> CommunicationDispatchRecoveryStageRequest
~~~


Source: `lightbulb/communication_dispatch_recovery.py:465`.

### `lightbulb.communication_dispatch_recovery.CommunicationChannelDispatchRecoveryStageRequest`

class. Source: `lightbulb/communication_dispatch_recovery.py:482`.

Closed pre-consume seed for one Slack or Teams channel turn.

Fields:
- `schema_id: Literal['lightbulb.communication_channel_dispatch_recovery_stage_request.v1'] = Field(default=COMMUNICATION_CHANNEL_DISPATCH_RECOVERY_STAGE_REQUEST_SCHEMA, alias='schema')`
- `provider: Literal['slack', 'teams']`
- `run_ref: str = Field(min_length=1, max_length=160)`
- `schedule_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `idempotency_key: str = Field(min_length=1, max_length=240)`
- `invocation_request_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `draft: CommunicationMessageDraft`
- `policy_decision: CommunicationContactPolicyDecision`
- `approval_grant: CommunicationApprovalGrant`
- `reservation_request: CommunicationContactReservationRequest`
- `reservation: CommunicationContactReservation`
- `poll_plan: CommunicationPollPlan`
- `poll_template: CommunicationChannelPollTemplate`

### `lightbulb.communication_dispatch_recovery.CommunicationChannelDispatchRecoveryStage`

class. Source: `lightbulb/communication_dispatch_recovery.py:519`.

HMAC-sealed channel authority sufficient for pure finalization.

Fields:
- `schema_id: Literal['lightbulb.communication_channel_dispatch_recovery_stage.v1'] = Field(default=COMMUNICATION_CHANNEL_DISPATCH_RECOVERY_STAGE_SCHEMA, alias='schema')`
- `provider: Literal['slack', 'teams']`
- `run_ref: str = Field(min_length=1, max_length=160)`
- `schedule_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `idempotency_key: str = Field(min_length=1, max_length=240)`
- `invocation_request_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `draft: CommunicationMessageDraft`
- `policy_decision: CommunicationContactPolicyDecision`
- `approval_grant: CommunicationApprovalGrant`
- `reservation_request: CommunicationContactReservationRequest`
- `reservation: CommunicationContactReservation`
- `reservation_consumption: CommunicationContactReservationConsumption`
- `poll_plan: CommunicationPollPlan`
- `poll_template: CommunicationChannelPollTemplate`

#### Methods

##### `lightbulb.communication_dispatch_recovery.CommunicationChannelDispatchRecoveryStage.as_request`



~~~python
def as_request() -> CommunicationChannelDispatchRecoveryStageRequest
~~~


Source: `lightbulb/communication_dispatch_recovery.py:556`.

### `lightbulb.communication_dispatch_recovery.CommunicationDispatchRecoveryAuthority`

class. Source: `lightbulb/communication_dispatch_recovery.py:640`.

Atomic production seam for reservation consumption plus stage custody.

Fields:
- `contact_token_key_id: str`

#### Methods

##### `lightbulb.communication_dispatch_recovery.CommunicationDispatchRecoveryAuthority.consume_and_stage`



~~~python
def consume_and_stage(*, request: CommunicationRecoveryStageRequest, scope: DynamicWorkflowScope, scope_keyring: CommunicationScopeKeyRing, consumed_at: datetime) -> CommunicationRecoveryStage
~~~


Source: `lightbulb/communication_dispatch_recovery.py:645`.

### `lightbulb.communication_dispatch_recovery.validate_communication_dispatch_recovery_stage_request`

function. Source: `lightbulb/communication_dispatch_recovery.py:692`.



~~~python
validate_communication_dispatch_recovery_stage_request(value: CommunicationRecoveryStageRequest | Mapping[str, Any], *, scope: DynamicWorkflowScope | Mapping[str, Any], scope_keyring: CommunicationScopeKeyRing, at: datetime) -> CommunicationRecoveryStageRequest
~~~


Verify every sealed seed component before reservation consumption.

### `lightbulb.communication_dispatch_recovery.mint_communication_dispatch_recovery_stage`

function. Source: `lightbulb/communication_dispatch_recovery.py:755`.



~~~python
mint_communication_dispatch_recovery_stage(request: CommunicationRecoveryStageRequest | Mapping[str, Any], *, reservation_consumption: CommunicationContactReservationConsumption | Mapping[str, Any], scope: DynamicWorkflowScope | Mapping[str, Any], scope_keyring: CommunicationScopeKeyRing) -> CommunicationRecoveryStage
~~~


Mint the final stage after an authority atomically consumes its slot.

### `lightbulb.communication_dispatch_recovery.verify_communication_dispatch_recovery_stage`

function. Source: `lightbulb/communication_dispatch_recovery.py:786`.



~~~python
verify_communication_dispatch_recovery_stage(value: CommunicationRecoveryStage | Mapping[str, Any], *, scope: DynamicWorkflowScope | Mapping[str, Any], scope_keyring: CommunicationScopeKeyRing, expected_request: CommunicationRecoveryStageRequest | Mapping[str, Any] | None=None) -> CommunicationRecoveryStage
~~~


Verify a stage at its consumed time, not at recovery wall-clock time.

### `lightbulb.communication_dispatch_recovery.CommunicationChannelPollArtifacts`

class. Source: `lightbulb/communication_dispatch_recovery.py:855`.

Complete encrypted-at-rest Slack/Teams observation input.

Fields:
- `schema_id: Literal['lightbulb.communication_channel_poll_artifacts.v1'] = Field(default=COMMUNICATION_CHANNEL_POLL_ARTIFACTS_SCHEMA, alias='schema')`
- `read_route: CommunicationChannelReadRoute`
- `communication_route: CommunicationChannelWriteRoute`
- `materialization: CommunicationMaterializationResult`
- `thread: CommunicationThreadBinding`
- `outbound_sender_endpoint: CommunicationEndpointBinding`
- `contact_party: CommunicationPartyRef`
- `contact_endpoint: CommunicationEndpointBinding`
- `crm: CommunicationCrmTraceBinding`
- `private_dispatch: CommunicationPrivateChannelDispatch`
- `channel_binding: CommunicationChannelTurnBinding`

### `lightbulb.communication_dispatch_recovery.CommunicationDispatchRecoveryFinalization`

class. Source: `lightbulb/communication_dispatch_recovery.py:889`.

Fields:
- `schema_id: Literal['lightbulb.communication_dispatch_recovery_finalization.v1'] = Field(default=COMMUNICATION_DISPATCH_RECOVERY_FINALIZATION_SCHEMA, alias='schema')`
- `stage_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `materialization: CommunicationMaterializationResult`
- `poll_artifacts: CommunicationGmailPollArtifacts | CommunicationOutlookPollArtifacts | CommunicationChannelPollArtifacts | None = None`

### `lightbulb.communication_dispatch_recovery.build_communication_dispatch_recovery_stage_request`

function. Source: `lightbulb/communication_dispatch_recovery.py:916`.



~~~python
build_communication_dispatch_recovery_stage_request(*, provider: Literal['gmail', 'outlook', 'slack', 'teams'], run_ref: str, schedule_digest: str, idempotency_key: str, invocation_request_digest: str, draft: CommunicationMessageDraft, policy_decision: CommunicationContactPolicyDecision, approval_grant: CommunicationApprovalGrant, reservation_request: CommunicationContactReservationRequest, reservation: CommunicationContactReservation, poll_plan: CommunicationPollPlan | Mapping[str, Any], poll_template: CommunicationPollTemplate | Mapping[str, Any]) -> CommunicationRecoveryStageRequest
~~~


### `lightbulb.communication_dispatch_recovery.finalize_recovered_communication_dispatch`

function. Source: `lightbulb/communication_dispatch_recovery.py:967`.



~~~python
finalize_recovered_communication_dispatch(*, stage: CommunicationRecoveryStage | Mapping[str, Any], connector_result: ConnectorExecutionResult | Mapping[str, Any], scope: DynamicWorkflowScope | Mapping[str, Any], scope_keyring: CommunicationScopeKeyRing) -> CommunicationDispatchRecoveryFinalization
~~~


Purely finalize one recovered governed effect without new I/O.

## Module `lightbulb.communication_governance`

Host-authority checks for governed communication artifacts.

### `lightbulb.communication_governance.CommunicationContactReservationConflict`

class. Source: `lightbulb/communication_governance.py:35`.

Another run owns, or already consumed, the exact contact slot.

### `lightbulb.communication_governance.CommunicationContactReservationAuthority`

class. Source: `lightbulb/communication_governance.py:40`.

Transactional host boundary for a short-lived, one-use contact slot.

Fields:
- `contact_token_key_id: str`

#### Methods

##### `lightbulb.communication_governance.CommunicationContactReservationAuthority.consume`



~~~python
def consume(reservation: CommunicationContactReservation, *, request: CommunicationContactReservationRequest, scope: DynamicWorkflowScope | Mapping[str, Any], scope_keyring: CommunicationScopeKeyRing, consumed_at: datetime) -> CommunicationContactReservationConsumption
~~~


Source: `lightbulb/communication_governance.py:55`.

##### `lightbulb.communication_governance.CommunicationContactReservationAuthority.reserve`



~~~python
def reserve(request: CommunicationContactReservationRequest, *, scope: DynamicWorkflowScope | Mapping[str, Any], scope_keyring: CommunicationScopeKeyRing, reserved_at: datetime, ttl_seconds: int=900) -> CommunicationContactReservation
~~~


Source: `lightbulb/communication_governance.py:45`.

### `lightbulb.communication_governance.mint_communication_contact_reservation_request`

function. Source: `lightbulb/communication_governance.py:77`.



~~~python
mint_communication_contact_reservation_request(*, request_ref: str, draft: CommunicationMessageDraft, policy_decision: CommunicationContactPolicyDecision, contact_window_ref: str, run_ref: str, requested_at: datetime, scope: DynamicWorkflowScope | Mapping[str, Any], scope_keyring: CommunicationScopeKeyRing, scope_key_id: str | None=None) -> CommunicationContactReservationRequest
~~~


Mint a run request whose slot excludes run and mutable message content.

### `lightbulb.communication_governance.verify_communication_contact_policy_decision`

function. Source: `lightbulb/communication_governance.py:130`.



~~~python
verify_communication_contact_policy_decision(value: CommunicationContactPolicyDecision | Mapping[str, Any], *, draft: CommunicationMessageDraft, at: datetime, scope: DynamicWorkflowScope | Mapping[str, Any], scope_keyring: CommunicationScopeKeyRing) -> CommunicationContactPolicyDecision
~~~


Admit only a fresh allow decision bound to the exact draft audience.

### `lightbulb.communication_governance.verify_communication_approval_grant`

function. Source: `lightbulb/communication_governance.py:172`.



~~~python
verify_communication_approval_grant(value: CommunicationApprovalGrant | Mapping[str, Any], *, draft: CommunicationMessageDraft, policy_decision: CommunicationContactPolicyDecision, connector_account_ref: str, route_digest: str, schedule_digest: str, at: datetime, scope: DynamicWorkflowScope | Mapping[str, Any], scope_keyring: CommunicationScopeKeyRing) -> CommunicationApprovalGrant
~~~


Verify human authority over exact content, audience, route, and schedule.

### `lightbulb.communication_governance.verify_communication_contact_reservation`

function. Source: `lightbulb/communication_governance.py:235`.



~~~python
verify_communication_contact_reservation(value: CommunicationContactReservation | Mapping[str, Any], *, request: CommunicationContactReservationRequest, at: datetime, scope: DynamicWorkflowScope | Mapping[str, Any], scope_keyring: CommunicationScopeKeyRing) -> CommunicationContactReservation
~~~


Verify the current reservation belongs to the exact sealed request.

### `lightbulb.communication_governance.verify_communication_contact_reservation_consumption`

function. Source: `lightbulb/communication_governance.py:271`.



~~~python
verify_communication_contact_reservation_consumption(value: CommunicationContactReservationConsumption | Mapping[str, Any], *, reservation: CommunicationContactReservation, request: CommunicationContactReservationRequest, scope: DynamicWorkflowScope | Mapping[str, Any], scope_keyring: CommunicationScopeKeyRing) -> CommunicationContactReservationConsumption
~~~


Verify the single-use proof for one exact reservation and request.

### `lightbulb.communication_governance.verify_communication_dispatch_authority`

function. Source: `lightbulb/communication_governance.py:330`.



~~~python
verify_communication_dispatch_authority(*, draft: CommunicationMessageDraft, policy_decision: CommunicationContactPolicyDecision, approval_grant: CommunicationApprovalGrant, reservation_request: CommunicationContactReservationRequest, reservation: CommunicationContactReservation, reservation_consumption: CommunicationContactReservationConsumption, connector_account_ref: str, route_digest: str, schedule_digest: str, at: datetime, scope: DynamicWorkflowScope | Mapping[str, Any], scope_keyring: CommunicationScopeKeyRing, max_consumption_age: timedelta=timedelta(minutes=1)) -> tuple[CommunicationMessageDraft, CommunicationContactPolicyDecision, CommunicationApprovalGrant, CommunicationContactReservationConsumption]
~~~


Verify the complete authority bundle immediately before connector I/O.

### `lightbulb.communication_governance.InMemoryCommunicationContactReservationAuthority`

class. Source: `lightbulb/communication_governance.py:427`.

Thread-safe reference authority; production hosts require durable storage.

#### Methods

##### `lightbulb.communication_governance.InMemoryCommunicationContactReservationAuthority.consume`



~~~python
def consume(reservation: CommunicationContactReservation, *, request: CommunicationContactReservationRequest, scope: DynamicWorkflowScope | Mapping[str, Any], scope_keyring: CommunicationScopeKeyRing, consumed_at: datetime) -> CommunicationContactReservationConsumption
~~~


Source: `lightbulb/communication_governance.py:505`.

##### `lightbulb.communication_governance.InMemoryCommunicationContactReservationAuthority.reserve`



~~~python
def reserve(request: CommunicationContactReservationRequest, *, scope: DynamicWorkflowScope | Mapping[str, Any], scope_keyring: CommunicationScopeKeyRing, reserved_at: datetime, ttl_seconds: int=900) -> CommunicationContactReservation
~~~


Source: `lightbulb/communication_governance.py:443`.

## Module `lightbulb.communication_materializer`

Governed one-recipient materialization for CRM conversation turns.

### `lightbulb.communication_materializer.CommunicationGmailRoute`

class. Source: `lightbulb/communication_materializer.py:120`.

Server-attested coordinates resolved before a communication turn.

Fields:
- `schema_id: Literal['lightbulb.communication_gmail_route.v1'] = Field(default=COMMUNICATION_GMAIL_ROUTE_SCHEMA, alias='schema')`
- `project_id: UUID`
- `project_ref: str = Field(min_length=1, max_length=160)`
- `connector_account_ref: str = Field(min_length=1, max_length=200)`
- `tenant_connector_id: UUID`
- `route_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `tool: Literal['gmail.send_email'] = _GMAIL_SEND_TOOL`
- `tool_version: int = Field(ge=1)`

### `lightbulb.communication_materializer.CommunicationPrivateGmailMessage`

class. Source: `lightbulb/communication_materializer.py:141`.

Transient private content resolved by the trusted host at dispatch.

Fields:
- `schema_id: Literal['lightbulb.communication_private_gmail_message.v1'] = Field(default=COMMUNICATION_PRIVATE_GMAIL_MESSAGE_SCHEMA, alias='schema')`
- `private_content_ref: str = Field(min_length=1, max_length=200)`
- `sender_endpoint_ref: str = Field(min_length=1, max_length=200)`
- `recipient_endpoint_ref: str = Field(min_length=1, max_length=200)`
- `recipient_address: str = Field(min_length=3, max_length=998, repr=False)`
- `subject: str = Field(min_length=1, max_length=998, repr=False)`
- `body: str = Field(min_length=1, max_length=50000, repr=False)`
- `provider_thread_id: str = Field(min_length=1, max_length=512, repr=False)`
- `parent_message_id: str = Field(min_length=5, max_length=998, repr=False)`

#### Methods

##### `lightbulb.communication_materializer.CommunicationPrivateGmailMessage.connector_arguments`



~~~python
def connector_arguments() -> dict[str, str]
~~~


Source: `lightbulb/communication_materializer.py:200`.

### `lightbulb.communication_materializer.CommunicationPrivateDispatchSink`

class. Source: `lightbulb/communication_materializer.py:220`.

Trusted host boundary for encrypted provider-write result custody.

#### Methods

##### `lightbulb.communication_materializer.CommunicationPrivateDispatchSink.store`



~~~python
def store(*, dispatch: CommunicationDispatchReceipt, authority_binding: Any, private_dispatch: Any, scope: DynamicWorkflowScope, scope_keyring: CommunicationScopeKeyRing) -> None
~~~


Source: `lightbulb/communication_materializer.py:223`.

### `lightbulb.communication_materializer.CommunicationMaterializationStatus`

class. Source: `lightbulb/communication_materializer.py:454`.

### `lightbulb.communication_materializer.CommunicationExternalEffectState`

class. Source: `lightbulb/communication_materializer.py:463`.

### `lightbulb.communication_materializer.CommunicationMaterializationResult`

class. Source: `lightbulb/communication_materializer.py:470`.

Fields:
- `schema_id: Literal['lightbulb.communication_materialization_result.v1'] = Field(default=COMMUNICATION_MATERIALIZATION_RESULT_SCHEMA, alias='schema')`
- `status: CommunicationMaterializationStatus`
- `draft_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `thread_ref: str`
- `run_ref: str`
- `idempotency_key: str = Field(min_length=1, max_length=240)`
- `connector_status: ConnectorExecutionStatus | None = None`
- `approval_ref: str | None = Field(default=None, max_length=200)`
- `approval_receipt_digest: str | None = Field(default=None, pattern='^[0-9a-f]{64}$')`
- `connector_error_kind: ConnectorErrorKind | None = None`
- `connector_error_code: str | None = Field(default=None, max_length=160)`
- `effect_state: CommunicationExternalEffectState`
- `receipt: CommunicationDispatchReceipt | None = None`
- `summary: str = Field(min_length=1, max_length=1000)`

### `lightbulb.communication_materializer.communication_endpoint_address_commitment`

function. Source: `lightbulb/communication_materializer.py:531`.



~~~python
communication_endpoint_address_commitment(*, endpoint_ref: str, address: str, key_id: str, scope_keyring: CommunicationScopeKeyRing) -> str
~~~


Return a host-keyed address commitment resistant to dictionary lookup.

### `lightbulb.communication_materializer.materialize_gmail_communication_turn`

function. Source: `lightbulb/communication_materializer.py:666`.



~~~python
materialize_gmail_communication_turn(*, scope: DynamicWorkflowScope | Mapping[str, Any], scope_keyring: CommunicationScopeKeyRing, execution_scope: ExecutionScope | Mapping[str, Any], route: CommunicationGmailRoute | Mapping[str, Any], context: CommunicationContextSnapshot | Mapping[str, Any], thread: CommunicationThreadBinding | Mapping[str, Any], sender_party: CommunicationPartyRef | Mapping[str, Any], recipient_party: CommunicationPartyRef | Mapping[str, Any], sender_endpoint: CommunicationEndpointBinding | Mapping[str, Any], recipient_endpoint: CommunicationEndpointBinding | Mapping[str, Any], draft: CommunicationMessageDraft | Mapping[str, Any], policy_decision: CommunicationContactPolicyDecision | Mapping[str, Any], private_message: CommunicationPrivateGmailMessage | Mapping[str, Any], executor: ConnectorExecutor, run_ref: str, schedule_digest: str, now: datetime, preview_only: bool=True, approval_grant: CommunicationApprovalGrant | Mapping[str, Any] | None=None, reservation_request: CommunicationContactReservationRequest | Mapping[str, Any] | None=None, reservation: CommunicationContactReservation | Mapping[str, Any] | None=None, reservation_authority: CommunicationContactReservationAuthority | None=None, _provider_adapter: CommunicationEmailMaterializerAdapter | None=None, _authority_binding: Any=None, _private_dispatch_sink: CommunicationPrivateDispatchSink | None=None, _recovery_authority: Any=None, _recovery_poll_plan: Any=None, _recovery_poll_template: Any=None) -> CommunicationMaterializationResult
~~~


Preview, propose, resume, or complete one governed CRM turn.

## Module `lightbulb.communication_observation`

Bounded Gmail reply observation for the governed communication rail.

### `lightbulb.communication_observation.CommunicationGmailReadRoute`

class. Source: `lightbulb/communication_observation.py:145`.

Exact Spring-owned route for the ephemeral Gmail thread read.

Fields:
- `schema_id: Literal['lightbulb.communication_gmail_read_route.v1'] = Field(default=COMMUNICATION_GMAIL_READ_ROUTE_SCHEMA, alias='schema')`
- `project_id: UUID`
- `project_ref: str = Field(min_length=1, max_length=160)`
- `connector_account_ref: str = Field(min_length=1, max_length=200)`
- `tenant_connector_id: UUID`
- `route_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `tool: Literal['gmail.get_thread'] = _GMAIL_GET_THREAD_TOOL`
- `tool_version: int = Field(ge=1)`

### `lightbulb.communication_observation.CommunicationPrivateGmailDispatch`

class. Source: `lightbulb/communication_observation.py:165`.

Transient raw identifiers retained by the host after Gmail dispatch.

Fields:
- `schema_id: Literal['lightbulb.communication_private_gmail_dispatch.v1'] = Field(default=COMMUNICATION_PRIVATE_GMAIL_DISPATCH_SCHEMA, alias='schema')`
- `provider_message_id: str = Field(min_length=1, max_length=512, repr=False)`
- `provider_thread_id: str = Field(min_length=1, max_length=512, repr=False)`

### `lightbulb.communication_observation.GmailThreadHeaders`

class. Source: `lightbulb/communication_observation.py:181`.

Fields:
- `subject: str | None = Field(default=None, max_length=998)`
- `from_address: str | None = Field(default=None, alias='from', max_length=998)`
- `to_address: str | None = Field(default=None, alias='to', max_length=998)`
- `date: str | None = Field(default=None, max_length=128)`
- `message_id: str | None = Field(default=None, alias='messageId', max_length=998)`
- `in_reply_to: str | None = Field(default=None, alias='inReplyTo', max_length=998)`
- `references: str | None = Field(default=None, max_length=4096)`

### `lightbulb.communication_observation.GmailThreadMessage`

class. Source: `lightbulb/communication_observation.py:206`.

Fields:
- `message_id: str = Field(alias='id', min_length=1, max_length=512)`
- `internal_date: str | None = Field(default=None, alias='internalDate', pattern='^[0-9]{1,20}$')`
- `snippet: str | None = Field(default=None, max_length=500)`
- `body: str | None = Field(default=None, max_length=2000)`
- `body_truncated: bool = Field(alias='bodyTruncated')`
- `headers: GmailThreadHeaders`

### `lightbulb.communication_observation.GmailThreadOutput`

class. Source: `lightbulb/communication_observation.py:226`.

Fields:
- `schema_id: Literal['lightbulb.gmail_thread.v1'] = Field(default=_GMAIL_THREAD_SCHEMA, alias='schema')`
- `thread_id: str = Field(alias='threadId', min_length=1, max_length=512)`
- `message_count: int = Field(alias='messageCount', ge=0)`
- `returned_message_count: int = Field(alias='returnedMessageCount', ge=0, le=10)`
- `truncated: bool`
- `private_data: Literal[True] = Field(alias='privateData')`
- `retention: Literal['ephemeral_response_only']`
- `messages: tuple[GmailThreadMessage, ...] = Field(max_length=10)`

### `lightbulb.communication_observation.CommunicationGmailObservationStatus`

class. Source: `lightbulb/communication_observation.py:269`.

### `lightbulb.communication_observation.CommunicationGmailObservationResult`

class. Source: `lightbulb/communication_observation.py:274`.

Privacy-minimised result of one host-invoked bounded poll.

Fields:
- `schema_id: Literal['lightbulb.communication_gmail_observation_result.v1'] = Field(default=COMMUNICATION_GMAIL_OBSERVATION_RESULT_SCHEMA, alias='schema')`
- `status: CommunicationGmailObservationStatus`
- `read_request_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `read_provenance_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `read_receipt_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `read_completed_at: str`
- `provider_message_count: int = Field(ge=0)`
- `returned_message_count: int = Field(ge=0, le=10)`
- `provider_event: CommunicationProviderEvent | None = None`
- `trace: CommunicationTraceResult | None = None`

### `lightbulb.communication_observation.CommunicationObservedEventRepository`

class. Source: `lightbulb/communication_observation.py:310`.

Safe first-evidence custody for restart-stable observed messages.

#### Methods

##### `lightbulb.communication_observation.CommunicationObservedEventRepository.get`



~~~python
def get(identity_digest: str) -> CommunicationProviderEvent | None
~~~


Source: `lightbulb/communication_observation.py:319`.

##### `lightbulb.communication_observation.CommunicationObservedEventRepository.put`



~~~python
def put(identity_digest: str, event: CommunicationProviderEvent) -> CommunicationProviderEvent
~~~


Source: `lightbulb/communication_observation.py:321`.

### `lightbulb.communication_observation.InMemoryCommunicationObservedEventRepository`

class. Source: `lightbulb/communication_observation.py:328`.

Thread-safe adapter retaining only sealed provider-event artifacts.

#### Methods

##### `lightbulb.communication_observation.InMemoryCommunicationObservedEventRepository.get`



~~~python
def get(identity_digest: str) -> CommunicationProviderEvent | None
~~~


Source: `lightbulb/communication_observation.py:335`.

##### `lightbulb.communication_observation.InMemoryCommunicationObservedEventRepository.put`



~~~python
def put(identity_digest: str, event: CommunicationProviderEvent) -> CommunicationProviderEvent
~~~


Source: `lightbulb/communication_observation.py:341`.

### `lightbulb.communication_observation.GmailCommunicationObserver`

class. Source: `lightbulb/communication_observation.py:1435`.

Backward-compatible Gmail facade over the shared observation rail.

## Module `lightbulb.communication_omnichannel`

Governed omnichannel contracts, planning, materialization, and observation.

### `lightbulb.communication_omnichannel.NormalizedTransportState`

class. Source: `lightbulb/communication_omnichannel.py:319`.

### `lightbulb.communication_omnichannel.NormalizedOutcome`

class. Source: `lightbulb/communication_omnichannel.py:328`.

### `lightbulb.communication_omnichannel.OmnichannelEffectBoundary`

class. Source: `lightbulb/communication_omnichannel.py:348`.

Fields:
- `connector_reads: Literal[0] = 0`
- `connector_writes: Literal[0] = 0`
- `approvals_consumed: Literal[0] = 0`
- `identities_merged: Literal[False] = False`
- `consent_changed: Literal[False] = False`
- `suppression_changed: Literal[False] = False`
- `message_dispatched: Literal[False] = False`
- `voice_call_placed: Literal[False] = False`
- `outcome_written: Literal[False] = False`
- `external_systems_changed: Literal[False] = False`
- `spring_system_of_record_authority_required: Literal[True] = True`
- `spring_rbac_approval_audit_required: Literal[True] = True`

### `lightbulb.communication_omnichannel.OmnichannelEvidencePolicy`

class. Source: `lightbulb/communication_omnichannel.py:363`.

Fields:
- `minimum_verification_grade: PrimitiveEvidenceVerificationGrade = PrimitiveEvidenceVerificationGrade.VERIFIED`
- `maximum_age_minutes: int = Field(default=120, ge=1, le=1440)`

### `lightbulb.communication_omnichannel.CrossChannelIdentityInput`

class. Source: `lightbulb/communication_omnichannel.py:506`.

Fields:
- `schema_id: Literal['lightbulb.communication_cross_channel_identity_input.v1'] = Field(default=CROSS_CHANNEL_IDENTITY_INPUT_SCHEMA, alias='schema')`
- `resolution_ref: OpaqueRef`
- `analysis_as_of: str`
- `party: CommunicationPartyRef`
- `endpoints: tuple[CommunicationEndpointBinding, ...] = Field(min_length=2, max_length=20)`
- `evidence_refs: tuple[PrimitiveEvidenceRef, ...] = Field(min_length=1, max_length=100)`
- `evidence_policy: OmnichannelEvidencePolicy = Field(default_factory=OmnichannelEvidencePolicy)`

### `lightbulb.communication_omnichannel.CrossChannelIdentityProposal`

class. Source: `lightbulb/communication_omnichannel.py:544`.

Fields:
- `schema_id: Literal['lightbulb.communication_cross_channel_identity_proposal.v1'] = Field(default=CROSS_CHANNEL_IDENTITY_PROPOSAL_SCHEMA, alias='schema')`
- `resolution_ref: OpaqueRef`
- `party_ref: OpaqueRef`
- `evaluated_at: str`
- `proposed_disposition: OmnichannelDisposition`
- `endpoint_refs: tuple[OpaqueRef, ...]`
- `channels: tuple[CommunicationChannel, ...]`
- `findings: tuple[OmnichannelFinding, ...]`
- `evidence_refs: tuple[PrimitiveEvidenceRef, ...]`
- `operation_spec: PrimitiveOperationSpec = IDENTITY_RESOLUTION_OPERATION`
- `operation_digest: Sha256Digest`
- `evidence_digest: Sha256Digest`
- `cross_channel_identity_merge_authorized: Literal[False] = False`
- `identities_merged: Literal[False] = False`
- `spring_artifact_seal_verification_required: Literal[True] = True`
- `effect_boundary: OmnichannelEffectBoundary = Field(default_factory=OmnichannelEffectBoundary)`
- `proposal_digest: Sha256Digest = _ZERO_DIGEST`

### `lightbulb.communication_omnichannel.resolve_cross_channel_identity`

function. Source: `lightbulb/communication_omnichannel.py:592`.



~~~python
resolve_cross_channel_identity(value: CrossChannelIdentityInput | Mapping[str, Any]) -> CrossChannelIdentityProposal
~~~


Propose one cross-channel identity resolution without merging records.

### `lightbulb.communication_omnichannel.CommunicationJurisdictionPolicyDecision`

class. Source: `lightbulb/communication_omnichannel.py:689`.

Short-lived Spring-issued channel and jurisdiction contact authority.

Fields:
- `schema_id: Literal['lightbulb.communication_jurisdiction_channel_policy_decision.v1'] = Field(default=COMMUNICATION_JURISDICTION_POLICY_DECISION_SCHEMA, alias='schema')`
- `decision_ref: OpaqueRef`
- `policy_version_ref: OpaqueRef`
- `draft_digest: Sha256Digest`
- `purpose: CommunicationPurpose`
- `channel: CommunicationChannel`
- `recipient_endpoint_digest: Sha256Digest`
- `jurisdiction: JurisdictionCode`
- `jurisdiction_evidence_digest: Sha256Digest`
- `lawful_basis_code: OpaqueCode`
- `lawful_basis_evidence_digest: Sha256Digest`
- `consent_status: CommunicationConsentStatus`
- `consent_evidence_digest: Sha256Digest`
- `suppression_status: CommunicationSuppressionStatus`
- `suppression_evidence_digest: Sha256Digest`
- `quiet_hours_status: CommunicationQuietHoursStatus`
- `quiet_hours_evidence_digest: Sha256Digest`
- `frequency_status: CommunicationFrequencyStatus`
- `frequency_evidence_digest: Sha256Digest`
- `disposition: CommunicationPolicyDisposition`
- `reason_codes: tuple[OpaqueCode, ...] = Field(default=(), max_length=24)`
- `source_authority: Literal['spring_control_plane'] = 'spring_control_plane'`
- `observed_at: str`
- `valid_until: str`

### `lightbulb.communication_omnichannel.JurisdictionChannelPolicyInput`

class. Source: `lightbulb/communication_omnichannel.py:768`.

Fields:
- `schema_id: Literal['lightbulb.communication_jurisdiction_channel_policy_input.v1'] = Field(default=JURISDICTION_CHANNEL_POLICY_INPUT_SCHEMA, alias='schema')`
- `evaluation_ref: OpaqueRef`
- `analysis_as_of: str`
- `draft_ref: OpaqueRef`
- `draft_digest: Sha256Digest`
- `purpose: CommunicationPurpose`
- `channel: CommunicationChannel`
- `recipient_endpoint_ref: OpaqueRef`
- `recipient_endpoint_digest: Sha256Digest`
- `jurisdiction: JurisdictionCode`
- `lawful_basis_code: OpaqueCode | None = None`
- `consent_status: CommunicationConsentStatus`
- `suppression_status: CommunicationSuppressionStatus`
- `quiet_hours_status: CommunicationQuietHoursStatus`
- `frequency_status: CommunicationFrequencyStatus`
- `evidence_refs: tuple[PrimitiveEvidenceRef, ...] = Field(min_length=1, max_length=100)`
- `evidence_policy: OmnichannelEvidencePolicy = Field(default_factory=lambda: OmnichannelEvidencePolicy(maximum_age_minutes=15))`

### `lightbulb.communication_omnichannel.JurisdictionChannelPolicyProposal`

class. Source: `lightbulb/communication_omnichannel.py:814`.

Fields:
- `schema_id: Literal['lightbulb.communication_jurisdiction_channel_policy_proposal.v1'] = Field(default=JURISDICTION_CHANNEL_POLICY_PROPOSAL_SCHEMA, alias='schema')`
- `evaluation_ref: OpaqueRef`
- `draft_ref: OpaqueRef`
- `draft_digest: Sha256Digest`
- `recipient_endpoint_ref: OpaqueRef`
- `recipient_endpoint_digest: Sha256Digest`
- `purpose: CommunicationPurpose`
- `channel: CommunicationChannel`
- `jurisdiction: JurisdictionCode`
- `evaluated_at: str`
- `proposed_disposition: OmnichannelDisposition`
- `findings: tuple[OmnichannelFinding, ...]`
- `evidence_refs: tuple[PrimitiveEvidenceRef, ...]`
- `operation_spec: PrimitiveOperationSpec = JURISDICTION_POLICY_OPERATION`
- `operation_digest: Sha256Digest`
- `evidence_digest: Sha256Digest`
- `consent_granted: Literal[False] = False`
- `suppression_overridden: Literal[False] = False`
- `dispatch_authorized: Literal[False] = False`
- `spring_policy_decision_required: Literal[True] = True`
- `effect_boundary: OmnichannelEffectBoundary = Field(default_factory=OmnichannelEffectBoundary)`
- `proposal_digest: Sha256Digest = _ZERO_DIGEST`

### `lightbulb.communication_omnichannel.evaluate_jurisdiction_channel_policy`

function. Source: `lightbulb/communication_omnichannel.py:865`.



~~~python
evaluate_jurisdiction_channel_policy(value: JurisdictionChannelPolicyInput | Mapping[str, Any]) -> JurisdictionChannelPolicyProposal
~~~


Evaluate jurisdiction-plus-channel evidence without granting authority.

### `lightbulb.communication_omnichannel.VoiceCallPlanInput`

class. Source: `lightbulb/communication_omnichannel.py:996`.

Fields:
- `schema_id: Literal['lightbulb.communication_voice_call_plan_input.v1'] = Field(default=VOICE_CALL_PLAN_INPUT_SCHEMA, alias='schema')`
- `plan_ref: OpaqueRef`
- `analysis_as_of: str`
- `purpose: CommunicationPurpose`
- `party_ref: OpaqueRef`
- `voice_endpoint_ref: OpaqueRef`
- `voice_endpoint_digest: Sha256Digest`
- `recipient_address_hmac_v1: Sha256Digest`
- `identity_resolution_digest: Sha256Digest`
- `identity_disposition: OmnichannelDisposition`
- `jurisdiction_policy_digest: Sha256Digest`
- `jurisdiction_policy_disposition: OmnichannelDisposition`
- `jurisdiction: JurisdictionCode`
- `script_ref: OpaqueRef`
- `script_version: int = Field(ge=1)`
- `script_digest: Sha256Digest`
- `script_status: Literal['approved', 'pending_review', 'rejected', 'expired']`
- `voice_profile_ref: OpaqueRef`
- `instruction_codes: tuple[VoiceInstructionCode, ...] = Field(min_length=2, max_length=4)`
- `maximum_duration_seconds: int = Field(ge=15, le=600)`
- `scheduled_for: str`
- `route_digest: Sha256Digest`
- `connector_account_ref: OpaqueRef`
- `evidence_refs: tuple[PrimitiveEvidenceRef, ...] = Field(min_length=1, max_length=100)`
- `evidence_policy: OmnichannelEvidencePolicy = Field(default_factory=lambda: OmnichannelEvidencePolicy(maximum_age_minutes=15))`

### `lightbulb.communication_omnichannel.VoiceCallPlanProposal`

class. Source: `lightbulb/communication_omnichannel.py:1060`.

Fields:
- `schema_id: Literal['lightbulb.communication_voice_call_plan_proposal.v1'] = Field(default=VOICE_CALL_PLAN_PROPOSAL_SCHEMA, alias='schema')`
- `plan_ref: OpaqueRef`
- `party_ref: OpaqueRef`
- `voice_endpoint_ref: OpaqueRef`
- `voice_endpoint_digest: Sha256Digest`
- `recipient_address_hmac_v1: Sha256Digest`
- `jurisdiction: JurisdictionCode`
- `evaluated_at: str`
- `scheduled_for: str`
- `proposed_disposition: OmnichannelDisposition`
- `script_ref: OpaqueRef`
- `script_version: int = Field(ge=1)`
- `script_digest: Sha256Digest`
- `instruction_codes: tuple[VoiceInstructionCode, ...]`
- `maximum_duration_seconds: int = Field(ge=15, le=600)`
- `connector_account_ref: OpaqueRef`
- `route_digest: Sha256Digest`
- `governed_tool: Literal['twilio.place_call_turn'] = TWILIO_PLACE_CALL_TURN_TOOL`
- `findings: tuple[OmnichannelFinding, ...]`
- `evidence_refs: tuple[PrimitiveEvidenceRef, ...]`
- `operation_spec: PrimitiveOperationSpec = VOICE_CALL_PLAN_OPERATION`
- `operation_digest: Sha256Digest`
- `evidence_digest: Sha256Digest`
- `call_authorized: Literal[False] = False`
- `call_placed: Literal[False] = False`
- `arbitrary_twiml_allowed: Literal[False] = False`
- `arbitrary_callback_url_allowed: Literal[False] = False`
- `transfer_allowed: Literal[False] = False`
- `provider_credentials_present: Literal[False] = False`
- `raw_destination_present: Literal[False] = False`
- `hosted_execution_contract_required: Literal[True] = True`
- `effect_boundary: OmnichannelEffectBoundary = Field(default_factory=OmnichannelEffectBoundary)`
- `proposal_digest: Sha256Digest = _ZERO_DIGEST`

### `lightbulb.communication_omnichannel.plan_governed_voice_call`

function. Source: `lightbulb/communication_omnichannel.py:1122`.



~~~python
plan_governed_voice_call(value: VoiceCallPlanInput | Mapping[str, Any]) -> VoiceCallPlanProposal
~~~


Plan a closed voice call without placing or authorizing one.

### `lightbulb.communication_omnichannel.CommunicationTwilioVoiceWriteRoute`

class. Source: `lightbulb/communication_omnichannel.py:1248`.

Exact Spring-owned project/account route for one voice write.

Fields:
- `schema_id: Literal['lightbulb.communication_twilio_voice_write_route.v1'] = Field(default=TWILIO_VOICE_WRITE_ROUTE_SCHEMA, alias='schema')`
- `project_id: UUID`
- `project_ref: OpaqueRef`
- `connector_account_ref: OpaqueRef`
- `tenant_connector_id: UUID`
- `route_digest: Sha256Digest`
- `tool: Literal['twilio.place_call_turn'] = TWILIO_PLACE_CALL_TURN_TOOL`
- `tool_version: int = Field(ge=1)`

### `lightbulb.communication_omnichannel.CommunicationTwilioVoiceStatusRoute`

class. Source: `lightbulb/communication_omnichannel.py:1263`.

Exact Spring-owned project/account route for one fresh call-status read.

Fields:
- `schema_id: Literal['lightbulb.communication_twilio_voice_status_route.v1'] = Field(default=TWILIO_VOICE_STATUS_ROUTE_SCHEMA, alias='schema')`
- `project_id: UUID`
- `project_ref: OpaqueRef`
- `connector_account_ref: OpaqueRef`
- `tenant_connector_id: UUID`
- `route_digest: Sha256Digest`
- `tool: Literal['twilio.lookup_call_status'] = TWILIO_LOOKUP_CALL_STATUS_TOOL`
- `tool_version: int = Field(ge=1)`

### `lightbulb.communication_omnichannel.TwilioVoiceExecutionEffectBoundary`

class. Source: `lightbulb/communication_omnichannel.py:1422`.

Fields:
- `connector_reads: int = Field(ge=0, le=1)`
- `connector_writes: int = Field(ge=0, le=1)`
- `approvals_consumed: int = Field(ge=0, le=1)`
- `arbitrary_twiml_allowed: Literal[False] = False`
- `arbitrary_callback_url_allowed: Literal[False] = False`
- `transfer_allowed: Literal[False] = False`
- `spring_route_credential_approval_audit_required: Literal[True] = True`

### `lightbulb.communication_omnichannel.TwilioVoiceDispatchReceipt`

class. Source: `lightbulb/communication_omnichannel.py:1432`.

HMAC-only public receipt; the provider call SID remains in host custody.

Fields:
- `schema_id: Literal['lightbulb.communication_twilio_voice_dispatch_receipt.v1'] = Field(default='lightbulb.communication_twilio_voice_dispatch_receipt.v1', alias='schema')`
- `plan_digest: Sha256Digest`
- `request_digest: Sha256Digest`
- `connector_provenance_digest: Sha256Digest`
- `connector_account_ref: OpaqueRef`
- `tenant_connector_id: UUID`
- `project_id: UUID`
- `write_route_digest: Sha256Digest`
- `provider_commitment_key_id: OpaqueRef`
- `call_sid_hmac_v1: Sha256Digest`
- `recipient_address_hmac_v1: Sha256Digest`
- `script_sha256: Sha256Digest`
- `provider_status: Literal['queued', 'initiated', 'ringing', 'in_progress']`
- `accepted: Literal[True]`
- `provider_observed: Literal[True]`
- `private_dispatch_custody: Literal['host_private'] = 'host_private'`

### `lightbulb.communication_omnichannel.TwilioVoiceMaterializationResult`

class. Source: `lightbulb/communication_omnichannel.py:1458`.

Fields:
- `schema_id: Literal['lightbulb.communication_twilio_voice_materialization.v1'] = Field(default=TWILIO_VOICE_MATERIALIZATION_SCHEMA, alias='schema')`
- `status: Literal['preview', 'completed', 'pending_approval', 'blocked', 'failed']`
- `connector_status: ConnectorExecutionStatus`
- `request_digest: Sha256Digest`
- `approval_ref: OpaqueRef | None = None`
- `dispatch_receipt: TwilioVoiceDispatchReceipt | None = None`
- `summary: str = Field(min_length=1, max_length=1000)`
- `effect_boundary: TwilioVoiceExecutionEffectBoundary`

### `lightbulb.communication_omnichannel.TwilioVoiceObservationResult`

class. Source: `lightbulb/communication_omnichannel.py:1484`.

Fields:
- `schema_id: Literal['lightbulb.communication_twilio_voice_observation.v1'] = Field(default=TWILIO_VOICE_OBSERVATION_SCHEMA, alias='schema')`
- `status: Literal['completed', 'blocked', 'failed']`
- `connector_status: ConnectorExecutionStatus`
- `request_digest: Sha256Digest`
- `provider_event_digest: Sha256Digest | None = None`
- `transport_state: NormalizedTransportState | None = None`
- `outcome: NormalizedOutcome | None = None`
- `terminal: bool = False`
- `duration_seconds: int | None = Field(default=None, ge=0, le=36000)`
- `summary: str = Field(min_length=1, max_length=1000)`
- `effect_boundary: TwilioVoiceExecutionEffectBoundary`

### `lightbulb.communication_omnichannel.materialize_twilio_voice_call`

function. Source: `lightbulb/communication_omnichannel.py:1556`.



~~~python
materialize_twilio_voice_call(*, scope: DynamicWorkflowScope | Mapping[str, Any], scope_keyring: CommunicationScopeKeyRing, execution_scope: ExecutionScope | Mapping[str, Any], route: CommunicationTwilioVoiceWriteRoute | Mapping[str, Any], plan: VoiceCallPlanProposal | Mapping[str, Any], private_turn: CommunicationPrivateTwilioVoiceTurn | Mapping[str, Any], provider_commitment_key_id: str, executor: Any, idempotency_key: str, _private_dispatch_sink: CommunicationPrivateDispatchSink | None=None, preview_only: bool=True) -> TwilioVoiceMaterializationResult
~~~


Preview or dispatch one exact voice turn through Spring authority.

### `lightbulb.communication_omnichannel.observe_twilio_voice_call`

function. Source: `lightbulb/communication_omnichannel.py:1761`.



~~~python
observe_twilio_voice_call(*, scope: DynamicWorkflowScope | Mapping[str, Any], scope_keyring: CommunicationScopeKeyRing, execution_scope: ExecutionScope | Mapping[str, Any], route: CommunicationTwilioVoiceStatusRoute | Mapping[str, Any], write_route: CommunicationTwilioVoiceWriteRoute | Mapping[str, Any], plan: VoiceCallPlanProposal | Mapping[str, Any], dispatch_receipt: TwilioVoiceDispatchReceipt | Mapping[str, Any], provider_commitment_key_id: str, executor: HostedConnectorExecutor, _private_dispatch_sink: CommunicationPrivateDispatchSink) -> TwilioVoiceObservationResult
~~~


Resolve one private SID in trusted custody and read its fresh status.

### `lightbulb.communication_omnichannel.ProviderObservationInput`

class. Source: `lightbulb/communication_omnichannel.py:2009`.

Fields:
- `schema_id: Literal['lightbulb.communication_provider_observation_input.v1'] = Field(default=PROVIDER_OBSERVATION_INPUT_SCHEMA, alias='schema')`
- `observation_ref: OpaqueRef`
- `analysis_as_of: str`
- `provider: OmnichannelProvider`
- `channel: CommunicationChannel`
- `provider_status: OpaqueCode`
- `dispatch_receipt_digest: Sha256Digest`
- `provider_event_digest: Sha256Digest`
- `provider_message_digest: Sha256Digest`
- `connector_account_ref: OpaqueRef`
- `route_digest: Sha256Digest`
- `authenticity: CommunicationAuthenticityGrade`
- `authenticity_evidence_digest: Sha256Digest | None = None`
- `occurred_at: str`
- `received_at: str`
- `evidence_refs: tuple[PrimitiveEvidenceRef, ...] = Field(min_length=1, max_length=100)`
- `evidence_policy: OmnichannelEvidencePolicy = Field(default_factory=lambda: OmnichannelEvidencePolicy(maximum_age_minutes=30))`

### `lightbulb.communication_omnichannel.ProviderObservationProposal`

class. Source: `lightbulb/communication_omnichannel.py:2066`.

Fields:
- `schema_id: Literal['lightbulb.communication_provider_observation_proposal.v1'] = Field(default=PROVIDER_OBSERVATION_PROPOSAL_SCHEMA, alias='schema')`
- `observation_ref: OpaqueRef`
- `provider: OmnichannelProvider`
- `channel: CommunicationChannel`
- `provider_status: OpaqueCode`
- `evaluated_at: str`
- `proposed_disposition: OmnichannelDisposition`
- `transport_state: NormalizedTransportState`
- `outcome: NormalizedOutcome`
- `conclusive: bool`
- `terminal: bool`
- `provider_event_type: CommunicationProviderEventType | None = None`
- `dispatch_receipt_digest: Sha256Digest`
- `provider_event_digest: Sha256Digest`
- `provider_message_digest: Sha256Digest`
- `findings: tuple[OmnichannelFinding, ...]`
- `evidence_refs: tuple[PrimitiveEvidenceRef, ...]`
- `operation_spec: PrimitiveOperationSpec = PROVIDER_OBSERVATION_OPERATION`
- `operation_digest: Sha256Digest`
- `evidence_digest: Sha256Digest`
- `delivery_claim_authorized: Literal[False] = False`
- `business_outcome_claim_authorized: Literal[False] = False`
- `crm_mutated: Literal[False] = False`
- `effect_boundary: OmnichannelEffectBoundary = Field(default_factory=OmnichannelEffectBoundary)`
- `proposal_digest: Sha256Digest = _ZERO_DIGEST`

### `lightbulb.communication_omnichannel.normalize_provider_outcome`

function. Source: `lightbulb/communication_omnichannel.py:2253`.



~~~python
normalize_provider_outcome(value: ProviderObservationInput | Mapping[str, Any]) -> ProviderObservationProposal
~~~


Normalize provider-neutral state without writing CRM.

### `lightbulb.communication_omnichannel.materialize_twilio_sms_communication_turn`

function. Source: `lightbulb/communication_omnichannel.py:3180`.



~~~python
materialize_twilio_sms_communication_turn(**arguments: Any) -> CommunicationMaterializationResult
~~~


Preview or host-dispatch one exact governed Twilio SMS turn.

### `lightbulb.communication_omnichannel.materialize_whatsapp_template_communication_turn`

function. Source: `lightbulb/communication_omnichannel.py:3191`.



~~~python
materialize_whatsapp_template_communication_turn(**arguments: Any) -> CommunicationMaterializationResult
~~~


Preview or host-dispatch one exact governed WhatsApp template turn.

### `lightbulb.communication_omnichannel.materialize_whatsapp_service_window_communication_turn`

function. Source: `lightbulb/communication_omnichannel.py:3202`.



~~~python
materialize_whatsapp_service_window_communication_turn(**arguments: Any) -> CommunicationMaterializationResult
~~~


Preview or host-dispatch one exact service-window WhatsApp reply.

### `lightbulb.communication_omnichannel.observe_twilio_sms_delivery`

function. Source: `lightbulb/communication_omnichannel.py:3292`.



~~~python
observe_twilio_sms_delivery(*, scope: DynamicWorkflowScope | Mapping[str, Any], scope_keyring: CommunicationScopeKeyRing, execution_scope: ExecutionScope | Mapping[str, Any], route: CommunicationTwilioSmsStatusRoute | Mapping[str, Any], dispatch_receipt: CommunicationDispatchReceipt | Mapping[str, Any], omnichannel_binding: CommunicationOmnichannelTurnBinding | Mapping[str, Any], private_dispatch: CommunicationPrivateTwilioSmsDispatch | Mapping[str, Any], executor: HostedConnectorExecutor, event_ref: str, private_payload_ref: str, observed_at: datetime) -> TwilioSmsObservationResult
~~~


Read and normalize one SMS delivery status through Spring custody.

### `lightbulb.communication_omnichannel.ResolveCrossChannelIdentityPrimitive`

class. Source: `lightbulb/communication_omnichannel.py:3791`.

#### Methods

##### `lightbulb.communication_omnichannel.ResolveCrossChannelIdentityPrimitive.implementation_contract`



~~~python
def implementation_contract() -> dict[str, Any]
~~~


Source: `lightbulb/communication_omnichannel.py:3809`.

### `lightbulb.communication_omnichannel.EvaluateJurisdictionChannelPolicyPrimitive`

class. Source: `lightbulb/communication_omnichannel.py:3837`.

#### Methods

##### `lightbulb.communication_omnichannel.EvaluateJurisdictionChannelPolicyPrimitive.implementation_contract`



~~~python
def implementation_contract() -> dict[str, Any]
~~~


Source: `lightbulb/communication_omnichannel.py:3858`.

### `lightbulb.communication_omnichannel.PlanGovernedVoiceCallPrimitive`

class. Source: `lightbulb/communication_omnichannel.py:3884`.

#### Methods

##### `lightbulb.communication_omnichannel.PlanGovernedVoiceCallPrimitive.implementation_contract`



~~~python
def implementation_contract() -> dict[str, Any]
~~~


Source: `lightbulb/communication_omnichannel.py:3902`.

### `lightbulb.communication_omnichannel.NormalizeProviderOutcomePrimitive`

class. Source: `lightbulb/communication_omnichannel.py:3935`.

#### Methods

##### `lightbulb.communication_omnichannel.NormalizeProviderOutcomePrimitive.implementation_contract`



~~~python
def implementation_contract() -> dict[str, Any]
~~~


Source: `lightbulb/communication_omnichannel.py:3953`.

## Module `lightbulb.communication_outlook`

Exact Outlook adapter for the shared governed email materializer.

### `lightbulb.communication_outlook.CommunicationOutlookRoute`

class. Source: `lightbulb/communication_outlook.py:61`.

Server-attested coordinates for one exact Microsoft account route.

Fields:
- `schema_id: Literal['lightbulb.communication_outlook_route.v1'] = Field(default=COMMUNICATION_OUTLOOK_ROUTE_SCHEMA, alias='schema')`
- `project_id: UUID`
- `project_ref: str = Field(min_length=1, max_length=160)`
- `connector_account_ref: str = Field(min_length=1, max_length=200)`
- `tenant_connector_id: UUID`
- `route_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `tool: Literal['microsoft.reply_email'] = _OUTLOOK_REPLY_TOOL`
- `tool_version: int = Field(ge=1)`

### `lightbulb.communication_outlook.CommunicationPrivateOutlookMessage`

class. Source: `lightbulb/communication_outlook.py:82`.

Transient content and Graph selectors resolved by the trusted host.

Fields:
- `schema_id: Literal['lightbulb.communication_private_outlook_message.v1'] = Field(default=COMMUNICATION_PRIVATE_OUTLOOK_MESSAGE_SCHEMA, alias='schema')`
- `private_content_ref: str = Field(min_length=1, max_length=200)`
- `sender_endpoint_ref: str = Field(min_length=1, max_length=200)`
- `recipient_endpoint_ref: str = Field(min_length=1, max_length=200)`
- `recipient_address: str = Field(min_length=3, max_length=254, repr=False)`
- `subject: str = Field(min_length=1, max_length=998, repr=False)`
- `body: str = Field(min_length=1, max_length=50000, repr=False)`
- `provider_conversation_id: str = Field(min_length=1, max_length=512, repr=False)`
- `parent_provider_message_id: str = Field(min_length=1, max_length=512, repr=False)`
- `parent_rfc_message_id: str = Field(min_length=5, max_length=998, repr=False)`

#### Methods

##### `lightbulb.communication_outlook.CommunicationPrivateOutlookMessage.connector_arguments`



~~~python
def connector_arguments() -> dict[str, str]
~~~


Source: `lightbulb/communication_outlook.py:146`.

### `lightbulb.communication_outlook.materialize_outlook_communication_turn`

function. Source: `lightbulb/communication_outlook.py:300`.



~~~python
materialize_outlook_communication_turn(**arguments: Any) -> CommunicationMaterializationResult
~~~


Run the shared authority with exact Microsoft-specific proof hooks.

## Module `lightbulb.communication_outlook_host`

Closed Outlook artifact shape for the shared communication poll host.

### `lightbulb.communication_outlook_host.CommunicationOutlookPollArtifacts`

class. Source: `lightbulb/communication_outlook_host.py:46`.

One transient, exact-route Outlook poll payload.

Fields:
- `schema_id: Literal['lightbulb.communication_outlook_poll_artifacts.v1'] = Field(default=COMMUNICATION_OUTLOOK_POLL_ARTIFACTS_SCHEMA, alias='schema')`
- `read_route: CommunicationOutlookReadRoute`
- `communication_route: CommunicationOutlookRoute`
- `materialization: CommunicationMaterializationResult`
- `thread: CommunicationThreadBinding`
- `outbound_sender_endpoint: CommunicationEndpointBinding`
- `contact_party: CommunicationPartyRef`
- `contact_endpoint: CommunicationEndpointBinding`
- `crm: CommunicationCrmTraceBinding`
- `private_dispatch: CommunicationPrivateOutlookDispatch`

### `lightbulb.communication_outlook_host.parse_outlook_poll_artifacts`

function. Source: `lightbulb/communication_outlook_host.py:187`.



~~~python
parse_outlook_poll_artifacts(value: CommunicationOutlookPollArtifacts | Mapping[str, object] | str | bytes) -> CommunicationOutlookPollArtifacts
~~~


Parse one bounded Spring wire payload through Pydantic's JSON boundary.

## Module `lightbulb.communication_outlook_observation`

Microsoft Graph models and proof adapter for shared email observation.

### `lightbulb.communication_outlook_observation.CommunicationOutlookReadRoute`

class. Source: `lightbulb/communication_outlook_observation.py:72`.

Exact Spring-owned route for the ephemeral Outlook conversation read.

Fields:
- `schema_id: Literal['lightbulb.communication_outlook_read_route.v1'] = Field(default=COMMUNICATION_OUTLOOK_READ_ROUTE_SCHEMA, alias='schema')`
- `project_id: UUID`
- `project_ref: str = Field(min_length=1, max_length=160)`
- `connector_account_ref: str = Field(min_length=1, max_length=200)`
- `tenant_connector_id: UUID`
- `route_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `tool: Literal['microsoft.get_conversation'] = _OUTLOOK_GET_CONVERSATION_TOOL`
- `tool_version: int = Field(ge=1)`

### `lightbulb.communication_outlook_observation.CommunicationPrivateOutlookDispatch`

class. Source: `lightbulb/communication_outlook_observation.py:92`.

Transient immutable identifiers retained after Outlook acceptance.

Fields:
- `schema_id: Literal['lightbulb.communication_private_outlook_dispatch.v1'] = Field(default=COMMUNICATION_PRIVATE_OUTLOOK_DISPATCH_SCHEMA, alias='schema')`
- `provider_message_id: str = Field(min_length=1, max_length=512, repr=False)`
- `provider_conversation_id: str = Field(min_length=1, max_length=512, repr=False)`

### `lightbulb.communication_outlook_observation.OutlookMessageHeaders`

class. Source: `lightbulb/communication_outlook_observation.py:113`.

Fields:
- `message_id: str | None = Field(default=None, alias='messageId', max_length=998)`
- `in_reply_to: str | None = Field(default=None, alias='inReplyTo', max_length=998)`
- `references: str | None = Field(default=None, max_length=4096)`

### `lightbulb.communication_outlook_observation.OutlookConversationMessage`

class. Source: `lightbulb/communication_outlook_observation.py:126`.

Fields:
- `message_id: str = Field(alias='id', min_length=1, max_length=512)`
- `conversation_id: str = Field(alias='conversationId', min_length=1, max_length=512)`
- `internet_message_id: str = Field(alias='internetMessageId', min_length=5, max_length=998)`
- `headers: OutlookMessageHeaders`
- `from_address: str = Field(alias='from', min_length=3, max_length=254)`
- `sender_address: str = Field(alias='sender', min_length=3, max_length=254)`
- `to_recipients: tuple[str, ...] = Field(alias='toRecipients', max_length=50)`
- `cc_recipients: tuple[str, ...] = Field(alias='ccRecipients', max_length=50)`
- `bcc_recipients: tuple[str, ...] = Field(alias='bccRecipients', max_length=50)`
- `reply_to: tuple[str, ...] = Field(alias='replyTo', max_length=50)`
- `received_at: str | None = Field(default=None, alias='receivedDateTime', max_length=128)`
- `sent_at: str | None = Field(default=None, alias='sentDateTime', max_length=128)`
- `subject: str | None = Field(default=None, max_length=998)`
- `body: str = Field(max_length=2000)`
- `body_truncated: bool = Field(alias='bodyTruncated')`
- `is_draft: bool = Field(alias='isDraft')`

### `lightbulb.communication_outlook_observation.OutlookConversationOutput`

class. Source: `lightbulb/communication_outlook_observation.py:218`.

Fields:
- `schema_id: Literal['lightbulb.outlook_conversation.v1'] = Field(default=_OUTLOOK_CONVERSATION_SCHEMA, alias='schema')`
- `conversation_id: str = Field(alias='conversationId', min_length=1, max_length=512)`
- `returned_message_count: int = Field(alias='returnedMessageCount', ge=0, le=10)`
- `truncated: bool`
- `private_data: Literal[True] = Field(alias='privateData')`
- `retention: Literal['ephemeral_response_only']`
- `messages: tuple[OutlookConversationMessage, ...] = Field(max_length=10)`

### `lightbulb.communication_outlook_observation.CommunicationOutlookObservationStatus`

class. Source: `lightbulb/communication_outlook_observation.py:261`.

### `lightbulb.communication_outlook_observation.CommunicationOutlookObservationResult`

class. Source: `lightbulb/communication_outlook_observation.py:267`.

Privacy-minimised result of one host-invoked bounded poll.

Fields:
- `schema_id: Literal['lightbulb.communication_outlook_observation_result.v1'] = Field(default=COMMUNICATION_OUTLOOK_OBSERVATION_RESULT_SCHEMA, alias='schema')`
- `status: CommunicationOutlookObservationStatus`
- `read_request_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `read_provenance_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `read_receipt_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `read_completed_at: str`
- `provider_message_count: int = Field(ge=0)`
- `returned_message_count: int = Field(ge=0, le=10)`
- `outbound_observed: bool`
- `provider_event: CommunicationProviderEvent | None = None`
- `trace: CommunicationOutlookTraceResult | None = None`

### `lightbulb.communication_outlook_observation.OutlookCommunicationObserver`

class. Source: `lightbulb/communication_outlook_observation.py:659`.

Outlook facade selecting the closed Graph proof adapter.

## Module `lightbulb.communication_outlook_runtime`

Outlook types on the provider-neutral communication CRM/replay runtime.

### `lightbulb.communication_outlook_runtime.CommunicationPrivateOutlookInbound`

class. Source: `lightbulb/communication_outlook_runtime.py:26`.

Validated transient Outlook content accepted directly by the shared rail.

Fields:
- `schema_id: Literal['lightbulb.communication_private_outlook_inbound.v1'] = Field(default=COMMUNICATION_PRIVATE_OUTLOOK_INBOUND_SCHEMA, alias='schema')`

## Module `lightbulb.communication_primitives`

Proposal-only executable primitive for a governed CRM conversation turn.

### `lightbulb.communication_primitives.CommunicationTurnKind`

class. Source: `lightbulb/communication_primitives.py:32`.

### `lightbulb.communication_primitives.CommunicationTurnPhase`

class. Source: `lightbulb/communication_primitives.py:37`.

### `lightbulb.communication_primitives.PlanCrmConversationTurnInput`

class. Source: `lightbulb/communication_primitives.py:49`.

Opaque, deterministic inputs for one supported email-provider tracer.

Fields:
- `analysis_as_of: str`
- `plan_ref: str = Field(min_length=1, max_length=160)`
- `objective_ref: str = Field(min_length=1, max_length=200)`
- `objective_digest: str = Field(pattern=_SHA256_PATTERN)`
- `turn_kind: CommunicationTurnKind`
- `purpose: CommunicationPurpose`
- `provider: Literal['gmail', 'outlook'] = 'gmail'`
- `crm_conversation_ref: str = Field(min_length=1, max_length=200)`
- `crm_contact_ref: str = Field(min_length=1, max_length=200)`
- `source_message_ref: str | None = Field(default=None, max_length=200)`
- `source_message_digest: str | None = Field(default=None, pattern=_SHA256_PATTERN)`
- `connector_account_ref: str = Field(min_length=1, max_length=200)`
- `growth_source_ref: str | None = Field(default=None, max_length=200)`
- `growth_source_digest: str | None = Field(default=None, pattern=_SHA256_PATTERN)`

### `lightbulb.communication_primitives.CommunicationTurnPlan`

class. Source: `lightbulb/communication_primitives.py:132`.

Fields:
- `schema_id: Literal['lightbulb.communication_turn_plan.v1'] = Field(default=COMMUNICATION_TURN_PLAN_SCHEMA, alias='schema')`
- `plan_ref: str`
- `plan_digest: str = Field(pattern=_SHA256_PATTERN)`
- `analysis_as_of: str`
- `objective_ref: str`
- `objective_digest: str = Field(pattern=_SHA256_PATTERN)`
- `turn_kind: CommunicationTurnKind`
- `purpose: CommunicationPurpose`
- `channel: Literal['email'] = 'email'`
- `provider: Literal['gmail', 'outlook'] = 'gmail'`
- `crm_conversation_ref: str`
- `crm_contact_ref: str`
- `source_message_ref: str | None = None`
- `source_message_digest: str | None = Field(default=None, pattern=_SHA256_PATTERN)`
- `connector_account_ref: str`
- `growth_source_ref: str | None = None`
- `growth_source_digest: str | None = Field(default=None, pattern=_SHA256_PATTERN)`
- `phases: tuple[CommunicationTurnPhase, ...]`
- `required_capabilities: tuple[str, ...]`
- `durable_private_content_allowed: Literal[False] = False`
- `live_systems_changed: Literal[False] = False`

### `lightbulb.communication_primitives.plan_crm_conversation_turn`

function. Source: `lightbulb/communication_primitives.py:202`.



~~~python
plan_crm_conversation_turn(inputs: PlanCrmConversationTurnInput) -> CommunicationTurnPlan
~~~


### `lightbulb.communication_primitives.PlanCrmConversationTurnPrimitive`

class. Source: `lightbulb/communication_primitives.py:234`.

Compose the trusted-host communication loop without dispatching it.

Fields:
- `connector_tools: tuple[str, ...] = ()`

#### Methods

##### `lightbulb.communication_primitives.PlanCrmConversationTurnPrimitive.implementation_contract`



~~~python
def implementation_contract() -> dict[str, Any]
~~~


Source: `lightbulb/communication_primitives.py:269`.

## Module `lightbulb.communication_runtime`

Restart-safe reply tracing on the governed communication rail.

### `lightbulb.communication_runtime.CommunicationCrmTraceBinding`

class. Source: `lightbulb/communication_runtime.py:294`.

Sealed CRM coordinates bound to one exact contact party and endpoint.

Fields:
- `schema_id: Literal['lightbulb.communication_crm_trace_binding.v1', 'lightbulb.communication_crm_trace_binding.v2'] = Field(default=COMMUNICATION_CRM_TRACE_BINDING_SCHEMA, alias='schema')`
- `contact_party_ref: str = Field(min_length=1, max_length=200)`
- `contact_party_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `contact_endpoint_ref: str = Field(min_length=1, max_length=200)`
- `contact_endpoint_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `crm_contact_ref: str = Field(min_length=1, max_length=200)`
- `crm_account_ref: str | None = Field(default=None, max_length=200)`
- `crm_deal_ref: str | None = Field(default=None, max_length=200)`
- `crm_conversation_ref: str | None = Field(default=None, max_length=36)`
- `associated_source_ref: str = Field(min_length=1, max_length=200)`
- `associated_source_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `growth_source: GrowthSourceBinding | None = None`

#### Methods

##### `lightbulb.communication_runtime.CommunicationCrmTraceBinding.digest_payload`



~~~python
def digest_payload() -> dict[str, Any]
~~~


Source: `lightbulb/communication_runtime.py:405`.

##### `lightbulb.communication_runtime.CommunicationCrmTraceBinding.hmac_payload`



~~~python
def hmac_payload() -> dict[str, Any]
~~~


Source: `lightbulb/communication_runtime.py:411`.

### `lightbulb.communication_runtime.CommunicationTraceResult`

class. Source: `lightbulb/communication_runtime.py:418`.

Privacy-minimised result of one exactly-once communication trace.

Fields:
- `schema_id: Literal['lightbulb.communication_gmail_trace_result.v1', 'lightbulb.communication_trace_result.v2'] = Field(default=COMMUNICATION_TRACE_RESULT_SCHEMA, alias='schema')`
- `inbound_message: CommunicationInboundMessage`
- `interpretation: CommunicationReplyInterpretation`
- `touchpoint_receipts: tuple[CrmTouchpointReceipt, ...] = Field(min_length=3, max_length=3)`
- `outcome_observation: CommunicationOutcomeObservation`
- `replayed: bool = False`

### `lightbulb.communication_runtime.CommunicationReplayError`

class. Source: `lightbulb/communication_runtime.py:506`.

Base error for replay-custody failures.

### `lightbulb.communication_runtime.CommunicationReplayConflict`

class. Source: `lightbulb/communication_runtime.py:510`.

A dedupe identity was previously claimed for different evidence.

### `lightbulb.communication_runtime.CommunicationReplayInProgress`

class. Source: `lightbulb/communication_runtime.py:514`.

The exact message is already being processed under a live lease.

### `lightbulb.communication_runtime.CommunicationReplayCapacityExceeded`

class. Source: `lightbulb/communication_runtime.py:518`.

The safe in-memory repository is full and refuses unsafe eviction.

### `lightbulb.communication_runtime.CommunicationReplayClaim`

class. Source: `lightbulb/communication_runtime.py:522`.

Fields:
- `claim_ref: str = Field(min_length=1, max_length=200)`
- `dedupe_keys: tuple[str, ...] = Field(min_length=1, max_length=8)`
- `request_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `lease_expires_at: str`
- `replayed_result: CommunicationTraceResult | None = None`

### `lightbulb.communication_runtime.CommunicationReplayRepository`

class. Source: `lightbulb/communication_runtime.py:549`.

Durable claim/complete boundary for restart-safe message dedupe.

#### Methods

##### `lightbulb.communication_runtime.CommunicationReplayRepository.claim`



~~~python
def claim(*, dedupe_keys: tuple[str, ...], request_digest: str, claimed_at: datetime, lease_for: timedelta) -> CommunicationReplayClaim
~~~


Source: `lightbulb/communication_runtime.py:552`.

##### `lightbulb.communication_runtime.CommunicationReplayRepository.complete`



~~~python
def complete(claim: CommunicationReplayClaim, *, result: CommunicationTraceResult) -> None
~~~


Source: `lightbulb/communication_runtime.py:561`.

##### `lightbulb.communication_runtime.CommunicationReplayRepository.release`



~~~python
def release(claim: CommunicationReplayClaim) -> None
~~~


Source: `lightbulb/communication_runtime.py:568`.

### `lightbulb.communication_runtime.InMemoryCommunicationReplayRepository`

class. Source: `lightbulb/communication_runtime.py:579`.

Thread-safe adapter that never evicts completed dedupe evidence.

#### Methods

##### `lightbulb.communication_runtime.InMemoryCommunicationReplayRepository.claim`



~~~python
def claim(*, dedupe_keys: tuple[str, ...], request_digest: str, claimed_at: datetime, lease_for: timedelta) -> CommunicationReplayClaim
~~~


Source: `lightbulb/communication_runtime.py:589`.

##### `lightbulb.communication_runtime.InMemoryCommunicationReplayRepository.complete`



~~~python
def complete(claim: CommunicationReplayClaim, *, result: CommunicationTraceResult) -> None
~~~


Source: `lightbulb/communication_runtime.py:675`.

##### `lightbulb.communication_runtime.InMemoryCommunicationReplayRepository.release`



~~~python
def release(claim: CommunicationReplayClaim) -> None
~~~


Source: `lightbulb/communication_runtime.py:711`.

### `lightbulb.communication_runtime.CrmTouchpointSink`

class. Source: `lightbulb/communication_runtime.py:721`.

Append-only CRM boundary; implementations must be idempotent.

#### Methods

##### `lightbulb.communication_runtime.CrmTouchpointSink.append`



~~~python
def append(receipt: CrmTouchpointReceipt, *, scope: DynamicWorkflowScope, scope_keyring: CommunicationScopeKeyRing) -> CrmTouchpointReceipt
~~~


Source: `lightbulb/communication_runtime.py:724`.

### `lightbulb.communication_runtime.InMemoryCrmTouchpointSink`

class. Source: `lightbulb/communication_runtime.py:733`.

Thread-safe, privacy-minimised sink suitable for tests and local runs.

#### Methods

##### `lightbulb.communication_runtime.InMemoryCrmTouchpointSink.append`



~~~python
def append(receipt: CrmTouchpointReceipt, *, scope: DynamicWorkflowScope, scope_keyring: CommunicationScopeKeyRing) -> CrmTouchpointReceipt
~~~


Source: `lightbulb/communication_runtime.py:741`.

##### `lightbulb.communication_runtime.InMemoryCrmTouchpointSink.receipts`



~~~python
@property
def receipts() -> tuple[CrmTouchpointReceipt, ...]
~~~


Source: `lightbulb/communication_runtime.py:785`.

### `lightbulb.communication_runtime.CommunicationRuntime`

class. Source: `lightbulb/communication_runtime.py:932`.

Verify, interpret, and record one exact reply without effects.

#### Methods

##### `lightbulb.communication_runtime.CommunicationRuntime.process_reply`



~~~python
def process_reply(*, scope: DynamicWorkflowScope | Mapping[str, Any], route: CommunicationEmailRuntimeRoute | Mapping[str, Any], materialization: CommunicationMaterializationResult | Mapping[str, Any], thread: CommunicationThreadBinding | Mapping[str, Any], outbound_sender_endpoint: CommunicationEndpointBinding | Mapping[str, Any], contact_party: CommunicationPartyRef | Mapping[str, Any], contact_endpoint: CommunicationEndpointBinding | Mapping[str, Any], provider_event: CommunicationProviderEvent | Mapping[str, Any], private_inbound: CommunicationPrivateInbound | Mapping[str, Any], crm: CommunicationCrmTraceBinding | Mapping[str, Any], now: datetime) -> CommunicationTraceResult
~~~


Process one sealed reply or return its completed replay.

Source: `lightbulb/communication_runtime.py:968`.

## Module `lightbulb.communication_twilio_sms`

Closed contracts for the dark governed Twilio SMS tracer.

### `lightbulb.communication_twilio_sms.canonical_twilio_e164`

function. Source: `lightbulb/communication_twilio_sms.py:70`.



~~~python
canonical_twilio_e164(value: str) -> str
~~~


Require one already-canonical E.164 destination; never guess a country.

### `lightbulb.communication_twilio_sms.canonical_twilio_message_sid`

function. Source: `lightbulb/communication_twilio_sms.py:82`.



~~~python
canonical_twilio_message_sid(value: str) -> str
~~~


Require the first-tracer Twilio Message SID shape.

### `lightbulb.communication_twilio_sms.communication_twilio_sms_private_identifier_commitment`

function. Source: `lightbulb/communication_twilio_sms.py:110`.



~~~python
communication_twilio_sms_private_identifier_commitment(*, scope: DynamicWorkflowScope, key_id: str, scope_keyring: CommunicationScopeKeyRing, connector_account_ref: str, route_digest: str, identifier_kind: Literal['message_sid'], value: str) -> str
~~~


Key a provider identifier by tenant, company, project route, and kind.

### `lightbulb.communication_twilio_sms.TwilioSmsProviderStatus`

class. Source: `lightbulb/communication_twilio_sms.py:144`.

#### Methods

##### `lightbulb.communication_twilio_sms.TwilioSmsProviderStatus.event_type`



~~~python
@property
def event_type() -> CommunicationProviderEventType
~~~


Source: `lightbulb/communication_twilio_sms.py:164`.

##### `lightbulb.communication_twilio_sms.TwilioSmsProviderStatus.terminal`



~~~python
@property
def terminal() -> bool
~~~


Source: `lightbulb/communication_twilio_sms.py:155`.

### `lightbulb.communication_twilio_sms.CommunicationTwilioSmsWriteRoute`

class. Source: `lightbulb/communication_twilio_sms.py:192`.

Fields:
- `schema_id: Literal['lightbulb.communication_twilio_sms_write_route.v1'] = Field(default=COMMUNICATION_TWILIO_SMS_WRITE_ROUTE_SCHEMA, alias='schema')`
- `tool: Literal['twilio.send_sms_turn'] = TWILIO_SEND_SMS_TOOL`

### `lightbulb.communication_twilio_sms.CommunicationTwilioSmsStatusRoute`

class. Source: `lightbulb/communication_twilio_sms.py:199`.

Fields:
- `schema_id: Literal['lightbulb.communication_twilio_sms_status_route.v1'] = Field(default=COMMUNICATION_TWILIO_SMS_STATUS_ROUTE_SCHEMA, alias='schema')`
- `tool: Literal['twilio.lookup_message_status'] = TWILIO_LOOKUP_MESSAGE_STATUS_TOOL`

### `lightbulb.communication_twilio_sms.CommunicationPrivateTwilioSmsTurn`

class. Source: `lightbulb/communication_twilio_sms.py:206`.

Transient approved destination and content loaded by the trusted host.

Fields:
- `schema_id: Literal['lightbulb.communication_private_twilio_sms_turn.v1'] = Field(default=COMMUNICATION_PRIVATE_TWILIO_SMS_TURN_SCHEMA, alias='schema')`
- `private_content_ref: str = Field(min_length=1, max_length=200)`
- `sender_endpoint_ref: str = Field(min_length=1, max_length=200)`
- `recipient_endpoint_ref: str = Field(min_length=1, max_length=200)`
- `recipient_address: str = Field(min_length=9, max_length=16, repr=False)`
- `body: str = Field(min_length=1, max_length=1600, repr=False)`

#### Methods

##### `lightbulb.communication_twilio_sms.CommunicationPrivateTwilioSmsTurn.connector_arguments`



~~~python
def connector_arguments() -> dict[str, str]
~~~


Source: `lightbulb/communication_twilio_sms.py:239`.

### `lightbulb.communication_twilio_sms.TwilioSmsAcceptance`

class. Source: `lightbulb/communication_twilio_sms.py:243`.

Live provider acceptance proof; Message SID enters encrypted custody.

Fields:
- `schema_id: Literal['lightbulb.twilio_sms_acceptance.v1'] = Field(default=TWILIO_SMS_ACCEPTANCE_SCHEMA, alias='schema')`
- `message_sid: str = Field(alias='messageSid', repr=False)`
- `status: Literal['accepted', 'queued', 'sending', 'sent']`
- `body_sha256: str = Field(alias='bodySha256', pattern='^[0-9a-f]{64}$')`
- `accepted: Literal[True]`
- `provider_observed: Literal[True] = Field(alias='providerObserved')`

### `lightbulb.communication_twilio_sms.TwilioSmsStatus`

class. Source: `lightbulb/communication_twilio_sms.py:262`.

Fresh ephemeral status response; it never claims a conversational reply.

Fields:
- `schema_id: Literal['lightbulb.twilio_sms_status.v1'] = Field(default=TWILIO_SMS_STATUS_SCHEMA, alias='schema')`
- `message_sid: str = Field(alias='messageSid', repr=False)`
- `recipient_address: str = Field(alias='to', repr=False)`
- `status: TwilioSmsProviderStatus`
- `event_type: CommunicationProviderEventType = Field(alias='eventType')`
- `terminal: bool`
- `body_sha256: str = Field(alias='bodySha256', pattern='^[0-9a-f]{64}$')`
- `error_code: int | None = Field(default=None, alias='errorCode', ge=0, le=99999)`
- `provider_updated_at: str | None = Field(default=None, alias='providerUpdatedAt')`
- `provider_observed: Literal[True] = Field(alias='providerObserved')`
- `private_data: Literal[True] = Field(alias='privateData')`
- `retention: Literal['ephemeral_response_only']`

### `lightbulb.communication_twilio_sms.CommunicationTwilioSmsPrivateResultCommitments`

class. Source: `lightbulb/communication_twilio_sms.py:312`.

Fields:
- `schema_id: Literal['lightbulb.communication_twilio_sms_private_result_commitments.v1'] = Field(default=COMMUNICATION_TWILIO_SMS_PRIVATE_RESULT_COMMITMENTS_SCHEMA, alias='schema')`
- `key_id: str = Field(min_length=8, max_length=80)`
- `provider_message_sid_hmac_v1: str = Field(pattern='^[0-9a-f]{64}$')`
- `body_sha256: str = Field(pattern='^[0-9a-f]{64}$')`

### `lightbulb.communication_twilio_sms.CommunicationPrivateTwilioSmsDispatch`

class. Source: `lightbulb/communication_twilio_sms.py:324`.

Encrypted-outbox identity derived from one verified send acceptance.

Fields:
- `schema_id: Literal['lightbulb.communication_private_twilio_sms_dispatch.v1'] = Field(default=COMMUNICATION_PRIVATE_TWILIO_SMS_DISPATCH_SCHEMA, alias='schema')`
- `provider_message_sid: str = Field(repr=False)`
- `provider_commitment_key_id: str = Field(min_length=8, max_length=80)`
- `provider_message_sid_hmac_v1: str = Field(pattern='^[0-9a-f]{64}$')`
- `body_sha256: str = Field(pattern='^[0-9a-f]{64}$')`
- `accepted: Literal[True]`
- `provider_observed: Literal[True]`

## Module `lightbulb.communication_whatsapp_observer`

Fail-closed WhatsApp webhook observation for Spring-hosted custody.

### `lightbulb.communication_whatsapp_observer.communication_whatsapp_private_event_id_commitment`

function. Source: `lightbulb/communication_whatsapp_observer.py:186`.



~~~python
communication_whatsapp_private_event_id_commitment(*, scope: DynamicWorkflowScope | Mapping[str, Any], key_id: str, scope_keyring: CommunicationScopeKeyRing, connector_account_ref: str, route_digest: str, provider_event_id: str) -> str
~~~


HMAC one private webhook event ID to exact scope, account, and route.

### `lightbulb.communication_whatsapp_observer.whatsapp_provider_event_identity_digest`

function. Source: `lightbulb/communication_whatsapp_observer.py:231`.



~~~python
whatsapp_provider_event_identity_digest(*, exact_scope_digest: str, dispatch_receipt_digest: str, authority_binding_digest: str, connector_account_ref: str, route_digest: str, provider_message_sha256: str, provider_event_id_hmac_v1: str) -> str
~~~


Derive the stable, private-ID-free identity for one provider event.

### `lightbulb.communication_whatsapp_observer.whatsapp_webhook_event_digest`

function. Source: `lightbulb/communication_whatsapp_observer.py:257`.



~~~python
whatsapp_webhook_event_digest(*, provider_event_identity_digest: str, provider: OmnichannelProvider, channel: CommunicationChannel, mode: OmnichannelOutboundMode, provider_status: WhatsAppObservedStatus, jurisdiction: str, provider_conversation_sha256: str, body_sha256: str, private_payload_ref: str, provider_payload_sha256: str, authenticity_proof_ref: str, authenticity_proof_digest: str, webhook_signature_algorithm: str, webhook_signature_key_ref: str, webhook_signature_key_version: int, custody_ref: str, custody_digest: str, retention_policy_ref: str, retained_until: str, occurred_at: str, received_at: str, observed_at: str) -> str
~~~


Digest the exact public commitments in one private webhook event.

### `lightbulb.communication_whatsapp_observer.CommunicationWhatsAppWebhookObservation`

class. Source: `lightbulb/communication_whatsapp_observer.py:313`.

Spring-sealed proof of one authenticated, privately retained webhook.

Fields:
- `schema_id: Literal['lightbulb.communication_whatsapp_webhook_observation.v1'] = Field(default=COMMUNICATION_WHATSAPP_WEBHOOK_OBSERVATION_SCHEMA, alias='schema')`
- `observation_ref: OpaqueRef`
- `event_ref: OpaqueRef`
- `provider: Literal[OmnichannelProvider.WHATSAPP_CLOUD] = OmnichannelProvider.WHATSAPP_CLOUD`
- `channel: Literal[CommunicationChannel.WHATSAPP] = CommunicationChannel.WHATSAPP`
- `mode: WhatsAppMode`
- `dispatch_receipt_digest: Sha256Digest`
- `authority_binding_digest: Sha256Digest`
- `connector_account_ref: OpaqueRef`
- `route_digest: Sha256Digest`
- `provider_commitment_key_id: str = Field(min_length=8, max_length=80)`
- `provider_message_sha256: Sha256Digest`
- `provider_conversation_sha256: Sha256Digest`
- `body_sha256: Sha256Digest`
- `jurisdiction: JurisdictionCode`
- `provider_event_id_hmac_v1: Sha256Digest`
- `provider_event_identity_digest: Sha256Digest`
- `provider_status: WhatsAppObservedStatus`
- `private_payload_ref: OpaqueRef`
- `provider_payload_sha256: Sha256Digest`
- `webhook_event_digest: Sha256Digest`
- `authenticity: Literal[CommunicationAuthenticityGrade.VERIFIED] = CommunicationAuthenticityGrade.VERIFIED`
- `authenticity_proof_ref: OpaqueRef`
- `authenticity_proof_digest: Sha256Digest`
- `webhook_signature_algorithm: Literal['hmac_sha256'] = 'hmac_sha256'`
- `webhook_signature_key_ref: OpaqueRef`
- `webhook_signature_key_version: int = Field(ge=1)`
- `webhook_signature_verified: Literal[True] = True`
- `custody: Literal['spring_verified_webhook'] = 'spring_verified_webhook'`
- `custody_ref: OpaqueRef`
- `custody_digest: Sha256Digest`
- `private_payload_custodied: Literal[True] = True`
- `retention_policy_ref: OpaqueRef`
- `retained_until: str`
- `occurred_at: str`
- `received_at: str`
- `observed_at: str`
- `valid_until: str`

### `lightbulb.communication_whatsapp_observer.WhatsAppObservationEffectBoundary`

class. Source: `lightbulb/communication_whatsapp_observer.py:467`.

Fields:
- `connector_calls: Literal[0] = 0`
- `connector_reads: Literal[0] = 0`
- `connector_writes: Literal[0] = 0`
- `approvals_consumed: Literal[0] = 0`
- `local_or_host_state_written: Literal[False] = False`
- `provider_event_persisted: Literal[False] = False`
- `audit_written: Literal[False] = False`
- `external_systems_changed: Literal[False] = False`
- `crm_mutated: Literal[False] = False`
- `message_dispatched: Literal[False] = False`
- `provider_acceptance_promoted_to_delivery: Literal[False] = False`
- `reply_claimed: Literal[False] = False`
- `business_outcome_claimed: Literal[False] = False`
- `caller_claims_authenticated: Literal[False] = False`
- `spring_webhook_authentication_required: Literal[True] = True`
- `spring_durable_replay_custody_required: Literal[True] = True`

### `lightbulb.communication_whatsapp_observer.WhatsAppObservationResult`

class. Source: `lightbulb/communication_whatsapp_observer.py:509`.

Fields:
- `schema_id: Literal['lightbulb.communication_whatsapp_observation_result.v1'] = Field(default=COMMUNICATION_WHATSAPP_OBSERVATION_RESULT_SCHEMA, alias='schema')`
- `status: Literal['completed'] = 'completed'`
- `observation: CommunicationWhatsAppWebhookObservation`
- `dispatch_receipt_digest: Sha256Digest`
- `authority_binding_digest: Sha256Digest`
- `event: CommunicationProviderEvent`
- `normalized: ProviderObservationProposal`
- `retained_event_digests: tuple[Sha256Digest, ...] = Field(default=(), max_length=1000)`
- `operation_digest: Sha256Digest`
- `summary: str = Field(min_length=1, max_length=1000)`
- `effect_boundary: WhatsAppObservationEffectBoundary = Field(default_factory=WhatsAppObservationEffectBoundary)`

#### Methods

##### `lightbulb.communication_whatsapp_observer.WhatsAppObservationResult.to_dict`



~~~python
def to_dict() -> dict[str, Any]
~~~


Source: `lightbulb/communication_whatsapp_observer.py:529`.

### `lightbulb.communication_whatsapp_observer.observe_whatsapp_delivery`

function. Source: `lightbulb/communication_whatsapp_observer.py:809`.



~~~python
observe_whatsapp_delivery(*, scope: DynamicWorkflowScope | Mapping[str, Any], scope_keyring: CommunicationScopeKeyRing, dispatch_receipt: CommunicationDispatchReceipt | Mapping[str, Any], omnichannel_binding: CommunicationOmnichannelTurnBinding | Mapping[str, Any], private_dispatch: CommunicationPrivateWhatsAppDispatch | Mapping[str, Any], observation_artifact: CommunicationWhatsAppWebhookObservation | Mapping[str, Any], observed_at: datetime, retained_events: Sequence[CommunicationProviderEvent | Mapping[str, Any]]=()) -> WhatsAppObservationResult
~~~


Verify and normalize one Spring-authenticated WhatsApp webhook event.

## Module `lightbulb.compliance_controls`

Deterministic controls for compliance and regulated operations.

### `lightbulb.compliance_controls.RegulatedControlPolicy`

class. Source: `lightbulb/compliance_controls.py:189`.

Fields:
- `applicability: ComplianceApplicability = Field(default_factory=ComplianceApplicability)`
- `minimum_evidence_grade: PrimitiveEvidenceVerificationGrade = PrimitiveEvidenceVerificationGrade.ATTESTED`
- `max_evidence_age_hours: int = Field(default=720, ge=1, le=87600)`
- `maximum_control_test_age_days: int = Field(default=365, ge=1, le=3650)`
- `maximum_assessment_age_days: int = Field(default=365, ge=1, le=3650)`
- `maximum_kyc_review_age_days: int = Field(default=365, ge=1, le=3650)`
- `incident_report_deadline_hours: int = Field(default=72, ge=1, le=720)`
- `maximum_model_validation_age_days: int = Field(default=365, ge=1, le=3650)`

### `lightbulb.compliance_controls.RegulatedControlsInput`

class. Source: `lightbulb/compliance_controls.py:469`.

Fields:
- `schema_id: Literal['lightbulb.regulated_controls_input.v1'] = Field(default=REGULATED_CONTROLS_INPUT_SCHEMA, alias='schema')`
- `evaluation_ref: OpaqueRef`
- `analysis_as_of: str`
- `policy_controls: tuple[PolicyControlSnapshot, ...] = Field(default_factory=tuple, max_length=10000)`
- `assessments: tuple[ComplianceAssessmentSnapshot, ...] = Field(default_factory=tuple, max_length=10000)`
- `incidents: tuple[IncidentReportingSnapshot, ...] = Field(default_factory=tuple, max_length=10000)`
- `kyc_aml_subjects: tuple[KycAmlSnapshot, ...] = Field(default_factory=tuple, max_length=100000)`
- `regulated_processes: tuple[RegulatedProcessSnapshot, ...] = Field(default_factory=tuple, max_length=10000)`
- `export_transactions: tuple[ExportControlSnapshot, ...] = Field(default_factory=tuple, max_length=100000)`
- `retention_records: tuple[RetentionRecordSnapshot, ...] = Field(default_factory=tuple, max_length=100000)`
- `models: tuple[ModelRiskSnapshot, ...] = Field(default_factory=tuple, max_length=100000)`
- `policy: RegulatedControlPolicy = Field(default_factory=RegulatedControlPolicy)`

### `lightbulb.compliance_controls.ComplianceEffectBoundary`

class. Source: `lightbulb/compliance_controls.py:609`.

Fields:
- `connector_reads: Literal[0] = 0`
- `connector_writes: Literal[0] = 0`
- `approvals_consumed: Literal[0] = 0`
- `reports_or_filings_submitted: Literal[False] = False`
- `subjects_approved: Literal[False] = False`
- `records_disposed: Literal[False] = False`
- `models_deployed: Literal[False] = False`
- `regulated_systems_changed: Literal[False] = False`
- `external_systems_changed: Literal[False] = False`

### `lightbulb.compliance_controls.RegulatedControlsResult`

class. Source: `lightbulb/compliance_controls.py:632`.

Fields:
- `schema_id: Literal['lightbulb.regulated_controls_result.v1'] = Field(default=REGULATED_CONTROLS_RESULT_SCHEMA, alias='schema')`
- `evaluation_ref: OpaqueRef`
- `analysis_as_of: str`
- `assurance_grade: PrimitiveEvidenceVerificationGrade`
- `applicability: ComplianceApplicability`
- `proposed_disposition: ComplianceDisposition`
- `gates: tuple[RegulatedGateResult, ...]`
- `findings: tuple[RegulatedControlFinding, ...]`
- `obligation_proposals: tuple[ComplianceObligationProposal, ...]`
- `source_snapshot_digests: dict[str, str]`
- `evidence_refs: tuple[OpaqueRef, ...]`
- `effect_boundary: ComplianceEffectBoundary = Field(default_factory=ComplianceEffectBoundary)`
- `result_digest: str = Field(default=_ZERO_DIGEST, pattern='^[0-9a-f]{64}$')`

### `lightbulb.compliance_controls.evaluate_regulated_controls`

function. Source: `lightbulb/compliance_controls.py:838`.



~~~python
evaluate_regulated_controls(inputs: RegulatedControlsInput | Mapping[str, Any]) -> RegulatedControlsResult
~~~


Evaluate regulated controls without performing a regulated action.

### `lightbulb.compliance_controls.EvaluateRegulatedControlsPrimitive`

class. Source: `lightbulb/compliance_controls.py:1489`.

#### Methods

##### `lightbulb.compliance_controls.EvaluateRegulatedControlsPrimitive.implementation_contract`



~~~python
def implementation_contract() -> dict[str, Any]
~~~


Source: `lightbulb/compliance_controls.py:1558`.

## Module `lightbulb.compliance_risk_lifecycle`

Deterministic compliance, risk, and regulated-operations case lifecycles.

### `lightbulb.compliance_risk_lifecycle.ComplianceRiskScope`

class. Source: `lightbulb/compliance_risk_lifecycle.py:318`.

Fields:
- `schema_id: Literal['lightbulb.compliance_risk_scope.v2'] = Field(default=COMPLIANCE_RISK_SCOPE_SCHEMA, alias='schema')`
- `tenant_ref: OpaqueRef`
- `company_ref: OpaqueRef`
- `project_ref: OpaqueRef`
- `project_id: UUID`
- `jurisdiction_ref: OpaqueRef`
- `regime_ref: OpaqueRef`
- `case_ref: OpaqueRef`
- `case_kind: ComplianceRiskCaseKind`
- `subject_ref: OpaqueRef`
- `model_ref: OpaqueRef | None = None`
- `applicable_quality_domains: tuple[RegulatedDomain, ...] = Field(default_factory=tuple, max_length=6)`
- `evidence_custody_ref: OpaqueRef`
- `authorized_evidence_issuer_refs: tuple[OpaqueRef, ...] = Field(min_length=1, max_length=100)`

### `lightbulb.compliance_risk_lifecycle.compliance_risk_scope_digest`

function. Source: `lightbulb/compliance_risk_lifecycle.py:385`.



~~~python
compliance_risk_scope_digest(scope: ComplianceRiskScope | Mapping[str, Any]) -> str
~~~


### `lightbulb.compliance_risk_lifecycle.RegulatedEvidenceEnvelope`

class. Source: `lightbulb/compliance_risk_lifecycle.py:392`.

Fields:
- `schema_id: Literal['lightbulb.regulated_evidence_envelope.v1'] = Field(default='lightbulb.regulated_evidence_envelope.v1', alias='schema')`
- `sequence: int = Field(ge=1, le=500)`
- `use_ref: OpaqueRef`
- `artifact_ref: OpaqueRef`
- `artifact_digest: Sha256Digest`
- `predecessor_lineage_digest: Sha256Digest`
- `lineage_digest: Sha256Digest`
- `custody_ref: OpaqueRef`
- `retained_until: str`
- `single_use: StrictTrue = True`
- `reference: PrimitiveEvidenceRef`

### `lightbulb.compliance_risk_lifecycle.ComplianceRiskTransitionCommand`

class. Source: `lightbulb/compliance_risk_lifecycle.py:867`.

Fields:
- `schema_id: Literal['lightbulb.compliance_risk_transition_command.v2'] = Field(default=COMPLIANCE_RISK_COMMAND_SCHEMA, alias='schema')`
- `kind: TransitionKind`
- `scope: ComplianceRiskScope`
- `transition_ref: OpaqueRef`
- `idempotency_key: OpaqueRef`
- `expected_version: int = Field(ge=0, le=MAX_COMPLIANCE_RISK_TRANSITIONS)`
- `expected_state_digest: Sha256Digest`
- `expected_evidence_lineage_digest: Sha256Digest`
- `occurred_at: str`
- `host_outcome_report: Literal['reported_certain', 'reported_in_doubt', 'unreported'] = 'reported_certain'`
- `requested_by_ref: OpaqueRef`
- `evidence_custody_ref: OpaqueRef`
- `required_evidence_retention_until: str`
- `evidence: tuple[RegulatedEvidenceEnvelope, ...] = Field(min_length=1, max_length=20)`
- `package: ComplianceDomainPackage`
- `request_digest: Sha256Digest = GENESIS_STATE_DIGEST`

### `lightbulb.compliance_risk_lifecycle.compliance_risk_command_content_digest`

function. Source: `lightbulb/compliance_risk_lifecycle.py:1220`.



~~~python
compliance_risk_command_content_digest(command: ComplianceRiskTransitionCommand | Mapping[str, Any]) -> str
~~~


Digest normalized command content without circular digest fields.

### `lightbulb.compliance_risk_lifecycle.compliance_risk_command_digest`

function. Source: `lightbulb/compliance_risk_lifecycle.py:1234`.



~~~python
compliance_risk_command_digest(command: ComplianceRiskTransitionCommand | Mapping[str, Any]) -> str
~~~


Digest the full normalized command, excluding only request_digest.

### `lightbulb.compliance_risk_lifecycle.seal_compliance_risk_command`

function. Source: `lightbulb/compliance_risk_lifecycle.py:1244`.



~~~python
seal_compliance_risk_command(command: Mapping[str, Any]) -> dict[str, Any]
~~~


Normalize and content-seal one caller-prepared transition command.

### `lightbulb.compliance_risk_lifecycle.ComplianceRiskTransitionCandidate`

class. Source: `lightbulb/compliance_risk_lifecycle.py:1285`.

Fields:
- `schema_id: Literal['lightbulb.compliance_risk_transition_candidate.v2'] = Field(default='lightbulb.compliance_risk_transition_candidate.v2', alias='schema')`
- `to_version: int = Field(ge=1, le=MAX_COMPLIANCE_RISK_TRANSITIONS)`
- `prior_state_digest: Sha256Digest`
- `scope_digest: Sha256Digest`
- `command_content_digest: Sha256Digest`
- `evidence_digest: Sha256Digest`
- `transition_digest: Sha256Digest`
- `command: ComplianceRiskTransitionCommand`

### `lightbulb.compliance_risk_lifecycle.ComplianceRiskLifecycleSnapshot`

class. Source: `lightbulb/compliance_risk_lifecycle.py:1383`.

Fields:
- `schema_id: Literal['lightbulb.compliance_risk_lifecycle_snapshot.v2'] = Field(default=COMPLIANCE_RISK_SNAPSHOT_SCHEMA, alias='schema')`
- `scope: ComplianceRiskScope`
- `status: LifecycleStatus`
- `version: int = Field(ge=1, le=MAX_COMPLIANCE_RISK_TRANSITIONS)`
- `transition_history: tuple[ComplianceRiskTransitionCandidate, ...] = Field(min_length=1, max_length=MAX_COMPLIANCE_RISK_TRANSITIONS)`
- `evidence_lineage_digest: Sha256Digest`
- `policy_control: PolicyControlOwnershipPackage | None = None`
- `control_test: ControlTestEvidencePackage | None = None`
- `assessment: ComplianceAssessmentPackage | None = None`
- `incident_breach: IncidentBreachPackage | None = None`
- `kyc_aml_case: KycAmlCasePackage | None = None`
- `regulated_quality: RegulatedQualityPackage | None = None`
- `export_control: ExportControlPackage | None = None`
- `retention_legal_hold: RetentionLegalHoldPackage | None = None`
- `model_risk: ModelRiskPackage | None = None`
- `state_digest: Sha256Digest`

### `lightbulb.compliance_risk_lifecycle.ComplianceRiskLifecycleInput`

class. Source: `lightbulb/compliance_risk_lifecycle.py:1492`.

Fields:
- `schema_id: Literal['lightbulb.compliance_risk_lifecycle_input.v2'] = Field(default=COMPLIANCE_RISK_INPUT_SCHEMA, alias='schema')`
- `scope: ComplianceRiskScope`
- `command: ComplianceRiskTransitionCommand`
- `current_snapshot: ComplianceRiskLifecycleSnapshot | None = None`

### `lightbulb.compliance_risk_lifecycle.ComplianceRiskEffectBoundary`

class. Source: `lightbulb/compliance_risk_lifecycle.py:1533`.

Fields:
- `sdk_candidate_only: StrictTrue = True`
- `identity_or_rbac_changed: StrictFalse = False`
- `legal_determination_made: StrictFalse = False`
- `filing_or_report_submitted: StrictFalse = False`
- `legal_hold_applied: StrictFalse = False`
- `account_decision_made: StrictFalse = False`
- `risk_accepted: StrictFalse = False`
- `persistence_written: StrictFalse = False`
- `approval_recorded: StrictFalse = False`
- `audit_record_written: StrictFalse = False`
- `regulated_system_changed: StrictFalse = False`
- `connector_effect_executed: StrictFalse = False`

### `lightbulb.compliance_risk_lifecycle.ComplianceRiskLifecycleResult`

class. Source: `lightbulb/compliance_risk_lifecycle.py:1606`.

Fields:
- `schema_id: Literal['lightbulb.compliance_risk_lifecycle_result.v2'] = Field(default=COMPLIANCE_RISK_RESULT_SCHEMA, alias='schema')`
- `candidate_validated: bool`
- `snapshot: ComplianceRiskLifecycleSnapshot | None = None`
- `transition_receipt: ComplianceRiskTransitionReceipt`
- `effect_boundary: ComplianceRiskEffectBoundary = Field(default_factory=ComplianceRiskEffectBoundary)`

### `lightbulb.compliance_risk_lifecycle.materialize_compliance_risk_candidate`

function. Source: `lightbulb/compliance_risk_lifecycle.py:1935`.



~~~python
materialize_compliance_risk_candidate(inputs: ComplianceRiskLifecycleInput | Mapping[str, Any]) -> ComplianceRiskLifecycleResult
~~~


Materialize exactly one bounded, SDK-only regulated candidate transition.

### `lightbulb.compliance_risk_lifecycle.ProposeComplianceRiskTransitionPrimitive`

class. Source: `lightbulb/compliance_risk_lifecycle.py:2103`.

Fields:
- `example_inputs: Mapping[str, Any] = _compliance_risk_example_inputs()`

#### Methods

##### `lightbulb.compliance_risk_lifecycle.ProposeComplianceRiskTransitionPrimitive.implementation_contract`



~~~python
def implementation_contract() -> dict[str, Any]
~~~


Source: `lightbulb/compliance_risk_lifecycle.py:2128`.

## Module `lightbulb.connector_bindings`

One declarative Connector Binding registry for every Executable Primitive.

### `lightbulb.connector_bindings.ConnectorBindingError`

class. Source: `lightbulb/connector_bindings.py:51`.

No Tool is bound for a requested capability or selector value.

### `lightbulb.connector_bindings.ConnectorBinding`

class. Source: `lightbulb/connector_bindings.py:78`.

One resolved row of the registry.

Fields:
- `capability: str`
- `selector: str`
- `selector_value: str`
- `tool: str`

#### Methods

##### `lightbulb.connector_bindings.ConnectorBinding.provider`



~~~python
@property
def provider() -> str
~~~


Provider derived exactly as ``ConnectorToolContract.provider`` does.

Source: `lightbulb/connector_bindings.py:87`.

### `lightbulb.connector_bindings.ConnectorCapability`

class. Source: `lightbulb/connector_bindings.py:94`.

Every Tool one Executable Primitive may route to, keyed by selector value.

Fields:
- `capability: str`
- `selector: str`
- `bindings: Mapping[str, str]`

#### Methods

##### `lightbulb.connector_bindings.ConnectorCapability.rows`



~~~python
def rows() -> tuple[ConnectorBinding, ...]
~~~


Source: `lightbulb/connector_bindings.py:137`.

### `lightbulb.connector_bindings.ConnectorBindingRegistry`

class. Source: `lightbulb/connector_bindings.py:149`.

Resolve ``(capability, selector value)`` to one declared Tool name.

#### Methods

##### `lightbulb.connector_bindings.ConnectorBindingRegistry.capabilities`



~~~python
def capabilities() -> tuple[str, ...]
~~~


Source: `lightbulb/connector_bindings.py:165`.

##### `lightbulb.connector_bindings.ConnectorBindingRegistry.declaration`



~~~python
def declaration(capability: str) -> ConnectorCapability
~~~


Source: `lightbulb/connector_bindings.py:171`.

##### `lightbulb.connector_bindings.ConnectorBindingRegistry.providers`



~~~python
def providers(capability: str) -> tuple[str, ...]
~~~


Selector values declared for a capability, in declaration order.

Source: `lightbulb/connector_bindings.py:188`.

##### `lightbulb.connector_bindings.ConnectorBindingRegistry.resolve`



~~~python
def resolve(capability: str, selector_value: str) -> str
~~~


Return the single Tool bound to this capability and selector value.

Source: `lightbulb/connector_bindings.py:207`.

##### `lightbulb.connector_bindings.ConnectorBindingRegistry.rows`



~~~python
def rows() -> tuple[ConnectorBinding, ...]
~~~


Source: `lightbulb/connector_bindings.py:200`.

##### `lightbulb.connector_bindings.ConnectorBindingRegistry.selector`



~~~python
def selector(capability: str) -> str
~~~


Source: `lightbulb/connector_bindings.py:185`.

##### `lightbulb.connector_bindings.ConnectorBindingRegistry.supports`



~~~python
def supports(capability: str) -> bool
~~~


Source: `lightbulb/connector_bindings.py:168`.

##### `lightbulb.connector_bindings.ConnectorBindingRegistry.to_dict`



~~~python
def to_dict() -> Dict[str, Any]
~~~


Source: `lightbulb/connector_bindings.py:230`.

##### `lightbulb.connector_bindings.ConnectorBindingRegistry.tools`



~~~python
def tools(capability: str) -> tuple[str, ...]
~~~


Distinct Tool names a capability may route to, in declaration order.

Source: `lightbulb/connector_bindings.py:193`.

### `lightbulb.connector_bindings.resolve_connector_tool`

function. Source: `lightbulb/connector_bindings.py:341`.



~~~python
resolve_connector_tool(capability: str, selector_value: str) -> str
~~~


Resolve one Tool name through the default Connector Binding registry.

## Module `lightbulb.connector_conformance`

Executable connector contracts for every provider used by SDK primitives.

### `lightbulb.connector_conformance.ConnectorToolContract`

class. Source: `lightbulb/connector_conformance.py:24`.

Fields:
- `tool: str`
- `effect: ConnectorEffect`
- `approval_required: bool = False`
- `supplied_arguments: tuple[str, ...]`
- `output_ref_fields: tuple[str, ...] = ('id', 'externalId', 'external_id')`

#### Methods

##### `lightbulb.connector_conformance.ConnectorToolContract.fixture`



~~~python
def fixture() -> dict[str, Any]
~~~


Source: `lightbulb/connector_conformance.py:37`.

##### `lightbulb.connector_conformance.ConnectorToolContract.provider`



~~~python
@property
def provider() -> str
~~~


Source: `lightbulb/connector_conformance.py:34`.

### `lightbulb.connector_conformance.ConnectorConformanceResult`

class. Source: `lightbulb/connector_conformance.py:44`.

Fields:
- `tool: str`
- `provider: str`
- `primitive_refs: tuple[str, ...]`
- `passed: bool`
- `checks: Mapping[str, bool]`
- `failures: tuple[str, ...] = ()`

### `lightbulb.connector_conformance.ConnectorConformanceReport`

class. Source: `lightbulb/connector_conformance.py:55`.

Fields:
- `schema_id: str = Field(default=CONNECTOR_CONFORMANCE_SCHEMA, alias='schema')`
- `passed: bool`
- `contract_count: int`
- `provider_count: int`
- `live_schema_checked: bool`
- `missing_contracts: list[str] = Field(default_factory=list)`
- `stale_contracts: list[str] = Field(default_factory=list)`
- `failed_tools: list[str] = Field(default_factory=list)`
- `failed_providers: list[str] = Field(default_factory=list)`
- `results: list[ConnectorConformanceResult] = Field(default_factory=list)`

#### Methods

##### `lightbulb.connector_conformance.ConnectorConformanceReport.to_dict`



~~~python
def to_dict() -> dict[str, Any]
~~~


Source: `lightbulb/connector_conformance.py:69`.

### `lightbulb.connector_conformance.run_connector_conformance`

function. Source: `lightbulb/connector_conformance.py:436`.



~~~python
run_connector_conformance(*, live_tool_schemas: Iterable[Mapping[str, Any]] | None=None, contracts: Iterable[ConnectorToolContract]=CONNECTOR_TOOL_CONTRACTS) -> ConnectorConformanceReport
~~~


Run deterministic policy checks and optional hosted-schema drift checks.

## Module `lightbulb.connector_execution`

Typed Connector Execution contracts for SDK-native business workflows.

### `lightbulb.connector_execution.ConnectorEffect`

class. Source: `lightbulb/connector_execution.py:110`.

### `lightbulb.connector_execution.ConnectorExecutionStatus`

class. Source: `lightbulb/connector_execution.py:116`.

### `lightbulb.connector_execution.ConnectorErrorKind`

class. Source: `lightbulb/connector_execution.py:124`.

### `lightbulb.connector_execution.ConnectorExecutionProvenance`

class. Source: `lightbulb/connector_execution.py:137`.

Server-attested custody needed before an effect becomes workflow evidence.

Fields:
- `schema_id: Literal['lightbulb.connector_execution_provenance.v1'] = Field(default=CONNECTOR_EXECUTION_PROVENANCE_SCHEMA, alias='schema')`
- `tool: str`
- `tool_version: int = Field(ge=1)`
- `server_effect: ConnectorEffect`
- `connector_account_ref: str = Field(min_length=1, max_length=200)`
- `tenant_connector_id: UUID`
- `project_id: UUID`
- `route_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `journal_ref: str = Field(min_length=1, max_length=200)`
- `request_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `receipt_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `approval_ref: str | None = Field(default=None, min_length=1, max_length=200)`
- `approval_receipt_digest: str | None = Field(default=None, pattern='^[0-9a-f]{64}$')`
- `completed_at: str`

### `lightbulb.connector_execution.ExecutionScope`

class. Source: `lightbulb/connector_execution.py:219`.

Opaque correlation scope; hosted adapters use authenticated client scope.

Fields:
- `tenant_ref: str = 'authenticated'`
- `company_ref: str = 'selected'`
- `project_ref: str = Field(min_length=1, max_length=160)`
- `project_id: UUID | None = None`
- `actor_ref: str | None = Field(default=None, max_length=160)`

### `lightbulb.connector_execution.TrustedWorkflowIdentity`

class. Source: `lightbulb/connector_execution.py:242`.

Immutable identity minted only from a signature-v2-or-newer worker envelope.

Fields:
- `workflow_instance_id: str`
- `step_id: str`
- `step_generation: int`

#### Methods

##### `lightbulb.connector_execution.TrustedWorkflowIdentity.from_verified_envelope`



~~~python
def from_verified_envelope(envelope: Any) -> 'TrustedWorkflowIdentity'
~~~


Source: `lightbulb/connector_execution.py:262`.

### `lightbulb.connector_execution.ConnectorExecutionRequest`

class. Source: `lightbulb/connector_execution.py:466`.

Fields:
- `schema_id: str = Field(default=CONNECTOR_EXECUTION_REQUEST_SCHEMA, alias='schema')`
- `tool: str`
- `arguments: Dict[str, Any] = Field(default_factory=dict)`
- `scope: ExecutionScope`
- `connector_account_ref: str | None = Field(default=None, min_length=1, max_length=200)`
- `effect: ConnectorEffect = ConnectorEffect.READ`
- `approval_required: bool = False`
- `approval_ref: str | None = Field(default=None, max_length=200)`
- `preview_only: bool = False`
- `idempotency_key: str | None = Field(default=None, max_length=240)`
- `metadata: Dict[str, Any] = Field(default_factory=dict)`

#### Methods

##### `lightbulb.connector_execution.ConnectorExecutionRequest.custody_fingerprint`



~~~python
def custody_fingerprint() -> str
~~~


Digest the exact request that a governed execution receipt must bind.

Source: `lightbulb/connector_execution.py:519`.

##### `lightbulb.connector_execution.ConnectorExecutionRequest.fingerprint`



~~~python
def fingerprint() -> str
~~~


Source: `lightbulb/connector_execution.py:505`.

##### `lightbulb.connector_execution.ConnectorExecutionRequest.to_dict`



~~~python
def to_dict() -> Dict[str, Any]
~~~


Source: `lightbulb/connector_execution.py:551`.

### `lightbulb.connector_execution.ConnectorExecutionResult`

class. Source: `lightbulb/connector_execution.py:555`.

Fields:
- `schema_id: str = Field(default=CONNECTOR_EXECUTION_RESULT_SCHEMA, alias='schema')`
- `status: ConnectorExecutionStatus`
- `tool: str`
- `output: Dict[str, Any] = Field(default_factory=dict)`
- `message: str = ''`
- `approval_ref: str | None = None`
- `approval_receipt_digest: str | None = Field(default=None, pattern='^[0-9a-f]{64}$')`
- `error_kind: ConnectorErrorKind | None = None`
- `error_code: str | None = None`
- `retryable: bool = False`
- `cached: bool = False`
- `provenance: ConnectorExecutionProvenance | None = None`
- `unverified_recovery_journal_locator: str | None = Field(default=None, min_length=36, max_length=36, description='Untrusted routing hint from a hosted ambiguity response; Spring must authenticate and reauthorize it before recovery.')`

#### Methods

##### `lightbulb.connector_execution.ConnectorExecutionResult.to_dict`



~~~python
def to_dict() -> Dict[str, Any]
~~~


Source: `lightbulb/connector_execution.py:621`.

### `lightbulb.connector_execution.ConnectorExecutor`

class. Source: `lightbulb/connector_execution.py:626`.

#### Methods

##### `lightbulb.connector_execution.ConnectorExecutor.execute`



~~~python
def execute(request: ConnectorExecutionRequest) -> ConnectorExecutionResult
~~~


Source: `lightbulb/connector_execution.py:629`.

##### `lightbulb.connector_execution.ConnectorExecutor.supports`



~~~python
def supports(tool: str) -> bool
~~~


Source: `lightbulb/connector_execution.py:627`.

### `lightbulb.connector_execution.HostedConnectorExecutor`

class. Source: `lightbulb/connector_execution.py:787`.

Connector adapter backed by Spring-owned effect and approval authority.

#### Methods

##### `lightbulb.connector_execution.HostedConnectorExecutor.execute`



~~~python
def execute(request: ConnectorExecutionRequest) -> ConnectorExecutionResult
~~~


Source: `lightbulb/connector_execution.py:846`.

##### `lightbulb.connector_execution.HostedConnectorExecutor.from_verified_envelope`



~~~python
def from_verified_envelope(client: Any, envelope: Any, *, available_tools: Iterable[str] | None=None) -> 'HostedConnectorExecutor'
~~~


Source: `lightbulb/connector_execution.py:822`.

##### `lightbulb.connector_execution.HostedConnectorExecutor.supports`



~~~python
def supports(tool: str) -> bool
~~~


Source: `lightbulb/connector_execution.py:840`.

### `lightbulb.connector_execution.InMemoryConnectorExecutor`

class. Source: `lightbulb/connector_execution.py:1114`.

Deterministic connector adapter for project tests and local simulation.

#### Methods

##### `lightbulb.connector_execution.InMemoryConnectorExecutor.execute`



~~~python
def execute(request: ConnectorExecutionRequest) -> ConnectorExecutionResult
~~~


Source: `lightbulb/connector_execution.py:1143`.

##### `lightbulb.connector_execution.InMemoryConnectorExecutor.register`



~~~python
def register(tool: str, handler: ConnectorHandler) -> None
~~~


Source: `lightbulb/connector_execution.py:1134`.

##### `lightbulb.connector_execution.InMemoryConnectorExecutor.requests`



~~~python
@property
def requests() -> tuple[ConnectorExecutionRequest, ...]
~~~


Source: `lightbulb/connector_execution.py:1131`.

##### `lightbulb.connector_execution.InMemoryConnectorExecutor.supports`



~~~python
def supports(tool: str) -> bool
~~~


Source: `lightbulb/connector_execution.py:1140`.

## Module `lightbulb.connectors`

Typed clients for the deep connector integrations exposed by the platform.

### `lightbulb.connectors.SlackClient`

class. Source: `lightbulb/connectors.py:39`.

Thin wrapper over LightbulbClient for Slack operations.

Fields:
- `inner: LightbulbClient`

#### Methods

##### `lightbulb.connectors.SlackClient.add_reaction`



~~~python
def add_reaction(*, channel: str, ts: str, name: str) -> Dict[str, Any]
~~~


Add an emoji reaction (e.g. name='thumbsup').

Source: `lightbulb/connectors.py:70`.

##### `lightbulb.connectors.SlackClient.archive_channel`



~~~python
def archive_channel(channel: str) -> Dict[str, Any]
~~~


Source: `lightbulb/connectors.py:91`.

##### `lightbulb.connectors.SlackClient.create_channel`



~~~python
def create_channel(*, name: str, is_private: bool=False) -> Dict[str, Any]
~~~


Source: `lightbulb/connectors.py:79`.

##### `lightbulb.connectors.SlackClient.get_channel_history`



~~~python
def get_channel_history(channel: str, *, limit: int=100, cursor: str='') -> Dict[str, Any]
~~~


Source: `lightbulb/connectors.py:94`.

##### `lightbulb.connectors.SlackClient.get_thread_replies`



~~~python
def get_thread_replies(*, channel: str, ts: str, limit: int=100) -> Dict[str, Any]
~~~


Source: `lightbulb/connectors.py:100`.

##### `lightbulb.connectors.SlackClient.invite_to_channel`



~~~python
def invite_to_channel(*, channel: str, users: List[str]) -> Dict[str, Any]
~~~


Source: `lightbulb/connectors.py:88`.

##### `lightbulb.connectors.SlackClient.join_channel`



~~~python
def join_channel(channel: str) -> Dict[str, Any]
~~~


Source: `lightbulb/connectors.py:82`.

##### `lightbulb.connectors.SlackClient.list_channels`



~~~python
def list_channels(*, types: str='public_channel,private_channel', limit: int=200) -> Dict[str, Any]
~~~


Source: `lightbulb/connectors.py:76`.

##### `lightbulb.connectors.SlackClient.list_users`



~~~python
def list_users(*, limit: int=200, cursor: str='') -> Dict[str, Any]
~~~


Source: `lightbulb/connectors.py:111`.

##### `lightbulb.connectors.SlackClient.lookup_user`



~~~python
def lookup_user(*, email: str) -> Dict[str, Any]
~~~


Source: `lightbulb/connectors.py:108`.

##### `lightbulb.connectors.SlackClient.post_message`



~~~python
def post_message(*, channel: str, text: str, thread_ts: Optional[str]=None, blocks: Optional[List[Dict[str, Any]]]=None) -> Dict[str, Any]
~~~


Post a message to a Slack channel or thread.

Source: `lightbulb/connectors.py:48`.

##### `lightbulb.connectors.SlackClient.search_messages`



~~~python
def search_messages(query: str, *, count: int=20) -> Dict[str, Any]
~~~


Source: `lightbulb/connectors.py:105`.

##### `lightbulb.connectors.SlackClient.set_channel_topic`



~~~python
def set_channel_topic(*, channel: str, topic: str) -> Dict[str, Any]
~~~


Source: `lightbulb/connectors.py:85`.

##### `lightbulb.connectors.SlackClient.update_message`



~~~python
def update_message(*, channel: str, ts: str, text: str) -> Dict[str, Any]
~~~


Edit a previously-posted message.

Source: `lightbulb/connectors.py:64`.

### `lightbulb.connectors.JiraClient`

class. Source: `lightbulb/connectors.py:122`.

Thin wrapper over LightbulbClient for Atlassian Jira operations.

Fields:
- `inner: LightbulbClient`

#### Methods

##### `lightbulb.connectors.JiraClient.add_comment`



~~~python
def add_comment(issue_key: str, body: str) -> Dict[str, Any]
~~~


Source: `lightbulb/connectors.py:172`.

##### `lightbulb.connectors.JiraClient.create_issue`



~~~python
def create_issue(*, project_key: str, summary: str, issue_type: str='Task', description: str='', assignee: Optional[str]=None, labels: Optional[List[str]]=None, priority: Optional[str]=None, custom_fields: Optional[Dict[str, Any]]=None) -> Dict[str, Any]
~~~


Source: `lightbulb/connectors.py:127`.

##### `lightbulb.connectors.JiraClient.get_board_sprints`



~~~python
def get_board_sprints(board_id: str, *, state: str='active') -> Dict[str, Any]
~~~


Source: `lightbulb/connectors.py:183`.

##### `lightbulb.connectors.JiraClient.get_issue`



~~~python
def get_issue(issue_key: str) -> Dict[str, Any]
~~~


Source: `lightbulb/connectors.py:160`.

##### `lightbulb.connectors.JiraClient.get_sprint_issues`



~~~python
def get_sprint_issues(sprint_id: str) -> Dict[str, Any]
~~~


Source: `lightbulb/connectors.py:180`.

##### `lightbulb.connectors.JiraClient.link_issues`



~~~python
def link_issues(*, inward_key: str, outward_key: str, link_type: str) -> Dict[str, Any]
~~~


Source: `lightbulb/connectors.py:175`.

##### `lightbulb.connectors.JiraClient.search_issues`



~~~python
def search_issues(jql: str, *, max_results: int=50) -> Dict[str, Any]
~~~


Run a JQL search.

Source: `lightbulb/connectors.py:156`.

##### `lightbulb.connectors.JiraClient.transition_issue`



~~~python
def transition_issue(issue_key: str, transition: str, *, comment: str='') -> Dict[str, Any]
~~~


Source: `lightbulb/connectors.py:166`.

##### `lightbulb.connectors.JiraClient.update_issue`



~~~python
def update_issue(issue_key: str, fields: Dict[str, Any]) -> Dict[str, Any]
~~~


Source: `lightbulb/connectors.py:163`.

### `lightbulb.connectors.BambooHRClient`

class. Source: `lightbulb/connectors.py:191`.

BambooHR client.

Fields:
- `inner: LightbulbClient`

#### Methods

##### `lightbulb.connectors.BambooHRClient.create_leave_request`



~~~python
def create_leave_request(body: Dict[str, Any]) -> Dict[str, Any]
~~~


Source: `lightbulb/connectors.py:217`.

##### `lightbulb.connectors.BambooHRClient.get_employee`



~~~python
def get_employee(employee_id: str) -> Dict[str, Any]
~~~


Source: `lightbulb/connectors.py:211`.

##### `lightbulb.connectors.BambooHRClient.health`



~~~python
def health() -> Dict[str, Any]
~~~


Source: `lightbulb/connectors.py:208`.

##### `lightbulb.connectors.BambooHRClient.leave_balance`



~~~python
def leave_balance(employee_id: str) -> Dict[str, Any]
~~~


Source: `lightbulb/connectors.py:205`.

##### `lightbulb.connectors.BambooHRClient.list_employees`



~~~python
def list_employees(**filters: Any) -> Dict[str, Any]
~~~


Source: `lightbulb/connectors.py:214`.

##### `lightbulb.connectors.BambooHRClient.whos_out`



~~~python
def whos_out(**filters: Any) -> Dict[str, Any]
~~~


Roster of employees currently or upcoming OOO.

Source: `lightbulb/connectors.py:201`.

### `lightbulb.connectors.GreenhouseClient`

class. Source: `lightbulb/connectors.py:225`.

Greenhouse ATS client (recruiting).

Fields:
- `inner: LightbulbClient`

#### Methods

##### `lightbulb.connectors.GreenhouseClient.advance_application`



~~~python
def advance_application(application_id: str, body: Optional[Dict[str, Any]]=None) -> Dict[str, Any]
~~~


HITL-gated: advance a candidate to the next stage.

Source: `lightbulb/connectors.py:236`.

##### `lightbulb.connectors.GreenhouseClient.get_candidate`



~~~python
def get_candidate(candidate_id: str) -> Dict[str, Any]
~~~


Source: `lightbulb/connectors.py:244`.

##### `lightbulb.connectors.GreenhouseClient.list_applications`



~~~python
def list_applications(**filters: Any) -> Dict[str, Any]
~~~


Source: `lightbulb/connectors.py:233`.

##### `lightbulb.connectors.GreenhouseClient.list_candidates`



~~~python
def list_candidates(**filters: Any) -> Dict[str, Any]
~~~


Source: `lightbulb/connectors.py:247`.

##### `lightbulb.connectors.GreenhouseClient.list_jobs`



~~~python
def list_jobs(**filters: Any) -> Dict[str, Any]
~~~


Source: `lightbulb/connectors.py:230`.

##### `lightbulb.connectors.GreenhouseClient.reject_application`



~~~python
def reject_application(application_id: str, body: Optional[Dict[str, Any]]=None) -> Dict[str, Any]
~~~


HITL-gated: reject a candidate.

Source: `lightbulb/connectors.py:240`.

### `lightbulb.connectors.MondayClient`

class. Source: `lightbulb/connectors.py:255`.

Monday.com client used by the HR engagement and onboarding flows.

Fields:
- `inner: LightbulbClient`

#### Methods

##### `lightbulb.connectors.MondayClient.cases`



~~~python
def cases(**filters: Any) -> Dict[str, Any]
~~~


Source: `lightbulb/connectors.py:264`.

##### `lightbulb.connectors.MondayClient.create_item`



~~~python
def create_item(*, board_id: str, group_id: str, item_name: str, column_values: Optional[Dict[str, Any]]=None) -> Dict[str, Any]
~~~


Source: `lightbulb/connectors.py:273`.

##### `lightbulb.connectors.MondayClient.get_board`



~~~python
def get_board(board_id: str) -> Dict[str, Any]
~~~


Source: `lightbulb/connectors.py:270`.

##### `lightbulb.connectors.MondayClient.list_boards`



~~~python
def list_boards(**filters: Any) -> Dict[str, Any]
~~~


Source: `lightbulb/connectors.py:267`.

##### `lightbulb.connectors.MondayClient.onboarding_board`



~~~python
def onboarding_board(checklist_id: str) -> Dict[str, Any]
~~~


Read the Monday board for an HR onboarding checklist.

Source: `lightbulb/connectors.py:260`.

##### `lightbulb.connectors.MondayClient.update_item`



~~~python
def update_item(*, item_id: str, column_values: Dict[str, Any]) -> Dict[str, Any]
~~~


Source: `lightbulb/connectors.py:283`.

## Module `lightbulb.customer_service_lifecycle`

Evidence-bound customer-service lifecycle primitives.

### `lightbulb.customer_service_lifecycle.ServiceScopeBinding`

class. Source: `lightbulb/customer_service_lifecycle.py:209`.

Expected organizational scope; authenticated context remains authoritative.

Fields:
- `schema_id: Literal['lightbulb.service_scope_binding.v1'] = Field(default=SERVICE_SCOPE_BINDING_SCHEMA, alias='schema')`
- `tenant_ref: OpaqueRef`
- `company_ref: OpaqueRef`
- `project_ref: OpaqueRef`
- `project_id: UUID`

### `lightbulb.customer_service_lifecycle.ServiceContactPolicyBinding`

class. Source: `lightbulb/customer_service_lifecycle.py:237`.

Content-bound customer/channel consent and suppression decision.

Fields:
- `schema_id: Literal['lightbulb.service_contact_policy_binding.v1'] = Field(default=SERVICE_CONTACT_POLICY_BINDING_SCHEMA, alias='schema')`
- `customer_ref: OpaqueRef`
- `party_ref: OpaqueRef`
- `channel: Channel`
- `endpoint_binding_ref: OpaqueRef`
- `purpose: Literal['customer_support'] = 'customer_support'`
- `jurisdiction: Annotated[str, StringConstraints(min_length=2, max_length=80)]`
- `consent_state: Literal['granted', 'not_required', 'withdrawn', 'unknown']`
- `suppression_state: Literal['clear', 'suppressed', 'unknown']`
- `decision_ref: OpaqueRef`
- `decided_at: str`
- `expires_at: str`
- `decision_digest: Sha256Digest`
- `evidence: PrimitiveEvidenceRef`

### `lightbulb.customer_service_lifecycle.service_contact_policy_digest`

function. Source: `lightbulb/customer_service_lifecycle.py:287`.



~~~python
service_contact_policy_digest(value: ServiceContactPolicyBinding | Mapping[str, Any]) -> str
~~~


### `lightbulb.customer_service_lifecycle.ServiceSlaTarget`

class. Source: `lightbulb/customer_service_lifecycle.py:315`.

Fields:
- `first_response_minutes: int = Field(ge=1, le=10080)`
- `resolution_minutes: int = Field(ge=1, le=43200)`

### `lightbulb.customer_service_lifecycle.ServiceSlaPolicy`

class. Source: `lightbulb/customer_service_lifecycle.py:326`.

Fields:
- `schema_id: Literal['lightbulb.service_sla_policy.v1'] = Field(default=SERVICE_SLA_POLICY_SCHEMA, alias='schema')`
- `policy_ref: OpaqueRef`
- `policy_version: int = Field(ge=1, le=1000000)`
- `low: ServiceSlaTarget`
- `medium: ServiceSlaTarget`
- `high: ServiceSlaTarget`
- `critical: ServiceSlaTarget`
- `policy_digest: Sha256Digest`
- `evidence: PrimitiveEvidenceRef`

#### Methods

##### `lightbulb.customer_service_lifecycle.ServiceSlaPolicy.target_for`



~~~python
def target_for(severity: Severity) -> ServiceSlaTarget
~~~


Source: `lightbulb/customer_service_lifecycle.py:362`.

### `lightbulb.customer_service_lifecycle.service_sla_policy_digest`

function. Source: `lightbulb/customer_service_lifecycle.py:366`.



~~~python
service_sla_policy_digest(value: ServiceSlaPolicy | Mapping[str, Any]) -> str
~~~


### `lightbulb.customer_service_lifecycle.ServiceRiskSignals`

class. Source: `lightbulb/customer_service_lifecycle.py:384`.

Fields:
- `schema_id: Literal['lightbulb.service_risk_signals.v1'] = Field(default='lightbulb.service_risk_signals.v1', alias='schema')`
- `safety_hazard: bool = False`
- `security_or_privacy_incident: bool = False`
- `regulatory_deadline: bool = False`
- `fraud_suspected: bool = False`
- `vulnerable_customer: bool = False`
- `repeated_service_failure: bool = False`
- `financial_exposure: Decimal = Decimal('0.00')`

### `lightbulb.customer_service_lifecycle.ServiceTransitionFence`

class. Source: `lightbulb/customer_service_lifecycle.py:403`.

Fields:
- `schema_id: Literal['lightbulb.service_transition_fence.v1'] = Field(default=SERVICE_TRANSITION_FENCE_SCHEMA, alias='schema')`
- `transition_ref: OpaqueRef`
- `expected_revision: int = Field(ge=0, le=_MAX_TRANSITIONS)`
- `expected_snapshot_digest: Sha256Digest | None = None`
- `idempotency_key_digest: Sha256Digest`

### `lightbulb.customer_service_lifecycle.ServiceCaseLifecycleSnapshot`

class. Source: `lightbulb/customer_service_lifecycle.py:422`.

Fields:
- `schema_id: Literal['lightbulb.service_case_lifecycle_snapshot.v1'] = Field(default=SERVICE_CASE_LIFECYCLE_SNAPSHOT_SCHEMA, alias='schema')`
- `scope: ServiceScopeBinding`
- `case_ref: OpaqueRef`
- `customer_ref: OpaqueRef`
- `party_ref: OpaqueRef`
- `channel: Channel`
- `endpoint_binding_ref: OpaqueRef`
- `contact_policy_decision_ref: OpaqueRef`
- `contact_policy_digest: Sha256Digest`
- `contact_policy_expires_at: str`
- `outbound_contact_permitted: bool`
- `category_ref: OpaqueRef`
- `classification_confidence: Decimal`
- `requested_severity: Severity`
- `severity_floor: Severity`
- `effective_severity: Severity`
- `state: CaseState`
- `summary_digest: Sha256Digest`
- `opened_at: str`
- `updated_at: str`
- `sla_policy_ref: OpaqueRef`
- `sla_policy_digest: Sha256Digest`
- `first_response_due_at: str`
- `resolution_due_at: str`
- `owner_ref: OpaqueRef | None = None`
- `assigned_at: str | None = None`
- `first_response_at: str | None = None`
- `escalation_ref: OpaqueRef | None = None`
- `escalation_owner_ref: OpaqueRef | None = None`
- `escalated_at: str | None = None`
- `resolution_ref: OpaqueRef | None = None`
- `resolver_ref: OpaqueRef | None = None`
- `resolution_submitted_at: str | None = None`
- `resolution_digest: Sha256Digest | None = None`
- `resolution_verification: Literal['not_submitted', 'pending', 'confirmed', 'rejected', 'unreachable'] = 'not_submitted'`
- `outcome_verified: bool = False`
- `pending_remedy_proposal_digest: Sha256Digest | None = None`
- `revision: int = Field(ge=1, le=_MAX_TRANSITIONS)`
- `transition_refs: tuple[OpaqueRef, ...] = Field(min_length=1, max_length=_MAX_TRANSITIONS)`
- `idempotency_key_digests: tuple[Sha256Digest, ...] = Field(min_length=1, max_length=_MAX_TRANSITIONS)`
- `evidence_refs: tuple[PrimitiveEvidenceRef, ...] = Field(min_length=1, max_length=_MAX_EVIDENCE)`
- `state_digest: Sha256Digest`

### `lightbulb.customer_service_lifecycle.service_case_snapshot_digest`

function. Source: `lightbulb/customer_service_lifecycle.py:672`.



~~~python
service_case_snapshot_digest(value: ServiceCaseLifecycleSnapshot | Mapping[str, Any]) -> str
~~~


### `lightbulb.customer_service_lifecycle.service_transition_idempotency_digest`

function. Source: `lightbulb/customer_service_lifecycle.py:684`.



~~~python
service_transition_idempotency_digest(scope: ExecutionScope, idempotency_key: str) -> str
~~~


### `lightbulb.customer_service_lifecycle.IntakeServiceCaseInput`

class. Source: `lightbulb/customer_service_lifecycle.py:709`.

Fields:
- `schema_id: Literal['lightbulb.service_case_intake_input.v1'] = Field(default=SERVICE_CASE_INTAKE_INPUT_SCHEMA, alias='schema')`
- `scope: ServiceScopeBinding`
- `fence: ServiceTransitionFence`
- `acting_ref: OpaqueRef`
- `analysis_as_of: str`
- `case_ref: OpaqueRef`
- `customer_ref: OpaqueRef`
- `contact_policy: ServiceContactPolicyBinding`
- `received_at: str`
- `summary: BoundedText`
- `category_ref: OpaqueRef`
- `classification_confidence: Decimal`
- `requested_severity: Severity`
- `risk_signals: ServiceRiskSignals = Field(default_factory=ServiceRiskSignals)`
- `sla_policy: ServiceSlaPolicy`
- `evidence_refs: tuple[PrimitiveEvidenceRef, ...] = Field(min_length=1, max_length=16)`

### `lightbulb.customer_service_lifecycle.RouteServiceCaseInput`

class. Source: `lightbulb/customer_service_lifecycle.py:759`.

Fields:
- `schema_id: Literal['lightbulb.service_case_route_input.v1'] = Field(default=SERVICE_CASE_ROUTE_INPUT_SCHEMA, alias='schema')`
- `scope: ServiceScopeBinding`
- `fence: ServiceTransitionFence`
- `acting_ref: OpaqueRef`
- `analysis_as_of: str`
- `case: ServiceCaseLifecycleSnapshot`
- `owner_ref: OpaqueRef`
- `first_response_at: str | None = None`
- `escalation_ref: OpaqueRef | None = None`
- `escalation_owner_ref: OpaqueRef | None = None`
- `evidence_refs: tuple[PrimitiveEvidenceRef, ...] = Field(min_length=1, max_length=16)`

### `lightbulb.customer_service_lifecycle.SubmitServiceResolutionInput`

class. Source: `lightbulb/customer_service_lifecycle.py:792`.

Fields:
- `schema_id: Literal['lightbulb.service_resolution_submission_input.v1'] = Field(default=SERVICE_RESOLUTION_SUBMISSION_INPUT_SCHEMA, alias='schema')`
- `scope: ServiceScopeBinding`
- `fence: ServiceTransitionFence`
- `acting_ref: OpaqueRef`
- `analysis_as_of: str`
- `case: ServiceCaseLifecycleSnapshot`
- `resolution_ref: OpaqueRef`
- `resolver_ref: OpaqueRef`
- `resolved_at: str`
- `root_cause_ref: OpaqueRef`
- `resolution_summary: BoundedText`
- `evidence_refs: tuple[PrimitiveEvidenceRef, ...] = Field(min_length=1, max_length=16)`

### `lightbulb.customer_service_lifecycle.VerifyServiceResolutionInput`

class. Source: `lightbulb/customer_service_lifecycle.py:825`.

Fields:
- `schema_id: Literal['lightbulb.service_resolution_verification_input.v1'] = Field(default=SERVICE_RESOLUTION_VERIFICATION_INPUT_SCHEMA, alias='schema')`
- `scope: ServiceScopeBinding`
- `fence: ServiceTransitionFence`
- `acting_ref: OpaqueRef`
- `analysis_as_of: str`
- `case: ServiceCaseLifecycleSnapshot`
- `expected_resolution_digest: Sha256Digest`
- `verifier_ref: OpaqueRef`
- `verified_at: str`
- `customer_ref: OpaqueRef`
- `channel: Channel`
- `contact_policy_decision_ref: OpaqueRef`
- `outcome: Literal['confirmed', 'rejected', 'unreachable']`
- `evidence_refs: tuple[PrimitiveEvidenceRef, ...] = Field(min_length=1, max_length=16)`

### `lightbulb.customer_service_lifecycle.ProposeServiceRemedyInput`

class. Source: `lightbulb/customer_service_lifecycle.py:855`.

Fields:
- `schema_id: Literal['lightbulb.service_remedy_proposal_input.v1'] = Field(default=SERVICE_REMEDY_PROPOSAL_INPUT_SCHEMA, alias='schema')`
- `scope: ServiceScopeBinding`
- `fence: ServiceTransitionFence`
- `acting_ref: OpaqueRef`
- `analysis_as_of: str`
- `case: ServiceCaseLifecycleSnapshot`
- `remedy_ref: OpaqueRef`
- `kind: RemedyKind`
- `reason_ref: OpaqueRef`
- `requested_risk: RiskLevel = 'low'`
- `proposer_ref: OpaqueRef`
- `required_approver_ref: OpaqueRef`
- `amount: Decimal | None = None`
- `currency: CurrencyCode | None = None`
- `original_transaction_ref: OpaqueRef | None = None`
- `product_ref: OpaqueRef | None = None`
- `asset_ref: OpaqueRef | None = None`
- `serial_ref: OpaqueRef | None = None`
- `hazardous_return: bool = False`
- `evidence_refs: tuple[PrimitiveEvidenceRef, ...] = Field(min_length=1, max_length=16)`

### `lightbulb.customer_service_lifecycle.ServiceRemedyAuthorizationProposal`

class. Source: `lightbulb/customer_service_lifecycle.py:931`.

Fields:
- `schema_id: Literal['lightbulb.service_remedy_authorization_proposal.v1'] = Field(default=SERVICE_REMEDY_AUTHORIZATION_PROPOSAL_SCHEMA, alias='schema')`
- `scope: ServiceScopeBinding`
- `case_ref: OpaqueRef`
- `customer_ref: OpaqueRef`
- `channel: Channel`
- `endpoint_binding_ref: OpaqueRef`
- `contact_policy_decision_ref: OpaqueRef`
- `contact_policy_digest: Sha256Digest`
- `source_snapshot_digest: Sha256Digest`
- `source_revision: int = Field(ge=1, le=_MAX_TRANSITIONS)`
- `source_effective_severity: Severity`
- `remedy_ref: OpaqueRef`
- `kind: RemedyKind`
- `reason_ref: OpaqueRef`
- `requested_risk: RiskLevel`
- `risk_floor: RiskLevel`
- `effective_risk: RiskLevel`
- `proposer_ref: OpaqueRef`
- `required_approver_ref: OpaqueRef`
- `required_approver_role: Literal['finance_authorizer', 'returns_authorizer']`
- `required_approver_ref_authoritative: Literal[False] = False`
- `spring_approver_revalidation_required: Literal[True] = True`
- `amount: Decimal | None = None`
- `currency: CurrencyCode | None = None`
- `original_transaction_ref: OpaqueRef`
- `product_ref: OpaqueRef | None = None`
- `asset_ref: OpaqueRef | None = None`
- `serial_ref: OpaqueRef | None = None`
- `hazardous_return: bool = False`
- `proposed_at: str`
- `expires_at: str`
- `idempotency_key_digest: Sha256Digest`
- `evidence_refs: tuple[PrimitiveEvidenceRef, ...] = Field(min_length=1, max_length=16)`
- `approval_required: Literal[True] = True`
- `separation_of_duties_required: Literal[True] = True`
- `authorization_status: Literal['pending_approval'] = 'pending_approval'`
- `authorization_granted: Literal[False] = False`
- `live_system_changed: Literal[False] = False`
- `provider_effect_executed: Literal[False] = False`
- `proposal_digest: Sha256Digest`

### `lightbulb.customer_service_lifecycle.ServiceRemedyProposalResult`

class. Source: `lightbulb/customer_service_lifecycle.py:1083`.

Fields:
- `schema_id: Literal['lightbulb.service_remedy_proposal_result.v1'] = Field(default=SERVICE_REMEDY_PROPOSAL_RESULT_SCHEMA, alias='schema')`
- `proposal: ServiceRemedyAuthorizationProposal`
- `case: ServiceCaseLifecycleSnapshot`
- `authorization_granted: Literal[False] = False`
- `live_system_changed: Literal[False] = False`
- `provider_effect_executed: Literal[False] = False`

### `lightbulb.customer_service_lifecycle.service_resolution_verification_digest`

function. Source: `lightbulb/customer_service_lifecycle.py:1491`.



~~~python
service_resolution_verification_digest(*, case_ref: str, resolution_ref: str, resolution_digest: str, verifier_ref: str, verified_at: str, customer_ref: str, channel: Channel, contact_policy_decision_ref: str, outcome: Literal['confirmed', 'rejected', 'unreachable']) -> str
~~~


Bind independent verification evidence to one exact claimed outcome.

### `lightbulb.customer_service_lifecycle.IntakeAndClassifyServiceCasePrimitive`

class. Source: `lightbulb/customer_service_lifecycle.py:1605`.

Fields:
- `example_inputs: Mapping[str, Any] = {}`

### `lightbulb.customer_service_lifecycle.RouteAndEscalateServiceCasePrimitive`

class. Source: `lightbulb/customer_service_lifecycle.py:1769`.

Fields:
- `example_inputs: Mapping[str, Any] = {}`

### `lightbulb.customer_service_lifecycle.SubmitServiceResolutionPrimitive`

class. Source: `lightbulb/customer_service_lifecycle.py:1957`.

Fields:
- `example_inputs: Mapping[str, Any] = {}`

### `lightbulb.customer_service_lifecycle.VerifyServiceResolutionPrimitive`

class. Source: `lightbulb/customer_service_lifecycle.py:2072`.

Fields:
- `example_inputs: Mapping[str, Any] = {}`

### `lightbulb.customer_service_lifecycle.ProposeServiceRemedyAuthorizationPrimitive`

class. Source: `lightbulb/customer_service_lifecycle.py:2238`.

Fields:
- `example_inputs: Mapping[str, Any] = {}`

## Module `lightbulb.demand_gen_primitives`

Demand-generation planners driven by funnel evidence and learnings.

### `lightbulb.demand_gen_primitives.DemandGenValidationError`

class. Source: `lightbulb/demand_gen_primitives.py:104`.

A demand-gen brief cannot become a safe, bounded plan.

### `lightbulb.demand_gen_primitives.DemandGenChannelAccount`

class. Source: `lightbulb/demand_gen_primitives.py:233`.

One social destination; target identity is validated per channel.

Fields:
- `channel: SocialChannel`
- `connector_account_ref: OperationRef`
- `provider_target_id: ShortText`

### `lightbulb.demand_gen_primitives.ContentCalendarBrief`

class. Source: `lightbulb/demand_gen_primitives.py:257`.

Fields:
- `calendar_ref: PortableRef`
- `planning_as_of: str`
- `campaign_goal: LongText`
- `window_start: str`
- `window_weeks: int = Field(ge=1, le=_MAX_WEEKS)`
- `posts_per_week_per_channel: int = Field(ge=1, le=_MAX_POSTS_PER_WEEK)`
- `channel_accounts: tuple[DemandGenChannelAccount, ...] = Field(min_length=1, max_length=_MAX_CHANNEL_ACCOUNTS)`
- `content_themes: tuple[ShortText, ...] = Field(min_length=1, max_length=_MAX_THEMES)`
- `funnel_snapshot: GrowthFunnelSnapshot`
- `learnings: tuple[GrowthLearningEntry, ...] = Field(default_factory=tuple, max_length=_MAX_LEARNINGS)`
- `max_snapshot_age_hours: int = Field(default=720, ge=1, le=8760)`

### `lightbulb.demand_gen_primitives.ContentBriefItem`

class. Source: `lightbulb/demand_gen_primitives.py:314`.

One planned post: a directive for authorship, not authored copy.

Fields:
- `item_ref: PortableRef`
- `channel: SocialChannel`
- `connector_account_ref: OperationRef`
- `provider_target_id: ShortText`
- `scheduled_for: str`
- `intent: ContentIntent`
- `theme: ShortText`
- `message_directive: LongText`
- `media_required: bool`
- `link_required: bool`
- `dispatchable_by_planner: Literal[False] = False`
- `item_digest: Sha256Digest = '0' * 64`
- `approval_unit: str = Field(min_length=1, max_length=200)`

### `lightbulb.demand_gen_primitives.ContentCalendarPlan`

class. Source: `lightbulb/demand_gen_primitives.py:385`.

Fields:
- `schema_id: Literal['lightbulb.growth_content_calendar_plan.v1'] = Field(default=CONTENT_CALENDAR_PLAN_SCHEMA, alias='schema')`
- `calendar_ref: PortableRef`
- `planning_as_of: str`
- `window_start: str`
- `window_weeks: int = Field(ge=1, le=_MAX_WEEKS)`
- `campaign_goal: LongText`
- `evidence_scope_status: EvidenceScopeStatus`
- `target_bottleneck: str | None = None`
- `primary_intent: ContentIntent`
- `intent_allocations: tuple[IntentAllocation, ...]`
- `informed_by: InformedBy`
- `items: tuple[ContentBriefItem, ...] = Field(min_length=1, max_length=_MAX_CALENDAR_ITEMS)`
- `dispatchable_by_planner: Literal[False] = False`
- `plan_digest: Sha256Digest = '0' * 64`
- `receipt_key_id: str | None = Field(default=None, min_length=8, max_length=80, pattern='^[A-Za-z0-9][A-Za-z0-9._-]{7,79}$')`
- `exact_scope_digest: Sha256Digest | None = None`
- `plan_hmac: Sha256Digest | None = None`

#### Methods

##### `lightbulb.demand_gen_primitives.ContentCalendarPlan.hmac_payload`



~~~python
def hmac_payload() -> dict[str, Any]
~~~


Source: `lightbulb/demand_gen_primitives.py:463`.

##### `lightbulb.demand_gen_primitives.ContentCalendarPlan.to_dict`



~~~python
def to_dict() -> dict[str, Any]
~~~


Source: `lightbulb/demand_gen_primitives.py:471`.

### `lightbulb.demand_gen_primitives.plan_content_calendar`

function. Source: `lightbulb/demand_gen_primitives.py:554`.



~~~python
plan_content_calendar(brief: ContentCalendarBrief | Mapping[str, Any], *, scope: DynamicWorkflowScope | Mapping[str, Any] | None=None, scope_keyring: ExactScopeDigestProvider | None=None, scope_key_id: str | None=None) -> ContentCalendarPlan
~~~


Deterministically compile a bounded, approval-ready posting calendar.

### `lightbulb.demand_gen_primitives.verify_content_calendar_plan`

function. Source: `lightbulb/demand_gen_primitives.py:675`.



~~~python
verify_content_calendar_plan(value: ContentCalendarPlan | Mapping[str, Any], *, scope: DynamicWorkflowScope | Mapping[str, Any], scope_keyring: ExactScopeDigestProvider) -> ContentCalendarPlan
~~~


### `lightbulb.demand_gen_primitives.AudienceGrowthBrief`

class. Source: `lightbulb/demand_gen_primitives.py:716`.

Fields:
- `plan_ref: PortableRef`
- `planning_as_of: str`
- `growth_goal: LongText`
- `window_start: str`
- `window_weeks: int = Field(ge=1, le=_MAX_WEEKS)`
- `actions_per_week_per_channel: int = Field(ge=1, le=_MAX_POSTS_PER_WEEK)`
- `channel_accounts: tuple[DemandGenChannelAccount, ...] = Field(min_length=1, max_length=_MAX_CHANNEL_ACCOUNTS)`
- `lead_magnet_title: ShortText | None = None`
- `funnel_snapshot: GrowthFunnelSnapshot`
- `learnings: tuple[GrowthLearningEntry, ...] = Field(default_factory=tuple, max_length=_MAX_LEARNINGS)`
- `max_snapshot_age_hours: int = Field(default=720, ge=1, le=8760)`

### `lightbulb.demand_gen_primitives.AudienceGrowthPlan`

class. Source: `lightbulb/demand_gen_primitives.py:770`.

Fields:
- `schema_id: Literal['lightbulb.growth_audience_growth_plan.v1'] = Field(default=AUDIENCE_GROWTH_PLAN_SCHEMA, alias='schema')`
- `plan_ref: PortableRef`
- `planning_as_of: str`
- `window_start: str`
- `window_weeks: int = Field(ge=1, le=_MAX_WEEKS)`
- `growth_goal: LongText`
- `evidence_scope_status: EvidenceScopeStatus`
- `strategy: AudienceStrategy`
- `strategy_rationale: ShortText`
- `max_actions_per_week_per_channel: int = Field(ge=1, le=_MAX_POSTS_PER_WEEK)`
- `informed_by: InformedBy`
- `items: tuple[ContentBriefItem, ...] = Field(min_length=1, max_length=_MAX_CALENDAR_ITEMS)`
- `dispatchable_by_planner: Literal[False] = False`
- `plan_digest: Sha256Digest = '0' * 64`
- `receipt_key_id: str | None = Field(default=None, min_length=8, max_length=80, pattern='^[A-Za-z0-9][A-Za-z0-9._-]{7,79}$')`
- `exact_scope_digest: Sha256Digest | None = None`
- `plan_hmac: Sha256Digest | None = None`

#### Methods

##### `lightbulb.demand_gen_primitives.AudienceGrowthPlan.hmac_payload`



~~~python
def hmac_payload() -> dict[str, Any]
~~~


Source: `lightbulb/demand_gen_primitives.py:845`.

##### `lightbulb.demand_gen_primitives.AudienceGrowthPlan.to_dict`



~~~python
def to_dict() -> dict[str, Any]
~~~


Source: `lightbulb/demand_gen_primitives.py:853`.

### `lightbulb.demand_gen_primitives.plan_audience_growth`

function. Source: `lightbulb/demand_gen_primitives.py:889`.



~~~python
plan_audience_growth(brief: AudienceGrowthBrief | Mapping[str, Any], *, scope: DynamicWorkflowScope | Mapping[str, Any] | None=None, scope_keyring: ExactScopeDigestProvider | None=None, scope_key_id: str | None=None) -> AudienceGrowthPlan
~~~


Deterministically compile a bounded audience-growth action plan.

### `lightbulb.demand_gen_primitives.verify_audience_growth_plan`

function. Source: `lightbulb/demand_gen_primitives.py:1009`.



~~~python
verify_audience_growth_plan(value: AudienceGrowthPlan | Mapping[str, Any], *, scope: DynamicWorkflowScope | Mapping[str, Any], scope_keyring: ExactScopeDigestProvider) -> AudienceGrowthPlan
~~~


## Module `lightbulb.distributed_data`

Typed metadata for distributed arrays, tensors, and hash maps.

### `lightbulb.distributed_data.PartitionStrategy`

class. Source: `lightbulb/distributed_data.py:19`.

### `lightbulb.distributed_data.TensorOrder`

class. Source: `lightbulb/distributed_data.py:27`.

### `lightbulb.distributed_data.MapConsistency`

class. Source: `lightbulb/distributed_data.py:32`.

### `lightbulb.distributed_data.PartitionSpec`

class. Source: `lightbulb/distributed_data.py:38`.

Logical partitioning independent of any particular compute engine.

Fields:
- `strategy: PartitionStrategy`
- `partition_count: int = Field(ge=1)`
- `axis: int | None = Field(default=None, ge=0)`
- `keys: tuple[str, ...] = ()`
- `replication_factor: int = Field(default=1, ge=1)`

### `lightbulb.distributed_data.LineageInput`

class. Source: `lightbulb/distributed_data.py:84`.

Fields:
- `asset_ref: str = Field(min_length=1, max_length=500)`
- `version: str | None = Field(default=None, min_length=1, max_length=160)`
- `content_sha256: str | None = Field(default=None, min_length=64, max_length=64)`

### `lightbulb.distributed_data.DataLineage`

class. Source: `lightbulb/distributed_data.py:109`.

Reproducible operation and immutable references that produced a dataset.

Fields:
- `operation: str = Field(min_length=1, max_length=240)`
- `inputs: tuple[LineageInput, ...] = ()`
- `run_ref: str | None = Field(default=None, min_length=1, max_length=240)`

### `lightbulb.distributed_data.DistributedArrayMetadata`

class. Source: `lightbulb/distributed_data.py:166`.

Fields:
- `schema_id: str = Field(default=DISTRIBUTED_ARRAY_METADATA_SCHEMA, alias='schema')`
- `order: TensorOrder = TensorOrder.C`

### `lightbulb.distributed_data.DistributedTensorMetadata`

class. Source: `lightbulb/distributed_data.py:171`.

Fields:
- `schema_id: str = Field(default=DISTRIBUTED_TENSOR_METADATA_SCHEMA, alias='schema')`
- `order: TensorOrder = TensorOrder.C`
- `device: str | None = Field(default=None, min_length=1, max_length=160)`

### `lightbulb.distributed_data.DistributedHashMapMetadata`

class. Source: `lightbulb/distributed_data.py:187`.

Typed key/value and partition metadata for a distributed hash map.

Fields:
- `schema_id: str = Field(default=DISTRIBUTED_HASHMAP_METADATA_SCHEMA, alias='schema')`
- `key_dtype: str = Field(min_length=1, max_length=128)`
- `value_dtype: str = Field(min_length=1, max_length=128)`
- `partition: PartitionSpec`
- `lineage: DataLineage`
- `estimated_entries: int | None = Field(default=None, ge=0)`
- `consistency: MapConsistency = MapConsistency.SESSION`

## Module `lightbulb.domain_primitives`

Built-in executable primitives for finance, legal, CRM, and HR workflows.

### `lightbulb.domain_primitives.SupplierInvoiceInput`

class. Source: `lightbulb/domain_primitives.py:92`.

Fields:
- `invoice_url: str = Field(default='', max_length=2048)`
- `invoice_text: str = Field(default='', max_length=500000)`
- `expected_vendor: str = Field(default='', max_length=300)`
- `extracted_fields: Dict[str, Any] = Field(default_factory=dict)`
- `known_invoice_numbers: list[str] = Field(default_factory=list, max_length=10000)`
- `provider: Literal['xero', 'quickbooks'] = 'xero'`
- `create_bill: bool = False`

### `lightbulb.domain_primitives.SupplierInvoiceOutput`

class. Source: `lightbulb/domain_primitives.py:110`.

Fields:
- `vendor: str`
- `invoice_number: str`
- `invoice_date: str`
- `due_date: str`
- `currency: str`
- `subtotal: Decimal | None = None`
- `tax: Decimal | None = None`
- `total: Decimal | None = None`
- `duplicate: bool`
- `exceptions: list[str]`
- `confidence: float = Field(ge=0, le=1)`
- `state: Literal['extracted', 'exception', 'preview', 'pending_approval', 'bill_created', 'blocked', 'failed']`
- `bill_ref: str | None = None`

### `lightbulb.domain_primitives.IngestSupplierInvoicePrimitive`

class. Source: `lightbulb/domain_primitives.py:136`.

### `lightbulb.domain_primitives.DraftContractInput`

class. Source: `lightbulb/domain_primitives.py:291`.

Fields:
- `document_type: str = Field(min_length=1, max_length=120)`
- `brief: str = Field(min_length=1, max_length=100000)`
- `counterparty: str = Field(default='', max_length=300)`
- `jurisdiction: str = Field(default='', max_length=160)`
- `playbook: str = Field(default='', max_length=200)`
- `provider: Literal['docs', 'microsoft'] = 'docs'`
- `save_document: bool = False`

### `lightbulb.domain_primitives.DraftContractOutput`

class. Source: `lightbulb/domain_primitives.py:303`.

Fields:
- `document_type: str`
- `title: str`
- `draft_text: str`
- `sections: list[str]`
- `review_required: bool`
- `state: Literal['draft', 'preview', 'pending_approval', 'saved', 'blocked', 'failed']`
- `document_ref: str | None = None`

### `lightbulb.domain_primitives.DraftContractPrimitive`

class. Source: `lightbulb/domain_primitives.py:315`.

### `lightbulb.domain_primitives.ContractRiskFinding`

class. Source: `lightbulb/domain_primitives.py:431`.

Fields:
- `code: str`
- `severity: Literal['low', 'medium', 'high']`
- `summary: str`
- `recommendation: str`

### `lightbulb.domain_primitives.ReviewContractInput`

class. Source: `lightbulb/domain_primitives.py:440`.

Fields:
- `contract_url: str = Field(default='', max_length=2048)`
- `contract_text: str = Field(default='', max_length=1000000)`
- `playbook: str = Field(default='', max_length=200)`
- `counterparty_name: str = Field(default='', max_length=300)`
- `focus: str = Field(default='', max_length=2000)`
- `provider: Literal['docs', 'drive', 'microsoft'] = 'docs'`

### `lightbulb.domain_primitives.ReviewContractOutput`

class. Source: `lightbulb/domain_primitives.py:457`.

Fields:
- `counterparty_name: str`
- `playbook: str`
- `risk_level: Literal['low', 'medium', 'high']`
- `findings: list[ContractRiskFinding]`
- `summary: str`
- `state: Literal['reviewed', 'blocked', 'failed']`

### `lightbulb.domain_primitives.ReviewContractPrimitive`

class. Source: `lightbulb/domain_primitives.py:468`.

### `lightbulb.domain_primitives.LeadQualificationRules`

class. Source: `lightbulb/domain_primitives.py:577`.

Fields:
- `preferred_industries: list[str] = Field(default_factory=list, max_length=100)`
- `target_titles: list[str] = Field(default_factory=list, max_length=100)`
- `min_employees: int | None = Field(default=None, ge=1)`
- `max_employees: int | None = Field(default=None, ge=1)`
- `qualified_threshold: int = Field(default=70, ge=1, le=100)`

### `lightbulb.domain_primitives.QualifyLeadInput`

class. Source: `lightbulb/domain_primitives.py:593`.

Fields:
- `lead_id: str = Field(default='', max_length=200)`
- `lead_email: str = Field(default='', max_length=320)`
- `company_domain: str = Field(default='', max_length=253)`
- `provider: Literal['hubspot', 'salesforce'] = 'hubspot'`
- `profile: Dict[str, Any] = Field(default_factory=dict)`
- `rules: LeadQualificationRules = Field(default_factory=LeadQualificationRules)`

### `lightbulb.domain_primitives.QualifyLeadOutput`

class. Source: `lightbulb/domain_primitives.py:618`.

Fields:
- `score: int = Field(ge=0, le=100)`
- `qualification: Literal['qualified', 'disqualified', 'needs_research']`
- `reasons: list[str]`
- `missing_data: list[str]`
- `next_action: str`
- `profile_source: Literal['input', 'hubspot', 'salesforce']`

### `lightbulb.domain_primitives.QualifyLeadPrimitive`

class. Source: `lightbulb/domain_primitives.py:629`.

### `lightbulb.domain_primitives.OnboardingTask`

class. Source: `lightbulb/domain_primitives.py:771`.

Fields:
- `key: str`
- `title: str`
- `owner: str`
- `due: str`
- `approval_required: bool`

### `lightbulb.domain_primitives.OnboardEmployeeInput`

class. Source: `lightbulb/domain_primitives.py:781`.

Fields:
- `employee_name: str = Field(min_length=1, max_length=300)`
- `role_title: str = Field(min_length=1, max_length=300)`
- `start_date: str`
- `manager_email: str = Field(default='', max_length=320)`
- `department: str = Field(default='', max_length=200)`
- `location: str = Field(default='', max_length=300)`
- `systems: list[OnboardingSystem] = Field(default_factory=lambda: ['bamboohr', 'google_workspace'], min_length=1, max_length=3)`
- `provision: bool = False`

### `lightbulb.domain_primitives.OnboardEmployeeOutput`

class. Source: `lightbulb/domain_primitives.py:817`.

Fields:
- `employee_name: str`
- `role_title: str`
- `start_date: str`
- `tasks: list[OnboardingTask]`
- `systems: list[OnboardingSystem]`
- `state: Literal['plan', 'preview', 'pending_approval', 'provisioned', 'blocked', 'failed']`
- `system_refs: Dict[str, str] = Field(default_factory=dict)`

### `lightbulb.domain_primitives.OnboardEmployeePrimitive`

class. Source: `lightbulb/domain_primitives.py:829`.

## Module `lightbulb.durable_runtime`

Durable pause/resume, scheduling, events, and worker leasing for projects.

### `lightbulb.durable_runtime.default_checkpoint_dir`

function. Source: `lightbulb/durable_runtime.py:136`.



~~~python
default_checkpoint_dir(project_ref: str, *, tenant_id: str | None=None, company_id: str | None=None) -> Path
~~~


Return a local checkpoint directory isolated by authenticated scope.

### `lightbulb.durable_runtime.CheckpointConflictError`

class. Source: `lightbulb/durable_runtime.py:168`.

The checkpoint changed after a worker read it.

### `lightbulb.durable_runtime.CheckpointCompatibilityError`

class. Source: `lightbulb/durable_runtime.py:180`.

A checkpoint was created for different executable project semantics.

### `lightbulb.durable_runtime.CheckpointStatus`

class. Source: `lightbulb/durable_runtime.py:184`.

### `lightbulb.durable_runtime.WorkflowEventEnvelope`

class. Source: `lightbulb/durable_runtime.py:197`.

Fields:
- `schema_id: str = Field(default=WORKFLOW_EVENT_SCHEMA, alias='schema')`
- `event_id: str = Field(default_factory=lambda: f'event-{uuid4()}', min_length=1, max_length=200)`
- `project_ref: str = Field(min_length=1, max_length=128)`
- `event_type: str = Field(min_length=1, max_length=160)`
- `payload: Dict[str, Any] = Field(default_factory=dict)`
- `occurred_at: datetime = Field(default_factory=lambda: datetime.now(timezone.utc))`
- `source: str = Field(default='sdk', max_length=120)`

#### Methods

##### `lightbulb.durable_runtime.WorkflowEventEnvelope.fingerprint`



~~~python
def fingerprint() -> str
~~~


Source: `lightbulb/durable_runtime.py:213`.

##### `lightbulb.durable_runtime.WorkflowEventEnvelope.to_dict`



~~~python
def to_dict() -> Dict[str, Any]
~~~


Source: `lightbulb/durable_runtime.py:210`.

### `lightbulb.durable_runtime.WorkflowCheckpoint`

class. Source: `lightbulb/durable_runtime.py:227`.

Fields:
- `schema_id: str = Field(default=DURABLE_CHECKPOINT_SCHEMA, alias='schema')`
- `run_ref: str = Field(min_length=1, max_length=200, pattern='^[A-Za-z0-9._-]+$')`
- `project_ref: str = Field(min_length=1, max_length=128)`
- `scope_fingerprint: str | None = Field(default=None, pattern='^[0-9a-f]{64}$')`
- `hosted_project_id: UUID | None = None`
- `project_version: str = Field(min_length=1, max_length=80)`
- `workflow_key: str = Field(min_length=1, max_length=128)`
- `workflow_version: str | None = Field(default=None, min_length=1, max_length=80)`
- `workflow_identity_sha256: str | None = Field(default=None, pattern='^[0-9a-f]{64}$')`
- `primitive_versions: Dict[str, str] = Field(default_factory=dict)`
- `status: CheckpointStatus`
- `workflow_inputs: Dict[str, Any] = Field(default_factory=dict)`
- `preview_only: bool = True`
- `approval_refs: Dict[str, str] = Field(default_factory=dict)`
- `connector_account_refs: Dict[str, str] = Field(default_factory=dict)`
- `recovery_attestations: Dict[str, PrimitiveRecoveryAttestation] = Field(default_factory=dict)`
- `current_step: str | None = None`
- `step_runs: list[ProjectWorkflowStepRun] = Field(default_factory=list)`
- `events: list[PrimitiveEvent] = Field(default_factory=list)`
- `visits: Dict[str, int] = Field(default_factory=dict)`
- `saw_preview: bool = False`
- `last_event: PrimitiveEvent | None = None`
- `blockers: list[PrimitiveBlocker] = Field(default_factory=list)`
- `resume_at: datetime | None = None`
- `next_attempt_at: datetime | None = None`
- `step_attempts: Dict[str, int] = Field(default_factory=dict)`
- `step_invocations: Dict[str, int] = Field(default_factory=dict)`
- `active_step_id: str | None = Field(default=None, max_length=128)`
- `active_attempt_key: str | None = Field(default=None, max_length=132)`
- `legacy_step_idempotency_mode: bool = False`
- `trigger_event_id: str | None = Field(default=None, max_length=200)`
- `lease_owner: str | None = Field(default=None, max_length=200)`
- `lease_until: datetime | None = None`
- `revision: int = Field(default=0, ge=0)`
- `created_at: datetime = Field(default_factory=lambda: datetime.now(timezone.utc))`
- `updated_at: datetime = Field(default_factory=lambda: datetime.now(timezone.utc))`

#### Methods

##### `lightbulb.durable_runtime.WorkflowCheckpoint.to_dict`



~~~python
def to_dict() -> Dict[str, Any]
~~~


Source: `lightbulb/durable_runtime.py:492`.

### `lightbulb.durable_runtime.WorkflowCheckpointStore`

class. Source: `lightbulb/durable_runtime.py:496`.

#### Methods

##### `lightbulb.durable_runtime.WorkflowCheckpointStore.claim_next`



~~~python
def claim_next(project_ref: str, *, worker_ref: str, now: datetime, lease_seconds: int) -> WorkflowCheckpoint | None
~~~


Source: `lightbulb/durable_runtime.py:514`.

##### `lightbulb.durable_runtime.WorkflowCheckpointStore.get`



~~~python
def get(run_ref: str) -> WorkflowCheckpoint | None
~~~


Source: `lightbulb/durable_runtime.py:504`.

##### `lightbulb.durable_runtime.WorkflowCheckpointStore.list_ready`



~~~python
def list_ready(project_ref: str, *, now: datetime, limit: int=100) -> list[WorkflowCheckpoint]
~~~


Source: `lightbulb/durable_runtime.py:506`.

##### `lightbulb.durable_runtime.WorkflowCheckpointStore.record_event`



~~~python
def record_event(event: WorkflowEventEnvelope) -> bool
~~~


Source: `lightbulb/durable_runtime.py:533`.

##### `lightbulb.durable_runtime.WorkflowCheckpointStore.renew_lease`



~~~python
def renew_lease(run_ref: str, *, worker_ref: str, expected_revision: int, now: datetime, lease_seconds: int) -> WorkflowCheckpoint
~~~


Source: `lightbulb/durable_runtime.py:523`.

##### `lightbulb.durable_runtime.WorkflowCheckpointStore.save`



~~~python
def save(checkpoint: WorkflowCheckpoint, *, expected_revision: int | None) -> WorkflowCheckpoint
~~~


Source: `lightbulb/durable_runtime.py:497`.

### `lightbulb.durable_runtime.InMemoryCheckpointStore`

class. Source: `lightbulb/durable_runtime.py:548`.

Revisioned checkpoint store and queue for tests and one-process workers.

#### Methods

##### `lightbulb.durable_runtime.InMemoryCheckpointStore.claim_next`



~~~python
def claim_next(project_ref: str, *, worker_ref: str, now: datetime, lease_seconds: int) -> WorkflowCheckpoint | None
~~~


Source: `lightbulb/durable_runtime.py:610`.

##### `lightbulb.durable_runtime.InMemoryCheckpointStore.get`



~~~python
def get(run_ref: str) -> WorkflowCheckpoint | None
~~~


Source: `lightbulb/durable_runtime.py:586`.

##### `lightbulb.durable_runtime.InMemoryCheckpointStore.list_ready`



~~~python
def list_ready(project_ref: str, *, now: datetime, limit: int=100) -> list[WorkflowCheckpoint]
~~~


Source: `lightbulb/durable_runtime.py:591`.

##### `lightbulb.durable_runtime.InMemoryCheckpointStore.record_event`



~~~python
def record_event(event: WorkflowEventEnvelope) -> bool
~~~


Source: `lightbulb/durable_runtime.py:691`.

##### `lightbulb.durable_runtime.InMemoryCheckpointStore.renew_lease`



~~~python
def renew_lease(run_ref: str, *, worker_ref: str, expected_revision: int, now: datetime, lease_seconds: int) -> WorkflowCheckpoint
~~~


Source: `lightbulb/durable_runtime.py:641`.

##### `lightbulb.durable_runtime.InMemoryCheckpointStore.save`



~~~python
def save(checkpoint: WorkflowCheckpoint, *, expected_revision: int | None) -> WorkflowCheckpoint
~~~


Source: `lightbulb/durable_runtime.py:556`.

### `lightbulb.durable_runtime.JsonFileCheckpointStore`

class. Source: `lightbulb/durable_runtime.py:773`.

Atomic local persistence for durable development and single-host workers.

#### Methods

##### `lightbulb.durable_runtime.JsonFileCheckpointStore.claim_next`



~~~python
def claim_next(project_ref: str, *, worker_ref: str, now: datetime, lease_seconds: int) -> WorkflowCheckpoint | None
~~~


Source: `lightbulb/durable_runtime.py:906`.

##### `lightbulb.durable_runtime.JsonFileCheckpointStore.get`



~~~python
def get(run_ref: str) -> WorkflowCheckpoint | None
~~~


Source: `lightbulb/durable_runtime.py:886`.

##### `lightbulb.durable_runtime.JsonFileCheckpointStore.list_ready`



~~~python
def list_ready(project_ref: str, *, now: datetime, limit: int=100) -> list[WorkflowCheckpoint]
~~~


Source: `lightbulb/durable_runtime.py:895`.

##### `lightbulb.durable_runtime.JsonFileCheckpointStore.record_event`



~~~python
def record_event(event: WorkflowEventEnvelope) -> bool
~~~


Source: `lightbulb/durable_runtime.py:949`.

##### `lightbulb.durable_runtime.JsonFileCheckpointStore.renew_lease`



~~~python
def renew_lease(run_ref: str, *, worker_ref: str, expected_revision: int, now: datetime, lease_seconds: int) -> WorkflowCheckpoint
~~~


Source: `lightbulb/durable_runtime.py:927`.

##### `lightbulb.durable_runtime.JsonFileCheckpointStore.save`



~~~python
def save(checkpoint: WorkflowCheckpoint, *, expected_revision: int | None) -> WorkflowCheckpoint
~~~


Source: `lightbulb/durable_runtime.py:873`.

### `lightbulb.durable_runtime.HostedCheckpointStore`

class. Source: `lightbulb/durable_runtime.py:973`.

Checkpoint store backed by the authenticated Lightbulb control plane.

#### Methods

##### `lightbulb.durable_runtime.HostedCheckpointStore.claim_next`



~~~python
def claim_next(project_ref: str, *, worker_ref: str, now: datetime, lease_seconds: int) -> WorkflowCheckpoint | None
~~~


Source: `lightbulb/durable_runtime.py:1039`.

##### `lightbulb.durable_runtime.HostedCheckpointStore.get`



~~~python
def get(run_ref: str) -> WorkflowCheckpoint | None
~~~


Source: `lightbulb/durable_runtime.py:1021`.

##### `lightbulb.durable_runtime.HostedCheckpointStore.list_ready`



~~~python
def list_ready(project_ref: str, *, now: datetime, limit: int=100) -> list[WorkflowCheckpoint]
~~~


Source: `lightbulb/durable_runtime.py:1025`.

##### `lightbulb.durable_runtime.HostedCheckpointStore.record_event`



~~~python
def record_event(event: WorkflowEventEnvelope) -> bool
~~~


Source: `lightbulb/durable_runtime.py:1076`.

##### `lightbulb.durable_runtime.HostedCheckpointStore.renew_lease`



~~~python
def renew_lease(run_ref: str, *, worker_ref: str, expected_revision: int, now: datetime, lease_seconds: int) -> WorkflowCheckpoint
~~~


Source: `lightbulb/durable_runtime.py:1057`.

##### `lightbulb.durable_runtime.HostedCheckpointStore.save`



~~~python
def save(checkpoint: WorkflowCheckpoint, *, expected_revision: int | None) -> WorkflowCheckpoint
~~~


Source: `lightbulb/durable_runtime.py:1007`.

### `lightbulb.durable_runtime.DurableProjectRuntime`

class. Source: `lightbulb/durable_runtime.py:1157`.

Execute a :class:`ProjectRuntime` with revisioned durable state.

#### Methods

##### `lightbulb.durable_runtime.DurableProjectRuntime.dispatch_workflow`



~~~python
def dispatch_workflow(workflow_key: str, inputs: Mapping[str, Any], *, preview_only: bool | None=None, approval_refs: Mapping[str, str] | None=None, connector_account_refs: Mapping[str, str] | None=None, run_ref: str | None=None, trigger_event_id: str | None=None) -> WorkflowCheckpoint
~~~


Source: `lightbulb/durable_runtime.py:1228`.

##### `lightbulb.durable_runtime.DurableProjectRuntime.get_checkpoint`



~~~python
def get_checkpoint(run_ref: str) -> WorkflowCheckpoint | None
~~~


Source: `lightbulb/durable_runtime.py:1170`.

##### `lightbulb.durable_runtime.DurableProjectRuntime.ingest_event`



~~~python
def ingest_event(event: WorkflowEventEnvelope | Mapping[str, Any], *, preview_only: bool | None=None, connector_account_refs: Mapping[str, str] | None=None) -> list[WorkflowCheckpoint]
~~~


Source: `lightbulb/durable_runtime.py:1343`.

##### `lightbulb.durable_runtime.DurableProjectRuntime.resume_workflow`



~~~python
def resume_workflow(run_ref: str, *, input_updates: Mapping[str, Any] | None=None, approval_refs: Mapping[str, str] | None=None, connector_account_refs: Mapping[str, str] | None=None, recovery_attestations: Mapping[str, PrimitiveRecoveryAttestation | Mapping[str, Any]] | None=None, tenant_ref: str='authenticated', company_ref: str='selected', actor_ref: str | None=None) -> ProjectWorkflowRun
~~~


Source: `lightbulb/durable_runtime.py:1250`.

##### `lightbulb.durable_runtime.DurableProjectRuntime.run_next`



~~~python
def run_next(*, worker_ref: str, now: datetime | None=None, lease_seconds: int=60, tenant_ref: str='authenticated', company_ref: str='selected', actor_ref: str | None=None) -> ProjectWorkflowRun | None
~~~


Source: `lightbulb/durable_runtime.py:1401`.

##### `lightbulb.durable_runtime.DurableProjectRuntime.run_ready`



~~~python
def run_ready(*, worker_ref: str, now: datetime | None=None, limit: int=100, lease_seconds: int=60) -> list[ProjectWorkflowRun]
~~~


Source: `lightbulb/durable_runtime.py:1432`.

##### `lightbulb.durable_runtime.DurableProjectRuntime.schedule_workflow`



~~~python
def schedule_workflow(workflow_key: str, inputs: Mapping[str, Any], *, resume_at: datetime, preview_only: bool | None=None, approval_refs: Mapping[str, str] | None=None, connector_account_refs: Mapping[str, str] | None=None, run_ref: str | None=None) -> WorkflowCheckpoint
~~~


Source: `lightbulb/durable_runtime.py:1205`.

##### `lightbulb.durable_runtime.DurableProjectRuntime.start_workflow`



~~~python
def start_workflow(workflow_key: str, inputs: Mapping[str, Any], *, preview_only: bool | None=None, approval_refs: Mapping[str, str] | None=None, connector_account_refs: Mapping[str, str] | None=None, run_ref: str | None=None, tenant_ref: str='authenticated', company_ref: str='selected', actor_ref: str | None=None) -> ProjectWorkflowRun
~~~


Source: `lightbulb/durable_runtime.py:1176`.

## Module `lightbulb.dynamic_workflow_hosts`

Host-neutral identities for dynamic workflow harness sessions.

### `lightbulb.dynamic_workflow_hosts.DynamicWorkflowHostCapability`

class. Source: `lightbulb/dynamic_workflow_hosts.py:175`.

### `lightbulb.dynamic_workflow_hosts.DynamicWorkflowHostCapabilities`

class. Source: `lightbulb/dynamic_workflow_hosts.py:188`.

Observed host capabilities normalized to a bounded vocabulary.

Fields:
- `values: frozenset[DynamicWorkflowHostCapability] = field(default_factory=frozenset)`

#### Methods

##### `lightbulb.dynamic_workflow_hosts.DynamicWorkflowHostCapabilities.supports`



~~~python
def supports(capability: DynamicWorkflowHostCapability) -> bool
~~~


Source: `lightbulb/dynamic_workflow_hosts.py:206`.

##### `lightbulb.dynamic_workflow_hosts.DynamicWorkflowHostCapabilities.to_list`



~~~python
def to_list() -> list[str]
~~~


Source: `lightbulb/dynamic_workflow_hosts.py:209`.

### `lightbulb.dynamic_workflow_hosts.DynamicWorkflowHostSessionIdentity`

class. Source: `lightbulb/dynamic_workflow_hosts.py:214`.

Opaque, host-neutral session identity bound to exact Lightbulb scope.

Fields:
- `harness_id: str`
- `opaque_session_id: str = field(repr=False)`
- `scope: DynamicWorkflowScope`
- `capabilities: DynamicWorkflowHostCapabilities = field(default_factory=DynamicWorkflowHostCapabilities)`

#### Methods

##### `lightbulb.dynamic_workflow_hosts.DynamicWorkflowHostSessionIdentity.session_binding_ref`



~~~python
@property
def session_binding_ref() -> str
~~~


Return a domain-separated digest safe for persistence and logs.

Source: `lightbulb/dynamic_workflow_hosts.py:243`.

##### `lightbulb.dynamic_workflow_hosts.DynamicWorkflowHostSessionIdentity.to_dict`



~~~python
def to_dict() -> dict[str, object]
~~~


Serialize without exposing the provider's raw session identifier.

Source: `lightbulb/dynamic_workflow_hosts.py:256`.

### `lightbulb.dynamic_workflow_hosts.DynamicWorkflowHostRegistry`

class. Source: `lightbulb/dynamic_workflow_hosts.py:474`.

Registry that dispatches normalization without dispatching host calls.

#### Methods

##### `lightbulb.dynamic_workflow_hosts.DynamicWorkflowHostRegistry.adapters`



~~~python
@property
def adapters() -> Mapping[str, DynamicWorkflowHostAdapter]
~~~


Source: `lightbulb/dynamic_workflow_hosts.py:490`.

##### `lightbulb.dynamic_workflow_hosts.DynamicWorkflowHostRegistry.get`



~~~python
def get(harness_id: str) -> DynamicWorkflowHostAdapter
~~~


Source: `lightbulb/dynamic_workflow_hosts.py:510`.

##### `lightbulb.dynamic_workflow_hosts.DynamicWorkflowHostRegistry.harness_ids`



~~~python
@property
def harness_ids() -> tuple[str, ...]
~~~


Source: `lightbulb/dynamic_workflow_hosts.py:486`.

##### `lightbulb.dynamic_workflow_hosts.DynamicWorkflowHostRegistry.normalize_capabilities`



~~~python
def normalize_capabilities(harness_id: str, capabilities: object) -> DynamicWorkflowHostCapabilities
~~~


Source: `lightbulb/dynamic_workflow_hosts.py:519`.

##### `lightbulb.dynamic_workflow_hosts.DynamicWorkflowHostRegistry.normalize_session_identity`



~~~python
def normalize_session_identity(harness_id: str, session: object, *, scope: DynamicWorkflowScope | Mapping[str, object], authorized_scope: DynamicWorkflowScope | Mapping[str, object], capabilities: object=None) -> DynamicWorkflowHostSessionIdentity
~~~


Source: `lightbulb/dynamic_workflow_hosts.py:526`.

##### `lightbulb.dynamic_workflow_hosts.DynamicWorkflowHostRegistry.register`



~~~python
def register(adapter: DynamicWorkflowHostAdapter, *, replace: bool=False) -> None
~~~


Source: `lightbulb/dynamic_workflow_hosts.py:493`.

### `lightbulb.dynamic_workflow_hosts.default_dynamic_workflow_host_registry`

function. Source: `lightbulb/dynamic_workflow_hosts.py:617`.



~~~python
default_dynamic_workflow_host_registry() -> DynamicWorkflowHostRegistry
~~~


Return a fresh registry containing the five supported harness adapters.

## Module `lightbulb.dynamic_workflow_scope_resolution`

Resolve public workflow refs into an authenticated hosted project scope.

### `lightbulb.dynamic_workflow_scope_resolution.DynamicWorkflowScopeResolutionError`

class. Source: `lightbulb/dynamic_workflow_scope_resolution.py:38`.

Raised when authenticated public scope discovery cannot resolve safely.

### `lightbulb.dynamic_workflow_scope_resolution.DynamicWorkflowScopeDiscoveryClient`

class. Source: `lightbulb/dynamic_workflow_scope_resolution.py:42`.

Small client surface required by :class:`DynamicWorkflowScopeResolver`.

#### Methods

##### `lightbulb.dynamic_workflow_scope_resolution.DynamicWorkflowScopeDiscoveryClient.list_companies`



~~~python
def list_companies() -> list[Mapping[str, object]]
~~~


Source: `lightbulb/dynamic_workflow_scope_resolution.py:47`.

##### `lightbulb.dynamic_workflow_scope_resolution.DynamicWorkflowScopeDiscoveryClient.list_projects`



~~~python
def list_projects(*, company_id: str | None=None) -> list[Mapping[str, object]]
~~~


Source: `lightbulb/dynamic_workflow_scope_resolution.py:49`.

##### `lightbulb.dynamic_workflow_scope_resolution.DynamicWorkflowScopeDiscoveryClient.whoami`



~~~python
def whoami() -> Mapping[str, object]
~~~


Source: `lightbulb/dynamic_workflow_scope_resolution.py:45`.

### `lightbulb.dynamic_workflow_scope_resolution.DynamicWorkflowScopeResolution`

class. Source: `lightbulb/dynamic_workflow_scope_resolution.py:220`.

Immutable binding of public refs to one internal hosted checkpoint store.

Fields:
- `scope: DynamicWorkflowScope`
- `hosted_project_id: str`
- `company_ref: str`
- `project_ref: str`

#### Methods

##### `lightbulb.dynamic_workflow_scope_resolution.DynamicWorkflowScopeResolution.to_dict`



~~~python
def to_dict() -> dict[str, str]
~~~


Serialize public selection handles without internal scope UUIDs.

Source: `lightbulb/dynamic_workflow_scope_resolution.py:261`.

### `lightbulb.dynamic_workflow_scope_resolution.DynamicWorkflowScopeResolver`

class. Source: `lightbulb/dynamic_workflow_scope_resolution.py:334`.

Resolve public refs against authenticated SDK discovery responses.

#### Methods

##### `lightbulb.dynamic_workflow_scope_resolution.DynamicWorkflowScopeResolver.resolve`



~~~python
def resolve(company_ref: str, project_ref: str) -> DynamicWorkflowScopeResolution
~~~


Source: `lightbulb/dynamic_workflow_scope_resolution.py:360`.

### `lightbulb.dynamic_workflow_scope_resolution.resolve_dynamic_workflow_scope`

function. Source: `lightbulb/dynamic_workflow_scope_resolution.py:570`.



~~~python
resolve_dynamic_workflow_scope(client: DynamicWorkflowScopeDiscoveryClient, company_ref: str, project_ref: str, *, authenticated_tenant_id: str, authenticated_user_id: str) -> DynamicWorkflowScopeResolution
~~~


Resolve public handles using explicit authenticated adapter identity.

## Module `lightbulb.dynamic_workflows`

Provider-neutral contracts for durable, evaluator-gated dynamic workflows.

### `lightbulb.dynamic_workflows.DynamicWorkflowError`

class. Source: `lightbulb/dynamic_workflows.py:73`.

Base error for rejected dynamic-workflow transitions.

### `lightbulb.dynamic_workflows.ScopeMismatchError`

class. Source: `lightbulb/dynamic_workflows.py:77`.

A transition attempted to cross a tenant, company, user, or project.

### `lightbulb.dynamic_workflows.InvalidTransitionError`

class. Source: `lightbulb/dynamic_workflows.py:81`.

A command is inconsistent with the current durable workflow state.

### `lightbulb.dynamic_workflows.WorkflowRunStatus`

class. Source: `lightbulb/dynamic_workflows.py:85`.

#### Methods

##### `lightbulb.dynamic_workflows.WorkflowRunStatus.terminal`



~~~python
@property
def terminal() -> bool
~~~


Source: `lightbulb/dynamic_workflows.py:96`.

### `lightbulb.dynamic_workflows.EvaluatorDecision`

class. Source: `lightbulb/dynamic_workflows.py:106`.

### `lightbulb.dynamic_workflows.BuilderOutcome`

class. Source: `lightbulb/dynamic_workflows.py:114`.

### `lightbulb.dynamic_workflows.DynamicWorkflowRole`

class. Source: `lightbulb/dynamic_workflows.py:120`.

### `lightbulb.dynamic_workflows.DynamicWorkflowScope`

class. Source: `lightbulb/dynamic_workflows.py:149`.

Complete authority scope; every field is required and compared exactly.

Fields:
- `tenant_id: str = Field(min_length=1, max_length=200)`
- `company_id: str = Field(min_length=1, max_length=200)`
- `user_id: str = Field(min_length=1, max_length=200)`
- `project_ref: str = Field(min_length=1, max_length=200)`

#### Methods

##### `lightbulb.dynamic_workflows.DynamicWorkflowScope.require_exact`



~~~python
def require_exact(other: 'DynamicWorkflowScope') -> None
~~~


Source: `lightbulb/dynamic_workflows.py:162`.

### `lightbulb.dynamic_workflows.WorkflowLimits`

class. Source: `lightbulb/dynamic_workflows.py:170`.

Finite run limits. Equality with a limit is allowed; exceeding it is not.

Fields:
- `max_plan_revisions: int = Field(default=3, ge=1, le=100)`
- `max_build_attempts: int = Field(default=8, ge=1, le=10000)`
- `max_evaluation_attempts: int = Field(default=8, ge=1, le=10000)`
- `max_iterations: int = Field(default=8, ge=1, le=10000)`
- `max_elapsed_seconds: int = Field(default=14400, ge=1, le=31536000)`
- `max_tokens: int = Field(default=10000000, ge=1)`
- `max_cost_microusd: int = Field(default=100000000, ge=0)`
- `max_handoff_bytes: int = Field(default=1000000, ge=256, description='Maximum cumulative serialized bytes in the handoff chain.')`
- `max_no_progress_digests: int = Field(default=2, ge=1, le=100)`

### `lightbulb.dynamic_workflows.UsageDelta`

class. Source: `lightbulb/dynamic_workflows.py:188`.

Fields:
- `elapsed_seconds: int = Field(default=0, ge=0)`
- `input_tokens: int = Field(default=0, ge=0)`
- `output_tokens: int = Field(default=0, ge=0)`
- `cost_microusd: int = Field(default=0, ge=0)`

#### Methods

##### `lightbulb.dynamic_workflows.UsageDelta.tokens`



~~~python
@property
def tokens() -> int
~~~


Source: `lightbulb/dynamic_workflows.py:195`.

### `lightbulb.dynamic_workflows.UsageTotals`

class. Source: `lightbulb/dynamic_workflows.py:199`.

Fields:
- `elapsed_seconds: int = Field(default=0, ge=0)`
- `input_tokens: int = Field(default=0, ge=0)`
- `output_tokens: int = Field(default=0, ge=0)`
- `cost_microusd: int = Field(default=0, ge=0)`

#### Methods

##### `lightbulb.dynamic_workflows.UsageTotals.add`



~~~python
def add(delta: UsageDelta) -> 'UsageTotals'
~~~


Source: `lightbulb/dynamic_workflows.py:209`.

##### `lightbulb.dynamic_workflows.UsageTotals.tokens`



~~~python
@property
def tokens() -> int
~~~


Source: `lightbulb/dynamic_workflows.py:206`.

### `lightbulb.dynamic_workflows.EvidenceRef`

class. Source: `lightbulb/dynamic_workflows.py:218`.

Content-addressed evidence; raw evidence never enters the control state.

Fields:
- `ref: str = Field(min_length=1, max_length=2000)`
- `sha256: str`
- `kind: str = Field(min_length=1, max_length=120)`
- `media_type: str | None = Field(default=None, max_length=200)`

### `lightbulb.dynamic_workflows.AcceptanceCriterion`

class. Source: `lightbulb/dynamic_workflows.py:240`.

An immutable acceptance obligation fixed before planning begins.

Fields:
- `criterion_id: str = Field(min_length=1, max_length=160)`
- `description: str = Field(min_length=1, max_length=4000)`
- `required_evidence: tuple[str, ...] = Field(min_length=1, max_length=50)`

### `lightbulb.dynamic_workflows.CriterionEvaluation`

class. Source: `lightbulb/dynamic_workflows.py:261`.

Default-fail result for one immutable criterion.

Fields:
- `criterion_id: str = Field(min_length=1, max_length=160)`
- `accepted: bool = False`
- `reason: str = Field(default='not_evaluated', min_length=1, max_length=4000)`
- `evidence_refs: tuple[EvidenceRef, ...] = Field(default_factory=tuple, max_length=200)`

### `lightbulb.dynamic_workflows.PlannerPlan`

class. Source: `lightbulb/dynamic_workflows.py:276`.

Fields:
- `scope: DynamicWorkflowScope`
- `run_ref: str = Field(min_length=1, max_length=200)`
- `plan_id: str = Field(min_length=1, max_length=200)`
- `revision: int = Field(ge=1)`
- `objective: str = Field(min_length=1, max_length=20000)`
- `acceptance_criteria: tuple[AcceptanceCriterion, ...] = Field(min_length=1, max_length=500)`
- `work_items: tuple[str, ...] = Field(min_length=1, max_length=1000)`
- `planner_context_id: str = Field(min_length=1, max_length=300)`
- `planner_session_id: str = Field(min_length=1, max_length=300)`
- `occurred_at: datetime`
- `usage: UsageDelta = Field(default_factory=UsageDelta)`

### `lightbulb.dynamic_workflows.BuilderAssignment`

class. Source: `lightbulb/dynamic_workflows.py:317`.

Fields:
- `scope: DynamicWorkflowScope`
- `run_ref: str = Field(min_length=1, max_length=200)`
- `assignment_id: str = Field(min_length=1, max_length=200)`
- `plan_digest: str`
- `plan_revision: int = Field(ge=1)`
- `iteration: int = Field(ge=1)`
- `instructions: str = Field(min_length=1, max_length=20000)`
- `acceptance_criteria_digest: str`
- `builder_context_id: str = Field(min_length=1, max_length=300)`
- `builder_session_id: str = Field(min_length=1, max_length=300)`
- `prior_verdict_digest: str | None = None`
- `occurred_at: datetime`
- `usage: UsageDelta = Field(default_factory=UsageDelta)`

### `lightbulb.dynamic_workflows.BuilderResult`

class. Source: `lightbulb/dynamic_workflows.py:358`.

Fields:
- `scope: DynamicWorkflowScope`
- `run_ref: str = Field(min_length=1, max_length=200)`
- `assignment_id: str = Field(min_length=1, max_length=200)`
- `plan_digest: str`
- `iteration: int = Field(ge=1)`
- `builder_context_id: str = Field(min_length=1, max_length=300)`
- `builder_session_id: str = Field(min_length=1, max_length=300)`
- `outcome: BuilderOutcome`
- `summary: str = Field(min_length=1, max_length=20000)`
- `evidence_refs: tuple[EvidenceRef, ...] = Field(default_factory=tuple, max_length=1000)`
- `progress_digest: str`
- `occurred_at: datetime`
- `usage: UsageDelta = Field(default_factory=UsageDelta)`

### `lightbulb.dynamic_workflows.EvaluatorVerdict`

class. Source: `lightbulb/dynamic_workflows.py:397`.

Fields:
- `scope: DynamicWorkflowScope`
- `run_ref: str = Field(min_length=1, max_length=200)`
- `verdict_id: str = Field(min_length=1, max_length=200)`
- `plan_digest: str`
- `builder_result_digest: str`
- `evaluator_context_id: str = Field(min_length=1, max_length=300)`
- `evaluator_session_id: str = Field(min_length=1, max_length=300)`
- `decision: EvaluatorDecision`
- `accepted: bool = False`
- `summary: str = Field(min_length=1, max_length=20000)`
- `criterion_results: tuple[CriterionEvaluation, ...] = Field(default_factory=tuple, max_length=500)`
- `occurred_at: datetime`
- `usage: UsageDelta = Field(default_factory=UsageDelta)`

### `lightbulb.dynamic_workflows.DynamicWorkflowHandoff`

class. Source: `lightbulb/dynamic_workflows.py:447`.

Fields:
- `schema_id: str = Field(default=DYNAMIC_WORKFLOW_HANDOFF_SCHEMA, alias='schema')`
- `scope: DynamicWorkflowScope`
- `run_ref: str = Field(min_length=1, max_length=200)`
- `sequence: int = Field(ge=1)`
- `source_role: DynamicWorkflowRole`
- `target_role: DynamicWorkflowRole`
- `artifact_type: str = Field(min_length=1, max_length=160)`
- `artifact_digest: str`
- `summary: str = Field(min_length=1, max_length=20000)`
- `evidence_refs: tuple[EvidenceRef, ...] = Field(default_factory=tuple, max_length=1000)`
- `previous_digest: str`
- `occurred_at: datetime`

#### Methods

##### `lightbulb.dynamic_workflows.DynamicWorkflowHandoff.byte_size`



~~~python
@property
def byte_size() -> int
~~~


Source: `lightbulb/dynamic_workflows.py:487`.

### `lightbulb.dynamic_workflows.DynamicWorkflowState`

class. Source: `lightbulb/dynamic_workflows.py:495`.

Immutable durable state for a single provider-neutral workflow run.

Fields:
- `schema_id: str = Field(default=DYNAMIC_WORKFLOW_STATE_SCHEMA, alias='schema')`
- `scope: DynamicWorkflowScope`
- `run_ref: str = Field(min_length=1, max_length=200)`
- `objective: str = Field(min_length=1, max_length=20000)`
- `acceptance_criteria: tuple[AcceptanceCriterion, ...] = Field(min_length=1, max_length=500)`
- `criterion_results: tuple[CriterionEvaluation, ...] = Field(min_length=1, max_length=500)`
- `limits: WorkflowLimits = Field(default_factory=WorkflowLimits)`
- `status: WorkflowRunStatus = WorkflowRunStatus.PLANNING`
- `revision: int = Field(default=0, ge=0)`
- `created_at: datetime`
- `updated_at: datetime`
- `plan_revisions: int = Field(default=0, ge=0)`
- `build_attempts: int = Field(default=0, ge=0)`
- `evaluation_attempts: int = Field(default=0, ge=0)`
- `iterations: int = Field(default=0, ge=0)`
- `usage: UsageTotals = Field(default_factory=UsageTotals)`
- `handoff_bytes: int = Field(default=0, ge=0)`
- `repeated_no_progress_digests: int = Field(default=0, ge=0)`
- `last_progress_digest: str | None = None`
- `current_plan: PlannerPlan | None = None`
- `current_assignment: BuilderAssignment | None = None`
- `current_builder_result: BuilderResult | None = None`
- `current_verdict: EvaluatorVerdict | None = None`
- `handoffs: tuple[DynamicWorkflowHandoff, ...] = Field(default_factory=tuple)`
- `builder_context_ids: tuple[str, ...] = Field(default_factory=tuple)`
- `builder_session_ids: tuple[str, ...] = Field(default_factory=tuple)`
- `evaluator_context_ids: tuple[str, ...] = Field(default_factory=tuple)`
- `evaluator_session_ids: tuple[str, ...] = Field(default_factory=tuple)`
- `terminal_reason: str | None = Field(default=None, max_length=4000)`

#### Methods

##### `lightbulb.dynamic_workflows.DynamicWorkflowState.acceptance_criteria_digest`



~~~python
@property
def acceptance_criteria_digest() -> str
~~~


Source: `lightbulb/dynamic_workflows.py:826`.

##### `lightbulb.dynamic_workflows.DynamicWorkflowState.assign_builder`



~~~python
def assign_builder(assignment: BuilderAssignment) -> 'DynamicWorkflowState'
~~~


Source: `lightbulb/dynamic_workflows.py:865`.

##### `lightbulb.dynamic_workflows.DynamicWorkflowState.block`



~~~python
def block(*, scope: DynamicWorkflowScope, reason: str, occurred_at: datetime) -> 'DynamicWorkflowState'
~~~


Source: `lightbulb/dynamic_workflows.py:1106`.

##### `lightbulb.dynamic_workflows.DynamicWorkflowState.cancel`



~~~python
def cancel(*, scope: DynamicWorkflowScope, reason: str, occurred_at: datetime) -> 'DynamicWorkflowState'
~~~


Source: `lightbulb/dynamic_workflows.py:1090`.

##### `lightbulb.dynamic_workflows.DynamicWorkflowState.create`



~~~python
def create(*, scope: DynamicWorkflowScope | Mapping[str, Any], run_ref: str, objective: str, acceptance_criteria: Iterable[AcceptanceCriterion | Mapping[str, Any]], created_at: datetime, limits: WorkflowLimits | Mapping[str, Any] | None=None) -> 'DynamicWorkflowState'
~~~


Source: `lightbulb/dynamic_workflows.py:782`.

##### `lightbulb.dynamic_workflows.DynamicWorkflowState.latest_handoff_digest`



~~~python
@property
def latest_handoff_digest() -> str
~~~


Source: `lightbulb/dynamic_workflows.py:830`.

##### `lightbulb.dynamic_workflows.DynamicWorkflowState.record_builder_result`



~~~python
def record_builder_result(result: BuilderResult) -> 'DynamicWorkflowState'
~~~


Source: `lightbulb/dynamic_workflows.py:914`.

##### `lightbulb.dynamic_workflows.DynamicWorkflowState.record_evaluator_verdict`



~~~python
def record_evaluator_verdict(verdict: EvaluatorVerdict) -> 'DynamicWorkflowState'
~~~


Source: `lightbulb/dynamic_workflows.py:997`.

##### `lightbulb.dynamic_workflows.DynamicWorkflowState.submit_plan`



~~~python
def submit_plan(plan: PlannerPlan) -> 'DynamicWorkflowState'
~~~


Source: `lightbulb/dynamic_workflows.py:833`.

##### `lightbulb.dynamic_workflows.DynamicWorkflowState.to_dict`



~~~python
def to_dict() -> dict[str, Any]
~~~


Source: `lightbulb/dynamic_workflows.py:822`.

## Module `lightbulb.errors`

Friendly exception hierarchy for the Lightbulb SDK.

### `lightbulb.errors.LightbulbError`

class. Source: `lightbulb/errors.py:51`.

Base for all Lightbulb SDK exceptions raised against the platform.

Fields:
- `status_code: Optional[int] = None`

### `lightbulb.errors.AuthenticationError`

class. Source: `lightbulb/errors.py:76`.

401 — credentials missing or invalid (token expired, bad password, etc.).

### `lightbulb.errors.PermissionDenied`

class. Source: `lightbulb/errors.py:81`.

403 — caller is authenticated but lacks permission for the action.

### `lightbulb.errors.NotFoundError`

class. Source: `lightbulb/errors.py:86`.

404 — resource does not exist or is outside the caller's scope.

### `lightbulb.errors.ValidationError`

class. Source: `lightbulb/errors.py:91`.

400 / 422 — request was malformed or rejected by server validation.

### `lightbulb.errors.TransportError`

class. Source: `lightbulb/errors.py:104`.

The request did not receive an HTTP response from Lightbulb.

### `lightbulb.errors.RateLimitedError`

class. Source: `lightbulb/errors.py:117`.

429 — too many requests. Back off and retry.

### `lightbulb.errors.ServerError`

class. Source: `lightbulb/errors.py:132`.

5xx — the platform itself is unhappy. Usually transient.

### `lightbulb.errors.from_response`

function. Source: `lightbulb/errors.py:176`.



~~~python
from_response(response: httpx.Response, *, default_message: str='') -> LightbulbError
~~~


Map an HTTP response to the matching LightbulbError subclass.

### `lightbulb.errors.wrap_http_error`

function. Source: `lightbulb/errors.py:192`.



~~~python
wrap_http_error(exc: httpx.HTTPStatusError) -> LightbulbError
~~~


Convert an ``httpx.HTTPStatusError`` to a LightbulbError without leaking the body.

### `lightbulb.errors.wrap_transport_error`

function. Source: `lightbulb/errors.py:197`.



~~~python
wrap_transport_error(exc: httpx.RequestError) -> TransportError
~~~


Convert an httpx network failure without exposing its raw message.

### `lightbulb.errors.raise_if_error`

function. Source: `lightbulb/errors.py:221`.



~~~python
raise_if_error(response: httpx.Response) -> None
~~~


Raise a :class:`LightbulbError` subclass if ``response`` has an error status.

## Module `lightbulb.executable_primitives`

Built-in executable business process primitives shipped by the SDK.

### `lightbulb.executable_primitives.ReplyClassificationInput`

class. Source: `lightbulb/executable_primitives.py:356`.

Fields:
- `reply_text: str = Field(min_length=1, max_length=100000)`
- `thread_context: Dict[str, Any] = Field(default_factory=dict)`
- `taxonomy: list[str] = Field(default_factory=list, max_length=100)`
- `confidence_threshold: float = Field(default=0.75, ge=0, le=1)`
- `channel: str = Field(default='email', min_length=1, max_length=40)`

### `lightbulb.executable_primitives.ReplyClassificationOutput`

class. Source: `lightbulb/executable_primitives.py:366`.

Fields:
- `intent: str`
- `confidence: float = Field(ge=0, le=1)`
- `route_event: str`
- `needs_human_review: bool`
- `evidence_labels: list[str]`
- `channel: str`

### `lightbulb.executable_primitives.ClassifyReplyPrimitive`

class. Source: `lightbulb/executable_primitives.py:377`.

### `lightbulb.executable_primitives.WriteEmailInput`

class. Source: `lightbulb/executable_primitives.py:519`.

Fields:
- `to: list[str] = Field(default_factory=list, max_length=100)`
- `subject: str = Field(default='', max_length=998)`
- `body: str = Field(default='', max_length=500000)`
- `intent: str = Field(default='', max_length=120)`
- `tone: str = Field(default='professional', max_length=80)`
- `send: bool = False`
- `provider: Literal['gmail', 'microsoft', 'notifications', 'ses'] = 'gmail'`
- `thread_id: str | None = Field(default=None, min_length=1, max_length=512)`
- `parent_message_id: str | None = Field(default=None, min_length=3, max_length=998)`

### `lightbulb.executable_primitives.WriteEmailOutput`

class. Source: `lightbulb/executable_primitives.py:586`.

Fields:
- `recipients: list[str]`
- `subject: str`
- `body: str`
- `tone: str`
- `provider: str`
- `state: Literal['draft', 'preview', 'pending_approval', 'sent', 'blocked', 'failed']`
- `message_ref: str | None = None`

### `lightbulb.executable_primitives.WriteEmailPrimitive`

class. Source: `lightbulb/executable_primitives.py:598`.

### `lightbulb.executable_primitives.InvoiceLineItem`

class. Source: `lightbulb/executable_primitives.py:726`.

Fields:
- `description: str = Field(min_length=1, max_length=500)`
- `quantity: Decimal = Field(default=Decimal('1'), gt=0)`
- `unit_amount: Decimal = Field(gt=0)`
- `account_code: str | None = Field(default=None, max_length=80)`

### `lightbulb.executable_primitives.CreateInvoiceInput`

class. Source: `lightbulb/executable_primitives.py:735`.

Fields:
- `provider: Literal['xero', 'quickbooks', 'stripe', 'square'] = 'xero'`
- `customer_name: str = Field(default='', max_length=300)`
- `customer_id: str = Field(default='', max_length=200)`
- `line_items: list[InvoiceLineItem] = Field(default_factory=list, max_length=500)`
- `amount: Decimal | None = Field(default=None, gt=0)`
- `currency: str = Field(default='USD', min_length=3, max_length=3)`
- `due_date: str = Field(default='', max_length=20)`
- `reference: str = Field(default='', max_length=200)`
- `memo: str = Field(default='', max_length=5000)`
- `commit: bool = False`

### `lightbulb.executable_primitives.CreateInvoiceOutput`

class. Source: `lightbulb/executable_primitives.py:766`.

Fields:
- `provider: str`
- `customer_name: str`
- `customer_id: str`
- `currency: str`
- `subtotal: Decimal`
- `total: Decimal`
- `state: Literal['draft', 'preview', 'pending_approval', 'created', 'blocked', 'failed']`
- `invoice_ref: str | None = None`

### `lightbulb.executable_primitives.CreateInvoicePrimitive`

class. Source: `lightbulb/executable_primitives.py:781`.

### `lightbulb.executable_primitives.ScheduleMeetingInput`

class. Source: `lightbulb/executable_primitives.py:909`.

Fields:
- `attendees: list[str] = Field(min_length=1, max_length=100)`
- `title: str = Field(min_length=1, max_length=500)`
- `time_window: str = Field(default='', max_length=500)`
- `start_time: str = Field(default='', max_length=80)`
- `duration_minutes: int = Field(default=30, ge=5, le=1440)`
- `agenda: str = Field(default='', max_length=20000)`
- `provider: Literal['calendar', 'microsoft'] = 'calendar'`
- `create_invite: bool = False`

### `lightbulb.executable_primitives.ScheduleMeetingOutput`

class. Source: `lightbulb/executable_primitives.py:942`.

Fields:
- `attendees: list[str]`
- `title: str`
- `proposed_slots: list[str]`
- `duration_minutes: int`
- `provider: str`
- `state: Literal['proposed', 'preview', 'pending_approval', 'scheduled', 'blocked', 'failed']`
- `event_ref: str | None = None`

### `lightbulb.executable_primitives.ScheduleMeetingPrimitive`

class. Source: `lightbulb/executable_primitives.py:956`.

### `lightbulb.executable_primitives.default_primitive_registry`

function. Source: `lightbulb/executable_primitives.py:1176`.



~~~python
default_primitive_registry(extra_primitives: Iterable[BusinessProcessPrimitive[Any, Any]]=()) -> PrimitiveRegistry
~~~


### `lightbulb.executable_primitives.executable_business_primitive_catalog`

function. Source: `lightbulb/executable_primitives.py:1185`.



~~~python
executable_business_primitive_catalog(*, query: str='', include_schemas: bool=True, offset: int=0, limit: int | None=None) -> Dict[str, Any]
~~~


Return a filterable, optionally paged executable primitive catalog.

## Module `lightbulb.finance_accounting`

Deterministic accounting control evaluations for governed finance workflows.

### `lightbulb.finance_accounting.CompanyAccountingContext`

class. Source: `lightbulb/finance_accounting.py:185`.

Fields:
- `company_ref: OpaqueRef`
- `functional_currency: CurrencyCode`
- `allowed_transaction_currencies: tuple[CurrencyCode, ...] = Field(min_length=1, max_length=20)`
- `amount_scale: int = Field(default=2, ge=0, le=8)`

### `lightbulb.finance_accounting.AccountingPeriodContext`

class. Source: `lightbulb/finance_accounting.py:212`.

Fields:
- `period_ref: OpaqueRef`
- `company_ref: OpaqueRef`
- `functional_currency: CurrencyCode`
- `start_date: str`
- `end_date: str`
- `state: AccountingPeriodState`

### `lightbulb.finance_accounting.ChartAccountControl`

class. Source: `lightbulb/finance_accounting.py:232`.

Fields:
- `account_ref: OpaqueRef`
- `company_ref: OpaqueRef`
- `allowed_currencies: tuple[CurrencyCode, ...] = Field(min_length=1, max_length=20)`
- `active: bool`
- `posting_allowed: bool`
- `reconciliation_required: bool = False`

### `lightbulb.finance_accounting.AccountingEvidencePolicy`

class. Source: `lightbulb/finance_accounting.py:252`.

Fields:
- `required_kinds: tuple[ShortText, ...] = Field(default_factory=tuple, max_length=20)`
- `maximum_age_hours: int = Field(default=72, ge=1, le=8760)`
- `minimum_verification_grade: PrimitiveEvidenceVerificationGrade = PrimitiveEvidenceVerificationGrade.ATTESTED`
- `require_effective_at: bool = False`

### `lightbulb.finance_accounting.AccountingControlGate`

class. Source: `lightbulb/finance_accounting.py:279`.

Fields:
- `control_ref: OpaqueRef`
- `name: ShortText`
- `required: bool = True`
- `status: ControlGateStatus`
- `evaluated_by_ref: OpaqueRef | None = None`
- `evidence_refs: tuple[OpaqueRef, ...] = Field(default_factory=tuple, max_length=20)`

### `lightbulb.finance_accounting.AccountingApprovalGate`

class. Source: `lightbulb/finance_accounting.py:293`.

Fields:
- `required: bool = True`
- `status: ApprovalStatus`
- `prepared_by_ref: OpaqueRef`
- `approved_by_ref: OpaqueRef | None = None`
- `evidence_refs: tuple[OpaqueRef, ...] = Field(default_factory=tuple, max_length=20)`

### `lightbulb.finance_accounting.FinanceControlFinding`

class. Source: `lightbulb/finance_accounting.py:306`.

Fields:
- `code: ControlCode`
- `status: FinanceControlStatus`
- `message: ShortText`
- `field: ShortText | None = None`
- `affected_refs: tuple[OpaqueRef, ...] = Field(default_factory=tuple, max_length=100)`
- `evidence_refs: tuple[OpaqueRef, ...] = Field(default_factory=tuple, max_length=20)`

### `lightbulb.finance_accounting.JournalEntryLine`

class. Source: `lightbulb/finance_accounting.py:320`.

Fields:
- `line_ref: OpaqueRef`
- `account_ref: OpaqueRef`
- `company_ref: OpaqueRef`
- `currency: CurrencyCode`
- `debit: Decimal = Field(default=Decimal('0'), ge=0, le=_MAX_MONEY)`
- `credit: Decimal = Field(default=Decimal('0'), ge=0, le=_MAX_MONEY)`

### `lightbulb.finance_accounting.JournalEntryControlInput`

class. Source: `lightbulb/finance_accounting.py:334`.

Fields:
- `schema_id: Literal['lightbulb.finance_journal_entry_control_input.v1'] = Field(default=JOURNAL_ENTRY_CONTROL_INPUT_SCHEMA, alias='schema')`
- `evaluation_ref: OpaqueRef`
- `evaluation_as_of: str`
- `entry_ref: OpaqueRef`
- `entry_date: str`
- `transaction_currency: CurrencyCode`
- `company: CompanyAccountingContext`
- `period: AccountingPeriodContext`
- `chart_of_accounts_complete: bool`
- `chart_of_accounts: tuple[ChartAccountControl, ...] = Field(min_length=1, max_length=2000)`
- `lines: tuple[JournalEntryLine, ...] = Field(min_length=2, max_length=1000)`
- `approval: AccountingApprovalGate`
- `control_gates: tuple[AccountingControlGate, ...] = Field(default_factory=tuple, max_length=100)`
- `evidence_policy: AccountingEvidencePolicy = Field(default_factory=lambda: AccountingEvidencePolicy(required_kinds=_JOURNAL_REQUIRED_EVIDENCE_KINDS))`
- `evidence_refs: tuple[PrimitiveEvidenceRef, ...] = Field(default_factory=tuple, max_length=200)`

### `lightbulb.finance_accounting.ReconciliationControl`

class. Source: `lightbulb/finance_accounting.py:406`.

Fields:
- `reconciliation_ref: OpaqueRef`
- `account_ref: OpaqueRef`
- `company_ref: OpaqueRef`
- `period_ref: OpaqueRef`
- `balance_as_of: str`
- `status: ReconciliationStatus`
- `unreconciled_amount: Decimal | None = Field(default=None, ge=0, le=_MAX_MONEY)`
- `reviewed_by_ref: OpaqueRef | None = None`
- `completed_at: str | None = None`
- `evidence_refs: tuple[OpaqueRef, ...] = Field(default_factory=tuple, max_length=20)`

### `lightbulb.finance_accounting.ConsolidationReadiness`

class. Source: `lightbulb/finance_accounting.py:453`.

Fields:
- `required: bool`
- `group_currency: CurrencyCode | None = None`
- `required_entity_refs: tuple[OpaqueRef, ...] = Field(default_factory=tuple, max_length=200)`
- `received_entity_refs: tuple[OpaqueRef, ...] = Field(default_factory=tuple, max_length=200)`
- `currency_translation_status: ControlGateStatus`
- `intercompany_matching_status: ControlGateStatus`
- `elimination_status: ControlGateStatus`
- `elimination_debits: Decimal | None = Field(default=None, ge=0, le=_MAX_MONEY)`
- `elimination_credits: Decimal | None = Field(default=None, ge=0, le=_MAX_MONEY)`
- `approved_by_ref: OpaqueRef | None = None`
- `evidence_refs: tuple[OpaqueRef, ...] = Field(default_factory=tuple, max_length=40)`

### `lightbulb.finance_accounting.PeriodCloseReadinessInput`

class. Source: `lightbulb/finance_accounting.py:496`.

Fields:
- `schema_id: Literal['lightbulb.finance_period_close_readiness_input.v1'] = Field(default=PERIOD_CLOSE_READINESS_INPUT_SCHEMA, alias='schema')`
- `evaluation_ref: OpaqueRef`
- `evaluation_as_of: str`
- `close_ref: OpaqueRef`
- `company: CompanyAccountingContext`
- `period: AccountingPeriodContext`
- `chart_of_accounts_complete: bool`
- `chart_of_accounts: tuple[ChartAccountControl, ...] = Field(min_length=1, max_length=2000)`
- `trial_balance_debits: Decimal = Field(ge=0, le=_MAX_MONEY)`
- `trial_balance_credits: Decimal = Field(ge=0, le=_MAX_MONEY)`
- `reconciliations: tuple[ReconciliationControl, ...] = Field(default_factory=tuple, max_length=2000)`
- `consolidation: ConsolidationReadiness`
- `approval: AccountingApprovalGate`
- `control_gates: tuple[AccountingControlGate, ...] = Field(default_factory=tuple, max_length=100)`
- `evidence_policy: AccountingEvidencePolicy = Field(default_factory=lambda: AccountingEvidencePolicy(required_kinds=_PERIOD_CLOSE_REQUIRED_EVIDENCE_KINDS))`
- `evidence_refs: tuple[PrimitiveEvidenceRef, ...] = Field(default_factory=tuple, max_length=200)`

### `lightbulb.finance_accounting.JournalEntryControlEvaluation`

class. Source: `lightbulb/finance_accounting.py:671`.

Fields:
- `schema_id: Literal['lightbulb.finance_journal_entry_control_evaluation.v1'] = Field(default=JOURNAL_ENTRY_CONTROL_EVALUATION_SCHEMA, alias='schema')`
- `entry_ref: OpaqueRef`
- `transaction_currency: CurrencyCode`
- `debit_total: Decimal`
- `credit_total: Decimal`
- `imbalance: Decimal`
- `posting_authorized: Literal[False] = False`

### `lightbulb.finance_accounting.PeriodCloseReadinessEvaluation`

class. Source: `lightbulb/finance_accounting.py:696`.

Fields:
- `schema_id: Literal['lightbulb.finance_period_close_readiness_evaluation.v1'] = Field(default=PERIOD_CLOSE_READINESS_EVALUATION_SCHEMA, alias='schema')`
- `close_ref: OpaqueRef`
- `trial_balance_debits: Decimal`
- `trial_balance_credits: Decimal`
- `trial_balance_imbalance: Decimal`
- `required_reconciliation_count: int = Field(ge=0, le=2000)`
- `completed_reconciliation_count: int = Field(ge=0, le=2000)`
- `consolidation_required: bool`
- `missing_entity_refs: tuple[OpaqueRef, ...] = Field(default_factory=tuple, max_length=200)`
- `close_authorized: Literal[False] = False`

### `lightbulb.finance_accounting.evaluate_journal_entry_controls`

function. Source: `lightbulb/finance_accounting.py:1085`.



~~~python
evaluate_journal_entry_controls(inputs: JournalEntryControlInput | Mapping[str, Any]) -> JournalEntryControlEvaluation
~~~


Evaluate a journal package without authorizing or posting it.

### `lightbulb.finance_accounting.evaluate_period_close_readiness`

function. Source: `lightbulb/finance_accounting.py:1285`.



~~~python
evaluate_period_close_readiness(inputs: PeriodCloseReadinessInput | Mapping[str, Any]) -> PeriodCloseReadinessEvaluation
~~~


Evaluate close controls without authorizing or closing the period.

### `lightbulb.finance_accounting.EvaluateJournalEntryControlsPrimitive`

class. Source: `lightbulb/finance_accounting.py:1867`.

#### Methods

##### `lightbulb.finance_accounting.EvaluateJournalEntryControlsPrimitive.implementation_contract`



~~~python
def implementation_contract() -> dict[str, Any]
~~~


Source: `lightbulb/finance_accounting.py:1888`.

### `lightbulb.finance_accounting.EvaluatePeriodCloseReadinessPrimitive`

class. Source: `lightbulb/finance_accounting.py:1913`.

#### Methods

##### `lightbulb.finance_accounting.EvaluatePeriodCloseReadinessPrimitive.implementation_contract`



~~~python
def implementation_contract() -> dict[str, Any]
~~~


Source: `lightbulb/finance_accounting.py:1937`.

## Module `lightbulb.finance_adjusting_entries_package`

Prepare a controlled period-close adjusting-entries package candidate.

### `lightbulb.finance_adjusting_entries_package.AdjustmentJournalPostingEvidence`

class. Source: `lightbulb/finance_adjusting_entries_package.py:135`.

Fields:
- `effective_at: str`
- `provider: Literal['quickbooks', 'xero']`
- `journal: JournalEntryControlInput`
- `preparation: JournalEntryPreparation`
- `post_result: PostJournalEntryResult`
- `reconciliation_input: ReconcileJournalPostInput`
- `reconciliation_result: ReconcileJournalPostResult`

#### Methods

##### `lightbulb.finance_adjusting_entries_package.AdjustmentJournalPostingEvidence.evidence_digest`



~~~python
def evidence_digest() -> str
~~~


Source: `lightbulb/finance_adjusting_entries_package.py:248`.

### `lightbulb.finance_adjusting_entries_package.AdjustmentJournalEvidenceBinding`

class. Source: `lightbulb/finance_adjusting_entries_package.py:252`.

Fields:
- `schema_id: Literal['lightbulb.finance_adjustment_journal_evidence_binding.v1'] = Field(default=ADJUSTMENT_JOURNAL_EVIDENCE_BINDING_SCHEMA, alias='schema')`
- `journal_entry_ref: OpaqueRef`
- `journal_evidence_digest: Sha256Digest`
- `journal_evidence: AdjustmentJournalPostingEvidence`

### `lightbulb.finance_adjusting_entries_package.PrepareAdjustingEntriesPackageInput`

class. Source: `lightbulb/finance_adjusting_entries_package.py:305`.

Fields:
- `schema_id: Literal['lightbulb.finance_adjusting_entries_package_candidate_input.v2'] = Field(default=ADJUSTING_ENTRIES_PACKAGE_CANDIDATE_INPUT_SCHEMA, alias='schema')`
- `workspace: FinanceCloseWorkspace`
- `lifecycle_snapshot: PeriodCloseLifecycleSnapshot`
- `adjustment_batch_ref: OpaqueRef`
- `evidence_use_refs: tuple[OpaqueRef, OpaqueRef]`
- `no_adjustments_required: bool`
- `journals: tuple[AdjustmentJournalPostingEvidence, ...] = Field(default_factory=tuple, max_length=500)`
- `reported_posted_at: str`
- `prepared_by_ref: OpaqueRef`
- `posted_by_ref: OpaqueRef`
- `reviewed_by_ref: OpaqueRef`

### `lightbulb.finance_adjusting_entries_package.AdjustingEntriesPackageCandidateResult`

class. Source: `lightbulb/finance_adjusting_entries_package.py:504`.

Fields:
- `schema_id: Literal['lightbulb.finance_adjusting_entries_package_candidate_result.v2'] = Field(default=ADJUSTING_ENTRIES_PACKAGE_CANDIDATE_RESULT_SCHEMA, alias='schema')`
- `workspace_ref: OpaqueRef`
- `workspace_revision: int = Field(ge=1)`
- `workspace_digest: Sha256Digest`
- `lifecycle_version: Literal[3] = 3`
- `lifecycle_state_digest: Sha256Digest`
- `reconciliation_transition_digest: Sha256Digest`
- `package: AdjustingEntriesPackage`
- `package_digest: Sha256Digest`
- `journal_evidence_bindings: tuple[AdjustmentJournalEvidenceBinding, ...] = Field(max_length=500)`
- `candidate_digest: Sha256Digest = _ZERO_DIGEST`
- `journal_post_state: Literal['spring_settlement_required', 'not_applicable']`
- `actor_identity_state: Literal['spring_revalidation_required'] = 'spring_revalidation_required'`
- `evidence_custody_state: Literal['spring_retention_required'] = 'spring_retention_required'`
- `adjusting_entries_package_authority: Literal[False] = False`
- `lifecycle_transition_authority: Literal[False] = False`
- `persistence_authorized: Literal[False] = False`

#### Methods

##### `lightbulb.finance_adjusting_entries_package.AdjustingEntriesPackageCandidateResult.digest_payload`



~~~python
def digest_payload() -> dict[str, Any]
~~~


Source: `lightbulb/finance_adjusting_entries_package.py:536`.

### `lightbulb.finance_adjusting_entries_package.prepare_adjusting_entries_package`

function. Source: `lightbulb/finance_adjusting_entries_package.py:577`.



~~~python
prepare_adjusting_entries_package(inputs: PrepareAdjustingEntriesPackageInput) -> AdjustingEntriesPackageCandidateResult
~~~


### `lightbulb.finance_adjusting_entries_package.PrepareAdjustingEntriesPackagePrimitive`

class. Source: `lightbulb/finance_adjusting_entries_package.py:662`.

#### Methods

##### `lightbulb.finance_adjusting_entries_package.PrepareAdjustingEntriesPackagePrimitive.implementation_contract`



~~~python
def implementation_contract() -> dict[str, Any]
~~~


Source: `lightbulb/finance_adjusting_entries_package.py:687`.

## Module `lightbulb.finance_adjusting_entries_transition`

Prepare an evidence-bound ``record_adjusting_entries`` transition command.

### `lightbulb.finance_adjusting_entries_transition.AdjustingEntriesArtifactEvidenceClaim`

class. Source: `lightbulb/finance_adjusting_entries_transition.py:121`.

Fields:
- `use_ref: OpaqueRef`
- `artifact_ref: OpaqueRef`
- `artifact_digest: Sha256Digest`
- `evidence_ref: OpaqueRef`
- `kind: Literal['adjusting_entry_batch'] = _ARTIFACT_KIND`
- `issuer_ref: OpaqueRef`
- `observed_at: str`
- `effective_at: str`
- `retained_until: str`
- `verification_grade: Literal['attested', 'verified'] = 'attested'`
- `classification: Literal['internal', 'confidential', 'restricted'] = 'restricted'`

### `lightbulb.finance_adjusting_entries_transition.AdjustmentPostingReviewEvidenceClaim`

class. Source: `lightbulb/finance_adjusting_entries_transition.py:140`.

Fields:
- `use_ref: OpaqueRef`
- `artifact_ref: OpaqueRef`
- `artifact_digest: Sha256Digest`
- `evidence_ref: OpaqueRef`
- `kind: Literal['adjustment_posting_attestation'] = _REVIEW_KIND`
- `issuer_ref: OpaqueRef`
- `observed_at: str`
- `effective_at: str`
- `retained_until: str`
- `verification_grade: Literal['verified'] = 'verified'`
- `classification: Literal['internal', 'confidential', 'restricted'] = 'restricted'`

### `lightbulb.finance_adjusting_entries_transition.PrepareAdjustingEntriesTransitionCommandInput`

class. Source: `lightbulb/finance_adjusting_entries_transition.py:159`.

Fields:
- `schema_id: Literal['lightbulb.finance_adjusting_entries_transition_command_input.v2'] = Field(default=ADJUSTING_ENTRIES_TRANSITION_COMMAND_INPUT_SCHEMA, alias='schema')`
- `workspace: FinanceCloseWorkspace`
- `package_candidate: AdjustingEntriesPackageCandidateResult`
- `lifecycle_snapshot: PeriodCloseLifecycleSnapshot`
- `transition_ref: OpaqueRef`
- `idempotency_key: OpaqueRef`
- `occurred_at: str`
- `requested_by_ref: OpaqueRef`
- `artifact_evidence: AdjustingEntriesArtifactEvidenceClaim`
- `review_evidence: AdjustmentPostingReviewEvidenceClaim`

### `lightbulb.finance_adjusting_entries_transition.AdjustingEntriesTransitionCommandResult`

class. Source: `lightbulb/finance_adjusting_entries_transition.py:269`.

Fields:
- `schema_id: Literal['lightbulb.finance_adjusting_entries_transition_command_result.v2'] = Field(default=ADJUSTING_ENTRIES_TRANSITION_COMMAND_RESULT_SCHEMA, alias='schema')`
- `workspace_ref: OpaqueRef`
- `workspace_revision: int = Field(ge=1)`
- `workspace_digest: Sha256Digest`
- `package_candidate_digest: Sha256Digest`
- `lifecycle_version: Literal[3] = 3`
- `lifecycle_state_digest: Sha256Digest`
- `lifecycle_input: PeriodCloseLifecycleInput`
- `command_content_digest: Sha256Digest`
- `command_request_digest: Sha256Digest`
- `evidence_lineage_tail_digest: Sha256Digest`
- `result_digest: Sha256Digest = _ZERO_DIGEST`
- `journal_post_settlement_state: Literal['spring_revalidation_required', 'not_applicable']`
- `evidence_authentication_state: Literal['spring_revalidation_required'] = 'spring_revalidation_required'`
- `evidence_custody_state: Literal['spring_retention_required'] = 'spring_retention_required'`
- `lifecycle_transition_authority: Literal[False] = False`
- `persistence_authorized: Literal[False] = False`
- `provider_calls_authorized: Literal[False] = False`

#### Methods

##### `lightbulb.finance_adjusting_entries_transition.AdjustingEntriesTransitionCommandResult.digest_payload`



~~~python
def digest_payload() -> dict[str, Any]
~~~


Source: `lightbulb/finance_adjusting_entries_transition.py:299`.

### `lightbulb.finance_adjusting_entries_transition.prepare_adjusting_entries_transition_command`

function. Source: `lightbulb/finance_adjusting_entries_transition.py:369`.



~~~python
prepare_adjusting_entries_transition_command(inputs: PrepareAdjustingEntriesTransitionCommandInput) -> AdjustingEntriesTransitionCommandResult
~~~


### `lightbulb.finance_adjusting_entries_transition.PrepareAdjustingEntriesTransitionCommandPrimitive`

class. Source: `lightbulb/finance_adjusting_entries_transition.py:473`.

#### Methods

##### `lightbulb.finance_adjusting_entries_transition.PrepareAdjustingEntriesTransitionCommandPrimitive.implementation_contract`



~~~python
def implementation_contract() -> dict[str, Any]
~~~


Source: `lightbulb/finance_adjusting_entries_transition.py:499`.

## Module `lightbulb.finance_close_approval_package`

Prepare an independently reviewed period-close approval package candidate.

### `lightbulb.finance_close_approval_package.close_approval_request_digest`

function. Source: `lightbulb/finance_close_approval_package.py:145`.



~~~python
close_approval_request_digest(*, workspace: FinanceCloseWorkspace, lifecycle_snapshot: PeriodCloseLifecycleSnapshot, consolidation_transition_digest: str, approval_candidate_ref: str, review_workpaper_ref: str, review_workpaper_digest: str, review_prepared_by_ref: str, independent_approver_ref: str, approval_policy_ref: str) -> str
~~~


### `lightbulb.finance_close_approval_package.CloseApprovalObservation`

class. Source: `lightbulb/finance_close_approval_package.py:177`.

Fields:
- `schema_id: Literal['lightbulb.finance_close_approval_observation.v1'] = Field(default=CLOSE_APPROVAL_OBSERVATION_SCHEMA, alias='schema')`
- `approval_candidate_ref: OpaqueRef`
- `approval_decision_ref: OpaqueRef`
- `approval_policy_ref: OpaqueRef`
- `reviewer_qualification_ref: OpaqueRef`
- `issuer_ref: OpaqueRef`
- `scope_digest: Sha256Digest`
- `lifecycle_state_digest: Sha256Digest`
- `consolidation_transition_digest: Sha256Digest`
- `approval_request_digest: Sha256Digest`
- `decision: Literal['reported_approved'] = 'reported_approved'`
- `unresolved_material_exception_count: Literal[0] = 0`
- `decided_at: str`
- `expires_at: str`
- `independent_approver_ref: OpaqueRef`

#### Methods

##### `lightbulb.finance_close_approval_package.CloseApprovalObservation.evidence_digest`



~~~python
def evidence_digest() -> str
~~~


Source: `lightbulb/finance_close_approval_package.py:208`.

### `lightbulb.finance_close_approval_package.PrepareCloseApprovalPackageInput`

class. Source: `lightbulb/finance_close_approval_package.py:212`.

Fields:
- `schema_id: Literal['lightbulb.finance_close_approval_package_candidate_input.v1'] = Field(default=CLOSE_APPROVAL_PACKAGE_CANDIDATE_INPUT_SCHEMA, alias='schema')`
- `workspace: FinanceCloseWorkspace`
- `lifecycle_snapshot: PeriodCloseLifecycleSnapshot`
- `review_workpaper_ref: OpaqueRef`
- `review_workpaper_digest: Sha256Digest`
- `evidence_use_refs: tuple[OpaqueRef, OpaqueRef]`
- `review_prepared_by_ref: OpaqueRef`
- `approval_observation: CloseApprovalObservation`
- `prepared_at: str`

### `lightbulb.finance_close_approval_package.CloseApprovalPackageCandidateResult`

class. Source: `lightbulb/finance_close_approval_package.py:322`.

Fields:
- `schema_id: Literal['lightbulb.finance_close_approval_package_candidate_result.v1'] = Field(default=CLOSE_APPROVAL_PACKAGE_CANDIDATE_RESULT_SCHEMA, alias='schema')`
- `workspace_ref: OpaqueRef`
- `workspace_revision: int = Field(ge=1)`
- `workspace_digest: Sha256Digest`
- `lifecycle_version: Literal[6] = 6`
- `lifecycle_state_digest: Sha256Digest`
- `consolidation_transition_digest: Sha256Digest`
- `approval_request_digest: Sha256Digest`
- `prepared_at: str`
- `package: CloseApprovalPackage`
- `package_digest: Sha256Digest`
- `review_workpaper_digest: Sha256Digest`
- `approval_observation_digest: Sha256Digest`
- `candidate_digest: Sha256Digest = _ZERO_DIGEST`
- `approval_authentication_state: Literal['spring_revalidation_required'] = 'spring_revalidation_required'`
- `reviewer_qualification_state: Literal['spring_revalidation_required'] = 'spring_revalidation_required'`
- `approval_consumption_state: Literal['spring_consumption_required'] = 'spring_consumption_required'`
- `evidence_custody_state: Literal['spring_retention_required'] = 'spring_retention_required'`
- `close_approval_package_authority: Literal[False] = False`
- `lifecycle_transition_authority: Literal[False] = False`
- `persistence_authorized: Literal[False] = False`

#### Methods

##### `lightbulb.finance_close_approval_package.CloseApprovalPackageCandidateResult.digest_payload`



~~~python
def digest_payload() -> dict[str, Any]
~~~


Source: `lightbulb/finance_close_approval_package.py:360`.

### `lightbulb.finance_close_approval_package.prepare_close_approval_package`

function. Source: `lightbulb/finance_close_approval_package.py:381`.



~~~python
prepare_close_approval_package(inputs: PrepareCloseApprovalPackageInput) -> CloseApprovalPackageCandidateResult
~~~


### `lightbulb.finance_close_approval_package.PrepareCloseApprovalPackagePrimitive`

class. Source: `lightbulb/finance_close_approval_package.py:494`.

#### Methods

##### `lightbulb.finance_close_approval_package.PrepareCloseApprovalPackagePrimitive.implementation_contract`



~~~python
def implementation_contract() -> dict[str, Any]
~~~


Source: `lightbulb/finance_close_approval_package.py:519`.

## Module `lightbulb.finance_close_approval_transition`

Prepare an evidence-bound ``approve_close`` transition command.

### `lightbulb.finance_close_approval_transition.CloseReviewWorkpaperEvidenceClaim`

class. Source: `lightbulb/finance_close_approval_transition.py:127`.

Fields:
- `use_ref: OpaqueRef`
- `artifact_ref: OpaqueRef`
- `artifact_digest: Sha256Digest`
- `evidence_ref: OpaqueRef`
- `kind: Literal['close_review_workpaper'] = _ARTIFACT_KIND`
- `issuer_ref: OpaqueRef`
- `observed_at: str`
- `effective_at: str`
- `retained_until: str`
- `verification_grade: Literal['attested', 'verified'] = 'attested'`
- `classification: Literal['internal', 'confidential', 'restricted'] = 'restricted'`

### `lightbulb.finance_close_approval_transition.SpringCloseApprovalEvidenceClaim`

class. Source: `lightbulb/finance_close_approval_transition.py:146`.

Fields:
- `use_ref: OpaqueRef`
- `artifact_ref: OpaqueRef`
- `artifact_digest: Sha256Digest`
- `evidence_ref: OpaqueRef`
- `kind: Literal['spring_close_approval_attestation'] = _APPROVAL_KIND`
- `issuer_ref: OpaqueRef`
- `observed_at: str`
- `effective_at: str`
- `retained_until: str`
- `verification_grade: Literal['verified'] = 'verified'`
- `classification: Literal['internal', 'confidential', 'restricted'] = 'restricted'`
- `approval_observation: CloseApprovalObservation`

### `lightbulb.finance_close_approval_transition.PrepareCloseApprovalTransitionCommandInput`

class. Source: `lightbulb/finance_close_approval_transition.py:190`.

Fields:
- `schema_id: Literal['lightbulb.finance_close_approval_transition_command_input.v1'] = Field(default=CLOSE_APPROVAL_TRANSITION_COMMAND_INPUT_SCHEMA, alias='schema')`
- `workspace: FinanceCloseWorkspace`
- `package_candidate: CloseApprovalPackageCandidateResult`
- `lifecycle_snapshot: PeriodCloseLifecycleSnapshot`
- `transition_ref: OpaqueRef`
- `idempotency_key: OpaqueRef`
- `occurred_at: str`
- `requested_by_ref: OpaqueRef`
- `workpaper_evidence: CloseReviewWorkpaperEvidenceClaim`
- `approval_evidence: SpringCloseApprovalEvidenceClaim`

### `lightbulb.finance_close_approval_transition.CloseApprovalTransitionCommandResult`

class. Source: `lightbulb/finance_close_approval_transition.py:346`.

Fields:
- `schema_id: Literal['lightbulb.finance_close_approval_transition_command_result.v1'] = Field(default=CLOSE_APPROVAL_TRANSITION_COMMAND_RESULT_SCHEMA, alias='schema')`
- `workspace_ref: OpaqueRef`
- `workspace_revision: int = Field(ge=1)`
- `workspace_digest: Sha256Digest`
- `package_candidate_digest: Sha256Digest`
- `lifecycle_version: Literal[6] = 6`
- `lifecycle_state_digest: Sha256Digest`
- `approval_candidate_ref: OpaqueRef`
- `approval_request_digest: Sha256Digest`
- `approval_observation_digest: Sha256Digest`
- `approval_expires_at: str`
- `lifecycle_input: PeriodCloseLifecycleInput`
- `command_content_digest: Sha256Digest`
- `command_request_digest: Sha256Digest`
- `evidence_lineage_tail_digest: Sha256Digest`
- `result_digest: Sha256Digest = _ZERO_DIGEST`
- `approval_authentication_state: Literal['spring_revalidation_required'] = 'spring_revalidation_required'`
- `reviewer_qualification_state: Literal['spring_revalidation_required'] = 'spring_revalidation_required'`
- `approval_consumption_state: Literal['spring_consumption_required'] = 'spring_consumption_required'`
- `evidence_authentication_state: Literal['spring_revalidation_required'] = 'spring_revalidation_required'`
- `evidence_custody_state: Literal['spring_retention_required'] = 'spring_retention_required'`
- `lifecycle_transition_authority: Literal[False] = False`
- `persistence_authorized: Literal[False] = False`
- `period_close_authorized: Literal[False] = False`
- `connector_calls_authorized: Literal[False] = False`

#### Methods

##### `lightbulb.finance_close_approval_transition.CloseApprovalTransitionCommandResult.digest_payload`



~~~python
def digest_payload() -> dict[str, Any]
~~~


Source: `lightbulb/finance_close_approval_transition.py:390`.

### `lightbulb.finance_close_approval_transition.prepare_close_approval_transition_command`

function. Source: `lightbulb/finance_close_approval_transition.py:465`.



~~~python
prepare_close_approval_transition_command(inputs: PrepareCloseApprovalTransitionCommandInput) -> CloseApprovalTransitionCommandResult
~~~


### `lightbulb.finance_close_approval_transition.PrepareCloseApprovalTransitionCommandPrimitive`

class. Source: `lightbulb/finance_close_approval_transition.py:564`.

#### Methods

##### `lightbulb.finance_close_approval_transition.PrepareCloseApprovalTransitionCommandPrimitive.implementation_contract`



~~~python
def implementation_contract() -> dict[str, Any]
~~~


Source: `lightbulb/finance_close_approval_transition.py:589`.

## Module `lightbulb.finance_close_audit_packet`

Build a finance-close audit packet candidate with outcome evidence.

### `lightbulb.finance_close_audit_packet.FinanceCloseExecutionObservation`

class. Source: `lightbulb/finance_close_audit_packet.py:175`.

Fields:
- `schema_id: Literal['lightbulb.finance_close_execution_observation.v1'] = Field(default=FINANCE_CLOSE_EXECUTION_OBSERVATION_SCHEMA, alias='schema')`
- `issuer_ref: OpaqueRef`
- `environment_ref: OpaqueRef`
- `environment_class: Literal['test', 'canary', 'production']`
- `workspace_digest: Sha256Digest`
- `scope_digest: Sha256Digest`
- `lifecycle_version: Literal[8] = 8`
- `lifecycle_state_digest: Sha256Digest`
- `close_candidate_ref: OpaqueRef`
- `command_request_digest: Sha256Digest`
- `hosted_execution_ref: OpaqueRef`
- `execution_receipt_ref: OpaqueRef`
- `execution_receipt_digest: Sha256Digest`
- `persistence_receipt_ref: OpaqueRef`
- `persistence_receipt_digest: Sha256Digest`
- `period_state_ref: OpaqueRef`
- `period_state_digest: Sha256Digest`
- `readback_observation_ref: OpaqueRef`
- `readback_observation_digest: Sha256Digest`
- `execution_state: Literal['reported_applied'] = 'reported_applied'`
- `persistence_state: Literal['reported_committed'] = 'reported_committed'`
- `period_state: Literal['reported_closed'] = 'reported_closed'`
- `independent_readback_verified: Literal[True] = True`
- `ambiguity_state: Literal['none'] = 'none'`
- `duplicate_external_effect_count: Literal[0] = 0`
- `closed_through_at: str`
- `executed_at: str`
- `observed_at: str`
- `production_certified: Literal[False] = False`

#### Methods

##### `lightbulb.finance_close_audit_packet.FinanceCloseExecutionObservation.evidence_digest`



~~~python
def evidence_digest() -> str
~~~


Source: `lightbulb/finance_close_audit_packet.py:220`.

### `lightbulb.finance_close_audit_packet.FinanceCloseAuditPacketInput`

class. Source: `lightbulb/finance_close_audit_packet.py:224`.

Fields:
- `schema_id: Literal['lightbulb.finance_close_audit_packet_input.v1'] = Field(default=FINANCE_CLOSE_AUDIT_PACKET_INPUT_SCHEMA, alias='schema')`
- `packet_ref: OpaqueRef`
- `workspace: FinanceCloseWorkspace`
- `final_transition: ClosePeriodTransitionCommandResult`
- `lifecycle_snapshot: PeriodCloseLifecycleSnapshot`
- `execution_observation: FinanceCloseExecutionObservation`
- `business_outcomes: tuple[BusinessOutcomeMeasurement, ...] = Field(min_length=len(_OUTCOME_CONTRACT), max_length=len(_OUTCOME_CONTRACT))`
- `prepared_by_ref: OpaqueRef`
- `prepared_at: str`

### `lightbulb.finance_close_audit_packet.FinanceCloseTransitionAuditRecord`

class. Source: `lightbulb/finance_close_audit_packet.py:387`.

Fields:
- `sequence: int = Field(ge=1, le=8)`
- `kind: OpaqueRef`
- `transition_ref: OpaqueRef`
- `occurred_at: str`
- `requested_by_ref: OpaqueRef`
- `command_request_digest: Sha256Digest`
- `command_content_digest: Sha256Digest`
- `evidence_digest: Sha256Digest`
- `transition_digest: Sha256Digest`

### `lightbulb.finance_close_audit_packet.FinanceCloseOutcomeSummary`

class. Source: `lightbulb/finance_close_audit_packet.py:404`.

Fields:
- `outcome_ref: OpaqueRef`
- `metric_name: OpaqueRef`
- `baseline: Decimal`
- `observed: Decimal`
- `target: Decimal`
- `target_met: bool`
- `improved_from_baseline: bool`
- `measurement_digest: Sha256Digest`

### `lightbulb.finance_close_audit_packet.FinanceCloseAuditPacketResult`

class. Source: `lightbulb/finance_close_audit_packet.py:428`.

Fields:
- `schema_id: Literal['lightbulb.finance_close_audit_packet_result.v1'] = Field(default=FINANCE_CLOSE_AUDIT_PACKET_RESULT_SCHEMA, alias='schema')`
- `packet_ref: OpaqueRef`
- `workspace_ref: OpaqueRef`
- `workspace_revision: int = Field(ge=1)`
- `workspace_digest: Sha256Digest`
- `lifecycle_version: Literal[8] = 8`
- `lifecycle_state_digest: Sha256Digest`
- `final_command_request_digest: Sha256Digest`
- `execution_observation_digest: Sha256Digest`
- `transition_records: tuple[FinanceCloseTransitionAuditRecord, ...] = Field(min_length=8, max_length=8)`
- `outcome_summaries: tuple[FinanceCloseOutcomeSummary, ...] = Field(min_length=len(_OUTCOME_CONTRACT), max_length=len(_OUTCOME_CONTRACT))`
- `prepared_by_ref: OpaqueRef`
- `prepared_at: str`
- `transition_evidence_digest: Sha256Digest`
- `business_outcome_digest: Sha256Digest`
- `packet_digest: Sha256Digest = _ZERO_DIGEST`
- `execution_authentication_state: Literal['spring_revalidation_required'] = 'spring_revalidation_required'`
- `business_outcome_authentication_state: Literal['spring_revalidation_required'] = 'spring_revalidation_required'`
- `audit_custody_state: Literal['spring_retention_required'] = 'spring_retention_required'`
- `structural_close_lifecycle_complete: Literal[True] = True`
- `hosted_execution_reported: Literal[True] = True`
- `production_certified: Literal[False] = False`
- `period_close_authorized: Literal[False] = False`
- `persistence_authorized: Literal[False] = False`
- `connector_calls_authorized: Literal[False] = False`

#### Methods

##### `lightbulb.finance_close_audit_packet.FinanceCloseAuditPacketResult.digest_payload`



~~~python
def digest_payload() -> dict[str, Any]
~~~


Source: `lightbulb/finance_close_audit_packet.py:479`.

### `lightbulb.finance_close_audit_packet.build_finance_close_audit_packet`

function. Source: `lightbulb/finance_close_audit_packet.py:537`.



~~~python
build_finance_close_audit_packet(inputs: FinanceCloseAuditPacketInput) -> FinanceCloseAuditPacketResult
~~~


### `lightbulb.finance_close_audit_packet.BuildFinanceCloseAuditPacketPrimitive`

class. Source: `lightbulb/finance_close_audit_packet.py:679`.

#### Methods

##### `lightbulb.finance_close_audit_packet.BuildFinanceCloseAuditPacketPrimitive.implementation_contract`



~~~python
def implementation_contract() -> dict[str, Any]
~~~


Source: `lightbulb/finance_close_audit_packet.py:704`.

## Module `lightbulb.finance_close_evidence_bundle`

Sealed provider evidence for the initial monthly-close lighthouse.

### `lightbulb.finance_close_evidence_bundle.FinanceCloseEvidenceBundleInput`

class. Source: `lightbulb/finance_close_evidence_bundle.py:145`.

Fields:
- `schema_id: Literal['lightbulb.finance_close_evidence_bundle_input.v2'] = Field(default=FINANCE_CLOSE_EVIDENCE_BUNDLE_INPUT_SCHEMA, alias='schema')`
- `bundle_ref: OpaqueRef`
- `bundle_revision: PositiveRevision`
- `prepared_at: str`
- `ledger_materialization: LedgerSnapshotMaterializationResult`
- `close_source_transactions: CloseSourceTransactionEvidence`
- `stripe_settlement_observation: StripeSettlementObservationResult`
- `provider_period_status: ProviderPeriodStatusResult`

#### Methods

##### `lightbulb.finance_close_evidence_bundle.FinanceCloseEvidenceBundleInput.ledger_snapshot`



~~~python
@property
def ledger_snapshot() -> CanonicalLedgerSnapshot
~~~


Source: `lightbulb/finance_close_evidence_bundle.py:159`.

### `lightbulb.finance_close_evidence_bundle.FinanceCloseEvidenceBundle`

class. Source: `lightbulb/finance_close_evidence_bundle.py:288`.

Fields:
- `schema_id: Literal['lightbulb.finance_close_evidence_bundle.v2'] = Field(default=FINANCE_CLOSE_EVIDENCE_BUNDLE_SCHEMA, alias='schema')`
- `bundle_ref: OpaqueRef`
- `bundle_revision: PositiveRevision`
- `prepared_at: str`
- `tenant_ref: OpaqueRef`
- `company_ref: OpaqueRef`
- `project_ref: OpaqueRef`
- `project_id: UUID`
- `legal_entity_ref: OpaqueRef`
- `ledger_ref: OpaqueRef`
- `fiscal_period_ref: OpaqueRef`
- `start_date: str`
- `end_date: str`
- `currency: str = Field(pattern='^[A-Z]{3}$')`
- `accounting_provider: Literal['quickbooks', 'xero']`
- `accounting_tenant_connector_ref: OpaqueRef`
- `accounting_tenant_connector_id: UUID`
- `accounting_connector_account_ref: OpaqueRef`
- `accounting_provider_account_ref: OpaqueRef`
- `stripe_tenant_connector_id: UUID`
- `stripe_connector_account_ref: OpaqueRef`
- `ledger_snapshot_ref: OpaqueRef`
- `ledger_snapshot_revision: PositiveRevision`
- `ledger_snapshot_artifact_digest: Sha256Digest`
- `ledger_source_read_binding_digest: Sha256Digest`
- `close_source_digest: Sha256Digest`
- `stripe_settlement_digest: Sha256Digest`
- `provider_period_status_digest: Sha256Digest`
- `provider_period_relation: Literal['no_provider_lock_configured', 'fully_at_or_before_provider_lock', 'overlaps_provider_lock_boundary', 'after_provider_locks']`
- `readiness: CloseEvidenceReadiness`
- `control_code: CloseEvidenceControlCode | None = None`
- `source_facts_complete: Literal[True] = True`
- `workspace_eligible: bool`
- `close_transition_authority: Literal[False] = False`
- `content_digest: Sha256Digest = _ZERO_DIGEST`

#### Methods

##### `lightbulb.finance_close_evidence_bundle.FinanceCloseEvidenceBundle.content_digest_payload`



~~~python
def content_digest_payload() -> dict[str, Any]
~~~


Source: `lightbulb/finance_close_evidence_bundle.py:338`.

### `lightbulb.finance_close_evidence_bundle.FinanceCloseEvidenceBundleResult`

class. Source: `lightbulb/finance_close_evidence_bundle.py:375`.

Fields:
- `schema_id: Literal['lightbulb.finance_close_evidence_bundle_result.v2'] = Field(default=FINANCE_CLOSE_EVIDENCE_BUNDLE_RESULT_SCHEMA, alias='schema')`
- `bundle: FinanceCloseEvidenceBundle`
- `connector_operation_performed: Literal[False] = False`
- `persistence_authorized: Literal[False] = False`
- `close_transition_authorized: Literal[False] = False`

### `lightbulb.finance_close_evidence_bundle.prepare_close_evidence_bundle`

function. Source: `lightbulb/finance_close_evidence_bundle.py:396`.



~~~python
prepare_close_evidence_bundle(inputs: FinanceCloseEvidenceBundleInput) -> FinanceCloseEvidenceBundleResult
~~~


### `lightbulb.finance_close_evidence_bundle.PrepareCloseEvidenceBundlePrimitive`

class. Source: `lightbulb/finance_close_evidence_bundle.py:541`.

#### Methods

##### `lightbulb.finance_close_evidence_bundle.PrepareCloseEvidenceBundlePrimitive.implementation_contract`



~~~python
def implementation_contract() -> dict[str, Any]
~~~


Source: `lightbulb/finance_close_evidence_bundle.py:566`.

## Module `lightbulb.finance_close_lifecycle`

Deterministic, evidence-bound finance period-close proposal lifecycle.

### `lightbulb.finance_close_lifecycle.SubledgerScopeBinding`

class. Source: `lightbulb/finance_close_lifecycle.py:277`.

Fields:
- `subledger_ref: OpaqueRef`
- `control_account_ref: OpaqueRef`

### `lightbulb.finance_close_lifecycle.PeriodCloseScope`

class. Source: `lightbulb/finance_close_lifecycle.py:282`.

Fields:
- `tenant_ref: OpaqueRef`
- `company_ref: OpaqueRef`
- `project_ref: OpaqueRef`
- `project_id: UUID`
- `scope_kind: Literal['entity', 'consolidation_group']`
- `entity_refs: tuple[OpaqueRef, ...] = Field(min_length=1, max_length=100)`
- `consolidation_group_ref: OpaqueRef | None = None`
- `ledger_ref: OpaqueRef`
- `functional_currency: CurrencyCode`
- `fiscal_period_ref: OpaqueRef`
- `period_started_at: str`
- `period_ended_at: str`
- `jurisdiction_ref: OpaqueRef`
- `financial_retention_policy_ref: OpaqueRef`
- `evidence_retention_until: str`
- `materiality_threshold: Money`
- `required_subledgers: tuple[SubledgerScopeBinding, ...] = Field(min_length=1, max_length=100)`
- `evidence_custody_ref: OpaqueRef`
- `spring_authority_ref: OpaqueRef`
- `authorized_evidence_issuer_refs: tuple[OpaqueRef, ...] = Field(min_length=2, max_length=100)`

### `lightbulb.finance_close_lifecycle.period_close_scope_digest`

function. Source: `lightbulb/finance_close_lifecycle.py:383`.



~~~python
period_close_scope_digest(scope: PeriodCloseScope | Mapping[str, Any]) -> str
~~~


### `lightbulb.finance_close_lifecycle.CloseEvidenceEnvelope`

class. Source: `lightbulb/finance_close_lifecycle.py:388`.

Fields:
- `schema_id: Literal['lightbulb.finance_close_evidence_envelope.v1'] = Field(default='lightbulb.finance_close_evidence_envelope.v1', alias='schema')`
- `sequence: int = Field(ge=1, le=20)`
- `use_ref: OpaqueRef`
- `artifact_ref: OpaqueRef`
- `artifact_digest: Sha256Digest`
- `predecessor_lineage_digest: Sha256Digest`
- `lineage_digest: Sha256Digest`
- `custody_ref: OpaqueRef`
- `retained_until: str`
- `single_use: StrictTrue = True`
- `reference: PrimitiveEvidenceRef`

### `lightbulb.finance_close_lifecycle.OpenPeriodPackage`

class. Source: `lightbulb/finance_close_lifecycle.py:432`.

Fields:
- `kind: Literal['open_period'] = 'open_period'`
- `period_open_candidate_ref: OpaqueRef`
- `prior_period_state: Literal['closed', 'not_applicable']`
- `opened_at: str`
- `opened_by_ref: OpaqueRef`
- `reviewed_by_ref: OpaqueRef`

### `lightbulb.finance_close_lifecycle.TrialBalanceLine`

class. Source: `lightbulb/finance_close_lifecycle.py:455`.

Fields:
- `account_ref: OpaqueRef`
- `account_class: Literal['asset', 'liability', 'equity', 'revenue', 'expense']`
- `debit: Money`
- `credit: Money`

### `lightbulb.finance_close_lifecycle.TrialBalancePackage`

class. Source: `lightbulb/finance_close_lifecycle.py:472`.

Fields:
- `kind: Literal['capture_trial_balance'] = 'capture_trial_balance'`
- `trial_balance_ref: OpaqueRef`
- `as_of: str`
- `currency: CurrencyCode`
- `lines: tuple[TrialBalanceLine, ...] = Field(min_length=2, max_length=5000)`
- `total_debit: Money`
- `total_credit: Money`
- `prepared_by_ref: OpaqueRef`
- `reviewed_by_ref: OpaqueRef`

### `lightbulb.finance_close_lifecycle.AccountReconciliationRecord`

class. Source: `lightbulb/finance_close_lifecycle.py:518`.

Fields:
- `account_ref: OpaqueRef`
- `reconciliation_ref: OpaqueRef`
- `ledger_balance: Money`
- `source_balance: Money`
- `reconciling_items_total: Money`
- `unexplained_variance: Money`
- `materiality_threshold: Money`
- `status: Literal['reconciled'] = 'reconciled'`
- `prepared_by_ref: OpaqueRef`
- `reviewed_by_ref: OpaqueRef`

### `lightbulb.finance_close_lifecycle.SubledgerReconciliationRecord`

class. Source: `lightbulb/finance_close_lifecycle.py:550`.

Fields:
- `subledger_ref: OpaqueRef`
- `control_account_ref: OpaqueRef`
- `reconciliation_ref: OpaqueRef`
- `subledger_balance: Money`
- `general_ledger_balance: Money`
- `reconciling_items_total: Money`
- `unexplained_variance: Money`
- `materiality_threshold: Money`
- `status: Literal['reconciled'] = 'reconciled'`
- `prepared_by_ref: OpaqueRef`
- `reviewed_by_ref: OpaqueRef`

### `lightbulb.finance_close_lifecycle.ReconciliationPackage`

class. Source: `lightbulb/finance_close_lifecycle.py:587`.

Fields:
- `kind: Literal['reconcile_accounts'] = 'reconcile_accounts'`
- `reconciliation_set_ref: OpaqueRef`
- `trial_balance_transition_digest: Sha256Digest`
- `account_reconciliations: tuple[AccountReconciliationRecord, ...] = Field(min_length=2, max_length=5000)`
- `subledger_reconciliations: tuple[SubledgerReconciliationRecord, ...] = Field(min_length=1, max_length=100)`
- `aggregate_unexplained_variance: Money`
- `review_completed_at: str`

### `lightbulb.finance_close_lifecycle.JournalEntryLine`

class. Source: `lightbulb/finance_close_lifecycle.py:657`.

Fields:
- `line_ref: OpaqueRef`
- `account_ref: OpaqueRef`
- `debit: Money`
- `credit: Money`

### `lightbulb.finance_close_lifecycle.AdjustingJournalEntry`

class. Source: `lightbulb/finance_close_lifecycle.py:672`.

Fields:
- `journal_entry_ref: OpaqueRef`
- `currency: CurrencyCode`
- `effective_at: str`
- `lines: tuple[JournalEntryLine, ...] = Field(min_length=2, max_length=1000)`
- `total_debit: Money`
- `total_credit: Money`

### `lightbulb.finance_close_lifecycle.AdjustingEntriesPackage`

class. Source: `lightbulb/finance_close_lifecycle.py:710`.

Fields:
- `kind: Literal['record_adjusting_entries'] = 'record_adjusting_entries'`
- `adjustment_batch_ref: OpaqueRef`
- `trial_balance_transition_digest: Sha256Digest`
- `reconciliation_transition_digest: Sha256Digest`
- `no_adjustments_required: bool`
- `entries: tuple[AdjustingJournalEntry, ...] = Field(default_factory=tuple, max_length=500)`
- `batch_total_debit: Money`
- `batch_total_credit: Money`
- `posting_status: Literal['reported_posted', 'reported_not_required']`
- `reported_posted_at: str`
- `prepared_by_ref: OpaqueRef`
- `posted_by_ref: OpaqueRef`
- `reviewed_by_ref: OpaqueRef`

### `lightbulb.finance_close_lifecycle.SubledgerLockPackage`

class. Source: `lightbulb/finance_close_lifecycle.py:777`.

Fields:
- `kind: Literal['lock_subledgers'] = 'lock_subledgers'`
- `lock_set_ref: OpaqueRef`
- `reconciliation_transition_digest: Sha256Digest`
- `adjustment_transition_digest: Sha256Digest`
- `locked_subledger_refs: tuple[OpaqueRef, ...] = Field(min_length=1, max_length=100)`
- `lock_status: Literal['reported_locked'] = 'reported_locked'`
- `locked_at: str`
- `lock_owner_ref: OpaqueRef`
- `lock_reviewer_ref: OpaqueRef`

### `lightbulb.finance_close_lifecycle.EliminationEntry`

class. Source: `lightbulb/finance_close_lifecycle.py:808`.

Fields:
- `elimination_ref: OpaqueRef`
- `from_entity_ref: OpaqueRef`
- `to_entity_ref: OpaqueRef`
- `currency: CurrencyCode`
- `lines: tuple[JournalEntryLine, ...] = Field(min_length=2, max_length=1000)`
- `total_debit: Money`
- `total_credit: Money`

### `lightbulb.finance_close_lifecycle.ConsolidationPackage`

class. Source: `lightbulb/finance_close_lifecycle.py:844`.

Fields:
- `kind: Literal['consolidate'] = 'consolidate'`
- `consolidation_workpaper_ref: OpaqueRef`
- `adjustment_transition_digest: Sha256Digest`
- `lock_transition_digest: Sha256Digest`
- `entity_refs: tuple[OpaqueRef, ...] = Field(min_length=1, max_length=100)`
- `currency: CurrencyCode`
- `no_intercompany_activity: bool`
- `elimination_entries: tuple[EliminationEntry, ...] = Field(default_factory=tuple, max_length=1000)`
- `intercompany_input_balance: Money`
- `eliminated_amount: Money`
- `residual_balance: Money`
- `residual_materiality_threshold: Money`
- `consolidated_at: str`
- `consolidator_ref: OpaqueRef`
- `reviewed_by_ref: OpaqueRef`

### `lightbulb.finance_close_lifecycle.CloseApprovalPackage`

class. Source: `lightbulb/finance_close_lifecycle.py:940`.

Fields:
- `kind: Literal['approve_close'] = 'approve_close'`
- `approval_candidate_ref: OpaqueRef`
- `approval_decision_ref: OpaqueRef`
- `approval_policy_ref: OpaqueRef`
- `reviewer_qualification_ref: OpaqueRef`
- `approval_request_digest: Sha256Digest`
- `approval_observation_digest: Sha256Digest`
- `review_workpaper_ref: OpaqueRef`
- `review_workpaper_digest: Sha256Digest`
- `trial_balance_transition_digest: Sha256Digest`
- `reconciliation_transition_digest: Sha256Digest`
- `adjustment_transition_digest: Sha256Digest`
- `lock_transition_digest: Sha256Digest`
- `consolidation_transition_digest: Sha256Digest`
- `decision: Literal['host_reported_approved'] = 'host_reported_approved'`
- `unresolved_material_exception_count: StrictZero = 0`
- `approved_at: str`
- `approval_expires_at: str`
- `review_prepared_by_ref: OpaqueRef`
- `independent_approver_ref: OpaqueRef`

### `lightbulb.finance_close_lifecycle.ClosePeriodPackage`

class. Source: `lightbulb/finance_close_lifecycle.py:981`.

Fields:
- `kind: Literal['close_period'] = 'close_period'`
- `close_candidate_ref: OpaqueRef`
- `close_request_ref: OpaqueRef`
- `close_request_digest: Sha256Digest`
- `readiness_attestation_ref: OpaqueRef`
- `readiness_policy_ref: OpaqueRef`
- `readiness_evaluation_ref: OpaqueRef`
- `readiness_evaluation_digest: Sha256Digest`
- `readiness_evidence_digest: Sha256Digest`
- `readiness_observation_digest: Sha256Digest`
- `readiness_expires_at: str`
- `approval_candidate_ref: OpaqueRef`
- `approval_transition_digest: Sha256Digest`
- `closed_through_at: str`
- `close_requested_at: str`
- `close_operator_ref: OpaqueRef`
- `hosted_execution_route: Literal['spring_control_plane_required'] = 'spring_control_plane_required'`

### `lightbulb.finance_close_lifecycle.PeriodCloseTransitionCommand`

class. Source: `lightbulb/finance_close_lifecycle.py:1045`.

Fields:
- `schema_id: Literal['lightbulb.finance_period_close_command.v1'] = Field(default=PERIOD_CLOSE_COMMAND_SCHEMA, alias='schema')`
- `kind: TransitionKind`
- `scope: PeriodCloseScope`
- `transition_ref: OpaqueRef`
- `idempotency_key: OpaqueRef`
- `expected_version: int = Field(ge=0, le=MAX_PERIOD_CLOSE_TRANSITIONS)`
- `expected_state_digest: Sha256Digest`
- `expected_evidence_lineage_digest: Sha256Digest`
- `occurred_at: str`
- `host_outcome_report: Literal['reported_certain', 'reported_in_doubt', 'unreported'] = 'reported_certain'`
- `requested_by_ref: OpaqueRef`
- `evidence_custody_ref: OpaqueRef`
- `evidence: tuple[CloseEvidenceEnvelope, ...] = Field(min_length=2, max_length=20)`
- `package: PeriodClosePackage`
- `request_digest: Sha256Digest = GENESIS_PERIOD_CLOSE_DIGEST`

### `lightbulb.finance_close_lifecycle.period_close_command_content_digest`

function. Source: `lightbulb/finance_close_lifecycle.py:1402`.



~~~python
period_close_command_content_digest(command: PeriodCloseTransitionCommand | Mapping[str, Any]) -> str
~~~


Return the normalized semantic digest without circular seal fields.

### `lightbulb.finance_close_lifecycle.period_close_command_digest`

function. Source: `lightbulb/finance_close_lifecycle.py:1416`.



~~~python
period_close_command_digest(command: PeriodCloseTransitionCommand | Mapping[str, Any]) -> str
~~~


Return the full normalized command digest excluding request_digest itself.

### `lightbulb.finance_close_lifecycle.seal_period_close_command`

function. Source: `lightbulb/finance_close_lifecycle.py:1426`.



~~~python
seal_period_close_command(command: Mapping[str, Any]) -> dict[str, Any]
~~~


Normalize and seal one caller-prepared command without granting authority.

### `lightbulb.finance_close_lifecycle.PeriodCloseTransitionCandidate`

class. Source: `lightbulb/finance_close_lifecycle.py:1467`.

Fields:
- `schema_id: Literal['lightbulb.finance_period_close_transition_candidate.v1'] = Field(default='lightbulb.finance_period_close_transition_candidate.v1', alias='schema')`
- `to_version: int = Field(ge=1, le=MAX_PERIOD_CLOSE_TRANSITIONS)`
- `prior_state_digest: Sha256Digest`
- `scope_digest: Sha256Digest`
- `command_content_digest: Sha256Digest`
- `evidence_digest: Sha256Digest`
- `transition_digest: Sha256Digest`
- `command: PeriodCloseTransitionCommand`

### `lightbulb.finance_close_lifecycle.PeriodCloseLifecycleSnapshot`

class. Source: `lightbulb/finance_close_lifecycle.py:1850`.

Fields:
- `schema_id: Literal['lightbulb.finance_period_close_snapshot.v1'] = Field(default=PERIOD_CLOSE_SNAPSHOT_SCHEMA, alias='schema')`
- `scope: PeriodCloseScope`
- `status: LifecycleStatus`
- `version: int = Field(ge=1, le=MAX_PERIOD_CLOSE_TRANSITIONS)`
- `transition_history: tuple[PeriodCloseTransitionCandidate, ...] = Field(min_length=1, max_length=MAX_PERIOD_CLOSE_TRANSITIONS)`
- `evidence_lineage_digest: Sha256Digest`
- `period_open: OpenPeriodPackage`
- `trial_balance: TrialBalancePackage | None = None`
- `reconciliations: ReconciliationPackage | None = None`
- `adjusting_entries: AdjustingEntriesPackage | None = None`
- `subledger_locks: SubledgerLockPackage | None = None`
- `consolidation: ConsolidationPackage | None = None`
- `close_approval: CloseApprovalPackage | None = None`
- `close_candidate: ClosePeriodPackage | None = None`
- `state_digest: Sha256Digest`

### `lightbulb.finance_close_lifecycle.PeriodCloseLifecycleInput`

class. Source: `lightbulb/finance_close_lifecycle.py:1929`.

Fields:
- `schema_id: Literal['lightbulb.finance_period_close_input.v1'] = Field(default=PERIOD_CLOSE_INPUT_SCHEMA, alias='schema')`
- `scope: PeriodCloseScope`
- `snapshot: PeriodCloseLifecycleSnapshot | None = None`
- `command: PeriodCloseTransitionCommand`

### `lightbulb.finance_close_lifecycle.PeriodCloseEffectBoundary`

class. Source: `lightbulb/finance_close_lifecycle.py:1947`.

Fields:
- `sdk_mode: Literal['preview_only'] = 'preview_only'`
- `connector_calls: StrictZero = 0`
- `provider_calls: StrictZero = 0`
- `authoritative_scope_verified: StrictFalse = False`
- `rbac_authorized: StrictFalse = False`
- `authoritative_evidence_verified: StrictFalse = False`
- `hosted_write_executed: StrictFalse = False`
- `hosted_approval_task_created: StrictFalse = False`
- `hosted_approval_recorded: StrictFalse = False`
- `authoritative_audit_persisted: StrictFalse = False`
- `spring_authority_required: StrictTrue = True`

### `lightbulb.finance_close_lifecycle.PeriodCloseRecovery`

class. Source: `lightbulb/finance_close_lifecycle.py:1961`.

Fields:
- `disposition: Literal['not_required', 'manual_reconciliation_required']`
- `auto_retry_permitted: StrictFalse = False`
- `instructions: str | None = Field(default=None, min_length=1, max_length=1000)`

### `lightbulb.finance_close_lifecycle.PeriodCloseTransitionReceipt`

class. Source: `lightbulb/finance_close_lifecycle.py:1975`.

Fields:
- `schema_id: Literal['lightbulb.finance_period_close_receipt.v1'] = Field(default=PERIOD_CLOSE_RECEIPT_SCHEMA, alias='schema')`
- `transition_ref: OpaqueRef`
- `idempotency_key: OpaqueRef`
- `request_digest: Sha256Digest`
- `command_kind: TransitionKind`
- `status: Literal['candidate_materialized', 'replayed', 'rejected', 'in_doubt']`
- `from_version: int = Field(ge=0, le=MAX_PERIOD_CLOSE_TRANSITIONS)`
- `to_version: int = Field(ge=0, le=MAX_PERIOD_CLOSE_TRANSITIONS)`
- `from_state_digest: Sha256Digest`
- `to_state_digest: Sha256Digest`
- `evidence_digest: Sha256Digest`
- `rejection_code: str | None = Field(default=None, min_length=1, max_length=120)`
- `recovery: PeriodCloseRecovery`

### `lightbulb.finance_close_lifecycle.PeriodCloseLifecycleResult`

class. Source: `lightbulb/finance_close_lifecycle.py:2029`.

Fields:
- `schema_id: Literal['lightbulb.finance_period_close_result.v1'] = Field(default=PERIOD_CLOSE_RESULT_SCHEMA, alias='schema')`
- `candidate_validated: bool`
- `replayed: bool`
- `snapshot: PeriodCloseLifecycleSnapshot | None = None`
- `transition_receipt: PeriodCloseTransitionReceipt`
- `effect_boundary: PeriodCloseEffectBoundary = Field(default_factory=PeriodCloseEffectBoundary)`

### `lightbulb.finance_close_lifecycle.materialize_period_close_candidate`

function. Source: `lightbulb/finance_close_lifecycle.py:2144`.



~~~python
materialize_period_close_candidate(inputs: PeriodCloseLifecycleInput | Mapping[str, Any]) -> PeriodCloseLifecycleResult
~~~


Validate one bounded transition and return a non-authoritative candidate.

### `lightbulb.finance_close_lifecycle.ProposePeriodCloseTransitionPrimitive`

class. Source: `lightbulb/finance_close_lifecycle.py:2375`.

Fields:
- `example_inputs: Mapping[str, Any] = _period_close_example_inputs()`

#### Methods

##### `lightbulb.finance_close_lifecycle.ProposePeriodCloseTransitionPrimitive.implementation_contract`



~~~python
def implementation_contract() -> dict[str, Any]
~~~


Source: `lightbulb/finance_close_lifecycle.py:2397`.

## Module `lightbulb.finance_close_period_package`

Prepare a readiness-bound final period-close package candidate.

### `lightbulb.finance_close_period_package.close_period_request_digest`

function. Source: `lightbulb/finance_close_period_package.py:127`.



~~~python
close_period_request_digest(*, workspace: FinanceCloseWorkspace, lifecycle_snapshot: PeriodCloseLifecycleSnapshot, approval_transition_digest: str, close_candidate_ref: str, close_request_ref: str, close_requested_at: str, close_operator_ref: str, readiness_evaluation: PeriodCloseReadinessEvaluation) -> str
~~~


Commit the exact approved state, close request, and control result.

### `lightbulb.finance_close_period_package.CloseReadinessObservation`

class. Source: `lightbulb/finance_close_period_package.py:162`.

Fields:
- `schema_id: Literal['lightbulb.finance_close_readiness_observation.v1'] = Field(default=CLOSE_READINESS_OBSERVATION_SCHEMA, alias='schema')`
- `readiness_attestation_ref: OpaqueRef`
- `readiness_policy_ref: OpaqueRef`
- `issuer_ref: OpaqueRef`
- `scope_digest: Sha256Digest`
- `lifecycle_state_digest: Sha256Digest`
- `approval_transition_digest: Sha256Digest`
- `close_candidate_ref: OpaqueRef`
- `close_request_ref: OpaqueRef`
- `close_request_digest: Sha256Digest`
- `close_operator_ref: OpaqueRef`
- `readiness_evaluation_ref: OpaqueRef`
- `readiness_operation_digest: Sha256Digest`
- `readiness_evidence_digest: Sha256Digest`
- `readiness_evaluation_digest: Sha256Digest`
- `decision: Literal['reported_ready'] = 'reported_ready'`
- `observed_at: str`
- `expires_at: str`

#### Methods

##### `lightbulb.finance_close_period_package.CloseReadinessObservation.evidence_digest`



~~~python
def evidence_digest() -> str
~~~


Source: `lightbulb/finance_close_period_package.py:196`.

### `lightbulb.finance_close_period_package.PrepareClosePeriodPackageInput`

class. Source: `lightbulb/finance_close_period_package.py:200`.

Fields:
- `schema_id: Literal['lightbulb.finance_close_period_package_candidate_input.v1'] = Field(default=CLOSE_PERIOD_PACKAGE_CANDIDATE_INPUT_SCHEMA, alias='schema')`
- `workspace: FinanceCloseWorkspace`
- `lifecycle_snapshot: PeriodCloseLifecycleSnapshot`
- `readiness_input: PeriodCloseReadinessInput`
- `readiness_observation: CloseReadinessObservation`
- `close_candidate_ref: OpaqueRef`
- `close_request_ref: OpaqueRef`
- `close_requested_at: str`
- `close_operator_ref: OpaqueRef`
- `evidence_use_refs: tuple[OpaqueRef, OpaqueRef]`
- `prepared_at: str`

#### Methods

##### `lightbulb.finance_close_period_package.PrepareClosePeriodPackageInput.readiness_evaluation`



~~~python
def readiness_evaluation() -> PeriodCloseReadinessEvaluation
~~~


Source: `lightbulb/finance_close_period_package.py:417`.

### `lightbulb.finance_close_period_package.ClosePeriodPackageCandidateResult`

class. Source: `lightbulb/finance_close_period_package.py:421`.

Fields:
- `schema_id: Literal['lightbulb.finance_close_period_package_candidate_result.v1'] = Field(default=CLOSE_PERIOD_PACKAGE_CANDIDATE_RESULT_SCHEMA, alias='schema')`
- `workspace_ref: OpaqueRef`
- `workspace_revision: int = Field(ge=1)`
- `workspace_digest: Sha256Digest`
- `lifecycle_version: Literal[7] = 7`
- `lifecycle_state_digest: Sha256Digest`
- `approval_transition_digest: Sha256Digest`
- `close_request_digest: Sha256Digest`
- `prepared_at: str`
- `readiness_evaluation: PeriodCloseReadinessEvaluation`
- `package: ClosePeriodPackage`
- `package_digest: Sha256Digest`
- `readiness_observation_digest: Sha256Digest`
- `candidate_digest: Sha256Digest = _ZERO_DIGEST`
- `readiness_authentication_state: Literal['spring_revalidation_required'] = 'spring_revalidation_required'`
- `operator_authorization_state: Literal['spring_revalidation_required'] = 'spring_revalidation_required'`
- `evidence_custody_state: Literal['spring_retention_required'] = 'spring_retention_required'`
- `hosted_close_authority: Literal[False] = False`
- `lifecycle_transition_authority: Literal[False] = False`
- `persistence_authorized: Literal[False] = False`
- `connector_calls_authorized: Literal[False] = False`

#### Methods

##### `lightbulb.finance_close_period_package.ClosePeriodPackageCandidateResult.digest_payload`



~~~python
def digest_payload() -> dict[str, Any]
~~~


Source: `lightbulb/finance_close_period_package.py:457`.

### `lightbulb.finance_close_period_package.prepare_close_period_package`

function. Source: `lightbulb/finance_close_period_package.py:486`.



~~~python
prepare_close_period_package(inputs: PrepareClosePeriodPackageInput) -> ClosePeriodPackageCandidateResult
~~~


### `lightbulb.finance_close_period_package.PrepareClosePeriodPackagePrimitive`

class. Source: `lightbulb/finance_close_period_package.py:723`.

#### Methods

##### `lightbulb.finance_close_period_package.PrepareClosePeriodPackagePrimitive.implementation_contract`



~~~python
def implementation_contract() -> dict[str, Any]
~~~


Source: `lightbulb/finance_close_period_package.py:748`.

## Module `lightbulb.finance_close_period_transition`

Prepare an evidence-bound final ``close_period`` transition command.

### `lightbulb.finance_close_period_transition.CloseRequestEvidenceClaim`

class. Source: `lightbulb/finance_close_period_transition.py:128`.

Fields:
- `use_ref: OpaqueRef`
- `artifact_ref: OpaqueRef`
- `artifact_digest: Sha256Digest`
- `evidence_ref: OpaqueRef`
- `kind: Literal['close_request'] = _REQUEST_KIND`
- `issuer_ref: OpaqueRef`
- `observed_at: str`
- `effective_at: str`
- `retained_until: str`
- `verification_grade: Literal['attested', 'verified'] = 'attested'`
- `classification: Literal['internal', 'confidential', 'restricted'] = 'restricted'`

### `lightbulb.finance_close_period_transition.SpringCloseReadinessEvidenceClaim`

class. Source: `lightbulb/finance_close_period_transition.py:147`.

Fields:
- `use_ref: OpaqueRef`
- `artifact_ref: OpaqueRef`
- `artifact_digest: Sha256Digest`
- `evidence_ref: OpaqueRef`
- `kind: Literal['spring_close_readiness_attestation'] = _READINESS_KIND`
- `issuer_ref: OpaqueRef`
- `observed_at: str`
- `effective_at: str`
- `retained_until: str`
- `verification_grade: Literal['verified'] = 'verified'`
- `classification: Literal['internal', 'confidential', 'restricted'] = 'restricted'`
- `readiness_observation: CloseReadinessObservation`

### `lightbulb.finance_close_period_transition.PrepareClosePeriodTransitionCommandInput`

class. Source: `lightbulb/finance_close_period_transition.py:191`.

Fields:
- `schema_id: Literal['lightbulb.finance_close_period_transition_command_input.v1'] = Field(default=CLOSE_PERIOD_TRANSITION_COMMAND_INPUT_SCHEMA, alias='schema')`
- `workspace: FinanceCloseWorkspace`
- `package_candidate: ClosePeriodPackageCandidateResult`
- `lifecycle_snapshot: PeriodCloseLifecycleSnapshot`
- `transition_ref: OpaqueRef`
- `idempotency_key: OpaqueRef`
- `occurred_at: str`
- `requested_by_ref: OpaqueRef`
- `close_request_evidence: CloseRequestEvidenceClaim`
- `readiness_evidence: SpringCloseReadinessEvidenceClaim`

### `lightbulb.finance_close_period_transition.ClosePeriodTransitionCommandResult`

class. Source: `lightbulb/finance_close_period_transition.py:346`.

Fields:
- `schema_id: Literal['lightbulb.finance_close_period_transition_command_result.v1'] = Field(default=CLOSE_PERIOD_TRANSITION_COMMAND_RESULT_SCHEMA, alias='schema')`
- `workspace_ref: OpaqueRef`
- `workspace_revision: int = Field(ge=1)`
- `workspace_digest: Sha256Digest`
- `package_candidate_digest: Sha256Digest`
- `lifecycle_version: Literal[7] = 7`
- `lifecycle_state_digest: Sha256Digest`
- `close_candidate_ref: OpaqueRef`
- `close_request_digest: Sha256Digest`
- `readiness_observation_digest: Sha256Digest`
- `readiness_expires_at: str`
- `lifecycle_input: PeriodCloseLifecycleInput`
- `command_content_digest: Sha256Digest`
- `command_request_digest: Sha256Digest`
- `evidence_lineage_tail_digest: Sha256Digest`
- `result_digest: Sha256Digest = _ZERO_DIGEST`
- `readiness_authentication_state: Literal['spring_revalidation_required'] = 'spring_revalidation_required'`
- `operator_authorization_state: Literal['spring_revalidation_required'] = 'spring_revalidation_required'`
- `evidence_authentication_state: Literal['spring_revalidation_required'] = 'spring_revalidation_required'`
- `evidence_custody_state: Literal['spring_retention_required'] = 'spring_retention_required'`
- `hosted_close_execution_state: Literal['spring_execution_required'] = 'spring_execution_required'`
- `lifecycle_transition_authority: Literal[False] = False`
- `persistence_authorized: Literal[False] = False`
- `period_close_authorized: Literal[False] = False`
- `connector_calls_authorized: Literal[False] = False`

#### Methods

##### `lightbulb.finance_close_period_transition.ClosePeriodTransitionCommandResult.digest_payload`



~~~python
def digest_payload() -> dict[str, Any]
~~~


Source: `lightbulb/finance_close_period_transition.py:390`.

### `lightbulb.finance_close_period_transition.prepare_close_period_transition_command`

function. Source: `lightbulb/finance_close_period_transition.py:465`.



~~~python
prepare_close_period_transition_command(inputs: PrepareClosePeriodTransitionCommandInput) -> ClosePeriodTransitionCommandResult
~~~


### `lightbulb.finance_close_period_transition.PrepareClosePeriodTransitionCommandPrimitive`

class. Source: `lightbulb/finance_close_period_transition.py:564`.

#### Methods

##### `lightbulb.finance_close_period_transition.PrepareClosePeriodTransitionCommandPrimitive.implementation_contract`



~~~python
def implementation_contract() -> dict[str, Any]
~~~


Source: `lightbulb/finance_close_period_transition.py:589`.

## Module `lightbulb.finance_close_reconciliation_readiness`

Deterministic bridge from settlement activity to account-close readiness.

### `lightbulb.finance_close_reconciliation_readiness.CloseReconciliationReadinessInput`

class. Source: `lightbulb/finance_close_reconciliation_readiness.py:184`.

Fields:
- `schema_id: Literal['lightbulb.finance_close_reconciliation_readiness_input.v1'] = Field(default=CLOSE_RECONCILIATION_READINESS_INPUT_SCHEMA, alias='schema')`
- `workspace: FinanceCloseWorkspace`
- `lifecycle_snapshot: PeriodCloseLifecycleSnapshot | None = None`
- `settlement_reconciliation: StripeLedgerReconciliationResult`
- `evaluated_at: str`

### `lightbulb.finance_close_reconciliation_readiness.CloseReconciliationReadinessBlocker`

class. Source: `lightbulb/finance_close_reconciliation_readiness.py:246`.

Fields:
- `code: ReadinessBlockerCode`
- `message: str = Field(min_length=1, max_length=500)`

### `lightbulb.finance_close_reconciliation_readiness.CloseReconciliationReadinessResult`

class. Source: `lightbulb/finance_close_reconciliation_readiness.py:257`.

Fields:
- `schema_id: Literal['lightbulb.finance_close_reconciliation_readiness_result.v1'] = Field(default=CLOSE_RECONCILIATION_READINESS_RESULT_SCHEMA, alias='schema')`
- `workspace_ref: OpaqueRef`
- `workspace_revision: int = Field(ge=1)`
- `workspace_digest: Sha256Digest`
- `settlement_result_digest: Sha256Digest`
- `lifecycle_version: int | None = Field(default=None, ge=1, le=8)`
- `lifecycle_state_digest: Sha256Digest | None = None`
- `trial_balance_transition_digest: Sha256Digest | None = None`
- `evaluated_at: str`
- `blockers: tuple[CloseReconciliationReadinessBlocker, ...] = Field(max_length=11)`
- `checklist: tuple[FinanceCloseChecklistItem, ...] = Field(min_length=10, max_length=10)`
- `account_reconciliation_ready: bool`
- `next_transition: Literal['reconcile_accounts'] | None`
- `required_evidence_kinds: tuple[Literal['account_subledger_reconciliations', 'reconciliation_review_attestation'], Literal['account_subledger_reconciliations', 'reconciliation_review_attestation']] = ('account_subledger_reconciliations', 'reconciliation_review_attestation')`
- `settlement_activity_is_balance_reconciliation: Literal[False] = False`
- `reconciliation_package_authority: Literal[False] = False`
- `lifecycle_transition_authority: Literal[False] = False`
- `persistence_authorized: Literal[False] = False`
- `result_digest: Sha256Digest = _ZERO_DIGEST`

#### Methods

##### `lightbulb.finance_close_reconciliation_readiness.CloseReconciliationReadinessResult.digest_payload`



~~~python
def digest_payload() -> dict[str, Any]
~~~


Source: `lightbulb/finance_close_reconciliation_readiness.py:304`.

### `lightbulb.finance_close_reconciliation_readiness.evaluate_close_reconciliation_readiness`

function. Source: `lightbulb/finance_close_reconciliation_readiness.py:408`.



~~~python
evaluate_close_reconciliation_readiness(inputs: CloseReconciliationReadinessInput) -> CloseReconciliationReadinessResult
~~~


### `lightbulb.finance_close_reconciliation_readiness.EvaluateCloseReconciliationReadinessPrimitive`

class. Source: `lightbulb/finance_close_reconciliation_readiness.py:524`.

#### Methods

##### `lightbulb.finance_close_reconciliation_readiness.EvaluateCloseReconciliationReadinessPrimitive.implementation_contract`



~~~python
def implementation_contract() -> dict[str, Any]
~~~


Source: `lightbulb/finance_close_reconciliation_readiness.py:549`.

## Module `lightbulb.finance_close_source_transactions`

Governed monthly accounting source transactions for the close lighthouse.

### `lightbulb.finance_close_source_transactions.CloseSourceTransactionInput`

class. Source: `lightbulb/finance_close_source_transactions.py:233`.

Fields:
- `schema_id: Literal['lightbulb.finance_close_source_transaction_input.v1'] = Field(default=CLOSE_SOURCE_TRANSACTION_INPUT_SCHEMA, alias='schema')`
- `provider: Literal['quickbooks'] = 'quickbooks'`
- `start_date: str`
- `end_date: str`
- `currency: CurrencyCode`

### `lightbulb.finance_close_source_transactions.CloseSourceTransactionLink`

class. Source: `lightbulb/finance_close_source_transactions.py:248`.

Fields:
- `schema_id: Literal['lightbulb.finance_close_source_transaction_link.v1'] = Field(default=CLOSE_SOURCE_TRANSACTION_LINK_SCHEMA, alias='schema')`
- `source_ref: OpaqueRef`
- `source_type: OpaqueRef`

### `lightbulb.finance_close_source_transactions.CloseSourceTransaction`

class. Source: `lightbulb/finance_close_source_transactions.py:257`.

Fields:
- `schema_id: Literal['lightbulb.finance_close_source_transaction.v1'] = Field(default=CLOSE_SOURCE_TRANSACTION_SCHEMA, alias='schema')`
- `provider: Literal['quickbooks'] = 'quickbooks'`
- `transaction_type: TransactionType`
- `source_ref: OpaqueRef`
- `source_revision: str = Field(pattern=_SYNC_TOKEN_PATTERN)`
- `transaction_date: str`
- `source_updated_at: str`
- `document_number: str | None = Field(default=None, max_length=100)`
- `counterparty_ref: OpaqueRef | None = None`
- `counterparty_name: str | None = Field(default=None, max_length=500)`
- `currency: CurrencyCode`
- `total_amount: ExactDecimal`
- `open_balance: ExactDecimal | None = None`
- `links: tuple[CloseSourceTransactionLink, ...] = Field(default=(), max_length=_MAX_LINKS_PER_TRANSACTION)`
- `source_digest: Sha256Digest = _ZERO_DIGEST`

### `lightbulb.finance_close_source_transactions.CloseSourcePageCheckpoint`

class. Source: `lightbulb/finance_close_source_transactions.py:332`.

Fields:
- `schema_id: Literal['lightbulb.finance_close_source_page_checkpoint.v1'] = Field(default=CLOSE_SOURCE_PAGE_CHECKPOINT_SCHEMA, alias='schema')`
- `tool: Literal['quickbooks.list_invoices', 'quickbooks.list_bills', 'quickbooks.list_payments']`
- `tool_version: Literal[2] = QUICKBOOKS_CLOSE_SOURCE_TOOL_VERSION`
- `transaction_type: TransactionType`
- `start_position: ExactInteger = Field(ge=1)`
- `record_count: ExactInteger = Field(ge=0, le=_PAGE_SIZE)`
- `terminal: bool`
- `page_digest: Sha256Digest`
- `provenance_receipt_digest: Sha256Digest`
- `execution_journal_ref: OpaqueRef`
- `completed_at: str`

### `lightbulb.finance_close_source_transactions.CloseSourceTransactionResult`

class. Source: `lightbulb/finance_close_source_transactions.py:358`.

Fields:
- `schema_id: Literal['lightbulb.finance_close_source_transaction_result.v1'] = Field(default=CLOSE_SOURCE_TRANSACTION_RESULT_SCHEMA, alias='schema')`
- `provider: Literal['quickbooks'] = 'quickbooks'`
- `tool_version: Literal[2] = QUICKBOOKS_CLOSE_SOURCE_TOOL_VERSION`
- `project_id: UUID`
- `tenant_connector_id: UUID`
- `connector_account_ref: OpaqueRef`
- `route_digest: Sha256Digest`
- `start_date: str`
- `end_date: str`
- `currency: CurrencyCode`
- `transactions: tuple[CloseSourceTransaction, ...] = Field(max_length=_MAX_TRANSACTIONS)`
- `transaction_count: ExactInteger = Field(ge=0, le=_MAX_TRANSACTIONS)`
- `invoice_count: ExactInteger = Field(ge=0, le=_MAX_TRANSACTIONS_PER_TYPE)`
- `bill_count: ExactInteger = Field(ge=0, le=_MAX_TRANSACTIONS_PER_TYPE)`
- `payment_count: ExactInteger = Field(ge=0, le=_MAX_TRANSACTIONS_PER_TYPE)`
- `checkpoints: tuple[CloseSourcePageCheckpoint, ...] = Field(min_length=3, max_length=_MAX_PAGE_READS)`
- `observed_at: str`
- `freshness: Literal['bounded_observation'] = 'bounded_observation'`
- `classification: Literal['restricted'] = 'restricted'`
- `retention_requirement: Literal['spring_financial_evidence_policy'] = 'spring_financial_evidence_policy'`
- `complete: Literal[True] = True`
- `authoritative_read: Literal[True] = True`
- `reconciliation_authority: Literal[False] = False`
- `close_authority: Literal[False] = False`
- `source_digest: Sha256Digest = _ZERO_DIGEST`

### `lightbulb.finance_close_source_transactions.DiscoverCloseSourceTransactionsPrimitive`

class. Source: `lightbulb/finance_close_source_transactions.py:873`.

## Module `lightbulb.finance_close_workspace`

Initial monthly-close workspace construction for the finance lighthouse.

### `lightbulb.finance_close_workspace.FinanceCloseWorkspaceInput`

class. Source: `lightbulb/finance_close_workspace.py:147`.

Fields:
- `schema_id: Literal['lightbulb.finance_close_workspace_input.v3'] = Field(default=FINANCE_CLOSE_WORKSPACE_INPUT_SCHEMA, alias='schema')`
- `workspace_ref: OpaqueRef`
- `workspace_revision: PositiveRevision`
- `prepared_at: str`
- `ledger_materialization: LedgerSnapshotMaterializationResult`
- `close_evidence_bundle: FinanceCloseEvidenceBundle`
- `close_scope: PeriodCloseScope`
- `stripe_subledger_ref: OpaqueRef`
- `stripe_control_account_ref: OpaqueRef`
- `period_open_candidate_ref: OpaqueRef`
- `prior_period_state: Literal['closed', 'not_applicable']`
- `opened_at: str`
- `opened_by_ref: OpaqueRef`
- `open_reviewed_by_ref: OpaqueRef`
- `period_open_evidence_use_refs: tuple[OpaqueRef, ...] = Field(min_length=2, max_length=20)`
- `trial_balance_ref: OpaqueRef`
- `trial_balance_prepared_by_ref: OpaqueRef`
- `trial_balance_reviewed_by_ref: OpaqueRef`
- `trial_balance_evidence_use_refs: tuple[OpaqueRef, ...] = Field(min_length=2, max_length=20)`

#### Methods

##### `lightbulb.finance_close_workspace.FinanceCloseWorkspaceInput.ledger_snapshot`



~~~python
@property
def ledger_snapshot() -> CanonicalLedgerSnapshot
~~~


Source: `lightbulb/finance_close_workspace.py:178`.

### `lightbulb.finance_close_workspace.FinanceCloseChecklistItem`

class. Source: `lightbulb/finance_close_workspace.py:343`.

Fields:
- `sequence: int = Field(ge=1, le=len(_CHECKLIST_STAGES))`
- `stage: CloseWorkspaceStage`
- `status: CloseWorkspaceTaskStatus`
- `blocker_code: OpaqueRef | None = None`

### `lightbulb.finance_close_workspace.FinanceCloseWorkspace`

class. Source: `lightbulb/finance_close_workspace.py:358`.

Fields:
- `schema_id: Literal['lightbulb.finance_close_workspace.v3'] = Field(default=FINANCE_CLOSE_WORKSPACE_SCHEMA, alias='schema')`
- `workspace_ref: OpaqueRef`
- `workspace_revision: PositiveRevision`
- `prepared_at: str`
- `close_scope: PeriodCloseScope`
- `ledger_snapshot_ref: OpaqueRef`
- `ledger_snapshot_revision: PositiveRevision`
- `ledger_snapshot_content_digest: Sha256Digest`
- `ledger_snapshot_evidence_digest: Sha256Digest`
- `ledger_snapshot_artifact_digest: Sha256Digest`
- `ledger_source_read_binding_digest: Sha256Digest`
- `close_evidence_bundle_ref: OpaqueRef`
- `close_evidence_bundle_revision: PositiveRevision`
- `close_evidence_bundle_digest: Sha256Digest`
- `accounting_provider: Literal['quickbooks', 'xero']`
- `provider_period_readiness: Literal['ready', 'ready_with_provider_lock_warning']`
- `stripe_subledger_ref: OpaqueRef`
- `stripe_control_account_ref: OpaqueRef`
- `open_period_package: OpenPeriodPackage`
- `trial_balance_package: TrialBalancePackage`
- `checklist: tuple[FinanceCloseChecklistItem, ...] = Field(min_length=len(_CHECKLIST_STAGES), max_length=len(_CHECKLIST_STAGES))`
- `next_transition: Literal['open_period'] = 'open_period'`
- `remaining_task_count: int = Field(ge=1, le=len(_CHECKLIST_STAGES))`
- `authority_state: Literal['structural_candidate_only'] = 'structural_candidate_only'`
- `persistence_authorized: Literal[False] = False`
- `close_authorized: Literal[False] = False`
- `content_digest: Sha256Digest = _ZERO_DIGEST`

#### Methods

##### `lightbulb.finance_close_workspace.FinanceCloseWorkspace.content_digest_payload`



~~~python
def content_digest_payload() -> dict[str, Any]
~~~


Source: `lightbulb/finance_close_workspace.py:406`.

### `lightbulb.finance_close_workspace.FinanceCloseWorkspaceResult`

class. Source: `lightbulb/finance_close_workspace.py:440`.

Fields:
- `schema_id: Literal['lightbulb.finance_close_workspace_result.v3'] = Field(default=FINANCE_CLOSE_WORKSPACE_RESULT_SCHEMA, alias='schema')`
- `workspace: FinanceCloseWorkspace`
- `connector_operation_performed: Literal[False] = False`
- `persistence_authorized: Literal[False] = False`
- `close_authorized: Literal[False] = False`

### `lightbulb.finance_close_workspace.prepare_close_workspace`

function. Source: `lightbulb/finance_close_workspace.py:484`.



~~~python
prepare_close_workspace(inputs: FinanceCloseWorkspaceInput) -> FinanceCloseWorkspaceResult
~~~


### `lightbulb.finance_close_workspace.PrepareCloseWorkspacePrimitive`

class. Source: `lightbulb/finance_close_workspace.py:609`.

#### Methods

##### `lightbulb.finance_close_workspace.PrepareCloseWorkspacePrimitive.implementation_contract`



~~~python
def implementation_contract() -> dict[str, Any]
~~~


Source: `lightbulb/finance_close_workspace.py:634`.

## Module `lightbulb.finance_consolidation_package`

Prepare a controlled period-close consolidation package candidate.

### `lightbulb.finance_consolidation_package.PrepareConsolidationPackageInput`

class. Source: `lightbulb/finance_consolidation_package.py:122`.

Fields:
- `schema_id: Literal['lightbulb.finance_consolidation_package_candidate_input.v1'] = Field(default=CONSOLIDATION_PACKAGE_CANDIDATE_INPUT_SCHEMA, alias='schema')`
- `workspace: FinanceCloseWorkspace`
- `lifecycle_snapshot: PeriodCloseLifecycleSnapshot`
- `consolidation_workpaper_ref: OpaqueRef`
- `evidence_use_refs: tuple[OpaqueRef, OpaqueRef]`
- `no_intercompany_activity: bool`
- `elimination_entries: tuple[EliminationEntry, ...] = Field(default_factory=tuple, max_length=1000)`
- `intercompany_input_balance: Money`
- `eliminated_amount: Money`
- `residual_balance: Money`
- `residual_materiality_threshold: Money`
- `consolidated_at: str`
- `prepared_at: str`
- `consolidator_ref: OpaqueRef`
- `reviewed_by_ref: OpaqueRef`

### `lightbulb.finance_consolidation_package.ConsolidationPackageCandidateResult`

class. Source: `lightbulb/finance_consolidation_package.py:262`.

Fields:
- `schema_id: Literal['lightbulb.finance_consolidation_package_candidate_result.v1'] = Field(default=CONSOLIDATION_PACKAGE_CANDIDATE_RESULT_SCHEMA, alias='schema')`
- `workspace_ref: OpaqueRef`
- `workspace_revision: int = Field(ge=1)`
- `workspace_digest: Sha256Digest`
- `lifecycle_version: Literal[5] = 5`
- `lifecycle_state_digest: Sha256Digest`
- `adjustment_transition_digest: Sha256Digest`
- `lock_transition_digest: Sha256Digest`
- `prepared_at: str`
- `package: ConsolidationPackage`
- `package_digest: Sha256Digest`
- `elimination_entry_digests: tuple[Sha256Digest, ...] = Field(max_length=1000)`
- `candidate_digest: Sha256Digest = _ZERO_DIGEST`
- `elimination_settlement_state: Literal['not_applicable', 'spring_revalidation_required']`
- `actor_identity_state: Literal['spring_revalidation_required'] = 'spring_revalidation_required'`
- `evidence_custody_state: Literal['spring_retention_required'] = 'spring_retention_required'`
- `consolidation_package_authority: Literal[False] = False`
- `elimination_posting_authority: Literal[False] = False`
- `lifecycle_transition_authority: Literal[False] = False`
- `persistence_authorized: Literal[False] = False`

#### Methods

##### `lightbulb.finance_consolidation_package.ConsolidationPackageCandidateResult.digest_payload`



~~~python
def digest_payload() -> dict[str, Any]
~~~


Source: `lightbulb/finance_consolidation_package.py:302`.

### `lightbulb.finance_consolidation_package.prepare_consolidation_package`

function. Source: `lightbulb/finance_consolidation_package.py:334`.



~~~python
prepare_consolidation_package(inputs: PrepareConsolidationPackageInput) -> ConsolidationPackageCandidateResult
~~~


### `lightbulb.finance_consolidation_package.PrepareConsolidationPackagePrimitive`

class. Source: `lightbulb/finance_consolidation_package.py:410`.

#### Methods

##### `lightbulb.finance_consolidation_package.PrepareConsolidationPackagePrimitive.implementation_contract`



~~~python
def implementation_contract() -> dict[str, Any]
~~~


Source: `lightbulb/finance_consolidation_package.py:435`.

## Module `lightbulb.finance_consolidation_transition`

Prepare an evidence-bound ``consolidate`` transition command.

### `lightbulb.finance_consolidation_transition.ConsolidationArtifactEvidenceClaim`

class. Source: `lightbulb/finance_consolidation_transition.py:120`.

Fields:
- `use_ref: OpaqueRef`
- `artifact_ref: OpaqueRef`
- `artifact_digest: Sha256Digest`
- `evidence_ref: OpaqueRef`
- `kind: Literal['consolidation_workpaper'] = _ARTIFACT_KIND`
- `issuer_ref: OpaqueRef`
- `observed_at: str`
- `effective_at: str`
- `retained_until: str`
- `verification_grade: Literal['attested', 'verified'] = 'attested'`
- `classification: Literal['internal', 'confidential', 'restricted'] = 'restricted'`

### `lightbulb.finance_consolidation_transition.ConsolidationReviewEvidenceClaim`

class. Source: `lightbulb/finance_consolidation_transition.py:139`.

Fields:
- `use_ref: OpaqueRef`
- `artifact_ref: OpaqueRef`
- `artifact_digest: Sha256Digest`
- `evidence_ref: OpaqueRef`
- `kind: Literal['intercompany_elimination_attestation'] = _REVIEW_KIND`
- `issuer_ref: OpaqueRef`
- `observed_at: str`
- `effective_at: str`
- `retained_until: str`
- `verification_grade: Literal['verified'] = 'verified'`
- `classification: Literal['internal', 'confidential', 'restricted'] = 'restricted'`

### `lightbulb.finance_consolidation_transition.PrepareConsolidationTransitionCommandInput`

class. Source: `lightbulb/finance_consolidation_transition.py:158`.

Fields:
- `schema_id: Literal['lightbulb.finance_consolidation_transition_command_input.v1'] = Field(default=CONSOLIDATION_TRANSITION_COMMAND_INPUT_SCHEMA, alias='schema')`
- `workspace: FinanceCloseWorkspace`
- `package_candidate: ConsolidationPackageCandidateResult`
- `lifecycle_snapshot: PeriodCloseLifecycleSnapshot`
- `transition_ref: OpaqueRef`
- `idempotency_key: OpaqueRef`
- `occurred_at: str`
- `requested_by_ref: OpaqueRef`
- `artifact_evidence: ConsolidationArtifactEvidenceClaim`
- `review_evidence: ConsolidationReviewEvidenceClaim`

### `lightbulb.finance_consolidation_transition.ConsolidationTransitionCommandResult`

class. Source: `lightbulb/finance_consolidation_transition.py:266`.

Fields:
- `schema_id: Literal['lightbulb.finance_consolidation_transition_command_result.v1'] = Field(default=CONSOLIDATION_TRANSITION_COMMAND_RESULT_SCHEMA, alias='schema')`
- `workspace_ref: OpaqueRef`
- `workspace_revision: int = Field(ge=1)`
- `workspace_digest: Sha256Digest`
- `package_candidate_digest: Sha256Digest`
- `lifecycle_version: Literal[5] = 5`
- `lifecycle_state_digest: Sha256Digest`
- `lifecycle_input: PeriodCloseLifecycleInput`
- `command_content_digest: Sha256Digest`
- `command_request_digest: Sha256Digest`
- `evidence_lineage_tail_digest: Sha256Digest`
- `result_digest: Sha256Digest = _ZERO_DIGEST`
- `consolidation_state_authentication: Literal['spring_revalidation_required'] = 'spring_revalidation_required'`
- `elimination_settlement_state: Literal['not_applicable', 'spring_revalidation_required']`
- `evidence_authentication_state: Literal['spring_revalidation_required'] = 'spring_revalidation_required'`
- `evidence_custody_state: Literal['spring_retention_required'] = 'spring_retention_required'`
- `lifecycle_transition_authority: Literal[False] = False`
- `persistence_authorized: Literal[False] = False`
- `provider_calls_authorized: Literal[False] = False`
- `journal_posting_authorized: Literal[False] = False`

#### Methods

##### `lightbulb.finance_consolidation_transition.ConsolidationTransitionCommandResult.digest_payload`



~~~python
def digest_payload() -> dict[str, Any]
~~~


Source: `lightbulb/finance_consolidation_transition.py:298`.

### `lightbulb.finance_consolidation_transition.prepare_consolidation_transition_command`

function. Source: `lightbulb/finance_consolidation_transition.py:369`.



~~~python
prepare_consolidation_transition_command(inputs: PrepareConsolidationTransitionCommandInput) -> ConsolidationTransitionCommandResult
~~~


### `lightbulb.finance_consolidation_transition.PrepareConsolidationTransitionCommandPrimitive`

class. Source: `lightbulb/finance_consolidation_transition.py:469`.

#### Methods

##### `lightbulb.finance_consolidation_transition.PrepareConsolidationTransitionCommandPrimitive.implementation_contract`



~~~python
def implementation_contract() -> dict[str, Any]
~~~


Source: `lightbulb/finance_consolidation_transition.py:494`.

## Module `lightbulb.finance_general_ledger`

Governed provider-neutral General Ledger activity normalization.

### `lightbulb.finance_general_ledger.GeneralLedgerActivityInput`

class. Source: `lightbulb/finance_general_ledger.py:267`.

Fields:
- `schema_id: Literal['lightbulb.finance_general_ledger_activity_input.v1'] = Field(default=GENERAL_LEDGER_ACTIVITY_INPUT_SCHEMA, alias='schema')`
- `provider: _LedgerProvider = 'quickbooks'`
- `start_date: str`
- `end_date: str`
- `currency: CurrencyCode | None = None`

### `lightbulb.finance_general_ledger.GeneralLedgerActivityLine`

class. Source: `lightbulb/finance_general_ledger.py:291`.

Canonical, restricted activity retained from one provider Data row.

Fields:
- `schema_id: Literal['lightbulb.general_ledger_activity_line.v1'] = Field(default=GENERAL_LEDGER_ACTIVITY_LINE_SCHEMA, alias='schema')`
- `provider: _LedgerProvider = 'quickbooks'`
- `line_ref: Sha256Digest`
- `transaction_ref: OpaqueRef`
- `account_ref: OpaqueRef`
- `account_name: str = Field(min_length=1, max_length=500)`
- `transaction_date: str`
- `transaction_type: str = Field(min_length=1, max_length=160)`
- `document_number: str | None = Field(default=None, max_length=100)`
- `counterparty_ref: OpaqueRef | None = None`
- `counterparty_name: str | None = Field(default=None, max_length=500)`
- `memo: str | None = Field(default=None, max_length=_MAX_MEMO_CHARS)`
- `memo_digest: Sha256Digest | None = None`
- `split_account_ref: OpaqueRef | None = None`
- `split_account_name: str | None = Field(default=None, max_length=500)`
- `amount: Decimal`
- `running_balance: Decimal | None = None`
- `currency: CurrencyCode`
- `source_row_ordinal: int = Field(ge=1, le=_MAX_ACTIVITY_LINES)`
- `source_row_digest: Sha256Digest`

### `lightbulb.finance_general_ledger.GeneralLedgerActivityObservation`

class. Source: `lightbulb/finance_general_ledger.py:405`.

Fields:
- `schema_id: Literal['lightbulb.finance_general_ledger_activity_result.v1'] = Field(default=GENERAL_LEDGER_ACTIVITY_RESULT_SCHEMA, alias='schema')`
- `provider: _LedgerProvider`
- `tool: ToolName`
- `tool_version: int = Field(ge=1, le=2147483647)`
- `project_id: UUID`
- `tenant_connector_id: UUID`
- `connector_account_ref: OpaqueRef`
- `route_digest: Sha256Digest`
- `start_date: str`
- `end_date: str`
- `currency: CurrencyCode`
- `lines: tuple[GeneralLedgerActivityLine, ...] = Field(max_length=_MAX_ACTIVITY_LINES)`
- `line_count: int = Field(ge=0, le=_MAX_ACTIVITY_LINES)`
- `provider_report_digest: Sha256Digest`
- `provenance_receipt_digest: Sha256Digest`
- `observed_at: str`
- `freshness: Literal['current'] = 'current'`
- `classification: Literal['restricted'] = 'restricted'`
- `retention_requirement: Literal['spring_financial_evidence_policy'] = 'spring_financial_evidence_policy'`
- `complete: Literal[True] = True`
- `authoritative_read: Literal[True] = True`
- `reconciliation_authority: Literal[False] = False`
- `close_authority: Literal[False] = False`
- `certification_authority: Literal[False] = False`
- `source_digest: Sha256Digest = _ZERO_DIGEST`

### `lightbulb.finance_general_ledger.GeneralLedgerActivityResult`

class. Source: `lightbulb/finance_general_ledger.py:507`.

Provider-neutral observation returned by the executable primitive.

Fields:
- `provider: _LedgerProvider = 'quickbooks'`
- `tool: ToolName = QUICKBOOKS_GENERAL_LEDGER_TOOL`
- `tool_version: int = Field(default=QUICKBOOKS_GENERAL_LEDGER_TOOL_VERSION, ge=1)`

### `lightbulb.finance_general_ledger.DiscoverGeneralLedgerActivityPrimitive`

class. Source: `lightbulb/finance_general_ledger.py:1459`.

## Module `lightbulb.finance_journal_lifecycle`

Typed general-ledger journal lifecycle primitives.

### `lightbulb.finance_journal_lifecycle.LedgerAccountDiscoveryInput`

class. Source: `lightbulb/finance_journal_lifecycle.py:388`.

Fields:
- `schema_id: Literal['lightbulb.finance_ledger_account_discovery_input.v1'] = Field(default=LEDGER_ACCOUNT_DISCOVERY_INPUT_SCHEMA, alias='schema')`
- `provider: JournalProvider = 'quickbooks'`

### `lightbulb.finance_journal_lifecycle.GovernedLedgerReadReceipt`

class. Source: `lightbulb/finance_journal_lifecycle.py:396`.

Sanitized source-page custody from one completed Spring-governed read.

Fields:
- `schema_id: Literal['lightbulb.finance_governed_ledger_read_receipt.v2'] = Field(default=GOVERNED_LEDGER_READ_RECEIPT_SCHEMA, alias='schema')`
- `page_number: int = Field(ge=1, le=_MAX_ACCOUNT_PAGES)`
- `tool: Literal['quickbooks.list_accounts', 'quickbooks.trial_balance_report', 'xero.list_accounts', 'xero.trial_balance_report']`
- `tool_version: Literal[2] = 2`
- `project_id: UUID`
- `tenant_connector_id: UUID`
- `connector_account_ref: OpaqueRef`
- `route_digest: Sha256Digest`
- `execution_journal_ref: OpaqueRef`
- `request_digest: Sha256Digest`
- `provenance_receipt_digest: Sha256Digest`
- `completed_at: str`
- `provider_output_digest: Sha256Digest`
- `source_page_digest: Sha256Digest`

### `lightbulb.finance_journal_lifecycle.LedgerAccount`

class. Source: `lightbulb/finance_journal_lifecycle.py:427`.

Fields:
- `provider: JournalProvider = 'quickbooks'`
- `account_ref: OpaqueRef`
- `account_code: str | None = Field(default=None, max_length=160)`
- `name: str = Field(min_length=1, max_length=500)`
- `fully_qualified_name: str | None = Field(default=None, max_length=1000)`
- `account_type: str | None = Field(default=None, max_length=160)`
- `account_subtype: str | None = Field(default=None, max_length=160)`
- `classification: str | None = Field(default=None, max_length=160)`
- `currency: CurrencyCode | None = None`
- `active: bool`
- `current_balance: Decimal | None = None`
- `source_updated_at: str | None = None`
- `source_revision_kind: Literal['content_sha256'] | None = None`
- `source_revision: Sha256Digest | None = None`

### `lightbulb.finance_journal_lifecycle.LedgerAccountDiscoveryResult`

class. Source: `lightbulb/finance_journal_lifecycle.py:487`.

Fields:
- `schema_id: Literal['lightbulb.finance_ledger_account_discovery_result.v2'] = Field(default=LEDGER_ACCOUNT_DISCOVERY_RESULT_SCHEMA, alias='schema')`
- `provider: JournalProvider = 'quickbooks'`
- `tool: Literal['quickbooks.list_accounts', 'xero.list_accounts'] = QUICKBOOKS_LIST_ACCOUNTS_TOOL`
- `accounts: tuple[LedgerAccount, ...] = Field(max_length=_MAX_ACCOUNTS)`
- `account_count: int = Field(ge=0, le=_MAX_ACCOUNTS)`
- `page_count: int = Field(ge=1, le=_MAX_ACCOUNT_PAGES)`
- `provider_total_count: int | None = Field(default=None, ge=0, le=_MAX_ACCOUNTS)`
- `complete: Literal[True] = True`
- `authoritative_read: Literal[True] = True`
- `source_digest: Sha256Digest`
- `provider_observed_at: str | None = None`
- `provenance_receipt_digests: tuple[Sha256Digest, ...] = Field(min_length=1, max_length=_MAX_ACCOUNT_PAGES)`
- `read_receipts: tuple[GovernedLedgerReadReceipt, ...] = Field(min_length=1, max_length=_MAX_ACCOUNT_PAGES)`

#### Methods

##### `lightbulb.finance_journal_lifecycle.LedgerAccountDiscoveryResult.source_digest_for`



~~~python
def source_digest_for(accounts: Sequence[LedgerAccount]) -> str
~~~


Source: `lightbulb/finance_journal_lifecycle.py:533`.

##### `lightbulb.finance_journal_lifecycle.LedgerAccountDiscoveryResult.source_page_digest_for`



~~~python
def source_page_digest_for(*, provider: JournalProvider, tool: str, page_number: int, accounts: Sequence[LedgerAccount]) -> str
~~~


Source: `lightbulb/finance_journal_lifecycle.py:542`.

### `lightbulb.finance_journal_lifecycle.TrialBalanceDiscoveryInput`

class. Source: `lightbulb/finance_journal_lifecycle.py:622`.

Fields:
- `schema_id: Literal['lightbulb.finance_trial_balance_discovery_input.v1'] = Field(default=TRIAL_BALANCE_DISCOVERY_INPUT_SCHEMA, alias='schema')`
- `provider: JournalProvider = 'quickbooks'`
- `start_date: str`
- `end_date: str`

### `lightbulb.finance_journal_lifecycle.DiscoveredTrialBalanceLine`

class. Source: `lightbulb/finance_journal_lifecycle.py:649`.

Fields:
- `provider: JournalProvider = 'quickbooks'`
- `account_ref: OpaqueRef`
- `account_name: str = Field(min_length=1, max_length=500)`
- `currency: CurrencyCode`
- `debit: Decimal = Field(ge=0)`
- `credit: Decimal = Field(ge=0)`

### `lightbulb.finance_journal_lifecycle.TrialBalanceDiscoveryResult`

class. Source: `lightbulb/finance_journal_lifecycle.py:684`.

Fields:
- `schema_id: Literal['lightbulb.finance_trial_balance_discovery_result.v2'] = Field(default=TRIAL_BALANCE_DISCOVERY_RESULT_SCHEMA, alias='schema')`
- `provider: JournalProvider = 'quickbooks'`
- `tool: Literal['quickbooks.trial_balance_report', 'xero.trial_balance_report'] = QUICKBOOKS_TRIAL_BALANCE_TOOL`
- `start_date: str`
- `end_date: str`
- `currency: CurrencyCode`
- `lines: tuple[DiscoveredTrialBalanceLine, ...] = Field(min_length=2, max_length=_MAX_TRIAL_BALANCE_LINES)`
- `line_count: int = Field(ge=2, le=_MAX_TRIAL_BALANCE_LINES)`
- `total_debit: Decimal = Field(gt=0)`
- `total_credit: Decimal = Field(gt=0)`
- `complete: Literal[True] = True`
- `authoritative_read: Literal[True] = True`
- `source_digest: Sha256Digest`
- `provenance_receipt_digest: Sha256Digest`
- `read_receipt: GovernedLedgerReadReceipt`
- `provider_observed_at: str | None = None`
- `source_updated_at: str | None = None`
- `source_revision_kind: Literal['content_sha256'] | None = None`
- `source_revision: Sha256Digest | None = None`

#### Methods

##### `lightbulb.finance_journal_lifecycle.TrialBalanceDiscoveryResult.source_digest_for`



~~~python
def source_digest_for(*, start_date: str, end_date: str, currency: str, lines: Sequence[DiscoveredTrialBalanceLine]) -> str
~~~


Source: `lightbulb/finance_journal_lifecycle.py:735`.

### `lightbulb.finance_journal_lifecycle.QuickBooksValueRef`

class. Source: `lightbulb/finance_journal_lifecycle.py:796`.

Fields:
- `value: OpaqueRef`

### `lightbulb.finance_journal_lifecycle.QuickBooksJournalEntryLineDetail`

class. Source: `lightbulb/finance_journal_lifecycle.py:800`.

Fields:
- `posting_type: Literal['Debit', 'Credit'] = Field(alias='PostingType')`
- `account_ref: QuickBooksValueRef = Field(alias='AccountRef')`

### `lightbulb.finance_journal_lifecycle.QuickBooksJournalEntryLine`

class. Source: `lightbulb/finance_journal_lifecycle.py:805`.

Fields:
- `amount: int | float = Field(alias='Amount', gt=0)`
- `detail_type: Literal['JournalEntryLineDetail'] = Field(default='JournalEntryLineDetail', alias='DetailType')`
- `detail: QuickBooksJournalEntryLineDetail = Field(alias='JournalEntryLineDetail')`
- `line_num: int = Field(alias='LineNum', ge=1, le=1000)`

### `lightbulb.finance_journal_lifecycle.QuickBooksJournalEntryPayload`

class. Source: `lightbulb/finance_journal_lifecycle.py:815`.

Fields:
- `lines: tuple[QuickBooksJournalEntryLine, ...] = Field(alias='Line', min_length=2, max_length=100)`
- `transaction_date: str = Field(alias='TxnDate')`
- `document_number: str = Field(alias='DocNumber', min_length=1, max_length=100)`
- `currency_ref: QuickBooksValueRef = Field(alias='CurrencyRef')`
- `adjustment: Literal[False] = Field(default=False, alias='Adjustment')`

### `lightbulb.finance_journal_lifecycle.quickbooks_journal_effect_sha256`

function. Source: `lightbulb/finance_journal_lifecycle.py:832`.



~~~python
quickbooks_journal_effect_sha256(payload: QuickBooksJournalEntryPayload | Mapping[str, Any]) -> str
~~~


Commit the provider-stable accounting effect of one QBO journal payload.

### `lightbulb.finance_journal_lifecycle.XeroManualJournalLine`

class. Source: `lightbulb/finance_journal_lifecycle.py:907`.

Fields:
- `account_code: str = Field(alias='AccountCode', min_length=1, max_length=50)`
- `line_amount: int | float = Field(alias='LineAmount')`
- `description: str = Field(alias='Description', min_length=1, max_length=4000)`

### `lightbulb.finance_journal_lifecycle.XeroManualJournalPayload`

class. Source: `lightbulb/finance_journal_lifecycle.py:920`.

Fields:
- `narration: str = Field(alias='Narration', min_length=1, max_length=4000)`
- `journal_lines: tuple[XeroManualJournalLine, ...] = Field(alias='JournalLines', min_length=2, max_length=100)`
- `transaction_date: str = Field(alias='Date')`
- `status: Literal['POSTED'] = Field(default='POSTED', alias='Status')`

### `lightbulb.finance_journal_lifecycle.PrepareJournalEntryInput`

class. Source: `lightbulb/finance_journal_lifecycle.py:939`.

Fields:
- `schema_id: Literal['lightbulb.finance_journal_entry_preparation_input.v1'] = Field(default=JOURNAL_ENTRY_PREPARATION_INPUT_SCHEMA, alias='schema')`
- `provider: JournalProvider`
- `journal: JournalEntryControlInput`

### `lightbulb.finance_journal_lifecycle.JournalEntryPreparation`

class. Source: `lightbulb/finance_journal_lifecycle.py:964`.

Fields:
- `schema_id: Literal['lightbulb.finance_journal_entry_preparation.v1'] = Field(default=JOURNAL_ENTRY_PREPARATION_SCHEMA, alias='schema')`
- `provider: JournalProvider`
- `tool: Literal['quickbooks.create_journal_entry', 'xero.create_manual_journal']`
- `entry_ref: OpaqueRef`
- `control_evaluation: JournalEntryControlEvaluation`
- `provider_payload: JournalProviderPayload | None = None`
- `provider_payload_digest: Sha256Digest | None = None`
- `preparation_digest: Sha256Digest`
- `ready_for_posting: bool`
- `posting_authorized: Literal[False] = False`
- `evidence_refs: tuple[PrimitiveEvidenceRef, ...] = Field(default_factory=tuple, max_length=200)`

### `lightbulb.finance_journal_lifecycle.PostJournalEntryInput`

class. Source: `lightbulb/finance_journal_lifecycle.py:1030`.

Fields:
- `schema_id: Literal['lightbulb.finance_journal_entry_post_input.v1'] = Field(default=JOURNAL_ENTRY_POST_INPUT_SCHEMA, alias='schema')`
- `expected_preparation_digest: Sha256Digest`
- `commit: bool = False`

### `lightbulb.finance_journal_lifecycle.GovernedJournalWriteResult`

class. Source: `lightbulb/finance_journal_lifecycle.py:1039`.

Fields:
- `schema_id: Literal['lightbulb.governed_finance_write_result.v2'] = Field(default=GOVERNED_FINANCE_WRITE_RESULT_SCHEMA, alias='schema')`
- `provider: JournalProvider`
- `provider_record_type: Literal['journal_entry', 'manual_journal']`
- `provider_record_ref: OpaqueRef`
- `write_provider_output_sha256: Sha256Digest`
- `expected_effect_sha256: Sha256Digest | None = None`
- `provider_output_sha256: Sha256Digest | None = Field(default=None, exclude=True, repr=False, description='Deprecated raw-digest alias accepted only when it exactly matches write_provider_output_sha256; it is never semantic evidence.')`

### `lightbulb.finance_journal_lifecycle.PostJournalEntryResult`

class. Source: `lightbulb/finance_journal_lifecycle.py:1097`.

Fields:
- `schema_id: Literal['lightbulb.finance_journal_entry_post_result.v2'] = Field(default=JOURNAL_ENTRY_POST_RESULT_SCHEMA, alias='schema')`
- `provider: JournalProvider`
- `tool: Literal['quickbooks.create_journal_entry', 'xero.create_manual_journal']`
- `entry_ref: OpaqueRef`
- `preparation_digest: Sha256Digest`
- `state: Literal['preview', 'pending_approval', 'posted', 'blocked', 'failed', 'in_doubt']`
- `provider_record_ref: OpaqueRef | None = None`
- `write_provider_output_sha256: Sha256Digest | None = None`
- `expected_effect_sha256: Sha256Digest | None = None`
- `execution_journal_ref: OpaqueRef | None = None`
- `tool_version: int | None = Field(default=None, ge=1)`
- `project_id: UUID | None = None`
- `tenant_connector_id: UUID | None = None`
- `connector_account_ref: OpaqueRef | None = None`
- `route_digest: Sha256Digest | None = None`
- `provenance_receipt_digest: Sha256Digest | None = None`
- `unverified_recovery_journal_locator: OpaqueRef | None = Field(default=None, description='Untrusted routing hint from an ambiguous hosted response; Spring must authenticate, scope, and reauthorize it before recovery.')`
- `recovery_required: bool = False`
- `readback_required: bool = False`
- `automatic_retry_allowed: Literal[False] = False`
- `additional_posting_authorized: Literal[False] = False`

### `lightbulb.finance_journal_lifecycle.JournalPostReadback`

class. Source: `lightbulb/finance_journal_lifecycle.py:1198`.

Fields:
- `schema_id: Literal['lightbulb.finance_journal_post_readback.v2'] = Field(default=JOURNAL_POST_READBACK_SCHEMA, alias='schema')`
- `provider: JournalProvider`
- `read_tool: Literal['quickbooks.get_journal_entry', 'xero.list_journals']`
- `entry_ref: OpaqueRef`
- `post_request_digest: Sha256Digest`
- `preparation_digest: Sha256Digest`
- `read_tool_version: int = Field(ge=1)`
- `project_id: UUID`
- `tenant_connector_id: UUID`
- `connector_account_ref: OpaqueRef`
- `route_digest: Sha256Digest`
- `provenance_receipt_digest: Sha256Digest`
- `read_execution_journal_ref: OpaqueRef`
- `governed_read_source_ref: OpaqueRef`
- `observed_at: str`
- `state: Literal['found', 'not_found', 'unknown']`
- `provider_record_ref: OpaqueRef | None = None`
- `read_provider_output_sha256: Sha256Digest | None = None`
- `observed_effect_sha256: Sha256Digest | None = None`
- `evidence_refs: tuple[PrimitiveEvidenceRef, ...] = Field(min_length=1, max_length=20)`

### `lightbulb.finance_journal_lifecycle.ReconcileJournalPostInput`

class. Source: `lightbulb/finance_journal_lifecycle.py:1293`.

Fields:
- `schema_id: Literal['lightbulb.finance_journal_post_recovery_input.v2'] = Field(default=JOURNAL_POST_RECOVERY_INPUT_SCHEMA, alias='schema')`
- `provider: JournalProvider`
- `entry_ref: OpaqueRef`
- `post_receipt: PrimitiveOperationReceipt`
- `expected_provider_record_ref: OpaqueRef | None = None`
- `expected_effect_sha256: Sha256Digest | None = None`
- `readback: JournalPostReadback`

### `lightbulb.finance_journal_lifecycle.ReconcileJournalPostResult`

class. Source: `lightbulb/finance_journal_lifecycle.py:1462`.

Fields:
- `schema_id: Literal['lightbulb.finance_journal_post_recovery_result.v2'] = Field(default=JOURNAL_POST_RECOVERY_RESULT_SCHEMA, alias='schema')`
- `provider: JournalProvider`
- `entry_ref: OpaqueRef`
- `post_request_digest: Sha256Digest`
- `disposition: Literal['effect_confirmed_candidate', 'manual_reconciliation_required', 'readback_mismatch', 'evidence_insufficient']`
- `readback_matches: bool`
- `expected_provider_record_ref: OpaqueRef | None = None`
- `observed_provider_record_ref: OpaqueRef | None = None`
- `write_provider_output_sha256: Sha256Digest | None = None`
- `read_provider_output_sha256: Sha256Digest | None = None`
- `expected_effect_sha256: Sha256Digest | None = None`
- `observed_effect_sha256: Sha256Digest | None = None`
- `write_execution_journal_ref: OpaqueRef | None = None`
- `read_execution_journal_ref: OpaqueRef`
- `governed_read_source_ref: OpaqueRef`
- `write_tool_version: int | None = Field(default=None, ge=1)`
- `read_tool_version: int = Field(ge=1)`
- `write_project_id: UUID | None = None`
- `read_project_id: UUID`
- `write_tenant_connector_id: UUID | None = None`
- `read_tenant_connector_id: UUID`
- `write_connector_account_ref: OpaqueRef | None = None`
- `read_connector_account_ref: OpaqueRef`
- `write_route_digest: Sha256Digest | None = None`
- `read_route_digest: Sha256Digest`
- `write_provenance_receipt_digest: Sha256Digest | None = None`
- `read_provenance_receipt_digest: Sha256Digest`
- `spring_settlement_required: Literal[True] = True`
- `replay_permitted: Literal[False] = False`
- `recovery_plan: PrimitiveRecoveryPlan`
- `evidence_refs: tuple[PrimitiveEvidenceRef, ...] = Field(min_length=1, max_length=20)`
- `evaluation_digest: Sha256Digest`

### `lightbulb.finance_journal_lifecycle.prepare_journal_entry`

function. Source: `lightbulb/finance_journal_lifecycle.py:2289`.



~~~python
prepare_journal_entry(inputs: PrepareJournalEntryInput) -> JournalEntryPreparation
~~~


### `lightbulb.finance_journal_lifecycle.DiscoverLedgerAccountsPrimitive`

class. Source: `lightbulb/finance_journal_lifecycle.py:2603`.

### `lightbulb.finance_journal_lifecycle.DiscoverTrialBalancePrimitive`

class. Source: `lightbulb/finance_journal_lifecycle.py:2998`.

### `lightbulb.finance_journal_lifecycle.PrepareJournalEntryPrimitive`

class. Source: `lightbulb/finance_journal_lifecycle.py:3239`.

Fields:
- `example_inputs: Mapping[str, Any] = _prepare_example_inputs()`

### `lightbulb.finance_journal_lifecycle.PostJournalEntryPrimitive`

class. Source: `lightbulb/finance_journal_lifecycle.py:3305`.

Fields:
- `example_inputs: Mapping[str, Any] = _post_example_inputs()`

### `lightbulb.finance_journal_lifecycle.reconcile_journal_post`

function. Source: `lightbulb/finance_journal_lifecycle.py:3752`.



~~~python
reconcile_journal_post(inputs: ReconcileJournalPostInput) -> ReconcileJournalPostResult
~~~


Evaluate exact post/readback evidence without settling Spring authority.

### `lightbulb.finance_journal_lifecycle.ReconcileJournalPostPrimitive`

class. Source: `lightbulb/finance_journal_lifecycle.py:3885`.

Fields:
- `example_inputs: Mapping[str, Any] = _reconcile_example_inputs()`

## Module `lightbulb.finance_ledger_materialization`

Source-bound provider-neutral canonical ledger materialization.

### `lightbulb.finance_ledger_materialization.LedgerSnapshotMaterializationInput`

class. Source: `lightbulb/finance_ledger_materialization.py:69`.

Fields:
- `schema_id: Literal['lightbulb.ledger_snapshot_materialization_input.v2'] = Field(default=LEDGER_SNAPSHOT_MATERIALIZATION_INPUT_SCHEMA, alias='schema')`
- `snapshot_ref: OpaqueRef`
- `snapshot_revision: PositiveRevision`
- `scope: FinanceLedgerScope`
- `materialized_at: str`
- `account_discovery: LedgerAccountDiscoveryResult`
- `trial_balance_discovery: TrialBalanceDiscoveryResult`
- `source_observations: tuple[FinanceObservationEnvelope, ...] = Field(min_length=2, max_length=2)`

### `lightbulb.finance_ledger_materialization.LedgerSnapshotMaterializationResult`

class. Source: `lightbulb/finance_ledger_materialization.py:102`.

Fields:
- `schema_id: Literal['lightbulb.ledger_snapshot_materialization_result.v2'] = Field(default=LEDGER_SNAPSHOT_MATERIALIZATION_RESULT_SCHEMA, alias='schema')`
- `source_inputs: LedgerSnapshotMaterializationInput`
- `snapshot: CanonicalLedgerSnapshot`
- `source_read_binding_digest: Sha256Digest`
- `authority_state: Literal['governed_read_bound_structural_candidate'] = 'governed_read_bound_structural_candidate'`
- `provider_neutral: Literal[True] = True`
- `source_observations_evidence_bound: Literal[True] = True`
- `governed_read_results_bound: Literal[True] = True`
- `connector_operation_performed: Literal[False] = False`
- `persistence_authorized: Literal[False] = False`
- `posting_authorized: Literal[False] = False`

### `lightbulb.finance_ledger_materialization.materialize_ledger_snapshot`

function. Source: `lightbulb/finance_ledger_materialization.py:348`.



~~~python
materialize_ledger_snapshot(inputs: LedgerSnapshotMaterializationInput) -> LedgerSnapshotMaterializationResult
~~~


Return a self-verifying result with its sanitized governed source inputs.

### `lightbulb.finance_ledger_materialization.MaterializeLedgerSnapshotPrimitive`

class. Source: `lightbulb/finance_ledger_materialization.py:560`.

#### Methods

##### `lightbulb.finance_ledger_materialization.MaterializeLedgerSnapshotPrimitive.implementation_contract`



~~~python
def implementation_contract() -> dict[str, Any]
~~~


Source: `lightbulb/finance_ledger_materialization.py:585`.

## Module `lightbulb.finance_operating_controls`

Evidence-bound controls for finance operating subledgers.

### `lightbulb.finance_operating_controls.FinanceOperatingPolicy`

class. Source: `lightbulb/finance_operating_controls.py:371`.

Fields:
- `maximum_snapshot_age_hours: int = Field(default=168, ge=1, le=8760)`
- `minimum_cash_forecast_horizon_days: int = Field(default=13, ge=1, le=3650)`
- `minimum_liquidity_days: int = Field(default=30, ge=0, le=3650)`
- `maximum_subledger_gl_difference: Decimal = Field(default=Decimal('0'), ge=0)`
- `minimum_evidence_grade: PrimitiveEvidenceVerificationGrade = PrimitiveEvidenceVerificationGrade.ATTESTED`
- `required_evidence_kinds: tuple[str, ...] = Field(default=_REQUIRED_EVIDENCE_KINDS, min_length=1, max_length=30)`

### `lightbulb.finance_operating_controls.FinanceOperatingControlsInput`

class. Source: `lightbulb/finance_operating_controls.py:405`.

Fields:
- `schema_id: Literal['lightbulb.finance_operating_controls_input.v1'] = Field(default=FINANCE_OPERATING_CONTROLS_INPUT_SCHEMA, alias='schema')`
- `evaluation_ref: OpaqueRef`
- `company_ref: OpaqueRef`
- `period_ref: OpaqueRef`
- `currency: CurrencyCode`
- `evaluated_at: str`
- `planning: PlanningControlSnapshot`
- `treasury: TreasuryControlSnapshot`
- `expense: ExpenseControlSnapshot`
- `payroll: PayrollControlSnapshot`
- `tax: TaxControlSnapshot`
- `revenue_recognition: RevenueRecognitionControlSnapshot`
- `fixed_assets: FixedAssetControlSnapshot`
- `financial_controls: FinancialControlSnapshot`
- `policy: FinanceOperatingPolicy = Field(default_factory=FinanceOperatingPolicy)`
- `evidence_refs: tuple[PrimitiveEvidenceRef, ...] = Field(min_length=1, max_length=200)`

### `lightbulb.finance_operating_controls.FinanceOperatingControlsResult`

class. Source: `lightbulb/finance_operating_controls.py:489`.

Fields:
- `schema_id: Literal['lightbulb.finance_operating_controls_result.v1'] = Field(default=FINANCE_OPERATING_CONTROLS_RESULT_SCHEMA, alias='schema')`
- `evaluation_ref: OpaqueRef`
- `company_ref: OpaqueRef`
- `period_ref: OpaqueRef`
- `evaluated_at: str`
- `disposition: FinanceOperatingDisposition`
- `findings: tuple[FinanceOperatingFinding, ...]`
- `passed_count: int = Field(ge=0)`
- `failed_count: int = Field(ge=0)`
- `indeterminate_count: int = Field(ge=0)`
- `evidence_refs: tuple[PrimitiveEvidenceRef, ...]`
- `input_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `evidence_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `evaluation_digest: str = Field(default=_ZERO_DIGEST, pattern='^[0-9a-f]{64}$')`
- `operation_spec: PrimitiveOperationSpec`
- `budget_approved: Literal[False] = False`
- `cash_movement_authorized: Literal[False] = False`
- `expense_reimbursement_authorized: Literal[False] = False`
- `payroll_release_authorized: Literal[False] = False`
- `tax_filing_authorized: Literal[False] = False`
- `revenue_posting_authorized: Literal[False] = False`
- `asset_disposition_authorized: Literal[False] = False`
- `control_remediation_closed: Literal[False] = False`

### `lightbulb.finance_operating_controls.evaluate_finance_operating_controls`

function. Source: `lightbulb/finance_operating_controls.py:686`.



~~~python
evaluate_finance_operating_controls(inputs: FinanceOperatingControlsInput | dict[str, Any]) -> FinanceOperatingControlsResult
~~~


Evaluate a complete normalized finance operating-control packet.

### `lightbulb.finance_operating_controls.EvaluateFinanceOperatingControlsPrimitive`

class. Source: `lightbulb/finance_operating_controls.py:1134`.

#### Methods

##### `lightbulb.finance_operating_controls.EvaluateFinanceOperatingControlsPrimitive.implementation_contract`



~~~python
def implementation_contract() -> dict[str, Any]
~~~


Source: `lightbulb/finance_operating_controls.py:1158`.

## Module `lightbulb.finance_provider_period_status`

Governed provider lock-status evidence for the finance close lighthouse.

### `lightbulb.finance_provider_period_status.ProviderPeriodStatusInput`

class. Source: `lightbulb/finance_provider_period_status.py:171`.

Fields:
- `schema_id: Literal['lightbulb.finance_provider_period_status_input.v1'] = Field(default=PROVIDER_PERIOD_STATUS_INPUT_SCHEMA, alias='schema')`
- `provider: Provider`
- `start_date: str`
- `end_date: str`

### `lightbulb.finance_provider_period_status.ProviderPeriodLock`

class. Source: `lightbulb/finance_provider_period_status.py:186`.

Fields:
- `schema_id: Literal['lightbulb.finance_provider_period_lock.v1'] = Field(default=PROVIDER_PERIOD_LOCK_SCHEMA, alias='schema')`
- `lock_kind: LockKind`
- `through_date: str`

### `lightbulb.finance_provider_period_status.ProviderPeriodStatusResult`

class. Source: `lightbulb/finance_provider_period_status.py:206`.

Fields:
- `schema_id: Literal['lightbulb.finance_provider_period_status_result.v1'] = Field(default=PROVIDER_PERIOD_STATUS_RESULT_SCHEMA, alias='schema')`
- `provider: Provider`
- `tool: Literal['quickbooks.get_period_status', 'xero.get_period_status']`
- `tool_version: Literal[2] = PROVIDER_PERIOD_STATUS_TOOL_VERSION`
- `project_id: UUID`
- `tenant_connector_id: UUID`
- `connector_account_ref: OpaqueRef`
- `route_digest: Sha256Digest`
- `start_date: str`
- `end_date: str`
- `locks: tuple[ProviderPeriodLock, ...] = Field(max_length=2)`
- `period_relation: PeriodRelation`
- `source_revision_kind: Literal['sync_token', 'content_sha256']`
- `source_revision: str = Field(min_length=1, max_length=128)`
- `source_updated_at: str | None = None`
- `provider_observed_at: str`
- `provider_response_sha256: Sha256Digest`
- `execution_journal_ref: OpaqueRef`
- `provenance_receipt_digest: Sha256Digest`
- `execution_completed_at: str`
- `authoritative_read: Literal[True] = True`
- `bounded_observation: Literal[True] = True`
- `provider_lock_configuration_only: Literal[True] = True`
- `close_transition_authority: Literal[False] = False`
- `source_digest: Sha256Digest = '0' * 64`

### `lightbulb.finance_provider_period_status.DiscoverProviderPeriodStatusPrimitive`

class. Source: `lightbulb/finance_provider_period_status.py:506`.

## Module `lightbulb.finance_reconciliation`

Typed SDK contract for Spring-authoritative Stripe/ledger reconciliation.

### `lightbulb.finance_reconciliation.FinanceReconciliationRequest`

class. Source: `lightbulb/finance_reconciliation.py:148`.

Semantic request; the builder maps it to Spring's nullable booleans.

Fields:
- `schema_id: Literal['lightbulb.finance_reconciliation_request.v1'] = Field(default=FINANCE_RECONCILIATION_REQUEST_SCHEMA, alias='schema')`
- `ledger_provider: LedgerProviderRequest = 'auto'`
- `stripe_limit: int = Field(default=DEFAULT_STRIPE_LIMIT, ge=1, le=MAX_STRIPE_LIMIT)`
- `ledger_limit: int = Field(default=DEFAULT_LEDGER_LIMIT, ge=1, le=MAX_LEDGER_LIMIT)`
- `amount_tolerance: Decimal = Field(default=DEFAULT_AMOUNT_TOLERANCE, ge=0)`
- `include_details: bool = True`
- `simulation_mode: SimulationMode = 'auto'`
- `simulation_seed: int | None = Field(default=None, ge=_JAVA_INTEGER_MIN, le=_JAVA_INTEGER_MAX)`

### `lightbulb.finance_reconciliation.FinanceReconciliationParameters`

class. Source: `lightbulb/finance_reconciliation.py:189`.

Fields:
- `amount_tolerance: Decimal = Field(ge=0)`
- `include_details: bool`
- `simulate_mode: bool`
- `simulate_requested: bool`

### `lightbulb.finance_reconciliation.FinanceReconciliationCoverage`

class. Source: `lightbulb/finance_reconciliation.py:201`.

Fields:
- `stripe_invoice_count: int = Field(ge=0, le=MAX_STRIPE_LIMIT)`
- `ledger_invoice_count: int = Field(ge=0, le=MAX_LEDGER_LIMIT)`
- `matched_count: int = Field(ge=0, le=MAX_STRIPE_LIMIT)`
- `unmatched_stripe_count: int = Field(ge=0, le=MAX_STRIPE_LIMIT)`
- `unmatched_ledger_count: int = Field(ge=0, le=MAX_LEDGER_LIMIT)`

### `lightbulb.finance_reconciliation.FinanceReconciliationTotals`

class. Source: `lightbulb/finance_reconciliation.py:239`.

Fields:
- `stripe_total: Decimal`
- `ledger_total: Decimal`
- `stripe_paid_total: Decimal`
- `ledger_paid_total: Decimal`
- `gross_delta: Decimal`
- `paid_delta: Decimal`

### `lightbulb.finance_reconciliation.FinanceReconciliationControlSummary`

class. Source: `lightbulb/finance_reconciliation.py:271`.

Fields:
- `match_rate: Decimal = Field(ge=0, le=1)`
- `amount_mismatch_count: int = Field(ge=0, le=MAX_STRIPE_LIMIT)`
- `status_mismatch_count: int = Field(ge=0, le=MAX_STRIPE_LIMIT)`

### `lightbulb.finance_reconciliation.FinanceReconciliationInvoice`

class. Source: `lightbulb/finance_reconciliation.py:282`.

Fields:
- `provider: Literal['stripe', 'quickbooks', 'xero']`
- `invoice_id: ProviderReference | None = None`
- `invoice_number: ProviderReference | None = None`
- `customer_ref: ProviderReference | None = None`
- `customer_name: ProviderReference | None = None`
- `status: ShortText | None = None`
- `total: Decimal`
- `paid: Decimal`
- `balance: Decimal`
- `currency: Annotated[str, StringConstraints(max_length=16)] | None = None`
- `issued_at: DateText | None = None`
- `due_at: DateText | None = None`

### `lightbulb.finance_reconciliation.FinanceReconciliationMatch`

class. Source: `lightbulb/finance_reconciliation.py:302`.

Fields:
- `match_basis: Literal['invoice_number', 'amount_date']`
- `stripe_invoice: FinanceReconciliationInvoice`
- `ledger_invoice: FinanceReconciliationInvoice`
- `delta_total: Decimal`
- `delta_paid: Decimal`
- `delta_balance: Decimal`
- `stripe_status: ShortText`
- `ledger_status: ShortText`
- `amount_mismatch: bool`
- `status_mismatch: bool`

### `lightbulb.finance_reconciliation.FinanceReconciliationExceptions`

class. Source: `lightbulb/finance_reconciliation.py:320`.

Fields:
- `missing_in_ledger: tuple[FinanceReconciliationInvoice, ...] = Field(default_factory=tuple, max_length=MAX_STRIPE_LIMIT)`
- `missing_in_stripe: tuple[FinanceReconciliationInvoice, ...] = Field(default_factory=tuple, max_length=MAX_LEDGER_LIMIT)`
- `amount_mismatches: tuple[FinanceReconciliationMatch, ...] = Field(default_factory=tuple, max_length=MAX_STRIPE_LIMIT)`
- `status_mismatches: tuple[FinanceReconciliationMatch, ...] = Field(default_factory=tuple, max_length=MAX_STRIPE_LIMIT)`

### `lightbulb.finance_reconciliation.FinanceReconciliationProposedAction`

class. Source: `lightbulb/finance_reconciliation.py:350`.

Fields:
- `priority: Literal['high', 'medium', 'low']`
- `action: Annotated[str, StringConstraints(min_length=1, max_length=160)]`
- `count: int = Field(ge=0, le=MAX_LEDGER_LIMIT)`
- `description: BoundedText`

### `lightbulb.finance_reconciliation.FinanceReconciliationResult`

class. Source: `lightbulb/finance_reconciliation.py:357`.

A parsed Spring result with an SDK-derived, non-inflating authority label.

Fields:
- `schema_id: Literal['lightbulb.finance_reconciliation_result.v1'] = Field(default=FINANCE_RECONCILIATION_RESULT_SCHEMA, alias='schema')`
- `run_id: UUID | None = None`
- `status: Literal['completed']`
- `generated_at: datetime`
- `workflow: Literal['stripe_ledger_reconciliation']`
- `ledger_provider: LedgerProvider`
- `parameters: FinanceReconciliationParameters`
- `simulation_mode: bool`
- `simulation_reason: BoundedText | None = None`
- `warning: BoundedText | None = None`
- `coverage: FinanceReconciliationCoverage`
- `totals: FinanceReconciliationTotals`
- `reconciliation: FinanceReconciliationControlSummary`
- `exceptions: FinanceReconciliationExceptions`
- `matches: tuple[FinanceReconciliationMatch, ...] = Field(max_length=MAX_STRIPE_LIMIT)`
- `proposed_actions: tuple[FinanceReconciliationProposedAction, ...] = Field(min_length=1, max_length=5)`
- `server_authoritativeness: ServerAuthoritativeness | None = Field(default=None, alias='authoritativeness')`
- `authority_level: AuthorityLevel`
- `response_digest: str = Field(default=_ZERO_DIGEST, pattern=_SHA256_PATTERN)`

#### Methods

##### `lightbulb.finance_reconciliation.FinanceReconciliationResult.control_summary`



~~~python
@property
def control_summary() -> FinanceReconciliationControlSummary
~~~


Business-name alias for Spring's ``reconciliation`` section.

Source: `lightbulb/finance_reconciliation.py:497`.

##### `lightbulb.finance_reconciliation.FinanceReconciliationResult.counts`



~~~python
@property
def counts() -> FinanceReconciliationCoverage
~~~


Business-name alias for Spring's ``coverage`` section.

Source: `lightbulb/finance_reconciliation.py:491`.

##### `lightbulb.finance_reconciliation.FinanceReconciliationResult.to_dict`



~~~python
def to_dict() -> dict[str, Any]
~~~


Source: `lightbulb/finance_reconciliation.py:502`.

### `lightbulb.finance_reconciliation.FinanceReconciliationStoredRequest`

class. Source: `lightbulb/finance_reconciliation.py:506`.

The exact nullable request record persisted by Spring for one run.

Fields:
- `ledger_provider: ShortText | None`
- `stripe_limit: int | None = Field(default=None, ge=_JAVA_INTEGER_MIN, le=_JAVA_INTEGER_MAX)`
- `ledger_limit: int | None = Field(default=None, ge=_JAVA_INTEGER_MIN, le=_JAVA_INTEGER_MAX)`
- `amount_tolerance: Decimal | None = None`
- `include_details: bool | None`
- `simulate_mode: bool | None`
- `simulation_seed: int | None = Field(default=None, ge=_JAVA_INTEGER_MIN, le=_JAVA_INTEGER_MAX)`

### `lightbulb.finance_reconciliation.FinanceReconciliationCompletedRunSummary`

class. Source: `lightbulb/finance_reconciliation.py:537`.

Fields:
- `status: Literal['completed']`
- `ledger_provider: LedgerProvider`
- `generated_at: datetime`
- `started_at: datetime`
- `matched_count: int = Field(ge=0, le=MAX_STRIPE_LIMIT)`
- `unmatched_stripe_count: int = Field(ge=0, le=MAX_STRIPE_LIMIT)`
- `unmatched_ledger_count: int = Field(ge=0, le=MAX_LEDGER_LIMIT)`
- `match_rate: Decimal = Field(ge=0, le=1)`
- `amount_mismatch_count: int = Field(ge=0, le=MAX_STRIPE_LIMIT)`
- `status_mismatch_count: int = Field(ge=0, le=MAX_STRIPE_LIMIT)`
- `simulation_mode: bool`
- `simulation_reason: BoundedText`

### `lightbulb.finance_reconciliation.FinanceReconciliationFailedRunSummary`

class. Source: `lightbulb/finance_reconciliation.py:568`.

Fields:
- `status: Literal['failed']`
- `generated_at: datetime`

### `lightbulb.finance_reconciliation.FinanceReconciliationStoredFailure`

class. Source: `lightbulb/finance_reconciliation.py:584`.

Fields:
- `status: Literal['failed']`
- `error: BoundedText`

### `lightbulb.finance_reconciliation.FinanceReconciliationRunSummary`

class. Source: `lightbulb/finance_reconciliation.py:589`.

A strict row returned by Spring's reconciliation run-list route.

Fields:
- `schema_id: Literal['lightbulb.finance_reconciliation_run_summary.v1'] = Field(default=FINANCE_RECONCILIATION_RUN_SUMMARY_SCHEMA, alias='schema')`
- `run_id: UUID`
- `status: ReconciliationStatus`
- `workflow_type: Literal['finance_stripe_ledger_reconciliation']`
- `ledger_provider: ShortText | None`
- `created_at: datetime`
- `updated_at: datetime`
- `matched_count: int = Field(ge=0, le=MAX_STRIPE_LIMIT)`
- `unmatched_stripe_count: int = Field(ge=0, le=MAX_STRIPE_LIMIT)`
- `unmatched_ledger_count: int = Field(ge=0, le=MAX_LEDGER_LIMIT)`
- `match_rate: Decimal = Field(ge=0, le=1)`
- `amount_mismatch_count: int = Field(ge=0, le=MAX_STRIPE_LIMIT)`
- `status_mismatch_count: int = Field(ge=0, le=MAX_STRIPE_LIMIT)`
- `simulation_mode: bool`
- `simulation_reason: BoundedText`
- `error_message: BoundedText | None = None`

#### Methods

##### `lightbulb.finance_reconciliation.FinanceReconciliationRunSummary.authority_level`



~~~python
@property
def authority_level() -> AuthorityLevel
~~~


Source: `lightbulb/finance_reconciliation.py:644`.

##### `lightbulb.finance_reconciliation.FinanceReconciliationRunSummary.to_dict`



~~~python
def to_dict() -> dict[str, Any]
~~~


Source: `lightbulb/finance_reconciliation.py:649`.

### `lightbulb.finance_reconciliation.FinanceReconciliationRunDetails`

class. Source: `lightbulb/finance_reconciliation.py:653`.

The Spring-owned stored request, summary, and normalized run result.

Fields:
- `schema_id: Literal['lightbulb.finance_reconciliation_run_details.v1'] = Field(default=FINANCE_RECONCILIATION_RUN_DETAILS_SCHEMA, alias='schema')`
- `run_id: UUID`
- `status: ReconciliationStatus`
- `ledger_provider: ShortText | None`
- `error_message: BoundedText | None = None`
- `created_at: datetime`
- `updated_at: datetime`
- `request: FinanceReconciliationStoredRequest`
- `summary: FinanceReconciliationStoredSummary`
- `result: FinanceReconciliationResult | FinanceReconciliationStoredFailure`

#### Methods

##### `lightbulb.finance_reconciliation.FinanceReconciliationRunDetails.authority_level`



~~~python
@property
def authority_level() -> AuthorityLevel
~~~


Source: `lightbulb/finance_reconciliation.py:766`.

##### `lightbulb.finance_reconciliation.FinanceReconciliationRunDetails.to_dict`



~~~python
def to_dict() -> dict[str, Any]
~~~


Source: `lightbulb/finance_reconciliation.py:771`.

### `lightbulb.finance_reconciliation.build_finance_reconciliation_request`

function. Source: `lightbulb/finance_reconciliation.py:775`.



~~~python
build_finance_reconciliation_request(request: FinanceReconciliationRequest | Mapping[str, Any] | None=None, /, **request_fields: Any) -> dict[str, Any]
~~~


Build the exact JSON-ready body for Spring's reconciliation endpoint.

### `lightbulb.finance_reconciliation.parse_finance_reconciliation_result`

function. Source: `lightbulb/finance_reconciliation.py:821`.



~~~python
parse_finance_reconciliation_result(response: Mapping[str, Any]) -> FinanceReconciliationResult
~~~


Strictly parse a Spring response and derive a non-inflating authority.

### `lightbulb.finance_reconciliation.parse_finance_reconciliation_run_summaries`

function. Source: `lightbulb/finance_reconciliation.py:862`.



~~~python
parse_finance_reconciliation_run_summaries(response: Sequence[Mapping[str, Any]]) -> tuple[FinanceReconciliationRunSummary, ...]
~~~


Strictly parse the bounded list returned by Spring's ``/runs`` route.

### `lightbulb.finance_reconciliation.parse_finance_reconciliation_run_details`

function. Source: `lightbulb/finance_reconciliation.py:882`.



~~~python
parse_finance_reconciliation_run_details(response: Mapping[str, Any]) -> FinanceReconciliationRunDetails
~~~


Strictly parse one exact-scope Spring reconciliation run envelope.

## Module `lightbulb.finance_reconciliation_package`

Prepare a structural period-close ReconciliationPackage candidate.

### `lightbulb.finance_reconciliation_package.PrepareReconciliationPackageInput`

class. Source: `lightbulb/finance_reconciliation_package.py:125`.

Fields:
- `schema_id: Literal['lightbulb.finance_reconciliation_package_candidate_input.v1'] = Field(default=RECONCILIATION_PACKAGE_CANDIDATE_INPUT_SCHEMA, alias='schema')`
- `workspace: FinanceCloseWorkspace`
- `readiness: CloseReconciliationReadinessResult`
- `reconciliation_set_ref: OpaqueRef`
- `evidence_use_refs: tuple[OpaqueRef, OpaqueRef]`
- `account_reconciliations: tuple[AccountReconciliationRecord, ...] = Field(min_length=2, max_length=5000)`
- `subledger_reconciliations: tuple[SubledgerReconciliationRecord, ...] = Field(min_length=1, max_length=100)`
- `review_completed_at: str`

### `lightbulb.finance_reconciliation_package.ReconciliationPackageCandidateResult`

class. Source: `lightbulb/finance_reconciliation_package.py:203`.

Fields:
- `schema_id: Literal['lightbulb.finance_reconciliation_package_candidate_result.v1'] = Field(default=RECONCILIATION_PACKAGE_CANDIDATE_RESULT_SCHEMA, alias='schema')`
- `workspace_ref: OpaqueRef`
- `workspace_revision: int = Field(ge=1)`
- `workspace_digest: Sha256Digest`
- `readiness_result_digest: Sha256Digest`
- `settlement_result_digest: Sha256Digest`
- `lifecycle_state_digest: Sha256Digest`
- `package: ReconciliationPackage`
- `package_digest: Sha256Digest`
- `candidate_digest: Sha256Digest = _ZERO_DIGEST`
- `reviewer_identity_state: Literal['spring_revalidation_required'] = 'spring_revalidation_required'`
- `evidence_custody_state: Literal['spring_retention_required'] = 'spring_retention_required'`
- `reconciliation_package_authority: Literal[False] = False`
- `lifecycle_transition_authority: Literal[False] = False`
- `persistence_authorized: Literal[False] = False`

#### Methods

##### `lightbulb.finance_reconciliation_package.ReconciliationPackageCandidateResult.digest_payload`



~~~python
def digest_payload() -> dict[str, Any]
~~~


Source: `lightbulb/finance_reconciliation_package.py:226`.

### `lightbulb.finance_reconciliation_package.prepare_reconciliation_package`

function. Source: `lightbulb/finance_reconciliation_package.py:246`.



~~~python
prepare_reconciliation_package(inputs: PrepareReconciliationPackageInput) -> ReconciliationPackageCandidateResult
~~~


### `lightbulb.finance_reconciliation_package.PrepareReconciliationPackagePrimitive`

class. Source: `lightbulb/finance_reconciliation_package.py:414`.

#### Methods

##### `lightbulb.finance_reconciliation_package.PrepareReconciliationPackagePrimitive.implementation_contract`



~~~python
def implementation_contract() -> dict[str, Any]
~~~


Source: `lightbulb/finance_reconciliation_package.py:439`.

## Module `lightbulb.finance_reconciliation_transition`

Prepare an evidence-bound ``reconcile_accounts`` transition command.

### `lightbulb.finance_reconciliation_transition.ReconciliationArtifactEvidenceClaim`

class. Source: `lightbulb/finance_reconciliation_transition.py:135`.

Fields:
- `use_ref: OpaqueRef`
- `artifact_ref: OpaqueRef`
- `artifact_digest: Sha256Digest`
- `evidence_ref: OpaqueRef`
- `kind: Literal['account_subledger_reconciliations'] = _ARTIFACT_KIND`
- `issuer_ref: OpaqueRef`
- `observed_at: str`
- `effective_at: str`
- `retained_until: str`
- `verification_grade: Literal['attested', 'verified'] = 'attested'`
- `classification: Literal['internal', 'confidential', 'restricted'] = 'restricted'`

### `lightbulb.finance_reconciliation_transition.ReconciliationReviewEvidenceClaim`

class. Source: `lightbulb/finance_reconciliation_transition.py:154`.

Fields:
- `use_ref: OpaqueRef`
- `artifact_ref: OpaqueRef`
- `artifact_digest: Sha256Digest`
- `evidence_ref: OpaqueRef`
- `kind: Literal['reconciliation_review_attestation'] = _REVIEW_KIND`
- `issuer_ref: OpaqueRef`
- `observed_at: str`
- `effective_at: str`
- `retained_until: str`
- `verification_grade: Literal['verified'] = 'verified'`
- `classification: Literal['internal', 'confidential', 'restricted'] = 'restricted'`

### `lightbulb.finance_reconciliation_transition.PrepareReconciliationTransitionCommandInput`

class. Source: `lightbulb/finance_reconciliation_transition.py:173`.

Fields:
- `schema_id: Literal['lightbulb.finance_reconciliation_transition_command_input.v1'] = Field(default=RECONCILIATION_TRANSITION_COMMAND_INPUT_SCHEMA, alias='schema')`
- `workspace: FinanceCloseWorkspace`
- `package_candidate: ReconciliationPackageCandidateResult`
- `lifecycle_snapshot: PeriodCloseLifecycleSnapshot`
- `transition_ref: OpaqueRef`
- `idempotency_key: OpaqueRef`
- `occurred_at: str`
- `requested_by_ref: OpaqueRef`
- `artifact_evidence: ReconciliationArtifactEvidenceClaim`
- `review_evidence: ReconciliationReviewEvidenceClaim`

### `lightbulb.finance_reconciliation_transition.ReconciliationTransitionCommandResult`

class. Source: `lightbulb/finance_reconciliation_transition.py:279`.

Fields:
- `schema_id: Literal['lightbulb.finance_reconciliation_transition_command_result.v1'] = Field(default=RECONCILIATION_TRANSITION_COMMAND_RESULT_SCHEMA, alias='schema')`
- `workspace_ref: OpaqueRef`
- `workspace_revision: int = Field(ge=1)`
- `workspace_digest: Sha256Digest`
- `package_candidate_digest: Sha256Digest`
- `lifecycle_version: Literal[2] = 2`
- `lifecycle_state_digest: Sha256Digest`
- `lifecycle_input: PeriodCloseLifecycleInput`
- `command_content_digest: Sha256Digest`
- `command_request_digest: Sha256Digest`
- `evidence_lineage_tail_digest: Sha256Digest`
- `result_digest: Sha256Digest = _ZERO_DIGEST`
- `evidence_authentication_state: Literal['spring_revalidation_required'] = 'spring_revalidation_required'`
- `evidence_custody_state: Literal['spring_retention_required'] = 'spring_retention_required'`
- `lifecycle_transition_authority: Literal[False] = False`
- `persistence_authorized: Literal[False] = False`
- `provider_calls_authorized: Literal[False] = False`

#### Methods

##### `lightbulb.finance_reconciliation_transition.ReconciliationTransitionCommandResult.digest_payload`



~~~python
def digest_payload() -> dict[str, Any]
~~~


Source: `lightbulb/finance_reconciliation_transition.py:304`.

### `lightbulb.finance_reconciliation_transition.prepare_reconciliation_transition_command`

function. Source: `lightbulb/finance_reconciliation_transition.py:368`.



~~~python
prepare_reconciliation_transition_command(inputs: PrepareReconciliationTransitionCommandInput) -> ReconciliationTransitionCommandResult
~~~


### `lightbulb.finance_reconciliation_transition.PrepareReconciliationTransitionCommandPrimitive`

class. Source: `lightbulb/finance_reconciliation_transition.py:618`.

#### Methods

##### `lightbulb.finance_reconciliation_transition.PrepareReconciliationTransitionCommandPrimitive.implementation_contract`



~~~python
def implementation_contract() -> dict[str, Any]
~~~


Source: `lightbulb/finance_reconciliation_transition.py:643`.

## Module `lightbulb.finance_settlement_reconciliation`

Deterministic Stripe settlement-to-ledger reconciliation candidates.

### `lightbulb.finance_settlement_reconciliation.StripeLedgerReconciliationInput`

class. Source: `lightbulb/finance_settlement_reconciliation.py:186`.

Fields:
- `schema_id: Literal['lightbulb.finance_stripe_ledger_reconciliation_input.v1'] = Field(default=STRIPE_LEDGER_RECONCILIATION_INPUT_SCHEMA, alias='schema')`
- `workspace: FinanceCloseWorkspace`
- `stripe_observation: StripeSettlementObservationResult`
- `ledger_observation: GeneralLedgerActivityObservation`
- `reconciled_at: str`
- `minor_unit_exponent: int = Field(default=2, ge=0, le=_MAX_MINOR_UNIT_EXPONENT)`
- `settlement_date_tolerance_days: int = Field(default=7, ge=0, le=_MAX_DATE_TOLERANCE_DAYS)`

### `lightbulb.finance_settlement_reconciliation.StripeLedgerReconciliationMatch`

class. Source: `lightbulb/finance_settlement_reconciliation.py:282`.

Fields:
- `schema_id: Literal['lightbulb.finance_stripe_ledger_reconciliation_match.v1'] = Field(default=STRIPE_LEDGER_RECONCILIATION_MATCH_SCHEMA, alias='schema')`
- `match_ref: Sha256Digest`
- `payout_ref: OpaqueRef`
- `stripe_transaction_ref: OpaqueRef`
- `ledger_line_ref: Sha256Digest`
- `match_basis: Literal['payout_reference_amount_and_date'] = 'payout_reference_amount_and_date'`
- `expected_amount: Decimal = Field(ge=0)`
- `ledger_amount: Decimal = Field(ge=0)`
- `amount_delta: Decimal`
- `settlement_date: str`
- `ledger_date: str`
- `date_delta_days: int = Field(ge=0, le=_MAX_DATE_TOLERANCE_DAYS)`

### `lightbulb.finance_settlement_reconciliation.StripeLedgerReconciliationException`

class. Source: `lightbulb/finance_settlement_reconciliation.py:349`.

Fields:
- `schema_id: Literal['lightbulb.finance_stripe_ledger_reconciliation_exception.v1'] = Field(default=STRIPE_LEDGER_RECONCILIATION_EXCEPTION_SCHEMA, alias='schema')`
- `exception_ref: Sha256Digest`
- `kind: ReconciliationExceptionKind`
- `payout_ref: OpaqueRef | None = None`
- `stripe_transaction_refs: tuple[OpaqueRef, ...] = Field(max_length=_MAX_PAYOUTS)`
- `ledger_line_refs: tuple[Sha256Digest, ...] = Field(max_length=_MAX_LEDGER_LINES)`
- `expected_amount: Decimal | None = None`
- `ledger_amount: Decimal | None = None`
- `amount_delta: Decimal | None = None`
- `settlement_date: str | None = None`
- `ledger_date: str | None = None`
- `age_days: int = Field(ge=0, le=36600)`
- `material: bool`

### `lightbulb.finance_settlement_reconciliation.StripeLedgerMatchProposal`

class. Source: `lightbulb/finance_settlement_reconciliation.py:420`.

Fields:
- `proposal_ref: Sha256Digest`
- `payout_ref: OpaqueRef`
- `stripe_transaction_ref: OpaqueRef`
- `ledger_line_ref: Sha256Digest`
- `proposal_basis: Literal['unique_exact_amount_within_date_window'] = 'unique_exact_amount_within_date_window'`
- `expected_amount: Decimal = Field(ge=0)`
- `ledger_amount: Decimal = Field(ge=0)`
- `settlement_date: str`
- `ledger_date: str`
- `date_delta_days: int = Field(ge=0, le=_MAX_DATE_TOLERANCE_DAYS)`
- `automatic_match_authorized: Literal[False] = False`
- `human_review_required: Literal[True] = True`

### `lightbulb.finance_settlement_reconciliation.StripeLedgerReconciliationSummary`

class. Source: `lightbulb/finance_settlement_reconciliation.py:460`.

Fields:
- `payout_count: int = Field(ge=0, le=_MAX_PAYOUTS)`
- `referenced_ledger_line_count: int = Field(ge=0, le=_MAX_LEDGER_LINES)`
- `matched_count: int = Field(ge=0, le=_MAX_PAYOUTS)`
- `proposed_match_count: int = Field(ge=0, le=_MAX_PAYOUTS)`
- `unresolved_exception_count: int = Field(ge=0, le=_MAX_PAYOUTS + _MAX_LEDGER_LINES)`
- `material_exception_count: int = Field(ge=0, le=_MAX_PAYOUTS + _MAX_LEDGER_LINES)`
- `unreferenced_control_account_line_count: int = Field(ge=0, le=_MAX_LEDGER_LINES)`
- `stripe_payout_total: Decimal = Field(ge=0)`
- `referenced_ledger_total: Decimal`
- `matched_total: Decimal = Field(ge=0)`
- `unexplained_variance: Decimal`
- `match_coverage: Decimal = Field(ge=0, le=1)`
- `oldest_unresolved_exception_age_days: int = Field(ge=0, le=36600)`
- `close_reconciliation_ready: bool`

### `lightbulb.finance_settlement_reconciliation.StripeLedgerReconciliationResult`

class. Source: `lightbulb/finance_settlement_reconciliation.py:526`.

Fields:
- `schema_id: Literal['lightbulb.finance_stripe_ledger_reconciliation_result.v1'] = Field(default=STRIPE_LEDGER_RECONCILIATION_RESULT_SCHEMA, alias='schema')`
- `workspace_ref: OpaqueRef`
- `workspace_revision: int = Field(ge=1)`
- `workspace_digest: Sha256Digest`
- `stripe_subledger_ref: OpaqueRef`
- `control_account_ref: OpaqueRef`
- `ledger_provider: Literal['quickbooks', 'xero']`
- `start_date: str`
- `end_date: str`
- `currency: str = Field(pattern='^[A-Z]{3}$')`
- `reconciled_at: str`
- `stripe_source_digest: Sha256Digest`
- `ledger_source_digest: Sha256Digest`
- `matches: tuple[StripeLedgerReconciliationMatch, ...] = Field(max_length=_MAX_PAYOUTS)`
- `proposed_matches: tuple[StripeLedgerMatchProposal, ...] = Field(max_length=_MAX_PAYOUTS)`
- `exceptions: tuple[StripeLedgerReconciliationException, ...] = Field(max_length=_MAX_PAYOUTS + _MAX_LEDGER_LINES)`
- `summary: StripeLedgerReconciliationSummary`
- `connector_operation_performed: Literal[False] = False`
- `authority_state: Literal['structural_candidate_only'] = 'structural_candidate_only'`
- `reconciliation_authority: Literal[False] = False`
- `exception_disposition_authority: Literal[False] = False`
- `close_transition_authority: Literal[False] = False`
- `result_digest: Sha256Digest = _ZERO_DIGEST`

#### Methods

##### `lightbulb.finance_settlement_reconciliation.StripeLedgerReconciliationResult.digest_payload`



~~~python
def digest_payload() -> dict[str, Any]
~~~


Source: `lightbulb/finance_settlement_reconciliation.py:569`.

### `lightbulb.finance_settlement_reconciliation.reconcile_stripe_settlements`

function. Source: `lightbulb/finance_settlement_reconciliation.py:725`.



~~~python
reconcile_stripe_settlements(inputs: StripeLedgerReconciliationInput) -> StripeLedgerReconciliationResult
~~~


### `lightbulb.finance_settlement_reconciliation.ReconcileStripeSettlementsPrimitive`

class. Source: `lightbulb/finance_settlement_reconciliation.py:1166`.

#### Methods

##### `lightbulb.finance_settlement_reconciliation.ReconcileStripeSettlementsPrimitive.implementation_contract`



~~~python
def implementation_contract() -> dict[str, Any]
~~~


Source: `lightbulb/finance_settlement_reconciliation.py:1191`.

## Module `lightbulb.finance_source_records`

Provider-neutral, fixture-safe finance source record contracts.

### `lightbulb.finance_source_records.finance_canonical_json`

function. Source: `lightbulb/finance_source_records.py:142`.



~~~python
finance_canonical_json(value: Any) -> bytes
~~~


Serialize supported finance values into deterministic JSON bytes.

### `lightbulb.finance_source_records.finance_canonical_digest`

function. Source: `lightbulb/finance_source_records.py:154`.



~~~python
finance_canonical_digest(value: Any) -> str
~~~


Return the lowercase SHA-256 digest of canonical finance JSON.

### `lightbulb.finance_source_records.FinanceLedgerScope`

class. Source: `lightbulb/finance_source_records.py:260`.

Exact caller-supplied scope candidate; never an authorization grant.

Fields:
- `schema_id: Literal['lightbulb.finance_ledger_scope.v1'] = Field(default=FINANCE_LEDGER_SCOPE_SCHEMA, alias='schema')`
- `tenant_ref: OpaqueRef`
- `company_ref: OpaqueRef`
- `project_ref: OpaqueRef`
- `legal_entity_ref: OpaqueRef`
- `ledger_ref: OpaqueRef`
- `functional_currency: CurrencyCode`
- `fiscal_period_ref: OpaqueRef`
- `period_revision: PositiveRevision`
- `period_status: PeriodStatus`
- `period_started_at: str`
- `period_ended_at: str`
- `jurisdiction_ref: OpaqueRef`
- `classification: EvidenceClassification`
- `retention_policy_ref: OpaqueRef`
- `required_retained_until: str`

### `lightbulb.finance_source_records.FinanceSourceIdentity`

class. Source: `lightbulb/finance_source_records.py:300`.

Provider details confined to source provenance, outside canonical facts.

Fields:
- `schema_id: Literal['lightbulb.finance_source_identity.v1'] = Field(default=FINANCE_SOURCE_IDENTITY_SCHEMA, alias='schema')`
- `dataset: FinanceDataset`
- `provider: ProviderSlug`
- `tool: ToolName`
- `tool_version: PositiveRevision`
- `tenant_connector_ref: OpaqueRef`
- `connector_account_ref: OpaqueRef`
- `provider_account_ref: OpaqueRef`
- `route_ref: OpaqueRef`
- `execution_journal_ref: OpaqueRef`

### `lightbulb.finance_source_records.FinanceSourceCheckpoint`

class. Source: `lightbulb/finance_source_records.py:324`.

Bounded proof that every page in one source observation was consumed.

Fields:
- `schema_id: Literal['lightbulb.finance_source_checkpoint.v1'] = Field(default=FINANCE_SOURCE_CHECKPOINT_SCHEMA, alias='schema')`
- `cursor_kind: CursorKind`
- `initial_cursor: OpaqueCursor | None = None`
- `terminal_cursor: OpaqueCursor | None = None`
- `next_cursor: OpaqueCursor | None = None`
- `page_count: PositivePageCount`
- `record_count: NonnegativeCount`
- `provider_total_count: NonnegativeCount | None = None`
- `provider_revision: OpaqueCursor | None = None`
- `complete: StrictTrue`
- `page_digests: tuple[Sha256Digest, ...] = Field(min_length=1, max_length=10000)`

### `lightbulb.finance_source_records.FinanceObservationEnvelope`

class. Source: `lightbulb/finance_source_records.py:371`.

A content-bound source observation candidate with retained evidence refs.

Fields:
- `schema_id: Literal['lightbulb.finance_observation_envelope.v1'] = Field(default=FINANCE_OBSERVATION_ENVELOPE_SCHEMA, alias='schema')`
- `observation_ref: OpaqueRef`
- `observation_revision: PositiveRevision`
- `source: FinanceSourceIdentity`
- `scope: FinanceLedgerScope`
- `checkpoint: FinanceSourceCheckpoint`
- `observed_at: str`
- `effective_at: str`
- `freshness_class: FreshnessClass`
- `fresh_until: str`
- `retained_until: str`
- `evidence_refs: tuple[PrimitiveEvidenceRef, ...] = Field(min_length=1, max_length=100)`
- `source_payload_digest: Sha256Digest = _ZERO_DIGEST`
- `content_digest: Sha256Digest = _ZERO_DIGEST`
- `evidence_digest: Sha256Digest = _ZERO_DIGEST`

#### Methods

##### `lightbulb.finance_source_records.FinanceObservationEnvelope.content_digest_payload`



~~~python
def content_digest_payload() -> dict[str, Any]
~~~


Source: `lightbulb/finance_source_records.py:430`.

##### `lightbulb.finance_source_records.FinanceObservationEnvelope.evidence_digest_payload`



~~~python
def evidence_digest_payload() -> dict[str, Any]
~~~


Source: `lightbulb/finance_source_records.py:445`.

##### `lightbulb.finance_source_records.FinanceObservationEnvelope.source_payload_digest_payload`



~~~python
def source_payload_digest_payload() -> dict[str, Any]
~~~


Source: `lightbulb/finance_source_records.py:422`.

### `lightbulb.finance_source_records.CanonicalLedgerAccount`

class. Source: `lightbulb/finance_source_records.py:509`.

Provider-neutral ledger account fact.

Fields:
- `schema_id: Literal['lightbulb.canonical_ledger_account.v1'] = Field(default=CANONICAL_LEDGER_ACCOUNT_SCHEMA, alias='schema')`
- `account_ref: OpaqueRef`
- `account_code: BoundedText | None = None`
- `account_name: BoundedText`
- `account_class: AccountClass`
- `currency: CurrencyCode`
- `active: StrictBool`

### `lightbulb.finance_source_records.CanonicalTrialBalanceLine`

class. Source: `lightbulb/finance_source_records.py:524`.

One exact, one-sided provider-neutral trial-balance line.

Fields:
- `schema_id: Literal['lightbulb.canonical_trial_balance_line.v1'] = Field(default=CANONICAL_TRIAL_BALANCE_LINE_SCHEMA, alias='schema')`
- `account_ref: OpaqueRef`
- `account_class: AccountClass`
- `currency: CurrencyCode`
- `debit: Money`
- `credit: Money`

### `lightbulb.finance_source_records.CanonicalLedgerSnapshot`

class. Source: `lightbulb/finance_source_records.py:544`.

A sealed fixture representation, not a certified or authoritative read.

Fields:
- `schema_id: Literal['lightbulb.canonical_ledger_snapshot.v1'] = Field(default=CANONICAL_LEDGER_SNAPSHOT_SCHEMA, alias='schema')`
- `snapshot_ref: OpaqueRef`
- `snapshot_revision: PositiveRevision`
- `scope: FinanceLedgerScope`
- `as_of: str`
- `materialized_at: str`
- `source_observations: tuple[FinanceObservationEnvelope, ...] = Field(min_length=2, max_length=20)`
- `accounts: tuple[CanonicalLedgerAccount, ...] = Field(min_length=2, max_length=5000)`
- `trial_balance_lines: tuple[CanonicalTrialBalanceLine, ...] = Field(min_length=2, max_length=5000)`
- `total_debit: Money`
- `total_credit: Money`
- `content_digest: Sha256Digest = _ZERO_DIGEST`
- `evidence_digest: Sha256Digest = _ZERO_DIGEST`
- `materialization_idempotency_digest: Sha256Digest = _ZERO_DIGEST`
- `artifact_digest: Sha256Digest = _ZERO_DIGEST`

#### Methods

##### `lightbulb.finance_source_records.CanonicalLedgerSnapshot.artifact_digest_payload`



~~~python
def artifact_digest_payload() -> dict[str, Any]
~~~


Source: `lightbulb/finance_source_records.py:634`.

##### `lightbulb.finance_source_records.CanonicalLedgerSnapshot.content_digest_payload`



~~~python
def content_digest_payload() -> dict[str, Any]
~~~


Source: `lightbulb/finance_source_records.py:602`.

##### `lightbulb.finance_source_records.CanonicalLedgerSnapshot.evidence_digest_payload`



~~~python
def evidence_digest_payload() -> dict[str, Any]
~~~


Source: `lightbulb/finance_source_records.py:612`.

##### `lightbulb.finance_source_records.CanonicalLedgerSnapshot.materialization_idempotency_digest_payload`



~~~python
def materialization_idempotency_digest_payload() -> dict[str, Any]
~~~


Source: `lightbulb/finance_source_records.py:618`.

## Module `lightbulb.finance_stripe_settlements`

Governed Stripe settlement observation for the finance close lighthouse.

### `lightbulb.finance_stripe_settlements.StripeSettlementObservationInput`

class. Source: `lightbulb/finance_stripe_settlements.py:168`.

Fields:
- `schema_id: Literal['lightbulb.finance_stripe_settlement_observation_input.v1'] = Field(default=STRIPE_SETTLEMENT_OBSERVATION_INPUT_SCHEMA, alias='schema')`
- `provider: Literal['stripe'] = 'stripe'`
- `start_date: str`
- `end_date: str`
- `currency: CurrencyCode`

### `lightbulb.finance_stripe_settlements.StripeSettlementMovement`

class. Source: `lightbulb/finance_stripe_settlements.py:183`.

Canonical fields retained from one Stripe BalanceTransaction.

Fields:
- `schema_id: Literal['lightbulb.stripe_settlement_movement.v1'] = Field(default=STRIPE_SETTLEMENT_MOVEMENT_SCHEMA, alias='schema')`
- `provider: Literal['stripe'] = 'stripe'`
- `transaction_ref: str = Field(pattern='^txn_[A-Za-z0-9]{8,64}$')`
- `amount_minor: ExactInteger = Field(ge=_MIN_SIGNED_64, le=_MAX_SIGNED_64)`
- `fee_minor: ExactInteger = Field(ge=_MIN_SIGNED_64, le=_MAX_SIGNED_64)`
- `net_minor: ExactInteger = Field(ge=_MIN_SIGNED_64, le=_MAX_SIGNED_64)`
- `currency: CurrencyCode`
- `created_epoch_second: ExactInteger = Field(ge=0, le=_MAX_EPOCH_SECOND)`
- `created_at: str`
- `available_on_epoch_second: ExactInteger = Field(ge=0, le=_MAX_EPOCH_SECOND)`
- `available_on: str`
- `movement_type: str = Field(pattern='^[a-z][a-z0-9_]{0,79}$')`
- `reporting_category: str = Field(pattern='^[a-z][a-z0-9_]{0,79}$')`
- `status: Literal['available', 'pending']`
- `source_ref: str | None = Field(default=None, pattern='^[A-Za-z][A-Za-z0-9_]{1,199}$')`

### `lightbulb.finance_stripe_settlements.StripeSettlementObservationResult`

class. Source: `lightbulb/finance_stripe_settlements.py:232`.

Fields:
- `schema_id: Literal['lightbulb.finance_stripe_settlement_observation_result.v1'] = Field(default=STRIPE_SETTLEMENT_OBSERVATION_RESULT_SCHEMA, alias='schema')`
- `provider: Literal['stripe'] = 'stripe'`
- `tool: Literal['stripe.list_balance_transactions'] = STRIPE_LIST_BALANCE_TRANSACTIONS_TOOL`
- `tool_version: Literal[2] = STRIPE_SETTLEMENT_TOOL_VERSION`
- `project_id: UUID`
- `tenant_connector_id: UUID`
- `connector_account_ref: OpaqueRef`
- `route_digest: Sha256Digest`
- `start_date: str`
- `end_date: str`
- `currency: CurrencyCode`
- `movements: tuple[StripeSettlementMovement, ...] = Field(max_length=_MAX_MOVEMENTS)`
- `movement_count: ExactInteger = Field(ge=0, le=_MAX_MOVEMENTS)`
- `page_count: ExactInteger = Field(ge=1, le=_MAX_PAGES)`
- `final_cursor_ref: str | None = Field(default=None, pattern='^txn_[A-Za-z0-9]{8,64}$')`
- `page_digests: tuple[Sha256Digest, ...] = Field(min_length=1, max_length=_MAX_PAGES)`
- `provenance_receipt_digests: tuple[Sha256Digest, ...] = Field(min_length=1, max_length=_MAX_PAGES)`
- `observation_completed_ats: tuple[str, ...] = Field(min_length=1, max_length=_MAX_PAGES)`
- `observed_at: str`
- `freshness: Literal['current'] = 'current'`
- `classification: Literal['restricted'] = 'restricted'`
- `retention_requirement: Literal['spring_financial_evidence_policy'] = 'spring_financial_evidence_policy'`
- `complete: Literal[True] = True`
- `authoritative_read: Literal[True] = True`
- `reconciliation_authority: Literal[False] = False`
- `close_authority: Literal[False] = False`
- `source_digest: Sha256Digest = _ZERO_DIGEST`

### `lightbulb.finance_stripe_settlements.DiscoverStripeSettlementMovementsPrimitive`

class. Source: `lightbulb/finance_stripe_settlements.py:677`.

## Module `lightbulb.finance_subledger_lock_package`

Prepare a controlled period-close subledger-lock package candidate.

### `lightbulb.finance_subledger_lock_package.SubledgerLockObservation`

class. Source: `lightbulb/finance_subledger_lock_package.py:117`.

Fields:
- `subledger_ref: OpaqueRef`
- `control_account_ref: OpaqueRef`
- `lock_record_ref: OpaqueRef`
- `source_revision_ref: OpaqueRef`
- `evidence_ref: OpaqueRef`
- `issuer_ref: OpaqueRef`
- `lock_receipt_digest: Sha256Digest`
- `lock_state: Literal['reported_locked'] = 'reported_locked'`
- `locked_at: str`
- `observed_at: str`
- `locked_by_ref: OpaqueRef`

#### Methods

##### `lightbulb.finance_subledger_lock_package.SubledgerLockObservation.evidence_digest`



~~~python
def evidence_digest() -> str
~~~


Source: `lightbulb/finance_subledger_lock_package.py:141`.

### `lightbulb.finance_subledger_lock_package.PrepareSubledgerLockPackageInput`

class. Source: `lightbulb/finance_subledger_lock_package.py:145`.

Fields:
- `schema_id: Literal['lightbulb.finance_subledger_lock_package_candidate_input.v1'] = Field(default=SUBLEDGER_LOCK_PACKAGE_CANDIDATE_INPUT_SCHEMA, alias='schema')`
- `workspace: FinanceCloseWorkspace`
- `lifecycle_snapshot: PeriodCloseLifecycleSnapshot`
- `lock_set_ref: OpaqueRef`
- `evidence_use_refs: tuple[OpaqueRef, OpaqueRef]`
- `lock_observations: tuple[SubledgerLockObservation, ...] = Field(min_length=1, max_length=100)`
- `prepared_at: str`
- `lock_owner_ref: OpaqueRef`
- `lock_reviewer_ref: OpaqueRef`

### `lightbulb.finance_subledger_lock_package.SubledgerLockPackageCandidateResult`

class. Source: `lightbulb/finance_subledger_lock_package.py:272`.

Fields:
- `schema_id: Literal['lightbulb.finance_subledger_lock_package_candidate_result.v1'] = Field(default=SUBLEDGER_LOCK_PACKAGE_CANDIDATE_RESULT_SCHEMA, alias='schema')`
- `workspace_ref: OpaqueRef`
- `workspace_revision: int = Field(ge=1)`
- `workspace_digest: Sha256Digest`
- `lifecycle_version: Literal[4] = 4`
- `lifecycle_state_digest: Sha256Digest`
- `reconciliation_transition_digest: Sha256Digest`
- `adjustment_transition_digest: Sha256Digest`
- `prepared_at: str`
- `package: SubledgerLockPackage`
- `package_digest: Sha256Digest`
- `lock_observation_digests: tuple[Sha256Digest, ...] = Field(min_length=1, max_length=100)`
- `candidate_digest: Sha256Digest = _ZERO_DIGEST`
- `lock_state_authentication: Literal['spring_revalidation_required'] = 'spring_revalidation_required'`
- `actor_identity_state: Literal['spring_revalidation_required'] = 'spring_revalidation_required'`
- `evidence_custody_state: Literal['spring_retention_required'] = 'spring_retention_required'`
- `subledger_lock_package_authority: Literal[False] = False`
- `lifecycle_transition_authority: Literal[False] = False`
- `persistence_authorized: Literal[False] = False`

#### Methods

##### `lightbulb.finance_subledger_lock_package.SubledgerLockPackageCandidateResult.digest_payload`



~~~python
def digest_payload() -> dict[str, Any]
~~~


Source: `lightbulb/finance_subledger_lock_package.py:313`.

### `lightbulb.finance_subledger_lock_package.prepare_subledger_lock_package`

function. Source: `lightbulb/finance_subledger_lock_package.py:340`.



~~~python
prepare_subledger_lock_package(inputs: PrepareSubledgerLockPackageInput) -> SubledgerLockPackageCandidateResult
~~~


### `lightbulb.finance_subledger_lock_package.PrepareSubledgerLockPackagePrimitive`

class. Source: `lightbulb/finance_subledger_lock_package.py:421`.

#### Methods

##### `lightbulb.finance_subledger_lock_package.PrepareSubledgerLockPackagePrimitive.implementation_contract`



~~~python
def implementation_contract() -> dict[str, Any]
~~~


Source: `lightbulb/finance_subledger_lock_package.py:446`.

## Module `lightbulb.finance_subledger_lock_transition`

Prepare an evidence-bound ``lock_subledgers`` transition command.

### `lightbulb.finance_subledger_lock_transition.SubledgerLockArtifactEvidenceClaim`

class. Source: `lightbulb/finance_subledger_lock_transition.py:120`.

Fields:
- `use_ref: OpaqueRef`
- `artifact_ref: OpaqueRef`
- `artifact_digest: Sha256Digest`
- `evidence_ref: OpaqueRef`
- `kind: Literal['subledger_lock_record'] = _ARTIFACT_KIND`
- `issuer_ref: OpaqueRef`
- `observed_at: str`
- `effective_at: str`
- `retained_until: str`
- `verification_grade: Literal['attested', 'verified'] = 'attested'`
- `classification: Literal['internal', 'confidential', 'restricted'] = 'restricted'`

### `lightbulb.finance_subledger_lock_transition.SubledgerLockReviewEvidenceClaim`

class. Source: `lightbulb/finance_subledger_lock_transition.py:139`.

Fields:
- `use_ref: OpaqueRef`
- `artifact_ref: OpaqueRef`
- `artifact_digest: Sha256Digest`
- `evidence_ref: OpaqueRef`
- `kind: Literal['subledger_lock_attestation'] = _REVIEW_KIND`
- `issuer_ref: OpaqueRef`
- `observed_at: str`
- `effective_at: str`
- `retained_until: str`
- `verification_grade: Literal['verified'] = 'verified'`
- `classification: Literal['internal', 'confidential', 'restricted'] = 'restricted'`

### `lightbulb.finance_subledger_lock_transition.PrepareSubledgerLockTransitionCommandInput`

class. Source: `lightbulb/finance_subledger_lock_transition.py:158`.

Fields:
- `schema_id: Literal['lightbulb.finance_subledger_lock_transition_command_input.v1'] = Field(default=SUBLEDGER_LOCK_TRANSITION_COMMAND_INPUT_SCHEMA, alias='schema')`
- `workspace: FinanceCloseWorkspace`
- `package_candidate: SubledgerLockPackageCandidateResult`
- `lifecycle_snapshot: PeriodCloseLifecycleSnapshot`
- `transition_ref: OpaqueRef`
- `idempotency_key: OpaqueRef`
- `occurred_at: str`
- `requested_by_ref: OpaqueRef`
- `artifact_evidence: SubledgerLockArtifactEvidenceClaim`
- `review_evidence: SubledgerLockReviewEvidenceClaim`

### `lightbulb.finance_subledger_lock_transition.SubledgerLockTransitionCommandResult`

class. Source: `lightbulb/finance_subledger_lock_transition.py:266`.

Fields:
- `schema_id: Literal['lightbulb.finance_subledger_lock_transition_command_result.v1'] = Field(default=SUBLEDGER_LOCK_TRANSITION_COMMAND_RESULT_SCHEMA, alias='schema')`
- `workspace_ref: OpaqueRef`
- `workspace_revision: int = Field(ge=1)`
- `workspace_digest: Sha256Digest`
- `package_candidate_digest: Sha256Digest`
- `lifecycle_version: Literal[4] = 4`
- `lifecycle_state_digest: Sha256Digest`
- `lifecycle_input: PeriodCloseLifecycleInput`
- `command_content_digest: Sha256Digest`
- `command_request_digest: Sha256Digest`
- `evidence_lineage_tail_digest: Sha256Digest`
- `result_digest: Sha256Digest = _ZERO_DIGEST`
- `lock_state_authentication: Literal['spring_revalidation_required'] = 'spring_revalidation_required'`
- `evidence_authentication_state: Literal['spring_revalidation_required'] = 'spring_revalidation_required'`
- `evidence_custody_state: Literal['spring_retention_required'] = 'spring_retention_required'`
- `lifecycle_transition_authority: Literal[False] = False`
- `persistence_authorized: Literal[False] = False`
- `provider_calls_authorized: Literal[False] = False`

#### Methods

##### `lightbulb.finance_subledger_lock_transition.SubledgerLockTransitionCommandResult.digest_payload`



~~~python
def digest_payload() -> dict[str, Any]
~~~


Source: `lightbulb/finance_subledger_lock_transition.py:294`.

### `lightbulb.finance_subledger_lock_transition.prepare_subledger_lock_transition_command`

function. Source: `lightbulb/finance_subledger_lock_transition.py:358`.



~~~python
prepare_subledger_lock_transition_command(inputs: PrepareSubledgerLockTransitionCommandInput) -> SubledgerLockTransitionCommandResult
~~~


### `lightbulb.finance_subledger_lock_transition.PrepareSubledgerLockTransitionCommandPrimitive`

class. Source: `lightbulb/finance_subledger_lock_transition.py:457`.

#### Methods

##### `lightbulb.finance_subledger_lock_transition.PrepareSubledgerLockTransitionCommandPrimitive.implementation_contract`



~~~python
def implementation_contract() -> dict[str, Any]
~~~


Source: `lightbulb/finance_subledger_lock_transition.py:482`.

## Module `lightbulb.finance_xero_close_source_transactions`

Governed Xero source transactions for the monthly-close lighthouse.

### `lightbulb.finance_xero_close_source_transactions.XeroCloseSourceTransactionInput`

class. Source: `lightbulb/finance_xero_close_source_transactions.py:209`.

Fields:
- `schema_id: Literal['lightbulb.finance_xero_close_source_transaction_input.v1'] = Field(default=XERO_CLOSE_SOURCE_TRANSACTION_INPUT_SCHEMA, alias='schema')`
- `provider: Literal['xero'] = 'xero'`
- `start_date: str`
- `end_date: str`
- `currency: CurrencyCode`

### `lightbulb.finance_xero_close_source_transactions.XeroCloseSourceTransactionLink`

class. Source: `lightbulb/finance_xero_close_source_transactions.py:224`.

Fields:
- `schema_id: Literal['lightbulb.finance_xero_close_source_transaction_link.v1'] = Field(default=XERO_CLOSE_SOURCE_TRANSACTION_LINK_SCHEMA, alias='schema')`
- `source_ref: OpaqueRef`
- `source_type: Literal['invoice', 'bill', 'credit_note', 'prepayment', 'overpayment']`

### `lightbulb.finance_xero_close_source_transactions.XeroCloseSourceTransaction`

class. Source: `lightbulb/finance_xero_close_source_transactions.py:232`.

Fields:
- `schema_id: Literal['lightbulb.finance_xero_close_source_transaction.v1'] = Field(default=XERO_CLOSE_SOURCE_TRANSACTION_SCHEMA, alias='schema')`
- `provider: Literal['xero'] = 'xero'`
- `transaction_type: TransactionType`
- `source_ref: OpaqueRef`
- `source_revision_kind: Literal['content_sha256'] = 'content_sha256'`
- `source_revision: Sha256Digest`
- `transaction_date: str`
- `source_updated_at: str`
- `source_status: str = Field(min_length=1, max_length=50)`
- `document_number: str | None = Field(default=None, max_length=100)`
- `counterparty_ref: OpaqueRef | None = None`
- `counterparty_name: str | None = Field(default=None, max_length=500)`
- `currency: CurrencyCode`
- `total_amount: ExactDecimal`
- `open_balance: ExactDecimal | None = None`
- `links: tuple[XeroCloseSourceTransactionLink, ...] = Field(default=(), max_length=1)`
- `source_digest: Sha256Digest = _ZERO_DIGEST`

### `lightbulb.finance_xero_close_source_transactions.XeroCloseSourcePageCheckpoint`

class. Source: `lightbulb/finance_xero_close_source_transactions.py:307`.

Fields:
- `schema_id: Literal['lightbulb.finance_xero_close_source_page_checkpoint.v1'] = Field(default=XERO_CLOSE_SOURCE_PAGE_CHECKPOINT_SCHEMA, alias='schema')`
- `tool: Literal['xero.list_invoices', 'xero.list_bills', 'xero.list_payments']`
- `tool_version: Literal[2] = XERO_CLOSE_SOURCE_TOOL_VERSION`
- `transaction_type: TransactionType`
- `page: ExactInteger = Field(ge=1, le=_MAX_PAGES_PER_TYPE)`
- `record_count: ExactInteger = Field(ge=0, le=_PAGE_SIZE)`
- `provider_page_count: ExactInteger = Field(ge=0, le=_MAX_PAGES_PER_TYPE)`
- `provider_item_count: ExactInteger = Field(ge=0, le=_MAX_TRANSACTIONS_PER_TYPE)`
- `terminal: bool`
- `provider_observed_at: str`
- `page_digest: Sha256Digest`
- `provenance_receipt_digest: Sha256Digest`
- `execution_journal_ref: OpaqueRef`
- `completed_at: str`

### `lightbulb.finance_xero_close_source_transactions.XeroCloseSourceTransactionResult`

class. Source: `lightbulb/finance_xero_close_source_transactions.py:343`.

Fields:
- `schema_id: Literal['lightbulb.finance_xero_close_source_transaction_result.v1'] = Field(default=XERO_CLOSE_SOURCE_TRANSACTION_RESULT_SCHEMA, alias='schema')`
- `provider: Literal['xero'] = 'xero'`
- `tool_version: Literal[2] = XERO_CLOSE_SOURCE_TOOL_VERSION`
- `project_id: UUID`
- `tenant_connector_id: UUID`
- `connector_account_ref: OpaqueRef`
- `route_digest: Sha256Digest`
- `start_date: str`
- `end_date: str`
- `currency: CurrencyCode`
- `transactions: tuple[XeroCloseSourceTransaction, ...] = Field(max_length=_MAX_TRANSACTIONS)`
- `transaction_count: ExactInteger = Field(ge=0, le=_MAX_TRANSACTIONS)`
- `invoice_count: ExactInteger = Field(ge=0, le=_MAX_TRANSACTIONS_PER_TYPE)`
- `bill_count: ExactInteger = Field(ge=0, le=_MAX_TRANSACTIONS_PER_TYPE)`
- `payment_count: ExactInteger = Field(ge=0, le=_MAX_TRANSACTIONS_PER_TYPE)`
- `checkpoints: tuple[XeroCloseSourcePageCheckpoint, ...] = Field(min_length=3, max_length=_MAX_PAGE_READS)`
- `observed_at: str`
- `freshness: Literal['bounded_observation'] = 'bounded_observation'`
- `classification: Literal['restricted'] = 'restricted'`
- `retention_requirement: Literal['spring_financial_evidence_policy'] = 'spring_financial_evidence_policy'`
- `complete: Literal[True] = True`
- `authoritative_read: Literal[True] = True`
- `reconciliation_authority: Literal[False] = False`
- `close_authority: Literal[False] = False`
- `source_digest: Sha256Digest = _ZERO_DIGEST`

### `lightbulb.finance_xero_close_source_transactions.DiscoverXeroCloseSourceTransactionsPrimitive`

class. Source: `lightbulb/finance_xero_close_source_transactions.py:783`.

## Module `lightbulb.fundraise_readiness`

Fundraise readiness: default alive or dead, and the burn multiple.

### `lightbulb.fundraise_readiness.FundraiseReadinessError`

class. Source: `lightbulb/fundraise_readiness.py:72`.

The readiness inputs cannot produce an honest assessment.

### `lightbulb.fundraise_readiness.DefaultAliveInput`

class. Source: `lightbulb/fundraise_readiness.py:167`.

Fields:
- `assessment_ref: PortableRef`
- `as_of: str`
- `currency: CurrencyCode`
- `cash_on_hand: Decimal = Field(gt=0)`
- `monthly_revenue: Decimal = Field(ge=0)`
- `monthly_costs: Decimal = Field(ge=0)`
- `monthly_revenue_growth_rate: Decimal = Field(ge=0, le=Decimal('1'))`
- `monthly_cost_growth_rate: Decimal = Field(default=Decimal('0'), ge=0, le=Decimal('1'))`
- `horizon_months: int = Field(default=60, ge=1, le=120)`

### `lightbulb.fundraise_readiness.DefaultAliveAssessment`

class. Source: `lightbulb/fundraise_readiness.py:194`.

A conditional 'do we reach profitability before the money runs out?'.

Fields:
- `schema_id: Literal['lightbulb.default_alive_assessment.v1'] = Field(default=DEFAULT_ALIVE_ASSESSMENT_SCHEMA, alias='schema')`
- `assessment_ref: PortableRef`
- `as_of: str`
- `currency: CurrencyCode`
- `verdict: DefaultAliveVerdict`
- `months_to_breakeven: int | None = None`
- `cash_out_month: int | None = None`
- `naive_runway_months: Decimal | None = None`
- `lowest_projected_cash: Decimal`
- `horizon_months: int = Field(ge=1, le=120)`
- `assumed_monthly_revenue_growth_rate: Decimal`
- `assumed_monthly_cost_growth_rate: Decimal`
- `notes: tuple[ShortText, ...] = Field(default_factory=tuple, max_length=10)`
- `assessment_digest: str = '0' * 64`

#### Methods

##### `lightbulb.fundraise_readiness.DefaultAliveAssessment.to_dict`



~~~python
def to_dict() -> dict[str, Any]
~~~


Source: `lightbulb/fundraise_readiness.py:238`.

### `lightbulb.fundraise_readiness.assess_default_alive`

function. Source: `lightbulb/fundraise_readiness.py:242`.



~~~python
assess_default_alive(inputs: DefaultAliveInput | Mapping[str, Any]) -> DefaultAliveAssessment
~~~


Decide default-alive vs default-dead under the caller's growth assumptions.

### `lightbulb.fundraise_readiness.BurnMultipleInput`

class. Source: `lightbulb/fundraise_readiness.py:365`.

Fields:
- `metric_ref: PortableRef`
- `as_of: str`
- `currency: CurrencyCode`
- `net_burn: Decimal = Field(allow_inf_nan=False)`
- `net_new_revenue: Decimal = Field(allow_inf_nan=False)`

### `lightbulb.fundraise_readiness.BurnMultiple`

class. Source: `lightbulb/fundraise_readiness.py:383`.

Net burn per dollar of net new revenue — with a labeled heuristic rating.

Fields:
- `schema_id: Literal['lightbulb.burn_multiple.v1'] = Field(default=BURN_MULTIPLE_SCHEMA, alias='schema')`
- `metric_ref: PortableRef`
- `as_of: str`
- `currency: CurrencyCode`
- `net_burn: Decimal`
- `net_new_revenue: Decimal`
- `burn_multiple: Decimal | None = None`
- `rating: BurnMultipleRating`
- `reference_quality: Literal['default_heuristic'] = 'default_heuristic'`
- `notes: tuple[ShortText, ...] = Field(default_factory=tuple, max_length=6)`
- `metric_digest: str = '0' * 64`

#### Methods

##### `lightbulb.fundraise_readiness.BurnMultiple.to_dict`



~~~python
def to_dict() -> dict[str, Any]
~~~


Source: `lightbulb/fundraise_readiness.py:418`.

### `lightbulb.fundraise_readiness.compute_burn_multiple`

function. Source: `lightbulb/fundraise_readiness.py:422`.



~~~python
compute_burn_multiple(inputs: BurnMultipleInput | Mapping[str, Any]) -> BurnMultiple
~~~


Compute the burn multiple and a labeled-heuristic efficiency rating.

### `lightbulb.fundraise_readiness.AssessDefaultAlivePrimitive`

class. Source: `lightbulb/fundraise_readiness.py:472`.

Default alive or default dead, under stated growth assumptions.

### `lightbulb.fundraise_readiness.ComputeBurnMultiplePrimitive`

class. Source: `lightbulb/fundraise_readiness.py:555`.

Net burn per dollar of net new revenue, with a labeled rating.

## Module `lightbulb.governed_skill_search`

Governed default skill search and workflow-learning receipts.

### `lightbulb.governed_skill_search.SkillSearchMode`

class. Source: `lightbulb/governed_skill_search.py:123`.

### `lightbulb.governed_skill_search.ExactAgentSkillScope`

class. Source: `lightbulb/governed_skill_search.py:128`.

Exact authenticated scope used for both search and binding.

Fields:
- `tenant_id: UUID`
- `company_id: UUID`
- `project_id: UUID | None = None`
- `user_id: UUID`
- `agent_scope: str = Field(pattern='^(backbone|domain)$')`
- `agent_id: str = Field(min_length=1, max_length=128)`
- `domain_id: str | None = Field(default=None, max_length=128)`

### `lightbulb.governed_skill_search.GovernedSkillSearchRequest`

class. Source: `lightbulb/governed_skill_search.py:160`.

Server-built search request.

Fields:
- `schema_id: str = Field(default=GOVERNED_SKILL_SEARCH_REQUEST_SCHEMA, alias='schema')`
- `scope: ExactAgentSkillScope`
- `task_text: str = Field(min_length=1, max_length=2000)`
- `task_kind: str | None = Field(default=None, max_length=128)`
- `workflow_handle: str | None = Field(default=None, max_length=160)`
- `mode: SkillSearchMode = SkillSearchMode.EXECUTABLE`
- `top_k: int = Field(default=5, ge=1, le=8)`

#### Methods

##### `lightbulb.governed_skill_search.GovernedSkillSearchRequest.memory_query_body`



~~~python
def memory_query_body() -> dict[str, Any]
~~~


Source: `lightbulb/governed_skill_search.py:195`.

##### `lightbulb.governed_skill_search.GovernedSkillSearchRequest.memory_query_text`



~~~python
def memory_query_text() -> str
~~~


Source: `lightbulb/governed_skill_search.py:185`.

### `lightbulb.governed_skill_search.GovernedSkillBinding`

class. Source: `lightbulb/governed_skill_search.py:216`.

Fields:
- `schema_id: str = Field(default=GOVERNED_SKILL_BINDING_SCHEMA, alias='schema')`
- `skill_id: str = Field(min_length=1, max_length=255)`
- `skill_handle: str = Field(min_length=1, max_length=255)`
- `semantic_key: str = Field(min_length=1, max_length=384)`
- `summary: str | None = Field(default=None, max_length=500)`
- `objective: str | None = Field(default=None, max_length=500)`
- `procedure: str | None = Field(default=None, max_length=2000)`
- `version: int = Field(ge=1)`
- `lifecycle_stage: str = Field(pattern='^(candidate|verified|certified|published)$')`
- `binding_sha256: str = Field(pattern='^[0-9a-f]{64}$')`
- `artifact_sha256: str | None = Field(default=None, pattern='^[0-9a-f]{64}$')`
- `executable: bool`
- `relevance_score: float = Field(ge=0.0, le=1.0)`
- `text_score: float = Field(ge=0.0, le=1.0)`
- `success_rate: float = Field(ge=0.0, le=1.0)`
- `recency_score: float = Field(ge=0.0, le=1.0)`
- `confidence: float = Field(ge=0.0, le=1.0)`
- `evidence_refs: list[str] = Field(default_factory=list, max_length=24)`
- `rationale: list[str] = Field(default_factory=list, max_length=8)`

### `lightbulb.governed_skill_search.GovernedSkillSearchReceipt`

class. Source: `lightbulb/governed_skill_search.py:240`.

Fields:
- `schema_id: str = Field(default=GOVERNED_SKILL_SEARCH_RECEIPT_SCHEMA, alias='schema')`
- `scope: ExactAgentSkillScope`
- `mode: SkillSearchMode`
- `query_sha256: str = Field(pattern='^[0-9a-f]{64}$')`
- `selected: list[GovernedSkillBinding] = Field(default_factory=list, max_length=8)`
- `excluded_counts: dict[str, int] = Field(default_factory=dict)`
- `generated_at: datetime`
- `receipt_sha256: str = Field(pattern='^[0-9a-f]{64}$')`

#### Methods

##### `lightbulb.governed_skill_search.GovernedSkillSearchReceipt.to_dict`



~~~python
def to_dict() -> dict[str, Any]
~~~


Source: `lightbulb/governed_skill_search.py:252`.

### `lightbulb.governed_skill_search.GovernedSkillSearchProvider`

class. Source: `lightbulb/governed_skill_search.py:256`.

#### Methods

##### `lightbulb.governed_skill_search.GovernedSkillSearchProvider.search`



~~~python
def search(request: GovernedSkillSearchRequest) -> GovernedSkillSearchReceipt
~~~


Source: `lightbulb/governed_skill_search.py:257`.

### `lightbulb.governed_skill_search.compile_memory_skill_search_receipt`

function. Source: `lightbulb/governed_skill_search.py:489`.



~~~python
compile_memory_skill_search_receipt(request: GovernedSkillSearchRequest, payload: Mapping[str, Any], *, generated_at: datetime | None=None) -> GovernedSkillSearchReceipt
~~~


Validate, re-rank, semantically deduplicate, and bind a Memory response.

### `lightbulb.governed_skill_search.MemorySkillSearchClient`

class. Source: `lightbulb/governed_skill_search.py:576`.

Exact-scope adapter for the existing Memory ``/skills/query`` route.

#### Methods

##### `lightbulb.governed_skill_search.MemorySkillSearchClient.search`



~~~python
def search(request: GovernedSkillSearchRequest) -> GovernedSkillSearchReceipt
~~~


Source: `lightbulb/governed_skill_search.py:606`.

### `lightbulb.governed_skill_search.TypedDataReference`

class. Source: `lightbulb/governed_skill_search.py:641`.

Immutable typed data, never an inline raw workflow payload.

Fields:
- `name: str = Field(min_length=1, max_length=128)`
- `schema_sha256: str = Field(pattern='^[0-9a-f]{64}$')`
- `artifact_ref: str = Field(min_length=1, max_length=512)`
- `artifact_sha256: str = Field(pattern='^[0-9a-f]{64}$')`
- `media_type: str = Field(default='application/json', max_length=160)`
- `record_count: int | None = Field(default=None, ge=0)`

### `lightbulb.governed_skill_search.LearningEvidenceSummary`

class. Source: `lightbulb/governed_skill_search.py:664`.

Fields:
- `outcome_verified: bool = False`
- `outcome_evidence_refs: list[str] = Field(default_factory=list, max_length=32)`
- `eligible_episode_count: int = Field(default=0, ge=0)`
- `stable_typed_schema: bool = False`
- `training_dataset_ref: str | None = Field(default=None, max_length=512)`
- `policy_approval_ref: str | None = Field(default=None, max_length=512)`
- `reward_contract_ref: str | None = Field(default=None, max_length=512)`
- `off_policy_evaluation_ref: str | None = Field(default=None, max_length=512)`

### `lightbulb.governed_skill_search.ServerLearningPolicy`

class. Source: `lightbulb/governed_skill_search.py:697`.

Trusted-host policy input; workflow/user inputs must never populate it.

Fields:
- `allow_gepa: bool = True`
- `allow_automl: bool = True`
- `allow_paired_rl: bool = False`
- `min_rl_episode_count: int = Field(default=100, ge=20, le=1000000)`

### `lightbulb.governed_skill_search.WorkflowLearningDisposition`

class. Source: `lightbulb/governed_skill_search.py:708`.

Fields:
- `schema_id: str = Field(default=WORKFLOW_LEARNING_DISPOSITION_SCHEMA, alias='schema')`
- `action: str = Field(pattern='^(hold|enqueue_candidate)$')`
- `eligible_lanes: list[str] = Field(default_factory=list)`
- `reason_codes: list[str] = Field(default_factory=list)`
- `paired_learning_handoff_schema: str | None = None`
- `requires_control_plane_admission: bool = True`
- `training_authorized: bool = False`
- `promotion_authorized: bool = False`
- `serving_authorized: bool = False`

### `lightbulb.governed_skill_search.PrimitiveVersionBinding`

class. Source: `lightbulb/governed_skill_search.py:722`.

Fields:
- `step_id: str = Field(min_length=1, max_length=128)`
- `primitive_ref: str = Field(min_length=3, max_length=200)`
- `primitive_version: str = Field(min_length=1, max_length=80)`
- `contract_sha256: str = Field(pattern='^[0-9a-f]{64}$')`

### `lightbulb.governed_skill_search.WorkflowExecutionLearningRecord`

class. Source: `lightbulb/governed_skill_search.py:731`.

Fields:
- `schema_id: str = Field(default=WORKFLOW_EXECUTION_LEARNING_RECORD_SCHEMA, alias='schema')`
- `scope: ExactAgentSkillScope`
- `project_ref: str = Field(min_length=1, max_length=128)`
- `workflow_key: str = Field(min_length=1, max_length=128)`
- `run_ref: str = Field(min_length=1, max_length=200)`
- `workflow_status: str = Field(min_length=1, max_length=80)`
- `selected_skills: list[GovernedSkillBinding] = Field(default_factory=list, max_length=8)`
- `used_skill_ids: list[str] = Field(default_factory=list, max_length=8)`
- `used_skill_binding_sha256s: list[str] = Field(default_factory=list, max_length=8)`
- `primitive_bindings: list[PrimitiveVersionBinding] = Field(default_factory=list, max_length=1000)`
- `typed_inputs: list[TypedDataReference] = Field(default_factory=list, max_length=64)`
- `typed_outputs: list[TypedDataReference] = Field(default_factory=list, max_length=64)`
- `outcome_evidence_refs: list[str] = Field(default_factory=list, max_length=32)`
- `disposition: WorkflowLearningDisposition`
- `record_sha256: str = Field(pattern='^[0-9a-f]{64}$')`

#### Methods

##### `lightbulb.governed_skill_search.WorkflowExecutionLearningRecord.to_dict`



~~~python
def to_dict() -> dict[str, Any]
~~~


Source: `lightbulb/governed_skill_search.py:754`.

### `lightbulb.governed_skill_search.compile_workflow_execution_learning_record`

function. Source: `lightbulb/governed_skill_search.py:822`.



~~~python
compile_workflow_execution_learning_record(*, run: Any, scope: ExactAgentSkillScope, skill_search_receipt: GovernedSkillSearchReceipt, primitive_contracts: Mapping[str, Mapping[str, Any]], typed_inputs: Iterable[TypedDataReference], typed_outputs: Iterable[TypedDataReference], evidence: LearningEvidenceSummary, policy: ServerLearningPolicy, used_skill_binding_sha256s: Iterable[str]=()) -> WorkflowExecutionLearningRecord
~~~


Bind an existing ``ProjectRuntime`` run to proposal-only learning data.

## Module `lightbulb.grant_discovery`

Grant discovery: the AI accountant's non-dilutive capital finder.

### `lightbulb.grant_discovery.GrantDiscoveryError`

class. Source: `lightbulb/grant_discovery.py:98`.

A profile or program registry entry violates the contract.

### `lightbulb.grant_discovery.EligibilitySignals`

class. Source: `lightbulb/grant_discovery.py:170`.

Structural eligibility signals — not the program's full fine print.

Fields:
- `requires_incorporation: bool = False`
- `requires_rnd: bool = False`
- `requires_export_intent: bool = False`
- `for_smes: bool = False`
- `sectors: tuple[SectorTag, ...] = Field(default_factory=tuple)`
- `indicative_notes: LongText`

### `lightbulb.grant_discovery.GrantProgram`

class. Source: `lightbulb/grant_discovery.py:193`.

One real, sourced non-dilutive funding program.

Fields:
- `program_ref: PortableRef`
- `name: ShortText`
- `jurisdiction: Jurisdiction`
- `region: ShortText = 'federal'`
- `administering_body: ShortText`
- `funding_type: FundingType`
- `non_dilutive: Literal[True] = True`
- `category: GrantCategory`
- `official_source_url: HttpsUrl`
- `last_verified: str`
- `headline_benefit: LongText`
- `eligibility: EligibilitySignals`

### `lightbulb.grant_discovery.CompanyGrantProfile`

class. Source: `lightbulb/grant_discovery.py:390`.

What the accountant knows about the company, for matching.

Fields:
- `profile_ref: PortableRef`
- `country: Jurisdiction`
- `region: ShortText | None = None`
- `is_incorporated: bool`
- `conducts_rnd: bool`
- `export_intent: bool`
- `is_sme: bool = True`
- `sectors: tuple[SectorTag, ...] = Field(default_factory=tuple)`
- `annual_revenue: Decimal | None = None`
- `employee_count: int | None = Field(default=None, ge=0, le=10000000)`

### `lightbulb.grant_discovery.MatchedGrant`

class. Source: `lightbulb/grant_discovery.py:419`.

Fields:
- `program_ref: PortableRef`
- `name: ShortText`
- `jurisdiction: Jurisdiction`
- `funding_type: FundingType`
- `category: GrantCategory`
- `fit_score: int = Field(ge=1, le=100)`
- `match_reasons: tuple[ShortText, ...] = Field(min_length=1)`
- `headline_benefit: LongText`
- `official_source_url: HttpsUrl`
- `last_verified: str`
- `verification_required: Literal[True] = True`

### `lightbulb.grant_discovery.UnmatchedGrant`

class. Source: `lightbulb/grant_discovery.py:440`.

Fields:
- `program_ref: PortableRef`
- `name: ShortText`
- `reason: ShortText`

### `lightbulb.grant_discovery.GrantMatchResult`

class. Source: `lightbulb/grant_discovery.py:446`.

Fields:
- `schema_id: Literal['lightbulb.grant_match_result.v1'] = Field(default=GRANT_MATCH_RESULT_SCHEMA, alias='schema')`
- `profile_ref: PortableRef`
- `country: Jurisdiction`
- `matched: tuple[MatchedGrant, ...] = Field(default_factory=tuple)`
- `not_matched: tuple[UnmatchedGrant, ...] = Field(default_factory=tuple)`
- `disclaimer: LongText = _DISCLAIMER`
- `result_digest: str = '0' * 64`

#### Methods

##### `lightbulb.grant_discovery.GrantMatchResult.to_dict`



~~~python
def to_dict() -> dict[str, Any]
~~~


Source: `lightbulb/grant_discovery.py:465`.

### `lightbulb.grant_discovery.match_grant_programs`

function. Source: `lightbulb/grant_discovery.py:502`.



~~~python
match_grant_programs(inputs: CompanyGrantProfile | Mapping[str, Any]) -> GrantMatchResult
~~~


Match a company profile against the flagship non-dilutive registry.

### `lightbulb.grant_discovery.GrantSearchPlan`

class. Source: `lightbulb/grant_discovery.py:576`.

A plan to find current openings — queries and portals, not results.

Fields:
- `schema_id: Literal['lightbulb.grant_search_plan.v1'] = Field(default=GRANT_SEARCH_PLAN_SCHEMA, alias='schema')`
- `profile_ref: PortableRef`
- `country: Jurisdiction`
- `queries: tuple[ShortText, ...] = Field(min_length=1, max_length=30)`
- `official_portals: tuple[HttpsUrl, ...] = Field(min_length=1)`
- `guidance: LongText`
- `disclaimer: LongText = _DISCLAIMER`
- `plan_digest: str = '0' * 64`

#### Methods

##### `lightbulb.grant_discovery.GrantSearchPlan.to_dict`



~~~python
def to_dict() -> dict[str, Any]
~~~


Source: `lightbulb/grant_discovery.py:598`.

### `lightbulb.grant_discovery.compose_grant_search_plan`

function. Source: `lightbulb/grant_discovery.py:602`.



~~~python
compose_grant_search_plan(inputs: CompanyGrantProfile | Mapping[str, Any], *, year: int | None=None) -> GrantSearchPlan
~~~


Compose structured queries + portals to find current grant openings.

### `lightbulb.grant_discovery.grant_registry`

function. Source: `lightbulb/grant_discovery.py:656`.



~~~python
grant_registry() -> tuple[dict[str, Any], ...]
~~~


Discoverable list of the flagship programs in the registry.

### `lightbulb.grant_discovery.MatchGrantsPrimitive`

class. Source: `lightbulb/grant_discovery.py:691`.

Match a company to flagship non-dilutive programs (Canada / Australia).

### `lightbulb.grant_discovery.GrantSearchRequest`

class. Source: `lightbulb/grant_discovery.py:765`.

A machine-runnable request to search for grants via the platform tool.

Fields:
- `schema_id: Literal['lightbulb.grant_search_request.v1'] = Field(default=GRANT_SEARCH_REQUEST_SCHEMA, alias='schema')`
- `profile_ref: PortableRef`
- `country: Jurisdiction`
- `target_tool: ShortText`
- `query: LongText`
- `guidance: LongText`
- `disclaimer: LongText = _DISCLAIMER`
- `request_digest: str = '0' * 64`

#### Methods

##### `lightbulb.grant_discovery.GrantSearchRequest.to_dict`



~~~python
def to_dict() -> dict[str, Any]
~~~


Source: `lightbulb/grant_discovery.py:788`.

### `lightbulb.grant_discovery.GrantSearchFindings`

class. Source: `lightbulb/grant_discovery.py:792`.

Normalized grant-search findings — what the platform search returned.

Fields:
- `schema_id: Literal['lightbulb.grant_search_findings.v1'] = Field(default=GRANT_SEARCH_FINDINGS_SCHEMA, alias='schema')`
- `profile_ref: PortableRef`
- `country: Jurisdiction`
- `source_tool: ShortText`
- `query: LongText`
- `status: GrantSearchStatus`
- `findings: FindingsText | None = None`
- `verification_required: Literal[True] = True`
- `disclaimer: LongText = _DISCLAIMER`
- `notes: tuple[ShortText, ...] = Field(default_factory=tuple, max_length=10)`
- `findings_digest: str = '0' * 64`

#### Methods

##### `lightbulb.grant_discovery.GrantSearchFindings.to_dict`



~~~python
def to_dict() -> dict[str, Any]
~~~


Source: `lightbulb/grant_discovery.py:824`.

### `lightbulb.grant_discovery.normalize_grant_findings`

function. Source: `lightbulb/grant_discovery.py:884`.



~~~python
normalize_grant_findings(*, profile_ref: str, country: str, query: str, raw_response: Any, source_tool: str=_SEARCH_TOOL) -> GrantSearchFindings
~~~


Structure the raw output of a grant search into verify-flagged leads.

### `lightbulb.grant_discovery.SearchGrantsPrimitive`

class. Source: `lightbulb/grant_discovery.py:920`.

Compose a machine-runnable grant search for the platform to execute.

## Module `lightbulb.growth_briefing`

Growth briefing: session rehydration for a mind that reboots.

### `lightbulb.growth_briefing.GrowthBriefingValidationError`

class. Source: `lightbulb/growth_briefing.py:93`.

Briefing inputs cannot produce an honest rendering.

### `lightbulb.growth_briefing.GrowthBriefing`

class. Source: `lightbulb/growth_briefing.py:162`.

One budgeted, digest-pinned rendering of the scope's state.

Fields:
- `schema_id: Literal['lightbulb.growth_briefing.v1'] = Field(default=GROWTH_BRIEFING_SCHEMA, alias='schema')`
- `as_of: str`
- `budget_chars: int = Field(ge=_MIN_BUDGET_CHARS, le=_MAX_BUDGET_CHARS)`
- `used_chars: int = Field(ge=1, le=_MAX_BUDGET_CHARS)`
- `evidence_scope_status: Literal['caller_supplied_unverified', 'host_hmac_verified']`
- `text: BriefingText`
- `sections_included: tuple[ShortText, ...] = Field(min_length=1, max_length=10)`
- `sections_omitted: tuple[ShortText, ...] = Field(default_factory=tuple, max_length=10)`
- `agenda_digest: Sha256Digest`
- `source_digests: tuple[Sha256Digest, ...] = Field(default_factory=tuple, max_length=_MAX_SOURCE_DIGESTS)`
- `data_quality_notes: tuple[ShortText, ...] = Field(default_factory=tuple, max_length=10)`
- `briefing_digest: Sha256Digest = '0' * 64`

#### Methods

##### `lightbulb.growth_briefing.GrowthBriefing.to_dict`



~~~python
def to_dict() -> dict[str, Any]
~~~


Source: `lightbulb/growth_briefing.py:220`.

### `lightbulb.growth_briefing.CompileBriefingInput`

class. Source: `lightbulb/growth_briefing.py:224`.

Fields:
- `budget_chars: int = Field(default=_DEFAULT_BUDGET_CHARS, ge=_MIN_BUDGET_CHARS, le=_MAX_BUDGET_CHARS)`
- `max_agenda_items: int = Field(default=10, ge=1, le=_MAX_RENDERED_ITEMS)`
- `scope_label: ShortText | None = None`
- `agenda: GrowthAgendaInput`

### `lightbulb.growth_briefing.compile_growth_briefing`

function. Source: `lightbulb/growth_briefing.py:511`.



~~~python
compile_growth_briefing(inputs: CompileBriefingInput | Mapping[str, Any], *, inputs_verified_by_host: bool=False) -> GrowthBriefing
~~~


Render one budgeted cold-start briefing; the agenda does the deciding.

### `lightbulb.growth_briefing.CompileBriefingPrimitive`

class. Source: `lightbulb/growth_briefing.py:663`.

Render the scope's cold-start briefing under a character budget.

## Module `lightbulb.growth_cockpit`

Agent cockpit for the Growth Engine: diagnose, then act.

### `lightbulb.growth_cockpit.GrowthCockpitValidationError`

class. Source: `lightbulb/growth_cockpit.py:109`.

Cockpit inputs cannot produce an honest diagnosis.

### `lightbulb.growth_cockpit.DiagnoseGrowthInput`

class. Source: `lightbulb/growth_cockpit.py:171`.

Fields:
- `as_of: str`
- `funnel_snapshot: GrowthFunnelSnapshot`
- `learnings: tuple[GrowthLearningEntry, ...] = Field(default_factory=tuple, max_length=_MAX_DIAGNOSIS_LEARNINGS)`

### `lightbulb.growth_cockpit.GrowthOpportunity`

class. Source: `lightbulb/growth_cockpit.py:189`.

Fields:
- `rank: int = Field(ge=1, le=50)`
- `kind: OpportunityKind`
- `stage: ShortText`
- `title: ShortText`
- `mechanism: ShortText`
- `expected_impact_note: ShortText`
- `next_primitive_ref: ShortText`
- `argument_hints: dict[str, str] = Field(default_factory=dict)`

### `lightbulb.growth_cockpit.ApplicableLearning`

class. Source: `lightbulb/growth_cockpit.py:207`.

Fields:
- `entry_digest: Sha256Digest`
- `grade: Literal['experimental', 'observational', 'heuristic']`
- `lever: ShortText`
- `claim: ShortText`

### `lightbulb.growth_cockpit.GrowthDiagnosis`

class. Source: `lightbulb/growth_cockpit.py:234`.

One deterministic answer to "what should I do next, and why".

Fields:
- `schema_id: Literal['lightbulb.growth_diagnosis.v1'] = Field(default=GROWTH_DIAGNOSIS_SCHEMA, alias='schema')`
- `as_of: str`
- `funnel_digest: Sha256Digest`
- `evidence_scope_status: Literal['caller_supplied_unverified', 'host_hmac_verified']`
- `stages: tuple[DiagnosisStage, ...]`
- `rates: tuple[DiagnosisRate, ...] = Field(default_factory=tuple)`
- `bottleneck_rate: ShortText | None = None`
- `bottleneck_note: ShortText`
- `opportunities: tuple[GrowthOpportunity, ...] = Field(default_factory=tuple)`
- `applicable_learnings: tuple[ApplicableLearning, ...] = Field(default_factory=tuple)`
- `data_quality_notes: tuple[ShortText, ...] = Field(default_factory=tuple)`
- `diagnosis_digest: Sha256Digest = '0' * 64`

#### Methods

##### `lightbulb.growth_cockpit.GrowthDiagnosis.to_dict`



~~~python
def to_dict() -> dict[str, Any]
~~~


Source: `lightbulb/growth_cockpit.py:287`.

### `lightbulb.growth_cockpit.diagnose_growth`

function. Source: `lightbulb/growth_cockpit.py:306`.



~~~python
diagnose_growth(inputs: DiagnoseGrowthInput | Mapping[str, Any]) -> GrowthDiagnosis
~~~


Deterministically rank what to do next from funnel state + learnings.

### `lightbulb.growth_cockpit.BuildGrowthFunnelSnapshotPrimitive`

class. Source: `lightbulb/growth_cockpit.py:543`.

Compile a canonical funnel snapshot from supplied evidence envelopes.

### `lightbulb.growth_cockpit.DiagnoseGrowthPrimitive`

class. Source: `lightbulb/growth_cockpit.py:613`.

Rank the next best growth actions from a funnel snapshot.

### `lightbulb.growth_cockpit.PlanContentCalendarPrimitive`

class. Source: `lightbulb/growth_cockpit.py:679`.

Compile a bottleneck-aimed, approval-ready posting calendar.

### `lightbulb.growth_cockpit.PlanAudienceGrowthPrimitive`

class. Source: `lightbulb/growth_cockpit.py:760`.

Compile follower-growth or lead-magnet loops from funnel state.

## Module `lightbulb.growth_customers`

Customer value engine: what a customer is worth beyond the first order.

### `lightbulb.growth_customers.GrowthCustomersValidationError`

class. Source: `lightbulb/growth_customers.py:124`.

Cohort evidence or customer-value content violates the contract.

### `lightbulb.growth_customers.CohortAgeBucket`

class. Source: `lightbulb/growth_customers.py:285`.

Observed behavior of one cohort inside one age interval, in days.

Fields:
- `age_days_start: int = Field(ge=0, le=3650)`
- `age_days_end: int = Field(ge=1, le=3650)`
- `orders: int = Field(ge=0, le=10000000000)`
- `gross_sales: Decimal = Field(ge=0, le=Decimal('1000000000000'))`
- `discounts: Decimal = Field(ge=0, le=Decimal('1000000000000'))`
- `refunds: Decimal = Field(ge=0, le=Decimal('1000000000000'))`

### `lightbulb.growth_customers.CustomerCohortEvidence`

class. Source: `lightbulb/growth_customers.py:314`.

One sealed acquisition cohort with its observed repeat behavior.

Fields:
- `cohort_ref: PortableRef`
- `connector_account_ref: OperationRef`
- `provider: CohortProvider`
- `source_capability: str = Field(min_length=3, max_length=160, pattern='^[a-z][a-z0-9_-]{0,63}\\.[a-z][a-z0-9_.-]{0,127}$')`
- `currency: CurrencyCode`
- `acquisition_window_start: str`
- `acquisition_window_end: str`
- `observed_at: str`
- `cohort_size: int = Field(ge=1, le=10000000000)`
- `age_buckets: tuple[CohortAgeBucket, ...] = Field(min_length=1, max_length=_MAX_AGE_BUCKETS)`
- `evidence_digest: Sha256Digest`
- `receipt_key_id: str | None = Field(default=None, min_length=8, max_length=80, pattern='^[A-Za-z0-9][A-Za-z0-9._-]{7,79}$')`
- `exact_scope_digest: Sha256Digest | None = None`
- `cohort_hmac: Sha256Digest | None = None`

#### Methods

##### `lightbulb.growth_customers.CustomerCohortEvidence.hmac_payload`



~~~python
def hmac_payload() -> dict[str, Any]
~~~


Source: `lightbulb/growth_customers.py:413`.

##### `lightbulb.growth_customers.CustomerCohortEvidence.is_attested`



~~~python
@property
def is_attested() -> bool
~~~


Source: `lightbulb/growth_customers.py:410`.

##### `lightbulb.growth_customers.CustomerCohortEvidence.observed_age_days`



~~~python
@property
def observed_age_days() -> int
~~~


Whole days the cohort's YOUNGEST member has been observed.

Source: `lightbulb/growth_customers.py:401`.

### `lightbulb.growth_customers.mint_customer_cohort_evidence`

function. Source: `lightbulb/growth_customers.py:421`.



~~~python
mint_customer_cohort_evidence(value: CustomerCohortEvidence | Mapping[str, Any], *, scope: DynamicWorkflowScope | Mapping[str, Any], scope_keyring: ExactScopeDigestProvider, scope_key_id: str | None=None) -> CustomerCohortEvidence
~~~


Seal one host-verified acquisition cohort for customer-value use.

### `lightbulb.growth_customers.verify_customer_cohort_evidence`

function. Source: `lightbulb/growth_customers.py:490`.



~~~python
verify_customer_cohort_evidence(value: CustomerCohortEvidence | Mapping[str, Any], *, scope: DynamicWorkflowScope | Mapping[str, Any], scope_keyring: ExactScopeDigestProvider) -> CustomerCohortEvidence
~~~


Re-validate and verify one sealed cohort envelope; raise on failure.

### `lightbulb.growth_customers.BuildCustomerValueInput`

class. Source: `lightbulb/growth_customers.py:522`.

Fields:
- `analysis_as_of: str`
- `value_ref: PortableRef`
- `currency: CurrencyCode`
- `cohorts: tuple[CustomerCohortEvidence, ...] = Field(min_length=1, max_length=_MAX_COHORTS)`
- `unit_economics: UnitEconomicsSnapshot | None = None`

### `lightbulb.growth_customers.HorizonComponent`

class. Source: `lightbulb/growth_customers.py:552`.

Observed customer value at one horizon, from fully-aged cohorts only.

Fields:
- `horizon_days: int = Field(ge=1, le=3650)`
- `admitted_cohorts: int = Field(ge=1)`
- `customers: int = Field(ge=1)`
- `orders_per_customer: Decimal = Field(ge=0, multiple_of=_RATE_QUANTUM)`
- `net_revenue_per_customer: Decimal = Field(ge=0, multiple_of=_MONEY_QUANTUM)`
- `contribution_ltv: Decimal | None = Field(default=None, multiple_of=_MONEY_QUANTUM)`
- `cac_ceiling: Decimal | None = Field(default=None, multiple_of=_MONEY_QUANTUM)`
- `cross_artifact: bool`
- `complete: bool`
- `missing_inputs: tuple[ShortText, ...] = Field(default_factory=tuple)`
- `formula: ShortText`

### `lightbulb.growth_customers.ReorderCurvePoint`

class. Source: `lightbulb/growth_customers.py:611`.

Pooled orders per customer inside one age interval.

Fields:
- `age_days_start: int = Field(ge=0, le=3650)`
- `age_days_end: int = Field(ge=1, le=3650)`
- `customers: int = Field(ge=1)`
- `orders_per_customer: Decimal = Field(ge=0, multiple_of=_RATE_QUANTUM)`

### `lightbulb.growth_customers.CustomerValueSnapshot`

class. Source: `lightbulb/growth_customers.py:634`.

Sealed, horizon-bounded observed customer value for one scope.

Fields:
- `schema_id: Literal['lightbulb.growth_customer_value.v1'] = Field(default=GROWTH_CUSTOMER_VALUE_SCHEMA, alias='schema')`
- `value_ref: PortableRef`
- `analysis_as_of: str`
- `currency: CurrencyCode`
- `evidence_scope_status: Literal['caller_supplied_unverified', 'host_hmac_verified']`
- `horizons: tuple[HorizonComponent, ...] = Field(default_factory=tuple)`
- `reorder_curve: tuple[ReorderCurvePoint, ...] = Field(default_factory=tuple, max_length=24)`
- `economics_digest: Sha256Digest | None = None`
- `data_quality_notes: tuple[ShortText, ...] = Field(default_factory=tuple, max_length=20)`
- `admitted_cohort_refs: tuple[PortableRef, ...] = Field(default_factory=tuple)`
- `excluded_cohorts: tuple[ExcludedCohort, ...] = Field(default_factory=tuple)`
- `value_digest: Sha256Digest = '0' * 64`
- `receipt_key_id: str | None = Field(default=None, min_length=8, max_length=80, pattern='^[A-Za-z0-9][A-Za-z0-9._-]{7,79}$')`
- `exact_scope_digest: Sha256Digest | None = None`
- `value_hmac: Sha256Digest | None = None`

#### Methods

##### `lightbulb.growth_customers.CustomerValueSnapshot.hmac_payload`



~~~python
def hmac_payload() -> dict[str, Any]
~~~


Source: `lightbulb/growth_customers.py:738`.

##### `lightbulb.growth_customers.CustomerValueSnapshot.horizon`



~~~python
def horizon(horizon_days: int) -> HorizonComponent | None
~~~


Source: `lightbulb/growth_customers.py:746`.

##### `lightbulb.growth_customers.CustomerValueSnapshot.to_dict`



~~~python
def to_dict() -> dict[str, Any]
~~~


Source: `lightbulb/growth_customers.py:752`.

### `lightbulb.growth_customers.build_customer_value_snapshot`

function. Source: `lightbulb/growth_customers.py:790`.



~~~python
build_customer_value_snapshot(inputs: BuildCustomerValueInput | Mapping[str, Any], *, scope: DynamicWorkflowScope | Mapping[str, Any] | None=None, scope_keyring: ExactScopeDigestProvider | None=None, scope_key_id: str | None=None) -> CustomerValueSnapshot
~~~


Compute sealed, horizon-bounded observed customer value.

### `lightbulb.growth_customers.verify_customer_value_snapshot`

function. Source: `lightbulb/growth_customers.py:1118`.



~~~python
verify_customer_value_snapshot(value: CustomerValueSnapshot | Mapping[str, Any], *, scope: DynamicWorkflowScope | Mapping[str, Any], scope_keyring: ExactScopeDigestProvider) -> CustomerValueSnapshot
~~~


Re-validate and verify one sealed value snapshot; raise on failure.

### `lightbulb.growth_customers.ReviewCustomerValueInput`

class. Source: `lightbulb/growth_customers.py:1167`.

Fields:
- `as_of: str`
- `customer_value: CustomerValueSnapshot`
- `unit_economics: UnitEconomicsSnapshot | None = None`
- `payback_horizon_days: int = Field(default=180, ge=1, le=3650)`

### `lightbulb.growth_customers.CustomerValueOpportunity`

class. Source: `lightbulb/growth_customers.py:1188`.

Fields:
- `rank: int = Field(ge=1, le=_MAX_REVIEW_OPPORTUNITIES)`
- `kind: Literal['raise_acquisition_ceiling', 'cut_acquisition_spend', 'run_experiment', 'collect_evidence']`
- `title: ShortText`
- `mechanism: ShortText`
- `expected_contribution_delta: Decimal | None = None`
- `delta_low: Decimal | None = None`
- `delta_high: Decimal | None = None`
- `interval_kind: Literal['scenario_half_to_full_close'] | None = None`
- `assumptions: tuple[ShortText, ...] = Field(default_factory=tuple, max_length=5)`
- `next_primitive_ref: ShortText | None = None`
- `argument_hints: dict[str, str] = Field(default_factory=dict)`

### `lightbulb.growth_customers.CustomerValueReview`

class. Source: `lightbulb/growth_customers.py:1250`.

One deterministic answer to "what is a customer worth, and so what".

Fields:
- `schema_id: Literal['lightbulb.growth_customer_value_review.v1'] = Field(default=GROWTH_CUSTOMER_VALUE_REVIEW_SCHEMA, alias='schema')`
- `as_of: str`
- `value_digest: Sha256Digest`
- `economics_digest: Sha256Digest | None = None`
- `currency: CurrencyCode`
- `evidence_scope_status: Literal['caller_supplied_unverified', 'host_hmac_verified']`
- `payback_horizon_days: int = Field(ge=1, le=3650)`
- `opportunities: tuple[CustomerValueOpportunity, ...] = Field(default_factory=tuple, max_length=_MAX_REVIEW_OPPORTUNITIES)`
- `data_quality_notes: tuple[ShortText, ...] = Field(default_factory=tuple, max_length=20)`
- `review_digest: Sha256Digest = '0' * 64`

#### Methods

##### `lightbulb.growth_customers.CustomerValueReview.to_dict`



~~~python
def to_dict() -> dict[str, Any]
~~~


Source: `lightbulb/growth_customers.py:1300`.

### `lightbulb.growth_customers.review_customer_value`

function. Source: `lightbulb/growth_customers.py:1311`.



~~~python
review_customer_value(inputs: ReviewCustomerValueInput | Mapping[str, Any]) -> CustomerValueReview
~~~


Compare what a customer is worth with what acquisition pays for one.

### `lightbulb.growth_customers.BuildCustomerValuePrimitive`

class. Source: `lightbulb/growth_customers.py:1682`.

Compile horizon-bounded observed customer value from cohort evidence.

### `lightbulb.growth_customers.ReviewCustomerValuePrimitive`

class. Source: `lightbulb/growth_customers.py:1757`.

Compare observed customer value with the acquisition price paid.

## Module `lightbulb.growth_experiments`

Preregistered growth experiments with honest, sealed readouts.

### `lightbulb.growth_experiments.GrowthExperimentValidationError`

class. Source: `lightbulb/growth_experiments.py:129`.

Experiment content violates the preregistration contract.

### `lightbulb.growth_experiments.student_t_two_sided_quantile`

function. Source: `lightbulb/growth_experiments.py:306`.



~~~python
student_t_two_sided_quantile(alpha: float, degrees_of_freedom: float) -> float
~~~


Positive t whose two-sided tail probability equals ``alpha`` (bisection).

### `lightbulb.growth_experiments.required_sample_per_arm_proportion`

function. Source: `lightbulb/growth_experiments.py:394`.



~~~python
required_sample_per_arm_proportion(baseline: float, minimum_detectable_effect: float, *, alpha: float, power: float, direction: HypothesisDirection) -> int
~~~


Per-arm n for a two-sided two-proportion test (unpooled variance).

### `lightbulb.growth_experiments.required_sample_per_arm_continuous`

function. Source: `lightbulb/growth_experiments.py:424`.



~~~python
required_sample_per_arm_continuous(standard_deviation: float, minimum_detectable_effect: float, *, alpha: float, power: float) -> int
~~~


### `lightbulb.growth_experiments.ExperimentHypothesis`

class. Source: `lightbulb/growth_experiments.py:625`.

Fields:
- `metric_name: ExperimentMetricName`
- `direction: HypothesisDirection`
- `rationale: LongText`

#### Methods

##### `lightbulb.growth_experiments.ExperimentHypothesis.metric_kind`



~~~python
@property
def metric_kind() -> MetricKind
~~~


Source: `lightbulb/growth_experiments.py:631`.

### `lightbulb.growth_experiments.ExperimentVariant`

class. Source: `lightbulb/growth_experiments.py:635`.

Fields:
- `variant_ref: PortableRef`
- `description: ShortText`
- `allocation: Decimal = Field(gt=0, lt=1, multiple_of=_RATE_QUANTUM)`
- `is_control: bool`

### `lightbulb.growth_experiments.ExperimentGuardrail`

class. Source: `lightbulb/growth_experiments.py:647`.

A preregistered protective intent.

Fields:
- `metric_name: ExperimentMetricName`
- `max_absolute_degradation: Decimal = Field(gt=0, le=1, multiple_of=_RATE_QUANTUM)`

### `lightbulb.growth_experiments.GrowthExperimentDesign`

class. Source: `lightbulb/growth_experiments.py:664`.

A sealed preregistration. The HMAC is what makes it an experiment.

Fields:
- `schema_id: Literal['lightbulb.growth_experiment_design.v1'] = Field(default=GROWTH_EXPERIMENT_DESIGN_SCHEMA, alias='schema')`
- `design_ref: PortableRef`
- `hypothesis: ExperimentHypothesis`
- `variants: tuple[ExperimentVariant, ...] = Field(min_length=2, max_length=2)`
- `assignment_unit: AssignmentUnit`
- `baseline_source: BaselineSource`
- `baseline_value: Decimal = Field(ge=0, multiple_of=_RATE_QUANTUM)`
- `baseline_evidence_digest: Sha256Digest | None = None`
- `baseline_standard_deviation: Decimal | None = Field(default=None, gt=0, multiple_of=_RATE_QUANTUM)`
- `minimum_detectable_effect: Decimal = Field(gt=0, multiple_of=_RATE_QUANTUM)`
- `alpha: Decimal = Field(default=Decimal('0.050000'), ge=Decimal('0.001'), le=Decimal('0.2'), multiple_of=_RATE_QUANTUM)`
- `power: Decimal = Field(default=Decimal('0.800000'), ge=Decimal('0.5'), le=Decimal('0.99'), multiple_of=_RATE_QUANTUM)`
- `required_sample_per_arm: int = Field(ge=2, le=1000000000)`
- `designed_at: str`
- `exposure_start: str`
- `readout_horizon: str`
- `guardrails: tuple[ExperimentGuardrail, ...] = Field(default_factory=tuple, max_length=_MAX_GUARDRAILS)`
- `design_digest: Sha256Digest = '0' * 64`
- `receipt_key_id: str | None = Field(default=None, min_length=8, max_length=80, pattern='^[A-Za-z0-9][A-Za-z0-9._-]{7,79}$')`
- `exact_scope_digest: Sha256Digest | None = None`
- `design_hmac: Sha256Digest | None = None`

#### Methods

##### `lightbulb.growth_experiments.GrowthExperimentDesign.control_variant`



~~~python
@property
def control_variant() -> ExperimentVariant
~~~


Source: `lightbulb/growth_experiments.py:823`.

##### `lightbulb.growth_experiments.GrowthExperimentDesign.hmac_payload`



~~~python
def hmac_payload() -> dict[str, Any]
~~~


Source: `lightbulb/growth_experiments.py:830`.

##### `lightbulb.growth_experiments.GrowthExperimentDesign.is_sealed`



~~~python
@property
def is_sealed() -> bool
~~~


Source: `lightbulb/growth_experiments.py:819`.

##### `lightbulb.growth_experiments.GrowthExperimentDesign.to_dict`



~~~python
def to_dict() -> dict[str, Any]
~~~


Source: `lightbulb/growth_experiments.py:838`.

##### `lightbulb.growth_experiments.GrowthExperimentDesign.treatment_variant`



~~~python
@property
def treatment_variant() -> ExperimentVariant
~~~


Source: `lightbulb/growth_experiments.py:827`.

### `lightbulb.growth_experiments.DesignGrowthExperimentInput`

class. Source: `lightbulb/growth_experiments.py:859`.

Fields:
- `design_ref: PortableRef`
- `hypothesis: ExperimentHypothesis`
- `variants: tuple[ExperimentVariant, ...] = Field(min_length=2, max_length=2)`
- `assignment_unit: AssignmentUnit`
- `baseline_source: BaselineSource`
- `baseline_value: Decimal = Field(ge=0, multiple_of=_RATE_QUANTUM)`
- `baseline_evidence_digest: Sha256Digest | None = None`
- `baseline_standard_deviation: Decimal | None = Field(default=None, gt=0, multiple_of=_RATE_QUANTUM)`
- `minimum_detectable_effect: Decimal = Field(gt=0, multiple_of=_RATE_QUANTUM)`
- `alpha: Decimal = Field(default=Decimal('0.050000'), ge=Decimal('0.001'), le=Decimal('0.2'), multiple_of=_RATE_QUANTUM)`
- `power: Decimal = Field(default=Decimal('0.800000'), ge=Decimal('0.5'), le=Decimal('0.99'), multiple_of=_RATE_QUANTUM)`
- `designed_at: str`
- `exposure_start: str`
- `readout_horizon: str`
- `guardrails: tuple[ExperimentGuardrail, ...] = Field(default_factory=tuple, max_length=_MAX_GUARDRAILS)`

### `lightbulb.growth_experiments.design_growth_experiment`

function. Source: `lightbulb/growth_experiments.py:919`.



~~~python
design_growth_experiment(inputs: DesignGrowthExperimentInput | Mapping[str, Any], *, scope: DynamicWorkflowScope | Mapping[str, Any], scope_keyring: ExactScopeDigestProvider, scope_key_id: str | None=None) -> GrowthExperimentDesign
~~~


Compute the power analysis and seal the preregistration.

### `lightbulb.growth_experiments.verify_growth_experiment_design`

function. Source: `lightbulb/growth_experiments.py:995`.



~~~python
verify_growth_experiment_design(value: GrowthExperimentDesign | Mapping[str, Any], *, scope: DynamicWorkflowScope | Mapping[str, Any], scope_keyring: ExactScopeDigestProvider) -> GrowthExperimentDesign
~~~


### `lightbulb.growth_experiments.ExperimentAssignment`

class. Source: `lightbulb/growth_experiments.py:1042`.

Fields:
- `schema_id: Literal['lightbulb.growth_experiment_assignment.v1'] = Field(default=GROWTH_EXPERIMENT_ASSIGNMENT_SCHEMA, alias='schema')`
- `design_digest: Sha256Digest`
- `unit_digest: Sha256Digest`
- `variant_ref: PortableRef`
- `bucket: Decimal = Field(ge=0, lt=1, multiple_of=_RATE_QUANTUM)`
- `receipt_key_id: str = Field(min_length=8, max_length=80, pattern='^[A-Za-z0-9][A-Za-z0-9._-]{7,79}$')`
- `exact_scope_digest: Sha256Digest`
- `assignment_hmac: Sha256Digest`

#### Methods

##### `lightbulb.growth_experiments.ExperimentAssignment.hmac_payload`



~~~python
def hmac_payload() -> dict[str, Any]
~~~


Source: `lightbulb/growth_experiments.py:1064`.

### `lightbulb.growth_experiments.assign_experiment_unit`

function. Source: `lightbulb/growth_experiments.py:1073`.



~~~python
assign_experiment_unit(design: GrowthExperimentDesign | Mapping[str, Any], unit_id: str, *, scope: DynamicWorkflowScope | Mapping[str, Any], scope_keyring: ExactScopeDigestProvider) -> ExperimentAssignment
~~~


Deterministically assign one unit; the raw unit id never persists.

### `lightbulb.growth_experiments.verify_experiment_assignment`

function. Source: `lightbulb/growth_experiments.py:1137`.



~~~python
verify_experiment_assignment(value: ExperimentAssignment | Mapping[str, Any], *, scope: DynamicWorkflowScope | Mapping[str, Any], scope_keyring: ExactScopeDigestProvider) -> ExperimentAssignment
~~~


Re-validate and verify one sealed assignment record; raise on failure.

### `lightbulb.growth_experiments.ExperimentArmEvidence`

class. Source: `lightbulb/growth_experiments.py:1178`.

Sealed per-arm outcome totals gathered after exposure.

Fields:
- `schema_id: Literal['lightbulb.growth_experiment_arm_evidence.v1'] = Field(default=GROWTH_EXPERIMENT_ARM_EVIDENCE_SCHEMA, alias='schema')`
- `observation_ref: PortableRef`
- `design_digest: Sha256Digest`
- `variant_ref: PortableRef`
- `metric_kind: MetricKind`
- `connector_account_ref: OperationRef`
- `provider: AnalyticsProvider`
- `source_capability: str = Field(min_length=3, max_length=160, pattern='^[a-z][a-z0-9_-]{0,63}\\.[a-z][a-z0-9_.-]{0,127}$')`
- `observed_at: str`
- `window_start: str`
- `window_end: str`
- `successes: int | None = Field(default=None, ge=0, le=10000000000)`
- `trials: int | None = Field(default=None, ge=0, le=10000000000)`
- `sample_count: int | None = Field(default=None, ge=0, le=10000000000)`
- `sample_mean: Decimal | None = Field(default=None, ge=0)`
- `sample_variance: Decimal | None = Field(default=None, ge=0)`
- `evidence_digest: Sha256Digest`
- `receipt_key_id: str | None = Field(default=None, min_length=8, max_length=80, pattern='^[A-Za-z0-9][A-Za-z0-9._-]{7,79}$')`
- `exact_scope_digest: Sha256Digest | None = None`
- `arm_hmac: Sha256Digest | None = None`

#### Methods

##### `lightbulb.growth_experiments.ExperimentArmEvidence.hmac_payload`



~~~python
def hmac_payload() -> dict[str, Any]
~~~


Source: `lightbulb/growth_experiments.py:1271`.

### `lightbulb.growth_experiments.mint_experiment_arm_evidence`

function. Source: `lightbulb/growth_experiments.py:1280`.



~~~python
mint_experiment_arm_evidence(value: ExperimentArmEvidence | Mapping[str, Any], *, scope: DynamicWorkflowScope | Mapping[str, Any], scope_keyring: ExactScopeDigestProvider, scope_key_id: str | None=None) -> ExperimentArmEvidence
~~~


### `lightbulb.growth_experiments.verify_experiment_arm_evidence`

function. Source: `lightbulb/growth_experiments.py:1319`.



~~~python
verify_experiment_arm_evidence(value: ExperimentArmEvidence | Mapping[str, Any], *, scope: DynamicWorkflowScope | Mapping[str, Any], scope_keyring: ExactScopeDigestProvider) -> ExperimentArmEvidence
~~~


### `lightbulb.growth_experiments.ReadoutArm`

class. Source: `lightbulb/growth_experiments.py:1366`.

Fields:
- `variant_ref: PortableRef`
- `is_control: bool`
- `trials: int | None = Field(default=None, ge=0)`
- `successes: int | None = Field(default=None, ge=0)`
- `sample_count: int | None = Field(default=None, ge=0)`
- `sample_mean: Decimal | None = Field(default=None, ge=0)`
- `sample_variance: Decimal | None = Field(default=None, ge=0)`
- `evidence_digest: Sha256Digest`

### `lightbulb.growth_experiments.SampleRatioCheck`

class. Source: `lightbulb/growth_experiments.py:1384`.

Fields:
- `expected_control_share: Decimal = Field(gt=0, lt=1, multiple_of=_RATE_QUANTUM)`
- `observed_control: int = Field(ge=0)`
- `observed_treatment: int = Field(ge=0)`
- `p_value: Decimal = Field(ge=0, le=1, multiple_of=_RATE_QUANTUM)`
- `passed: bool`

### `lightbulb.growth_experiments.GuardrailBreach`

class. Source: `lightbulb/growth_experiments.py:1397`.

Fields:
- `metric_name: ExperimentMetricName`
- `control_value: Decimal = Field(ge=0, multiple_of=_RATE_QUANTUM)`
- `treatment_value: Decimal = Field(ge=0, multiple_of=_RATE_QUANTUM)`
- `max_absolute_degradation: Decimal = Field(gt=0, le=1, multiple_of=_RATE_QUANTUM)`

### `lightbulb.growth_experiments.GrowthExperimentReadout`

class. Source: `lightbulb/growth_experiments.py:1414`.

A sealed verdict bound to its preregistered design by digest.

Fields:
- `schema_id: Literal['lightbulb.growth_experiment_readout.v1'] = Field(default=GROWTH_EXPERIMENT_READOUT_SCHEMA, alias='schema')`
- `readout_ref: PortableRef`
- `design_digest: Sha256Digest`
- `metric_name: ExperimentMetricName`
- `metric_kind: MetricKind`
- `direction: HypothesisDirection`
- `analysis_as_of: str`
- `arms: tuple[ReadoutArm, ...] = Field(min_length=2, max_length=2)`
- `sample_ratio_check: SampleRatioCheck`
- `test_used: Literal['two_proportion_z', 'welch_t', 'none']`
- `effect_estimate: Decimal | None = None`
- `ci_low: Decimal | None = None`
- `ci_high: Decimal | None = None`
- `p_value: Decimal | None = Field(default=None, ge=0, le=1, multiple_of=_RATE_QUANTUM)`
- `verdict: ReadoutVerdict`
- `causal: bool`
- `underpowered: bool`
- `guardrail_breaches: tuple[GuardrailBreach, ...] = Field(default_factory=tuple)`
- `notes: tuple[ShortText, ...] = Field(default_factory=tuple, max_length=10)`
- `readout_digest: Sha256Digest = '0' * 64`
- `receipt_key_id: str | None = Field(default=None, min_length=8, max_length=80, pattern='^[A-Za-z0-9][A-Za-z0-9._-]{7,79}$')`
- `exact_scope_digest: Sha256Digest | None = None`
- `readout_hmac: Sha256Digest | None = None`

#### Methods

##### `lightbulb.growth_experiments.GrowthExperimentReadout.hmac_payload`



~~~python
def hmac_payload() -> dict[str, Any]
~~~


Source: `lightbulb/growth_experiments.py:1521`.

##### `lightbulb.growth_experiments.GrowthExperimentReadout.to_dict`



~~~python
def to_dict() -> dict[str, Any]
~~~


Source: `lightbulb/growth_experiments.py:1529`.

### `lightbulb.growth_experiments.read_out_growth_experiment`

function. Source: `lightbulb/growth_experiments.py:1537`.



~~~python
read_out_growth_experiment(design: GrowthExperimentDesign | Mapping[str, Any], arm_evidence: tuple[ExperimentArmEvidence | Mapping[str, Any], ...] | list[ExperimentArmEvidence | Mapping[str, Any]], *, readout_ref: str, analysis_as_of: str, scope: DynamicWorkflowScope | Mapping[str, Any], scope_keyring: ExactScopeDigestProvider, scope_key_id: str | None=None) -> GrowthExperimentReadout
~~~


Produce the sealed fixed-horizon readout for a preregistered design.

### `lightbulb.growth_experiments.verify_growth_experiment_readout`

function. Source: `lightbulb/growth_experiments.py:1873`.



~~~python
verify_growth_experiment_readout(value: GrowthExperimentReadout | Mapping[str, Any], *, scope: DynamicWorkflowScope | Mapping[str, Any], scope_keyring: ExactScopeDigestProvider) -> GrowthExperimentReadout
~~~


## Module `lightbulb.growth_funnel`

Cross-connector growth funnel model with sealed analytics evidence.

### `lightbulb.growth_funnel.GrowthFunnelValidationError`

class. Source: `lightbulb/growth_funnel.py:263`.

Funnel evidence or snapshot content violates the sealed contract.

### `lightbulb.growth_funnel.GrowthMetrics`

class. Source: `lightbulb/growth_funnel.py:380`.

Normalized per-observation metrics.

Fields:
- `impressions: int | None = Field(default=None, ge=0)`
- `clicks: int | None = Field(default=None, ge=0)`
- `engagements: int | None = Field(default=None, ge=0)`
- `conversions: int | None = Field(default=None, ge=0)`
- `sessions: int | None = Field(default=None, ge=0)`
- `orders: int | None = Field(default=None, ge=0)`
- `leads: int | None = Field(default=None, ge=0)`
- `opportunities: int | None = Field(default=None, ge=0)`
- `won_deals: int | None = Field(default=None, ge=0)`
- `revenue: Decimal | None = Field(default=None, ge=0, multiple_of=_MONEY_QUANTUM)`
- `conversion_rate: Decimal | None = Field(default=None, ge=0, le=1, multiple_of=_RATE_QUANTUM)`
- `click_through_rate: Decimal | None = Field(default=None, ge=0, le=1, multiple_of=_RATE_QUANTUM)`
- `engagement_rate: Decimal | None = Field(default=None, ge=0, le=1, multiple_of=_RATE_QUANTUM)`
- `pipeline_win_rate: Decimal | None = Field(default=None, ge=0, le=1, multiple_of=_RATE_QUANTUM)`
- `followers: int | None = Field(default=None, ge=0)`
- `list_size: int | None = Field(default=None, ge=0)`
- `unique_visitors: int | None = Field(default=None, ge=0)`
- `checkouts_started: int | None = Field(default=None, ge=0)`
- `repeat_orders: int | None = Field(default=None, ge=0)`
- `repeat_customers: int | None = Field(default=None, ge=0)`
- `churn_events: int | None = Field(default=None, ge=0)`

### `lightbulb.growth_funnel.GrowthFunnelEvidence`

class. Source: `lightbulb/growth_funnel.py:446`.

One sealed connector observation admissible into funnel snapshots.

Fields:
- `schema_id: Literal['lightbulb.growth_funnel_evidence.v1', 'lightbulb.growth_funnel_evidence.v2'] = Field(default=GROWTH_FUNNEL_EVIDENCE_SCHEMA, alias='schema')`
- `observation_ref: PortableRef`
- `connector_account_ref: OperationRef`
- `provider: AnalyticsProvider`
- `source_capability: str = Field(min_length=3, max_length=160, pattern='^[a-z][a-z0-9_-]{0,63}\\.[a-z][a-z0-9_.-]{0,127}$')`
- `observed_at: str`
- `window_start: str`
- `window_end: str`
- `sample_size: int = Field(ge=0, le=10000000000)`
- `metrics: GrowthMetrics`
- `currency: CurrencyCode | None = None`
- `evidence_digest: Sha256Digest`
- `receipt_key_id: str | None = Field(default=None, min_length=8, max_length=80, pattern='^[A-Za-z0-9][A-Za-z0-9._-]{7,79}$')`
- `exact_scope_digest: Sha256Digest | None = None`
- `snapshot_hmac: Sha256Digest | None = None`

#### Methods

##### `lightbulb.growth_funnel.GrowthFunnelEvidence.basis`



~~~python
@property
def basis() -> FunnelBasis
~~~


Source: `lightbulb/growth_funnel.py:534`.

##### `lightbulb.growth_funnel.GrowthFunnelEvidence.hmac_payload`



~~~python
def hmac_payload() -> dict[str, Any]
~~~


Return the complete canonical observation covered by host HMAC.

Source: `lightbulb/growth_funnel.py:541`.

##### `lightbulb.growth_funnel.GrowthFunnelEvidence.is_attested`



~~~python
@property
def is_attested() -> bool
~~~


Source: `lightbulb/growth_funnel.py:538`.

##### `lightbulb.growth_funnel.GrowthFunnelEvidence.legacy_hmac_payload`



~~~python
def legacy_hmac_payload() -> dict[str, Any]
~~~


Return the pre-v2 count-only envelope covered by legacy HMACs.

Source: `lightbulb/growth_funnel.py:551`.

### `lightbulb.growth_funnel.mint_growth_funnel_evidence`

function. Source: `lightbulb/growth_funnel.py:561`.



~~~python
mint_growth_funnel_evidence(value: GrowthFunnelEvidence | Mapping[str, Any], *, scope: DynamicWorkflowScope | Mapping[str, Any], scope_keyring: ExactScopeDigestProvider, scope_key_id: str | None=None) -> GrowthFunnelEvidence
~~~


Seal one host-verified connector observation for funnel use.

### `lightbulb.growth_funnel.verify_growth_funnel_evidence`

function. Source: `lightbulb/growth_funnel.py:688`.



~~~python
verify_growth_funnel_evidence(value: GrowthFunnelEvidence | Mapping[str, Any], *, scope: DynamicWorkflowScope | Mapping[str, Any], scope_keyring: ExactScopeDigestProvider) -> GrowthFunnelEvidence
~~~


Re-validate and verify one sealed evidence envelope; raise on failure.

### `lightbulb.growth_funnel.FunnelReferenceRate`

class. Source: `lightbulb/growth_funnel.py:719`.

A comparison rate with explicit provenance quality.

Fields:
- `rate_name: RateName`
- `value: Decimal = Field(gt=0, le=1, multiple_of=_RATE_QUANTUM)`
- `quality: ReferenceQuality`
- `source_digest: Sha256Digest | None = None`

### `lightbulb.growth_funnel.FunnelStalenessPolicy`

class. Source: `lightbulb/growth_funnel.py:770`.

Admission budget for evidence age and verification requirements.

Fields:
- `max_evidence_age_hours: int = Field(default=720, ge=1, le=8760)`
- `require_verified_evidence: bool = False`

### `lightbulb.growth_funnel.ExpectedFunnelContribution`

class. Source: `lightbulb/growth_funnel.py:777`.

Declares that a stage expects evidence from a specific account.

Fields:
- `stage: FunnelStage`
- `connector_account_ref: OperationRef`

### `lightbulb.growth_funnel.BuildGrowthFunnelSnapshotInput`

class. Source: `lightbulb/growth_funnel.py:784`.

Fields:
- `analysis_as_of: str`
- `snapshot_ref: PortableRef`
- `evidence: tuple[GrowthFunnelEvidence, ...] = Field(min_length=1, max_length=_MAX_FUNNEL_EVIDENCE)`
- `staleness_policy: FunnelStalenessPolicy = Field(default_factory=FunnelStalenessPolicy)`
- `reference_rates: tuple[FunnelReferenceRate, ...] = Field(default_factory=tuple, max_length=_MAX_REFERENCE_RATES)`
- `expected_contributions: tuple[ExpectedFunnelContribution, ...] = Field(default_factory=tuple, max_length=_MAX_EXPECTED_CONTRIBUTIONS)`

### `lightbulb.growth_funnel.StageMetricTotal`

class. Source: `lightbulb/growth_funnel.py:838`.

Fields:
- `metric: MetricName`
- `basis: FunnelBasis`
- `unit: Literal['count', 'money']`
- `value: Decimal = Field(ge=0)`
- `evidence_count: int = Field(ge=1)`
- `account_count: int = Field(ge=1)`

### `lightbulb.growth_funnel.StageAggregate`

class. Source: `lightbulb/growth_funnel.py:862`.

Fields:
- `stage: FunnelStage`
- `completeness: Literal['present', 'partial', 'unknown']`
- `totals: tuple[StageMetricTotal, ...] = Field(default_factory=tuple)`
- `missing_expected_accounts: tuple[OperationRef, ...] = Field(default_factory=tuple)`

### `lightbulb.growth_funnel.FunnelRateSide`

class. Source: `lightbulb/growth_funnel.py:890`.

Fields:
- `metric: MetricName`
- `stage: FunnelStage`
- `basis: FunnelBasis`
- `value: Decimal = Field(ge=0)`

### `lightbulb.growth_funnel.FunnelRate`

class. Source: `lightbulb/growth_funnel.py:902`.

Fields:
- `rate_name: RateName`
- `value: Decimal = Field(ge=0, multiple_of=_RATE_QUANTUM)`
- `numerator: FunnelRateSide`
- `denominator: FunnelRateSide`
- `cross_basis: bool`
- `anomalous: bool`

### `lightbulb.growth_funnel.DerivedFunnelValue`

class. Source: `lightbulb/growth_funnel.py:926`.

Fields:
- `name: DerivedValueName`
- `value: Decimal = Field(ge=0, multiple_of=_MONEY_QUANTUM)`
- `numerator: FunnelRateSide`
- `denominator: FunnelRateSide`

### `lightbulb.growth_funnel.FunnelBottleneck`

class. Source: `lightbulb/growth_funnel.py:938`.

Fields:
- `rate_name: RateName`
- `observed: Decimal = Field(ge=0, multiple_of=_RATE_QUANTUM)`
- `reference: FunnelReferenceRate`
- `shortfall: Decimal = Field(ge=0, lt=1, multiple_of=_RATE_QUANTUM)`

### `lightbulb.growth_funnel.AdmittedFunnelEvidence`

class. Source: `lightbulb/growth_funnel.py:950`.

Fields:
- `observation_ref: PortableRef`
- `evidence_digest: Sha256Digest`
- `provider: AnalyticsProvider`
- `basis: FunnelBasis`
- `connector_account_ref: OperationRef`
- `window_start: str`
- `window_end: str`
- `verified: bool`

### `lightbulb.growth_funnel.ExcludedFunnelEvidence`

class. Source: `lightbulb/growth_funnel.py:966`.

Fields:
- `observation_ref: PortableRef`
- `evidence_digest: Sha256Digest`
- `reason: ExclusionReason`

### `lightbulb.growth_funnel.GrowthFunnelSnapshot`

class. Source: `lightbulb/growth_funnel.py:972`.

Sealed six-stage funnel state derived from admissible evidence only.

Fields:
- `schema_id: Literal['lightbulb.growth_funnel_snapshot.v2'] = Field(default=GROWTH_FUNNEL_SNAPSHOT_SCHEMA, alias='schema')`
- `snapshot_ref: PortableRef`
- `analysis_as_of: str`
- `currency: CurrencyCode | None = None`
- `evidence_scope_status: EvidenceScopeStatus`
- `staleness_policy: FunnelStalenessPolicy`
- `stages: tuple[StageAggregate, ...]`
- `rates: tuple[FunnelRate, ...] = Field(default_factory=tuple)`
- `derived_values: tuple[DerivedFunnelValue, ...] = Field(default_factory=tuple)`
- `bottleneck: FunnelBottleneck | None = None`
- `bottleneck_reason: ShortText | None = None`
- `reference_rates: tuple[FunnelReferenceRate, ...] = Field(default_factory=tuple)`
- `admitted_evidence: tuple[AdmittedFunnelEvidence, ...] = Field(default_factory=tuple)`
- `excluded_evidence: tuple[ExcludedFunnelEvidence, ...] = Field(default_factory=tuple)`
- `funnel_digest: Sha256Digest = '0' * 64`
- `receipt_key_id: str | None = Field(default=None, min_length=8, max_length=80, pattern='^[A-Za-z0-9][A-Za-z0-9._-]{7,79}$')`
- `exact_scope_digest: Sha256Digest | None = None`
- `funnel_hmac: Sha256Digest | None = None`

#### Methods

##### `lightbulb.growth_funnel.GrowthFunnelSnapshot.hmac_payload`



~~~python
def hmac_payload() -> dict[str, Any]
~~~


Source: `lightbulb/growth_funnel.py:1071`.

##### `lightbulb.growth_funnel.GrowthFunnelSnapshot.stage`



~~~python
def stage(stage: FunnelStage) -> StageAggregate
~~~


Source: `lightbulb/growth_funnel.py:1079`.

##### `lightbulb.growth_funnel.GrowthFunnelSnapshot.to_dict`



~~~python
def to_dict() -> dict[str, Any]
~~~


Source: `lightbulb/growth_funnel.py:1085`.

### `lightbulb.growth_funnel.build_growth_funnel_snapshot`

function. Source: `lightbulb/growth_funnel.py:1206`.



~~~python
build_growth_funnel_snapshot(inputs: BuildGrowthFunnelSnapshotInput | Mapping[str, Any], *, scope: DynamicWorkflowScope | Mapping[str, Any] | None=None, scope_keyring: ExactScopeDigestProvider | None=None, scope_key_id: str | None=None) -> GrowthFunnelSnapshot
~~~


Compute one sealed funnel snapshot from admissible evidence.

### `lightbulb.growth_funnel.verify_growth_funnel_snapshot`

function. Source: `lightbulb/growth_funnel.py:1521`.



~~~python
verify_growth_funnel_snapshot(value: GrowthFunnelSnapshot | Mapping[str, Any], *, scope: DynamicWorkflowScope | Mapping[str, Any], scope_keyring: ExactScopeDigestProvider) -> GrowthFunnelSnapshot
~~~


Re-validate and verify one sealed funnel snapshot; raise on failure.

## Module `lightbulb.growth_ingestion`

Evidence ingestion: real connector responses become sealable evidence.

### `lightbulb.growth_ingestion.GrowthIngestionError`

class. Source: `lightbulb/growth_ingestion.py:108`.

A connector response cannot be normalized into canonical evidence.

### `lightbulb.growth_ingestion.MetricCoverage`

class. Source: `lightbulb/growth_ingestion.py:136`.

An honest account of what ingestion did and did not map.

Fields:
- `provider: AnalyticsProvider`
- `source_capability: str`
- `populated_metrics: tuple[str, ...]`
- `source_fields_used: tuple[str, ...]`
- `unrecognized_response_fields: tuple[str, ...]`

### `lightbulb.growth_ingestion.IngestionResult`

class. Source: `lightbulb/growth_ingestion.py:158`.

Fields:
- `schema_id: Literal['lightbulb.growth_ingestion_result.v2'] = Field(default=GROWTH_INGESTION_RESULT_SCHEMA, alias='schema')`
- `evidence: GrowthFunnelEvidence`
- `coverage: MetricCoverage`

#### Methods

##### `lightbulb.growth_ingestion.IngestionResult.to_dict`



~~~python
def to_dict() -> dict[str, Any]
~~~


Source: `lightbulb/growth_ingestion.py:166`.

### `lightbulb.growth_ingestion.normalize_connector_response`

function. Source: `lightbulb/growth_ingestion.py:688`.



~~~python
normalize_connector_response(*, source_capability: str, response: Mapping[str, Any], observation_ref: str, connector_account_ref: str, window_start: str, window_end: str, observed_at: str, sample_size: int | None=None, currency: str | None=None) -> IngestionResult
~~~


Normalize one raw connector analytics response into sealable evidence.

### `lightbulb.growth_ingestion.ingestion_capabilities`

function. Source: `lightbulb/growth_ingestion.py:787`.



~~~python
ingestion_capabilities() -> tuple[dict[str, str], ...]
~~~


Discoverable list of supported ingestion capabilities and providers.

## Module `lightbulb.growth_learnings`

Durable, integrity-sealed growth learnings ledger (growth memory).

### `lightbulb.growth_learnings.GrowthLearningsValidationError`

class. Source: `lightbulb/growth_learnings.py:119`.

Learning content violates the ledger contract.

### `lightbulb.growth_learnings.GrowthLearningsConflictError`

class. Source: `lightbulb/growth_learnings.py:123`.

A concurrent append advanced the ledger first; reload and retry.

### `lightbulb.growth_learnings.GrowthLearningsPersistenceError`

class. Source: `lightbulb/growth_learnings.py:127`.

The ledger store is unavailable, corrupt, or tampered.

### `lightbulb.growth_learnings.GrowthLearningEntry`

class. Source: `lightbulb/growth_learnings.py:278`.

One sealed, chained fact in the growth memory.

Fields:
- `schema_id: Literal['lightbulb.growth_learning_entry.v1'] = Field(default=GROWTH_LEARNING_ENTRY_SCHEMA, alias='schema')`
- `entry_ref: PortableRef`
- `sequence: int = Field(ge=1, le=_MAX_LEDGER_ENTRIES)`
- `prev_entry_digest: Sha256Digest | None = None`
- `recorded_at: str`
- `stage: FunnelStage`
- `lever: PortableRef`
- `audience: ShortText | None = None`
- `metric_name: LearningMetricName`
- `claim: LongText`
- `grade: LearningGrade`
- `causal: bool`
- `effect_estimate: Decimal | None = None`
- `ci_low: Decimal | None = None`
- `ci_high: Decimal | None = None`
- `p_value: Decimal | None = Field(default=None, ge=0, le=1, multiple_of=_RATE_QUANTUM)`
- `design_digest: Sha256Digest | None = None`
- `readout_digest: Sha256Digest | None = None`
- `evidence_digests: tuple[Sha256Digest, ...] = Field(default_factory=tuple, max_length=_MAX_EVIDENCE_DIGESTS)`
- `valid_until: str | None = None`
- `supersedes: Sha256Digest | None = None`
- `entry_digest: Sha256Digest = '0' * 64`
- `receipt_key_id: str | None = Field(default=None, min_length=8, max_length=80, pattern='^[A-Za-z0-9][A-Za-z0-9._-]{7,79}$')`
- `exact_scope_digest: Sha256Digest | None = None`
- `entry_hmac: Sha256Digest | None = None`

#### Methods

##### `lightbulb.growth_learnings.GrowthLearningEntry.hmac_payload`



~~~python
def hmac_payload() -> dict[str, Any]
~~~


Source: `lightbulb/growth_learnings.py:429`.

##### `lightbulb.growth_learnings.GrowthLearningEntry.to_dict`



~~~python
def to_dict() -> dict[str, Any]
~~~


Source: `lightbulb/growth_learnings.py:437`.

### `lightbulb.growth_learnings.mint_growth_learning_entry`

function. Source: `lightbulb/growth_learnings.py:441`.



~~~python
mint_growth_learning_entry(value: GrowthLearningEntry | Mapping[str, Any], *, scope: DynamicWorkflowScope | Mapping[str, Any], scope_keyring: ExactScopeDigestProvider, scope_key_id: str | None=None) -> GrowthLearningEntry
~~~


### `lightbulb.growth_learnings.verify_growth_learning_entry`

function. Source: `lightbulb/growth_learnings.py:490`.



~~~python
verify_growth_learning_entry(value: GrowthLearningEntry | Mapping[str, Any], *, scope: DynamicWorkflowScope | Mapping[str, Any], scope_keyring: ExactScopeDigestProvider) -> GrowthLearningEntry
~~~


### `lightbulb.growth_learnings.InMemoryLedgerStore`

class. Source: `lightbulb/growth_learnings.py:550`.

#### Methods

##### `lightbulb.growth_learnings.InMemoryLedgerStore.load`



~~~python
def load() -> tuple[int, tuple[dict[str, Any], ...]]
~~~


Source: `lightbulb/growth_learnings.py:556`.

##### `lightbulb.growth_learnings.InMemoryLedgerStore.save`



~~~python
def save(*, expected_revision: int, entries: tuple[dict[str, Any], ...]) -> int
~~~


Source: `lightbulb/growth_learnings.py:562`.

### `lightbulb.growth_learnings.JsonFileLedgerStore`

class. Source: `lightbulb/growth_learnings.py:674`.

Atomic local persistence for one scope's ledger file.

#### Methods

##### `lightbulb.growth_learnings.JsonFileLedgerStore.load`



~~~python
def load() -> tuple[int, tuple[dict[str, Any], ...]]
~~~


Source: `lightbulb/growth_learnings.py:713`.

##### `lightbulb.growth_learnings.JsonFileLedgerStore.save`



~~~python
def save(*, expected_revision: int, entries: tuple[dict[str, Any], ...]) -> int
~~~


Source: `lightbulb/growth_learnings.py:716`.

### `lightbulb.growth_learnings.GrowthLearningsLedger`

class. Source: `lightbulb/growth_learnings.py:748`.

Scope-bound view over one verified learning chain.

#### Methods

##### `lightbulb.growth_learnings.GrowthLearningsLedger.entries`



~~~python
def entries() -> tuple[GrowthLearningEntry, ...]
~~~


Source: `lightbulb/growth_learnings.py:801`.

##### `lightbulb.growth_learnings.GrowthLearningsLedger.head_digest`



~~~python
def head_digest() -> str | None
~~~


Source: `lightbulb/growth_learnings.py:805`.

##### `lightbulb.growth_learnings.GrowthLearningsLedger.query`



~~~python
def query(*, as_of: str, stage: FunnelStage | None=None, lever: str | None=None, metric_name: LearningMetricName | None=None, include_superseded: bool=False, limit: int=20) -> tuple[GrowthLearningEntry, ...]
~~~


Return the learnings applicable AS OF the given instant.

Source: `lightbulb/growth_learnings.py:999`.

##### `lightbulb.growth_learnings.GrowthLearningsLedger.record_experiment_learning`



~~~python
def record_experiment_learning(*, design: GrowthExperimentDesign | Mapping[str, Any], readout: GrowthExperimentReadout | Mapping[str, Any], entry_ref: str, lever: str, claim: str, recorded_at: str, audience: str | None=None, valid_until: str | None=None, supersedes: str | None=None) -> GrowthLearningEntry
~~~


Record a causal learning; effect statistics come from the readout.

Source: `lightbulb/growth_learnings.py:866`.

##### `lightbulb.growth_learnings.GrowthLearningsLedger.record_heuristic_learning`



~~~python
def record_heuristic_learning(*, entry_ref: str, lever: str, metric_name: LearningMetricName, claim: str, recorded_at: str, effect_estimate: str | Decimal | None=None, audience: str | None=None, valid_until: str | None=None, supersedes: str | None=None) -> GrowthLearningEntry
~~~


Record an assumption; ranks last and carries no provenance.

Source: `lightbulb/growth_learnings.py:964`.

##### `lightbulb.growth_learnings.GrowthLearningsLedger.record_observational_learning`



~~~python
def record_observational_learning(*, entry_ref: str, lever: str, metric_name: LearningMetricName, claim: str, recorded_at: str, funnel_snapshot: GrowthFunnelSnapshot | Mapping[str, Any] | None=None, evidence_digests: tuple[str, ...] | list[str] | None=None, effect_estimate: str | Decimal | None=None, audience: str | None=None, valid_until: str | None=None, supersedes: str | None=None) -> GrowthLearningEntry
~~~


Record a non-causal finding backed by named evidence digests.

Source: `lightbulb/growth_learnings.py:920`.

##### `lightbulb.growth_learnings.GrowthLearningsLedger.scope`



~~~python
@property
def scope() -> DynamicWorkflowScope
~~~


This ledger's authority scope (a frozen, immutable model).

Source: `lightbulb/growth_learnings.py:765`.

##### `lightbulb.growth_learnings.GrowthLearningsLedger.verify_chain`



~~~python
def verify_chain(*, expected_head_digest: str | None=None, expected_length: int | None=None) -> int
~~~


Fully re-verify the chain; return the entry count.

Source: `lightbulb/growth_learnings.py:809`.

## Module `lightbulb.growth_mandate`

Growth mandate: bounded autonomy the human can actually grant.

### `lightbulb.growth_mandate.GrowthMandateValidationError`

class. Source: `lightbulb/growth_mandate.py:134`.

Mandate, action, or receipt content violates the delegation contract.

### `lightbulb.growth_mandate.EconomicsGuardrail`

class. Source: `lightbulb/growth_mandate.py:299`.

The action is allowed only while a sealed economics component holds.

Fields:
- `kind: Literal['economics_bound'] = 'economics_bound'`
- `metric: GuardrailMetric`
- `bound: Literal['floor', 'ceiling']`
- `threshold: Decimal`
- `max_evidence_age_hours: int = Field(default=720, ge=1, le=8760)`

### `lightbulb.growth_mandate.ObjectiveVerdictGuardrail`

class. Source: `lightbulb/growth_mandate.py:320`.

The action is allowed only while the objective's verdict is listed.

Fields:
- `kind: Literal['objective_verdict'] = 'objective_verdict'`
- `allowed_verdicts: tuple[ObjectiveVerdictName, ...] = Field(min_length=1, max_length=5)`
- `max_evidence_age_hours: int = Field(default=336, ge=1, le=8760)`

### `lightbulb.growth_mandate.MandateGrant`

class. Source: `lightbulb/growth_mandate.py:357`.

One delegated action kind with its money ceilings and guardrails.

Fields:
- `action_kind: MandateActionKind`
- `per_action_limit: Decimal = Field(ge=0, multiple_of=_MONEY_QUANTUM)`
- `window_limit: Decimal = Field(ge=0, multiple_of=_MONEY_QUANTUM)`
- `window_days: int = Field(ge=1, le=366)`
- `guardrails: tuple[MandateGuardrail, ...] = Field(default_factory=tuple, max_length=_MAX_GUARDRAILS)`

### `lightbulb.growth_mandate.GrowthMandate`

class. Source: `lightbulb/growth_mandate.py:387`.

A sealed delegation of bounded authority. The HMAC is the grant.

Fields:
- `schema_id: Literal['lightbulb.growth_mandate.v1'] = Field(default=GROWTH_MANDATE_SCHEMA, alias='schema')`
- `mandate_ref: PortableRef`
- `granted_by: ShortText`
- `granted_to: ShortText`
- `currency: CurrencyCode`
- `granted_at: str`
- `expires_at: str`
- `grants: tuple[MandateGrant, ...] = Field(min_length=1, max_length=_MAX_GRANTS)`
- `rationale: LongText`
- `supersedes: Sha256Digest | None = None`
- `mandate_digest: Sha256Digest = '0' * 64`
- `receipt_key_id: str | None = Field(default=None, min_length=8, max_length=80, pattern='^[A-Za-z0-9][A-Za-z0-9._-]{7,79}$')`
- `exact_scope_digest: Sha256Digest | None = None`
- `mandate_hmac: Sha256Digest | None = None`

#### Methods

##### `lightbulb.growth_mandate.GrowthMandate.grant_for`



~~~python
def grant_for(action_kind: str) -> MandateGrant | None
~~~


Source: `lightbulb/growth_mandate.py:463`.

##### `lightbulb.growth_mandate.GrowthMandate.hmac_payload`



~~~python
def hmac_payload() -> dict[str, Any]
~~~


Source: `lightbulb/growth_mandate.py:469`.

##### `lightbulb.growth_mandate.GrowthMandate.is_sealed`



~~~python
@property
def is_sealed() -> bool
~~~


Source: `lightbulb/growth_mandate.py:460`.

##### `lightbulb.growth_mandate.GrowthMandate.to_dict`



~~~python
def to_dict() -> dict[str, Any]
~~~


Source: `lightbulb/growth_mandate.py:477`.

### `lightbulb.growth_mandate.GrantGrowthMandateInput`

class. Source: `lightbulb/growth_mandate.py:481`.

Fields:
- `mandate_ref: PortableRef`
- `granted_by: ShortText`
- `granted_to: ShortText`
- `currency: CurrencyCode`
- `granted_at: str`
- `expires_at: str`
- `grants: tuple[MandateGrant, ...] = Field(min_length=1, max_length=_MAX_GRANTS)`
- `rationale: LongText`
- `supersedes: Sha256Digest | None = None`

### `lightbulb.growth_mandate.grant_growth_mandate`

function. Source: `lightbulb/growth_mandate.py:503`.



~~~python
grant_growth_mandate(inputs: GrantGrowthMandateInput | Mapping[str, Any], *, scope: DynamicWorkflowScope | Mapping[str, Any], scope_keyring: ExactScopeDigestProvider, scope_key_id: str | None=None) -> GrowthMandate
~~~


Seal a delegation of bounded authority.

### `lightbulb.growth_mandate.verify_growth_mandate`

function. Source: `lightbulb/growth_mandate.py:566`.



~~~python
verify_growth_mandate(value: GrowthMandate | Mapping[str, Any], *, scope: DynamicWorkflowScope | Mapping[str, Any], scope_keyring: ExactScopeDigestProvider) -> GrowthMandate
~~~


Re-validate and verify one sealed mandate; raise on failure.

### `lightbulb.growth_mandate.ProposedAction`

class. Source: `lightbulb/growth_mandate.py:609`.

What the agent wants to do, stated in money before it happens.

Fields:
- `action_ref: PortableRef`
- `action_kind: MandateActionKind`
- `amount: Decimal = Field(ge=0, multiple_of=_MONEY_QUANTUM)`
- `currency: CurrencyCode`
- `description: LongText`
- `plan_digest: Sha256Digest | None = None`

### `lightbulb.growth_mandate.GuardrailCheck`

class. Source: `lightbulb/growth_mandate.py:625`.

One guardrail's evaluation, pinned to the evidence it consulted.

Fields:
- `description: ShortText`
- `status: GuardrailStatus`
- `observed: ShortText | None = None`
- `threshold: ShortText | None = None`
- `evidence_digest: Sha256Digest | None = None`
- `note: ShortText | None = None`

### `lightbulb.growth_mandate.ActionAuthorization`

class. Source: `lightbulb/growth_mandate.py:636`.

One sealed gate decision. Approvals and denials leave the same trail.

Fields:
- `schema_id: Literal['lightbulb.action_authorization.v1'] = Field(default=ACTION_AUTHORIZATION_SCHEMA, alias='schema')`
- `authorization_ref: PortableRef`
- `mandate_ref: PortableRef`
- `mandate_digest: Sha256Digest`
- `decided_at: str`
- `action_ref: PortableRef`
- `action_kind: MandateActionKind`
- `amount: Decimal = Field(ge=0, multiple_of=_MONEY_QUANTUM)`
- `currency: CurrencyCode`
- `description: LongText`
- `plan_digest: Sha256Digest | None = None`
- `verdict: AuthorizationVerdict`
- `reasons: tuple[ShortText, ...] = Field(min_length=1, max_length=_MAX_REASONS)`
- `checks: tuple[GuardrailCheck, ...] = Field(default_factory=tuple, max_length=_MAX_CHECKS)`
- `per_action_limit: Decimal | None = Field(default=None, ge=0, multiple_of=_MONEY_QUANTUM)`
- `window_limit: Decimal | None = Field(default=None, ge=0, multiple_of=_MONEY_QUANTUM)`
- `window_days: int | None = Field(default=None, ge=1, le=366)`
- `window_spent_before: Decimal | None = Field(default=None, ge=0, multiple_of=_MONEY_QUANTUM)`
- `window_remaining_after: Decimal | None = Field(default=None, ge=0, multiple_of=_MONEY_QUANTUM)`
- `prior_receipts_counted: int = Field(ge=0, le=_MAX_PRIOR_AUTHORIZATIONS)`
- `authorization_digest: Sha256Digest = '0' * 64`
- `receipt_key_id: str | None = Field(default=None, min_length=8, max_length=80, pattern='^[A-Za-z0-9][A-Za-z0-9._-]{7,79}$')`
- `exact_scope_digest: Sha256Digest | None = None`
- `authorization_hmac: Sha256Digest | None = None`

#### Methods

##### `lightbulb.growth_mandate.ActionAuthorization.hmac_payload`



~~~python
def hmac_payload() -> dict[str, Any]
~~~


Source: `lightbulb/growth_mandate.py:754`.

##### `lightbulb.growth_mandate.ActionAuthorization.is_sealed`



~~~python
@property
def is_sealed() -> bool
~~~


Source: `lightbulb/growth_mandate.py:751`.

##### `lightbulb.growth_mandate.ActionAuthorization.to_dict`



~~~python
def to_dict() -> dict[str, Any]
~~~


Source: `lightbulb/growth_mandate.py:762`.

### `lightbulb.growth_mandate.verify_action_authorization`

function. Source: `lightbulb/growth_mandate.py:766`.



~~~python
verify_action_authorization(value: ActionAuthorization | Mapping[str, Any], *, scope: DynamicWorkflowScope | Mapping[str, Any], scope_keyring: ExactScopeDigestProvider) -> ActionAuthorization
~~~


Re-validate and verify one sealed authorization; raise on failure.

### `lightbulb.growth_mandate.AuthorizeActionInput`

class. Source: `lightbulb/growth_mandate.py:1085`.

Gate inputs. Deliberately NO assessment field: advisory verdicts are caller-forgeable, so the objective guardrail derives its own.

Fields:
- `as_of: str`
- `authorization_ref: PortableRef`
- `mandate: GrowthMandate`
- `action: ProposedAction`
- `prior_authorizations: tuple[ActionAuthorization, ...] = Field(default_factory=tuple, max_length=_MAX_PRIOR_AUTHORIZATIONS)`
- `current_economics: UnitEconomicsSnapshot | None = None`
- `objective: GrowthObjective | None = None`

### `lightbulb.growth_mandate.authorize_growth_action`

function. Source: `lightbulb/growth_mandate.py:1135`.



~~~python
authorize_growth_action(inputs: AuthorizeActionInput | Mapping[str, Any], *, scope: DynamicWorkflowScope | Mapping[str, Any], scope_keyring: ExactScopeDigestProvider, scope_key_id: str | None=None) -> ActionAuthorization
~~~


Decide one proposed action against the mandate; mint a sealed receipt.

### `lightbulb.growth_mandate.MandateCheck`

class. Source: `lightbulb/growth_mandate.py:1348`.

What the gate WOULD say. Advisory; no receipt was minted.

Fields:
- `schema_id: Literal['lightbulb.mandate_check.v1'] = Field(default=MANDATE_CHECK_SCHEMA, alias='schema')`
- `as_of: str`
- `mandate_digest: Sha256Digest`
- `action_ref: PortableRef`
- `action_kind: MandateActionKind`
- `amount: Decimal = Field(ge=0, multiple_of=_MONEY_QUANTUM)`
- `currency: CurrencyCode`
- `predicted_verdict: AuthorizationVerdict`
- `reasons: tuple[ShortText, ...] = Field(min_length=1, max_length=_MAX_REASONS)`
- `checks: tuple[GuardrailCheck, ...] = Field(default_factory=tuple, max_length=_MAX_CHECKS)`
- `window_spent_before: Decimal | None = Field(default=None, ge=0, multiple_of=_MONEY_QUANTUM)`
- `label: Literal['preflight_no_receipt_minted'] = 'preflight_no_receipt_minted'`
- `data_quality_notes: tuple[ShortText, ...] = Field(default_factory=tuple, max_length=10)`
- `check_digest: Sha256Digest = '0' * 64`

#### Methods

##### `lightbulb.growth_mandate.MandateCheck.to_dict`



~~~python
def to_dict() -> dict[str, Any]
~~~


Source: `lightbulb/growth_mandate.py:1406`.

### `lightbulb.growth_mandate.PreflightActionInput`

class. Source: `lightbulb/growth_mandate.py:1410`.

Fields:
- `as_of: str`
- `mandate: GrowthMandate`
- `action: ProposedAction`
- `prior_authorizations: tuple[ActionAuthorization, ...] = Field(default_factory=tuple, max_length=_MAX_PRIOR_AUTHORIZATIONS)`
- `current_economics: UnitEconomicsSnapshot | None = None`
- `objective: GrowthObjective | None = None`

### `lightbulb.growth_mandate.preflight_growth_action`

function. Source: `lightbulb/growth_mandate.py:1446`.



~~~python
preflight_growth_action(inputs: PreflightActionInput | Mapping[str, Any]) -> MandateCheck
~~~


Dry-run the gate. Advisory: nothing is verified, nothing is minted.

### `lightbulb.growth_mandate.PreflightActionPrimitive`

class. Source: `lightbulb/growth_mandate.py:1560`.

Dry-run a proposed action against a growth mandate.

## Module `lightbulb.growth_money_ingestion`

Money evidence ingestion: contribution ledgers and acquisition cohorts.

### `lightbulb.growth_money_ingestion.GrowthMoneyIngestionError`

class. Source: `lightbulb/growth_money_ingestion.py:69`.

A connector response cannot be normalized into money evidence.

### `lightbulb.growth_money_ingestion.LedgerIngestionResult`

class. Source: `lightbulb/growth_money_ingestion.py:128`.

Fields:
- `schema_id: Literal['lightbulb.growth_ledger_ingestion_result.v1'] = Field(default=LEDGER_INGESTION_RESULT_SCHEMA, alias='schema')`
- `evidence: ProfitContributionEvidence`
- `coverage: MetricCoverage`

#### Methods

##### `lightbulb.growth_money_ingestion.LedgerIngestionResult.to_dict`



~~~python
def to_dict() -> dict[str, Any]
~~~


Source: `lightbulb/growth_money_ingestion.py:136`.

### `lightbulb.growth_money_ingestion.CohortIngestionResult`

class. Source: `lightbulb/growth_money_ingestion.py:140`.

Fields:
- `schema_id: Literal['lightbulb.growth_cohort_ingestion_result.v1'] = Field(default=COHORT_INGESTION_RESULT_SCHEMA, alias='schema')`
- `cohorts: tuple[CustomerCohortEvidence, ...] = Field(min_length=1)`
- `coverage: MetricCoverage`

#### Methods

##### `lightbulb.growth_money_ingestion.CohortIngestionResult.to_dict`



~~~python
def to_dict() -> dict[str, Any]
~~~


Source: `lightbulb/growth_money_ingestion.py:155`.

### `lightbulb.growth_money_ingestion.normalize_contribution_ledger_response`

function. Source: `lightbulb/growth_money_ingestion.py:240`.



~~~python
normalize_contribution_ledger_response(*, source_capability: str, response: Mapping[str, Any], observation_ref: str, connector_account_ref: str, currency: str, window_start: str, window_end: str, observed_at: str) -> LedgerIngestionResult
~~~


Normalize one raw ledger-shaped response into sealable profit evidence.

### `lightbulb.growth_money_ingestion.normalize_customer_cohorts_response`

function. Source: `lightbulb/growth_money_ingestion.py:372`.



~~~python
normalize_customer_cohorts_response(*, source_capability: str, response: Mapping[str, Any], connector_account_ref: str, currency: str, observed_at: str) -> CohortIngestionResult
~~~


Normalize one cohort-grouped response into sealable cohort evidence.

### `lightbulb.growth_money_ingestion.money_ingestion_capabilities`

function. Source: `lightbulb/growth_money_ingestion.py:538`.



~~~python
money_ingestion_capabilities() -> tuple[dict[str, Any], ...]
~~~


Discoverable list of money-ingestion capabilities and their status.

## Module `lightbulb.growth_objectives`

Growth objectives: the sealed target the whole engine drives toward.

### `lightbulb.growth_objectives.GrowthObjectivesValidationError`

class. Source: `lightbulb/growth_objectives.py:101`.

Objective or assessment content violates the commitment contract.

### `lightbulb.growth_objectives.GrowthObjective`

class. Source: `lightbulb/growth_objectives.py:330`.

A sealed growth commitment. The HMAC is what makes it binding.

Fields:
- `schema_id: Literal['lightbulb.growth_objective.v1'] = Field(default=GROWTH_OBJECTIVE_SCHEMA, alias='schema')`
- `objective_ref: PortableRef`
- `metric: ObjectiveMetric`
- `currency: CurrencyCode`
- `period_days: int = Field(ge=7, le=365)`
- `baseline_per_period: Decimal = Field(multiple_of=_MONEY_QUANTUM)`
- `target_per_period: Decimal = Field(gt=0, multiple_of=_MONEY_QUANTUM)`
- `baseline_economics_digest: Sha256Digest`
- `baseline_economics_as_of: str`
- `baseline_window_days: Decimal = Field(gt=0, multiple_of=_RATE_QUANTUM)`
- `baseline_complete: bool`
- `committed_at: str`
- `target_by: str`
- `rationale: LongText`
- `supersedes: Sha256Digest | None = None`
- `objective_digest: Sha256Digest = '0' * 64`
- `receipt_key_id: str | None = Field(default=None, min_length=8, max_length=80, pattern='^[A-Za-z0-9][A-Za-z0-9._-]{7,79}$')`
- `exact_scope_digest: Sha256Digest | None = None`
- `objective_hmac: Sha256Digest | None = None`

#### Methods

##### `lightbulb.growth_objectives.GrowthObjective.hmac_payload`



~~~python
def hmac_payload() -> dict[str, Any]
~~~


Source: `lightbulb/growth_objectives.py:412`.

##### `lightbulb.growth_objectives.GrowthObjective.is_sealed`



~~~python
@property
def is_sealed() -> bool
~~~


Source: `lightbulb/growth_objectives.py:409`.

##### `lightbulb.growth_objectives.GrowthObjective.to_dict`



~~~python
def to_dict() -> dict[str, Any]
~~~


Source: `lightbulb/growth_objectives.py:420`.

### `lightbulb.growth_objectives.CommitGrowthObjectiveInput`

class. Source: `lightbulb/growth_objectives.py:424`.

Fields:
- `objective_ref: PortableRef`
- `target_per_period: Decimal = Field(gt=0, multiple_of=_MONEY_QUANTUM)`
- `period_days: int = Field(default=30, ge=7, le=365)`
- `committed_at: str`
- `target_by: str`
- `rationale: LongText`
- `baseline_economics: UnitEconomicsSnapshot`
- `supersedes: Sha256Digest | None = None`

### `lightbulb.growth_objectives.commit_growth_objective`

function. Source: `lightbulb/growth_objectives.py:445`.



~~~python
commit_growth_objective(inputs: CommitGrowthObjectiveInput | Mapping[str, Any], *, scope: DynamicWorkflowScope | Mapping[str, Any], scope_keyring: ExactScopeDigestProvider, scope_key_id: str | None=None) -> GrowthObjective
~~~


Seal a growth commitment; the baseline comes from verified economics.

### `lightbulb.growth_objectives.verify_growth_objective`

function. Source: `lightbulb/growth_objectives.py:524`.



~~~python
verify_growth_objective(value: GrowthObjective | Mapping[str, Any], *, scope: DynamicWorkflowScope | Mapping[str, Any], scope_keyring: ExactScopeDigestProvider) -> GrowthObjective
~~~


Re-validate and verify one sealed objective; raise on failure.

### `lightbulb.growth_objectives.ObjectivePolicy`

class. Source: `lightbulb/growth_objectives.py:573`.

Assessment tolerances. Heuristics, not truths; deliberately unsealed.

Fields:
- `at_risk_shortfall_ratio: Decimal = Field(default=Decimal('0.100000'), gt=0, le=Decimal('0.5'), multiple_of=_RATE_QUANTUM)`

### `lightbulb.growth_objectives.AssessObjectiveInput`

class. Source: `lightbulb/growth_objectives.py:589`.

Fields:
- `as_of: str`
- `objective: GrowthObjective`
- `current_economics: UnitEconomicsSnapshot`
- `profit_review: ProfitReview | None = None`
- `customer_value_review: CustomerValueReview | None = None`
- `policy: ObjectivePolicy = Field(default_factory=ObjectivePolicy)`

### `lightbulb.growth_objectives.GapFunding`

class. Source: `lightbulb/growth_objectives.py:603`.

What the reviews' opportunities could fund, per period. Not a plan.

Fields:
- `opportunities_counted: int = Field(ge=0)`
- `excluded_incomparable: int = Field(ge=0)`
- `funded_low: Decimal = Field(ge=0, multiple_of=_MONEY_QUANTUM)`
- `funded_expected: Decimal = Field(ge=0, multiple_of=_MONEY_QUANTUM)`
- `funded_high: Decimal = Field(ge=0, multiple_of=_MONEY_QUANTUM)`
- `shortfall_after_expected: Decimal = Field(ge=0, multiple_of=_MONEY_QUANTUM)`
- `source_digests: tuple[Sha256Digest, ...] = Field(default_factory=tuple, max_length=4)`

### `lightbulb.growth_objectives.ObjectiveAssessment`

class. Source: `lightbulb/growth_objectives.py:648`.

One deterministic answer to "are we on track, and what funds the gap".

Fields:
- `schema_id: Literal['lightbulb.growth_objective_assessment.v1'] = Field(default=GROWTH_OBJECTIVE_ASSESSMENT_SCHEMA, alias='schema')`
- `as_of: str`
- `objective_digest: Sha256Digest`
- `objective_ref: PortableRef`
- `currency: CurrencyCode`
- `evidence_scope_status: Literal['caller_supplied_unverified', 'host_hmac_verified']`
- `period_days: int = Field(ge=7, le=365)`
- `baseline_per_period: Decimal = Field(multiple_of=_MONEY_QUANTUM)`
- `target_per_period: Decimal = Field(gt=0, multiple_of=_MONEY_QUANTUM)`
- `observed_per_period: Decimal = Field(multiple_of=_MONEY_QUANTUM)`
- `observed_window_days: Decimal = Field(gt=0, multiple_of=_RATE_QUANTUM)`
- `glide_expected_per_period: Decimal = Field(multiple_of=_MONEY_QUANTUM)`
- `elapsed_ratio: Decimal = Field(ge=0, multiple_of=_RATE_QUANTUM)`
- `remaining_gap_per_period: Decimal = Field(ge=0, multiple_of=_MONEY_QUANTUM)`
- `verdict: ObjectiveVerdict`
- `complete: bool`
- `missing_inputs: tuple[ShortText, ...] = Field(default_factory=tuple)`
- `gap_funding: GapFunding | None = None`
- `economics_digest: Sha256Digest`
- `data_quality_notes: tuple[ShortText, ...] = Field(default_factory=tuple, max_length=20)`
- `assessment_digest: Sha256Digest = '0' * 64`

#### Methods

##### `lightbulb.growth_objectives.ObjectiveAssessment.to_dict`



~~~python
def to_dict() -> dict[str, Any]
~~~


Source: `lightbulb/growth_objectives.py:729`.

### `lightbulb.growth_objectives.assess_objective_progress`

function. Source: `lightbulb/growth_objectives.py:832`.



~~~python
assess_objective_progress(inputs: AssessObjectiveInput | Mapping[str, Any]) -> ObjectiveAssessment
~~~


Deterministically judge progress against the sealed commitment.

### `lightbulb.growth_objectives.AssessObjectivePrimitive`

class. Source: `lightbulb/growth_objectives.py:1097`.

Judge progress against a sealed growth objective.

## Module `lightbulb.growth_operating`

Growth operating loop: the conductor that makes the instruments fire.

### `lightbulb.growth_operating.GrowthOperatingValidationError`

class. Source: `lightbulb/growth_operating.py:187`.

Operating-loop inputs cannot produce an honest agenda or delta.

### `lightbulb.growth_operating.GrowthCadencePolicy`

class. Source: `lightbulb/growth_operating.py:258`.

Operating-cadence thresholds. Heuristics, not truths.

Fields:
- `max_snapshot_age_hours: int = Field(default=168, ge=1, le=8760)`
- `max_economics_age_hours: int = Field(default=720, ge=1, le=8760)`
- `max_customer_value_age_hours: int = Field(default=720, ge=1, le=8760)`
- `max_concurrent_experiments: int = Field(default=3, ge=1, le=50)`
- `learning_expiry_window_hours: int = Field(default=168, ge=1, le=8760)`
- `mandate_expiry_warning_hours: int = Field(default=168, ge=1, le=8760)`
- `escalation_attention_window_hours: int = Field(default=336, ge=1, le=8760)`

### `lightbulb.growth_operating.AgendaItem`

class. Source: `lightbulb/growth_operating.py:282`.

One duty or option, with everything needed to act on it.

Fields:
- `rank: int = Field(ge=1, le=_MAX_AGENDA_ITEMS)`
- `kind: AgendaItemKind`
- `urgency: AgendaUrgency`
- `title: ShortText`
- `mechanism: ShortText`
- `next_primitive_ref: ShortText | None = None`
- `argument_hints: dict[str, str] = Field(default_factory=dict)`
- `blocked_by: tuple[ShortText, ...] = Field(default_factory=tuple, max_length=3)`
- `source_digests: tuple[Sha256Digest, ...] = Field(default_factory=tuple, max_length=_MAX_SOURCE_DIGESTS)`

### `lightbulb.growth_operating.GrowthAgenda`

class. Source: `lightbulb/growth_operating.py:318`.

One deterministic answer to "what does this scope need from me now".

Fields:
- `schema_id: Literal['lightbulb.growth_agenda.v1'] = Field(default=GROWTH_AGENDA_SCHEMA, alias='schema')`
- `as_of: str`
- `policy: GrowthCadencePolicy`
- `evidence_scope_status: EvidenceScopeStatus`
- `items: tuple[AgendaItem, ...] = Field(default_factory=tuple, max_length=_MAX_AGENDA_ITEMS)`
- `idle: bool`
- `wake_at: str | None = None`
- `data_quality_notes: tuple[ShortText, ...] = Field(default_factory=tuple, max_length=20)`
- `agenda_digest: Sha256Digest = '0' * 64`

#### Methods

##### `lightbulb.growth_operating.GrowthAgenda.to_dict`



~~~python
def to_dict() -> dict[str, Any]
~~~


Source: `lightbulb/growth_operating.py:383`.

### `lightbulb.growth_operating.GrowthAgendaInput`

class. Source: `lightbulb/growth_operating.py:387`.

Everything the agenda may consult, supplied explicitly by the caller.

Fields:
- `as_of: str`
- `policy: GrowthCadencePolicy = Field(default_factory=GrowthCadencePolicy)`
- `designs: tuple[GrowthExperimentDesign, ...] = Field(default_factory=tuple, max_length=_MAX_AGENDA_DESIGNS)`
- `readouts: tuple[GrowthExperimentReadout, ...] = Field(default_factory=tuple, max_length=_MAX_AGENDA_READOUTS)`
- `learnings: tuple[GrowthLearningEntry, ...] = Field(default_factory=tuple, max_length=_MAX_AGENDA_LEARNINGS)`
- `funnel_snapshot: GrowthFunnelSnapshot | None = None`
- `unit_economics: UnitEconomicsSnapshot | None = None`
- `customer_value: CustomerValueSnapshot | None = None`
- `diagnosis: GrowthDiagnosis | None = None`
- `profit_review: ProfitReview | None = None`
- `customer_value_review: CustomerValueReview | None = None`
- `objective: GrowthObjective | None = None`
- `objective_assessment: ObjectiveAssessment | None = None`
- `mandate: GrowthMandate | None = None`
- `authorizations: tuple[ActionAuthorization, ...] = Field(default_factory=tuple, max_length=_MAX_AGENDA_AUTHORIZATIONS)`
- `calendar_plans: tuple[ContentCalendarPlan, ...] = Field(default_factory=tuple, max_length=_MAX_AGENDA_PLANS)`
- `audience_plans: tuple[AudienceGrowthPlan, ...] = Field(default_factory=tuple, max_length=_MAX_AGENDA_PLANS)`
- `dispatches: tuple[RailDispatchPackage, ...] = Field(default_factory=tuple, max_length=_MAX_AGENDA_DISPATCHES)`
- `reconciliations: tuple[DispatchReconciliation, ...] = Field(default_factory=tuple, max_length=_MAX_AGENDA_DISPATCHES)`
- `recorded_readout_digests: tuple[Sha256Digest, ...] = Field(default_factory=tuple, max_length=500)`
- `reconciliation_errors: tuple[ShortText, ...] = Field(default_factory=tuple, max_length=_MAX_AGENDA_DISPATCHES)`

### `lightbulb.growth_operating.compile_growth_agenda`

function. Source: `lightbulb/growth_operating.py:1495`.



~~~python
compile_growth_agenda(inputs: GrowthAgendaInput | Mapping[str, Any], *, inputs_verified_by_host: bool=False) -> GrowthAgenda
~~~


Deterministically compile the scope's open loops into one agenda.

### `lightbulb.growth_operating.RateDelta`

class. Source: `lightbulb/growth_operating.py:1592`.

Fields:
- `rate_name: ShortText`
- `previous: Decimal | None = Field(default=None, ge=0, multiple_of=_RATE_QUANTUM)`
- `current: Decimal | None = Field(default=None, ge=0, multiple_of=_RATE_QUANTUM)`
- `change: Decimal | None = Field(default=None, multiple_of=_RATE_QUANTUM)`
- `movement: Movement`
- `cross_basis: bool`
- `label: MovementLabel = 'observational_movement_not_attribution'`

### `lightbulb.growth_operating.MetricTotalDelta`

class. Source: `lightbulb/growth_operating.py:1635`.

Fields:
- `metric: ShortText`
- `basis: ShortText`
- `previous: Decimal | None = Field(default=None, ge=0)`
- `current: Decimal | None = Field(default=None, ge=0)`
- `change: Decimal | None = None`
- `movement: Movement`
- `label: MovementLabel = 'observational_movement_not_attribution'`

### `lightbulb.growth_operating.FunnelDelta`

class. Source: `lightbulb/growth_operating.py:1678`.

Observational movement between two funnel snapshots of one scope.

Fields:
- `schema_id: Literal['lightbulb.growth_funnel_delta.v2'] = Field(default=GROWTH_FUNNEL_DELTA_SCHEMA, alias='schema')`
- `previous_digest: Sha256Digest`
- `current_digest: Sha256Digest`
- `previous_as_of: str`
- `current_as_of: str`
- `currency: CurrencyCode | None = None`
- `evidence_scope_status: EvidenceScopeStatus`
- `rate_deltas: tuple[RateDelta, ...] = Field(default_factory=tuple, max_length=10)`
- `total_deltas: tuple[MetricTotalDelta, ...] = Field(default_factory=tuple, max_length=80)`
- `derived_deltas: tuple[MetricTotalDelta, ...] = Field(default_factory=tuple, max_length=4)`
- `data_quality_notes: tuple[ShortText, ...] = Field(default_factory=tuple, max_length=10)`
- `delta_digest: Sha256Digest = '0' * 64`

#### Methods

##### `lightbulb.growth_operating.FunnelDelta.to_dict`



~~~python
def to_dict() -> dict[str, Any]
~~~


Source: `lightbulb/growth_operating.py:1757`.

### `lightbulb.growth_operating.CompareFunnelSnapshotsInput`

class. Source: `lightbulb/growth_operating.py:1761`.

Fields:
- `previous: GrowthFunnelSnapshot`
- `current: GrowthFunnelSnapshot`

### `lightbulb.growth_operating.compare_funnel_snapshots`

function. Source: `lightbulb/growth_operating.py:1781`.



~~~python
compare_funnel_snapshots(inputs: CompareFunnelSnapshotsInput | Mapping[str, Any]) -> FunnelDelta
~~~


Honest movement between two snapshots of the same scope.

### `lightbulb.growth_operating.CompileGrowthAgendaPrimitive`

class. Source: `lightbulb/growth_operating.py:2061`.

Compile the scope's open loops into one ranked, argument-hinted agenda.

### `lightbulb.growth_operating.CompareFunnelSnapshotsPrimitive`

class. Source: `lightbulb/growth_operating.py:2133`.

Report honest week-over-week movement between two funnel snapshots.

## Module `lightbulb.growth_portfolio`

Portfolio layer: N stores that learn as a fleet, not as strangers.

### `lightbulb.growth_portfolio.GrowthPortfolioValidationError`

class. Source: `lightbulb/growth_portfolio.py:137`.

Portfolio inputs violate the fleet custody or honesty contract.

### `lightbulb.growth_portfolio.PortfolioMemberInput`

class. Source: `lightbulb/growth_portfolio.py:298`.

One member store: its ref, its own scope, its sealed snapshot.

Fields:
- `member_ref: PortableRef`
- `scope: DynamicWorkflowScope`
- `funnel_snapshot: GrowthFunnelSnapshot`

### `lightbulb.growth_portfolio.PortfolioRateDistribution`

class. Source: `lightbulb/growth_portfolio.py:316`.

Fields:
- `rate_name: RateName`
- `member_count: int = Field(ge=1)`
- `fleet_median: Decimal = Field(ge=0, multiple_of=_RATE_QUANTUM)`
- `best: MemberRateReading`
- `worst: MemberRateReading`
- `laggards: tuple[PortableRef, ...] = Field(default_factory=tuple)`
- `leaders: tuple[PortableRef, ...] = Field(default_factory=tuple)`

### `lightbulb.growth_portfolio.PortfolioFunnelRollup`

class. Source: `lightbulb/growth_portfolio.py:368`.

Sealed fleet view over verified member snapshots.

Fields:
- `schema_id: Literal['lightbulb.growth_portfolio_rollup.v2'] = Field(default=GROWTH_PORTFOLIO_ROLLUP_SCHEMA, alias='schema')`
- `portfolio_ref: PortableRef`
- `analysis_as_of: str`
- `currency: CurrencyCode | None = None`
- `evidence_scope_status: EvidenceScopeStatus`
- `members: tuple[PortfolioMemberRecord, ...] = Field(min_length=1, max_length=_MAX_PORTFOLIO_MEMBERS)`
- `fleet_totals: tuple[PortfolioMetricTotal, ...] = Field(default_factory=tuple)`
- `rate_distributions: tuple[PortfolioRateDistribution, ...] = Field(default_factory=tuple)`
- `rollup_digest: Sha256Digest = '0' * 64`
- `receipt_key_id: str | None = Field(default=None, min_length=8, max_length=80, pattern='^[A-Za-z0-9][A-Za-z0-9._-]{7,79}$')`
- `exact_scope_digest: Sha256Digest | None = None`
- `rollup_hmac: Sha256Digest | None = None`

#### Methods

##### `lightbulb.growth_portfolio.PortfolioFunnelRollup.hmac_payload`



~~~python
def hmac_payload() -> dict[str, Any]
~~~


Source: `lightbulb/growth_portfolio.py:448`.

##### `lightbulb.growth_portfolio.PortfolioFunnelRollup.to_dict`



~~~python
def to_dict() -> dict[str, Any]
~~~


Source: `lightbulb/growth_portfolio.py:456`.

### `lightbulb.growth_portfolio.build_portfolio_funnel_rollup`

function. Source: `lightbulb/growth_portfolio.py:460`.



~~~python
build_portfolio_funnel_rollup(portfolio_ref: str, members: Sequence[PortfolioMemberInput | Mapping[str, Any]], *, analysis_as_of: str, portfolio_scope: DynamicWorkflowScope | Mapping[str, Any] | None=None, scope_keyring: ExactScopeDigestProvider | None=None, scope_key_id: str | None=None) -> PortfolioFunnelRollup
~~~


Aggregate verified member snapshots into one sealed fleet view.

### `lightbulb.growth_portfolio.verify_portfolio_funnel_rollup`

function. Source: `lightbulb/growth_portfolio.py:678`.



~~~python
verify_portfolio_funnel_rollup(value: PortfolioFunnelRollup | Mapping[str, Any], *, scope: DynamicWorkflowScope | Mapping[str, Any], scope_keyring: ExactScopeDigestProvider) -> PortfolioFunnelRollup
~~~


### `lightbulb.growth_portfolio.derive_sibling_reference_rates`

function. Source: `lightbulb/growth_portfolio.py:725`.



~~~python
derive_sibling_reference_rates(rollup: PortfolioFunnelRollup | Mapping[str, Any], *, scope: DynamicWorkflowScope | Mapping[str, Any], scope_keyring: ExactScopeDigestProvider, min_members: int=_MIN_SIBLING_MEMBERS) -> tuple[FunnelReferenceRate, ...]
~~~


Turn fleet medians into per-store benchmark references.

### `lightbulb.growth_portfolio.transfer_learning`

function. Source: `lightbulb/growth_portfolio.py:773`.



~~~python
transfer_learning(entry: GrowthLearningEntry | Mapping[str, Any], *, from_scope: DynamicWorkflowScope | Mapping[str, Any], to_ledger: GrowthLearningsLedger, scope_keyring: ExactScopeDigestProvider, entry_ref: str, recorded_at: str, valid_until: str | None=None) -> GrowthLearningEntry
~~~


Record a sibling store's verified learning into another store's ledger.

### `lightbulb.growth_portfolio.BottleneckCluster`

class. Source: `lightbulb/growth_portfolio.py:838`.

Fields:
- `rate_name: RateName`
- `member_refs: tuple[PortableRef, ...] = Field(min_length=1)`
- `fleet_median: Decimal | None = None`
- `test_stores: tuple[PortableRef, ...] = Field(min_length=1)`

### `lightbulb.growth_portfolio.PortfolioMove`

class. Source: `lightbulb/growth_portfolio.py:857`.

Fields:
- `rank: int = Field(ge=1, le=100)`
- `kind: Literal['cluster_experiment', 'laggard_transfer', 'collect_evidence']`
- `title: ShortText`
- `mechanism: ShortText`
- `member_refs: tuple[PortableRef, ...] = Field(min_length=1)`
- `next_action: ShortText`
- `argument_hints: dict[str, str] = Field(default_factory=dict)`

### `lightbulb.growth_portfolio.PortfolioDiagnosis`

class. Source: `lightbulb/growth_portfolio.py:883`.

Deterministic fleet moves: one experiment per cluster, then transfer.

Fields:
- `schema_id: Literal['lightbulb.growth_portfolio_diagnosis.v1'] = Field(default=GROWTH_PORTFOLIO_DIAGNOSIS_SCHEMA, alias='schema')`
- `portfolio_ref: PortableRef`
- `as_of: str`
- `rollup_digest: Sha256Digest`
- `evidence_scope_status: EvidenceScopeStatus`
- `member_count: int = Field(ge=1)`
- `clusters: tuple[BottleneckCluster, ...] = Field(default_factory=tuple)`
- `moves: tuple[PortfolioMove, ...] = Field(default_factory=tuple)`
- `diagnosis_digest: Sha256Digest = '0' * 64`

#### Methods

##### `lightbulb.growth_portfolio.PortfolioDiagnosis.to_dict`



~~~python
def to_dict() -> dict[str, Any]
~~~


Source: `lightbulb/growth_portfolio.py:926`.

### `lightbulb.growth_portfolio.diagnose_portfolio`

function. Source: `lightbulb/growth_portfolio.py:952`.



~~~python
diagnose_portfolio(rollup: PortfolioFunnelRollup | Mapping[str, Any], member_snapshots: Sequence[PortfolioMemberInput | Mapping[str, Any]], *, as_of: str, max_test_stores: int=3) -> PortfolioDiagnosis
~~~


Rank the fleet moves from a rollup plus its member snapshots.

## Module `lightbulb.growth_primitives`

Executable primitives promoted by the continuous improvement catalog.

### `lightbulb.growth_primitives.CollectPaymentInput`

class. Source: `lightbulb/growth_primitives.py:70`.

Fields:
- `invoice_id: str = Field(min_length=1, max_length=200)`
- `account_id: str = Field(min_length=1, max_length=200)`
- `amount: Decimal = Field(gt=0)`
- `currency: str = Field(default='USD', min_length=3, max_length=3)`
- `payment_date: str = Field(default_factory=lambda: date.today().isoformat())`
- `reference: str = Field(default='', max_length=300)`
- `commit: bool = False`

### `lightbulb.growth_primitives.CollectPaymentOutput`

class. Source: `lightbulb/growth_primitives.py:100`.

Fields:
- `provider: Literal['xero'] = 'xero'`
- `invoice_id: str`
- `account_id: str`
- `amount: Decimal`
- `currency: str`
- `payment_date: str`
- `state: Literal['proposal', 'preview', 'pending_approval', 'recorded', 'blocked', 'failed']`
- `payment_ref: str | None = None`

### `lightbulb.growth_primitives.CollectPaymentPrimitive`

class. Source: `lightbulb/growth_primitives.py:113`.

### `lightbulb.growth_primitives.RequestDecisionInput`

class. Source: `lightbulb/growth_primitives.py:223`.

Fields:
- `subject: str = Field(min_length=1, max_length=300)`
- `question: str = Field(min_length=1, max_length=5000)`
- `options: list[str] = Field(min_length=2, max_length=20)`
- `owner: str = Field(default='workflow_owner', min_length=1, max_length=200)`
- `due_at: str = Field(default='', max_length=80)`
- `context: Dict[str, Any] = Field(default_factory=dict)`
- `submit: bool = False`
- `decision: str = Field(default='', max_length=300)`

### `lightbulb.growth_primitives.RequestDecisionOutput`

class. Source: `lightbulb/growth_primitives.py:252`.

Fields:
- `subject: str`
- `question: str`
- `options: list[str]`
- `owner: str`
- `state: Literal['draft', 'pending', 'decided']`
- `decision: str | None = None`

### `lightbulb.growth_primitives.RequestDecisionPrimitive`

class. Source: `lightbulb/growth_primitives.py:263`.

### `lightbulb.growth_primitives.GenerateBusinessArtifactInput`

class. Source: `lightbulb/growth_primitives.py:371`.

Fields:
- `artifact_type: ArtifactType`
- `title: str = Field(min_length=1, max_length=300)`
- `content: Any`
- `destination: str = Field(default='', max_length=500)`
- `create: bool = False`

### `lightbulb.growth_primitives.GenerateBusinessArtifactOutput`

class. Source: `lightbulb/growth_primitives.py:389`.

Fields:
- `artifact_type: ArtifactType`
- `title: str`
- `state: Literal['draft', 'preview', 'pending_approval', 'created', 'blocked', 'failed']`
- `artifact_ref: str | None = None`

### `lightbulb.growth_primitives.GenerateBusinessArtifactPrimitive`

class. Source: `lightbulb/growth_primitives.py:398`.

### `lightbulb.growth_primitives.CreateWorkPacketInput`

class. Source: `lightbulb/growth_primitives.py:513`.

Fields:
- `title: str = Field(min_length=1, max_length=300)`
- `implementation_objective: str = Field(min_length=1, max_length=5000, validation_alias=AliasChoices('implementation_objective', 'objective'))`
- `scope: list[str] = Field(min_length=1, max_length=100)`
- `acceptance_criteria: list[str] = Field(min_length=1, max_length=100)`
- `target_files: list[str] = Field(default_factory=list, max_length=500)`
- `dependencies: list[str] = Field(default_factory=list, max_length=100)`
- `risk_level: Literal['low', 'medium', 'high'] = 'medium'`
- `submit_for_approval: bool = False`

### `lightbulb.growth_primitives.CreateWorkPacketOutput`

class. Source: `lightbulb/growth_primitives.py:535`.

Fields:
- `packet_ref: str`
- `title: str`
- `objective: str`
- `scope: list[str]`
- `acceptance_criteria: list[str]`
- `target_files: list[str]`
- `dependencies: list[str]`
- `risk_level: Literal['low', 'medium', 'high']`
- `state: Literal['draft', 'pending_approval', 'approved']`

### `lightbulb.growth_primitives.CreateWorkPacketPrimitive`

class. Source: `lightbulb/growth_primitives.py:549`.

## Module `lightbulb.growth_profit`

Profit engine: the money model of the Lightbulb Growth Engine.

### `lightbulb.growth_profit.GrowthProfitValidationError`

class. Source: `lightbulb/growth_profit.py:240`.

Profit evidence, economics, or price-plan content violates the contract.

### `lightbulb.growth_profit.ContributionMetrics`

class. Source: `lightbulb/growth_profit.py:401`.

Normalized per-observation contribution-ledger values.

Fields:
- `gross_sales: Decimal | None = Field(default=None, ge=0)`
- `discounts: Decimal | None = Field(default=None, ge=0)`
- `refunds: Decimal | None = Field(default=None, ge=0)`
- `cogs: Decimal | None = Field(default=None, ge=0)`
- `fulfillment_cost: Decimal | None = Field(default=None, ge=0)`
- `payment_fees: Decimal | None = Field(default=None, ge=0)`
- `service_cost: Decimal | None = Field(default=None, ge=0)`
- `acquisition_cost: Decimal | None = Field(default=None, ge=0)`
- `orders: int | None = Field(default=None, ge=0, le=10000000000)`
- `units: int | None = Field(default=None, ge=0, le=10000000000)`
- `new_customers: int | None = Field(default=None, ge=0, le=10000000000)`

### `lightbulb.growth_profit.ProfitContributionEvidence`

class. Source: `lightbulb/growth_profit.py:445`.

One sealed connector ledger observation admissible into unit economics.

Fields:
- `observation_ref: PortableRef`
- `connector_account_ref: OperationRef`
- `provider: ProfitProvider`
- `source_capability: str = Field(min_length=3, max_length=160, pattern='^[a-z][a-z0-9_-]{0,63}\\.[a-z][a-z0-9_.-]{0,127}$')`
- `currency: CurrencyCode`
- `observed_at: str`
- `window_start: str`
- `window_end: str`
- `metrics: ContributionMetrics`
- `evidence_digest: Sha256Digest`
- `receipt_key_id: str | None = Field(default=None, min_length=8, max_length=80, pattern='^[A-Za-z0-9][A-Za-z0-9._-]{7,79}$')`
- `exact_scope_digest: Sha256Digest | None = None`
- `evidence_hmac: Sha256Digest | None = None`

#### Methods

##### `lightbulb.growth_profit.ProfitContributionEvidence.basis`



~~~python
@property
def basis() -> ProfitBasis
~~~


Source: `lightbulb/growth_profit.py:500`.

##### `lightbulb.growth_profit.ProfitContributionEvidence.hmac_payload`



~~~python
def hmac_payload() -> dict[str, Any]
~~~


Return the complete canonical observation covered by host HMAC.

Source: `lightbulb/growth_profit.py:507`.

##### `lightbulb.growth_profit.ProfitContributionEvidence.is_attested`



~~~python
@property
def is_attested() -> bool
~~~


Source: `lightbulb/growth_profit.py:504`.

### `lightbulb.growth_profit.mint_profit_contribution_evidence`

function. Source: `lightbulb/growth_profit.py:517`.



~~~python
mint_profit_contribution_evidence(value: ProfitContributionEvidence | Mapping[str, Any], *, scope: DynamicWorkflowScope | Mapping[str, Any], scope_keyring: ExactScopeDigestProvider, scope_key_id: str | None=None) -> ProfitContributionEvidence
~~~


Seal one host-verified ledger observation for unit-economics use.

### `lightbulb.growth_profit.verify_profit_contribution_evidence`

function. Source: `lightbulb/growth_profit.py:588`.



~~~python
verify_profit_contribution_evidence(value: ProfitContributionEvidence | Mapping[str, Any], *, scope: DynamicWorkflowScope | Mapping[str, Any], scope_keyring: ExactScopeDigestProvider) -> ProfitContributionEvidence
~~~


Re-validate and verify one sealed evidence envelope; raise on failure.

### `lightbulb.growth_profit.ProfitStalenessPolicy`

class. Source: `lightbulb/growth_profit.py:620`.

Admission budget for evidence age and verification requirements.

Fields:
- `max_evidence_age_hours: int = Field(default=720, ge=1, le=8760)`
- `require_verified_evidence: bool = False`

### `lightbulb.growth_profit.BuildUnitEconomicsInput`

class. Source: `lightbulb/growth_profit.py:627`.

Fields:
- `analysis_as_of: str`
- `economics_ref: PortableRef`
- `currency: CurrencyCode`
- `evidence: tuple[ProfitContributionEvidence, ...] = Field(min_length=1, max_length=_MAX_PROFIT_EVIDENCE)`
- `staleness_policy: ProfitStalenessPolicy = Field(default_factory=ProfitStalenessPolicy)`

### `lightbulb.growth_profit.EconomicsComponent`

class. Source: `lightbulb/growth_profit.py:689`.

One derived money fact with explicit completeness and provenance.

Fields:
- `name: EconomicsComponentName`
- `unit: Literal['money', 'ratio', 'multiple']`
- `value: Decimal`
- `complete: bool`
- `missing_inputs: tuple[LedgerMetricName, ...] = Field(default_factory=tuple)`
- `cross_basis: bool`
- `formula: ShortText`

### `lightbulb.growth_profit.UnitEconomicsSnapshot`

class. Source: `lightbulb/growth_profit.py:744`.

Sealed unit-economics state derived from admissible ledger evidence.

Fields:
- `schema_id: Literal['lightbulb.growth_unit_economics.v1'] = Field(default=GROWTH_UNIT_ECONOMICS_SCHEMA, alias='schema')`
- `economics_ref: PortableRef`
- `analysis_as_of: str`
- `currency: CurrencyCode`
- `evidence_scope_status: EvidenceScopeStatus`
- `staleness_policy: ProfitStalenessPolicy`
- `metric_presence: tuple[LedgerMetricPresence, ...]`
- `ledger_totals: tuple[LedgerMetricTotal, ...] = Field(default_factory=tuple)`
- `components: tuple[EconomicsComponent, ...] = Field(default_factory=tuple)`
- `data_quality_notes: tuple[ShortText, ...] = Field(default_factory=tuple)`
- `admitted_evidence: tuple[AdmittedProfitEvidence, ...] = Field(default_factory=tuple)`
- `excluded_evidence: tuple[ExcludedProfitEvidence, ...] = Field(default_factory=tuple)`
- `economics_digest: Sha256Digest = '0' * 64`
- `receipt_key_id: str | None = Field(default=None, min_length=8, max_length=80, pattern='^[A-Za-z0-9][A-Za-z0-9._-]{7,79}$')`
- `exact_scope_digest: Sha256Digest | None = None`
- `economics_hmac: Sha256Digest | None = None`

#### Methods

##### `lightbulb.growth_profit.UnitEconomicsSnapshot.component`



~~~python
def component(name: EconomicsComponentName) -> EconomicsComponent | None
~~~


Source: `lightbulb/growth_profit.py:840`.

##### `lightbulb.growth_profit.UnitEconomicsSnapshot.hmac_payload`



~~~python
def hmac_payload() -> dict[str, Any]
~~~


Source: `lightbulb/growth_profit.py:832`.

##### `lightbulb.growth_profit.UnitEconomicsSnapshot.to_dict`



~~~python
def to_dict() -> dict[str, Any]
~~~


Source: `lightbulb/growth_profit.py:857`.

##### `lightbulb.growth_profit.UnitEconomicsSnapshot.total`



~~~python
def total(metric: LedgerMetricName) -> LedgerMetricTotal | None
~~~


The priority-picked total for one metric, or None if unknown.

Source: `lightbulb/growth_profit.py:846`.

### `lightbulb.growth_profit.build_unit_economics`

function. Source: `lightbulb/growth_profit.py:1113`.



~~~python
build_unit_economics(inputs: BuildUnitEconomicsInput | Mapping[str, Any], *, scope: DynamicWorkflowScope | Mapping[str, Any] | None=None, scope_keyring: ExactScopeDigestProvider | None=None, scope_key_id: str | None=None) -> UnitEconomicsSnapshot
~~~


Compute one sealed unit-economics snapshot from admissible evidence.

### `lightbulb.growth_profit.verify_unit_economics_snapshot`

function. Source: `lightbulb/growth_profit.py:1275`.



~~~python
verify_unit_economics_snapshot(value: UnitEconomicsSnapshot | Mapping[str, Any], *, scope: DynamicWorkflowScope | Mapping[str, Any], scope_keyring: ExactScopeDigestProvider) -> UnitEconomicsSnapshot
~~~


Re-validate and verify one sealed economics snapshot; raise on failure.

### `lightbulb.growth_profit.PriceElasticityEstimate`

class. Source: `lightbulb/growth_profit.py:1322`.

Arc elasticity derived from a sealed price plan and its causal readout.

Fields:
- `schema_id: Literal['lightbulb.growth_price_elasticity.v1'] = Field(default=GROWTH_PRICE_ELASTICITY_SCHEMA, alias='schema')`
- `estimate_ref: PortableRef`
- `method: Literal['arc_midpoint_revenue_per_session']`
- `price_change_ratio: Decimal = Field(gt=Decimal('-1'), lt=Decimal('1'), multiple_of=_RATE_QUANTUM)`
- `control_revenue_per_session: Decimal = Field(gt=0, multiple_of=_RATE_QUANTUM)`
- `treatment_revenue_per_session: Decimal = Field(ge=0, multiple_of=_RATE_QUANTUM)`
- `elasticity: Decimal = Field(multiple_of=_RATE_QUANTUM)`
- `ci_low: Decimal = Field(multiple_of=_RATE_QUANTUM)`
- `ci_high: Decimal = Field(multiple_of=_RATE_QUANTUM)`
- `readout_verdict: ShortText`
- `plan_digest: Sha256Digest`
- `design_digest: Sha256Digest`
- `readout_digest: Sha256Digest`
- `notes: tuple[ShortText, ...] = Field(default_factory=tuple, max_length=10)`
- `estimate_digest: Sha256Digest = '0' * 64`

#### Methods

##### `lightbulb.growth_profit.PriceElasticityEstimate.to_dict`



~~~python
def to_dict() -> dict[str, Any]
~~~


Source: `lightbulb/growth_profit.py:1386`.

### `lightbulb.growth_profit.estimate_price_elasticity`

function. Source: `lightbulb/growth_profit.py:1416`.



~~~python
estimate_price_elasticity(plan: 'PricePlan | Mapping[str, Any]', design: GrowthExperimentDesign | Mapping[str, Any], readout: GrowthExperimentReadout | Mapping[str, Any], *, estimate_ref: str, scope: DynamicWorkflowScope | Mapping[str, Any], scope_keyring: ExactScopeDigestProvider) -> PriceElasticityEstimate
~~~


Derive the price elasticity a causal price experiment actually proved.

### `lightbulb.growth_profit.PriceGuardrailPolicy`

class. Source: `lightbulb/growth_profit.py:1531`.

The caller-owned commercial constraints every price move must honor.

Fields:
- `minimum_contribution_margin: Decimal = Field(ge=0, lt=1, multiple_of=_RATE_QUANTUM)`
- `max_price_increase_ratio: Decimal = Field(default=Decimal('0.100000'), gt=0, le=Decimal('0.5'), multiple_of=_RATE_QUANTUM)`
- `max_price_decrease_ratio: Decimal = Field(default=Decimal('0.100000'), gt=0, le=Decimal('0.5'), multiple_of=_RATE_QUANTUM)`
- `probe_ratio: Decimal = Field(default=Decimal('0.050000'), gt=0, le=Decimal('0.25'), multiple_of=_RATE_QUANTUM)`

### `lightbulb.growth_profit.PriceExperimentSettings`

class. Source: `lightbulb/growth_profit.py:1568`.

Preregistration parameters for the price test a plan ships with.

Fields:
- `design_ref: PortableRef`
- `assignment_unit: AssignmentUnit`
- `baseline_value: Decimal | None = Field(default=None, gt=0, multiple_of=_RATE_QUANTUM)`
- `baseline_standard_deviation: Decimal = Field(gt=0, multiple_of=_RATE_QUANTUM)`
- `minimum_detectable_effect: Decimal = Field(gt=0, multiple_of=_RATE_QUANTUM)`
- `alpha: Decimal = Field(default=Decimal('0.050000'), ge=Decimal('0.001'), le=Decimal('0.2'), multiple_of=_RATE_QUANTUM)`
- `power: Decimal = Field(default=Decimal('0.800000'), ge=Decimal('0.5'), le=Decimal('0.99'), multiple_of=_RATE_QUANTUM)`
- `exposure_start: str`
- `readout_horizon: str`

### `lightbulb.growth_profit.PricePlanBrief`

class. Source: `lightbulb/growth_profit.py:1613`.

Fields:
- `plan_ref: PortableRef`
- `planned_at: str`
- `objective: PriceObjective`
- `direction: PriceDirection | None = None`
- `unit_economics: UnitEconomicsSnapshot`
- `policy: PriceGuardrailPolicy`
- `experiment: PriceExperimentSettings`
- `funnel_snapshot: GrowthFunnelSnapshot | None = None`
- `elasticity: PriceElasticityEstimate | None = None`
- `learnings: tuple[GrowthLearningEntry, ...] = Field(default_factory=tuple, max_length=_MAX_REVIEW_LEARNINGS)`

### `lightbulb.growth_profit.PriceMoveOperation`

class. Source: `lightbulb/growth_profit.py:1667`.

The executable content of a price move, bound to its approval unit.

Fields:
- `operation_ref: PortableRef`
- `currency: CurrencyCode`
- `direction: PriceDirection`
- `price_change_ratio: Decimal = Field(gt=Decimal('-1'), lt=Decimal('1'), multiple_of=_RATE_QUANTUM)`
- `economics_digest: Sha256Digest`
- `experiment_input: DesignGrowthExperimentInput`
- `operation_digest: Sha256Digest = '0' * 64`
- `approval_unit: str = Field(min_length=1, max_length=200)`

### `lightbulb.growth_profit.PricePlan`

class. Source: `lightbulb/growth_profit.py:1762`.

A margin-guarded, approval-ready price move that ships as an experiment.

Fields:
- `schema_id: Literal['lightbulb.growth_price_plan.v1'] = Field(default=GROWTH_PRICE_PLAN_SCHEMA, alias='schema')`
- `plan_ref: PortableRef`
- `planned_at: str`
- `objective: PriceObjective`
- `currency: CurrencyCode`
- `evidence_scope_status: EvidenceScopeStatus`
- `reference_quality: PriceReferenceQuality`
- `operation: PriceMoveOperation`
- `projections: tuple[PriceProjection, ...] = Field(default_factory=tuple)`
- `informed_by: ProfitInformedBy`
- `notes: tuple[ShortText, ...] = Field(default_factory=tuple, max_length=10)`
- `dispatchable_by_planner: Literal[False] = False`
- `plan_digest: Sha256Digest = '0' * 64`
- `receipt_key_id: str | None = Field(default=None, min_length=8, max_length=80, pattern='^[A-Za-z0-9][A-Za-z0-9._-]{7,79}$')`
- `exact_scope_digest: Sha256Digest | None = None`
- `plan_hmac: Sha256Digest | None = None`

#### Methods

##### `lightbulb.growth_profit.PricePlan.hmac_payload`



~~~python
def hmac_payload() -> dict[str, Any]
~~~


Source: `lightbulb/growth_profit.py:1836`.

##### `lightbulb.growth_profit.PricePlan.to_dict`



~~~python
def to_dict() -> dict[str, Any]
~~~


Source: `lightbulb/growth_profit.py:1844`.

### `lightbulb.growth_profit.plan_price_move`

function. Source: `lightbulb/growth_profit.py:2029`.



~~~python
plan_price_move(inputs: PricePlanBrief | Mapping[str, Any], *, scope: DynamicWorkflowScope | Mapping[str, Any] | None=None, scope_keyring: ExactScopeDigestProvider | None=None, scope_key_id: str | None=None) -> PricePlan
~~~


Plan one margin-guarded price move that ships as a preregistered test.

### `lightbulb.growth_profit.verify_price_plan`

function. Source: `lightbulb/growth_profit.py:2299`.



~~~python
verify_price_plan(value: PricePlan | Mapping[str, Any], *, scope: DynamicWorkflowScope | Mapping[str, Any], scope_keyring: ExactScopeDigestProvider) -> PricePlan
~~~


Re-validate and verify one sealed price plan; raise on failure.

### `lightbulb.growth_profit.ReviewProfitInput`

class. Source: `lightbulb/growth_profit.py:2342`.

Fields:
- `as_of: str`
- `unit_economics: UnitEconomicsSnapshot`
- `funnel_snapshot: GrowthFunnelSnapshot | None = None`
- `policy: PriceGuardrailPolicy | None = None`
- `learnings: tuple[GrowthLearningEntry, ...] = Field(default_factory=tuple, max_length=_MAX_REVIEW_LEARNINGS)`

### `lightbulb.growth_profit.MoneyOpportunity`

class. Source: `lightbulb/growth_profit.py:2362`.

One action ranked by what it is worth in contribution profit.

Fields:
- `rank: int = Field(ge=1, le=_MAX_REVIEW_OPPORTUNITIES)`
- `kind: MoneyOpportunityKind`
- `title: ShortText`
- `mechanism: ShortText`
- `expected_contribution_delta: Decimal | None = None`
- `delta_low: Decimal | None = None`
- `delta_high: Decimal | None = None`
- `interval_kind: Literal['scenario_half_to_full_close'] | None = None`
- `assumptions: tuple[ShortText, ...] = Field(default_factory=tuple, max_length=5)`
- `next_primitive_ref: ShortText | None = None`
- `argument_hints: dict[str, str] = Field(default_factory=dict)`

### `lightbulb.growth_profit.ProfitReview`

class. Source: `lightbulb/growth_profit.py:2425`.

One deterministic answer to "where is the money, and what is it worth".

Fields:
- `schema_id: Literal['lightbulb.growth_profit_review.v1'] = Field(default=GROWTH_PROFIT_REVIEW_SCHEMA, alias='schema')`
- `as_of: str`
- `economics_digest: Sha256Digest`
- `funnel_digest: Sha256Digest | None = None`
- `currency: CurrencyCode`
- `evidence_scope_status: EvidenceScopeStatus`
- `components: tuple[EconomicsComponent, ...] = Field(default_factory=tuple)`
- `opportunities: tuple[MoneyOpportunity, ...] = Field(default_factory=tuple)`
- `pricing_learnings: tuple[PricingLearningEcho, ...] = Field(default_factory=tuple)`
- `data_quality_notes: tuple[ShortText, ...] = Field(default_factory=tuple)`
- `review_digest: Sha256Digest = '0' * 64`

#### Methods

##### `lightbulb.growth_profit.ProfitReview.to_dict`



~~~python
def to_dict() -> dict[str, Any]
~~~


Source: `lightbulb/growth_profit.py:2476`.

### `lightbulb.growth_profit.review_profit`

function. Source: `lightbulb/growth_profit.py:2615`.



~~~python
review_profit(inputs: ReviewProfitInput | Mapping[str, Any]) -> ProfitReview
~~~


Deterministically rank where the money is from economics + funnel state.

### `lightbulb.growth_profit.BuildUnitEconomicsPrimitive`

class. Source: `lightbulb/growth_profit.py:2891`.

Compile a unit-economics snapshot from supplied ledger envelopes.

### `lightbulb.growth_profit.ReviewProfitPrimitive`

class. Source: `lightbulb/growth_profit.py:2965`.

Rank the next best money actions from unit economics and funnel state.

### `lightbulb.growth_profit.PlanPriceMovePrimitive`

class. Source: `lightbulb/growth_profit.py:3031`.

Plan a margin-guarded price move that ships as a preregistered test.

## Module `lightbulb.growth_rail_bridge`

Execution-rail bridge: growth plans become dispatchable, receipts come home.

### `lightbulb.growth_rail_bridge.GrowthRailBridgeValidationError`

class. Source: `lightbulb/growth_rail_bridge.py:102`.

Bridge content violates the rail-compatibility contract.

### `lightbulb.growth_rail_bridge.FacebookPublishArguments`

class. Source: `lightbulb/growth_rail_bridge.py:307`.

Fields:
- `kind: Literal['facebook_publish']`
- `page_id: ShortText`
- `message: LongText`
- `image_url: PublicHttpsUrl | None = None`

### `lightbulb.growth_rail_bridge.InstagramPublishArguments`

class. Source: `lightbulb/growth_rail_bridge.py:314`.

Fields:
- `kind: Literal['instagram_publish']`
- `instagram_business_account_id: ShortText`
- `caption: LongText`
- `image_url: PublicHttpsUrl`

### `lightbulb.growth_rail_bridge.LinkedInPublishArguments`

class. Source: `lightbulb/growth_rail_bridge.py:321`.

Fields:
- `kind: Literal['linkedin_publish']`
- `author_urn: ShortText`
- `text: LinkedInText`
- `url: PublicHttpsUrl`
- `image_url: PublicHttpsUrl | None = None`

### `lightbulb.growth_rail_bridge.AuthoredSocialPost`

class. Source: `lightbulb/growth_rail_bridge.py:389`.

Agent-authored copy bound to the plan brief it fulfils.

Fields:
- `item_ref: PortableRef`
- `channel: SocialChannel`
- `connector_account_ref: OperationRef`
- `provider_target_id: ShortText`
- `brief_digest: Sha256Digest`
- `body: LongText`
- `media_url: PublicHttpsUrl | None = None`
- `link_url: PublicHttpsUrl | None = None`
- `authored_digest: Sha256Digest = '0' * 64`

### `lightbulb.growth_rail_bridge.author_calendar_item`

function. Source: `lightbulb/growth_rail_bridge.py:450`.



~~~python
author_calendar_item(plan: ContentCalendarPlan | AudienceGrowthPlan | Mapping[str, Any], item_ref: str, *, body: str, media_url: str | None=None, link_url: str | None=None) -> AuthoredSocialPost
~~~


Bind authored copy to one plan brief; content drift is impossible.

### `lightbulb.growth_rail_bridge.RailSocialOperation`

class. Source: `lightbulb/growth_rail_bridge.py:503`.

One rail-shaped social_publish operation.

Fields:
- `ordinal: int = Field(ge=1, le=_MAX_DISPATCH_OPERATIONS)`
- `operation_id: OperationRef`
- `stage: Literal['social_publish'] = 'social_publish'`
- `execution_kind: Literal['connector_tool'] = 'connector_tool'`
- `capability: PublishCapability`
- `surface_availability: Literal['platform_registered_not_generated'] = 'platform_registered_not_generated'`
- `connector_account_ref: OperationRef`
- `effect: Literal['write'] = 'write'`
- `arguments: PublishArguments`
- `depends_on: tuple[OperationRef, ...] = Field(default_factory=tuple, max_length=2)`
- `input_bindings: tuple[str, ...] = Field(default_factory=tuple, max_length=0)`
- `status: Literal['proposal_only_not_executed'] = 'proposal_only_not_executed'`
- `approval_required: Literal[True] = True`
- `approval_unit: OperationRef`
- `receipt_kind: str = Field(min_length=1, max_length=120, pattern='^[a-z][a-z0-9_]{0,119}$')`
- `scheduling_semantics: Literal['not_scheduled'] = 'not_scheduled'`
- `operation_digest: str = ''`

### `lightbulb.growth_rail_bridge.RailDispatchPackage`

class. Source: `lightbulb/growth_rail_bridge.py:590`.

Sealed, approval-ready set of rail operations compiled from one plan.

Fields:
- `schema_id: Literal['lightbulb.growth_rail_dispatch.v1'] = Field(default=GROWTH_RAIL_DISPATCH_SCHEMA, alias='schema')`
- `dispatch_ref: PortableRef`
- `run_ref: WorkflowRunRef`
- `calendar_plan_digest: Sha256Digest`
- `evidence_scope_status: Literal['caller_supplied_unverified', 'host_hmac_verified']`
- `compiled_at: str`
- `operations: tuple[RailSocialOperation, ...] = Field(min_length=1, max_length=_MAX_DISPATCH_OPERATIONS)`
- `schedule: tuple[OperationSchedule, ...] = Field(min_length=1, max_length=_MAX_DISPATCH_OPERATIONS)`
- `unauthored_item_refs: tuple[PortableRef, ...] = Field(default_factory=tuple)`
- `package_digest: Sha256Digest = '0' * 64`
- `receipt_key_id: str = Field(min_length=8, max_length=80, pattern='^[A-Za-z0-9][A-Za-z0-9._-]{7,79}$')`
- `exact_scope_digest: Sha256Digest`
- `package_hmac: Sha256Digest`

#### Methods

##### `lightbulb.growth_rail_bridge.RailDispatchPackage.hmac_payload`



~~~python
def hmac_payload() -> dict[str, Any]
~~~


Source: `lightbulb/growth_rail_bridge.py:652`.

##### `lightbulb.growth_rail_bridge.RailDispatchPackage.to_dict`



~~~python
def to_dict() -> dict[str, Any]
~~~


Source: `lightbulb/growth_rail_bridge.py:660`.

### `lightbulb.growth_rail_bridge.compile_content_calendar_dispatch`

function. Source: `lightbulb/growth_rail_bridge.py:664`.



~~~python
compile_content_calendar_dispatch(plan: ContentCalendarPlan | Mapping[str, Any], authored_posts: Sequence[AuthoredSocialPost | Mapping[str, Any]], *, dispatch_ref: str, run_ref: str, compiled_at: str, scope: DynamicWorkflowScope | Mapping[str, Any], scope_keyring: ExactScopeDigestProvider, scope_key_id: str | None=None) -> RailDispatchPackage
~~~


Compile authored content-calendar items into a sealed dispatch package.

### `lightbulb.growth_rail_bridge.compile_audience_growth_dispatch`

function. Source: `lightbulb/growth_rail_bridge.py:699`.



~~~python
compile_audience_growth_dispatch(plan: AudienceGrowthPlan | Mapping[str, Any], authored_posts: Sequence[AuthoredSocialPost | Mapping[str, Any]], *, dispatch_ref: str, run_ref: str, compiled_at: str, scope: DynamicWorkflowScope | Mapping[str, Any], scope_keyring: ExactScopeDigestProvider, scope_key_id: str | None=None) -> RailDispatchPackage
~~~


Compile authored audience-growth items into a sealed dispatch package.

### `lightbulb.growth_rail_bridge.verify_rail_dispatch_package`

function. Source: `lightbulb/growth_rail_bridge.py:881`.



~~~python
verify_rail_dispatch_package(value: RailDispatchPackage | Mapping[str, Any], *, scope: DynamicWorkflowScope | Mapping[str, Any], scope_keyring: ExactScopeDigestProvider) -> RailDispatchPackage
~~~


### `lightbulb.growth_rail_bridge.RailExecutionReceipt`

class. Source: `lightbulb/growth_rail_bridge.py:927`.

The rail's always-sealed execution receipt, at the dict boundary.

Fields:
- `schema_id: Literal['lightbulb.product_launch_receipt.v1'] = Field(default=RAIL_EXECUTION_RECEIPT_SCHEMA, alias='schema')`
- `receipt_ref: OperationRef`
- `criterion_id: str = Field(min_length=1, max_length=120, pattern='^[a-z][a-z0-9_-]{0,119}$')`
- `receipt_kind: str = Field(min_length=1, max_length=120, pattern='^[a-z][a-z0-9_]{0,119}$')`
- `evidence_kind: str = Field(min_length=1, max_length=120, pattern='^[a-z][a-z0-9_]{0,119}$')`
- `plan_digest: Sha256Digest`
- `exact_scope_digest: Sha256Digest`
- `run_ref: WorkflowRunRef`
- `iteration: int = Field(ge=1, le=4)`
- `operation_id: OperationRef | None = None`
- `operation_digest: Sha256Digest | None = None`
- `approval_unit: OperationRef | None = None`
- `approval_receipt_digest: Sha256Digest | None = None`
- `issuer_ref: OperationRef`
- `evidence_digest: Sha256Digest`
- `status: Literal['succeeded'] = 'succeeded'`
- `issued_at: str`
- `effective_at: str`
- `window_start: str | None = None`
- `window_end: str | None = None`
- `sample_size: int | None = Field(default=None, ge=0, le=10000000000)`
- `primary_metric: PrimaryMetric | None = None`
- `metric_value: Decimal | None = Field(default=None, ge=0, le=1, multiple_of=_RATE_QUANTUM)`
- `receipt_key_id: str = Field(min_length=8, max_length=80, pattern='^[A-Za-z0-9][A-Za-z0-9._-]{7,79}$')`
- `receipt_hmac: Sha256Digest`
- `receipt_digest: str = ''`

#### Methods

##### `lightbulb.growth_rail_bridge.RailExecutionReceipt.hmac_payload`



~~~python
def hmac_payload() -> dict[str, Any]
~~~


Source: `lightbulb/growth_rail_bridge.py:1037`.

##### `lightbulb.growth_rail_bridge.RailExecutionReceipt.to_dict`



~~~python
def to_dict() -> dict[str, Any]
~~~


Source: `lightbulb/growth_rail_bridge.py:1045`.

### `lightbulb.growth_rail_bridge.verify_rail_execution_receipt`

function. Source: `lightbulb/growth_rail_bridge.py:1049`.



~~~python
verify_rail_execution_receipt(value: RailExecutionReceipt | Mapping[str, Any], *, scope: DynamicWorkflowScope | Mapping[str, Any], scope_keyring: ExactScopeDigestProvider) -> RailExecutionReceipt
~~~


Verify a rail receipt under the rail's own HMAC domain.

### `lightbulb.growth_rail_bridge.DispatchReconciliation`

class. Source: `lightbulb/growth_rail_bridge.py:1101`.

Digest-pinned answer to "did my plan actually happen, and when".

Fields:
- `schema_id: Literal['lightbulb.growth_rail_reconciliation.v1'] = Field(default=GROWTH_RAIL_RECONCILIATION_SCHEMA, alias='schema')`
- `package_digest: Sha256Digest`
- `completed: tuple[CompletedOperation, ...] = Field(default_factory=tuple)`
- `pending_operation_ids: tuple[OperationRef, ...] = Field(default_factory=tuple)`
- `all_completed: bool`
- `measure_after: str | None = None`
- `reconciliation_digest: Sha256Digest = '0' * 64`

#### Methods

##### `lightbulb.growth_rail_bridge.DispatchReconciliation.to_dict`



~~~python
def to_dict() -> dict[str, Any]
~~~


Source: `lightbulb/growth_rail_bridge.py:1151`.

### `lightbulb.growth_rail_bridge.reconcile_dispatch_receipts`

function. Source: `lightbulb/growth_rail_bridge.py:1155`.



~~~python
reconcile_dispatch_receipts(package: RailDispatchPackage | Mapping[str, Any], receipts: Sequence[RailExecutionReceipt | Mapping[str, Any]], *, scope: DynamicWorkflowScope | Mapping[str, Any], scope_keyring: ExactScopeDigestProvider) -> DispatchReconciliation
~~~


Match verified receipts to a verified dispatch, honestly.

### `lightbulb.growth_rail_bridge.RailDispatcher`

class. Source: `lightbulb/growth_rail_bridge.py:1251`.

The structural seam a rail-side executor satisfies when it lands.

#### Methods

##### `lightbulb.growth_rail_bridge.RailDispatcher.dispatch`



~~~python
def dispatch(operation: Mapping[str, Any], *, approval_ref: str, run_ref: str) -> Mapping[str, Any]
~~~


Source: `lightbulb/growth_rail_bridge.py:1259`.

## Module `lightbulb.growth_workspace`

Durable growth workspace: one scope's persistent home for growth work.

### `lightbulb.growth_workspace.GrowthWorkspaceValidationError`

class. Source: `lightbulb/growth_workspace.py:174`.

Workspace content violates the coherence or custody contract.

### `lightbulb.growth_workspace.GrowthWorkspacePersistenceError`

class. Source: `lightbulb/growth_workspace.py:178`.

The workspace store is unavailable, corrupt, or tampered.

### `lightbulb.growth_workspace.WorkspaceRecord`

class. Source: `lightbulb/growth_workspace.py:234`.

Fields:
- `kind: WorkspaceKind`
- `ref: ShortText`
- `storage_digest: Sha256Digest`
- `saved_at: str`
- `advisory: bool`

### `lightbulb.growth_workspace.ExperimentStatusRecord`

class. Source: `lightbulb/growth_workspace.py:247`.

Fields:
- `design_ref: ShortText`
- `design_digest: Sha256Digest`
- `state: ExperimentState`
- `exposure_start: str`
- `readout_horizon: str`
- `readout_digest: Sha256Digest | None = None`
- `verdict: ShortText | None = None`

### `lightbulb.growth_workspace.WorkspaceStatus`

class. Source: `lightbulb/growth_workspace.py:262`.

Fields:
- `as_of: str`
- `scope_project_ref: ShortText`
- `artifact_counts: dict[str, int] = Field(default_factory=dict)`
- `experiments: tuple[ExperimentStatusRecord, ...] = Field(default_factory=tuple)`
- `pending_readout_refs: tuple[ShortText, ...] = Field(default_factory=tuple)`
- `index_revision: int = Field(ge=0)`

### `lightbulb.growth_workspace.GrowthWorkspace`

class. Source: `lightbulb/growth_workspace.py:399`.

One scope's durable, verified store of Growth Engine artifacts.

#### Methods

##### `lightbulb.growth_workspace.GrowthWorkspace.authorize_action`



~~~python
def authorize_action(action: ProposedAction | Mapping[str, Any], *, as_of: str, authorization_ref: str) -> ActionAuthorization
~~~


Decide one proposed action under the current mandate; keep the receipt.

Source: `lightbulb/growth_workspace.py:1266`.

##### `lightbulb.growth_workspace.GrowthWorkspace.compile_agenda`



~~~python
def compile_agenda(as_of: str, *, policy: GrowthCadencePolicy | None=None) -> GrowthAgenda
~~~


One call, one ordered answer: what does this scope need from me now.

Source: `lightbulb/growth_workspace.py:1067`.

##### `lightbulb.growth_workspace.GrowthWorkspace.compile_briefing`



~~~python
def compile_briefing(as_of: str, *, budget_chars: int=4000, max_agenda_items: int=10, policy: GrowthCadencePolicy | None=None) -> GrowthBriefing
~~~


The cold-start call: one budgeted, digest-pinned rehydration.

Source: `lightbulb/growth_workspace.py:1089`.

##### `lightbulb.growth_workspace.GrowthWorkspace.experiment_status`



~~~python
def experiment_status(as_of: str, *, _records: list[WorkspaceRecord] | None=None) -> tuple[ExperimentStatusRecord, ...]
~~~


Deterministic state of every stored experiment at ``as_of``.

Source: `lightbulb/growth_workspace.py:978`.

##### `lightbulb.growth_workspace.GrowthWorkspace.latest`



~~~python
def latest(kind: WorkspaceKind, ref: str) -> BaseModel | None
~~~


Latest artifact of one kind for one ref (by saved_at, then digest).

Source: `lightbulb/growth_workspace.py:804`.

##### `lightbulb.growth_workspace.GrowthWorkspace.ledger`



~~~python
def ledger() -> GrowthLearningsLedger
~~~


The scope's learnings ledger, persisted inside the workspace.

Source: `lightbulb/growth_workspace.py:1369`.

##### `lightbulb.growth_workspace.GrowthWorkspace.list`



~~~python
def list(*, kind: WorkspaceKind | None=None, ref: str | None=None) -> tuple[WorkspaceRecord, ...]
~~~


Source: `lightbulb/growth_workspace.py:821`.

##### `lightbulb.growth_workspace.GrowthWorkspace.load`



~~~python
def load(kind: WorkspaceKind, storage_digest: str) -> BaseModel
~~~


Load one artifact by identity; re-verifies before returning.

Source: `lightbulb/growth_workspace.py:791`.

##### `lightbulb.growth_workspace.GrowthWorkspace.pending_readouts`



~~~python
def pending_readouts(as_of: str) -> tuple[ExperimentStatusRecord, ...]
~~~


Experiments past their horizon that still lack a readout.

Source: `lightbulb/growth_workspace.py:1031`.

##### `lightbulb.growth_workspace.GrowthWorkspace.save_action_authorization`



~~~python
def save_action_authorization(authorization: ActionAuthorization | Mapping[str, Any], *, saved_at: str) -> WorkspaceRecord
~~~


Source: `lightbulb/growth_workspace.py:958`.

##### `lightbulb.growth_workspace.GrowthWorkspace.save_arm_evidence`



~~~python
def save_arm_evidence(evidence: ExperimentArmEvidence | Mapping[str, Any], *, saved_at: str) -> WorkspaceRecord
~~~


Source: `lightbulb/growth_workspace.py:853`.

##### `lightbulb.growth_workspace.GrowthWorkspace.save_audience_growth_plan`



~~~python
def save_audience_growth_plan(plan: AudienceGrowthPlan | Mapping[str, Any], *, saved_at: str) -> WorkspaceRecord
~~~


Source: `lightbulb/growth_workspace.py:874`.

##### `lightbulb.growth_workspace.GrowthWorkspace.save_content_calendar_plan`



~~~python
def save_content_calendar_plan(plan: ContentCalendarPlan | Mapping[str, Any], *, saved_at: str) -> WorkspaceRecord
~~~


Source: `lightbulb/growth_workspace.py:869`.

##### `lightbulb.growth_workspace.GrowthWorkspace.save_customer_value`



~~~python
def save_customer_value(snapshot: CustomerValueSnapshot | Mapping[str, Any], *, saved_at: str) -> WorkspaceRecord
~~~


Source: `lightbulb/growth_workspace.py:927`.

##### `lightbulb.growth_workspace.GrowthWorkspace.save_customer_value_review`



~~~python
def save_customer_value_review(review: CustomerValueReview | Mapping[str, Any], *, saved_at: str) -> WorkspaceRecord
~~~


Source: `lightbulb/growth_workspace.py:935`.

##### `lightbulb.growth_workspace.GrowthWorkspace.save_experiment_design`



~~~python
def save_experiment_design(design: GrowthExperimentDesign | Mapping[str, Any], *, saved_at: str) -> WorkspaceRecord
~~~


Source: `lightbulb/growth_workspace.py:845`.

##### `lightbulb.growth_workspace.GrowthWorkspace.save_experiment_readout`



~~~python
def save_experiment_readout(readout: GrowthExperimentReadout | Mapping[str, Any], *, saved_at: str) -> WorkspaceRecord
~~~


Source: `lightbulb/growth_workspace.py:861`.

##### `lightbulb.growth_workspace.GrowthWorkspace.save_funnel_delta`



~~~python
def save_funnel_delta(delta: FunnelDelta | Mapping[str, Any], *, saved_at: str) -> WorkspaceRecord
~~~


Source: `lightbulb/growth_workspace.py:922`.

##### `lightbulb.growth_workspace.GrowthWorkspace.save_funnel_snapshot`



~~~python
def save_funnel_snapshot(snapshot: GrowthFunnelSnapshot | Mapping[str, Any], *, saved_at: str) -> WorkspaceRecord
~~~


Source: `lightbulb/growth_workspace.py:840`.

##### `lightbulb.growth_workspace.GrowthWorkspace.save_growth_agenda`



~~~python
def save_growth_agenda(agenda: GrowthAgenda | Mapping[str, Any], *, saved_at: str) -> WorkspaceRecord
~~~


Source: `lightbulb/growth_workspace.py:917`.

##### `lightbulb.growth_workspace.GrowthWorkspace.save_growth_diagnosis`



~~~python
def save_growth_diagnosis(diagnosis: GrowthDiagnosis | Mapping[str, Any], *, saved_at: str) -> WorkspaceRecord
~~~


Source: `lightbulb/growth_workspace.py:966`.

##### `lightbulb.growth_workspace.GrowthWorkspace.save_growth_mandate`



~~~python
def save_growth_mandate(mandate: GrowthMandate | Mapping[str, Any], *, saved_at: str) -> WorkspaceRecord
~~~


Source: `lightbulb/growth_workspace.py:953`.

##### `lightbulb.growth_workspace.GrowthWorkspace.save_growth_objective`



~~~python
def save_growth_objective(objective: GrowthObjective | Mapping[str, Any], *, saved_at: str) -> WorkspaceRecord
~~~


Source: `lightbulb/growth_workspace.py:940`.

##### `lightbulb.growth_workspace.GrowthWorkspace.save_objective_assessment`



~~~python
def save_objective_assessment(assessment: ObjectiveAssessment | Mapping[str, Any], *, saved_at: str) -> WorkspaceRecord
~~~


Source: `lightbulb/growth_workspace.py:945`.

##### `lightbulb.growth_workspace.GrowthWorkspace.save_portfolio_diagnosis`



~~~python
def save_portfolio_diagnosis(diagnosis: PortfolioDiagnosis | Mapping[str, Any], *, saved_at: str) -> WorkspaceRecord
~~~


Source: `lightbulb/growth_workspace.py:971`.

##### `lightbulb.growth_workspace.GrowthWorkspace.save_portfolio_rollup`



~~~python
def save_portfolio_rollup(rollup: PortfolioFunnelRollup | Mapping[str, Any], *, saved_at: str) -> WorkspaceRecord
~~~


Source: `lightbulb/growth_workspace.py:879`.

##### `lightbulb.growth_workspace.GrowthWorkspace.save_price_elasticity`



~~~python
def save_price_elasticity(estimate: PriceElasticityEstimate | Mapping[str, Any], *, saved_at: str) -> WorkspaceRecord
~~~


Source: `lightbulb/growth_workspace.py:909`.

##### `lightbulb.growth_workspace.GrowthWorkspace.save_price_plan`



~~~python
def save_price_plan(plan: PricePlan | Mapping[str, Any], *, saved_at: str) -> WorkspaceRecord
~~~


Source: `lightbulb/growth_workspace.py:899`.

##### `lightbulb.growth_workspace.GrowthWorkspace.save_profit_review`



~~~python
def save_profit_review(review: ProfitReview | Mapping[str, Any], *, saved_at: str) -> WorkspaceRecord
~~~


Source: `lightbulb/growth_workspace.py:904`.

##### `lightbulb.growth_workspace.GrowthWorkspace.save_rail_dispatch`



~~~python
def save_rail_dispatch(package: RailDispatchPackage | Mapping[str, Any], *, saved_at: str) -> WorkspaceRecord
~~~


Source: `lightbulb/growth_workspace.py:884`.

##### `lightbulb.growth_workspace.GrowthWorkspace.save_rail_receipt`



~~~python
def save_rail_receipt(receipt: RailExecutionReceipt | Mapping[str, Any], *, saved_at: str) -> WorkspaceRecord
~~~


Source: `lightbulb/growth_workspace.py:889`.

##### `lightbulb.growth_workspace.GrowthWorkspace.save_unit_economics`



~~~python
def save_unit_economics(snapshot: UnitEconomicsSnapshot | Mapping[str, Any], *, saved_at: str) -> WorkspaceRecord
~~~


Source: `lightbulb/growth_workspace.py:894`.

##### `lightbulb.growth_workspace.GrowthWorkspace.status`



~~~python
def status(as_of: str) -> WorkspaceStatus
~~~


One cross-session answer to "where is this scope's growth work".

Source: `lightbulb/growth_workspace.py:1040`.

## Module `lightbulb.gtm_materializer`

Host-side materialization for one governed Shopify DRAFT product.

### `lightbulb.gtm_materializer.ProductLaunchApprovalGrant`

class. Source: `lightbulb/gtm_materializer.py:85`.

Exact binding for one platform-governed approval reference.

Fields:
- `schema_id: Literal['lightbulb.product_launch_approval_grant.v1'] = Field(default=PRODUCT_LAUNCH_APPROVAL_GRANT_SCHEMA, alias='schema')`
- `plan_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `exact_scope_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `operation_id: str = Field(min_length=1, max_length=200)`
- `operation_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `connector_account_ref: str = Field(min_length=1, max_length=200)`
- `approval_unit: str = Field(min_length=1, max_length=200)`
- `approval_ref: str = Field(min_length=1, max_length=200)`
- `approval_receipt_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `grant_key_id: str = Field(min_length=1, max_length=100)`
- `grant_hmac: str = Field(pattern='^[0-9a-f]{64}$')`

#### Methods

##### `lightbulb.gtm_materializer.ProductLaunchApprovalGrant.hmac_payload`



~~~python
def hmac_payload() -> dict[str, Any]
~~~


Source: `lightbulb/gtm_materializer.py:117`.

### `lightbulb.gtm_materializer.ProductLaunchMaterializationResult`

class. Source: `lightbulb/gtm_materializer.py:125`.

Bounded result for the single DRAFT-product materialization step.

Fields:
- `schema_id: Literal['lightbulb.product_launch_materialization_result.v1'] = Field(default=PRODUCT_LAUNCH_MATERIALIZATION_RESULT_SCHEMA, alias='schema')`
- `status: MaterializationStatus`
- `launch_ref: str`
- `plan_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `operation_id: str`
- `operation_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `connector_account_ref: str`
- `approval_unit: str`
- `run_ref: str`
- `iteration: int = Field(ge=1, le=4)`
- `idempotency_key: str = Field(min_length=1, max_length=240)`
- `connector_status: ConnectorExecutionStatus | None = None`
- `connector_error_kind: ConnectorErrorKind | None = None`
- `connector_error_code: str | None = Field(default=None, max_length=160)`
- `approval_ref: str | None = Field(default=None, max_length=200)`
- `approval_receipt_digest: str | None = Field(default=None, pattern='^[0-9a-f]{64}$')`
- `execution_receipt_digest: str | None = Field(default=None, pattern='^[0-9a-f]{64}$')`
- `product_id: str | None = Field(default=None, max_length=512)`
- `receipt: ProductLaunchReceipt | None = None`
- `draft_product_created: bool = False`
- `live_systems_changed: bool | None = False`
- `omnichannel_launch_completed: Literal[False] = False`
- `summary: str = Field(min_length=1, max_length=1000)`

#### Methods

##### `lightbulb.gtm_materializer.ProductLaunchMaterializationResult.to_dict`



~~~python
def to_dict() -> dict[str, Any]
~~~


Source: `lightbulb/gtm_materializer.py:212`.

### `lightbulb.gtm_materializer.bind_product_launch_operation_approval`

function. Source: `lightbulb/gtm_materializer.py:407`.



~~~python
bind_product_launch_operation_approval(plan_value: OmnichannelProductLaunchPlan | Mapping[str, Any], *, scope: DynamicWorkflowScope | Mapping[str, Any], scope_keyring: ExactScopeDigestProvider, operation_id: str, approval_ref: str, approval_receipt_digest: str) -> ProductLaunchApprovalGrant
~~~


Bind one opaque governed approval ref to one exact launch write.

### `lightbulb.gtm_materializer.bind_shopify_draft_product_approval`

function. Source: `lightbulb/gtm_materializer.py:474`.



~~~python
bind_shopify_draft_product_approval(plan_value: OmnichannelProductLaunchPlan | Mapping[str, Any], *, scope: DynamicWorkflowScope | Mapping[str, Any], scope_keyring: ExactScopeDigestProvider, approval_ref: str, approval_receipt_digest: str) -> ProductLaunchApprovalGrant
~~~


Bind one governed approval to the canonical Shopify DRAFT operation.

### `lightbulb.gtm_materializer.materialize_shopify_draft_product`

function. Source: `lightbulb/gtm_materializer.py:642`.



~~~python
materialize_shopify_draft_product(plan_value: OmnichannelProductLaunchPlan | Mapping[str, Any], *, scope: DynamicWorkflowScope | Mapping[str, Any], scope_keyring: ExactScopeDigestProvider, execution_scope: ExecutionScope | Mapping[str, Any], executor: ConnectorExecutor, run_ref: str, iteration: int=1, preview_only: bool=True, approval_grant: ProductLaunchApprovalGrant | Mapping[str, Any] | None=None, completed_at: datetime | None=None, issuer_ref: str='lightbulb-gtm-materializer') -> ProductLaunchMaterializationResult
~~~


Preview, propose, or execute the plan's one Shopify DRAFT create.

## Module `lightbulb.gtm_primitives`

Typed, deterministic go-to-market workflow planning primitives.

### `lightbulb.gtm_primitives.OmnichannelProductLaunchValidationError`

class. Source: `lightbulb/gtm_primitives.py:221`.

A launch brief cannot be converted into a safe closed-world plan.

### `lightbulb.gtm_primitives.LaunchMoney`

class. Source: `lightbulb/gtm_primitives.py:320`.

Fields:
- `amount: Decimal = Field(gt=0, le=100000000, multiple_of=_MONEY_QUANTUM)`
- `currency: CurrencyCode`

### `lightbulb.gtm_primitives.LaunchVariant`

class. Source: `lightbulb/gtm_primitives.py:330`.

Fields:
- `variant_ref: PortableRef`
- `title: ShortText`
- `price: LaunchMoney`
- `sku: Sku | None = None`

### `lightbulb.gtm_primitives.LaunchProductBrief`

class. Source: `lightbulb/gtm_primitives.py:337`.

Fields:
- `product_ref: PortableRef`
- `connector_account_ref: OperationRef`
- `title: ShopifyProductTitle`
- `description: LongText | None = None`
- `vendor: ShortText | None = None`
- `product_type: ShortText | None = None`
- `tags: tuple[ShortText, ...] = Field(default_factory=tuple, max_length=50)`
- `price: LaunchMoney`
- `sku: Sku | None = None`
- `taxable: bool = True`
- `requires_shipping: bool = True`
- `landing_url: PublicHttpsUrl`
- `publication_ids: tuple[ShopifyPublicationId, ...] = Field(min_length=1, max_length=10)`
- `variants: tuple[LaunchVariant, ...] = Field(default_factory=tuple, max_length=20)`

### `lightbulb.gtm_primitives.SalesTouch`

class. Source: `lightbulb/gtm_primitives.py:390`.

Fields:
- `day_offset: int = Field(ge=0, le=120)`
- `channel: Literal['email', 'call', 'linkedin', 'task']`
- `objective: ShortText`
- `message: LongText`

### `lightbulb.gtm_primitives.SalesCampaignBrief`

class. Source: `lightbulb/gtm_primitives.py:397`.

Fields:
- `provider: CrmProvider = 'hubspot'`
- `connector_account_ref: OperationRef`
- `name: ShortText`
- `audience: LongText`
- `goal: LongText`
- `offer: LongText`
- `start_date: str`
- `end_date: str`
- `notes: LongText | None = None`
- `touches: tuple[SalesTouch, ...] = Field(default_factory=tuple, max_length=_MAX_SALES_TOUCHES)`

### `lightbulb.gtm_primitives.SocialPostDraft`

class. Source: `lightbulb/gtm_primitives.py:439`.

Fields:
- `channel: SocialChannel`
- `connector_account_ref: OperationRef`
- `provider_target_id: ShortText`
- `body: LongText`
- `media_url: PublicHttpsUrl | None = None`
- `link_url: PublicHttpsUrl | None = None`

### `lightbulb.gtm_primitives.NormalizedPerformanceMetrics`

class. Source: `lightbulb/gtm_primitives.py:472`.

Fields:
- `impressions: int | None = Field(default=None, ge=0)`
- `clicks: int | None = Field(default=None, ge=0)`
- `engagements: int | None = Field(default=None, ge=0)`
- `conversions: int | None = Field(default=None, ge=0)`
- `sessions: int | None = Field(default=None, ge=0)`
- `orders: int | None = Field(default=None, ge=0)`
- `leads: int | None = Field(default=None, ge=0)`
- `opportunities: int | None = Field(default=None, ge=0)`
- `won_deals: int | None = Field(default=None, ge=0)`
- `revenue: Decimal | None = Field(default=None, ge=0, multiple_of=_MONEY_QUANTUM)`
- `conversion_rate: Decimal | None = Field(default=None, ge=0, le=1, multiple_of=_RATE_QUANTUM)`
- `click_through_rate: Decimal | None = Field(default=None, ge=0, le=1, multiple_of=_RATE_QUANTUM)`
- `engagement_rate: Decimal | None = Field(default=None, ge=0, le=1, multiple_of=_RATE_QUANTUM)`
- `pipeline_win_rate: Decimal | None = Field(default=None, ge=0, le=1, multiple_of=_RATE_QUANTUM)`

### `lightbulb.gtm_primitives.AnalyticsSnapshot`

class. Source: `lightbulb/gtm_primitives.py:523`.

Fields:
- `observation_ref: PortableRef`
- `connector_account_ref: OperationRef`
- `provider: AnalyticsProvider`
- `source_capability: str = Field(min_length=3, max_length=160, pattern='^[a-z][a-z0-9_-]{0,63}\\.[a-z][a-z0-9_.-]{0,127}$')`
- `observed_at: str`
- `window_start: str`
- `window_end: str`
- `sample_size: int = Field(ge=0, le=10000000000)`
- `metrics: NormalizedPerformanceMetrics`
- `evidence_digest: Sha256Digest`
- `receipt_key_id: str | None = Field(default=None, min_length=8, max_length=80, pattern='^[A-Za-z0-9][A-Za-z0-9._-]{7,79}$')`
- `exact_scope_digest: Sha256Digest | None = None`
- `snapshot_hmac: Sha256Digest | None = None`

#### Methods

##### `lightbulb.gtm_primitives.AnalyticsSnapshot.hmac_payload`



~~~python
def hmac_payload() -> dict[str, Any]
~~~


Return the complete canonical observation covered by host HMAC.

Source: `lightbulb/gtm_primitives.py:575`.

### `lightbulb.gtm_primitives.ProductLaunchEvidenceScope`

class. Source: `lightbulb/gtm_primitives.py:585`.

Fields:
- `status: Literal['caller_supplied_unverified', 'host_hmac_verified']`
- `receipt_key_id: str | None = Field(default=None, min_length=8, max_length=80, pattern='^[A-Za-z0-9][A-Za-z0-9._-]{7,79}$')`
- `exact_scope_digest: Sha256Digest | None = None`

### `lightbulb.gtm_primitives.ProductLaunchConnectorAccountBinding`

class. Source: `lightbulb/gtm_primitives.py:607`.

Opaque destination account reference attested by the authenticated host.

Fields:
- `schema_id: Literal['lightbulb.product_launch_connector_account_binding.v1'] = Field(default=PRODUCT_LAUNCH_CONNECTOR_ACCOUNT_BINDING_SCHEMA, alias='schema')`
- `provider: LaunchConnectorProvider`
- `connector_account_ref: OperationRef`
- `receipt_key_id: str | None = Field(default=None, min_length=8, max_length=80, pattern='^[A-Za-z0-9][A-Za-z0-9._-]{7,79}$')`
- `exact_scope_digest: Sha256Digest | None = None`
- `account_hmac: Sha256Digest | None = None`

#### Methods

##### `lightbulb.gtm_primitives.ProductLaunchConnectorAccountBinding.hmac_payload`



~~~python
def hmac_payload() -> dict[str, Any]
~~~


Source: `lightbulb/gtm_primitives.py:640`.

### `lightbulb.gtm_primitives.LaunchOptimizationPolicy`

class. Source: `lightbulb/gtm_primitives.py:649`.

Fields:
- `primary_metric: PrimaryMetric = 'conversion_rate'`
- `target_value: Decimal = Field(default=Decimal('0.03'), ge=0, multiple_of=_RATE_QUANTUM)`
- `minimum_sample_size: int = Field(default=100, ge=1, le=1000000000)`
- `max_observation_age_hours: int = Field(default=720, ge=1, le=8760)`
- `measurement_window_hours: int = Field(default=168, ge=1, le=2160)`
- `max_iterations: int = Field(default=3, ge=1, le=4)`

### `lightbulb.gtm_primitives.PlanOmnichannelProductLaunchInput`

class. Source: `lightbulb/gtm_primitives.py:671`.

Fields:
- `analysis_as_of: str`
- `launch_ref: PortableRef`
- `business_goal: LongText`
- `target_audience: LongText`
- `value_proposition: LongText`
- `product: LaunchProductBrief`
- `sales_campaign: SalesCampaignBrief`
- `social_drafts: tuple[SocialPostDraft, ...] = Field(min_length=1, max_length=_MAX_SOCIAL_DRAFTS)`
- `analytics_snapshots: tuple[AnalyticsSnapshot, ...] = Field(default_factory=tuple, max_length=_MAX_ANALYTICS_SNAPSHOTS)`
- `optimization_policy: LaunchOptimizationPolicy = Field(default_factory=LaunchOptimizationPolicy)`

### `lightbulb.gtm_primitives.ShopifyDraftProductArguments`

class. Source: `lightbulb/gtm_primitives.py:747`.

Fields:
- `kind: Literal['shopify_draft_product']`
- `title: ShortText`
- `description: LongText | None = None`
- `vendor: ShortText | None = None`
- `product_type: ShortText | None = None`
- `status: Literal['DRAFT'] = 'DRAFT'`
- `tags: tuple[ShortText, ...] = Field(default_factory=tuple, max_length=50)`
- `price: Annotated[str, StringConstraints(pattern='^(?:0|[1-9][0-9]{0,8})\\.[0-9]{2}$')]`
- `sku: Sku | None = None`
- `taxable: bool`
- `requires_shipping: bool`

### `lightbulb.gtm_primitives.ShopifyPublishProductArguments`

class. Source: `lightbulb/gtm_primitives.py:769`.

Fields:
- `kind: Literal['shopify_publish_product']`
- `publication_ids: tuple[ShopifyPublicationId, ...] = Field(min_length=1, max_length=50)`

### `lightbulb.gtm_primitives.ShopifyActivateProductArguments`

class. Source: `lightbulb/gtm_primitives.py:782`.

Fields:
- `kind: Literal['shopify_activate_product']`
- `status: Literal['ACTIVE'] = 'ACTIVE'`

### `lightbulb.gtm_primitives.LandingReadinessArguments`

class. Source: `lightbulb/gtm_primitives.py:787`.

Fields:
- `kind: Literal['landing_readiness_gate']`
- `landing_url: PublicHttpsUrl`
- `required_checks: tuple[Literal['page_reachable', 'product_visible', 'price_and_currency_match', 'checkout_available'], ...] = ('page_reachable', 'product_visible', 'price_and_currency_match', 'checkout_available')`

### `lightbulb.gtm_primitives.HubSpotCampaignContainerArguments`

class. Source: `lightbulb/gtm_primitives.py:811`.

Fields:
- `kind: Literal['hubspot_campaign_container']`
- `name: ShortText`
- `startDate: str`
- `endDate: str`
- `goal: LongText`
- `audience: LongText`
- `notes: CampaignNotes`

### `lightbulb.gtm_primitives.FacebookPublishArguments`

class. Source: `lightbulb/gtm_primitives.py:826`.

Fields:
- `kind: Literal['facebook_publish']`
- `page_id: ShortText`
- `message: LongText`
- `image_url: PublicHttpsUrl | None = None`

### `lightbulb.gtm_primitives.InstagramPublishArguments`

class. Source: `lightbulb/gtm_primitives.py:833`.

Fields:
- `kind: Literal['instagram_publish']`
- `instagram_business_account_id: ShortText`
- `caption: LongText`
- `image_url: PublicHttpsUrl`

### `lightbulb.gtm_primitives.LinkedInPublishArguments`

class. Source: `lightbulb/gtm_primitives.py:840`.

Fields:
- `kind: Literal['linkedin_publish']`
- `author_urn: ShortText`
- `text: LinkedInText`
- `url: PublicHttpsUrl`
- `image_url: PublicHttpsUrl | None = None`

### `lightbulb.gtm_primitives.ProductLaunchInputBinding`

class. Source: `lightbulb/gtm_primitives.py:879`.

Fields:
- `target_field: Literal['product_id']`
- `source_operation_id: OperationRef`
- `source_output_field: Literal['product_id']`

### `lightbulb.gtm_primitives.ProductLaunchOperation`

class. Source: `lightbulb/gtm_primitives.py:885`.

Fields:
- `ordinal: int = Field(ge=1, le=8)`
- `operation_id: OperationRef`
- `stage: Literal['catalog_materialization', 'catalog_activation', 'catalog_publication', 'landing_readiness', 'crm_campaign_container', 'social_publish']`
- `execution_kind: ExecutionKind`
- `capability: LaunchCapability`
- `surface_availability: SurfaceAvailability`
- `connector_account_ref: OperationRef`
- `effect: Literal['read', 'write']`
- `arguments: LaunchOperationArguments`
- `depends_on: tuple[OperationRef, ...] = Field(default_factory=tuple, max_length=2)`
- `input_bindings: tuple[ProductLaunchInputBinding, ...] = Field(default_factory=tuple, max_length=2)`
- `status: Literal['proposal_only_not_executed', 'blocked_pending_evidence']`
- `approval_required: bool`
- `approval_unit: OperationRef | None = None`
- `receipt_kind: str = Field(min_length=1, max_length=120, pattern='^[a-z][a-z0-9_]{0,119}$')`
- `scheduling_semantics: Literal['not_scheduled'] = 'not_scheduled'`
- `operation_digest: str = ''`

#### Methods

##### `lightbulb.gtm_primitives.ProductLaunchOperation.connector_inputs`



~~~python
def connector_inputs(resolved_outputs: Mapping[str, Mapping[str, Any]] | None=None) -> dict[str, Any]
~~~


Return only provider-contract arguments, excluding SDK discriminators.

Source: `lightbulb/gtm_primitives.py:1050`.

### `lightbulb.gtm_primitives.AnalyticsFinding`

class. Source: `lightbulb/gtm_primitives.py:1087`.

Fields:
- `provider: AnalyticsProvider`
- `status: AnalyticsEligibility`
- `observation_ref: PortableRef | None = None`
- `connector_account_ref: OperationRef | None = None`
- `source_capability: str | None = None`
- `evidence_digest: Sha256Digest | None = None`
- `age_hours: int | None = Field(default=None, ge=0)`
- `sample_size: int | None = Field(default=None, ge=0)`
- `selected_metric: PrimaryMetric | None = None`
- `selected_value: Decimal | None = Field(default=None, ge=0, le=1, multiple_of=_RATE_QUANTUM)`
- `scope_verified: bool = False`
- `rationale: str = Field(min_length=1, max_length=500)`

### `lightbulb.gtm_primitives.ChannelPriority`

class. Source: `lightbulb/gtm_primitives.py:1111`.

Fields:
- `rank: int = Field(ge=1, le=_MAX_SOCIAL_DRAFTS)`
- `channel: SocialChannel`
- `evidence_informed: bool`
- `score: Decimal | None = Field(default=None, ge=0, le=1, multiple_of=_RATE_QUANTUM)`
- `observation_ref: PortableRef | None = None`
- `rationale: str = Field(min_length=1, max_length=500)`

### `lightbulb.gtm_primitives.ProductLaunchCapabilityGap`

class. Source: `lightbulb/gtm_primitives.py:1144`.

Fields:
- `code: GapCode`
- `affected_capabilities: tuple[str, ...] = Field(default_factory=tuple, max_length=12)`
- `blocks_autonomous_launch: bool`
- `message: str = Field(min_length=1, max_length=1000)`

### `lightbulb.gtm_primitives.CampaignMaterializationDisposition`

class. Source: `lightbulb/gtm_primitives.py:1156`.

Fields:
- `provider: CrmProvider`
- `planning_complete: Literal[True] = True`
- `container_operation_id: OperationRef | None = None`
- `campaign_container_supported: bool`
- `sales_sequence_authoring_supported: Literal[False] = False`
- `sales_sequence_launch_claimed: Literal[False] = False`

### `lightbulb.gtm_primitives.RequiredLaunchReceipt`

class. Source: `lightbulb/gtm_primitives.py:1165`.

Fields:
- `criterion_id: str = Field(min_length=1, max_length=120, pattern='^[a-z][a-z0-9_-]{0,119}$')`
- `receipt_kind: str = Field(min_length=1, max_length=120, pattern='^[a-z][a-z0-9_]{0,119}$')`
- `evidence_kind: str = Field(min_length=1, max_length=120, pattern='^[a-z][a-z0-9_]{0,119}$')`
- `operation_id: OperationRef | None = None`
- `operation_digest: Sha256Digest | None = None`
- `approval_unit: OperationRef | None = None`
- `proves: str = Field(min_length=1, max_length=500)`

### `lightbulb.gtm_primitives.ProductLaunchReceipt`

class. Source: `lightbulb/gtm_primitives.py:1195`.

Host-HMAC-sealed evidence envelope bound to one launch criterion.

Fields:
- `schema_id: Literal['lightbulb.product_launch_receipt.v1'] = Field(default=PRODUCT_LAUNCH_RECEIPT_SCHEMA, alias='schema')`
- `receipt_ref: OperationRef`
- `criterion_id: str = Field(min_length=1, max_length=120, pattern='^[a-z][a-z0-9_-]{0,119}$')`
- `receipt_kind: str = Field(min_length=1, max_length=120, pattern='^[a-z][a-z0-9_]{0,119}$')`
- `evidence_kind: str = Field(min_length=1, max_length=120, pattern='^[a-z][a-z0-9_]{0,119}$')`
- `plan_digest: Sha256Digest`
- `exact_scope_digest: Sha256Digest`
- `run_ref: WorkflowRunRef`
- `iteration: int = Field(ge=1, le=4)`
- `operation_id: OperationRef | None = None`
- `operation_digest: Sha256Digest | None = None`
- `approval_unit: OperationRef | None = None`
- `approval_receipt_digest: Sha256Digest | None = None`
- `issuer_ref: OperationRef`
- `evidence_digest: Sha256Digest`
- `status: Literal['succeeded'] = 'succeeded'`
- `issued_at: str`
- `effective_at: str`
- `window_start: str | None = None`
- `window_end: str | None = None`
- `sample_size: int | None = Field(default=None, ge=0, le=10000000000)`
- `primary_metric: PrimaryMetric | None = None`
- `metric_value: Decimal | None = Field(default=None, ge=0, le=1, multiple_of=_RATE_QUANTUM)`
- `receipt_key_id: str = Field(min_length=8, max_length=80, pattern='^[A-Za-z0-9][A-Za-z0-9._-]{7,79}$')`
- `receipt_hmac: Sha256Digest`
- `receipt_digest: str = ''`

#### Methods

##### `lightbulb.gtm_primitives.ProductLaunchReceipt.hmac_payload`



~~~python
def hmac_payload() -> dict[str, Any]
~~~


Source: `lightbulb/gtm_primitives.py:1305`.

##### `lightbulb.gtm_primitives.ProductLaunchReceipt.to_dict`



~~~python
def to_dict() -> dict[str, Any]
~~~


Source: `lightbulb/gtm_primitives.py:1313`.

### `lightbulb.gtm_primitives.ProductLaunchIterationEvaluation`

class. Source: `lightbulb/gtm_primitives.py:1326`.

One deterministic decision in the bounded post-launch feedback loop.

Fields:
- `schema_id: Literal['lightbulb.product_launch_iteration_evaluation.v1'] = Field(default=PRODUCT_LAUNCH_ITERATION_EVALUATION_SCHEMA, alias='schema')`
- `plan_digest: Sha256Digest`
- `exact_scope_digest: Sha256Digest`
- `run_ref: WorkflowRunRef`
- `iteration: int = Field(ge=1, le=4)`
- `commitment_ref: OperationRef`
- `evaluated_at: str`
- `previous_evaluation_digest: Sha256Digest | None = None`
- `primary_metric: PrimaryMetric`
- `target_value: Decimal = Field(ge=0, le=1, multiple_of=_RATE_QUANTUM)`
- `observed_value: Decimal = Field(ge=0, le=1, multiple_of=_RATE_QUANTUM)`
- `target_met: bool`
- `decision: Literal['target_met', 'revise_plan', 'iteration_limit_reached']`
- `next_iteration: int | None = Field(default=None, ge=2, le=4)`
- `verified_evidence: tuple[EvidenceRef, ...] = Field(min_length=1, max_length=20)`
- `summary: str = Field(min_length=1, max_length=500)`
- `evaluation_key_id: str = Field(min_length=8, max_length=80, pattern='^[A-Za-z0-9][A-Za-z0-9._-]{7,79}$')`
- `evaluation_hmac: Sha256Digest`
- `evaluation_digest: str = ''`

#### Methods

##### `lightbulb.gtm_primitives.ProductLaunchIterationEvaluation.hmac_payload`



~~~python
def hmac_payload() -> dict[str, Any]
~~~


Source: `lightbulb/gtm_primitives.py:1409`.

##### `lightbulb.gtm_primitives.ProductLaunchIterationEvaluation.to_dict`



~~~python
def to_dict() -> dict[str, Any]
~~~


Source: `lightbulb/gtm_primitives.py:1417`.

### `lightbulb.gtm_primitives.ProductLaunchEvaluationLoop`

class. Source: `lightbulb/gtm_primitives.py:1421`.

Fields:
- `loop_ref: OperationRef`
- `trigger_event: Literal['gtm.product_launch_observation_window_closed'] = 'gtm.product_launch_observation_window_closed'`
- `stages: tuple[Literal['baseline', 'approve', 'materialize', 'observe', 'evaluate', 'revise'], ...]`
- `primary_metric: PrimaryMetric`
- `target_value: Decimal = Field(ge=0, le=1, multiple_of=_RATE_QUANTUM)`
- `minimum_sample_size: int = Field(ge=1, le=1000000000)`
- `max_observation_age_hours: int = Field(ge=1, le=8760)`
- `measurement_window_hours: int = Field(ge=1, le=2160)`
- `max_iterations: int = Field(ge=1, le=4)`
- `observation_capabilities: tuple[str, ...] = Field(min_length=1, max_length=8)`
- `required_receipt_kinds: tuple[str, ...] = Field(min_length=1, max_length=12)`
- `stop_conditions: tuple[Literal['target_met', 'iteration_limit_reached', 'approval_revoked', 'evidence_missing'], ...]`
- `fresh_evidence_required: Literal[True] = True`
- `external_writes_require_new_approval: Literal[True] = True`

### `lightbulb.gtm_primitives.ProductLaunchScaleContract`

class. Source: `lightbulb/gtm_primitives.py:1474`.

Fields:
- `execution_scope: Literal['one_declared_scope_and_project'] = 'one_declared_scope_and_project'`
- `fan_out_key: Literal['scope_fingerprint+project_ref'] = 'scope_fingerprint+project_ref'`
- `scope_binding: Literal['caller_supplied_requires_host_verification'] = 'caller_supplied_requires_host_verification'`
- `max_launches_per_shard: Literal[12] = _MAX_LAUNCHES_PER_SHARD`
- `max_estimated_operations_per_shard: Literal[100] = 100`
- `max_serialized_job_bytes: Literal[262144] = _MAX_LAUNCH_JOB_BYTES`
- `max_serialized_shard_bytes: Literal[4194304] = _MAX_LAUNCH_SHARD_BYTES`
- `max_serialized_portfolio_bytes: Literal[67108864] = _MAX_LAUNCH_PORTFOLIO_BYTES`
- `recommended_global_parallelism: Literal[8] = 8`
- `recommended_parallelism_per_project: Literal[2] = 2`
- `approval_strategy: Literal['content_bound_per_write_revision'] = 'content_bound_per_write_revision'`
- `operation_estimate_semantics: Literal['initial_graph_only'] = 'initial_graph_only'`
- `resume_strategy: Literal['durable_run_per_launch'] = 'durable_run_per_launch'`

### `lightbulb.gtm_primitives.ProductLaunchEffectBoundary`

class. Source: `lightbulb/gtm_primitives.py:1498`.

Fields:
- `connector_calls_made: Literal[0] = 0`
- `domain_actions_called: Literal[0] = 0`
- `writes_executed: Literal[0] = 0`
- `products_created: Literal[0] = 0`
- `campaigns_created: Literal[0] = 0`
- `posts_published: Literal[0] = 0`

### `lightbulb.gtm_primitives.OmnichannelProductLaunchPlan`

class. Source: `lightbulb/gtm_primitives.py:1507`.

Fields:
- `schema_id: Literal['lightbulb.omnichannel_product_launch_plan.v1'] = Field(default=OMNICHANNEL_PRODUCT_LAUNCH_PLAN_SCHEMA, alias='schema')`
- `primitive_ref: Literal['gtm.plan_omnichannel_product_launch'] = OMNICHANNEL_PRODUCT_LAUNCH_PRIMITIVE_REF`
- `status: Literal['planned_with_execution_gaps'] = 'planned_with_execution_gaps'`
- `proposal_only: Literal[True] = True`
- `materialization_supported: Literal[False] = False`
- `live_systems_changed: Literal[False] = False`
- `launch_ref: PortableRef`
- `analysis_as_of: str`
- `analytics_scope: ProductLaunchEvidenceScope`
- `optimization_status: Literal['evidence_optimized', 'partially_evidence_informed', 'brief_only']`
- `business_goal: LongText`
- `target_audience: LongText`
- `value_proposition: LongText`
- `product: LaunchProductBrief`
- `sales_campaign: SalesCampaignBrief`
- `connector_account_bindings: tuple[ProductLaunchConnectorAccountBinding, ...] = Field(min_length=3, max_length=5)`
- `optimization_policy: LaunchOptimizationPolicy`
- `campaign_materialization: CampaignMaterializationDisposition`
- `analytics_findings: tuple[AnalyticsFinding, ...] = Field(min_length=1, max_length=8)`
- `channel_priority: tuple[ChannelPriority, ...] = Field(min_length=1, max_length=_MAX_SOCIAL_DRAFTS)`
- `operations: tuple[ProductLaunchOperation, ...] = Field(min_length=5, max_length=8)`
- `capability_gaps: tuple[ProductLaunchCapabilityGap, ...] = Field(min_length=3, max_length=12)`
- `required_receipts: tuple[RequiredLaunchReceipt, ...] = Field(min_length=3, max_length=12)`
- `evaluation_loop: ProductLaunchEvaluationLoop`
- `scale_contract: ProductLaunchScaleContract = Field(default_factory=ProductLaunchScaleContract)`
- `effect_boundary: ProductLaunchEffectBoundary = Field(default_factory=ProductLaunchEffectBoundary)`
- `summary: str = Field(min_length=1, max_length=1000)`
- `plan_hmac: Sha256Digest | None = None`
- `plan_digest: str = ''`

#### Methods

##### `lightbulb.gtm_primitives.OmnichannelProductLaunchPlan.hmac_payload`



~~~python
def hmac_payload() -> dict[str, Any]
~~~


Source: `lightbulb/gtm_primitives.py:1756`.

##### `lightbulb.gtm_primitives.OmnichannelProductLaunchPlan.to_dict`



~~~python
def to_dict() -> dict[str, Any]
~~~


Source: `lightbulb/gtm_primitives.py:1764`.

### `lightbulb.gtm_primitives.mint_product_launch_connector_account_binding`

function. Source: `lightbulb/gtm_primitives.py:1855`.



~~~python
mint_product_launch_connector_account_binding(value: ProductLaunchConnectorAccountBinding | Mapping[str, Any], *, scope: DynamicWorkflowScope | Mapping[str, Any], scope_keyring: ExactScopeDigestProvider, scope_key_id: str | None=None) -> ProductLaunchConnectorAccountBinding
~~~


Seal one opaque destination account to an authenticated workflow scope.

### `lightbulb.gtm_primitives.mint_product_launch_analytics_snapshot`

function. Source: `lightbulb/gtm_primitives.py:1998`.



~~~python
mint_product_launch_analytics_snapshot(value: AnalyticsSnapshot | Mapping[str, Any], *, scope: DynamicWorkflowScope | Mapping[str, Any], scope_keyring: ExactScopeDigestProvider, scope_key_id: str | None=None) -> AnalyticsSnapshot
~~~


Seal one host-verified connector observation for planning.

### `lightbulb.gtm_primitives.plan_omnichannel_product_launch`

function. Source: `lightbulb/gtm_primitives.py:2880`.



~~~python
plan_omnichannel_product_launch(value: PlanOmnichannelProductLaunchInput | Mapping[str, Any], *, verified_scope: DynamicWorkflowScope | Mapping[str, Any] | None=None, scope_keyring: ExactScopeDigestProvider | None=None, scope_key_id: str | None=None, connector_account_bindings: Iterable[ProductLaunchConnectorAccountBinding | Mapping[str, Any]] | None=None) -> OmnichannelProductLaunchPlan
~~~


Compile one deterministic, evidence-aware product-launch operation graph.

### `lightbulb.gtm_primitives.create_product_launch_evaluation_loop`

function. Source: `lightbulb/gtm_primitives.py:3029`.



~~~python
create_product_launch_evaluation_loop(plan: OmnichannelProductLaunchPlan, *, scope: DynamicWorkflowScope | Mapping[str, Any], created_at: datetime, run_ref: str | None=None, scope_keyring: ExactScopeDigestProvider | None=None) -> DynamicWorkflowState
~~~


Create a real bounded planner-builder-evaluator state for a launch plan.

### `lightbulb.gtm_primitives.verify_product_launch_plan`

function. Source: `lightbulb/gtm_primitives.py:3149`.



~~~python
verify_product_launch_plan(value: OmnichannelProductLaunchPlan | Mapping[str, Any], *, scope: DynamicWorkflowScope | Mapping[str, Any], scope_keyring: ExactScopeDigestProvider) -> OmnichannelProductLaunchPlan
~~~


Authenticate one host-bound launch plan for trusted downstream use.

### `lightbulb.gtm_primitives.mint_product_launch_receipt`

function. Source: `lightbulb/gtm_primitives.py:3176`.



~~~python
mint_product_launch_receipt(plan: OmnichannelProductLaunchPlan, *, scope: DynamicWorkflowScope | Mapping[str, Any], scope_keyring: ExactScopeDigestProvider, criterion_id: str, receipt_ref: str, issuer_ref: str, evidence_digest: str, issued_at: str, effective_at: str, window_start: str | None=None, window_end: str | None=None, run_ref: str | None=None, iteration: int=1, sample_size: int | None=None, primary_metric: PrimaryMetric | None=None, metric_value: Decimal | str | None=None, approval_receipt_digest: str | None=None) -> ProductLaunchReceipt
~~~


Mint evidence only after a trusted host verifies the underlying artifact.

### `lightbulb.gtm_primitives.verify_product_launch_receipts`

function. Source: `lightbulb/gtm_primitives.py:3275`.



~~~python
verify_product_launch_receipts(plan: OmnichannelProductLaunchPlan, receipts: Iterable[ProductLaunchReceipt | Mapping[str, Any]], *, scope: DynamicWorkflowScope | Mapping[str, Any], scope_keyring: ExactScopeDigestProvider, evaluated_at: datetime, run_ref: str | None=None, iteration: int=1, evidence_after: datetime | None=None) -> tuple[EvidenceRef, ...]
~~~


Verify a complete receipt set before admitting it to Dynamic Workflow.

### `lightbulb.gtm_primitives.evaluate_product_launch_iteration`

function. Source: `lightbulb/gtm_primitives.py:3441`.



~~~python
evaluate_product_launch_iteration(plan: OmnichannelProductLaunchPlan, receipts: Iterable[ProductLaunchReceipt | Mapping[str, Any]], *, scope: DynamicWorkflowScope | Mapping[str, Any], scope_keyring: ExactScopeDigestProvider, evaluated_at: datetime, iteration: int, run_ref: str | None=None, previous_evaluation: ProductLaunchIterationEvaluation | Mapping[str, Any] | None=None) -> ProductLaunchIterationEvaluation
~~~


Verify evidence and choose stop-or-revise for one bounded loop iteration.

### `lightbulb.gtm_primitives.ScopedProductLaunchJob`

class. Source: `lightbulb/gtm_primitives.py:3599`.

Fields:
- `job_ref: PortableRef`
- `scope_fingerprint: Sha256Digest`
- `project_ref: PortableRef`
- `launch: PlanOmnichannelProductLaunchInput`

### `lightbulb.gtm_primitives.ProductLaunchShard`

class. Source: `lightbulb/gtm_primitives.py:3623`.

Fields:
- `schema_id: Literal['lightbulb.product_launch_shard.v1'] = Field(default=PRODUCT_LAUNCH_SHARD_SCHEMA, alias='schema')`
- `shard_ref: OperationRef`
- `scope_fingerprint: Sha256Digest`
- `project_ref: PortableRef`
- `project_shard_index: int = Field(ge=1)`
- `project_shard_count: int = Field(ge=1)`
- `jobs: tuple[ScopedProductLaunchJob, ...] = Field(min_length=1, max_length=_MAX_LAUNCHES_PER_SHARD)`
- `estimated_operation_count: int = Field(ge=2, le=100)`
- `execution_scope: Literal['one_declared_scope_and_project'] = 'one_declared_scope_and_project'`
- `recommended_parallelism: int = Field(default=2, ge=1, le=2)`
- `shard_digest: str = ''`

#### Methods

##### `lightbulb.gtm_primitives.ProductLaunchShard.to_dict`



~~~python
def to_dict() -> dict[str, Any]
~~~


Source: `lightbulb/gtm_primitives.py:3696`.

### `lightbulb.gtm_primitives.ProductLaunchPortfolioPlan`

class. Source: `lightbulb/gtm_primitives.py:3700`.

Fields:
- `schema_id: Literal['lightbulb.product_launch_portfolio.v1'] = Field(default=PRODUCT_LAUNCH_PORTFOLIO_SCHEMA, alias='schema')`
- `project_count: int = Field(ge=1, le=_MAX_PORTFOLIO_LAUNCHES)`
- `launch_count: int = Field(ge=1, le=_MAX_PORTFOLIO_LAUNCHES)`
- `shard_count: int = Field(ge=1, le=_MAX_PORTFOLIO_LAUNCHES)`
- `estimated_operation_count: int = Field(ge=2)`
- `shards: tuple[ProductLaunchShard, ...] = Field(min_length=1, max_length=_MAX_PORTFOLIO_LAUNCHES)`
- `scale_contract: ProductLaunchScaleContract = Field(default_factory=ProductLaunchScaleContract)`
- `portfolio_digest: str = ''`

#### Methods

##### `lightbulb.gtm_primitives.ProductLaunchPortfolioPlan.to_dict`



~~~python
def to_dict() -> dict[str, Any]
~~~


Source: `lightbulb/gtm_primitives.py:3797`.

### `lightbulb.gtm_primitives.compile_product_launch_portfolio`

function. Source: `lightbulb/gtm_primitives.py:3809`.



~~~python
compile_product_launch_portfolio(jobs: Iterable[ScopedProductLaunchJob | Mapping[str, Any]], *, max_launches_per_shard: int=_MAX_LAUNCHES_PER_SHARD) -> ProductLaunchPortfolioPlan
~~~


Partition launches with exact scope boundaries and serialized-byte budgets.

### `lightbulb.gtm_primitives.PlanOmnichannelProductLaunchPrimitive`

class. Source: `lightbulb/gtm_primitives.py:3927`.

Compile an evidence-aware launch plan with zero external effects.

## Module `lightbulb.gtm_shopify_launch`

Resumable, fail-closed Shopify go-live runner for signed GTM plans.

### `lightbulb.gtm_shopify_launch.LandingReadinessRequest`

class. Source: `lightbulb/gtm_shopify_launch.py:141`.

Exact storefront state a trusted read implementation must observe.

Fields:
- `schema_id: Literal['lightbulb.landing_readiness_request.v1'] = Field(default=LANDING_READINESS_REQUEST_SCHEMA, alias='schema')`
- `plan_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `exact_scope_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `run_ref: str = Field(min_length=1, max_length=200)`
- `iteration: int = Field(ge=1, le=4)`
- `operation_id: str = Field(min_length=1, max_length=200)`
- `operation_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `connector_account_ref: str = Field(min_length=1, max_length=200)`
- `project_id: UUID`
- `product_id: str = Field(min_length=1, max_length=512)`
- `expected_title: str = Field(min_length=1, max_length=500)`
- `landing_url: str = Field(min_length=8, max_length=2000)`
- `expected_price: str = Field(pattern='^(?:0|[1-9][0-9]{0,8})\\.[0-9]{2}$')`
- `expected_currency: str = Field(pattern='^[A-Z]{3}$')`
- `expected_publication_ids: tuple[str, ...] = Field(min_length=1, max_length=50)`
- `publication_completed_at: str`
- `required_checks: tuple[Literal['page_reachable', 'product_visible', 'price_and_currency_match', 'checkout_available'], ...] = ('page_reachable', 'product_visible', 'price_and_currency_match', 'checkout_available')`
- `request_digest: str = ''`

### `lightbulb.gtm_shopify_launch.LandingReadinessObservation`

class. Source: `lightbulb/gtm_shopify_launch.py:224`.

Typed evidence returned by a trusted live-storefront reader.

Fields:
- `schema_id: Literal['lightbulb.landing_readiness_observation.v1'] = Field(default=LANDING_READINESS_OBSERVATION_SCHEMA, alias='schema')`
- `request_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `source_capability: str = Field(min_length=3, max_length=160)`
- `connector_account_ref: str = Field(min_length=1, max_length=200)`
- `project_id: UUID`
- `landing_url: str = Field(min_length=8, max_length=2000)`
- `product_id: str = Field(min_length=1, max_length=512)`
- `observed_title: str = Field(min_length=1, max_length=500)`
- `observed_price: str = Field(pattern='^(?:0|[1-9][0-9]{0,8})\\.[0-9]{2}$')`
- `observed_currency: str = Field(pattern='^[A-Z]{3}$')`
- `published_publication_ids: tuple[str, ...] = Field(min_length=1, max_length=50)`
- `page_reachable: bool`
- `product_visible: bool`
- `price_and_currency_match: bool`
- `checkout_available: bool`
- `observed_at: str`
- `evidence_digest: str = Field(pattern='^[0-9a-f]{64}$')`

### `lightbulb.gtm_shopify_launch.ShopifyProductReadinessPayload`

class. Source: `lightbulb/gtm_shopify_launch.py:285`.

Closed Spring/provider envelope for the governed readiness read.

Fields:
- `schema_id: Literal['lightbulb.shopify_product_readiness.v1'] = Field(default=SHOPIFY_PRODUCT_READINESS_PAYLOAD_SCHEMA, alias='schema')`
- `request_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `input_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `product_id: str = Field(pattern='^[1-9][0-9]{0,30}$')`
- `publication_ids: tuple[str, ...] = Field(min_length=1, max_length=50)`
- `publication_completed_at: str`
- `expected_title: str = Field(min_length=1, max_length=255)`
- `expected_price: str = Field(pattern='^(?:0|[1-9][0-9]{0,11})\\.[0-9]{2}$')`
- `expected_currency: str = Field(pattern='^[A-Z]{3}$')`
- `landing_url: str = Field(min_length=8, max_length=2000)`
- `admin_status: str = Field(min_length=1, max_length=40)`
- `admin_title: str = Field(min_length=1, max_length=255)`
- `title_matches: bool`
- `online_store_url: str = Field(min_length=8, max_length=2000)`
- `variant_id: str = Field(pattern='^[1-9][0-9]{0,30}$')`
- `variant_price: str = Field(pattern='^(?:0|[1-9][0-9]{0,11})\\.[0-9]{2}$')`
- `currency: str = Field(pattern='^[A-Z]{3}$')`
- `available_for_sale: bool`
- `publication_statuses: dict[str, bool]`
- `published_on_all_requested_publications: bool`
- `landing_url_matches_admin: bool`
- `landing_http_status: int = Field(ge=0, le=599)`
- `landing_body_sha256: str = Field(pattern='^[0-9a-f]{64}$')`
- `landing_title_present: bool`
- `landing_price_present: bool`
- `landing_currency_present: bool`
- `landing_variant_present: bool`
- `add_to_cart_form_present: bool`
- `cart_http_status: int = Field(ge=0, le=599)`
- `cart_readable: bool`
- `ready: bool`
- `verified_at: str`

### `lightbulb.gtm_shopify_launch.LandingReadinessVerifier`

class. Source: `lightbulb/gtm_shopify_launch.py:374`.

Trusted host seam that performs live, read-only storefront verification.

#### Methods

##### `lightbulb.gtm_shopify_launch.LandingReadinessVerifier.verify`



~~~python
def verify(request: LandingReadinessRequest) -> LandingReadinessObservation
~~~


Source: `lightbulb/gtm_shopify_launch.py:377`.

### `lightbulb.gtm_shopify_launch.ConnectorLandingReadinessVerifier`

class. Source: `lightbulb/gtm_shopify_launch.py:383`.

Turn one exact governed Shopify read into the launch evidence contract.

#### Methods

##### `lightbulb.gtm_shopify_launch.ConnectorLandingReadinessVerifier.verify`



~~~python
def verify(request: LandingReadinessRequest) -> LandingReadinessObservation
~~~


Source: `lightbulb/gtm_shopify_launch.py:423`.

### `lightbulb.gtm_shopify_launch.ShopifyLaunchOperationResult`

class. Source: `lightbulb/gtm_shopify_launch.py:526`.

Fields:
- `schema_id: Literal['lightbulb.shopify_launch_operation_result.v1'] = Field(default=SHOPIFY_LAUNCH_OPERATION_RESULT_SCHEMA, alias='schema')`
- `status: ShopifyLaunchOperationStatus`
- `operation_id: str`
- `operation_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `capability: str`
- `connector_account_ref: str`
- `idempotency_key: str = Field(min_length=1, max_length=240)`
- `connector_status: ConnectorExecutionStatus | None = None`
- `connector_error_kind: ConnectorErrorKind | None = None`
- `connector_error_code: str | None = Field(default=None, max_length=160)`
- `approval_ref: str | None = Field(default=None, max_length=200)`
- `approval_receipt_digest: str | None = Field(default=None, pattern='^[0-9a-f]{64}$')`
- `execution_receipt_digest: str | None = Field(default=None, pattern='^[0-9a-f]{64}$')`
- `product_id: str | None = Field(default=None, max_length=512)`
- `product_status: Literal['DRAFT', 'ACTIVE'] | None = None`
- `publication_ids: tuple[str, ...] = Field(default_factory=tuple, max_length=50)`
- `receipt: ProductLaunchReceipt | None = None`
- `live_systems_changed: bool | None = False`
- `summary: str = Field(min_length=1, max_length=1000)`

### `lightbulb.gtm_shopify_launch.ShopifyLaunchRunResult`

class. Source: `lightbulb/gtm_shopify_launch.py:599`.

Bounded storefront result; this is not omnichannel completion.

Fields:
- `schema_id: Literal['lightbulb.shopify_launch_run_result.v1'] = Field(default=SHOPIFY_LAUNCH_RUN_RESULT_SCHEMA, alias='schema')`
- `status: ShopifyLaunchStatus`
- `launch_ref: str`
- `plan_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `run_ref: str`
- `iteration: int = Field(ge=1, le=4)`
- `operation_results: tuple[ShopifyLaunchOperationResult, ...] = Field(max_length=4)`
- `receipts: tuple[ProductLaunchReceipt, ...] = Field(max_length=4)`
- `product_id: str | None = None`
- `product_status: Literal['DRAFT', 'ACTIVE'] | None = None`
- `publication_ids: tuple[str, ...] = Field(default_factory=tuple, max_length=50)`
- `next_operation_id: str | None = None`
- `storefront_ready: bool = False`
- `downstream_release_ready: bool = False`
- `eligible_downstream_operation_ids: tuple[str, ...] = Field(default_factory=tuple, max_length=4)`
- `held_downstream_operation_ids: tuple[str, ...] = Field(default_factory=tuple, max_length=4)`
- `omnichannel_launch_completed: Literal[False] = False`
- `summary: str = Field(min_length=1, max_length=1000)`

#### Methods

##### `lightbulb.gtm_shopify_launch.ShopifyLaunchRunResult.to_dict`



~~~python
def to_dict() -> dict[str, Any]
~~~


Source: `lightbulb/gtm_shopify_launch.py:674`.

### `lightbulb.gtm_shopify_launch.run_shopify_product_launch`

function. Source: `lightbulb/gtm_shopify_launch.py:1481`.



~~~python
run_shopify_product_launch(plan_value: OmnichannelProductLaunchPlan | Mapping[str, Any], *, scope: DynamicWorkflowScope | Mapping[str, Any], scope_keyring: ExactScopeDigestProvider, execution_scope: ExecutionScope | Mapping[str, Any], executor: ConnectorExecutor, run_ref: str, iteration: int=1, preview_only: bool=True, approval_grants: Iterable[ProductLaunchApprovalGrant | Mapping[str, Any]]=(), readiness_verifier: LandingReadinessVerifier | None=None) -> ShopifyLaunchRunResult
~~~


Run or resume DRAFT → ACTIVE → publish → live-readiness.

## Module `lightbulb.investment`

Governed SDK facade for Lightbulb investment and trading workflows.

### `lightbulb.investment.InvestmentAction`

class. Source: `lightbulb/investment.py:21`.

Registered finance actions that make up the investment agent system.

### `lightbulb.investment.InvestmentEffect`

class. Source: `lightbulb/investment.py:46`.

External effects acknowledged by the SDK caller, never authorized by it.

### `lightbulb.investment.InvestmentEffectIntent`

class. Source: `lightbulb/investment.py:56`.

Explicit caller intent for effect-capable investment requests.

Fields:
- `provider_spend: bool = False`
- `model_promotion: bool = False`
- `broker_execution: bool = False`
- `cash_movement: bool = False`

#### Methods

##### `lightbulb.investment.InvestmentEffectIntent.permits`



~~~python
def permits(effect: InvestmentEffect) -> bool
~~~


Source: `lightbulb/investment.py:78`.

### `lightbulb.investment.InvestmentSafetyError`

class. Source: `lightbulb/investment.py:82`.

Raised before an effect-capable request leaves the SDK process.

### `lightbulb.investment.InvestmentAgentClient`

class. Source: `lightbulb/investment.py:216`.

Synchronous facade over the authenticated finance domain dispatcher.

Fields:
- `inner: 'LightbulbClient'`

#### Methods

##### `lightbulb.investment.InvestmentAgentClient.alpha_discovery`



~~~python
def alpha_discovery(inputs: Mapping[str, Any], **kwargs: Any) -> 'DispatchResult'
~~~


Source: `lightbulb/investment.py:242`.

##### `lightbulb.investment.InvestmentAgentClient.broker_account_snapshot`



~~~python
def broker_account_snapshot(inputs: Mapping[str, Any], **kwargs: Any) -> 'DispatchResult'
~~~


Source: `lightbulb/investment.py:275`.

##### `lightbulb.investment.InvestmentAgentClient.broker_readiness`



~~~python
def broker_readiness(inputs: Mapping[str, Any], **kwargs: Any) -> 'DispatchResult'
~~~


Source: `lightbulb/investment.py:272`.

##### `lightbulb.investment.InvestmentAgentClient.capital_compute_portfolio`



~~~python
def capital_compute_portfolio(inputs: Mapping[str, Any], **kwargs: Any) -> 'DispatchResult'
~~~


Source: `lightbulb/investment.py:257`.

##### `lightbulb.investment.InvestmentAgentClient.dispatch`



~~~python
def dispatch(action: InvestmentAction | str, *, inputs: Mapping[str, Any] | None=None, message: str='', company_id: str | None=None, effect_intent: InvestmentEffectIntent | None=None) -> 'DispatchResult'
~~~


Source: `lightbulb/investment.py:221`.

##### `lightbulb.investment.InvestmentAgentClient.feature_engineering`



~~~python
def feature_engineering(inputs: Mapping[str, Any], **kwargs: Any) -> 'DispatchResult'
~~~


Source: `lightbulb/investment.py:239`.

##### `lightbulb.investment.InvestmentAgentClient.market_data_snapshot`



~~~python
def market_data_snapshot(inputs: Mapping[str, Any], **kwargs: Any) -> 'DispatchResult'
~~~


Source: `lightbulb/investment.py:280`.

##### `lightbulb.investment.InvestmentAgentClient.paper_trade_runbook`



~~~python
def paper_trade_runbook(inputs: Mapping[str, Any], *, effect_intent: InvestmentEffectIntent, **kwargs: Any) -> 'DispatchResult'
~~~


Source: `lightbulb/investment.py:294`.

##### `lightbulb.investment.InvestmentAgentClient.plan_alpha_training`



~~~python
def plan_alpha_training(inputs: Mapping[str, Any] | None=None, **kwargs: Any) -> 'DispatchResult'
~~~


Source: `lightbulb/investment.py:248`.

##### `lightbulb.investment.InvestmentAgentClient.portfolio_backtest`



~~~python
def portfolio_backtest(inputs: Mapping[str, Any], **kwargs: Any) -> 'DispatchResult'
~~~


Source: `lightbulb/investment.py:245`.

##### `lightbulb.investment.InvestmentAgentClient.stage_cash_movement`



~~~python
def stage_cash_movement(inputs: Mapping[str, Any], **kwargs: Any) -> 'DispatchResult'
~~~


Source: `lightbulb/investment.py:285`.

##### `lightbulb.investment.InvestmentAgentClient.trader_orchestration`



~~~python
def trader_orchestration(inputs: Mapping[str, Any], **kwargs: Any) -> 'DispatchResult'
~~~


Source: `lightbulb/investment.py:262`.

##### `lightbulb.investment.InvestmentAgentClient.trading_system_canary`



~~~python
def trading_system_canary(inputs: Mapping[str, Any] | None=None, **kwargs: Any) -> 'DispatchResult'
~~~


Source: `lightbulb/investment.py:267`.

### `lightbulb.investment.AsyncInvestmentAgentClient`

class. Source: `lightbulb/investment.py:310`.

Native-async facade over the authenticated finance domain dispatcher.

Fields:
- `inner: 'AsyncLightbulbClient'`

#### Methods

##### `lightbulb.investment.AsyncInvestmentAgentClient.alpha_discovery`



~~~python
async def alpha_discovery(inputs: Mapping[str, Any], **kwargs: Any) -> 'DispatchResult'
~~~


Source: `lightbulb/investment.py:336`.

##### `lightbulb.investment.AsyncInvestmentAgentClient.broker_account_snapshot`



~~~python
async def broker_account_snapshot(inputs: Mapping[str, Any], **kwargs: Any) -> 'DispatchResult'
~~~


Source: `lightbulb/investment.py:369`.

##### `lightbulb.investment.AsyncInvestmentAgentClient.broker_readiness`



~~~python
async def broker_readiness(inputs: Mapping[str, Any], **kwargs: Any) -> 'DispatchResult'
~~~


Source: `lightbulb/investment.py:366`.

##### `lightbulb.investment.AsyncInvestmentAgentClient.capital_compute_portfolio`



~~~python
async def capital_compute_portfolio(inputs: Mapping[str, Any], **kwargs: Any) -> 'DispatchResult'
~~~


Source: `lightbulb/investment.py:351`.

##### `lightbulb.investment.AsyncInvestmentAgentClient.dispatch`



~~~python
async def dispatch(action: InvestmentAction | str, *, inputs: Mapping[str, Any] | None=None, message: str='', company_id: str | None=None, effect_intent: InvestmentEffectIntent | None=None) -> 'DispatchResult'
~~~


Source: `lightbulb/investment.py:315`.

##### `lightbulb.investment.AsyncInvestmentAgentClient.feature_engineering`



~~~python
async def feature_engineering(inputs: Mapping[str, Any], **kwargs: Any) -> 'DispatchResult'
~~~


Source: `lightbulb/investment.py:333`.

##### `lightbulb.investment.AsyncInvestmentAgentClient.market_data_snapshot`



~~~python
async def market_data_snapshot(inputs: Mapping[str, Any], **kwargs: Any) -> 'DispatchResult'
~~~


Source: `lightbulb/investment.py:374`.

##### `lightbulb.investment.AsyncInvestmentAgentClient.paper_trade_runbook`



~~~python
async def paper_trade_runbook(inputs: Mapping[str, Any], *, effect_intent: InvestmentEffectIntent, **kwargs: Any) -> 'DispatchResult'
~~~


Source: `lightbulb/investment.py:388`.

##### `lightbulb.investment.AsyncInvestmentAgentClient.plan_alpha_training`



~~~python
async def plan_alpha_training(inputs: Mapping[str, Any] | None=None, **kwargs: Any) -> 'DispatchResult'
~~~


Source: `lightbulb/investment.py:342`.

##### `lightbulb.investment.AsyncInvestmentAgentClient.portfolio_backtest`



~~~python
async def portfolio_backtest(inputs: Mapping[str, Any], **kwargs: Any) -> 'DispatchResult'
~~~


Source: `lightbulb/investment.py:339`.

##### `lightbulb.investment.AsyncInvestmentAgentClient.stage_cash_movement`



~~~python
async def stage_cash_movement(inputs: Mapping[str, Any], **kwargs: Any) -> 'DispatchResult'
~~~


Source: `lightbulb/investment.py:379`.

##### `lightbulb.investment.AsyncInvestmentAgentClient.trader_orchestration`



~~~python
async def trader_orchestration(inputs: Mapping[str, Any], **kwargs: Any) -> 'DispatchResult'
~~~


Source: `lightbulb/investment.py:356`.

##### `lightbulb.investment.AsyncInvestmentAgentClient.trading_system_canary`



~~~python
async def trading_system_canary(inputs: Mapping[str, Any] | None=None, **kwargs: Any) -> 'DispatchResult'
~~~


Source: `lightbulb/investment.py:361`.

## Module `lightbulb.learning_primitives`

Executable learning primitives for governed Lightbulb optimization workflows.

### `lightbulb.learning_primitives.LearningDataProfile`

class. Source: `lightbulb/learning_primitives.py:88`.

Bounded scale signals used for local runtime selection.

Fields:
- `row_count: int = Field(default=0, ge=0, le=10000000000000)`
- `feature_count: int = Field(default=0, ge=0, le=10000000)`
- `events_per_second: int = Field(default=0, ge=0, le=10000000000)`
- `streaming: bool = False`
- `event_time_available: bool = True`

### `lightbulb.learning_primitives.OptimizationSweepBudget`

class. Source: `lightbulb/learning_primitives.py:100`.

One total budget that the planner divides across selected runtimes.

Fields:
- `max_platform_cost_usd: Decimal = Field(default=Decimal('5.000000'), ge=0, le=1000000)`
- `max_provider_cost_usd: Decimal = Field(default=Decimal('0.000000'), ge=0, le=1000000)`
- `max_gpu_seconds: int = Field(default=3600, ge=0, le=31536000)`
- `max_tokens: int = Field(default=100000, ge=0, le=1000000000000)`
- `max_steps: int = Field(default=10000, ge=1, le=1000000000000)`
- `max_attempts: int = Field(default=3, ge=1, le=10)`
- `lease_seconds: int = Field(default=300, ge=60, le=7200)`

### `lightbulb.learning_primitives.PlanOptimizationSweepInput`

class. Source: `lightbulb/learning_primitives.py:135`.

Business-level inputs; scope and credentials are intentionally absent.

Fields:
- `training_pack_receipt_id: UUID`
- `optimization_objective: str = Field(min_length=1, max_length=2000)`
- `primary_metric: str = Field(min_length=1, max_length=128, pattern='^[A-Za-z][A-Za-z0-9_.-]{0,127}$')`
- `direction: MetricDirection = 'maximize'`
- `target: OptimizationTarget = 'predictive_model'`
- `data_profile: LearningDataProfile = Field(default_factory=LearningDataProfile)`
- `feature_backend: FeatureBackend = 'auto'`
- `include_auto_research: bool = False`
- `include_feature_engineering: bool = True`
- `minimum_improvement: Decimal = Field(default=Decimal('0.010000'), gt=0, le=1)`
- `budget: OptimizationSweepBudget = Field(default_factory=OptimizationSweepBudget)`

### `lightbulb.learning_primitives.LearningRunPreparationPlan`

class. Source: `lightbulb/learning_primitives.py:245`.

Exact arguments for ``prepare_project_learning_run`` minus authority.

Fields:
- `training_pack_receipt_id: UUID`
- `primary_metric: str = Field(min_length=1, max_length=128, pattern='^[A-Za-z][A-Za-z0-9_.-]{0,127}$')`
- `runtime: LearningRuntime`
- `direction: MetricDirection`
- `minimum_improvement: str`
- `max_cost_usd: str`
- `max_platform_cost_usd: str`
- `max_gpu_seconds: int = Field(ge=0, le=31536000)`
- `max_tokens: int = Field(ge=0, le=1000000000000)`
- `max_steps: int = Field(ge=1, le=1000000000000)`
- `max_attempts: int = Field(ge=1, le=10)`
- `lease_seconds: int = Field(ge=60, le=7200)`
- `preemptible: bool`

### `lightbulb.learning_primitives.OptimizationSweepStage`

class. Source: `lightbulb/learning_primitives.py:311`.

One independently prepared and admitted Project learning run.

Fields:
- `stage_id: str`
- `ordinal: int = Field(ge=1, le=10)`
- `capability: str`
- `runtime: LearningRuntime`
- `depends_on: list[str] = Field(default_factory=list)`
- `rationale: str`
- `preparation: LearningRunPreparationPlan`
- `capacity_runtime: Literal['automl', 'spark', 'prime', 'puffer']`
- `billable: bool`
- `provider_account_binding_required: bool`
- `operator_approval_required: bool`
- `preparation_confirmation_required: bool = True`
- `admission_confirmation_required: bool = True`
- `emits: list[str] = Field(default_factory=list)`

### `lightbulb.learning_primitives.LearningEventStreamContract`

class. Source: `lightbulb/learning_primitives.py:332`.

Spring receipt snapshot contract; it does not claim a Kafka stream.

Fields:
- `schema_id: str = Field(default=LEARNING_EVENT_STREAM_CONTRACT_SCHEMA, alias='schema')`
- `source_runtime: Literal['spring_project_learning_run_service'] = 'spring_project_learning_run_service'`
- `transport: Literal['control_plane_event_ledger'] = 'control_plane_event_ledger'`
- `kafka_projection_status: Literal['not_bound_by_this_planner'] = 'not_bound_by_this_planner'`
- `delivery_semantics: Literal['bounded_latest_receipt_snapshot'] = 'bounded_latest_receipt_snapshot'`
- `ordering: Literal['not_exposed_as_stream_order'] = 'not_exposed_as_stream_order'`
- `deduplication: Literal['spring_tenant_scoped_idempotency_key'] = 'spring_tenant_scoped_idempotency_key'`
- `cursor_available: Literal[False] = False`
- `complete_history_available: Literal[False] = False`
- `credentials_in_event_payload_allowed: bool = False`
- `events: list[str]`

### `lightbulb.learning_primitives.OptimizationSweepResourceTotals`

class. Source: `lightbulb/learning_primitives.py:365`.

Auditable totals for one multi-runtime sweep.

Fields:
- `platform_cost_usd: str`
- `provider_cost_usd: str`
- `gpu_seconds: int = Field(ge=0)`
- `tokens: int = Field(ge=0)`
- `steps: int = Field(ge=0)`

### `lightbulb.learning_primitives.OptimizationSweepBudgetLedger`

class. Source: `lightbulb/learning_primitives.py:392`.

Requested, allocated, and deliberately unused resource caps.

Fields:
- `requested: OptimizationSweepResourceTotals`
- `allocated: OptimizationSweepResourceTotals`
- `unallocated: OptimizationSweepResourceTotals`

### `lightbulb.learning_primitives.OptimizationSweepSafety`

class. Source: `lightbulb/learning_primitives.py:402`.

Typed authority boundary for a locally compiled plan.

Fields:
- `scope_verification: Literal['deferred_to_spring_prepare_and_admission'] = 'deferred_to_spring_prepare_and_admission'`
- `training_pack_receipt_ownership_verified: bool = False`
- `rbac_verified: bool = False`
- `required_server_permissions: list[str] = Field(default_factory=lambda: ['automl.experiments.execute', 'learning.runs.execute'])`
- `caller_supplied_tenant_or_company_scope_allowed: bool = False`
- `credentials_or_provider_secrets_accepted: bool = False`
- `dataset_publication_authorized: bool = False`
- `capacity_or_commercial_admission_authorized: bool = False`
- `training_execution_authorized: bool = False`
- `model_or_policy_promotion_authorized: bool = False`
- `production_action_authorized: bool = False`
- `each_stage_requires_fresh_server_validation: bool = True`

### `lightbulb.learning_primitives.OptimizationSweepOutput`

class. Source: `lightbulb/learning_primitives.py:428`.

Deterministic plan that grants no execution or promotion authority.

Fields:
- `schema_id: str = Field(default=OPTIMIZATION_SWEEP_PLAN_SCHEMA, alias='schema')`
- `plan_digest: str`
- `objective: str`
- `training_pack_receipt_id: UUID`
- `primary_metric: str`
- `direction: MetricDirection`
- `target: OptimizationTarget`
- `feature_engineering_mode: Literal['spark_feature_matrix', 'automl_in_process', 'training_pack_features', 'not_requested']`
- `stages: list[OptimizationSweepStage]`
- `budget_ledger: OptimizationSweepBudgetLedger`
- `event_stream: LearningEventStreamContract`
- `next_actions: list[str]`
- `safety: OptimizationSweepSafety`

### `lightbulb.learning_primitives.compile_optimization_sweep`

function. Source: `lightbulb/learning_primitives.py:566`.



~~~python
compile_optimization_sweep(inputs: PlanOptimizationSweepInput | Dict[str, Any]) -> OptimizationSweepOutput
~~~


Compile a deterministic, non-authorizing multi-runtime learning plan.

### `lightbulb.learning_primitives.PlanOptimizationSweepPrimitive`

class. Source: `lightbulb/learning_primitives.py:727`.

Choose and budget existing learning runtimes without starting them.

## Module `lightbulb.maintenance_work_order_lifecycle`

Bounded, immutable maintenance work-order transition proposals.

### `lightbulb.maintenance_work_order_lifecycle.MaintenanceWorkOrderError`

class. Source: `lightbulb/maintenance_work_order_lifecycle.py:84`.

Stable, fail-closed lifecycle error used by the primitive wrapper.

### `lightbulb.maintenance_work_order_lifecycle.MaintenanceWorkOrderScope`

class. Source: `lightbulb/maintenance_work_order_lifecycle.py:274`.

Fields:
- `schema_id: Literal['lightbulb.maintenance_work_order_scope.v1'] = Field(default=MAINTENANCE_SCOPE_SCHEMA, alias='schema')`
- `tenant_ref: str = Field(min_length=1, max_length=160)`
- `company_ref: str = Field(min_length=1, max_length=160)`
- `project_ref: str = Field(min_length=1, max_length=160)`
- `project_id: UUID`
- `site_ref: str = Field(min_length=1, max_length=160)`
- `asset_ref: str = Field(min_length=1, max_length=160)`
- `work_order_ref: str = Field(min_length=1, max_length=160)`
- `asset_system_ref: str = Field(min_length=1, max_length=160)`
- `jurisdiction_ref: str = Field(min_length=1, max_length=80)`
- `retention_policy_ref: str = Field(min_length=1, max_length=160)`
- `evidence_custodian_ref: str = Field(min_length=1, max_length=160)`
- `spring_authority_ref: str = Field(min_length=1, max_length=160)`

### `lightbulb.maintenance_work_order_lifecycle.maintenance_scope_digest`

function. Source: `lightbulb/maintenance_work_order_lifecycle.py:324`.



~~~python
maintenance_scope_digest(scope: MaintenanceWorkOrderScope | Mapping[str, Any]) -> str
~~~


### `lightbulb.maintenance_work_order_lifecycle.MaintenanceEvidence`

class. Source: `lightbulb/maintenance_work_order_lifecycle.py:331`.

Fields:
- `schema_id: Literal['lightbulb.maintenance_work_order_evidence.v1'] = Field(default=MAINTENANCE_EVIDENCE_SCHEMA, alias='schema')`
- `sequence: int = Field(ge=1, le=MAX_MAINTENANCE_TRANSITIONS * MAX_EVIDENCE_PER_TRANSITION)`
- `evidence_ref: str = Field(min_length=1, max_length=200)`
- `kind: str = Field(min_length=1, max_length=80)`
- `issuer_ref: str = Field(min_length=1, max_length=200)`
- `custodian_ref: str = Field(min_length=1, max_length=200)`
- `subject_ref: str = Field(min_length=1, max_length=200)`
- `sha256: str = Field(pattern='^[0-9a-f]{64}$')`
- `observed_at: str`
- `effective_at: str`
- `verification_grade: PrimitiveEvidenceVerificationGrade`
- `classification: PrimitiveEvidenceClassification`
- `retention_policy: str = Field(min_length=1, max_length=160)`
- `jurisdiction: str = Field(min_length=1, max_length=80)`
- `retained_until: str`
- `single_use: Literal[True] = True`
- `causal_revision: int = Field(ge=0, le=MAX_MAINTENANCE_TRANSITIONS)`
- `causal_state_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `predecessor_lineage_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `lineage_digest: str = Field(pattern='^[0-9a-f]{64}$')`

#### Methods

##### `lightbulb.maintenance_work_order_lifecycle.MaintenanceEvidence.portable_ref`



~~~python
def portable_ref() -> PrimitiveEvidenceRef
~~~


Source: `lightbulb/maintenance_work_order_lifecycle.py:409`.

### `lightbulb.maintenance_work_order_lifecycle.maintenance_evidence_lineage_digest`

function. Source: `lightbulb/maintenance_work_order_lifecycle.py:425`.



~~~python
maintenance_evidence_lineage_digest(evidence: MaintenanceEvidence | Mapping[str, Any]) -> str
~~~


### `lightbulb.maintenance_work_order_lifecycle.MaintenanceChecklistItem`

class. Source: `lightbulb/maintenance_work_order_lifecycle.py:436`.

Fields:
- `sequence: int = Field(ge=1, le=MAX_CHECKLIST_ITEMS)`
- `task_ref: str = Field(min_length=1, max_length=160)`
- `instruction_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `required_competency_refs: tuple[str, ...] = Field(min_length=1, max_length=20)`
- `requires_shutdown: bool`
- `requires_loto: bool`

### `lightbulb.maintenance_work_order_lifecycle.PartReservation`

class. Source: `lightbulb/maintenance_work_order_lifecycle.py:466`.

Fields:
- `reservation_ref: str = Field(min_length=1, max_length=160)`
- `part_ref: str = Field(min_length=1, max_length=160)`
- `quantity: Decimal`
- `unit_of_measure: str = Field(min_length=1, max_length=32)`
- `unit_cost: Decimal`
- `extended_cost: Decimal`
- `lot_tracking_required: bool`
- `serial_tracking_required: bool`
- `authorized_lot_refs: tuple[str, ...] = Field(default=(), max_length=100)`
- `authorized_serial_refs: tuple[str, ...] = Field(default=(), max_length=100)`
- `custody_from_ref: str = Field(min_length=1, max_length=160)`

### `lightbulb.maintenance_work_order_lifecycle.LaborReservation`

class. Source: `lightbulb/maintenance_work_order_lifecycle.py:527`.

Fields:
- `reservation_ref: str = Field(min_length=1, max_length=160)`
- `technician_ref: str = Field(min_length=1, max_length=160)`
- `competency_refs: tuple[str, ...] = Field(min_length=1, max_length=20)`
- `planned_minutes: int = Field(gt=0, le=100000)`
- `hourly_rate: Decimal`
- `planned_cost: Decimal`

### `lightbulb.maintenance_work_order_lifecycle.ToolReservation`

class. Source: `lightbulb/maintenance_work_order_lifecycle.py:560`.

Fields:
- `reservation_ref: str = Field(min_length=1, max_length=160)`
- `tool_ref: str = Field(min_length=1, max_length=160)`
- `calibration_due_at: str`

### `lightbulb.maintenance_work_order_lifecycle.ChecklistCompletion`

class. Source: `lightbulb/maintenance_work_order_lifecycle.py:576`.

Fields:
- `sequence: int = Field(ge=1, le=MAX_CHECKLIST_ITEMS)`
- `task_ref: str = Field(min_length=1, max_length=160)`
- `completed_by_ref: str = Field(min_length=1, max_length=160)`
- `completed_at: str`
- `actual_minutes: int = Field(gt=0, le=100000)`
- `status: Literal['completed'] = 'completed'`

### `lightbulb.maintenance_work_order_lifecycle.LaborEntry`

class. Source: `lightbulb/maintenance_work_order_lifecycle.py:595`.

Fields:
- `technician_ref: str = Field(min_length=1, max_length=160)`
- `minutes: int = Field(gt=0, le=100000)`
- `hourly_rate: Decimal`
- `labor_cost: Decimal`

### `lightbulb.maintenance_work_order_lifecycle.PartUsage`

class. Source: `lightbulb/maintenance_work_order_lifecycle.py:618`.

Fields:
- `reservation_ref: str = Field(min_length=1, max_length=160)`
- `part_ref: str = Field(min_length=1, max_length=160)`
- `quantity: Decimal`
- `unit_of_measure: str = Field(min_length=1, max_length=32)`
- `unit_cost: Decimal`
- `extended_cost: Decimal`
- `lot_ref: str | None = Field(default=None, min_length=1, max_length=160)`
- `serial_refs: tuple[str, ...] = Field(default=(), max_length=100)`
- `custody_from_ref: str = Field(min_length=1, max_length=160)`
- `custody_to_ref: str = Field(min_length=1, max_length=160)`
- `issued_at: str`
- `installed_at: str`

### `lightbulb.maintenance_work_order_lifecycle.InspectionTest`

class. Source: `lightbulb/maintenance_work_order_lifecycle.py:678`.

Fields:
- `test_ref: str = Field(min_length=1, max_length=160)`
- `method_ref: str = Field(min_length=1, max_length=160)`
- `measured_value: Decimal`
- `minimum_acceptable: Decimal`
- `maximum_acceptable: Decimal`
- `unit_of_measure: str = Field(min_length=1, max_length=32)`
- `passed: Literal[True] = True`

### `lightbulb.maintenance_work_order_lifecycle.RecordWorkRequestCommand`

class. Source: `lightbulb/maintenance_work_order_lifecycle.py:726`.

Fields:
- `kind: Literal['record_request_and_diagnosis'] = 'record_request_and_diagnosis'`
- `request_ref: str = Field(min_length=1, max_length=160)`
- `requested_by_ref: str = Field(min_length=1, max_length=160)`
- `diagnosed_by_ref: str = Field(min_length=1, max_length=160)`
- `requested_at: str`
- `diagnosed_at: str`
- `symptom_code: str = Field(min_length=1, max_length=80)`
- `failure_mode_ref: str = Field(min_length=1, max_length=160)`
- `affected_component_ref: str = Field(min_length=1, max_length=160)`
- `production_impact: Literal['none', 'degraded', 'stopped', 'safety_critical']`
- `failure_severity: int = Field(ge=1, le=5)`
- `meter_name: str = Field(min_length=1, max_length=80)`
- `meter_reading: Decimal`
- `meter_unit: str = Field(min_length=1, max_length=32)`

### `lightbulb.maintenance_work_order_lifecycle.PlanMaintenanceCommand`

class. Source: `lightbulb/maintenance_work_order_lifecycle.py:773`.

Fields:
- `kind: Literal['plan_work'] = 'plan_work'`
- `plan_ref: str = Field(min_length=1, max_length=160)`
- `planner_ref: str = Field(min_length=1, max_length=160)`
- `planned_at: str`
- `strategy: MaintenanceStrategy`
- `priority: MaintenancePriority`
- `risk_likelihood: int = Field(ge=1, le=5)`
- `risk_severity: int = Field(ge=1, le=5)`
- `risk_detectability: int = Field(ge=1, le=5)`
- `risk_score: int = Field(ge=1, le=125)`
- `hazard_refs: tuple[str, ...] = Field(min_length=1, max_length=20)`
- `loto_required: bool`
- `isolation_point_refs: tuple[str, ...] = Field(default=(), max_length=20)`
- `permit_required: bool`
- `required_permit_refs: tuple[str, ...] = Field(default=(), max_length=20)`
- `required_competency_refs: tuple[str, ...] = Field(min_length=1, max_length=20)`
- `checklist: tuple[MaintenanceChecklistItem, ...] = Field(min_length=1, max_length=MAX_CHECKLIST_ITEMS)`
- `planned_window_start: str`
- `planned_window_end: str`

### `lightbulb.maintenance_work_order_lifecycle.AuthorizeAndScheduleCommand`

class. Source: `lightbulb/maintenance_work_order_lifecycle.py:863`.

Fields:
- `kind: Literal['authorize_and_schedule'] = 'authorize_and_schedule'`
- `authorization_ref: str = Field(min_length=1, max_length=160)`
- `safety_approver_ref: str = Field(min_length=1, max_length=160)`
- `authorized_at: str`
- `approved_plan_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `loto_plan_verified: Literal[True] = True`
- `permit_plan_verified: Literal[True] = True`
- `competency_requirements_verified: Literal[True] = True`
- `risk_controls_approved: Literal[True] = True`
- `schedule_start: str`
- `schedule_end: str`
- `part_reservations: tuple[PartReservation, ...] = Field(default=(), max_length=MAX_RESOURCES)`
- `labor_reservations: tuple[LaborReservation, ...] = Field(min_length=1, max_length=MAX_RESOURCES)`
- `tool_reservations: tuple[ToolReservation, ...] = Field(default=(), max_length=MAX_RESOURCES)`
- `estimated_parts_cost: Decimal`
- `estimated_labor_cost: Decimal`
- `estimated_total_cost: Decimal`

### `lightbulb.maintenance_work_order_lifecycle.RecordMaintenanceExecutionCommand`

class. Source: `lightbulb/maintenance_work_order_lifecycle.py:959`.

Fields:
- `kind: Literal['record_execution'] = 'record_execution'`
- `execution_ref: str = Field(min_length=1, max_length=160)`
- `started_at: str`
- `completed_at: str`
- `checklist_results: tuple[ChecklistCompletion, ...] = Field(min_length=1, max_length=MAX_CHECKLIST_ITEMS)`
- `labor_entries: tuple[LaborEntry, ...] = Field(min_length=1, max_length=MAX_RESOURCES)`
- `parts_used: tuple[PartUsage, ...] = Field(default=(), max_length=MAX_RESOURCES)`
- `meter_name: str = Field(min_length=1, max_length=80)`
- `meter_unit: str = Field(min_length=1, max_length=32)`
- `meter_before: Decimal`
- `meter_after: Decimal`
- `meter_delta: Decimal`
- `actual_labor_cost: Decimal`
- `actual_parts_cost: Decimal`
- `actual_total_cost: Decimal`

### `lightbulb.maintenance_work_order_lifecycle.RecordIndependentInspectionCommand`

class. Source: `lightbulb/maintenance_work_order_lifecycle.py:1035`.

Fields:
- `kind: Literal['record_independent_inspection'] = 'record_independent_inspection'`
- `inspection_ref: str = Field(min_length=1, max_length=160)`
- `inspector_ref: str = Field(min_length=1, max_length=160)`
- `inspected_at: str`
- `execution_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `tests: tuple[InspectionTest, ...] = Field(min_length=1, max_length=50)`
- `checklist_complete_verified: Literal[True] = True`
- `no_unresolved_safety_condition: Literal[True] = True`
- `open_deficiency_refs: tuple[()] = ()`

### `lightbulb.maintenance_work_order_lifecycle.ProposeReturnToServiceCommand`

class. Source: `lightbulb/maintenance_work_order_lifecycle.py:1067`.

Fields:
- `kind: Literal['propose_return_to_service'] = 'propose_return_to_service'`
- `authorization_ref: str = Field(min_length=1, max_length=160)`
- `authorized_by_ref: str = Field(min_length=1, max_length=160)`
- `authorized_at: str`
- `inspection_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `safe_to_return_to_service: Literal[True] = True`
- `loto_release_reviewed: Literal[True] = True`
- `permit_closeout_reviewed: Literal[True] = True`
- `open_deficiency_refs: tuple[()] = ()`
- `operating_condition_refs: tuple[str, ...] = Field(min_length=1, max_length=20)`

### `lightbulb.maintenance_work_order_lifecycle.ProposeMaintenanceCloseCommand`

class. Source: `lightbulb/maintenance_work_order_lifecycle.py:1105`.

Fields:
- `kind: Literal['propose_close'] = 'propose_close'`
- `close_ref: str = Field(min_length=1, max_length=160)`
- `closed_by_ref: str = Field(min_length=1, max_length=160)`
- `closed_at: str`
- `return_authorization_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `failure_code: str = Field(min_length=1, max_length=80)`
- `root_cause_code: str = Field(min_length=1, max_length=80)`
- `actual_labor_cost: Decimal`
- `actual_parts_cost: Decimal`
- `actual_total_cost: Decimal`
- `effectiveness_status: Literal['verified', 'review_scheduled']`
- `effectiveness_at: str`
- `effectiveness_evidence_ref: str = Field(min_length=1, max_length=160)`
- `next_maintenance_due_at: str`
- `next_maintenance_meter: Decimal`

### `lightbulb.maintenance_work_order_lifecycle.maintenance_command_digest`

function. Source: `lightbulb/maintenance_work_order_lifecycle.py:1178`.



~~~python
maintenance_command_digest(command: MaintenanceCommand | Mapping[str, Any]) -> str
~~~


### `lightbulb.maintenance_work_order_lifecycle.MaintenanceTransitionRecord`

class. Source: `lightbulb/maintenance_work_order_lifecycle.py:1271`.

Fields:
- `schema_id: Literal['lightbulb.maintenance_work_order_transition.v1'] = Field(default=MAINTENANCE_TRANSITION_SCHEMA, alias='schema')`
- `revision: int = Field(ge=1, le=MAX_MAINTENANCE_TRANSITIONS)`
- `scope_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `lifecycle_ref: str = Field(min_length=1, max_length=160)`
- `prior_state: MaintenanceState | None = None`
- `prior_state_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `prior_evidence_lineage_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `state: MaintenanceState`
- `transition_ref: str = Field(min_length=1, max_length=160)`
- `idempotency_key: str = Field(min_length=8, max_length=200)`
- `idempotency_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `requested_by_ref: str = Field(min_length=1, max_length=160)`
- `proposed_at: str`
- `command: MaintenanceCommand`
- `command_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `content_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `evidence: tuple[MaintenanceEvidence, ...] = Field(min_length=2, max_length=MAX_EVIDENCE_PER_TRANSITION)`
- `evidence_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `evidence_lineage_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `authoritative_scope_verified: Literal[False] = False`
- `authoritative_approval_recorded: Literal[False] = False`
- `work_order_persisted: Literal[False] = False`
- `live_effect_executed: Literal[False] = False`
- `transition_digest: str = Field(pattern='^[0-9a-f]{64}$')`

### `lightbulb.maintenance_work_order_lifecycle.maintenance_snapshot_digest`

function. Source: `lightbulb/maintenance_work_order_lifecycle.py:1386`.



~~~python
maintenance_snapshot_digest(snapshot: 'MaintenanceWorkOrderSnapshot' | Mapping[str, Any]) -> str
~~~


### `lightbulb.maintenance_work_order_lifecycle.MaintenanceWorkOrderSnapshot`

class. Source: `lightbulb/maintenance_work_order_lifecycle.py:1397`.

Fields:
- `schema_id: Literal['lightbulb.maintenance_work_order_snapshot.v1'] = Field(default=MAINTENANCE_SNAPSHOT_SCHEMA, alias='schema')`
- `scope: MaintenanceWorkOrderScope`
- `scope_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `lifecycle_ref: str = Field(min_length=1, max_length=160)`
- `revision: int = Field(ge=1, le=MAX_MAINTENANCE_TRANSITIONS)`
- `state: MaintenanceState`
- `history: tuple[MaintenanceTransitionRecord, ...] = Field(min_length=1, max_length=MAX_MAINTENANCE_TRANSITIONS)`
- `evidence_lineage_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `state_digest: str = Field(pattern='^[0-9a-f]{64}$')`

### `lightbulb.maintenance_work_order_lifecycle.maintenance_idempotency_digest`

function. Source: `lightbulb/maintenance_work_order_lifecycle.py:1482`.



~~~python
maintenance_idempotency_digest(scope: MaintenanceWorkOrderScope | Mapping[str, Any], lifecycle_ref: str, idempotency_key: str) -> str
~~~


### `lightbulb.maintenance_work_order_lifecycle.MaintenanceTransitionRequest`

class. Source: `lightbulb/maintenance_work_order_lifecycle.py:1524`.

Fields:
- `schema_id: Literal['lightbulb.maintenance_work_order_request.v1'] = Field(default=MAINTENANCE_REQUEST_SCHEMA, alias='schema')`
- `scope: MaintenanceWorkOrderScope`
- `scope_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `lifecycle_ref: str = Field(min_length=1, max_length=160)`
- `expected_revision: int = Field(ge=0, le=MAX_MAINTENANCE_TRANSITIONS)`
- `expected_state: MaintenanceState | None = None`
- `expected_state_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `expected_evidence_lineage_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `expected_snapshot: MaintenanceWorkOrderSnapshot | None = None`
- `transition_ref: str = Field(min_length=1, max_length=160)`
- `idempotency_key: str = Field(min_length=8, max_length=200)`
- `idempotency_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `requested_by_ref: str = Field(min_length=1, max_length=160)`
- `proposed_at: str`
- `command: MaintenanceCommand`
- `command_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `content_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `evidence: tuple[MaintenanceEvidence, ...] = Field(min_length=2, max_length=MAX_EVIDENCE_PER_TRANSITION)`

### `lightbulb.maintenance_work_order_lifecycle.maintenance_transition_content_digest`

function. Source: `lightbulb/maintenance_work_order_lifecycle.py:1621`.



~~~python
maintenance_transition_content_digest(request: MaintenanceTransitionRequest | Mapping[str, Any]) -> str
~~~


### `lightbulb.maintenance_work_order_lifecycle.maintenance_fact_evidence_digest`

function. Source: `lightbulb/maintenance_work_order_lifecycle.py:1667`.



~~~python
maintenance_fact_evidence_digest(scope: MaintenanceWorkOrderScope | Mapping[str, Any], lifecycle_ref: str, transition_ref: str, command: MaintenanceCommand | Mapping[str, Any]) -> str
~~~


### `lightbulb.maintenance_work_order_lifecycle.maintenance_transition_commitment_digest`

function. Source: `lightbulb/maintenance_work_order_lifecycle.py:1683`.



~~~python
maintenance_transition_commitment_digest(*, content_digest: str, fact_evidence_digest: str) -> str
~~~


### `lightbulb.maintenance_work_order_lifecycle.MaintenanceEffectBoundary`

class. Source: `lightbulb/maintenance_work_order_lifecycle.py:1694`.

Fields:
- `authoritative_scope_verified: Literal[False] = False`
- `rbac_authorized: Literal[False] = False`
- `authoritative_evidence_verified: Literal[False] = False`
- `authoritative_approval_recorded: Literal[False] = False`
- `work_order_persisted: Literal[False] = False`
- `asset_isolated: Literal[False] = False`
- `work_executed: Literal[False] = False`
- `labor_dispatched: Literal[False] = False`
- `inventory_reserved_or_moved: Literal[False] = False`
- `return_to_service_executed: Literal[False] = False`
- `work_order_closed: Literal[False] = False`
- `provider_write_executed: Literal[False] = False`
- `spring_submission_executed: Literal[False] = False`

### `lightbulb.maintenance_work_order_lifecycle.MaintenanceTransitionProposal`

class. Source: `lightbulb/maintenance_work_order_lifecycle.py:1710`.

Fields:
- `schema_id: Literal['lightbulb.maintenance_work_order_proposal.v1'] = Field(default=MAINTENANCE_PROPOSAL_SCHEMA, alias='schema')`
- `scope: MaintenanceWorkOrderScope`
- `lifecycle_ref: str = Field(min_length=1, max_length=160)`
- `source_revision: int = Field(ge=0, lt=MAX_MAINTENANCE_TRANSITIONS)`
- `source_state_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `target_revision: int = Field(ge=1, le=MAX_MAINTENANCE_TRANSITIONS)`
- `target_state: MaintenanceState`
- `transition_ref: str = Field(min_length=1, max_length=160)`
- `command_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `content_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `idempotency_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `transition_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `candidate_state_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `candidate_evidence_lineage_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `effect_boundary: MaintenanceEffectBoundary = Field(default_factory=MaintenanceEffectBoundary)`
- `proposal_digest: str = Field(pattern='^[0-9a-f]{64}$')`

### `lightbulb.maintenance_work_order_lifecycle.MaintenanceTransitionResult`

class. Source: `lightbulb/maintenance_work_order_lifecycle.py:1752`.

Fields:
- `schema_id: Literal['lightbulb.maintenance_work_order_result.v1'] = Field(default=MAINTENANCE_RESULT_SCHEMA, alias='schema')`
- `proposal: MaintenanceTransitionProposal`
- `candidate_snapshot: MaintenanceWorkOrderSnapshot`
- `authority_boundary: Literal['sdk_candidate_only_spring_and_governed_systems_authoritative'] = 'sdk_candidate_only_spring_and_governed_systems_authoritative'`
- `result_digest: str = Field(pattern='^[0-9a-f]{64}$')`

### `lightbulb.maintenance_work_order_lifecycle.propose_maintenance_work_order_transition`

function. Source: `lightbulb/maintenance_work_order_lifecycle.py:2425`.



~~~python
propose_maintenance_work_order_transition(request: MaintenanceTransitionRequest | Mapping[str, Any]) -> MaintenanceTransitionResult
~~~


Validate one exact transition and return an immutable candidate snapshot.

### `lightbulb.maintenance_work_order_lifecycle.ProposeMaintenanceWorkOrderTransitionPrimitive`

class. Source: `lightbulb/maintenance_work_order_lifecycle.py:2782`.

Fields:
- `example_inputs: Mapping[str, Any] = _example_inputs()`

#### Methods

##### `lightbulb.maintenance_work_order_lifecycle.ProposeMaintenanceWorkOrderTransitionPrimitive.implementation_contract`



~~~python
def implementation_contract() -> dict[str, Any]
~~~


Source: `lightbulb/maintenance_work_order_lifecycle.py:2805`.

## Module `lightbulb.manufacturing_controls`

Evidence-bound manufacturing release and completion control evaluation.

### `lightbulb.manufacturing_controls.manufacturing_snapshot_digest`

function. Source: `lightbulb/manufacturing_controls.py:176`.



~~~python
manufacturing_snapshot_digest(snapshot: BaseModel | Mapping[str, Any]) -> str
~~~


Return a stable digest for one normalized manufacturing snapshot.

### `lightbulb.manufacturing_controls.ManufacturingControlPolicy`

class. Source: `lightbulb/manufacturing_controls.py:618`.

Fields:
- `minimum_evidence_grade: PrimitiveEvidenceVerificationGrade = PrimitiveEvidenceVerificationGrade.ATTESTED`
- `max_evidence_age_hours: int = Field(default=168, ge=1, le=8760)`
- `quantity_tolerance: Decimal = Field(default=Decimal('0'), ge=0)`
- `require_incoming_inspection_for_release: bool = False`
- `require_final_inspection_for_completion: bool = True`
- `allow_quality_waiver: bool = False`
- `require_output_traceability: bool = True`
- `require_current_calibration: bool = True`

### `lightbulb.manufacturing_controls.ManufacturingControlInput`

class. Source: `lightbulb/manufacturing_controls.py:636`.

Fields:
- `schema_id: Literal['lightbulb.manufacturing_control_input.v1'] = Field(default=MANUFACTURING_CONTROL_INPUT_SCHEMA, alias='schema')`
- `evaluation_ref: OpaqueRef`
- `target: EvaluationTarget`
- `analysis_as_of: str`
- `bill_of_material: BillOfMaterialSnapshot`
- `routing: ManufacturingRoutingSnapshot`
- `production_order: ProductionOrderSnapshot`
- `material_allocations: tuple[MaterialAllocation, ...] = Field(default_factory=tuple, max_length=10000)`
- `work_centers: tuple[WorkCenterReadiness, ...] = Field(default_factory=tuple, max_length=1000)`
- `execution_records: tuple[WorkExecutionRecord, ...] = Field(default_factory=tuple, max_length=10000)`
- `quality_inspections: tuple[QualityInspection, ...] = Field(default_factory=tuple, max_length=10000)`
- `nonconformances: tuple[NonconformanceRecord, ...] = Field(default_factory=tuple, max_length=10000)`
- `policy: ManufacturingControlPolicy = Field(default_factory=ManufacturingControlPolicy)`

### `lightbulb.manufacturing_controls.ManufacturingEffectBoundary`

class. Source: `lightbulb/manufacturing_controls.py:739`.

Fields:
- `production_order_released: Literal[False] = False`
- `production_order_completed: Literal[False] = False`
- `inventory_mutated: Literal[False] = False`
- `quality_dispositioned: Literal[False] = False`
- `nonconformance_or_capa_closed: Literal[False] = False`
- `maintenance_work_order_changed: Literal[False] = False`
- `trusted_host_authority_required: Literal[True] = True`

### `lightbulb.manufacturing_controls.ManufacturingControlResult`

class. Source: `lightbulb/manufacturing_controls.py:760`.

Fields:
- `schema_id: Literal['lightbulb.manufacturing_control_result.v1'] = Field(default=MANUFACTURING_CONTROL_RESULT_SCHEMA, alias='schema')`
- `evaluation_ref: OpaqueRef`
- `target: EvaluationTarget`
- `analysis_as_of: str`
- `proposed_disposition: Disposition`
- `assurance_grade: PrimitiveEvidenceVerificationGrade`
- `gates: tuple[ManufacturingGateResult, ...]`
- `findings: tuple[ManufacturingFinding, ...]`
- `component_coverage: tuple[ComponentCoverage, ...]`
- `source_snapshot_digests: dict[str, str]`
- `evidence_refs: tuple[OpaqueRef, ...]`
- `effect_boundary: ManufacturingEffectBoundary = Field(default_factory=ManufacturingEffectBoundary)`
- `result_digest: str = Field(default=_ZERO_DIGEST, pattern='^[0-9a-f]{64}$')`

### `lightbulb.manufacturing_controls.evaluate_manufacturing_controls`

function. Source: `lightbulb/manufacturing_controls.py:937`.



~~~python
evaluate_manufacturing_controls(value: ManufacturingControlInput | Mapping[str, Any]) -> ManufacturingControlResult
~~~


Evaluate release/completion controls without performing a physical write.

### `lightbulb.manufacturing_controls.VerifyBomInventoryTraceabilityPrimitive`

class. Source: `lightbulb/manufacturing_controls.py:1604`.

#### Methods

##### `lightbulb.manufacturing_controls.VerifyBomInventoryTraceabilityPrimitive.implementation_contract`



~~~python
def implementation_contract() -> dict[str, Any]
~~~


Source: `lightbulb/manufacturing_controls.py:1698`.

## Module `lightbulb.manufacturing_execution_lifecycle`

Deterministic manufacturing execution lifecycle contracts.

### `lightbulb.manufacturing_execution_lifecycle.released_bom_content_digest`

function. Source: `lightbulb/manufacturing_execution_lifecycle.py:217`.



~~~python
released_bom_content_digest(value: BaseModel | Mapping[str, Any]) -> str
~~~


Commit the exact released BOM content, excluding its evidence envelope.

### `lightbulb.manufacturing_execution_lifecycle.released_routing_content_digest`

function. Source: `lightbulb/manufacturing_execution_lifecycle.py:257`.



~~~python
released_routing_content_digest(value: BaseModel | Mapping[str, Any]) -> str
~~~


Commit the exact released routing content, excluding its evidence envelope.

### `lightbulb.manufacturing_execution_lifecycle.ManufacturingLifecycleScope`

class. Source: `lightbulb/manufacturing_execution_lifecycle.py:319`.

Fields:
- `tenant_ref: OpaqueRef`
- `company_ref: OpaqueRef`
- `project_ref: OpaqueRef`
- `project_id: UuidRef`
- `site_ref: OpaqueRef`

### `lightbulb.manufacturing_execution_lifecycle.manufacturing_scope_digest`

function. Source: `lightbulb/manufacturing_execution_lifecycle.py:327`.



~~~python
manufacturing_scope_digest(scope: ManufacturingLifecycleScope | Mapping[str, Any]) -> str
~~~


Commit exact tenant, company, project UUID, project ref, and site scope.

### `lightbulb.manufacturing_execution_lifecycle.ReleasedBomComponent`

class. Source: `lightbulb/manufacturing_execution_lifecycle.py:340`.

Fields:
- `component_ref: OpaqueRef`
- `item_ref: OpaqueRef`
- `quantity_per_unit: Decimal = Field(gt=0)`
- `unit_of_measure: UnitCode`
- `trace_kind: TraceKind`

### `lightbulb.manufacturing_execution_lifecycle.ReleasedBomSnapshot`

class. Source: `lightbulb/manufacturing_execution_lifecycle.py:361`.

Fields:
- `schema_id: Literal['lightbulb.manufacturing_released_bom.v1'] = Field(default=RELEASED_BOM_SCHEMA, alias='schema')`
- `bom_ref: OpaqueRef`
- `scope_digest: Sha256Digest`
- `product_ref: OpaqueRef`
- `revision: int = Field(ge=1)`
- `status: Literal['released'] = 'released'`
- `output_unit_of_measure: UnitCode`
- `effective_from: str`
- `effective_until: str | None = None`
- `components: tuple[ReleasedBomComponent, ...] = Field(min_length=1, max_length=MAX_BOM_COMPONENTS)`
- `evidence_refs: tuple[PrimitiveEvidenceRef, ...] = Field(min_length=1, max_length=50)`

### `lightbulb.manufacturing_execution_lifecycle.ReleasedRoutingOperation`

class. Source: `lightbulb/manufacturing_execution_lifecycle.py:418`.

Fields:
- `sequence: int = Field(ge=1)`
- `operation_ref: OpaqueRef`
- `work_center_ref: OpaqueRef`
- `work_instruction_ref: OpaqueRef`
- `work_instruction_revision: int = Field(ge=1)`
- `required_certification_refs: tuple[OpaqueRef, ...] = Field(default_factory=tuple, max_length=100)`

### `lightbulb.manufacturing_execution_lifecycle.ReleasedRoutingSnapshot`

class. Source: `lightbulb/manufacturing_execution_lifecycle.py:443`.

Fields:
- `schema_id: Literal['lightbulb.manufacturing_released_routing.v1'] = Field(default=RELEASED_ROUTING_SCHEMA, alias='schema')`
- `routing_ref: OpaqueRef`
- `scope_digest: Sha256Digest`
- `product_ref: OpaqueRef`
- `revision: int = Field(ge=1)`
- `status: Literal['released'] = 'released'`
- `operations: tuple[ReleasedRoutingOperation, ...] = Field(min_length=1, max_length=MAX_ROUTING_OPERATIONS)`
- `evidence_refs: tuple[PrimitiveEvidenceRef, ...] = Field(min_length=1, max_length=50)`

### `lightbulb.manufacturing_execution_lifecycle.ReleasedManufacturingDefinition`

class. Source: `lightbulb/manufacturing_execution_lifecycle.py:488`.

Fields:
- `schema_id: Literal['lightbulb.manufacturing_released_definition.v1'] = Field(default=RELEASED_DEFINITION_SCHEMA, alias='schema')`
- `bill_of_material: ReleasedBomSnapshot`
- `routing: ReleasedRoutingSnapshot`
- `definition_digest: Sha256Digest`

### `lightbulb.manufacturing_execution_lifecycle.build_released_manufacturing_definition`

function. Source: `lightbulb/manufacturing_execution_lifecycle.py:518`.



~~~python
build_released_manufacturing_definition(bill_of_material: ReleasedBomSnapshot | Mapping[str, Any], routing: ReleasedRoutingSnapshot | Mapping[str, Any]) -> ReleasedManufacturingDefinition
~~~


Validate and content-bind one released BOM/routing pair.

### `lightbulb.manufacturing_execution_lifecycle.ProductionOrderPlan`

class. Source: `lightbulb/manufacturing_execution_lifecycle.py:536`.

Fields:
- `production_order_ref: OpaqueRef`
- `product_ref: OpaqueRef`
- `site_ref: OpaqueRef`
- `planned_quantity: Decimal = Field(gt=0)`
- `unit_of_measure: UnitCode`
- `output_trace_kind: TraceKind`
- `definition_digest: Sha256Digest`
- `scheduled_start: str`
- `scheduled_end: str`

### `lightbulb.manufacturing_execution_lifecycle.MaterialInputTrace`

class. Source: `lightbulb/manufacturing_execution_lifecycle.py:570`.

Fields:
- `source_type: Literal['component', 'prior_output']`
- `source_ref: OpaqueRef`
- `item_ref: OpaqueRef`
- `unit_of_measure: UnitCode`
- `trace_kind: TraceKind`
- `trace_ref: OpaqueRef`
- `quantity: Decimal = Field(gt=0)`

### `lightbulb.manufacturing_execution_lifecycle.ProducedTrace`

class. Source: `lightbulb/manufacturing_execution_lifecycle.py:591`.

Fields:
- `item_ref: OpaqueRef`
- `unit_of_measure: UnitCode`
- `trace_kind: TraceKind`
- `trace_ref: OpaqueRef`
- `quantity: Decimal = Field(gt=0)`

### `lightbulb.manufacturing_execution_lifecycle.OperationCompletion`

class. Source: `lightbulb/manufacturing_execution_lifecycle.py:610`.

Fields:
- `operation_ref: OpaqueRef`
- `sequence: int = Field(ge=1)`
- `work_center_ref: OpaqueRef`
- `input_quantity: Decimal = Field(gt=0)`
- `quantity_completed: Decimal = Field(ge=0)`
- `quantity_scrapped: Decimal = Field(ge=0)`
- `operator_ref: OpaqueRef`
- `certification_refs: tuple[OpaqueRef, ...] = Field(default_factory=tuple, max_length=100)`
- `occurred_at: str`
- `input_traces: tuple[MaterialInputTrace, ...] = Field(min_length=1, max_length=MAX_TRACES_PER_OPERATION)`
- `output_traces: tuple[ProducedTrace, ...] = Field(default_factory=tuple, max_length=MAX_TRACES_PER_OPERATION)`
- `evidence_refs: tuple[PrimitiveEvidenceRef, ...] = Field(min_length=1, max_length=50)`
- `transition_request_digest: Sha256Digest`

### `lightbulb.manufacturing_execution_lifecycle.QualityHold`

class. Source: `lightbulb/manufacturing_execution_lifecycle.py:683`.

Fields:
- `hold_ref: OpaqueRef`
- `status: Literal['active', 'released']`
- `trace_refs: tuple[OpaqueRef, ...] = Field(min_length=1, max_length=MAX_TRACES_PER_OPERATION)`
- `reason_code: OpaqueRef`
- `held_by_ref: OpaqueRef`
- `held_at: str`
- `evidence_refs: tuple[PrimitiveEvidenceRef, ...] = Field(min_length=1, max_length=50)`
- `hold_transition_request_digest: Sha256Digest`
- `released_by_ref: OpaqueRef | None = None`
- `released_at: str | None = None`
- `release_approval_ref: OpaqueRef | None = None`
- `release_approval_evidence_ref: OpaqueRef | None = None`
- `release_transition_request_digest: Sha256Digest | None = None`
- `release_evidence_refs: tuple[PrimitiveEvidenceRef, ...] = Field(default_factory=tuple, max_length=50)`

### `lightbulb.manufacturing_execution_lifecycle.Nonconformance`

class. Source: `lightbulb/manufacturing_execution_lifecycle.py:749`.

Fields:
- `nonconformance_ref: OpaqueRef`
- `hold_ref: OpaqueRef`
- `trace_refs: tuple[OpaqueRef, ...] = Field(min_length=1, max_length=MAX_TRACES_PER_OPERATION)`
- `severity: Literal['minor', 'major', 'critical']`
- `description_digest: Sha256Digest`
- `status: Literal['open', 'closed']`
- `opened_by_ref: OpaqueRef`
- `opened_at: str`
- `opening_evidence_refs: tuple[PrimitiveEvidenceRef, ...] = Field(min_length=1, max_length=50)`
- `opening_transition_request_digest: Sha256Digest`
- `closed_by_ref: OpaqueRef | None = None`
- `closed_at: str | None = None`
- `disposition: Literal['use_as_is', 'scrap'] | None = None`
- `concession_ref: OpaqueRef | None = None`
- `concession_evidence_ref: OpaqueRef | None = None`
- `capa_ref: OpaqueRef | None = None`
- `capa_evidence_ref: OpaqueRef | None = None`
- `closure_evidence_ref: OpaqueRef | None = None`
- `closure_transition_request_digest: Sha256Digest | None = None`
- `closure_evidence_refs: tuple[PrimitiveEvidenceRef, ...] = Field(default_factory=tuple, max_length=50)`

### `lightbulb.manufacturing_execution_lifecycle.MaterializedCandidateManufacturingTransition`

class. Source: `lightbulb/manufacturing_execution_lifecycle.py:845`.

Fields:
- `transition_ref: OpaqueRef`
- `actor_ref: OpaqueRef`
- `idempotency_key: OpaqueRef`
- `request_digest: Sha256Digest`
- `command_kind: Literal['create_production_order', 'complete_operation', 'place_quality_hold', 'open_nonconformance', 'close_nonconformance', 'release_quality_hold']`
- `occurred_at: str`
- `from_version: int = Field(ge=0)`
- `to_version: int = Field(ge=1)`
- `expected_snapshot_digest: Sha256Digest`
- `evidence_refs: tuple[PrimitiveEvidenceRef, ...] = Field(min_length=1, max_length=50)`
- `evidence_digest: Sha256Digest`

### `lightbulb.manufacturing_execution_lifecycle.ManufacturingOrderState`

class. Source: `lightbulb/manufacturing_execution_lifecycle.py:913`.

Fields:
- `plan: ProductionOrderPlan`
- `status: OrderStatus`
- `operation_completions: tuple[OperationCompletion, ...] = Field(default_factory=tuple, max_length=MAX_ROUTING_OPERATIONS)`
- `quality_hold: QualityHold | None = None`
- `nonconformances: tuple[Nonconformance, ...] = Field(default_factory=tuple, max_length=MAX_NONCONFORMANCES)`
- `completed_quantity: Decimal = Field(ge=0)`

### `lightbulb.manufacturing_execution_lifecycle.ManufacturingExecutionLifecycleSnapshot`

class. Source: `lightbulb/manufacturing_execution_lifecycle.py:975`.

Fields:
- `schema_id: Literal['lightbulb.manufacturing_execution_lifecycle_snapshot.v2'] = Field(default=MANUFACTURING_LIFECYCLE_SNAPSHOT_SCHEMA, alias='schema')`
- `scope: ManufacturingLifecycleScope`
- `definition: ReleasedManufacturingDefinition`
- `order: ManufacturingOrderState`
- `version: int = Field(ge=1, le=MAX_LIFECYCLE_TRANSITIONS)`
- `transition_history: tuple[MaterializedCandidateManufacturingTransition, ...] = Field(min_length=1, max_length=MAX_LIFECYCLE_TRANSITIONS)`
- `state_digest: Sha256Digest`

### `lightbulb.manufacturing_execution_lifecycle.manufacturing_snapshot_digest`

function. Source: `lightbulb/manufacturing_execution_lifecycle.py:1442`.



~~~python
manufacturing_snapshot_digest(snapshot: ManufacturingExecutionLifecycleSnapshot | Mapping[str, Any], *, validate: bool=True) -> str
~~~


Return the canonical digest excluding the snapshot's digest field.

### `lightbulb.manufacturing_execution_lifecycle.CreateProductionOrderCommand`

class. Source: `lightbulb/manufacturing_execution_lifecycle.py:1502`.

Fields:
- `kind: Literal['create_production_order'] = 'create_production_order'`
- `definition: ReleasedManufacturingDefinition`
- `order_plan: ProductionOrderPlan`

### `lightbulb.manufacturing_execution_lifecycle.CompleteOperationCommand`

class. Source: `lightbulb/manufacturing_execution_lifecycle.py:1527`.

Fields:
- `kind: Literal['complete_operation'] = 'complete_operation'`
- `operation_ref: OpaqueRef`
- `work_center_ref: OpaqueRef`
- `quantity_completed: Decimal = Field(ge=0)`
- `quantity_scrapped: Decimal = Field(ge=0)`
- `operator_ref: OpaqueRef`
- `certification_refs: tuple[OpaqueRef, ...] = Field(default_factory=tuple, max_length=100)`
- `input_traces: tuple[MaterialInputTrace, ...] = Field(min_length=1, max_length=MAX_TRACES_PER_OPERATION)`
- `output_traces: tuple[ProducedTrace, ...] = Field(default_factory=tuple, max_length=MAX_TRACES_PER_OPERATION)`

### `lightbulb.manufacturing_execution_lifecycle.PlaceQualityHoldCommand`

class. Source: `lightbulb/manufacturing_execution_lifecycle.py:1572`.

Fields:
- `kind: Literal['place_quality_hold'] = 'place_quality_hold'`
- `hold_ref: OpaqueRef`
- `trace_refs: tuple[OpaqueRef, ...] = Field(min_length=1, max_length=MAX_TRACES_PER_OPERATION)`
- `reason_code: OpaqueRef`
- `held_by_ref: OpaqueRef`

### `lightbulb.manufacturing_execution_lifecycle.OpenNonconformanceCommand`

class. Source: `lightbulb/manufacturing_execution_lifecycle.py:1595`.

Fields:
- `kind: Literal['open_nonconformance'] = 'open_nonconformance'`
- `nonconformance_ref: OpaqueRef`
- `hold_ref: OpaqueRef`
- `trace_refs: tuple[OpaqueRef, ...] = Field(min_length=1, max_length=MAX_TRACES_PER_OPERATION)`
- `severity: Literal['minor', 'major', 'critical']`
- `description_digest: Sha256Digest`
- `opened_by_ref: OpaqueRef`

### `lightbulb.manufacturing_execution_lifecycle.CloseNonconformanceCommand`

class. Source: `lightbulb/manufacturing_execution_lifecycle.py:1620`.

Fields:
- `kind: Literal['close_nonconformance'] = 'close_nonconformance'`
- `nonconformance_ref: OpaqueRef`
- `closed_by_ref: OpaqueRef`
- `disposition: Literal['use_as_is', 'scrap']`
- `closure_evidence_ref: OpaqueRef`
- `concession_ref: OpaqueRef | None = None`
- `concession_evidence_ref: OpaqueRef | None = None`
- `capa_ref: OpaqueRef | None = None`
- `capa_evidence_ref: OpaqueRef | None = None`

#### Methods

##### `lightbulb.manufacturing_execution_lifecycle.CloseNonconformanceCommand.minimum_evidence_grade`



~~~python
def minimum_evidence_grade() -> PrimitiveEvidenceVerificationGrade
~~~


Source: `lightbulb/manufacturing_execution_lifecycle.py:1631`.

### `lightbulb.manufacturing_execution_lifecycle.ReleaseQualityHoldCommand`

class. Source: `lightbulb/manufacturing_execution_lifecycle.py:1669`.

Fields:
- `kind: Literal['release_quality_hold'] = 'release_quality_hold'`
- `hold_ref: OpaqueRef`
- `released_by_ref: OpaqueRef`
- `approval_ref: OpaqueRef`
- `approval_evidence_ref: OpaqueRef`

#### Methods

##### `lightbulb.manufacturing_execution_lifecycle.ReleaseQualityHoldCommand.minimum_evidence_grade`



~~~python
def minimum_evidence_grade() -> PrimitiveEvidenceVerificationGrade
~~~


Source: `lightbulb/manufacturing_execution_lifecycle.py:1676`.

### `lightbulb.manufacturing_execution_lifecycle.manufacturing_command_digest`

function. Source: `lightbulb/manufacturing_execution_lifecycle.py:1714`.



~~~python
manufacturing_command_digest(command: BaseModel | Mapping[str, Any]) -> str
~~~


Digest all command fields except the self-describing request digest.

### `lightbulb.manufacturing_execution_lifecycle.seal_manufacturing_command`

function. Source: `lightbulb/manufacturing_execution_lifecycle.py:1727`.



~~~python
seal_manufacturing_command(command: Mapping[str, Any]) -> dict[str, Any]
~~~


Normalize, validate, and seal a command with its exact request digest.

### `lightbulb.manufacturing_execution_lifecycle.ManufacturingExecutionLifecycleInput`

class. Source: `lightbulb/manufacturing_execution_lifecycle.py:1746`.

Fields:
- `schema_id: Literal['lightbulb.manufacturing_execution_lifecycle_input.v2'] = Field(default=MANUFACTURING_LIFECYCLE_INPUT_SCHEMA, alias='schema')`
- `scope: ManufacturingLifecycleScope`
- `command: ManufacturingLifecycleCommand`
- `current_snapshot: ManufacturingExecutionLifecycleSnapshot | None = None`

### `lightbulb.manufacturing_execution_lifecycle.ManufacturingTransitionReceipt`

class. Source: `lightbulb/manufacturing_execution_lifecycle.py:1795`.

Fields:
- `schema_id: Literal['lightbulb.manufacturing_execution_transition_receipt.v2'] = Field(default=MANUFACTURING_TRANSITION_RECEIPT_SCHEMA, alias='schema')`
- `transition_ref: OpaqueRef`
- `idempotency_key: OpaqueRef`
- `request_digest: Sha256Digest`
- `command_kind: str = Field(min_length=1, max_length=80)`
- `status: Literal['candidate_materialized', 'rejected']`
- `from_version: int = Field(ge=0)`
- `to_version: int = Field(ge=0)`
- `from_snapshot_digest: Sha256Digest`
- `to_snapshot_digest: Sha256Digest`
- `evidence_digest: Sha256Digest`
- `rejection_code: str | None = Field(default=None, min_length=1, max_length=120)`
- `recovery: ManufacturingTransitionRecovery`
- `replayed: Literal[False] = False`
- `live_systems_changed: Literal[False] = False`
- `authoritative_write_authorized: Literal[False] = False`

### `lightbulb.manufacturing_execution_lifecycle.ManufacturingExecutionLifecycleResult`

class. Source: `lightbulb/manufacturing_execution_lifecycle.py:1848`.

Fields:
- `schema_id: Literal['lightbulb.manufacturing_execution_lifecycle_result.v2'] = Field(default=MANUFACTURING_LIFECYCLE_RESULT_SCHEMA, alias='schema')`
- `candidate_materialized: bool`
- `snapshot: ManufacturingExecutionLifecycleSnapshot | None = None`
- `transition_receipt: ManufacturingTransitionReceipt`
- `live_systems_changed: Literal[False] = False`
- `authoritative_write_authorized: Literal[False] = False`

### `lightbulb.manufacturing_execution_lifecycle.advance_manufacturing_execution_lifecycle`

function. Source: `lightbulb/manufacturing_execution_lifecycle.py:2676`.



~~~python
advance_manufacturing_execution_lifecycle(inputs: ManufacturingExecutionLifecycleInput | Mapping[str, Any]) -> ManufacturingExecutionLifecycleResult
~~~


Materialize one bounded candidate projection without external mutation.

### `lightbulb.manufacturing_execution_lifecycle.AdvanceManufacturingExecutionLifecyclePrimitive`

class. Source: `lightbulb/manufacturing_execution_lifecycle.py:2849`.

Fields:
- `example_inputs: Mapping[str, Any] = _manufacturing_lifecycle_example_inputs()`

#### Methods

##### `lightbulb.manufacturing_execution_lifecycle.AdvanceManufacturingExecutionLifecyclePrimitive.implementation_contract`



~~~python
def implementation_contract() -> dict[str, Any]
~~~


Source: `lightbulb/manufacturing_execution_lifecycle.py:2874`.

## Module `lightbulb.manufacturing_field_quality`

EHS, recall, and field-quality control evaluation for physical operations.

### `lightbulb.manufacturing_field_quality.FieldQualityControlPolicy`

class. Source: `lightbulb/manufacturing_field_quality.py:288`.

Fields:
- `maximum_snapshot_age_hours: int = Field(default=168, ge=1, le=8760)`
- `maximum_emergency_drill_age_hours: int = Field(default=4380, ge=1, le=17520)`
- `minimum_evidence_grade: PrimitiveEvidenceVerificationGrade = PrimitiveEvidenceVerificationGrade.ATTESTED`
- `required_evidence_kinds: tuple[str, ...] = Field(default=_REQUIRED_EVIDENCE_KINDS, min_length=1, max_length=20)`

### `lightbulb.manufacturing_field_quality.FieldQualityControlInput`

class. Source: `lightbulb/manufacturing_field_quality.py:310`.

Fields:
- `schema_id: Literal['lightbulb.field_quality_control_input.v1'] = Field(default=FIELD_QUALITY_CONTROL_INPUT_SCHEMA, alias='schema')`
- `evaluation_ref: OpaqueRef`
- `company_ref: OpaqueRef`
- `product_ref: OpaqueRef`
- `analysis_as_of: str`
- `ehs: EhsProgramSnapshot`
- `field_signals: tuple[FieldQualitySignal, ...] = Field(default_factory=tuple, max_length=100000)`
- `traceability: ProductTraceabilitySnapshot`
- `recall: RecallReadinessSnapshot`
- `policy: FieldQualityControlPolicy = Field(default_factory=FieldQualityControlPolicy)`
- `evidence_refs: tuple[PrimitiveEvidenceRef, ...] = Field(min_length=1, max_length=200)`

### `lightbulb.manufacturing_field_quality.FieldQualityControlResult`

class. Source: `lightbulb/manufacturing_field_quality.py:378`.

Fields:
- `schema_id: Literal['lightbulb.field_quality_control_result.v1'] = Field(default=FIELD_QUALITY_CONTROL_RESULT_SCHEMA, alias='schema')`
- `evaluation_ref: OpaqueRef`
- `company_ref: OpaqueRef`
- `product_ref: OpaqueRef`
- `analysis_as_of: str`
- `disposition: FieldQualityDisposition`
- `findings: tuple[FieldQualityFinding, ...]`
- `passed_count: int = Field(ge=0)`
- `failed_count: int = Field(ge=0)`
- `indeterminate_count: int = Field(ge=0)`
- `safety_or_recall_trigger_refs: tuple[OpaqueRef, ...]`
- `evidence_refs: tuple[PrimitiveEvidenceRef, ...]`
- `input_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `evidence_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `evaluation_digest: str = Field(default=_ZERO_DIGEST, pattern='^[0-9a-f]{64}$')`
- `operation_spec: PrimitiveOperationSpec`
- `work_stoppage_authorized: Literal[False] = False`
- `regulator_report_filed: Literal[False] = False`
- `recall_initiated: Literal[False] = False`
- `customer_notification_sent: Literal[False] = False`
- `inventory_quarantined: Literal[False] = False`
- `capa_closed: Literal[False] = False`

### `lightbulb.manufacturing_field_quality.evaluate_field_quality_controls`

function. Source: `lightbulb/manufacturing_field_quality.py:552`.



~~~python
evaluate_field_quality_controls(inputs: FieldQualityControlInput | dict[str, Any]) -> FieldQualityControlResult
~~~


Evaluate EHS, field-quality, traceability, and recall controls.

### `lightbulb.manufacturing_field_quality.EvaluateFieldQualityControlsPrimitive`

class. Source: `lightbulb/manufacturing_field_quality.py:951`.

#### Methods

##### `lightbulb.manufacturing_field_quality.EvaluateFieldQualityControlsPrimitive.implementation_contract`



~~~python
def implementation_contract() -> dict[str, Any]
~~~


Source: `lightbulb/manufacturing_field_quality.py:972`.

## Module `lightbulb.marketplace`

Normalized discovery contract for Lightbulb actions and workers.

### `lightbulb.marketplace.agent_marketplace_catalog`

function. Source: `lightbulb/marketplace.py:319`.



~~~python
agent_marketplace_catalog(*, business_primitives: Any=(), domain_contracts: Any=(), scoped_domain: str | None=None, scoped_actions: Any=(), query: str | None=None, kinds: str | Iterable[str] | None=None, domain: str | None=None, include_inputs: bool=True, limit: int=50) -> Dict[str, Any]
~~~


Build a bounded, deterministic marketplace discovery catalog.

## Module `lightbulb.observation_runtime`

Durable, scope-bound post-action observation and evaluation runtime.

### `lightbulb.observation_runtime.ObservationJobSpec`

class. Source: `lightbulb/observation_runtime.py:275`.

The complete bounded contract safe to persist in a checkpoint.

Fields:
- `schema_id: Literal['lightbulb.post_action_observation_job.v1'] = Field(default=OBSERVATION_JOB_SCHEMA, alias='schema')`
- `job_ref: str = Field(pattern=_PORTABLE_REF_RE)`
- `kind: Literal['gtm', 'storefront_phase', 'profit']`
- `project_ref: str = Field(min_length=1, max_length=200)`
- `exact_scope_digest: str = Field(pattern=_SHA256_RE)`
- `receipt_key_id: str = Field(min_length=8, max_length=80)`
- `project_id: UUID`
- `plan_digest: str = Field(pattern=_SHA256_RE)`
- `run_ref: str = Field(pattern=_PORTABLE_REF_RE)`
- `iteration: int = Field(ge=1, le=4)`
- `provider: Literal['shopify', 'google_analytics', 'host']`
- `source_capability: str = Field(pattern=_TOOL_RE)`
- `connector_account_ref: str | None = Field(default=None, min_length=1, max_length=200)`
- `subject_account_refs: tuple[str, ...] = Field(default_factory=tuple, max_length=20)`
- `tenant_connector_id: UUID | None = None`
- `expected_tool_version: int = Field(ge=1)`
- `expected_route_digest: str | None = Field(default=None, pattern=_SHA256_RE)`
- `query_digest: str = Field(pattern=_SHA256_RE)`
- `context_digest: str = Field(pattern=_SHA256_RE)`
- `target_metric: str = Field(min_length=1, max_length=80)`
- `target_unit: Literal['money', 'ratio', 'count', 'days', 'multiple']`
- `currency: str | None = Field(default=None, pattern='^[A-Z]{3}$')`
- `latest_action_completed_at: str`
- `window_start: str`
- `window_end: str`
- `due_at: str`
- `minimum_sample_size: int = Field(ge=1, le=1000000000)`
- `max_observation_age_hours: int = Field(ge=1, le=8760)`
- `max_attempts: int = Field(default=3, ge=1, le=10)`
- `job_digest: str = Field(default='0' * 64, pattern=_SHA256_RE)`

### `lightbulb.observation_runtime.NormalizedObservation`

class. Source: `lightbulb/observation_runtime.py:380`.

Fields:
- `metric: str = Field(min_length=1, max_length=80)`
- `unit: Literal['money', 'ratio', 'count', 'days', 'multiple']`
- `value: Decimal`
- `sample_size: int = Field(ge=0, le=10000000000)`
- `currency: str | None = Field(default=None, pattern='^[A-Z]{3}$')`
- `exposure_count: int | None = Field(default=None, ge=1, le=10000000000)`
- `ledger: ProfitContributionLedger | None = None`

### `lightbulb.observation_runtime.ObservationReadReceipt`

class. Source: `lightbulb/observation_runtime.py:407`.

Host-HMAC evidence that one exact governed read produced a metric.

Fields:
- `schema_id: Literal['lightbulb.observation_read_receipt.v1'] = Field(default=OBSERVATION_READ_RECEIPT_SCHEMA, alias='schema')`
- `receipt_ref: str = Field(pattern=_PORTABLE_REF_RE)`
- `job_ref: str = Field(pattern=_PORTABLE_REF_RE)`
- `job_digest: str = Field(pattern=_SHA256_RE)`
- `scope: DynamicWorkflowScope`
- `exact_scope_digest: str = Field(pattern=_SHA256_RE)`
- `project_id: UUID`
- `provider: Literal['shopify', 'google_analytics', 'host']`
- `source_capability: str = Field(pattern=_TOOL_RE)`
- `connector_account_ref: str | None = None`
- `subject_account_refs: tuple[str, ...] = Field(default_factory=tuple)`
- `tenant_connector_id: UUID | None = None`
- `tool_version: int = Field(ge=1)`
- `query_digest: str = Field(pattern=_SHA256_RE)`
- `request_digest: str = Field(pattern=_SHA256_RE)`
- `execution_receipt_digest: str = Field(pattern=_SHA256_RE)`
- `journal_ref: str = Field(min_length=1, max_length=200)`
- `raw_output_digest: str = Field(pattern=_SHA256_RE)`
- `window_start: str`
- `window_end: str`
- `observed_at: str`
- `normalized: NormalizedObservation`
- `receipt_key_id: str = Field(min_length=8, max_length=80)`
- `receipt_hmac: str = Field(pattern=_SHA256_RE)`
- `receipt_digest: str = Field(default='0' * 64, pattern=_SHA256_RE)`

#### Methods

##### `lightbulb.observation_runtime.ObservationReadReceipt.hmac_payload`



~~~python
def hmac_payload() -> dict[str, Any]
~~~


Source: `lightbulb/observation_runtime.py:479`.

### `lightbulb.observation_runtime.ShopifyAnalyticsPayload`

class. Source: `lightbulb/observation_runtime.py:488`.

Fields:
- `schema_id: Literal['lightbulb.shopify_analytics_observation.v1'] = Field(default=SHOPIFY_ANALYTICS_PAYLOAD_SCHEMA, alias='schema')`
- `query_digest: str = Field(pattern=_SHA256_RE)`
- `window_start: str`
- `window_end: str`
- `sample_size: int = Field(ge=0, le=10000000000)`
- `sessions: int | None = Field(default=None, ge=0)`
- `sessions_that_completed_checkout: int | None = Field(default=None, ge=0)`
- `sessions_with_cart_additions: int | None = Field(default=None, ge=0)`
- `sessions_that_reached_checkout: int | None = Field(default=None, ge=0)`
- `orders: int | None = Field(default=None, ge=0)`
- `currency: str | None = Field(default=None, pattern='^[A-Z]{3}$')`
- `total_sales: Decimal | None = None`

### `lightbulb.observation_runtime.GoogleAnalyticsPayload`

class. Source: `lightbulb/observation_runtime.py:519`.

Fields:
- `schema_id: Literal['lightbulb.google_analytics_observation.v1'] = Field(default=GOOGLE_ANALYTICS_PAYLOAD_SCHEMA, alias='schema')`
- `query_digest: str = Field(pattern=_SHA256_RE)`
- `window_start: str`
- `window_end: str`
- `sample_size: int = Field(ge=0, le=10000000000)`
- `sessions: int = Field(ge=0)`
- `conversions: int | None = Field(default=None, ge=0)`
- `impressions: int | None = Field(default=None, ge=0)`
- `clicks: int | None = Field(default=None, ge=0)`
- `add_to_cart_sessions: int | None = Field(default=None, ge=0)`
- `checkout_sessions: int | None = Field(default=None, ge=0)`
- `completed_checkout_sessions: int | None = Field(default=None, ge=0)`

### `lightbulb.observation_runtime.CheckoutRecoverySnapshotPayload`

class. Source: `lightbulb/observation_runtime.py:542`.

Aggregate, privacy-minimised randomized-holdout recovery snapshot.

Fields:
- `schema_id: Literal['lightbulb.checkout_recovery_snapshot.v1'] = Field(default=CHECKOUT_RECOVERY_SNAPSHOT_PAYLOAD_SCHEMA, alias='schema')`
- `query_digest: str = Field(pattern=_SHA256_RE)`
- `exact_scope_digest: str = Field(pattern=_SHA256_RE)`
- `subject_account_refs: tuple[str, ...] = Field(min_length=1, max_length=20)`
- `window_start: str`
- `window_end: str`
- `attribution_method: Literal['randomized_holdout']`
- `sample_size: int = Field(ge=2, le=10000000000)`
- `treatment_sample_size: int = Field(ge=1, le=10000000000)`
- `holdout_sample_size: int = Field(ge=1, le=10000000000)`
- `treatment_contribution_profit: Decimal = Field(ge=-1000000000000, le=1000000000000)`
- `holdout_contribution_profit: Decimal = Field(ge=-1000000000000, le=1000000000000)`
- `incremental_ledger: ProfitContributionLedger`

### `lightbulb.observation_runtime.ObservationNormalizer`

class. Source: `lightbulb/observation_runtime.py:608`.

Fields:
- `tool: str`
- `provider: str`

#### Methods

##### `lightbulb.observation_runtime.ObservationNormalizer.normalize`



~~~python
def normalize(output: Mapping[str, Any], *, spec: ObservationJobSpec) -> NormalizedObservation
~~~


Source: `lightbulb/observation_runtime.py:614`.

##### `lightbulb.observation_runtime.ObservationNormalizer.supports_metric`



~~~python
def supports_metric(metric: str) -> bool
~~~


Source: `lightbulb/observation_runtime.py:612`.

### `lightbulb.observation_runtime.ObservationScopeKeyRing`

class. Source: `lightbulb/observation_runtime.py:619`.

Fields:
- `active_key_id: str`

#### Methods

##### `lightbulb.observation_runtime.ObservationScopeKeyRing.exact_scope_digest`



~~~python
def exact_scope_digest(*, key_id: str, scope: DynamicWorkflowScope) -> str
~~~


Source: `lightbulb/observation_runtime.py:622`.

##### `lightbulb.observation_runtime.ObservationScopeKeyRing.sign`



~~~python
def sign(key_id: str, domain: str, payload: Any) -> bytes
~~~


Source: `lightbulb/observation_runtime.py:626`.

### `lightbulb.observation_runtime.HostObservationReadRequest`

class. Source: `lightbulb/observation_runtime.py:629`.

Exact, idempotent request crossing into a trusted host data reader.

Fields:
- `schema_id: Literal['lightbulb.host_observation_read_request.v1'] = Field(default=HOST_OBSERVATION_READ_REQUEST_SCHEMA, alias='schema')`
- `job_ref: str = Field(pattern=_PORTABLE_REF_RE)`
- `job_digest: str = Field(pattern=_SHA256_RE)`
- `scope: DynamicWorkflowScope`
- `exact_scope_digest: str = Field(pattern=_SHA256_RE)`
- `receipt_key_id: str = Field(min_length=8, max_length=80)`
- `project_id: UUID`
- `source_capability: str = Field(pattern=_TOOL_RE)`
- `tool_version: int = Field(ge=1)`
- `subject_account_refs: tuple[str, ...] = Field(min_length=1, max_length=20)`
- `query_arguments: Dict[str, Any]`
- `query_digest: str = Field(pattern=_SHA256_RE)`
- `target_metric: str = Field(min_length=1, max_length=80)`
- `target_unit: Literal['money', 'ratio', 'count', 'days', 'multiple']`
- `currency: str | None = Field(default=None, pattern='^[A-Z]{3}$')`
- `window_start: str`
- `window_end: str`
- `idempotency_key: str = Field(min_length=1, max_length=200)`
- `request_digest: str = Field(default='0' * 64, pattern=_SHA256_RE)`

### `lightbulb.observation_runtime.HostObservationReadProvenance`

class. Source: `lightbulb/observation_runtime.py:690`.

Scope-HMAC custody receipt returned by the trusted host reader.

Fields:
- `schema_id: Literal['lightbulb.host_observation_provenance.v1'] = Field(default=HOST_OBSERVATION_PROVENANCE_SCHEMA, alias='schema')`
- `reader_ref: str = Field(pattern=_PORTABLE_REF_RE)`
- `source_capability: str = Field(pattern=_TOOL_RE)`
- `tool_version: int = Field(ge=1)`
- `project_id: UUID`
- `exact_scope_digest: str = Field(pattern=_SHA256_RE)`
- `subject_account_refs: tuple[str, ...] = Field(min_length=1, max_length=20)`
- `query_digest: str = Field(pattern=_SHA256_RE)`
- `request_digest: str = Field(pattern=_SHA256_RE)`
- `output_digest: str = Field(pattern=_SHA256_RE)`
- `journal_ref: str = Field(min_length=1, max_length=200)`
- `completed_at: str`
- `receipt_key_id: str = Field(min_length=8, max_length=80)`
- `provenance_hmac: str = Field(pattern=_SHA256_RE)`
- `provenance_digest: str = Field(default='0' * 64, pattern=_SHA256_RE)`

#### Methods

##### `lightbulb.observation_runtime.HostObservationReadProvenance.hmac_payload`



~~~python
def hmac_payload() -> dict[str, Any]
~~~


Source: `lightbulb/observation_runtime.py:740`.

### `lightbulb.observation_runtime.HostObservationReadResult`

class. Source: `lightbulb/observation_runtime.py:749`.

Fields:
- `status: Literal['completed', 'failed']`
- `output: Dict[str, Any] | None = None`
- `provenance: HostObservationReadProvenance | None = None`
- `retryable: bool = False`
- `error_code: str | None = Field(default=None, pattern=_PORTABLE_REF_RE)`

### `lightbulb.observation_runtime.HostObservationReader`

class. Source: `lightbulb/observation_runtime.py:772`.

#### Methods

##### `lightbulb.observation_runtime.HostObservationReader.read`



~~~python
def read(request: HostObservationReadRequest) -> HostObservationReadResult
~~~


Source: `lightbulb/observation_runtime.py:775`.

##### `lightbulb.observation_runtime.HostObservationReader.supports`



~~~python
def supports(source_capability: str) -> bool
~~~


Source: `lightbulb/observation_runtime.py:773`.

### `lightbulb.observation_runtime.mint_host_observation_read_result`

function. Source: `lightbulb/observation_runtime.py:780`.



~~~python
mint_host_observation_read_result(request_value: HostObservationReadRequest | Mapping[str, Any], output_value: Mapping[str, Any], *, completed_at: datetime, reader_ref: str, journal_ref: str, scope_keyring: ObservationScopeKeyRing) -> HostObservationReadResult
~~~


Seal one trusted host read for consumption by ``ObservationRuntime``.

### `lightbulb.observation_runtime.ShopifyAnalyticsNormalizer`

class. Source: `lightbulb/observation_runtime.py:849`.

#### Methods

##### `lightbulb.observation_runtime.ShopifyAnalyticsNormalizer.normalize`



~~~python
def normalize(output: Mapping[str, Any], *, spec: ObservationJobSpec) -> NormalizedObservation
~~~


Source: `lightbulb/observation_runtime.py:865`.

##### `lightbulb.observation_runtime.ShopifyAnalyticsNormalizer.supports_metric`



~~~python
def supports_metric(metric: str) -> bool
~~~


Source: `lightbulb/observation_runtime.py:862`.

### `lightbulb.observation_runtime.GoogleAnalyticsNormalizer`

class. Source: `lightbulb/observation_runtime.py:932`.

#### Methods

##### `lightbulb.observation_runtime.GoogleAnalyticsNormalizer.normalize`



~~~python
def normalize(output: Mapping[str, Any], *, spec: ObservationJobSpec) -> NormalizedObservation
~~~


Source: `lightbulb/observation_runtime.py:948`.

##### `lightbulb.observation_runtime.GoogleAnalyticsNormalizer.supports_metric`



~~~python
def supports_metric(metric: str) -> bool
~~~


Source: `lightbulb/observation_runtime.py:945`.

### `lightbulb.observation_runtime.CheckoutRecoverySnapshotNormalizer`

class. Source: `lightbulb/observation_runtime.py:994`.

#### Methods

##### `lightbulb.observation_runtime.CheckoutRecoverySnapshotNormalizer.normalize`



~~~python
def normalize(output: Mapping[str, Any], *, spec: ObservationJobSpec) -> NormalizedObservation
~~~


Source: `lightbulb/observation_runtime.py:1002`.

##### `lightbulb.observation_runtime.CheckoutRecoverySnapshotNormalizer.supports_metric`



~~~python
def supports_metric(metric: str) -> bool
~~~


Source: `lightbulb/observation_runtime.py:999`.

### `lightbulb.observation_runtime.StorefrontPhaseEvaluation`

class. Source: `lightbulb/observation_runtime.py:1041`.

Sealed Shopify-storefront phase result; never omnichannel completion.

Fields:
- `schema_id: Literal['lightbulb.storefront_phase_evaluation.v1'] = Field(default=STOREFRONT_PHASE_EVALUATION_SCHEMA, alias='schema')`
- `evaluation_ref: str = Field(pattern=_PORTABLE_REF_RE)`
- `plan_digest: str = Field(pattern=_SHA256_RE)`
- `exact_scope_digest: str = Field(pattern=_SHA256_RE)`
- `receipt_key_id: str = Field(min_length=8, max_length=80)`
- `run_ref: str = Field(pattern=_PORTABLE_REF_RE)`
- `iteration: int = Field(ge=1, le=4)`
- `max_iterations: int = Field(ge=1, le=4)`
- `provider: Literal['shopify', 'google_analytics']`
- `source_capability: Literal['shopify.analytics_query', 'google_analytics.fetch_metrics']`
- `connector_account_ref: str = Field(min_length=1, max_length=200)`
- `primary_metric: Literal['conversion_rate', 'click_through_rate']`
- `observed_value: Decimal`
- `target_value: Decimal`
- `sample_size: int = Field(ge=1, le=10000000000)`
- `window_start: str`
- `window_end: str`
- `evaluated_at: str`
- `evidence_receipt_digest: str = Field(pattern=_SHA256_RE)`
- `storefront_receipt_digests: tuple[str, ...] = Field(min_length=4, max_length=4)`
- `previous_evaluation_digest: str | None = Field(default=None, pattern=_SHA256_RE)`
- `decision: Literal['target_met', 'revise_plan', 'iteration_limit_reached']`
- `next_iteration: int | None = Field(default=None, ge=2, le=4)`
- `evaluation_hmac: str = Field(pattern=_SHA256_RE)`
- `evaluation_digest: str = Field(default='0' * 64, pattern=_SHA256_RE)`

#### Methods

##### `lightbulb.observation_runtime.StorefrontPhaseEvaluation.hmac_payload`



~~~python
def hmac_payload() -> dict[str, Any]
~~~


Source: `lightbulb/observation_runtime.py:1125`.

### `lightbulb.observation_runtime.GtmObservationContext`

class. Source: `lightbulb/observation_runtime.py:1134`.

Fields:
- `spec_digest: str = Field(pattern=_SHA256_RE)`
- `scope: DynamicWorkflowScope`
- `query_arguments: Dict[str, Any]`
- `plan: OmnichannelProductLaunchPlan`
- `action_receipts: tuple[ProductLaunchReceipt, ...]`
- `previous_evaluation: ProductLaunchIterationEvaluation | None = None`
- `context_digest: str = Field(default='0' * 64, pattern=_SHA256_RE)`

### `lightbulb.observation_runtime.StorefrontPhaseObservationContext`

class. Source: `lightbulb/observation_runtime.py:1160`.

Fields:
- `spec_digest: str = Field(pattern=_SHA256_RE)`
- `scope: DynamicWorkflowScope`
- `query_arguments: Dict[str, Any]`
- `plan: OmnichannelProductLaunchPlan`
- `storefront_receipts: tuple[ProductLaunchReceipt, ...] = Field(min_length=4, max_length=4)`
- `previous_evaluation: StorefrontPhaseEvaluation | None = None`
- `context_digest: str = Field(default='0' * 64, pattern=_SHA256_RE)`

### `lightbulb.observation_runtime.ProfitObservationContext`

class. Source: `lightbulb/observation_runtime.py:1188`.

Fields:
- `spec_digest: str = Field(pattern=_SHA256_RE)`
- `scope: DynamicWorkflowScope`
- `query_arguments: Dict[str, Any]`
- `plan: ProfitWorkflowPlan`
- `action_receipts: tuple[ProfitActionExecutionReceipt, ...]`
- `previous_evaluation: ProfitWorkflowEvaluation | None = None`
- `context_digest: str = Field(default='0' * 64, pattern=_SHA256_RE)`

### `lightbulb.observation_runtime.ObservationRunResult`

class. Source: `lightbulb/observation_runtime.py:1219`.

Fields:
- `schema_id: Literal['lightbulb.post_action_observation_result.v1'] = Field(default=OBSERVATION_RESULT_SCHEMA, alias='schema')`
- `job_ref: str = Field(pattern=_PORTABLE_REF_RE)`
- `job_digest: str = Field(pattern=_SHA256_RE)`
- `status: Literal['completed'] = 'completed'`
- `read_receipt: ObservationReadReceipt`
- `storefront_phase_evaluation: StorefrontPhaseEvaluation | None = None`
- `gtm_performance_receipt: ProductLaunchReceipt | None = None`
- `gtm_evaluation: ProductLaunchIterationEvaluation | None = None`
- `profit_metric_evidence: ProfitMetricEvidence | None = None`
- `profit_outcome: ProfitOutcomeEvidence | None = None`
- `profit_evaluation: ProfitWorkflowEvaluation | None = None`
- `next_iteration_event: WorkflowEventEnvelope | None = None`
- `result_digest: str = Field(default='0' * 64, pattern=_SHA256_RE)`

### `lightbulb.observation_runtime.ObservationArtifactRepository`

class. Source: `lightbulb/observation_runtime.py:1286`.

#### Methods

##### `lightbulb.observation_runtime.ObservationArtifactRepository.get_context`



~~~python
def get_context(job_ref: str) -> ObservationContext | None
~~~


Source: `lightbulb/observation_runtime.py:1289`.

##### `lightbulb.observation_runtime.ObservationArtifactRepository.get_result`



~~~python
def get_result(job_ref: str) -> ObservationRunResult | None
~~~


Source: `lightbulb/observation_runtime.py:1293`.

##### `lightbulb.observation_runtime.ObservationArtifactRepository.put_context`



~~~python
def put_context(job_ref: str, context: ObservationContext) -> None
~~~


Source: `lightbulb/observation_runtime.py:1287`.

##### `lightbulb.observation_runtime.ObservationArtifactRepository.put_result`



~~~python
def put_result(result: ObservationRunResult) -> None
~~~


Source: `lightbulb/observation_runtime.py:1291`.

### `lightbulb.observation_runtime.InMemoryObservationArtifactRepository`

class. Source: `lightbulb/observation_runtime.py:1296`.

Conflict-detecting test/reference repository; production may use object storage.

#### Methods

##### `lightbulb.observation_runtime.InMemoryObservationArtifactRepository.get_context`



~~~python
def get_context(job_ref: str) -> ObservationContext | None
~~~


Source: `lightbulb/observation_runtime.py:1312`.

##### `lightbulb.observation_runtime.InMemoryObservationArtifactRepository.get_result`



~~~python
def get_result(job_ref: str) -> ObservationRunResult | None
~~~


Source: `lightbulb/observation_runtime.py:1327`.

##### `lightbulb.observation_runtime.InMemoryObservationArtifactRepository.put_context`



~~~python
def put_context(job_ref: str, context: ObservationContext) -> None
~~~


Source: `lightbulb/observation_runtime.py:1304`.

##### `lightbulb.observation_runtime.InMemoryObservationArtifactRepository.put_result`



~~~python
def put_result(result: ObservationRunResult) -> None
~~~


Source: `lightbulb/observation_runtime.py:1319`.

### `lightbulb.observation_runtime.JsonFileObservationArtifactRepository`

class. Source: `lightbulb/observation_runtime.py:1369`.

Immutable, atomic JSON artifact store suitable for one shared filesystem.

#### Methods

##### `lightbulb.observation_runtime.JsonFileObservationArtifactRepository.get_context`



~~~python
def get_context(job_ref: str) -> ObservationContext | None
~~~


Source: `lightbulb/observation_runtime.py:1552`.

##### `lightbulb.observation_runtime.JsonFileObservationArtifactRepository.get_result`



~~~python
def get_result(job_ref: str) -> ObservationRunResult | None
~~~


Source: `lightbulb/observation_runtime.py:1591`.

##### `lightbulb.observation_runtime.JsonFileObservationArtifactRepository.put_context`



~~~python
def put_context(job_ref: str, context: ObservationContext) -> None
~~~


Source: `lightbulb/observation_runtime.py:1535`.

##### `lightbulb.observation_runtime.JsonFileObservationArtifactRepository.put_result`



~~~python
def put_result(result: ObservationRunResult) -> None
~~~


Source: `lightbulb/observation_runtime.py:1575`.

### `lightbulb.observation_runtime.ObservationRuntime`

class. Source: `lightbulb/observation_runtime.py:1607`.

Schedule, claim, normalize, attest, and evaluate post-action reads.

#### Methods

##### `lightbulb.observation_runtime.ObservationRuntime.run_next`



~~~python
def run_next(*, scope: DynamicWorkflowScope | Mapping[str, Any], worker_ref: str, now: datetime, lease_seconds: int=60) -> ObservationRunResult | None
~~~


Source: `lightbulb/observation_runtime.py:2033`.

##### `lightbulb.observation_runtime.ObservationRuntime.schedule_gtm`



~~~python
def schedule_gtm(plan_value: OmnichannelProductLaunchPlan | Mapping[str, Any], *, action_receipts: Iterable[ProductLaunchReceipt | Mapping[str, Any]], scope: DynamicWorkflowScope | Mapping[str, Any], project_id: UUID, tenant_connector_id: UUID, connector_account_ref: str, provider: Literal['shopify', 'google_analytics']='shopify', source_capability: Literal['shopify.analytics_query', 'google_analytics.fetch_metrics'] | None=None, query_arguments: Mapping[str, Any], expected_tool_version: int, expected_route_digest: str, run_ref: str, iteration: int=1, previous_evaluation: ProductLaunchIterationEvaluation | None=None, max_attempts: int=3) -> WorkflowCheckpoint
~~~


Schedule one exact analytics source for one launch evaluation job.

Source: `lightbulb/observation_runtime.py:1648`.

##### `lightbulb.observation_runtime.ObservationRuntime.schedule_profit`



~~~python
def schedule_profit(plan_value: ProfitWorkflowPlan | Mapping[str, Any], *, action_receipts: Iterable[ProfitActionExecutionReceipt | Mapping[str, Any]], scope: DynamicWorkflowScope | Mapping[str, Any], project_id: UUID, provider: Literal['shopify', 'google_analytics', 'host'], tenant_connector_id: UUID | None=None, connector_account_ref: str | None=None, source_capability: str, query_arguments: Mapping[str, Any], expected_tool_version: int, expected_route_digest: str | None=None, run_ref: str, iteration: int=1, previous_evaluation: ProfitWorkflowEvaluation | None=None, max_attempts: int=3) -> WorkflowCheckpoint
~~~


Source: `lightbulb/observation_runtime.py:1888`.

##### `lightbulb.observation_runtime.ObservationRuntime.schedule_storefront_phase`



~~~python
def schedule_storefront_phase(plan_value: OmnichannelProductLaunchPlan | Mapping[str, Any], *, storefront_receipts: Iterable[ProductLaunchReceipt | Mapping[str, Any]], scope: DynamicWorkflowScope | Mapping[str, Any], project_id: UUID, tenant_connector_id: UUID, connector_account_ref: str, provider: Literal['shopify', 'google_analytics']='shopify', source_capability: Literal['shopify.analytics_query', 'google_analytics.fetch_metrics'] | None=None, query_arguments: Mapping[str, Any], expected_tool_version: int, expected_route_digest: str, run_ref: str, iteration: int=1, previous_evaluation: StorefrontPhaseEvaluation | None=None, max_attempts: int=3) -> WorkflowCheckpoint
~~~


Schedule a sealed storefront-phase evaluation from the four Shopify receipts.

Source: `lightbulb/observation_runtime.py:1762`.

##### `lightbulb.observation_runtime.ObservationRuntime.verify_read_receipt`



~~~python
def verify_read_receipt(receipt_value: ObservationReadReceipt | Mapping[str, Any]) -> ObservationReadReceipt
~~~


Source: `lightbulb/observation_runtime.py:2226`.

##### `lightbulb.observation_runtime.ObservationRuntime.verify_storefront_phase_evaluation`



~~~python
def verify_storefront_phase_evaluation(value: StorefrontPhaseEvaluation | Mapping[str, Any]) -> StorefrontPhaseEvaluation
~~~


Source: `lightbulb/observation_runtime.py:2248`.

### `lightbulb.observation_runtime.ObservationWorker`

class. Source: `lightbulb/observation_runtime.py:2987`.

Bounded poller; the hosting process remains responsible for starting it.

#### Methods

##### `lightbulb.observation_runtime.ObservationWorker.run_once`



~~~python
def run_once(*, now: datetime | None=None) -> tuple[ObservationRunResult, ...]
~~~


Source: `lightbulb/observation_runtime.py:3041`.

##### `lightbulb.observation_runtime.ObservationWorker.serve`



~~~python
def serve(*, stop_requested: Callable[[], bool], max_cycles: int | None=None) -> int
~~~


Poll until the host requests shutdown; ``max_cycles`` bounds tests/jobs.

Source: `lightbulb/observation_runtime.py:3060`.

## Module `lightbulb.operational_readiness`

Evidence-bound production execution readiness evaluation.

### `lightbulb.operational_readiness.OperationalReadinessPolicy`

class. Source: `lightbulb/operational_readiness.py:508`.

Fields:
- `required_hosted_write_tools: tuple[ToolName, ...] = Field(default_factory=tuple, max_length=1000)`
- `required_connector_providers: tuple[ProviderName, ...] = Field(default_factory=tuple, max_length=100)`
- `required_connector_tools: tuple[ToolName, ...] = Field(default_factory=tuple, max_length=1000)`
- `required_channels: tuple[Channel, ...] = Field(default_factory=tuple, max_length=4)`
- `required_replay_classes: tuple[OpaqueRef, ...] = Field(default_factory=tuple, max_length=100)`
- `required_slos: tuple[SloRef, ...] = Field(default_factory=tuple, max_length=100)`
- `required_business_outcomes: tuple[OpaqueRef, ...] = Field(default_factory=tuple, max_length=100)`
- `minimum_evidence_grade: PrimitiveEvidenceVerificationGrade = PrimitiveEvidenceVerificationGrade.ATTESTED`
- `maximum_incident_exercise_age_hours: int = Field(default=2160, ge=1, le=17520)`
- `maximum_business_measurement_age_hours: int = Field(default=744, ge=1, le=8760)`
- `minimum_slo_sample_count: int = Field(default=100, ge=1, le=1000000000)`

### `lightbulb.operational_readiness.OperationalReadinessInput`

class. Source: `lightbulb/operational_readiness.py:595`.

Fields:
- `schema_id: Literal['lightbulb.operational_readiness_input.v1'] = Field(default=OPERATIONAL_READINESS_INPUT_SCHEMA, alias='schema')`
- `evaluation_ref: OpaqueRef`
- `environment_ref: OpaqueRef`
- `evaluated_at: str`
- `policy: OperationalReadinessPolicy`
- `hosted_writes: tuple[HostedWriteCertification, ...] = Field(default_factory=tuple, max_length=1000)`
- `bounded_loops: BoundedLoopCertification`
- `publication_recovery: WorkflowPublicationRecoveryCertification | None = None`
- `connector_conformance: tuple[ConnectorConformanceCertification, ...] = Field(default_factory=tuple, max_length=_MAX_CONNECTOR_CERTIFICATIONS)`
- `transports: tuple[TransportRecoveryCertification, ...] = Field(default_factory=tuple, max_length=100)`
- `replay_guarantees: tuple[ReplayGuaranteeCertification, ...] = Field(default_factory=tuple, max_length=100)`
- `service_levels: tuple[ServiceLevelMeasurement, ...] = Field(default_factory=tuple, max_length=100)`
- `incident_procedure: IncidentProcedureCertification`
- `business_outcomes: tuple[BusinessOutcomeMeasurement, ...] = Field(default_factory=tuple, max_length=100)`

### `lightbulb.operational_readiness.OperationalReadinessResult`

class. Source: `lightbulb/operational_readiness.py:719`.

Fields:
- `schema_id: Literal['lightbulb.operational_readiness_result.v1'] = Field(default=OPERATIONAL_READINESS_RESULT_SCHEMA, alias='schema')`
- `evaluation_ref: OpaqueRef`
- `environment_ref: OpaqueRef`
- `evaluated_at: str`
- `disposition: ReadinessDisposition`
- `findings: tuple[OperationalReadinessFinding, ...]`
- `passed_count: int = Field(ge=0)`
- `failed_count: int = Field(ge=0)`
- `indeterminate_count: int = Field(ge=0)`
- `evidence_refs: tuple[PrimitiveEvidenceRef, ...]`
- `input_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `evidence_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `evaluation_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `operation_spec: PrimitiveOperationSpec`
- `production_certified: Literal[False] = False`
- `deployment_authorized: Literal[False] = False`
- `incident_closed: Literal[False] = False`

### `lightbulb.operational_readiness.evaluate_operational_readiness`

function. Source: `lightbulb/operational_readiness.py:915`.



~~~python
evaluate_operational_readiness(inputs: OperationalReadinessInput | dict[str, Any]) -> OperationalReadinessResult
~~~


Evaluate production execution evidence without granting certification.

### `lightbulb.operational_readiness.EvaluateOperationalReadinessPrimitive`

class. Source: `lightbulb/operational_readiness.py:1530`.

#### Methods

##### `lightbulb.operational_readiness.EvaluateOperationalReadinessPrimitive.implementation_contract`



~~~python
def implementation_contract() -> dict[str, Any]
~~~


Source: `lightbulb/operational_readiness.py:1552`.

## Module `lightbulb.people_controls`

Evidence-bound recruiting, payroll-readiness, and offboarding controls.

### `lightbulb.people_controls.people_snapshot_digest`

function. Source: `lightbulb/people_controls.py:186`.



~~~python
people_snapshot_digest(snapshot: BaseModel | Mapping[str, Any]) -> str
~~~


### `lightbulb.people_controls.PeopleControlPolicy`

class. Source: `lightbulb/people_controls.py:510`.

Fields:
- `minimum_evidence_grade: PrimitiveEvidenceVerificationGrade = PrimitiveEvidenceVerificationGrade.ATTESTED`
- `max_evidence_age_hours: int = Field(default=720, ge=1, le=8760)`
- `require_current_certifications_for_hire: bool = True`
- `allow_certification_waiver_review: bool = True`
- `require_clear_pay_equity_review: bool = True`
- `require_timecard_without_exceptions: bool = True`
- `require_final_pay_approval: bool = True`
- `require_all_access_revoked: bool = True`

### `lightbulb.people_controls.PeopleControlInput`

class. Source: `lightbulb/people_controls.py:523`.

Fields:
- `schema_id: Literal['lightbulb.people_control_input.v1'] = Field(default=PEOPLE_CONTROL_INPUT_SCHEMA, alias='schema')`
- `evaluation_ref: OpaqueRef`
- `target: PeopleTarget`
- `analysis_as_of: str`
- `target_pay_period_ref: OpaqueRef | None = None`
- `target_pay_period_start: str | None = None`
- `target_pay_period_end: str | None = None`
- `worker: WorkerLifecycleSnapshot`
- `workforce_plan: WorkforcePlanSnapshot | None = None`
- `recruiting: RecruitingSnapshot | None = None`
- `schedule_time: ScheduleTimeSnapshot | None = None`
- `leave: LeaveSnapshot | None = None`
- `performance_compensation: PerformanceCompensationSnapshot | None = None`
- `learning: LearningSnapshot | None = None`
- `payroll: PayrollIntegrationSnapshot | None = None`
- `offboarding: OffboardingSnapshot | None = None`
- `access_accounts: tuple[AccessAccountSnapshot, ...] = Field(default_factory=tuple, max_length=10000)`
- `policy: PeopleControlPolicy = Field(default_factory=PeopleControlPolicy)`

### `lightbulb.people_controls.PeopleEffectBoundary`

class. Source: `lightbulb/people_controls.py:661`.

Fields:
- `worker_hired_or_terminated: Literal[False] = False`
- `compensation_or_leave_changed: Literal[False] = False`
- `schedule_or_timecard_changed: Literal[False] = False`
- `payroll_exported_or_paid: Literal[False] = False`
- `learning_or_certification_changed: Literal[False] = False`
- `access_provisioned_or_revoked: Literal[False] = False`
- `trusted_host_authority_required: Literal[True] = True`

### `lightbulb.people_controls.PeopleControlResult`

class. Source: `lightbulb/people_controls.py:682`.

Fields:
- `schema_id: Literal['lightbulb.people_control_result.v1'] = Field(default=PEOPLE_CONTROL_RESULT_SCHEMA, alias='schema')`
- `evaluation_ref: OpaqueRef`
- `target: PeopleTarget`
- `analysis_as_of: str`
- `proposed_disposition: Disposition`
- `assurance_grade: PrimitiveEvidenceVerificationGrade`
- `gates: tuple[PeopleGateResult, ...]`
- `findings: tuple[PeopleFinding, ...]`
- `source_snapshot_digests: dict[str, str]`
- `evidence_refs: tuple[OpaqueRef, ...]`
- `effect_boundary: PeopleEffectBoundary = Field(default_factory=PeopleEffectBoundary)`
- `result_digest: str = Field(default=_ZERO_DIGEST, pattern='^[0-9a-f]{64}$')`

### `lightbulb.people_controls.evaluate_people_controls`

function. Source: `lightbulb/people_controls.py:855`.



~~~python
evaluate_people_controls(value: PeopleControlInput | Mapping[str, Any]) -> PeopleControlResult
~~~


Evaluate one people-lifecycle gate without changing a host system.

### `lightbulb.people_controls.EvaluateWorkerLifecycleControlsPrimitive`

class. Source: `lightbulb/people_controls.py:1493`.

#### Methods

##### `lightbulb.people_controls.EvaluateWorkerLifecycleControlsPrimitive.implementation_contract`



~~~python
def implementation_contract() -> dict[str, Any]
~~~


Source: `lightbulb/people_controls.py:1559`.

## Module `lightbulb.people_operations_lifecycle`

Deterministic, no-effect people-operations lifecycle proposals.

### `lightbulb.people_operations_lifecycle.PeopleOperationsScope`

class. Source: `lightbulb/people_operations_lifecycle.py:286`.

Fields:
- `schema_id: Literal['lightbulb.people_operations_scope.v1'] = Field(default=PEOPLE_OPERATIONS_SCOPE_SCHEMA, alias='schema')`
- `tenant_ref: OpaqueRef`
- `company_ref: OpaqueRef`
- `project_ref: OpaqueRef`
- `project_id: UUID`
- `worker_ref: OpaqueRef`
- `candidate_ref: OpaqueRef`
- `position_ref: OpaqueRef`
- `jurisdiction: JurisdictionCode`
- `payroll_currency: CurrencyCode`
- `pay_rate_uom: PayRateUom`
- `pay_periods_per_year: PayPeriodsPerYear | None = None`

### `lightbulb.people_operations_lifecycle.people_scope_digest`

function. Source: `lightbulb/people_operations_lifecycle.py:327`.



~~~python
people_scope_digest(value: PeopleOperationsScope | Mapping[str, Any]) -> str
~~~


### `lightbulb.people_operations_lifecycle.PeoplePayPeriod`

class. Source: `lightbulb/people_operations_lifecycle.py:332`.

Fields:
- `schema_id: Literal['lightbulb.people_pay_period.v1'] = Field(default=PEOPLE_PAY_PERIOD_SCHEMA, alias='schema')`
- `pay_period_ref: OpaqueRef`
- `starts_on: str`
- `ends_on: str`
- `jurisdiction: JurisdictionCode`
- `currency: CurrencyCode`

### `lightbulb.people_operations_lifecycle.PeopleApprovalEvidence`

class. Source: `lightbulb/people_operations_lifecycle.py:357`.

Fields:
- `schema_id: Literal['lightbulb.people_approval_evidence.v1'] = Field(default=PEOPLE_APPROVAL_EVIDENCE_SCHEMA, alias='schema')`
- `approval_ref: OpaqueRef`
- `approval_receipt_digest: Sha256Digest`
- `scope_digest: Sha256Digest`
- `lifecycle_ref: OpaqueRef`
- `transition_ref: OpaqueRef`
- `command_digest: Sha256Digest`
- `idempotency_digest: Sha256Digest`
- `approved_by_ref: OpaqueRef`
- `approver_role: ApprovalRole`
- `approved_at: str`
- `expires_at: str`
- `decision: Literal['approved'] = 'approved'`
- `single_use: Literal[True] = True`
- `sdk_execution_authority_granted: Literal[False] = False`
- `evidence: PrimitiveEvidenceRef`
- `approval_digest: Sha256Digest`

### `lightbulb.people_operations_lifecycle.people_approval_digest`

function. Source: `lightbulb/people_operations_lifecycle.py:409`.



~~~python
people_approval_digest(value: PeopleApprovalEvidence | Mapping[str, Any]) -> str
~~~


### `lightbulb.people_operations_lifecycle.CreateCandidateCommand`

class. Source: `lightbulb/people_operations_lifecycle.py:428`.

Fields:
- `schema_id: Literal['lightbulb.people_create_candidate_command.v1'] = Field(default='lightbulb.people_create_candidate_command.v1', alias='schema')`
- `kind: Literal['create_candidate'] = 'create_candidate'`
- `recruiting_source_ref: OpaqueRef`
- `headcount_plan_ref: OpaqueRef`
- `position_authorization_ref: OpaqueRef`
- `position_status: Literal['approved_open'] = 'approved_open'`

### `lightbulb.people_operations_lifecycle.AdvanceCandidateCommand`

class. Source: `lightbulb/people_operations_lifecycle.py:440`.

Fields:
- `schema_id: Literal['lightbulb.people_advance_candidate_command.v1'] = Field(default='lightbulb.people_advance_candidate_command.v1', alias='schema')`
- `kind: Literal['advance_candidate'] = 'advance_candidate'`
- `target_stage: Literal['screened', 'interviewed', 'offer_approved']`
- `evaluation_ref: OpaqueRef`

### `lightbulb.people_operations_lifecycle.ActivateWorkerCommand`

class. Source: `lightbulb/people_operations_lifecycle.py:450`.

Fields:
- `schema_id: Literal['lightbulb.people_activate_worker_command.v1'] = Field(default='lightbulb.people_activate_worker_command.v1', alias='schema')`
- `kind: Literal['activate_worker'] = 'activate_worker'`
- `worker_activation_ref: OpaqueRef`
- `employment_agreement_ref: OpaqueRef`
- `compensation_ref: OpaqueRef`
- `employment_starts_at: str`
- `base_pay_rate: Decimal`
- `currency: CurrencyCode`
- `pay_rate_uom: PayRateUom`

### `lightbulb.people_operations_lifecycle.ScheduleShiftCommand`

class. Source: `lightbulb/people_operations_lifecycle.py:478`.

Fields:
- `schema_id: Literal['lightbulb.people_schedule_shift_command.v1'] = Field(default='lightbulb.people_schedule_shift_command.v1', alias='schema')`
- `kind: Literal['schedule_shift'] = 'schedule_shift'`
- `shift_ref: OpaqueRef`
- `starts_at: str`
- `ends_at: str`
- `break_minutes: int = Field(ge=0, le=720)`
- `scheduled_hours: Decimal`
- `hours_uom: HoursUom = 'hour'`

### `lightbulb.people_operations_lifecycle.RecordApprovedTimecardCommand`

class. Source: `lightbulb/people_operations_lifecycle.py:520`.

Fields:
- `schema_id: Literal['lightbulb.people_record_timecard_command.v1'] = Field(default='lightbulb.people_record_timecard_command.v1', alias='schema')`
- `kind: Literal['record_approved_timecard'] = 'record_approved_timecard'`
- `timecard_ref: OpaqueRef`
- `shift_ref: OpaqueRef`
- `pay_period: PeoplePayPeriod`
- `regular_hours: Decimal`
- `overtime_hours: Decimal`
- `worked_hours: Decimal`
- `paid_leave_hours: Decimal = Decimal('0.000')`
- `hours_uom: HoursUom = 'hour'`

### `lightbulb.people_operations_lifecycle.RecordApprovedLeaveCommand`

class. Source: `lightbulb/people_operations_lifecycle.py:553`.

Fields:
- `schema_id: Literal['lightbulb.people_record_leave_command.v1'] = Field(default='lightbulb.people_record_leave_command.v1', alias='schema')`
- `kind: Literal['record_approved_leave'] = 'record_approved_leave'`
- `leave_ref: OpaqueRef`
- `leave_type_ref: OpaqueRef`
- `pay_period: PeoplePayPeriod`
- `starts_at: str`
- `ends_at: str`
- `requested_hours: Decimal`
- `balance_before_hours: Decimal`
- `balance_after_hours: Decimal`
- `paid_leave: bool`
- `payroll_reconciled: bool`
- `hours_uom: HoursUom = 'hour'`

### `lightbulb.people_operations_lifecycle.RecordPerformanceCompensationCommand`

class. Source: `lightbulb/people_operations_lifecycle.py:597`.

Fields:
- `schema_id: Literal['lightbulb.people_performance_compensation_command.v1'] = Field(default='lightbulb.people_performance_compensation_command.v1', alias='schema')`
- `kind: Literal['record_performance_compensation'] = 'record_performance_compensation'`
- `performance_review_ref: OpaqueRef`
- `performance_cycle_ref: OpaqueRef`
- `reviewer_ref: OpaqueRef`
- `compensation_ref: OpaqueRef`
- `old_base_pay_rate: Decimal`
- `compensation_change: Decimal`
- `new_base_pay_rate: Decimal`
- `currency: CurrencyCode`
- `pay_rate_uom: PayRateUom`
- `effective_at: str`

### `lightbulb.people_operations_lifecycle.RecordCertificationCommand`

class. Source: `lightbulb/people_operations_lifecycle.py:638`.

Fields:
- `schema_id: Literal['lightbulb.people_certification_command.v1'] = Field(default='lightbulb.people_certification_command.v1', alias='schema')`
- `kind: Literal['record_certification'] = 'record_certification'`
- `learning_record_ref: OpaqueRef`
- `certification_ref: OpaqueRef`
- `credential_ref: OpaqueRef`
- `issued_on: str`
- `expires_on: str`
- `status: Literal['current'] = 'current'`
- `required_for_position: bool`

### `lightbulb.people_operations_lifecycle.PreparePayrollHandoffCommand`

class. Source: `lightbulb/people_operations_lifecycle.py:664`.

Fields:
- `schema_id: Literal['lightbulb.people_payroll_handoff_command.v1'] = Field(default='lightbulb.people_payroll_handoff_command.v1', alias='schema')`
- `kind: Literal['prepare_payroll_handoff'] = 'prepare_payroll_handoff'`
- `payroll_handoff_ref: OpaqueRef`
- `payroll_account_ref: OpaqueRef`
- `pay_period: PeoplePayPeriod`
- `timecard_ref: OpaqueRef`
- `compensation_ref: OpaqueRef`
- `base_pay_rate: Decimal`
- `overtime_multiplier: Decimal = Decimal('1.500')`
- `gross_pay_amount: Decimal`
- `calculation_basis_digest: Sha256Digest`
- `currency: CurrencyCode`
- `pay_rate_uom: PayRateUom`
- `pay_periods_per_year: PayPeriodsPerYear | None = None`
- `salary_period_basis: SalaryPeriodBasis | None = None`

### `lightbulb.people_operations_lifecycle.InitiateOffboardingCommand`

class. Source: `lightbulb/people_operations_lifecycle.py:722`.

Fields:
- `schema_id: Literal['lightbulb.people_initiate_offboarding_command.v1'] = Field(default='lightbulb.people_initiate_offboarding_command.v1', alias='schema')`
- `kind: Literal['initiate_offboarding'] = 'initiate_offboarding'`
- `offboarding_ref: OpaqueRef`
- `last_working_at: str`
- `final_pay_period: PeoplePayPeriod`
- `final_payroll_handoff_ref: OpaqueRef`
- `expected_access_system_refs: tuple[OpaqueRef, ...] = Field(min_length=1, max_length=_MAX_ACCESS_SYSTEMS)`

### `lightbulb.people_operations_lifecycle.VerifyAccessRevocationCommand`

class. Source: `lightbulb/people_operations_lifecycle.py:761`.

Fields:
- `schema_id: Literal['lightbulb.people_verify_access_revocation_command.v1'] = Field(default='lightbulb.people_verify_access_revocation_command.v1', alias='schema')`
- `kind: Literal['verify_access_revocation'] = 'verify_access_revocation'`
- `offboarding_ref: OpaqueRef`
- `system_ref: OpaqueRef`
- `account_ref: OpaqueRef`
- `revocation_verification_ref: OpaqueRef`
- `claimed_provider_effect_receipt_digest: Sha256Digest`
- `revoked_at: str`

### `lightbulb.people_operations_lifecycle.CompleteOffboardingCommand`

class. Source: `lightbulb/people_operations_lifecycle.py:780`.

Fields:
- `schema_id: Literal['lightbulb.people_complete_offboarding_command.v1'] = Field(default='lightbulb.people_complete_offboarding_command.v1', alias='schema')`
- `kind: Literal['complete_offboarding'] = 'complete_offboarding'`
- `offboarding_ref: OpaqueRef`
- `final_payroll_handoff_ref: OpaqueRef`
- `completed_at: str`

### `lightbulb.people_operations_lifecycle.people_command_digest`

function. Source: `lightbulb/people_operations_lifecycle.py:817`.



~~~python
people_command_digest(value: _PeopleCommand | Mapping[str, Any]) -> str
~~~


### `lightbulb.people_operations_lifecycle.PeopleTransitionCandidate`

class. Source: `lightbulb/people_operations_lifecycle.py:824`.

Fields:
- `schema_id: Literal['lightbulb.people_transition_candidate.v1'] = Field(default=PEOPLE_TRANSITION_CANDIDATE_SCHEMA, alias='schema')`
- `lifecycle_ref: OpaqueRef`
- `revision: int = Field(ge=1, le=_MAX_TRANSITIONS)`
- `scope_digest: Sha256Digest`
- `transition_ref: OpaqueRef`
- `prior_state_digest: Sha256Digest`
- `command: PeopleCommand`
- `command_digest: Sha256Digest`
- `idempotency_digest: Sha256Digest`
- `requested_by_ref: OpaqueRef`
- `proposed_at: str`
- `evidence_refs: tuple[PrimitiveEvidenceRef, ...] = Field(min_length=1, max_length=_MAX_EVIDENCE_PER_TRANSITION)`
- `evidence_digest: Sha256Digest`
- `required_approver_role: ApprovalRole | None = None`
- `approval_ref: OpaqueRef | None = None`
- `approval_receipt_digest: Sha256Digest | None = None`
- `authoritative_state_changed: Literal[False] = False`
- `provider_effect_executed: Literal[False] = False`
- `transition_digest: Sha256Digest`

### `lightbulb.people_operations_lifecycle.people_transition_candidate_digest`

function. Source: `lightbulb/people_operations_lifecycle.py:905`.



~~~python
people_transition_candidate_digest(value: PeopleTransitionCandidate | Mapping[str, Any]) -> str
~~~


### `lightbulb.people_operations_lifecycle.CertificationProjection`

class. Source: `lightbulb/people_operations_lifecycle.py:917`.

Fields:
- `certification_ref: OpaqueRef`
- `learning_record_ref: OpaqueRef`
- `credential_ref: OpaqueRef`
- `issued_on: str`
- `expires_on: str`
- `required_for_position: bool`

### `lightbulb.people_operations_lifecycle.AccessRevocationProjection`

class. Source: `lightbulb/people_operations_lifecycle.py:931`.

Fields:
- `system_ref: OpaqueRef`
- `account_ref: OpaqueRef`
- `revocation_verification_ref: OpaqueRef`
- `claimed_provider_effect_receipt_digest: Sha256Digest`
- `revoked_at: str`

### `lightbulb.people_operations_lifecycle.PeopleOperationsSnapshot`

class. Source: `lightbulb/people_operations_lifecycle.py:944`.

Fields:
- `schema_id: Literal['lightbulb.people_operations_snapshot.v1'] = Field(default=PEOPLE_OPERATIONS_SNAPSHOT_SCHEMA, alias='schema')`
- `scope: PeopleOperationsScope`
- `scope_digest: Sha256Digest`
- `lifecycle_ref: OpaqueRef`
- `state: PeopleLifecycleState`
- `candidate_stage: CandidateStage`
- `position_authorization_ref: OpaqueRef`
- `worker_activation_ref: OpaqueRef | None = None`
- `employment_starts_at: str | None = None`
- `current_compensation_ref: OpaqueRef | None = None`
- `current_base_pay_rate: Decimal | None = None`
- `current_compensation_effective_at: str | None = None`
- `latest_shift_ref: OpaqueRef | None = None`
- `latest_shift_starts_at: str | None = None`
- `latest_shift_ends_at: str | None = None`
- `latest_scheduled_hours: Decimal | None = None`
- `latest_timecard_ref: OpaqueRef | None = None`
- `latest_timecard_shift_ref: OpaqueRef | None = None`
- `latest_timecard_shift_starts_at: str | None = None`
- `latest_timecard_shift_ends_at: str | None = None`
- `latest_timecard_pay_period: PeoplePayPeriod | None = None`
- `latest_regular_hours: Decimal | None = None`
- `latest_overtime_hours: Decimal | None = None`
- `latest_paid_leave_hours: Decimal | None = None`
- `latest_leave_ref: OpaqueRef | None = None`
- `latest_leave_pay_period: PeoplePayPeriod | None = None`
- `latest_leave_hours: Decimal | None = None`
- `latest_leave_paid: bool | None = None`
- `latest_leave_payroll_reconciled: bool | None = None`
- `latest_performance_review_ref: OpaqueRef | None = None`
- `certifications: tuple[CertificationProjection, ...] = Field(default=(), max_length=_MAX_CERTIFICATIONS)`
- `latest_payroll_handoff_ref: OpaqueRef | None = None`
- `latest_payroll_timecard_ref: OpaqueRef | None = None`
- `latest_payroll_pay_period: PeoplePayPeriod | None = None`
- `latest_gross_pay_amount: Decimal | None = None`
- `latest_payroll_calculation_basis_digest: Sha256Digest | None = None`
- `latest_payroll_pay_periods_per_year: PayPeriodsPerYear | None = None`
- `latest_salary_period_basis: SalaryPeriodBasis | None = None`
- `offboarding_ref: OpaqueRef | None = None`
- `offboarding_initiated_at: str | None = None`
- `last_working_at: str | None = None`
- `final_payroll_handoff_ref: OpaqueRef | None = None`
- `expected_access_system_refs: tuple[OpaqueRef, ...] = ()`
- `access_revocations: tuple[AccessRevocationProjection, ...] = Field(default=(), max_length=_MAX_ACCESS_SYSTEMS)`
- `offboarded_at: str | None = None`
- `revision: int = Field(ge=1, le=_MAX_TRANSITIONS)`
- `transition_history: tuple[PeopleTransitionCandidate, ...] = Field(min_length=1, max_length=_MAX_TRANSITIONS)`
- `state_digest: Sha256Digest`

### `lightbulb.people_operations_lifecycle.people_snapshot_digest`

function. Source: `lightbulb/people_operations_lifecycle.py:1079`.



~~~python
people_snapshot_digest(value: PeopleOperationsSnapshot | Mapping[str, Any]) -> str
~~~


### `lightbulb.people_operations_lifecycle.people_payroll_calculation_basis_digest`

function. Source: `lightbulb/people_operations_lifecycle.py:1153`.



~~~python
people_payroll_calculation_basis_digest(snapshot: PeopleOperationsSnapshot, command: PreparePayrollHandoffCommand | Mapping[str, Any]) -> str
~~~


Digest exact retained time/rate lineage without authorizing payroll.

### `lightbulb.people_operations_lifecycle.PeopleTransitionRequest`

class. Source: `lightbulb/people_operations_lifecycle.py:1169`.

Fields:
- `schema_id: Literal['lightbulb.people_transition_request.v1'] = Field(default=PEOPLE_TRANSITION_REQUEST_SCHEMA, alias='schema')`
- `scope: PeopleOperationsScope`
- `lifecycle_ref: OpaqueRef`
- `expected_revision: int = Field(ge=0, le=_MAX_TRANSITIONS)`
- `expected_state_digest: Sha256Digest`
- `transition_ref: OpaqueRef`
- `idempotency_key: OpaqueRef`
- `requested_by_ref: OpaqueRef`
- `proposed_at: str`
- `current_snapshot: PeopleOperationsSnapshot | None = None`
- `command: PeopleCommand`
- `evidence_refs: tuple[PrimitiveEvidenceRef, ...] = Field(min_length=1, max_length=_MAX_EVIDENCE_PER_TRANSITION)`

### `lightbulb.people_operations_lifecycle.people_idempotency_digest`

function. Source: `lightbulb/people_operations_lifecycle.py:1220`.



~~~python
people_idempotency_digest(scope: PeopleOperationsScope | Mapping[str, Any], lifecycle_ref: str, idempotency_key: str) -> str
~~~


### `lightbulb.people_operations_lifecycle.people_transition_evidence_digest`

function. Source: `lightbulb/people_operations_lifecycle.py:1235`.



~~~python
people_transition_evidence_digest(value: PeopleTransitionRequest | Mapping[str, Any]) -> str
~~~


### `lightbulb.people_operations_lifecycle.people_access_revocation_evidence_digest`

function. Source: `lightbulb/people_operations_lifecycle.py:1305`.



~~~python
people_access_revocation_evidence_digest(scope: PeopleOperationsScope | Mapping[str, Any], lifecycle_ref: str, transition_ref: str, command: VerifyAccessRevocationCommand | Mapping[str, Any]) -> str
~~~


Bind a portable revocation claim; this is not provider provenance.

### `lightbulb.people_operations_lifecycle.PeopleTransitionProposal`

class. Source: `lightbulb/people_operations_lifecycle.py:1323`.

Fields:
- `schema_id: Literal['lightbulb.people_transition_proposal.v1'] = Field(default=PEOPLE_TRANSITION_PROPOSAL_SCHEMA, alias='schema')`
- `scope: PeopleOperationsScope`
- `lifecycle_ref: OpaqueRef`
- `source_revision: int = Field(ge=0, le=_MAX_TRANSITIONS)`
- `source_state_digest: Sha256Digest`
- `target_revision: int = Field(ge=1, le=_MAX_TRANSITIONS)`
- `target_state: PeopleLifecycleState`
- `transition_ref: OpaqueRef`
- `transition_digest: Sha256Digest`
- `candidate_state_digest: Sha256Digest`
- `required_approver_role: ApprovalRole | None = None`
- `business_approval_evidence_present: bool`
- `spring_revalidation_required: Literal[True] = True`
- `authoritative_persistence_granted: Literal[False] = False`
- `employment_or_compensation_decision_executed: Literal[False] = False`
- `payroll_hcm_or_iam_write_executed: Literal[False] = False`
- `hosted_approval_task_created: Literal[False] = False`
- `spring_submission_executed: Literal[False] = False`
- `provider_receipt_verified_by_sdk: Literal[False] = False`
- `proposal_digest: Sha256Digest`

### `lightbulb.people_operations_lifecycle.PeopleTransitionResult`

class. Source: `lightbulb/people_operations_lifecycle.py:1359`.

Fields:
- `schema_id: Literal['lightbulb.people_transition_result.v1'] = Field(default=PEOPLE_TRANSITION_RESULT_SCHEMA, alias='schema')`
- `proposal: PeopleTransitionProposal`
- `candidate_snapshot: PeopleOperationsSnapshot`
- `candidate_validated: Literal[True] = True`
- `authoritative_state_changed: Literal[False] = False`
- `provider_effect_executed: Literal[False] = False`
- `hosted_approval_task_created: Literal[False] = False`
- `spring_submission_executed: Literal[False] = False`
- `provider_receipt_verified_by_sdk: Literal[False] = False`

### `lightbulb.people_operations_lifecycle.PeopleOperationsLifecycleError`

class. Source: `lightbulb/people_operations_lifecycle.py:1398`.

### `lightbulb.people_operations_lifecycle.propose_people_operations_transition`

function. Source: `lightbulb/people_operations_lifecycle.py:2366`.



~~~python
propose_people_operations_transition(value: PeopleTransitionRequest | Mapping[str, Any]) -> PeopleTransitionResult
~~~


### `lightbulb.people_operations_lifecycle.ProposePeopleOperationsTransitionPrimitive`

class. Source: `lightbulb/people_operations_lifecycle.py:2716`.

Fields:
- `example_inputs: Mapping[str, Any] = _example_inputs()`

#### Methods

##### `lightbulb.people_operations_lifecycle.ProposePeopleOperationsTransitionPrimitive.implementation_contract`



~~~python
def implementation_contract() -> dict[str, Any]
~~~


Source: `lightbulb/people_operations_lifecycle.py:2737`.

## Module `lightbulb.primitive_preview`

Provider-free adapter over the Executable Primitive Runtime.

### `lightbulb.primitive_preview.PrimitivePreview`

class. Source: `lightbulb/primitive_preview.py:32`.

Fields:
- `result: PrimitiveExecutionResult[Any]`
- `connector_requests: tuple[ConnectorExecutionRequest, ...]`

### `lightbulb.primitive_preview.preview_executable_primitive`

function. Source: `lightbulb/primitive_preview.py:37`.



~~~python
preview_executable_primitive(*, primitive_ref: str, inputs: Mapping[str, Any] | BaseModel, scope: ExecutionScope, run_ref: str, source: str, registry: PrimitiveRegistry | None=None, outcome_recorder: RuntimeOutcomeRecorder | None=None) -> PrimitivePreview
~~~


Execute one primitive through the shared preview-only run profile.

## Module `lightbulb.primitive_runtime`

Executable business process primitive runtime for custom Lightbulb projects.

### `lightbulb.primitive_runtime.PrimitiveExecutionStatus`

class. Source: `lightbulb/primitive_runtime.py:68`.

### `lightbulb.primitive_runtime.PrimitiveRunMode`

class. Source: `lightbulb/primitive_runtime.py:77`.

### `lightbulb.primitive_runtime.PrimitiveEvidenceVerificationGrade`

class. Source: `lightbulb/primitive_runtime.py:82`.

### `lightbulb.primitive_runtime.PrimitiveEvidenceClassification`

class. Source: `lightbulb/primitive_runtime.py:89`.

### `lightbulb.primitive_runtime.PrimitiveOperationReplayClass`

class. Source: `lightbulb/primitive_runtime.py:96`.

### `lightbulb.primitive_runtime.PrimitiveOperationFreshnessClass`

class. Source: `lightbulb/primitive_runtime.py:102`.

### `lightbulb.primitive_runtime.PrimitiveOperationRecoveryPolicy`

class. Source: `lightbulb/primitive_runtime.py:108`.

### `lightbulb.primitive_runtime.PrimitiveOperationStatus`

class. Source: `lightbulb/primitive_runtime.py:116`.

### `lightbulb.primitive_runtime.PrimitiveRecoveryDisposition`

class. Source: `lightbulb/primitive_runtime.py:127`.

### `lightbulb.primitive_runtime.PrimitiveRecoveryOutcome`

class. Source: `lightbulb/primitive_runtime.py:136`.

### `lightbulb.primitive_runtime.PrimitiveEvent`

class. Source: `lightbulb/primitive_runtime.py:167`.

Fields:
- `type: str = Field(min_length=1, max_length=160)`
- `payload: Dict[str, Any] = Field(default_factory=dict)`

### `lightbulb.primitive_runtime.PrimitiveEvidence`

class. Source: `lightbulb/primitive_runtime.py:174`.

Fields:
- `kind: str = Field(min_length=1, max_length=80)`
- `summary: str = Field(min_length=1, max_length=500)`
- `labels: list[str] = Field(default_factory=list)`
- `refs: Dict[str, str] = Field(default_factory=dict)`

### `lightbulb.primitive_runtime.PrimitiveEvidenceRef`

class. Source: `lightbulb/primitive_runtime.py:183`.

Portable, content-bound reference to evidence retained outside a result.

Fields:
- `schema_id: Literal['lightbulb.primitive_evidence_ref.v1'] = Field(default=PRIMITIVE_EVIDENCE_REF_SCHEMA, alias='schema')`
- `evidence_ref: str = Field(min_length=1, max_length=200)`
- `kind: str = Field(min_length=1, max_length=80)`
- `issuer_ref: str = Field(min_length=1, max_length=200)`
- `subject_ref: str | None = Field(default=None, min_length=1, max_length=200)`
- `sha256: str = Field(pattern='^[0-9a-f]{64}$')`
- `observed_at: str`
- `effective_at: str | None = None`
- `verification_grade: PrimitiveEvidenceVerificationGrade`
- `classification: PrimitiveEvidenceClassification`
- `retention_policy: str | None = Field(default=None, min_length=1, max_length=160)`
- `jurisdiction: str | None = Field(default=None, min_length=2, max_length=80)`

### `lightbulb.primitive_runtime.PrimitiveBlocker`

class. Source: `lightbulb/primitive_runtime.py:224`.

Fields:
- `code: str = Field(min_length=1, max_length=120)`
- `message: str = Field(min_length=1, max_length=500)`
- `field: str | None = Field(default=None, max_length=200)`
- `retryable: bool = False`

### `lightbulb.primitive_runtime.PrimitiveRecoveryAttestation`

class. Source: `lightbulb/primitive_runtime.py:233`.

Evidence-bound resolution of an ambiguous operation outcome.

Fields:
- `schema_id: Literal['lightbulb.primitive_recovery_attestation.v1'] = Field(default=PRIMITIVE_RECOVERY_ATTESTATION_SCHEMA, alias='schema')`
- `request_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `operation_ref: str = Field(min_length=1, max_length=160)`
- `outcome: PrimitiveRecoveryOutcome`
- `replay_permitted: bool`
- `evidence_refs: list[PrimitiveEvidenceRef] = Field(min_length=1, max_length=20)`
- `attested_by_ref: str = Field(min_length=1, max_length=200)`
- `attested_at: str`
- `notes: str | None = Field(default=None, min_length=1, max_length=1000)`

### `lightbulb.primitive_runtime.PrimitiveOperationSpec`

class. Source: `lightbulb/primitive_runtime.py:297`.

Exact effect, replay, freshness, and recovery contract for one operation.

Fields:
- `schema_id: Literal['lightbulb.primitive_operation_spec.v1'] = Field(default=PRIMITIVE_OPERATION_SPEC_SCHEMA, alias='schema')`
- `operation_ref: str = Field(min_length=1, max_length=160)`
- `tool: str = Field(min_length=3, max_length=192)`
- `effect: ConnectorEffect`
- `approval_required: bool`
- `atomicity_group: str | None = Field(default=None, min_length=1, max_length=160)`
- `replay_class: PrimitiveOperationReplayClass`
- `freshness_class: PrimitiveOperationFreshnessClass`
- `recovery_policy: PrimitiveOperationRecoveryPolicy`

### `lightbulb.primitive_runtime.PrimitiveRecoveryPlan`

class. Source: `lightbulb/primitive_runtime.py:351`.

Bounded next action for an operation that did not reach a certain outcome.

Fields:
- `schema_id: Literal['lightbulb.primitive_recovery_plan.v1'] = Field(default=PRIMITIVE_RECOVERY_PLAN_SCHEMA, alias='schema')`
- `policy: PrimitiveOperationRecoveryPolicy`
- `disposition: PrimitiveRecoveryDisposition`
- `status_probe_tool: str | None = Field(default=None, min_length=3, max_length=192)`
- `compensation_operation_ref: str | None = Field(default=None, min_length=1, max_length=160)`
- `retry_at: str | None = None`
- `instructions: str | None = Field(default=None, min_length=1, max_length=1000)`

### `lightbulb.primitive_runtime.PrimitiveOperationReceipt`

class. Source: `lightbulb/primitive_runtime.py:426`.

Sanitized, replay-aware result for one exact primitive operation.

Fields:
- `schema_id: Literal['lightbulb.primitive_operation_receipt.v1'] = Field(default=PRIMITIVE_OPERATION_RECEIPT_SCHEMA, alias='schema')`
- `spec: PrimitiveOperationSpec`
- `status: PrimitiveOperationStatus`
- `request_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `approval_ref: str | None = Field(default=None, min_length=1, max_length=200)`
- `provenance_receipt_digest: str | None = Field(default=None, pattern='^[0-9a-f]{64}$')`
- `external_refs: Dict[str, str] = Field(default_factory=dict)`
- `evidence_refs: list[PrimitiveEvidenceRef] = Field(default_factory=list)`
- `attempt: int = Field(default=1, ge=1)`
- `replayed: bool = False`
- `recovery_disposition: PrimitiveRecoveryDisposition = PrimitiveRecoveryDisposition.NOT_REQUIRED`
- `recovery_plan: PrimitiveRecoveryPlan | None = None`
- `error: PrimitiveBlocker | None = None`

### `lightbulb.primitive_runtime.detach_model_boundary_value`

function. Source: `lightbulb/primitive_runtime.py:540`.



~~~python
detach_model_boundary_value(value: Any) -> Any
~~~


Serialize an arbitrary graph so nested Pydantic instances cannot bypass validation.

### `lightbulb.primitive_runtime.revalidate_model_boundary`

function. Source: `lightbulb/primitive_runtime.py:556`.



~~~python
revalidate_model_boundary(model_type: type[BoundaryModelT], value: BoundaryModelT | Mapping[str, Any]) -> BoundaryModelT
~~~


Detach and reconstruct a complete typed graph at a public SDK boundary.

### `lightbulb.primitive_runtime.PrimitiveExecutionResult`

class. Source: `lightbulb/primitive_runtime.py:565`.

Fields:
- `schema_id: str = Field(default=PRIMITIVE_EXECUTION_RESULT_SCHEMA, alias='schema')`
- `status: PrimitiveExecutionStatus`
- `primitive_ref: str`
- `primitive_version: str`
- `summary: str`
- `output: OutputT | None = None`
- `events: list[PrimitiveEvent] = Field(default_factory=list)`
- `evidence: list[PrimitiveEvidence] = Field(default_factory=list)`
- `evidence_refs: list[PrimitiveEvidenceRef] = Field(default_factory=list)`
- `operation_receipts: list[PrimitiveOperationReceipt] = Field(default_factory=list)`
- `recovery_plan: PrimitiveRecoveryPlan | None = None`
- `blockers: list[PrimitiveBlocker] = Field(default_factory=list)`
- `approval_ref: str | None = None`
- `approval_refs: Dict[str, str] = Field(default_factory=dict)`
- `connector_tool: str | None = None`
- `retryable: bool = False`

#### Methods

##### `lightbulb.primitive_runtime.PrimitiveExecutionResult.to_dict`



~~~python
def to_dict() -> Dict[str, Any]
~~~


Source: `lightbulb/primitive_runtime.py:627`.

##### `lightbulb.primitive_runtime.PrimitiveExecutionResult.unresolved_operation_receipts`



~~~python
def unresolved_operation_receipts() -> list[PrimitiveOperationReceipt]
~~~


Source: `lightbulb/primitive_runtime.py:613`.

### `lightbulb.primitive_runtime.PrimitiveExecutionContext`

class. Source: `lightbulb/primitive_runtime.py:635`.

Fields:
- `scope: ExecutionScope`
- `connectors: ConnectorExecutor`
- `preview_only: bool = True`
- `run_ref: str = field(default_factory=lambda: f'run-{uuid4()}')`
- `idempotency_key: str | None = None`
- `approval_refs: Mapping[str, str] = field(default_factory=dict)`
- `connector_account_refs: Mapping[str, str] = field(default_factory=dict)`
- `metadata: Mapping[str, Any] = field(default_factory=dict)`
- `event_sink: EventSink | None = None`
- `outcome_recorder: RuntimeOutcomeRecorder | None = None`
- `writes_require_approval: bool = True`
- `primitive_version: str | None = None`
- `step_id: str | None = None`
- `step_execution_ref: str | None = None`

#### Methods

##### `lightbulb.primitive_runtime.PrimitiveExecutionContext.approval_ref_for`



~~~python
def approval_ref_for(primitive_ref: str, *, operation_ref: str | None=None) -> str | None
~~~


Source: `lightbulb/primitive_runtime.py:651`.

##### `lightbulb.primitive_runtime.PrimitiveExecutionContext.connector_request`



~~~python
def connector_request(*, primitive_ref: str, tool: str, arguments: Mapping[str, Any], effect: ConnectorEffect, approval_required: bool, operation_ref: str | None=None, connector_account_ref: str | None=None, metadata: Mapping[str, Any] | None=None) -> ConnectorExecutionRequest
~~~


Source: `lightbulb/primitive_runtime.py:691`.

##### `lightbulb.primitive_runtime.PrimitiveExecutionContext.emit`



~~~python
def emit(events: Iterable[PrimitiveEvent]) -> None
~~~


Source: `lightbulb/primitive_runtime.py:763`.

##### `lightbulb.primitive_runtime.PrimitiveExecutionContext.step_context`



~~~python
def step_context(step_id: str, *, execution_ref: str | None=None) -> 'PrimitiveExecutionContext'
~~~


Source: `lightbulb/primitive_runtime.py:668`.

### `lightbulb.primitive_runtime.BusinessProcessPrimitive`

class. Source: `lightbulb/primitive_runtime.py:783`.

Fields:
- `primitive_ref: ClassVar[str]`
- `version: ClassVar[str] = '1.0.0'`
- `title: ClassVar[str]`
- `description: ClassVar[str] = ''`
- `input_model: ClassVar[type[BaseModel]]`
- `output_model: ClassVar[type[BaseModel]]`
- `connector_tools: ClassVar[tuple[str, ...]] = ()`
- `risk_level: ClassVar[str] = 'low'`
- `approval_required: ClassVar[bool] = False`
- `example_inputs: ClassVar[Mapping[str, Any]] = {}`
- `mcp_read_only: ClassVar[bool] = False`
- `mcp_destructive: ClassVar[bool] = True`
- `mcp_idempotent: ClassVar[bool] = False`
- `mcp_open_world: ClassVar[bool] = True`

#### Methods

##### `lightbulb.primitive_runtime.BusinessProcessPrimitive.execute`



~~~python
def execute(context: PrimitiveExecutionContext, inputs: InputT | Mapping[str, Any]) -> PrimitiveExecutionResult[OutputT]
~~~


Source: `lightbulb/primitive_runtime.py:799`.

##### `lightbulb.primitive_runtime.BusinessProcessPrimitive.implementation_contract`



~~~python
def implementation_contract() -> Dict[str, Any]
~~~


Source: `lightbulb/primitive_runtime.py:922`.

### `lightbulb.primitive_runtime.FunctionBusinessProcessPrimitive`

class. Source: `lightbulb/primitive_runtime.py:963`.

### `lightbulb.primitive_runtime.business_process_primitive`

function. Source: `lightbulb/primitive_runtime.py:1011`.



~~~python
business_process_primitive(*, primitive_ref: str, title: str, input_model: type[BaseModel], output_model: type[BaseModel], version: str='1.0.0', description: str='', connector_tools: Iterable[str]=(), risk_level: str='low', approval_required: bool=False) -> Callable[[PrimitiveHandler], FunctionBusinessProcessPrimitive]
~~~


Turn a typed function into a registry-ready custom primitive.

### `lightbulb.primitive_runtime.PrimitiveRegistry`

class. Source: `lightbulb/primitive_runtime.py:1042`.

#### Methods

##### `lightbulb.primitive_runtime.PrimitiveRegistry.catalog`



~~~python
def catalog() -> list[Dict[str, Any]]
~~~


Source: `lightbulb/primitive_runtime.py:1083`.

##### `lightbulb.primitive_runtime.PrimitiveRegistry.copy`



~~~python
def copy() -> 'PrimitiveRegistry'
~~~


Source: `lightbulb/primitive_runtime.py:1089`.

##### `lightbulb.primitive_runtime.PrimitiveRegistry.execute`



~~~python
def execute(primitive_ref: str, context: PrimitiveExecutionContext, inputs: Mapping[str, Any] | BaseModel) -> PrimitiveExecutionResult[Any]
~~~


Source: `lightbulb/primitive_runtime.py:1075`.

##### `lightbulb.primitive_runtime.PrimitiveRegistry.get`



~~~python
def get(primitive_ref: str) -> BusinessProcessPrimitive[Any, Any]
~~~


Source: `lightbulb/primitive_runtime.py:1063`.

##### `lightbulb.primitive_runtime.PrimitiveRegistry.register`



~~~python
def register(primitive: BusinessProcessPrimitive[Any, Any], *, replace_existing: bool=False) -> None
~~~


Source: `lightbulb/primitive_runtime.py:1050`.

##### `lightbulb.primitive_runtime.PrimitiveRegistry.supports`



~~~python
def supports(primitive_ref: str) -> bool
~~~


Source: `lightbulb/primitive_runtime.py:1072`.

### `lightbulb.primitive_runtime.PrimitiveCall`

class. Source: `lightbulb/primitive_runtime.py:1094`.

One typed request inside an opened Primitive Run Session.

Fields:
- `primitive_ref: str`
- `inputs: Mapping[str, Any] | BaseModel`
- `step_id: str | None = None`
- `execution_ref: str | None = None`

### `lightbulb.primitive_runtime.PrimitiveCorrelation`

class. Source: `lightbulb/primitive_runtime.py:1104`.

Governed, non-payload correlation fields emitted with runtime outcomes.

Fields:
- `source: str = 'lightbulb_sdk'`
- `workflow_key: str | None = None`

### `lightbulb.primitive_runtime.StandalonePrimitiveRun`

class. Source: `lightbulb/primitive_runtime.py:1112`.

Semantic profile for a primitive that is not owned by a Project Runtime.

Fields:
- `scope: ExecutionScope`
- `run_ref: str`
- `mode: PrimitiveRunMode = PrimitiveRunMode.PREVIEW`
- `approval_refs: Mapping[str, str] = field(default_factory=dict)`
- `connector_account_refs: Mapping[str, str] = field(default_factory=dict)`
- `correlation: PrimitiveCorrelation = field(default_factory=PrimitiveCorrelation)`
- `idempotency_key: str | None = None`

### `lightbulb.primitive_runtime.ProjectPrimitiveRun`

class. Source: `lightbulb/primitive_runtime.py:1125`.

Semantic profile whose capabilities and policy come from a Lightbulb Project.

Fields:
- `project: 'LightbulbProject'`
- `scope: ExecutionScope`
- `run_ref: str`
- `mode: PrimitiveRunMode | None = None`
- `approval_refs: Mapping[str, str] = field(default_factory=dict)`
- `connector_account_refs: Mapping[str, str] = field(default_factory=dict)`
- `correlation: PrimitiveCorrelation = field(default_factory=PrimitiveCorrelation)`
- `idempotency_key: str | None = None`

### `lightbulb.primitive_runtime.PrimitiveRunSession`

class. Source: `lightbulb/primitive_runtime.py:1192`.

Deep execution interface for every call in one immutable scoped run.

#### Methods

##### `lightbulb.primitive_runtime.PrimitiveRunSession.events`



~~~python
@property
def events() -> tuple[PrimitiveEvent, ...]
~~~


Source: `lightbulb/primitive_runtime.py:1205`.

##### `lightbulb.primitive_runtime.PrimitiveRunSession.execute`



~~~python
def execute(call: PrimitiveCall) -> PrimitiveExecutionResult[Any]
~~~


Source: `lightbulb/primitive_runtime.py:1208`.

### `lightbulb.primitive_runtime.ExecutablePrimitiveRuntime`

class. Source: `lightbulb/primitive_runtime.py:1329`.

Open governed Primitive Run Sessions over stable runtime dependencies.

#### Methods

##### `lightbulb.primitive_runtime.ExecutablePrimitiveRuntime.open`



~~~python
def open(run: StandalonePrimitiveRun | ProjectPrimitiveRun) -> PrimitiveRunSession
~~~


Source: `lightbulb/primitive_runtime.py:1345`.

## Module `lightbulb.procure_to_pay_lifecycle`

Deterministic, Spring-authoritative procure-to-pay lifecycle contracts.

### `lightbulb.procure_to_pay_lifecycle.ProcureToPayScope`

class. Source: `lightbulb/procure_to_pay_lifecycle.py:246`.

Exact authenticated scope that Spring must derive, never a policy grant.

Fields:
- `schema_id: Literal['lightbulb.procure_to_pay_scope.v1'] = Field(default=PROCURE_TO_PAY_SCOPE_SCHEMA, alias='schema')`
- `tenant_ref: OpaqueRef`
- `company_ref: OpaqueRef`
- `project_ref: OpaqueRef`
- `project_id: UUID`
- `account_ref: OpaqueRef`

#### Methods

##### `lightbulb.procure_to_pay_lifecycle.ProcureToPayScope.scope_digest`



~~~python
@property
def scope_digest() -> str
~~~


Source: `lightbulb/procure_to_pay_lifecycle.py:270`.

### `lightbulb.procure_to_pay_lifecycle.RequisitionLine`

class. Source: `lightbulb/procure_to_pay_lifecycle.py:274`.

Fields:
- `line_ref: OpaqueRef`
- `item_ref: OpaqueRef`
- `description: ShortText`
- `quantity_requested: Decimal = Field(gt=0)`
- `unit_of_measure: UnitCode`
- `estimated_unit_price: Decimal = Field(ge=0)`
- `line_total: Decimal = Field(ge=0)`
- `cost_center_ref: OpaqueRef`

### `lightbulb.procure_to_pay_lifecycle.PurchaseRequisition`

class. Source: `lightbulb/procure_to_pay_lifecycle.py:305`.

Fields:
- `requisition_ref: OpaqueRef`
- `status: Literal['draft', 'submitted', 'approved']`
- `currency: CurrencyCode`
- `vendor_ref: OpaqueRef`
- `budget_ref: OpaqueRef`
- `budget_amount: Decimal = Field(gt=0)`
- `total_amount: Decimal = Field(gt=0)`
- `lines: tuple[RequisitionLine, ...] = Field(min_length=1, max_length=_MAX_LINES)`

### `lightbulb.procure_to_pay_lifecycle.PurchaseOrderLine`

class. Source: `lightbulb/procure_to_pay_lifecycle.py:339`.

Fields:
- `line_ref: OpaqueRef`
- `requisition_line_ref: OpaqueRef`
- `item_ref: OpaqueRef`
- `quantity_ordered: Decimal = Field(gt=0)`
- `unit_of_measure: UnitCode`
- `unit_price: Decimal = Field(ge=0)`
- `line_total: Decimal = Field(ge=0)`

### `lightbulb.procure_to_pay_lifecycle.PurchaseOrder`

class. Source: `lightbulb/procure_to_pay_lifecycle.py:367`.

Fields:
- `purchase_order_ref: OpaqueRef`
- `requisition_ref: OpaqueRef`
- `vendor_ref: OpaqueRef`
- `status: Literal['draft', 'issued', 'partially_received', 'received', 'matched', 'match_exception', 'closed']`
- `currency: CurrencyCode`
- `total_amount: Decimal = Field(gt=0)`
- `issued_at: str | None = None`
- `lines: tuple[PurchaseOrderLine, ...] = Field(min_length=1, max_length=_MAX_LINES)`

### `lightbulb.procure_to_pay_lifecycle.GoodsReceiptLine`

class. Source: `lightbulb/procure_to_pay_lifecycle.py:421`.

Fields:
- `line_ref: OpaqueRef`
- `purchase_order_line_ref: OpaqueRef`
- `item_ref: OpaqueRef`
- `quantity_received: Decimal = Field(gt=0)`
- `quantity_accepted: Decimal = Field(ge=0)`
- `quantity_rejected: Decimal = Field(ge=0)`
- `unit_of_measure: UnitCode`

### `lightbulb.procure_to_pay_lifecycle.GoodsReceipt`

class. Source: `lightbulb/procure_to_pay_lifecycle.py:449`.

Fields:
- `goods_receipt_ref: OpaqueRef`
- `purchase_order_ref: OpaqueRef`
- `vendor_ref: OpaqueRef`
- `receiving_location_ref: OpaqueRef`
- `received_at: str`
- `lines: tuple[GoodsReceiptLine, ...] = Field(min_length=1, max_length=_MAX_LINES)`

### `lightbulb.procure_to_pay_lifecycle.SupplierInvoiceLine`

class. Source: `lightbulb/procure_to_pay_lifecycle.py:477`.

Fields:
- `line_ref: OpaqueRef`
- `purchase_order_line_ref: OpaqueRef`
- `item_ref: OpaqueRef`
- `quantity_invoiced: Decimal = Field(gt=0)`
- `unit_of_measure: UnitCode`
- `unit_price: Decimal = Field(ge=0)`
- `line_total: Decimal = Field(ge=0)`

### `lightbulb.procure_to_pay_lifecycle.SupplierInvoice`

class. Source: `lightbulb/procure_to_pay_lifecycle.py:505`.

Fields:
- `supplier_invoice_ref: OpaqueRef`
- `invoice_number: ShortText`
- `purchase_order_ref: OpaqueRef`
- `vendor_ref: OpaqueRef`
- `currency: CurrencyCode`
- `invoice_date: str`
- `duplicate_check: Literal['clear', 'possible_duplicate', 'confirmed_duplicate']`
- `subtotal: Decimal = Field(ge=0)`
- `tax_total: Decimal = Field(ge=0)`
- `total: Decimal = Field(gt=0)`
- `lines: tuple[SupplierInvoiceLine, ...] = Field(min_length=1, max_length=_MAX_LINES)`

### `lightbulb.procure_to_pay_lifecycle.ThreeWayMatchPolicy`

class. Source: `lightbulb/procure_to_pay_lifecycle.py:548`.

Fields:
- `quantity_tolerance: Decimal = Decimal('0.000000')`
- `unit_price_tolerance: Decimal = Decimal('0.00')`
- `subtotal_tolerance: Decimal = Decimal('0.00')`

### `lightbulb.procure_to_pay_lifecycle.ThreeWayMatchFinding`

class. Source: `lightbulb/procure_to_pay_lifecycle.py:564`.

Fields:
- `code: OpaqueRef`
- `message: ShortText`
- `purchase_order_line_ref: OpaqueRef | None = None`

### `lightbulb.procure_to_pay_lifecycle.ThreeWayMatchResult`

class. Source: `lightbulb/procure_to_pay_lifecycle.py:570`.

Fields:
- `match_ref: OpaqueRef`
- `disposition: Literal['matched', 'exception']`
- `purchase_order_ref: OpaqueRef`
- `supplier_invoice_ref: OpaqueRef`
- `evaluated_at: str`
- `accepted_quantity_total: Decimal = Field(ge=0)`
- `invoiced_quantity_total: Decimal = Field(ge=0)`
- `expected_subtotal: Decimal = Field(ge=0)`
- `invoice_subtotal: Decimal = Field(ge=0)`
- `policy: ThreeWayMatchPolicy`
- `findings: tuple[ThreeWayMatchFinding, ...] = Field(max_length=_MAX_FINDINGS)`
- `evaluation_digest: Sha256Digest`

### `lightbulb.procure_to_pay_lifecycle.ExceptionResolution`

class. Source: `lightbulb/procure_to_pay_lifecycle.py:620`.

Fields:
- `resolution_ref: OpaqueRef`
- `disposition: Literal['approve_override', 'cancel_and_close']`
- `rationale: ShortText`
- `resolved_at: str`

### `lightbulb.procure_to_pay_lifecycle.ProcureToPayClosure`

class. Source: `lightbulb/procure_to_pay_lifecycle.py:632`.

Fields:
- `closure_ref: OpaqueRef`
- `closed_at: str`

### `lightbulb.procure_to_pay_lifecycle.ProcureToPayTransitionRecord`

class. Source: `lightbulb/procure_to_pay_lifecycle.py:656`.

Fields:
- `transition_index: int = Field(ge=1, le=_MAX_TRANSITIONS)`
- `operation: OpaqueRef`
- `idempotency_key: OpaqueRef`
- `intent_digest: Sha256Digest`
- `proposal_digest: Sha256Digest`
- `requested_by_ref: OpaqueRef`
- `authority_ref: OpaqueRef`
- `approved_by_ref: OpaqueRef`
- `approval_ref: OpaqueRef`
- `approval_receipt_digest: Sha256Digest`
- `authority_receipt_digest: Sha256Digest`
- `supporting_evidence_digest: Sha256Digest`
- `authority_evidence_digest: Sha256Digest`
- `committed_at: str`

### `lightbulb.procure_to_pay_lifecycle.ProcureToPayLifecycle`

class. Source: `lightbulb/procure_to_pay_lifecycle.py:678`.

Fields:
- `schema_id: Literal['lightbulb.procure_to_pay_lifecycle.v1'] = Field(default=PROCURE_TO_PAY_LIFECYCLE_SCHEMA, alias='schema')`
- `lifecycle_ref: OpaqueRef`
- `revision: int = Field(ge=1, le=_MAX_TRANSITIONS)`
- `scope: ProcureToPayScope`
- `state: ProcureToPayState`
- `requisition: PurchaseRequisition`
- `purchase_order: PurchaseOrder | None = None`
- `goods_receipts: tuple[GoodsReceipt, ...] = Field(default_factory=tuple, max_length=_MAX_RECEIPTS)`
- `supplier_invoice: SupplierInvoice | None = None`
- `three_way_match: ThreeWayMatchResult | None = None`
- `exception_resolution: ExceptionResolution | None = None`
- `closure: ProcureToPayClosure | None = None`
- `updated_at: str`
- `transition_history: tuple[ProcureToPayTransitionRecord, ...] = Field(min_length=1, max_length=_MAX_TRANSITIONS)`
- `domain_digest: Sha256Digest`
- `state_digest: Sha256Digest`

### `lightbulb.procure_to_pay_lifecycle.CreateRequisitionCommand`

class. Source: `lightbulb/procure_to_pay_lifecycle.py:1006`.

Fields:
- `kind: Literal['create_requisition'] = 'create_requisition'`
- `requisition: PurchaseRequisition`

### `lightbulb.procure_to_pay_lifecycle.SubmitRequisitionCommand`

class. Source: `lightbulb/procure_to_pay_lifecycle.py:1017`.

Fields:
- `kind: Literal['submit_requisition'] = 'submit_requisition'`

### `lightbulb.procure_to_pay_lifecycle.ApproveRequisitionCommand`

class. Source: `lightbulb/procure_to_pay_lifecycle.py:1021`.

Fields:
- `kind: Literal['approve_requisition'] = 'approve_requisition'`

### `lightbulb.procure_to_pay_lifecycle.CreatePurchaseOrderCommand`

class. Source: `lightbulb/procure_to_pay_lifecycle.py:1025`.

Fields:
- `kind: Literal['create_purchase_order'] = 'create_purchase_order'`
- `purchase_order: PurchaseOrder`

### `lightbulb.procure_to_pay_lifecycle.IssuePurchaseOrderCommand`

class. Source: `lightbulb/procure_to_pay_lifecycle.py:1036`.

Fields:
- `kind: Literal['issue_purchase_order'] = 'issue_purchase_order'`
- `issued_at: str`

### `lightbulb.procure_to_pay_lifecycle.RecordGoodsReceiptCommand`

class. Source: `lightbulb/procure_to_pay_lifecycle.py:1046`.

Fields:
- `kind: Literal['record_goods_receipt'] = 'record_goods_receipt'`
- `goods_receipt: GoodsReceipt`

### `lightbulb.procure_to_pay_lifecycle.EvaluateThreeWayMatchCommand`

class. Source: `lightbulb/procure_to_pay_lifecycle.py:1051`.

Fields:
- `kind: Literal['evaluate_three_way_match'] = 'evaluate_three_way_match'`
- `match_ref: OpaqueRef`
- `supplier_invoice: SupplierInvoice`
- `policy: ThreeWayMatchPolicy = Field(default_factory=ThreeWayMatchPolicy)`

### `lightbulb.procure_to_pay_lifecycle.ResolveMatchExceptionCommand`

class. Source: `lightbulb/procure_to_pay_lifecycle.py:1058`.

Fields:
- `kind: Literal['resolve_match_exception'] = 'resolve_match_exception'`
- `resolution: ExceptionResolution`

### `lightbulb.procure_to_pay_lifecycle.CloseProcureToPayCommand`

class. Source: `lightbulb/procure_to_pay_lifecycle.py:1063`.

Fields:
- `kind: Literal['close'] = 'close'`
- `closed_at: str`
- `closure_ref: OpaqueRef`

### `lightbulb.procure_to_pay_lifecycle.ProcureToPayTransitionRequest`

class. Source: `lightbulb/procure_to_pay_lifecycle.py:1090`.

Fields:
- `schema_id: Literal['lightbulb.procure_to_pay_transition_request.v1'] = Field(default=PROCURE_TO_PAY_TRANSITION_REQUEST_SCHEMA, alias='schema')`
- `scope: ProcureToPayScope`
- `lifecycle_ref: OpaqueRef`
- `expected_revision: int = Field(ge=0, le=_MAX_TRANSITIONS - 1)`
- `expected_state_digest: Sha256Digest`
- `idempotency_key: OpaqueRef`
- `requested_by_ref: OpaqueRef`
- `proposed_at: str`
- `command: TransitionCommand`
- `current: ProcureToPayLifecycle | None = None`
- `evidence_refs: tuple[PrimitiveEvidenceRef, ...] = Field(min_length=1, max_length=_MAX_EVIDENCE_REFS)`

### `lightbulb.procure_to_pay_lifecycle.ProcureToPayTransitionProposal`

class. Source: `lightbulb/procure_to_pay_lifecycle.py:1199`.

Fields:
- `schema_id: Literal['lightbulb.procure_to_pay_transition_proposal.v1'] = Field(default=PROCURE_TO_PAY_TRANSITION_PROPOSAL_SCHEMA, alias='schema')`
- `request: ProcureToPayTransitionRequest`
- `operation_spec: PrimitiveOperationSpec`
- `scope_digest: Sha256Digest`
- `intent_digest: Sha256Digest`
- `supporting_evidence_digest: Sha256Digest`
- `target_revision: int = Field(ge=1, le=_MAX_TRANSITIONS)`
- `target_state: ProcureToPayState`
- `target_domain_digest: Sha256Digest`
- `execution_boundary: Literal['spring_control_plane'] = 'spring_control_plane'`
- `approval_required: Literal[True] = True`
- `connector_reads: Literal[0] = 0`
- `connector_writes: Literal[0] = 0`
- `provider_execution_claimed: Literal[False] = False`
- `proposal_digest: Sha256Digest`

### `lightbulb.procure_to_pay_lifecycle.ProcureToPayProposalResult`

class. Source: `lightbulb/procure_to_pay_lifecycle.py:1243`.

Fields:
- `schema_id: Literal['lightbulb.procure_to_pay_proposal_result.v1'] = Field(default=PROCURE_TO_PAY_PROPOSAL_RESULT_SCHEMA, alias='schema')`
- `proposal: ProcureToPayTransitionProposal`
- `operation_receipt: PrimitiveOperationReceipt`
- `state_changed: Literal[False] = False`

### `lightbulb.procure_to_pay_lifecycle.spring_authority_binding_digest`

function. Source: `lightbulb/procure_to_pay_lifecycle.py:1286`.



~~~python
spring_authority_binding_digest(*, proposal: ProcureToPayTransitionProposal, outcome: AuthorityOutcome, authority_ref: str, committed_at: str, approval_ref: str | None, approved_by_ref: str | None, approval_receipt_digest: str | None, reason_code: str | None) -> str
~~~


Digest the exact Spring decision fields carried by commit evidence.

### `lightbulb.procure_to_pay_lifecycle.SpringProcureToPayTransitionEvidence`

class. Source: `lightbulb/procure_to_pay_lifecycle.py:1322`.

Fields:
- `schema_id: Literal['lightbulb.spring_procure_to_pay_transition_evidence.v1'] = Field(default=SPRING_TRANSITION_EVIDENCE_SCHEMA, alias='schema')`
- `proposal: ProcureToPayTransitionProposal`
- `outcome: AuthorityOutcome`
- `authority_ref: OpaqueRef`
- `lifecycle_ref: OpaqueRef`
- `scope_digest: Sha256Digest`
- `current_state_digest: Sha256Digest`
- `idempotency_key: OpaqueRef`
- `target_domain_digest: Sha256Digest`
- `authority_receipt_digest: Sha256Digest`
- `authority_evidence_digest: Sha256Digest`
- `committed_at: str`
- `approval_ref: OpaqueRef | None = None`
- `approved_by_ref: OpaqueRef | None = None`
- `approval_receipt_digest: Sha256Digest | None = None`
- `reason_code: OpaqueRef | None = None`
- `evidence_refs: tuple[PrimitiveEvidenceRef, ...] = Field(min_length=1, max_length=_MAX_EVIDENCE_REFS)`

### `lightbulb.procure_to_pay_lifecycle.ProcureToPayTransitionValidationResult`

class. Source: `lightbulb/procure_to_pay_lifecycle.py:1493`.

Structural validation output; never proof that Spring persisted a change.

Fields:
- `schema_id: Literal['lightbulb.procure_to_pay_transition_validation_result.v1'] = Field(default=PROCURE_TO_PAY_TRANSITION_VALIDATION_RESULT_SCHEMA, alias='schema')`
- `status: Literal['candidate_validated', 'in_doubt', 'rejected']`
- `proposal_digest: Sha256Digest`
- `operation_spec: PrimitiveOperationSpec`
- `current_lifecycle: ProcureToPayLifecycle | None = None`
- `candidate_lifecycle: ProcureToPayLifecycle | None = None`
- `operation_receipt: PrimitiveOperationReceipt`
- `recovery_plan: PrimitiveRecoveryPlan | None = None`
- `state_changed: Literal[False] = False`
- `authoritative_persistence_claimed: Literal[False] = False`
- `automatic_retry_allowed: Literal[False] = False`
- `connector_writes: Literal[0] = 0`
- `provider_execution_claimed: Literal[False] = False`

### `lightbulb.procure_to_pay_lifecycle.ProcureToPayLifecycleError`

class. Source: `lightbulb/procure_to_pay_lifecycle.py:1539`.

Fail-closed lifecycle error with a stable machine-readable code.

### `lightbulb.procure_to_pay_lifecycle.propose_transition`

function. Source: `lightbulb/procure_to_pay_lifecycle.py:2097`.



~~~python
propose_transition(request: ProcureToPayTransitionRequest | dict[str, Any]) -> ProcureToPayProposalResult
~~~


Build a deterministic approval proposal without changing state or connectors.

### `lightbulb.procure_to_pay_lifecycle.validate_transition_evidence`

function. Source: `lightbulb/procure_to_pay_lifecycle.py:2184`.



~~~python
validate_transition_evidence(evidence: SpringProcureToPayTransitionEvidence | dict[str, Any], *, live_current: ProcureToPayLifecycle | None) -> ProcureToPayTransitionValidationResult
~~~


Validate evidence and return a non-authoritative lifecycle candidate.

### `lightbulb.procure_to_pay_lifecycle.ProposeProcureToPayTransitionPrimitive`

class. Source: `lightbulb/procure_to_pay_lifecycle.py:2413`.

Executable proposal wrapper with no connector or persistence authority.

Fields:
- `example_inputs: Mapping[str, Any] = _procure_to_pay_example_inputs()`

#### Methods

##### `lightbulb.procure_to_pay_lifecycle.ProposeProcureToPayTransitionPrimitive.implementation_contract`



~~~python
def implementation_contract() -> dict[str, Any]
~~~


Source: `lightbulb/procure_to_pay_lifecycle.py:2439`.

## Module `lightbulb.procurement_controls`

Deterministic, evidence-bound purchase-to-pay control evaluation.

### `lightbulb.procurement_controls.procurement_snapshot_digest`

function. Source: `lightbulb/procurement_controls.py:216`.



~~~python
procurement_snapshot_digest(snapshot: BaseModel | Mapping[str, Any]) -> str
~~~


Return the canonical digest of one normalized procurement snapshot.

### `lightbulb.procurement_controls.ProcurementMaterialTraceRef`

class. Source: `lightbulb/procurement_controls.py:234`.

Fields:
- `kind: TraceKind`
- `trace_ref: OpaqueRef`

### `lightbulb.procurement_controls.VendorQualificationSnapshot`

class. Source: `lightbulb/procurement_controls.py:239`.

Fields:
- `schema_id: Literal['lightbulb.vendor_qualification_snapshot.v1'] = Field(default=VENDOR_QUALIFICATION_SNAPSHOT_SCHEMA, alias='schema')`
- `vendor_ref: OpaqueRef`
- `status: VendorQualificationStatus`
- `policy_ref: OpaqueRef`
- `qualified_at: str | None = None`
- `valid_until: str | None = None`
- `evidence_refs: tuple[PrimitiveEvidenceRef, ...] = Field(min_length=1, max_length=20)`

### `lightbulb.procurement_controls.PurchaseRequisitionLine`

class. Source: `lightbulb/procurement_controls.py:283`.

Fields:
- `line_ref: OpaqueRef`
- `item_ref: OpaqueRef`
- `description: ShortText | None = None`
- `quantity_requested: Decimal = Field(gt=0)`
- `unit_of_measure: UnitCode`
- `estimated_unit_price: Decimal | None = Field(default=None, ge=0)`

### `lightbulb.procurement_controls.PurchaseRequisitionSnapshot`

class. Source: `lightbulb/procurement_controls.py:302`.

Fields:
- `schema_id: Literal['lightbulb.purchase_requisition_snapshot.v1'] = Field(default=PURCHASE_REQUISITION_SNAPSHOT_SCHEMA, alias='schema')`
- `requisition_ref: OpaqueRef`
- `revision: int = Field(ge=1)`
- `status: PurchaseRequisitionStatus`
- `currency: CurrencyCode`
- `approved_budget_amount: Decimal = Field(gt=0)`
- `vendor_ref: OpaqueRef | None = None`
- `approval_ref: OpaqueRef | None = None`
- `approved_at: str | None = None`
- `lines: tuple[PurchaseRequisitionLine, ...] = Field(min_length=1, max_length=1000)`
- `evidence_refs: tuple[PrimitiveEvidenceRef, ...] = Field(min_length=1, max_length=20)`

### `lightbulb.procurement_controls.PurchaseOrderLine`

class. Source: `lightbulb/procurement_controls.py:353`.

Fields:
- `line_ref: OpaqueRef`
- `requisition_line_ref: OpaqueRef`
- `item_ref: OpaqueRef`
- `description: ShortText | None = None`
- `quantity_ordered: Decimal = Field(gt=0)`
- `unit_of_measure: UnitCode`
- `unit_price: Decimal = Field(ge=0)`

### `lightbulb.procurement_controls.PurchaseOrderSnapshot`

class. Source: `lightbulb/procurement_controls.py:373`.

Fields:
- `schema_id: Literal['lightbulb.purchase_order_snapshot.v1'] = Field(default=PURCHASE_ORDER_SNAPSHOT_SCHEMA, alias='schema')`
- `purchase_order_ref: OpaqueRef`
- `revision: int = Field(ge=1)`
- `requisition_ref: OpaqueRef`
- `vendor_ref: OpaqueRef`
- `status: PurchaseOrderStatus`
- `currency: CurrencyCode`
- `issued_at: str | None = None`
- `approval_ref: OpaqueRef | None = None`
- `lines: tuple[PurchaseOrderLine, ...] = Field(min_length=1, max_length=1000)`
- `evidence_refs: tuple[PrimitiveEvidenceRef, ...] = Field(min_length=1, max_length=20)`

### `lightbulb.procurement_controls.GoodsReceiptLine`

class. Source: `lightbulb/procurement_controls.py:421`.

Fields:
- `line_ref: OpaqueRef`
- `purchase_order_line_ref: OpaqueRef`
- `item_ref: OpaqueRef`
- `quantity_received: Decimal = Field(gt=0)`
- `quantity_accepted: Decimal = Field(ge=0)`
- `quantity_rejected: Decimal = Field(default=Decimal('0'), ge=0)`
- `unit_of_measure: UnitCode`
- `trace_refs: tuple[ProcurementMaterialTraceRef, ...] = Field(default_factory=tuple, max_length=1000)`

### `lightbulb.procurement_controls.GoodsReceiptSnapshot`

class. Source: `lightbulb/procurement_controls.py:459`.

Fields:
- `schema_id: Literal['lightbulb.goods_receipt_snapshot.v1'] = Field(default=GOODS_RECEIPT_SNAPSHOT_SCHEMA, alias='schema')`
- `goods_receipt_ref: OpaqueRef`
- `revision: int = Field(ge=1)`
- `purchase_order_ref: OpaqueRef`
- `vendor_ref: OpaqueRef`
- `status: GoodsReceiptStatus`
- `received_at: str`
- `receiving_location_ref: OpaqueRef`
- `lines: tuple[GoodsReceiptLine, ...] = Field(min_length=1, max_length=1000)`
- `evidence_refs: tuple[PrimitiveEvidenceRef, ...] = Field(min_length=1, max_length=20)`

### `lightbulb.procurement_controls.SupplierInvoiceLine`

class. Source: `lightbulb/procurement_controls.py:493`.

Fields:
- `line_ref: OpaqueRef`
- `purchase_order_line_ref: OpaqueRef`
- `item_ref: OpaqueRef`
- `quantity_invoiced: Decimal = Field(gt=0)`
- `unit_of_measure: UnitCode`
- `unit_price: Decimal = Field(ge=0)`
- `line_total: Decimal = Field(ge=0)`

### `lightbulb.procurement_controls.SupplierInvoiceSnapshot`

class. Source: `lightbulb/procurement_controls.py:513`.

Fields:
- `schema_id: Literal['lightbulb.supplier_invoice_snapshot.v1'] = Field(default=SUPPLIER_INVOICE_SNAPSHOT_SCHEMA, alias='schema')`
- `supplier_invoice_ref: OpaqueRef`
- `revision: int = Field(ge=1)`
- `invoice_number: ShortText`
- `vendor_ref: OpaqueRef`
- `purchase_order_ref: OpaqueRef`
- `status: SupplierInvoiceStatus`
- `duplicate_check: InvoiceDuplicateCheck`
- `currency: CurrencyCode`
- `invoice_date: str`
- `due_at: str | None = None`
- `subtotal: Decimal = Field(ge=0)`
- `tax_total: Decimal = Field(default=Decimal('0'), ge=0)`
- `total: Decimal = Field(ge=0)`
- `lines: tuple[SupplierInvoiceLine, ...] = Field(min_length=1, max_length=1000)`
- `evidence_refs: tuple[PrimitiveEvidenceRef, ...] = Field(min_length=1, max_length=20)`

### `lightbulb.procurement_controls.PurchaseToPayControlPolicy`

class. Source: `lightbulb/procurement_controls.py:564`.

Fields:
- `minimum_evidence_grade: PrimitiveEvidenceVerificationGrade = PrimitiveEvidenceVerificationGrade.ATTESTED`
- `max_evidence_age_hours: int = Field(default=168, ge=1, le=8760)`
- `quantity_tolerance_ratio: Decimal = Field(default=Decimal('0'), ge=0, le=1)`
- `unit_price_tolerance_ratio: Decimal = Field(default=Decimal('0.02'), ge=0, le=1)`
- `line_total_tolerance_ratio: Decimal = Field(default=Decimal('0.02'), ge=0, le=1)`
- `document_total_tolerance_ratio: Decimal = Field(default=Decimal('0.02'), ge=0, le=1)`
- `absolute_amount_tolerance: Decimal = Field(default=Decimal('0.01'), ge=0)`
- `allowed_over_receipt_ratio: Decimal = Field(default=Decimal('0'), ge=0, le=1)`
- `require_full_order_receipt: bool = False`

### `lightbulb.procurement_controls.PurchaseToPayControlsInput`

class. Source: `lightbulb/procurement_controls.py:602`.

Fields:
- `schema_id: Literal['lightbulb.purchase_to_pay_controls_input.v1'] = Field(default=PURCHASE_TO_PAY_CONTROLS_INPUT_SCHEMA, alias='schema')`
- `control_ref: OpaqueRef`
- `analysis_as_of: str`
- `vendor: VendorQualificationSnapshot`
- `requisition: PurchaseRequisitionSnapshot`
- `purchase_order: PurchaseOrderSnapshot`
- `goods_receipts: tuple[GoodsReceiptSnapshot, ...] = Field(max_length=100)`
- `supplier_invoice: SupplierInvoiceSnapshot`
- `policy: PurchaseToPayControlPolicy = Field(default_factory=PurchaseToPayControlPolicy)`

### `lightbulb.procurement_controls.PurchaseToPayFinding`

class. Source: `lightbulb/procurement_controls.py:680`.

Fields:
- `code: OpaqueRef`
- `gate: ControlGate`
- `severity: ControlSeverity`
- `message: Annotated[str, StringConstraints(min_length=1, max_length=500)]`
- `document_ref: OpaqueRef | None = None`
- `line_ref: OpaqueRef | None = None`

### `lightbulb.procurement_controls.PurchaseToPayGateResult`

class. Source: `lightbulb/procurement_controls.py:689`.

Fields:
- `gate: ControlGate`
- `status: ControlGateStatus`
- `finding_codes: tuple[OpaqueRef, ...] = Field(default_factory=tuple, max_length=100)`

### `lightbulb.procurement_controls.PurchaseToPayLineResult`

class. Source: `lightbulb/procurement_controls.py:700`.

Fields:
- `purchase_order_line_ref: OpaqueRef`
- `requisition_line_ref: OpaqueRef`
- `item_ref: OpaqueRef`
- `unit_of_measure: UnitCode`
- `quantity_ordered: Decimal = Field(ge=0)`
- `quantity_accepted: Decimal = Field(ge=0)`
- `quantity_invoiced: Decimal = Field(ge=0)`
- `receipt_evidence_present: bool`
- `purchase_order_unit_price: Decimal = Field(ge=0)`
- `invoice_unit_price: Decimal | None = Field(default=None, ge=0)`
- `expected_invoice_line_total: Decimal = Field(ge=0)`
- `actual_invoice_line_total: Decimal = Field(ge=0)`
- `price_variance_ratio: Decimal | None = Field(default=None, ge=0)`
- `total_variance_ratio: Decimal | None = Field(default=None, ge=0)`
- `accepted_goods_receipt_refs: tuple[OpaqueRef, ...] = Field(default_factory=tuple, max_length=100)`
- `trace_refs: tuple[ProcurementMaterialTraceRef, ...] = Field(default_factory=tuple, max_length=1000)`
- `status: PurchaseToPayLineStatus`
- `finding_codes: tuple[OpaqueRef, ...] = Field(default_factory=tuple, max_length=100)`

### `lightbulb.procurement_controls.ProcurementEffectBoundary`

class. Source: `lightbulb/procurement_controls.py:748`.

Fields:
- `connector_reads: Literal[0] = 0`
- `connector_writes: Literal[0] = 0`
- `approvals_consumed: Literal[0] = 0`
- `payment_authorized: Literal[False] = False`
- `inventory_changed: Literal[False] = False`
- `external_systems_changed: Literal[False] = False`

### `lightbulb.procurement_controls.PurchaseToPayControlsResult`

class. Source: `lightbulb/procurement_controls.py:768`.

Fields:
- `schema_id: Literal['lightbulb.purchase_to_pay_controls_result.v1'] = Field(default=PURCHASE_TO_PAY_CONTROLS_RESULT_SCHEMA, alias='schema')`
- `control_ref: OpaqueRef`
- `analysis_as_of: str`
- `assurance_grade: PrimitiveEvidenceVerificationGrade`
- `proposed_disposition: PurchaseToPayDisposition`
- `payment_authorized: Literal[False] = False`
- `gates: tuple[PurchaseToPayGateResult, ...]`
- `line_results: tuple[PurchaseToPayLineResult, ...]`
- `findings: tuple[PurchaseToPayFinding, ...]`
- `purchase_order_total: Decimal = Field(ge=0)`
- `accepted_value_at_purchase_order_price: Decimal = Field(ge=0)`
- `expected_invoice_subtotal: Decimal = Field(ge=0)`
- `actual_invoice_subtotal: Decimal = Field(ge=0)`
- `source_snapshot_digests: dict[str, str]`
- `evidence_refs: tuple[str, ...]`
- `effect_boundary: ProcurementEffectBoundary = Field(default_factory=ProcurementEffectBoundary)`
- `result_digest: str = Field(default=_ZERO_DIGEST, pattern='^[0-9a-f]{64}$')`

### `lightbulb.procurement_controls.evaluate_purchase_to_pay_controls`

function. Source: `lightbulb/procurement_controls.py:1009`.



~~~python
evaluate_purchase_to_pay_controls(value: PurchaseToPayControlsInput | Mapping[str, Any]) -> PurchaseToPayControlsResult
~~~


Evaluate one normalized packet without reading or mutating external state.

### `lightbulb.procurement_controls.EvaluatePurchaseToPayControlsPrimitive`

class. Source: `lightbulb/procurement_controls.py:1922`.

#### Methods

##### `lightbulb.procurement_controls.EvaluatePurchaseToPayControlsPrimitive.implementation_contract`



~~~python
def implementation_contract() -> dict[str, Any]
~~~


Source: `lightbulb/procurement_controls.py:2049`.

## Module `lightbulb.product_engineering_lifecycle`

Deterministic product-engineering lifecycle candidate materialization.

### `lightbulb.product_engineering_lifecycle.ProductEngineeringLifecycleScope`

class. Source: `lightbulb/product_engineering_lifecycle.py:263`.

Exact business scope plus the expected external evidence custodians.

Fields:
- `tenant_ref: OpaqueRef`
- `company_ref: OpaqueRef`
- `project_ref: OpaqueRef`
- `project_id: UUID`
- `product_ref: OpaqueRef`
- `configuration_ref: OpaqueRef`
- `release_ref: OpaqueRef`
- `spring_authority_ref: OpaqueRef`
- `plm_system_ref: OpaqueRef`
- `alm_system_ref: OpaqueRef`
- `telemetry_system_ref: OpaqueRef`

### `lightbulb.product_engineering_lifecycle.product_engineering_scope_digest`

function. Source: `lightbulb/product_engineering_lifecycle.py:305`.



~~~python
product_engineering_scope_digest(scope: ProductEngineeringLifecycleScope | Mapping[str, Any]) -> str
~~~


### `lightbulb.product_engineering_lifecycle.CertifiedLifecycleActor`

class. Source: `lightbulb/product_engineering_lifecycle.py:345`.

Fields:
- `actor_ref: OpaqueRef`
- `role: ActorRole`
- `certification_ref: OpaqueRef`
- `valid_from: str`
- `valid_until: str`
- `certification_evidence: PrimitiveEvidenceRef`

### `lightbulb.product_engineering_lifecycle.RequirementRecord`

class. Source: `lightbulb/product_engineering_lifecycle.py:404`.

Fields:
- `requirement_ref: OpaqueRef`
- `revision: int = Field(ge=1, le=1000000)`
- `kind: RequirementKind`
- `statement_digest: Sha256Digest`
- `acceptance_criteria_refs: tuple[OpaqueRef, ...] = Field(min_length=1, max_length=1000)`

### `lightbulb.product_engineering_lifecycle.RequirementsBaselineCandidate`

class. Source: `lightbulb/product_engineering_lifecycle.py:425`.

Fields:
- `baseline_ref: OpaqueRef`
- `revision: int = Field(ge=1, le=1000000)`
- `requirements: tuple[RequirementRecord, ...] = Field(min_length=1, max_length=MAX_REQUIREMENTS)`

### `lightbulb.product_engineering_lifecycle.ReleaseTargetCandidate`

class. Source: `lightbulb/product_engineering_lifecycle.py:447`.

Fields:
- `release_target_ref: OpaqueRef`
- `revision: int = Field(ge=1, le=1000000)`
- `requirements_baseline_digest: Sha256Digest`
- `roadmap_item_refs: tuple[OpaqueRef, ...] = Field(min_length=1, max_length=2000)`
- `requirement_refs: tuple[OpaqueRef, ...] = Field(min_length=1, max_length=MAX_REQUIREMENTS)`
- `planned_release_at: str`
- `change_cutoff_at: str`

### `lightbulb.product_engineering_lifecycle.SpecificationRecord`

class. Source: `lightbulb/product_engineering_lifecycle.py:480`.

Fields:
- `specification_ref: OpaqueRef`
- `revision: int = Field(ge=1, le=1000000)`
- `content_sha256: Sha256Digest`
- `requirement_refs: tuple[OpaqueRef, ...] = Field(min_length=1, max_length=2000)`
- `configuration_item_refs: tuple[OpaqueRef, ...] = Field(min_length=1, max_length=MAX_TRACE_RECORDS)`

### `lightbulb.product_engineering_lifecycle.BomComponentRecord`

class. Source: `lightbulb/product_engineering_lifecycle.py:522`.

Fields:
- `component_ref: OpaqueRef`
- `revision: int = Field(ge=1, le=1000000)`
- `quantity: int = Field(ge=1, le=1000000000)`
- `configuration_item_refs: tuple[OpaqueRef, ...] = Field(min_length=1, max_length=MAX_TRACE_RECORDS)`

### `lightbulb.product_engineering_lifecycle.EngineeringBaselineCandidate`

class. Source: `lightbulb/product_engineering_lifecycle.py:542`.

Fields:
- `baseline_ref: OpaqueRef`
- `revision: int = Field(ge=1, le=1000000)`
- `configuration_ref: OpaqueRef`
- `requirements_baseline_digest: Sha256Digest`
- `release_target_digest: Sha256Digest`
- `specifications: tuple[SpecificationRecord, ...] = Field(min_length=1, max_length=MAX_TRACE_RECORDS)`
- `configuration_items: tuple[ConfigurationItemRecord, ...] = Field(min_length=1, max_length=MAX_TRACE_RECORDS)`
- `bom_components: tuple[BomComponentRecord, ...] = Field(min_length=1, max_length=MAX_TRACE_RECORDS)`

### `lightbulb.product_engineering_lifecycle.DesignActionRecord`

class. Source: `lightbulb/product_engineering_lifecycle.py:593`.

Fields:
- `action_ref: OpaqueRef`
- `severity: Literal['low', 'medium', 'high', 'critical']`
- `status: Literal['closed', 'open']`
- `closure_ref: OpaqueRef | None = None`

### `lightbulb.product_engineering_lifecycle.DesignReviewCandidate`

class. Source: `lightbulb/product_engineering_lifecycle.py:606`.

Fields:
- `review_ref: OpaqueRef`
- `revision: int = Field(ge=1, le=1000000)`
- `engineering_baseline_digest: Sha256Digest`
- `covered_requirement_refs: tuple[OpaqueRef, ...] = Field(min_length=1, max_length=MAX_REQUIREMENTS)`
- `covered_specification_refs: tuple[OpaqueRef, ...] = Field(min_length=1, max_length=MAX_TRACE_RECORDS)`
- `covered_configuration_item_refs: tuple[OpaqueRef, ...] = Field(min_length=1, max_length=MAX_TRACE_RECORDS)`
- `covered_component_refs: tuple[OpaqueRef, ...] = Field(min_length=1, max_length=MAX_TRACE_RECORDS)`
- `actions: tuple[DesignActionRecord, ...] = Field(default_factory=tuple, max_length=MAX_TRACE_RECORDS)`
- `recommendation: Literal['candidate_ready', 'changes_required']`

### `lightbulb.product_engineering_lifecycle.EngineeringChangeCandidate`

class. Source: `lightbulb/product_engineering_lifecycle.py:665`.

Fields:
- `change_ref: OpaqueRef`
- `revision: int = Field(ge=1, le=1000000)`
- `from_baseline_digest: Sha256Digest`
- `proposed_baseline_digest: Sha256Digest`
- `proposed_baseline: EngineeringBaselineCandidate`
- `risk_tier: Literal['low', 'medium', 'high', 'critical']`
- `implementation_plan_ref: OpaqueRef`
- `impacted_requirement_refs: tuple[OpaqueRef, ...] = Field(min_length=1, max_length=MAX_REQUIREMENTS)`
- `impacted_specification_refs: tuple[OpaqueRef, ...] = Field(min_length=1, max_length=MAX_TRACE_RECORDS)`
- `impacted_configuration_item_refs: tuple[OpaqueRef, ...] = Field(min_length=1, max_length=MAX_TRACE_RECORDS)`
- `impacted_component_refs: tuple[OpaqueRef, ...] = Field(min_length=1, max_length=MAX_TRACE_RECORDS)`

### `lightbulb.product_engineering_lifecycle.TestRecord`

class. Source: `lightbulb/product_engineering_lifecycle.py:721`.

Fields:
- `test_ref: OpaqueRef`
- `kind: Literal['verification', 'validation']`
- `method: Literal['test', 'analysis', 'inspection', 'demonstration', 'simulation']`
- `result: Literal['passed', 'failed', 'not_run']`
- `result_sha256: Sha256Digest`
- `requirement_refs: tuple[OpaqueRef, ...] = Field(min_length=1, max_length=2000)`
- `acceptance_criteria_refs: tuple[OpaqueRef, ...] = Field(min_length=1, max_length=MAX_TRACE_RECORDS)`
- `specification_refs: tuple[OpaqueRef, ...] = Field(min_length=1, max_length=MAX_TRACE_RECORDS)`

### `lightbulb.product_engineering_lifecycle.VerificationValidationCandidate`

class. Source: `lightbulb/product_engineering_lifecycle.py:761`.

Fields:
- `campaign_ref: OpaqueRef`
- `revision: int = Field(ge=1, le=1000000)`
- `engineering_change_digest: Sha256Digest`
- `target_baseline_digest: Sha256Digest`
- `tests: tuple[TestRecord, ...] = Field(min_length=1, max_length=MAX_TRACE_RECORDS)`

### `lightbulb.product_engineering_lifecycle.ReleaseArtifactRecord`

class. Source: `lightbulb/product_engineering_lifecycle.py:779`.

Fields:
- `artifact_ref: OpaqueRef`
- `kind: Literal['software', 'firmware', 'hardware', 'documentation', 'configuration', 'sbom']`
- `content_sha256: Sha256Digest`

### `lightbulb.product_engineering_lifecycle.ReleaseCandidateRecord`

class. Source: `lightbulb/product_engineering_lifecycle.py:792`.

Fields:
- `candidate_ref: OpaqueRef`
- `candidate_version: ShortText`
- `target_baseline_digest: Sha256Digest`
- `design_review_digest: Sha256Digest`
- `engineering_change_digest: Sha256Digest`
- `verification_validation_digest: Sha256Digest`
- `traced_requirement_refs: tuple[OpaqueRef, ...] = Field(min_length=1, max_length=MAX_REQUIREMENTS)`
- `traced_specification_refs: tuple[OpaqueRef, ...] = Field(min_length=1, max_length=MAX_TRACE_RECORDS)`
- `artifacts: tuple[ReleaseArtifactRecord, ...] = Field(min_length=1, max_length=MAX_TRACE_RECORDS)`
- `known_blocker_refs: tuple[OpaqueRef, ...] = Field(default_factory=tuple, max_length=MAX_TRACE_RECORDS)`

### `lightbulb.product_engineering_lifecycle.TelemetrySignalRecord`

class. Source: `lightbulb/product_engineering_lifecycle.py:846`.

Fields:
- `signal_ref: OpaqueRef`
- `metric_ref: OpaqueRef`
- `source_sha256: Sha256Digest`
- `sample_count: int = Field(ge=1, le=10000000000)`
- `threshold_status: Literal['within_threshold', 'warning', 'breached']`
- `requirement_refs: tuple[OpaqueRef, ...] = Field(min_length=1, max_length=2000)`

### `lightbulb.product_engineering_lifecycle.ProductTelemetryCandidate`

class. Source: `lightbulb/product_engineering_lifecycle.py:865`.

Fields:
- `observation_ref: OpaqueRef`
- `release_candidate_digest: Sha256Digest`
- `environment: Literal['test', 'staging', 'pilot', 'production', 'field']`
- `window_started_at: str`
- `window_ended_at: str`
- `signals: tuple[TelemetrySignalRecord, ...] = Field(min_length=1, max_length=MAX_TRACE_RECORDS)`

### `lightbulb.product_engineering_lifecycle.ProductIssueRecord`

class. Source: `lightbulb/product_engineering_lifecycle.py:908`.

Fields:
- `issue_ref: OpaqueRef`
- `kind: Literal['vulnerability', 'defect']`
- `severity: Literal['low', 'medium', 'high', 'critical']`
- `source_ref: OpaqueRef`
- `linked_requirement_refs: tuple[OpaqueRef, ...] = Field(min_length=1, max_length=2000)`
- `telemetry_signal_refs: tuple[OpaqueRef, ...] = Field(min_length=1, max_length=MAX_TRACE_RECORDS)`
- `proposed_disposition: IssueDisposition`
- `remediation_ref: OpaqueRef | None = None`

### `lightbulb.product_engineering_lifecycle.IssueDispositionCandidate`

class. Source: `lightbulb/product_engineering_lifecycle.py:953`.

Fields:
- `disposition_ref: OpaqueRef`
- `release_candidate_digest: Sha256Digest`
- `telemetry_digest: Sha256Digest`
- `no_known_issues: bool`
- `issues: tuple[ProductIssueRecord, ...] = Field(default_factory=tuple, max_length=MAX_ISSUES)`

### `lightbulb.product_engineering_lifecycle.BaselineRequirementsCommand`

class. Source: `lightbulb/product_engineering_lifecycle.py:1144`.

Fields:
- `kind: Literal['requirements'] = 'requirements'`
- `candidate: RequirementsBaselineCandidate`

### `lightbulb.product_engineering_lifecycle.TargetReleaseCommand`

class. Source: `lightbulb/product_engineering_lifecycle.py:1159`.

Fields:
- `kind: Literal['release_target'] = 'release_target'`
- `candidate: ReleaseTargetCandidate`

### `lightbulb.product_engineering_lifecycle.BaselineEngineeringCommand`

class. Source: `lightbulb/product_engineering_lifecycle.py:1171`.

Fields:
- `kind: Literal['engineering_baseline'] = 'engineering_baseline'`
- `candidate: EngineeringBaselineCandidate`

### `lightbulb.product_engineering_lifecycle.ReviewDesignCommand`

class. Source: `lightbulb/product_engineering_lifecycle.py:1186`.

Fields:
- `kind: Literal['design_review'] = 'design_review'`
- `candidate: DesignReviewCandidate`

### `lightbulb.product_engineering_lifecycle.ValidateEngineeringChangeCommand`

class. Source: `lightbulb/product_engineering_lifecycle.py:1201`.

Fields:
- `kind: Literal['engineering_change'] = 'engineering_change'`
- `candidate: EngineeringChangeCandidate`

### `lightbulb.product_engineering_lifecycle.ValidateVerificationCommand`

class. Source: `lightbulb/product_engineering_lifecycle.py:1223`.

Fields:
- `kind: Literal['verification_validation'] = 'verification_validation'`
- `candidate: VerificationValidationCandidate`

### `lightbulb.product_engineering_lifecycle.ValidateReleaseCandidateCommand`

class. Source: `lightbulb/product_engineering_lifecycle.py:1238`.

Fields:
- `kind: Literal['release_candidate'] = 'release_candidate'`
- `candidate: ReleaseCandidateRecord`

### `lightbulb.product_engineering_lifecycle.ObserveProductTelemetryCommand`

class. Source: `lightbulb/product_engineering_lifecycle.py:1253`.

Fields:
- `kind: Literal['product_telemetry'] = 'product_telemetry'`
- `candidate: ProductTelemetryCandidate`

### `lightbulb.product_engineering_lifecycle.ProposeIssueDispositionCommand`

class. Source: `lightbulb/product_engineering_lifecycle.py:1268`.

Fields:
- `kind: Literal['issue_disposition'] = 'issue_disposition'`
- `candidate: IssueDispositionCandidate`

### `lightbulb.product_engineering_lifecycle.seal_product_engineering_command`

function. Source: `lightbulb/product_engineering_lifecycle.py:1299`.



~~~python
seal_product_engineering_command(command: BaseModel | Mapping[str, Any]) -> ProductEngineeringTransitionCommand
~~~


Canonically seal a command; this does not authenticate its assertions.

### `lightbulb.product_engineering_lifecycle.ProductEngineeringLifecycleSnapshot`

class. Source: `lightbulb/product_engineering_lifecycle.py:2057`.

Fields:
- `schema_id: Literal['lightbulb.product_engineering_lifecycle_snapshot.v1'] = Field(default=PRODUCT_ENGINEERING_LIFECYCLE_SNAPSHOT_SCHEMA, alias='schema')`
- `scope: ProductEngineeringLifecycleScope`
- `revision: int = Field(ge=1, le=MAX_PRODUCT_ENGINEERING_TRANSITIONS)`
- `phase: LifecyclePhase`
- `transition_history: tuple[ProductEngineeringTransitionRecord, ...] = Field(min_length=1, max_length=MAX_PRODUCT_ENGINEERING_TRANSITIONS)`
- `requirements_baseline: RequirementsBaselineCandidate | None = None`
- `release_target: ReleaseTargetCandidate | None = None`
- `engineering_baseline: EngineeringBaselineCandidate | None = None`
- `design_review: DesignReviewCandidate | None = None`
- `engineering_change: EngineeringChangeCandidate | None = None`
- `verification_validation: VerificationValidationCandidate | None = None`
- `release_candidate: ReleaseCandidateRecord | None = None`
- `product_telemetry: ProductTelemetryCandidate | None = None`
- `issue_disposition: IssueDispositionCandidate | None = None`
- `state_digest: Sha256Digest`

### `lightbulb.product_engineering_lifecycle.product_engineering_snapshot_digest`

function. Source: `lightbulb/product_engineering_lifecycle.py:2197`.



~~~python
product_engineering_snapshot_digest(snapshot: ProductEngineeringLifecycleSnapshot | Mapping[str, Any], *, validate: bool=True) -> str
~~~


### `lightbulb.product_engineering_lifecycle.ProductEngineeringLifecycleInput`

class. Source: `lightbulb/product_engineering_lifecycle.py:2214`.

Fields:
- `schema_id: Literal['lightbulb.product_engineering_lifecycle_input.v1'] = Field(default=PRODUCT_ENGINEERING_LIFECYCLE_INPUT_SCHEMA, alias='schema')`
- `scope: ProductEngineeringLifecycleScope`
- `command: ProductEngineeringTransitionCommand`
- `snapshot: ProductEngineeringLifecycleSnapshot | None = None`

### `lightbulb.product_engineering_lifecycle.ProductEngineeringTransitionReceipt`

class. Source: `lightbulb/product_engineering_lifecycle.py:2245`.

Fields:
- `schema_id: Literal['lightbulb.product_engineering_transition_receipt.v1'] = Field(default=PRODUCT_ENGINEERING_TRANSITION_RECEIPT_SCHEMA, alias='schema')`
- `command_ref: OpaqueRef`
- `kind: TransitionKind`
- `status: TransitionReceiptStatus`
- `request_digest: Sha256Digest`
- `evidence_digest: Sha256Digest`
- `from_revision: int = Field(ge=0, le=MAX_PRODUCT_ENGINEERING_TRANSITIONS)`
- `to_revision: int = Field(ge=0, le=MAX_PRODUCT_ENGINEERING_TRANSITIONS)`
- `from_snapshot_digest: Sha256Digest`
- `to_snapshot_digest: Sha256Digest`
- `rejection_code: str | None = Field(default=None, min_length=1, max_length=120)`
- `message: str = Field(min_length=1, max_length=500)`
- `recovery: TransitionRecovery`

### `lightbulb.product_engineering_lifecycle.ProductEngineeringLifecycleResult`

class. Source: `lightbulb/product_engineering_lifecycle.py:2288`.

Fields:
- `schema_id: Literal['lightbulb.product_engineering_lifecycle_result.v1'] = Field(default=PRODUCT_ENGINEERING_LIFECYCLE_RESULT_SCHEMA, alias='schema')`
- `candidate_validated: bool`
- `live_systems_changed: Literal[False] = False`
- `authoritative_persistence_claimed: Literal[False] = False`
- `authoritative_release_claimed: Literal[False] = False`
- `risk_acceptance_or_issue_closure_claimed: Literal[False] = False`
- `snapshot: ProductEngineeringLifecycleSnapshot | None = None`
- `transition_receipt: ProductEngineeringTransitionReceipt`

### `lightbulb.product_engineering_lifecycle.materialize_product_engineering_candidate`

function. Source: `lightbulb/product_engineering_lifecycle.py:2570`.



~~~python
materialize_product_engineering_candidate(inputs: ProductEngineeringLifecycleInput | Mapping[str, Any]) -> ProductEngineeringLifecycleResult
~~~


Validate and retain one SDK candidate without authoritative effects.

### `lightbulb.product_engineering_lifecycle.ProposeProductEngineeringTransitionPrimitive`

class. Source: `lightbulb/product_engineering_lifecycle.py:2838`.

Fields:
- `example_inputs: Mapping[str, Any] = _product_engineering_example_inputs()`

#### Methods

##### `lightbulb.product_engineering_lifecycle.ProposeProductEngineeringTransitionPrimitive.implementation_contract`



~~~python
def implementation_contract() -> dict[str, Any]
~~~


Source: `lightbulb/product_engineering_lifecycle.py:2862`.

## Module `lightbulb.product_governance`

Deterministic, evidence-bound product release governance controls.

### `lightbulb.product_governance.ReleaseGovernancePolicy`

class. Source: `lightbulb/product_governance.py:922`.

Fields:
- `minimum_evidence_grade: PrimitiveEvidenceVerificationGrade = PrimitiveEvidenceVerificationGrade.ATTESTED`
- `max_evidence_age_hours: int = Field(default=168, ge=1, le=8760)`
- `max_telemetry_evidence_age_hours: int = Field(default=48, ge=1, le=8760)`
- `require_bom: bool = False`
- `require_validation: bool = True`
- `require_telemetry: bool = True`
- `minimum_telemetry_sample_size: int = Field(default=100, ge=1, le=10000000000)`
- `required_design_review_types: tuple[DesignReviewType, ...] = Field(default=('release',), min_length=1, max_length=8)`
- `blocking_issue_severities: tuple[ProductIssueSeverity, ...] = Field(default=('critical', 'high'), min_length=1, max_length=4)`
- `require_high_risk_change_review: bool = True`
- `allow_verification_validation_waivers: bool = False`

### `lightbulb.product_governance.ReleaseGovernanceInput`

class. Source: `lightbulb/product_governance.py:977`.

Fields:
- `schema_id: Literal['lightbulb.release_governance_input.v1'] = Field(default=RELEASE_GOVERNANCE_INPUT_SCHEMA, alias='schema')`
- `evaluation_ref: OpaqueRef`
- `analysis_as_of: str`
- `evidence_coverage: ProductGovernanceEvidenceCoverage`
- `release_scope: ProductRoadmapReleaseScope`
- `requirements: tuple[ProductRequirementSnapshot, ...] = Field(max_length=5000)`
- `specifications: tuple[ProductSpecificationSnapshot, ...] = Field(max_length=5000)`
- `configuration: ProductConfigurationSnapshot`
- `bom: ProductBomSnapshot | None = None`
- `engineering_changes: tuple[ProductEngineeringChangeSnapshot, ...] = Field(max_length=5000)`
- `design_reviews: tuple[ProductDesignReviewSnapshot, ...] = Field(max_length=5000)`
- `verification_validation_records: tuple[ProductVerificationValidationRecord, ...] = Field(max_length=20000)`
- `telemetry: tuple[ProductTelemetrySnapshot, ...] = Field(max_length=1000)`
- `issues: tuple[ProductIssueSnapshot, ...] = Field(max_length=20000)`
- `policy: ReleaseGovernancePolicy = Field(default_factory=ReleaseGovernancePolicy)`

### `lightbulb.product_governance.ProductGovernanceEffectBoundary`

class. Source: `lightbulb/product_governance.py:1277`.

Fields:
- `connector_reads: Literal[0] = 0`
- `connector_writes: Literal[0] = 0`
- `approvals_consumed: Literal[0] = 0`
- `release_authorized: Literal[False] = False`
- `configuration_change_authorized: Literal[False] = False`
- `engineering_change_authorized: Literal[False] = False`
- `vulnerability_disposition_authorized: Literal[False] = False`
- `defect_disposition_authorized: Literal[False] = False`
- `release_state_changed: Literal[False] = False`
- `configuration_changed: Literal[False] = False`
- `engineering_changes_changed: Literal[False] = False`
- `vulnerabilities_changed: Literal[False] = False`
- `defects_changed: Literal[False] = False`
- `external_systems_changed: Literal[False] = False`

### `lightbulb.product_governance.ReleaseGovernanceResult`

class. Source: `lightbulb/product_governance.py:1305`.

Fields:
- `schema_id: Literal['lightbulb.release_governance_result.v1'] = Field(default=RELEASE_GOVERNANCE_RESULT_SCHEMA, alias='schema')`
- `evaluation_ref: OpaqueRef`
- `analysis_as_of: str`
- `release_ref: OpaqueRef`
- `release_version: ShortText`
- `assurance_grade: PrimitiveEvidenceVerificationGrade`
- `disposition: ReleaseGovernanceDisposition`
- `release_authorized: Literal[False] = False`
- `gates: tuple[ReleaseGovernanceGateResult, ...] = Field(min_length=9, max_length=9)`
- `findings: tuple[ReleaseGovernanceFinding, ...] = Field(max_length=200000)`
- `coverage: ReleaseGovernanceCoverageSummary`
- `source_snapshot_digests: dict[str, str]`
- `evidence_refs: tuple[OpaqueRef, ...] = Field(max_length=1220100)`
- `effect_boundary: ProductGovernanceEffectBoundary = Field(default_factory=ProductGovernanceEffectBoundary)`
- `result_digest: str = Field(default=_ZERO_DIGEST, pattern='^[0-9a-f]{64}$')`

### `lightbulb.product_governance.evaluate_release_governance_controls`

function. Source: `lightbulb/product_governance.py:1502`.



~~~python
evaluate_release_governance_controls(value: ReleaseGovernanceInput | Mapping[str, Any]) -> ReleaseGovernanceResult
~~~


Evaluate one normalized release packet without reading or mutating state.

### `lightbulb.product_governance.EvaluateReleaseGovernanceControlsPrimitive`

class. Source: `lightbulb/product_governance.py:3009`.

#### Methods

##### `lightbulb.product_governance.EvaluateReleaseGovernanceControlsPrimitive.implementation_contract`



~~~python
def implementation_contract() -> dict[str, Any]
~~~


Source: `lightbulb/product_governance.py:3231`.

## Module `lightbulb.production_connector_conformance`

Evidence-bound verification of production connector conformance.

### `lightbulb.production_connector_conformance.ProductionConnectorConformancePolicy`

class. Source: `lightbulb/production_connector_conformance.py:839`.

Fields:
- `requirements: tuple[ProductionToolConformanceRequirement, ...] = Field(min_length=1, max_length=_MAX_TOOL_PROOFS)`
- `maximum_attestation_age_hours: int = Field(default=168, ge=1, le=8760)`
- `certification_candidate_validity_hours: int = Field(default=24, ge=1, le=168)`

### `lightbulb.production_connector_conformance.ProductionConnectorConformanceInput`

class. Source: `lightbulb/production_connector_conformance.py:930`.

Fields:
- `schema_id: Literal['lightbulb.production_connector_conformance_input.v1'] = Field(default=PRODUCTION_CONNECTOR_CONFORMANCE_INPUT_SCHEMA, alias='schema')`
- `evaluation_ref: OpaqueRef`
- `environment: Literal['production']`
- `tenant_id: UuidRef`
- `company_id: UuidRef`
- `project_id: UuidRef`
- `evaluated_at: str`
- `policy: ProductionConnectorConformancePolicy`
- `tool_proofs: tuple[ProductionToolConformanceProof, ...] = Field(max_length=_MAX_TOOL_PROOFS)`

### `lightbulb.production_connector_conformance.ProductionConnectorConformanceEffectBoundary`

class. Source: `lightbulb/production_connector_conformance.py:1035`.

Fields:
- `connector_reads: Literal[0] = 0`
- `connector_writes: Literal[0] = 0`
- `provider_dispatches: Literal[0] = 0`
- `approvals_consumed: Literal[0] = 0`
- `journals_mutated: Literal[0] = 0`
- `production_certified: Literal[False] = False`
- `certification_authorized: Literal[False] = False`
- `external_systems_changed: Literal[False] = False`

### `lightbulb.production_connector_conformance.ProductionConnectorConformanceResult`

class. Source: `lightbulb/production_connector_conformance.py:1069`.

Fields:
- `schema_id: Literal['lightbulb.production_connector_conformance_result.v1'] = Field(default=PRODUCTION_CONNECTOR_CONFORMANCE_RESULT_SCHEMA, alias='schema')`
- `evaluation_ref: OpaqueRef`
- `environment: Literal['production']`
- `tenant_id: UuidRef`
- `company_id: UuidRef`
- `project_id: UuidRef`
- `evaluated_at: str`
- `disposition: ProductionConformanceDisposition`
- `assurance_grade: PrimitiveEvidenceVerificationGrade`
- `tool_results: tuple[ProductionToolConformanceResult, ...] = Field(min_length=1, max_length=_MAX_TOOL_PROOFS)`
- `findings: tuple[ProductionConformanceFinding, ...] = Field(min_length=len(_GATE_ORDER), max_length=_MAX_TOOL_PROOFS * len(_GATE_ORDER))`
- `certification_candidates: tuple[ConnectorConformanceCertification, ...] = Field(max_length=_MAX_TOOL_PROOFS)`
- `evidence_refs: tuple[PrimitiveEvidenceRef, ...] = Field(max_length=_MAX_EVIDENCE)`
- `input_digest: Sha256Digest`
- `evidence_digest: Sha256Digest`
- `evaluation_digest: Sha256Digest`
- `operation_spec: PrimitiveOperationSpec`
- `effect_boundary: ProductionConnectorConformanceEffectBoundary = Field(default_factory=ProductionConnectorConformanceEffectBoundary)`
- `production_certified: Literal[False] = False`
- `certification_authorized: Literal[False] = False`
- `result_digest: Sha256Digest = _ZERO_DIGEST`

### `lightbulb.production_connector_conformance.evaluate_production_connector_conformance`

function. Source: `lightbulb/production_connector_conformance.py:1751`.



~~~python
evaluate_production_connector_conformance(inputs: ProductionConnectorConformanceInput | Mapping[str, Any]) -> ProductionConnectorConformanceResult
~~~


Verify supplied production proof without executing or certifying anything.

### `lightbulb.production_connector_conformance.EvaluateProductionConnectorConformancePrimitive`

class. Source: `lightbulb/production_connector_conformance.py:2259`.

#### Methods

##### `lightbulb.production_connector_conformance.EvaluateProductionConnectorConformancePrimitive.implementation_contract`



~~~python
def implementation_contract() -> dict[str, Any]
~~~


Source: `lightbulb/production_connector_conformance.py:2284`.

## Module `lightbulb.production_connector_read_conformance`

Evidence-bound conformance verification for governed production reads.

### `lightbulb.production_connector_read_conformance.HostedReadSchemaAttestation`

class. Source: `lightbulb/production_connector_read_conformance.py:298`.

Fields:
- `schema_id: Literal['lightbulb.hosted_read_schema_attestation.v1'] = Field(default=HOSTED_READ_SCHEMA_ATTESTATION_SCHEMA, alias='schema')`
- `attestation_ref: OpaqueRef`
- `tool: ToolName`
- `provider: ProviderName`
- `environment: Literal['production']`
- `hosted_schema_identity: OpaqueRef`
- `catalog_version: OpaqueRef`
- `tool_version: int = Field(ge=1, le=1000000)`
- `server_effect: Literal['read']`
- `input_schema_sha256: Sha256Digest`
- `output_schema_sha256: Sha256Digest`
- `observed_at: str`
- `evidence_refs: tuple[PrimitiveEvidenceRef, ...] = Field(min_length=1, max_length=5)`

### `lightbulb.production_connector_read_conformance.GovernedReadAttestation`

class. Source: `lightbulb/production_connector_read_conformance.py:339`.

Fields:
- `schema_id: Literal['lightbulb.governed_read_attestation.v1'] = Field(default=GOVERNED_READ_ATTESTATION_SCHEMA, alias='schema')`
- `attestation_ref: OpaqueRef`
- `tool: ToolName`
- `provider: ProviderName`
- `environment: Literal['production']`
- `tenant_id: UuidRef`
- `company_id: UuidRef`
- `user_id: UuidRef`
- `project_id: UuidRef`
- `connector_account_ref: OpaqueRef`
- `effect_catalog_version: OpaqueRef`
- `journal_status: Literal['succeeded', 'failed', 'ambiguous']`
- `provenance: ConnectorExecutionProvenance`
- `provider_output_sha256: Sha256Digest`
- `durable_commitment_schema: GovernedReadCommitmentSchema`
- `durable_provider_output_sha256: Sha256Digest`
- `durable_record_count: int = Field(ge=0, le=1000000)`
- `observed_at: str`
- `evidence_refs: tuple[PrimitiveEvidenceRef, ...] = Field(min_length=1, max_length=5)`

### `lightbulb.production_connector_read_conformance.ProviderReadOutcomeAttestation`

class. Source: `lightbulb/production_connector_read_conformance.py:405`.

Fields:
- `schema_id: Literal['lightbulb.provider_read_outcome_attestation.v1'] = Field(default=PROVIDER_READ_OUTCOME_ATTESTATION_SCHEMA, alias='schema')`
- `attestation_ref: OpaqueRef`
- `tool: ToolName`
- `provider: ProviderName`
- `environment: Literal['production']`
- `connector_account_ref: OpaqueRef`
- `provider_request_ref: OpaqueRef`
- `provider_output_sha256: Sha256Digest`
- `record_count: int = Field(ge=0, le=1000000)`
- `outcome: Literal['completed', 'failed', 'indeterminate']`
- `observed_at: str`
- `evidence_refs: tuple[PrimitiveEvidenceRef, ...] = Field(min_length=1, max_length=5)`

### `lightbulb.production_connector_read_conformance.ProductionReadToolRequirement`

class. Source: `lightbulb/production_connector_read_conformance.py:445`.

Fields:
- `tool: ToolName`
- `provider: ProviderName`
- `hosted_schema_identity: OpaqueRef`
- `catalog_version: OpaqueRef`
- `tool_version: int = Field(ge=1, le=1000000)`
- `input_schema_sha256: Sha256Digest`
- `output_schema_sha256: Sha256Digest`
- `durable_commitment_schema: GovernedReadCommitmentSchema = GOVERNED_OUTPUT_COMMITMENT_SCHEMA`
- `required_normalized_error_kinds: tuple[ConnectorErrorKind, ...] = Field(min_length=2, max_length=10)`

### `lightbulb.production_connector_read_conformance.ProductionConnectorReadConformancePolicy`

class. Source: `lightbulb/production_connector_read_conformance.py:487`.

Fields:
- `requirements: tuple[ProductionReadToolRequirement, ...] = Field(min_length=1, max_length=_MAX_TOOL_PROOFS)`
- `maximum_attestation_age_hours: int = Field(default=168, ge=1, le=8760)`
- `certification_candidate_validity_hours: int = Field(default=24, ge=1, le=168)`

### `lightbulb.production_connector_read_conformance.ProductionReadToolProof`

class. Source: `lightbulb/production_connector_read_conformance.py:508`.

Fields:
- `tool: ToolName`
- `provider: ProviderName`
- `schema_attestation: HostedReadSchemaAttestation`
- `route_attestation: ExactConnectorRouteAttestation`
- `read_attestation: GovernedReadAttestation`
- `provider_outcome_attestation: ProviderReadOutcomeAttestation`
- `error_attestations: tuple[NormalizedConnectorErrorAttestation, ...] = Field(min_length=2, max_length=10)`

### `lightbulb.production_connector_read_conformance.ProductionConnectorReadConformanceInput`

class. Source: `lightbulb/production_connector_read_conformance.py:610`.

Fields:
- `schema_id: Literal['lightbulb.production_connector_read_conformance_input.v1'] = Field(default=PRODUCTION_CONNECTOR_READ_CONFORMANCE_INPUT_SCHEMA, alias='schema')`
- `evaluation_ref: OpaqueRef`
- `environment: Literal['production']`
- `tenant_id: UuidRef`
- `company_id: UuidRef`
- `project_id: UuidRef`
- `evaluated_at: str`
- `policy: ProductionConnectorReadConformancePolicy`
- `tool_proofs: tuple[ProductionReadToolProof, ...] = Field(max_length=_MAX_TOOL_PROOFS)`

### `lightbulb.production_connector_read_conformance.ProductionReadConformanceFinding`

class. Source: `lightbulb/production_connector_read_conformance.py:662`.

Fields:
- `tool: ToolName`
- `provider: ProviderName`
- `gate: ReadConformanceGate`
- `status: ReadConformanceGateStatus`
- `code: OpaqueRef`
- `message: str = Field(min_length=1, max_length=500)`
- `evidence_refs: tuple[EvidenceRefId, ...] = Field(default_factory=tuple, max_length=_MAX_EVIDENCE_PER_TOOL)`

### `lightbulb.production_connector_read_conformance.ProductionReadToolResult`

class. Source: `lightbulb/production_connector_read_conformance.py:680`.

Fields:
- `tool: ToolName`
- `provider: ProviderName`
- `status: ReadConformanceGateStatus`
- `gates: tuple[ProductionReadConformanceFinding, ...] = Field(min_length=len(_GATE_ORDER), max_length=len(_GATE_ORDER))`
- `evidence_refs: tuple[EvidenceRefId, ...] = Field(max_length=_MAX_EVIDENCE_PER_TOOL)`

### `lightbulb.production_connector_read_conformance.ProductionConnectorReadConformanceEffectBoundary`

class. Source: `lightbulb/production_connector_read_conformance.py:711`.

Fields:
- `connector_reads: Literal[0] = 0`
- `connector_writes: Literal[0] = 0`
- `provider_dispatches: Literal[0] = 0`
- `approvals_consumed: Literal[0] = 0`
- `journals_mutated: Literal[0] = 0`
- `production_certified: Literal[False] = False`
- `certification_authorized: Literal[False] = False`
- `external_systems_changed: Literal[False] = False`

### `lightbulb.production_connector_read_conformance.ProductionConnectorReadConformanceResult`

class. Source: `lightbulb/production_connector_read_conformance.py:757`.

Fields:
- `schema_id: Literal['lightbulb.production_connector_read_conformance_result.v1'] = Field(default=PRODUCTION_CONNECTOR_READ_CONFORMANCE_RESULT_SCHEMA, alias='schema')`
- `evaluation_ref: OpaqueRef`
- `environment: Literal['production']`
- `tenant_id: UuidRef`
- `company_id: UuidRef`
- `project_id: UuidRef`
- `evaluated_at: str`
- `certification_scope: Literal['governed_read'] = 'governed_read'`
- `disposition: ProductionReadConformanceDisposition`
- `assurance_grade: PrimitiveEvidenceVerificationGrade`
- `tool_results: tuple[ProductionReadToolResult, ...] = Field(min_length=1, max_length=_MAX_TOOL_PROOFS)`
- `findings: tuple[ProductionReadConformanceFinding, ...] = Field(min_length=len(_GATE_ORDER), max_length=_MAX_TOOL_PROOFS * len(_GATE_ORDER))`
- `certification_candidates: tuple[ConnectorConformanceCertification, ...] = Field(max_length=_MAX_TOOL_PROOFS)`
- `evidence_refs: tuple[PrimitiveEvidenceRef, ...] = Field(max_length=_MAX_EVIDENCE)`
- `input_digest: Sha256Digest`
- `evidence_digest: Sha256Digest`
- `evaluation_digest: Sha256Digest`
- `operation_spec: PrimitiveOperationSpec`
- `effect_boundary: ProductionConnectorReadConformanceEffectBoundary = Field(default_factory=ProductionConnectorReadConformanceEffectBoundary)`
- `production_certified: Literal[False] = False`
- `certification_authorized: Literal[False] = False`
- `result_digest: Sha256Digest = _ZERO_DIGEST`

### `lightbulb.production_connector_read_conformance.evaluate_production_connector_read_conformance`

function. Source: `lightbulb/production_connector_read_conformance.py:1253`.



~~~python
evaluate_production_connector_read_conformance(inputs: ProductionConnectorReadConformanceInput | Mapping[str, Any]) -> ProductionConnectorReadConformanceResult
~~~


Verify supplied production READ proof without executing or certifying.

### `lightbulb.production_connector_read_conformance.EvaluateProductionConnectorReadConformancePrimitive`

class. Source: `lightbulb/production_connector_read_conformance.py:1813`.

#### Methods

##### `lightbulb.production_connector_read_conformance.EvaluateProductionConnectorReadConformancePrimitive.implementation_contract`



~~~python
def implementation_contract() -> dict[str, Any]
~~~


Source: `lightbulb/production_connector_read_conformance.py:1838`.

## Module `lightbulb.profit_action_builders`

Typed candidate builders that make existing profit workflows executable.

### `lightbulb.profit_action_builders.MaterializableCandidateEconomics`

class. Source: `lightbulb/profit_action_builders.py:42`.

Fields:
- `expected_incremental_revenue: Decimal = Field(ge=0, le=1000000000000)`
- `expected_incremental_cost: Decimal = Field(ge=0, le=1000000000000)`
- `implementation_cost: Decimal = Field(default=Decimal('0.00'), ge=0)`
- `downside_loss: Decimal = Field(default=Decimal('0.00'), ge=0)`
- `confidence: Decimal = Field(gt=0, le=1)`
- `time_to_value_days: int = Field(ge=0, le=3650)`

### `lightbulb.profit_action_builders.build_materializable_connector_candidate`

function. Source: `lightbulb/profit_action_builders.py:70`.



~~~python
build_materializable_connector_candidate(*, candidate_ref: str, title: str, capability: MaterializableCapability, connector_account_ref: str, connector_arguments: Mapping[str, Any] | BaseModel, rationale: str, economics: MaterializableCandidateEconomics | Mapping[str, Any], measurement_metric: str, supported_by_evidence_refs: Sequence[str], depends_on: Sequence[str]=(), mutually_exclusive_group: str | None=None) -> ProfitLeverCandidate
~~~


Build a profit candidate committed to one closed connector payload.

### `lightbulb.profit_action_builders.build_offer_product_update_candidate`

function. Source: `lightbulb/profit_action_builders.py:117`.



~~~python
build_offer_product_update_candidate(*, candidate_ref: str, connector_account_ref: str, arguments: EcommerceUpdateProductArguments | Mapping[str, Any], economics: MaterializableCandidateEconomics | Mapping[str, Any], supported_by_evidence_refs: Sequence[str]) -> ProfitLeverCandidate
~~~


Create an executable offer/margin or storefront product-update candidate.

### `lightbulb.profit_action_builders.build_creative_publish_candidate`

function. Source: `lightbulb/profit_action_builders.py:143`.



~~~python
build_creative_publish_candidate(*, candidate_ref: str, capability: Literal['facebook.publish_post', 'instagram.publish_post', 'linkedin.publish_post'], connector_account_ref: str, arguments: FacebookPublishPostArguments | InstagramPublishPostArguments | LinkedInPublishPostArguments | Mapping[str, Any], economics: MaterializableCandidateEconomics | Mapping[str, Any], supported_by_evidence_refs: Sequence[str]) -> ProfitLeverCandidate
~~~


Create an exact, separately-approved social experiment cell.

### `lightbulb.profit_action_builders.build_lifecycle_email_candidate`

function. Source: `lightbulb/profit_action_builders.py:179`.



~~~python
build_lifecycle_email_candidate(*, candidate_ref: str, connector_account_ref: str, arguments: GmailSendEmailArguments | Mapping[str, Any], economics: MaterializableCandidateEconomics | Mapping[str, Any], measurement_metric: Literal['contribution_profit_per_contact', 'recovered_contribution_profit'], supported_by_evidence_refs: Sequence[str], depends_on: Sequence[str]=()) -> ProfitLeverCandidate
~~~


Create a consent-reviewed Gmail lifecycle or recovery candidate.

## Module `lightbulb.profit_materializer`

Trusted-host materialization for exact actions in profit workflow plans.

### `lightbulb.profit_materializer.GmailSendEmailArguments`

class. Source: `lightbulb/profit_materializer.py:136`.

Fields:
- `to: str = Field(min_length=3, max_length=998)`
- `subject: str = Field(min_length=1, max_length=998)`
- `body: str = Field(min_length=1, max_length=50000)`
- `cc: str | None = Field(default=None, min_length=3, max_length=998)`
- `html: bool = False`

### `lightbulb.profit_materializer.EcommerceCreateDiscountArguments`

class. Source: `lightbulb/profit_materializer.py:167`.

Fields:
- `title: str = Field(min_length=1, max_length=255)`
- `code: str = Field(pattern='^[A-Z0-9][A-Z0-9_-]{3,63}$')`
- `percentage: Decimal = Field(gt=0, le=50)`
- `starts_at: str`
- `ends_at: str`
- `usage_limit: int = Field(ge=1, le=100)`

### `lightbulb.profit_materializer.EcommerceUpdateProductArguments`

class. Source: `lightbulb/profit_materializer.py:208`.

Fields:
- `product_id: str = Field(min_length=1, max_length=200)`
- `variant_id: str | None = Field(default=None, min_length=1, max_length=200)`
- `title: str | None = Field(default=None, min_length=1, max_length=300)`
- `description: str | None = Field(default=None, min_length=1, max_length=10000)`
- `vendor: str | None = Field(default=None, min_length=1, max_length=300)`
- `product_type: str | None = Field(default=None, min_length=1, max_length=300)`
- `status: Literal['ACTIVE', 'DRAFT', 'ARCHIVED'] | None = None`
- `tags: tuple[str, ...] | None = Field(default=None, max_length=50)`
- `price: str | None = Field(default=None, pattern='^(?:0|[1-9][0-9]{0,8})\\.[0-9]{2}$')`
- `sku: str | None = Field(default=None, min_length=1, max_length=100)`
- `taxable: bool | None = None`
- `requires_shipping: bool | None = None`

### `lightbulb.profit_materializer.FacebookPublishPostArguments`

class. Source: `lightbulb/profit_materializer.py:270`.

Fields:
- `page_id: str = Field(min_length=1, max_length=200)`
- `message: str = Field(min_length=1, max_length=10000)`
- `image_url: str | None = Field(default=None, max_length=2048)`

### `lightbulb.profit_materializer.InstagramPublishPostArguments`

class. Source: `lightbulb/profit_materializer.py:293`.

Fields:
- `instagram_business_account_id: str = Field(min_length=1, max_length=200)`
- `caption: str = Field(min_length=1, max_length=10000)`
- `image_url: str = Field(min_length=9, max_length=2048)`

### `lightbulb.profit_materializer.LinkedInPublishPostArguments`

class. Source: `lightbulb/profit_materializer.py:316`.

Fields:
- `author_urn: str = Field(min_length=1, max_length=300)`
- `text: str = Field(min_length=1, max_length=_LINKEDIN_TEXT_LIMIT)`
- `url: str | None = Field(default=None, max_length=2048)`
- `image_url: str | None = Field(default=None, max_length=2048)`

### `lightbulb.profit_materializer.canonical_profit_connector_arguments`

function. Source: `lightbulb/profit_materializer.py:350`.



~~~python
canonical_profit_connector_arguments(capability: str, value: Mapping[str, Any] | BaseModel) -> dict[str, Any]
~~~


Validate and canonicalize one code-owned connector payload.

### `lightbulb.profit_materializer.profit_connector_arguments_digest`

function. Source: `lightbulb/profit_materializer.py:374`.



~~~python
profit_connector_arguments_digest(capability: str, value: Mapping[str, Any] | BaseModel) -> str
~~~


Return the digest a candidate must commit to before materialization.

### `lightbulb.profit_materializer.ProfitActionApprovalGrant`

class. Source: `lightbulb/profit_materializer.py:388`.

Fields:
- `schema_id: Literal['lightbulb.profit_action_approval_grant.v1'] = Field(default=PROFIT_ACTION_APPROVAL_GRANT_SCHEMA, alias='schema')`
- `workflow_id: str = Field(min_length=3, max_length=160)`
- `plan_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `exact_scope_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `operation_ref: str = Field(min_length=1, max_length=180)`
- `operation_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `capability: str = Field(min_length=3, max_length=200)`
- `connector_account_ref: str = Field(min_length=1, max_length=200)`
- `connector_arguments_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `approval_unit: str = Field(min_length=1, max_length=500)`
- `approval_ref: str = Field(min_length=1, max_length=200)`
- `approval_receipt_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `grant_key_id: str = Field(min_length=8, max_length=80)`
- `grant_hmac: str = Field(pattern='^[0-9a-f]{64}$')`

#### Methods

##### `lightbulb.profit_materializer.ProfitActionApprovalGrant.hmac_payload`



~~~python
def hmac_payload() -> dict[str, Any]
~~~


Source: `lightbulb/profit_materializer.py:420`.

### `lightbulb.profit_materializer.ProfitActionMaterializationResult`

class. Source: `lightbulb/profit_materializer.py:428`.

Fields:
- `schema_id: Literal['lightbulb.profit_action_materialization_result.v1'] = Field(default=PROFIT_ACTION_MATERIALIZATION_RESULT_SCHEMA, alias='schema')`
- `status: ProfitMaterializationStatus`
- `workflow_id: str`
- `plan_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `operation_ref: str`
- `operation_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `capability: str`
- `connector_account_ref: str`
- `connector_arguments_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `run_ref: str`
- `iteration: int = Field(ge=1, le=4)`
- `idempotency_key: str = Field(min_length=1, max_length=240)`
- `connector_status: ConnectorExecutionStatus | None = None`
- `connector_error_kind: ConnectorErrorKind | None = None`
- `connector_error_code: str | None = Field(default=None, max_length=160)`
- `approval_ref: str | None = Field(default=None, max_length=200)`
- `approval_receipt_digest: str | None = Field(default=None, pattern='^[0-9a-f]{64}$')`
- `execution_receipt_digest: str | None = Field(default=None, pattern='^[0-9a-f]{64}$')`
- `receipt: ProfitActionExecutionReceipt | None = None`
- `live_systems_changed: bool | None = False`
- `summary: str = Field(min_length=1, max_length=1000)`

#### Methods

##### `lightbulb.profit_materializer.ProfitActionMaterializationResult.to_dict`



~~~python
def to_dict() -> dict[str, Any]
~~~


Source: `lightbulb/profit_materializer.py:498`.

### `lightbulb.profit_materializer.bind_profit_action_approval`

function. Source: `lightbulb/profit_materializer.py:610`.



~~~python
bind_profit_action_approval(plan_value: ProfitWorkflowPlan | Mapping[str, Any], *, scope: DynamicWorkflowScope | Mapping[str, Any], scope_keyring: ProfitScopeKeyRing, operation_ref: str, connector_arguments: Mapping[str, Any] | BaseModel, approval_ref: str, approval_receipt_digest: str) -> ProfitActionApprovalGrant
~~~


Bind one platform approval proof to one exact plan/action/payload.

### `lightbulb.profit_materializer.materialize_profit_action`

function. Source: `lightbulb/profit_materializer.py:1555`.



~~~python
materialize_profit_action(plan_value: ProfitWorkflowPlan | Mapping[str, Any], *, scope: DynamicWorkflowScope | Mapping[str, Any], scope_keyring: ProfitScopeKeyRing, execution_scope: ExecutionScope | Mapping[str, Any], executor: ConnectorExecutor, operation_ref: str, connector_arguments: Mapping[str, Any] | BaseModel, run_ref: str, iteration: int=1, preview_only: bool=True, approval_grant: ProfitActionApprovalGrant | Mapping[str, Any] | None=None, dependency_receipts: Iterable[ProfitActionExecutionReceipt | Mapping[str, Any]]=()) -> ProfitActionMaterializationResult
~~~


Preview, propose, resume, or complete one exact profit connector write.

## Module `lightbulb.profit_primitives`

Executable proposal primitives for the ten-workflow profit flywheel.

### `lightbulb.profit_primitives.ProfitWorkflowPrimitive`

class. Source: `lightbulb/profit_primitives.py:191`.

One thin SDK adapter over a code-owned profit workflow blueprint.

#### Methods

##### `lightbulb.profit_primitives.ProfitWorkflowPrimitive.implementation_contract`



~~~python
def implementation_contract() -> dict[str, Any]
~~~


Source: `lightbulb/profit_primitives.py:214`.

### `lightbulb.profit_primitives.profit_workflow_example_inputs`

function. Source: `lightbulb/profit_primitives.py:275`.



~~~python
profit_workflow_example_inputs(workflow_id: str) -> dict[str, Any]
~~~


Return a defensive copy of one valid, proposal-only example input.

## Module `lightbulb.profit_workflow_blueprints`

Code-owned blueprints for the ten profit workflows adjacent to launch.

### `lightbulb.profit_workflow_blueprints.ProfitWorkflowValidationError`

class. Source: `lightbulb/profit_workflow_blueprints.py:282`.

A profit workflow request cannot be compiled safely.

### `lightbulb.profit_workflow_blueprints.ProfitScopeKeyRing`

class. Source: `lightbulb/profit_workflow_blueprints.py:286`.

Trusted host contract for exact-scope digests and HMAC signatures.

Fields:
- `active_key_id: str`

#### Methods

##### `lightbulb.profit_workflow_blueprints.ProfitScopeKeyRing.exact_scope_digest`



~~~python
def exact_scope_digest(*, key_id: str, scope: DynamicWorkflowScope) -> str
~~~


Source: `lightbulb/profit_workflow_blueprints.py:291`.

##### `lightbulb.profit_workflow_blueprints.ProfitScopeKeyRing.sign`



~~~python
def sign(key_id: str, domain: str, payload: Any) -> bytes
~~~


Source: `lightbulb/profit_workflow_blueprints.py:298`.

### `lightbulb.profit_workflow_blueprints.ProfitCapabilityContract`

class. Source: `lightbulb/profit_workflow_blueprints.py:301`.

Fields:
- `capability: CapabilityRef`
- `purpose: ShortText`
- `execution_kind: ExecutionKind`
- `effect: ProfitEffect`
- `availability: CapabilityAvailability`
- `notes: LongText`

### `lightbulb.profit_workflow_blueprints.ProfitWorkflowDefinition`

class. Source: `lightbulb/profit_workflow_blueprints.py:310`.

Fields:
- `workflow_id: ProfitWorkflowId`
- `ordinal: int = Field(ge=1, le=10)`
- `title: ShortText`
- `category: ShortText`
- `promise: LongText`
- `primary_metric: ProfitMetric`
- `target_direction: TargetDirection`
- `required_metrics: tuple[ProfitMetric, ...] = Field(min_length=1, max_length=8)`
- `supported_metrics: tuple[ProfitMetric, ...] = Field(min_length=1, max_length=16)`
- `evidence_capabilities: tuple[CapabilityRef, ...] = Field(min_length=1, max_length=16)`
- `action_capabilities: tuple[ProfitCapabilityContract, ...] = Field(min_length=1, max_length=8)`
- `consumes: tuple[str, ...] = Field(default_factory=tuple, max_length=12)`
- `feeds: tuple[str, ...] = Field(default_factory=tuple, max_length=12)`
- `trigger_event: CapabilityRef`
- `emits_event: CapabilityRef`

## Module `lightbulb.profit_workflow_execution`

Resumable trusted-host runner for materializable profit workflow actions.

### `lightbulb.profit_workflow_execution.ProfitWorkflowExecutionRun`

class. Source: `lightbulb/profit_workflow_execution.py:56`.

Bounded result of one preview, execution, or receipt-backed resume.

Fields:
- `schema_id: Literal['lightbulb.profit_workflow_execution_run.v1'] = Field(default=PROFIT_WORKFLOW_EXECUTION_RUN_SCHEMA, alias='schema')`
- `status: ProfitWorkflowExecutionStatus`
- `workflow_id: str`
- `plan_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `run_ref: str`
- `iteration: int = Field(ge=1, le=4)`
- `action_results: tuple[ProfitActionMaterializationResult, ...] = Field(default_factory=tuple, max_length=10)`
- `receipts: tuple[ProfitActionExecutionReceipt, ...] = Field(default_factory=tuple, max_length=10)`
- `observation_not_before: str | None = None`
- `causal_claim_ready: Literal[False] = False`
- `summary: str = Field(min_length=1, max_length=1000)`

### `lightbulb.profit_workflow_execution.run_profit_workflow_actions`

function. Source: `lightbulb/profit_workflow_execution.py:161`.



~~~python
run_profit_workflow_actions(plan_value: ProfitWorkflowPlan | Mapping[str, Any], *, scope: DynamicWorkflowScope | Mapping[str, Any], scope_keyring: ProfitScopeKeyRing, execution_scope: ExecutionScope | Mapping[str, Any], executor: ConnectorExecutor, connector_arguments: Mapping[str, Mapping[str, Any] | BaseModel], run_ref: str, iteration: int=1, preview_only: bool=True, approval_grants: Mapping[str, ProfitActionApprovalGrant | Mapping[str, Any]] | None=None, existing_receipts: Iterable[ProfitActionExecutionReceipt | Mapping[str, Any]]=()) -> ProfitWorkflowExecutionRun
~~~


Run every materializable connector action until a safe terminal state.

## Module `lightbulb.profit_workflow_runtime`

Shared evidence, economics, planning, and evaluation runtime for profit workflows.

### `lightbulb.profit_workflow_runtime.get_profit_workflow_definition`

function. Source: `lightbulb/profit_workflow_runtime.py:323`.



~~~python
get_profit_workflow_definition(workflow_id: ProfitWorkflowId | str) -> ProfitWorkflowDefinition
~~~


### `lightbulb.profit_workflow_runtime.ProfitConnectorAccountBinding`

class. Source: `lightbulb/profit_workflow_runtime.py:332`.

Fields:
- `provider: Provider`
- `connector_account_ref: ShortText`
- `receipt_key_id: str | None = Field(default=None, min_length=8, max_length=80, pattern='^[A-Za-z0-9][A-Za-z0-9._-]{7,79}$')`
- `exact_scope_digest: Sha256Digest | None = None`
- `account_hmac: Sha256Digest | None = None`

#### Methods

##### `lightbulb.profit_workflow_runtime.ProfitConnectorAccountBinding.hmac_payload`



~~~python
def hmac_payload() -> dict[str, Any]
~~~


Source: `lightbulb/profit_workflow_runtime.py:357`.

### `lightbulb.profit_workflow_runtime.ProfitContributionLedger`

class. Source: `lightbulb/profit_workflow_runtime.py:365`.

Fields:
- `currency: CurrencyCode`
- `gross_sales: Decimal = Field(ge=0, le=1000000000000)`
- `discounts: Decimal = Field(default=Decimal('0'), ge=0, le=1000000000000)`
- `refunds: Decimal = Field(default=Decimal('0'), ge=0, le=1000000000000)`
- `cogs: Decimal = Field(default=Decimal('0'), ge=0, le=1000000000000)`
- `fulfillment_cost: Decimal = Field(default=Decimal('0'), ge=0, le=1000000000000)`
- `payment_fees: Decimal = Field(default=Decimal('0'), ge=0, le=1000000000000)`
- `acquisition_cost: Decimal = Field(default=Decimal('0'), ge=0, le=1000000000000)`
- `service_cost: Decimal = Field(default=Decimal('0'), ge=0, le=1000000000000)`

#### Methods

##### `lightbulb.profit_workflow_runtime.ProfitContributionLedger.contribution_profit`



~~~python
@property
def contribution_profit() -> Decimal
~~~


Source: `lightbulb/profit_workflow_runtime.py:392`.

##### `lightbulb.profit_workflow_runtime.ProfitContributionLedger.net_revenue`



~~~python
@property
def net_revenue() -> Decimal
~~~


Source: `lightbulb/profit_workflow_runtime.py:405`.

### `lightbulb.profit_workflow_runtime.ProfitMetricEvidence`

class. Source: `lightbulb/profit_workflow_runtime.py:411`.

Fields:
- `evidence_ref: PortableRef`
- `provider: Provider`
- `connector_account_ref: ShortText | None = None`
- `subject_account_refs: tuple[ShortText, ...] = Field(default_factory=tuple, max_length=20)`
- `source_capability: CapabilityRef`
- `metric: ProfitMetric`
- `unit: MetricUnit`
- `value: Decimal`
- `currency: CurrencyCode | None = None`
- `exposure_count: int | None = Field(default=None, ge=1, le=10000000000)`
- `sample_size: int = Field(ge=0, le=10000000000)`
- `observed_at: str`
- `window_start: str`
- `window_end: str`
- `ledger: ProfitContributionLedger | None = None`
- `evidence_digest: Sha256Digest`
- `receipt_key_id: str | None = Field(default=None, min_length=8, max_length=80, pattern='^[A-Za-z0-9][A-Za-z0-9._-]{7,79}$')`
- `exact_scope_digest: Sha256Digest | None = None`
- `snapshot_hmac: Sha256Digest | None = None`

#### Methods

##### `lightbulb.profit_workflow_runtime.ProfitMetricEvidence.hmac_payload`



~~~python
def hmac_payload() -> dict[str, Any]
~~~


Source: `lightbulb/profit_workflow_runtime.py:538`.

### `lightbulb.profit_workflow_runtime.ProfitActionParameter`

class. Source: `lightbulb/profit_workflow_runtime.py:546`.

Fields:
- `name: str = Field(min_length=1, max_length=64, pattern='^[a-z][a-z0-9_]{0,63}$')`
- `value: str = Field(min_length=1, max_length=2000)`

### `lightbulb.profit_workflow_runtime.ProfitLeverCandidate`

class. Source: `lightbulb/profit_workflow_runtime.py:571`.

Fields:
- `candidate_ref: PortableRef`
- `title: ShortText`
- `capability: CapabilityRef`
- `target_account_ref: ShortText | None = None`
- `rationale: LongText`
- `parameters: tuple[ProfitActionParameter, ...] = Field(default_factory=tuple, max_length=_MAX_PARAMETERS)`
- `expected_incremental_revenue: Decimal = Field(ge=0, le=1000000000000)`
- `expected_incremental_cost: Decimal = Field(ge=0, le=1000000000000)`
- `implementation_cost: Decimal = Field(ge=0, le=1000000000000)`
- `downside_loss: Decimal = Field(ge=0, le=1000000000000)`
- `confidence: Decimal = Field(ge=0, le=1)`
- `time_to_value_days: int = Field(ge=0, le=3650)`
- `measurement_metric: ProfitMetric`
- `supported_by_evidence_refs: tuple[PortableRef, ...] = Field(default_factory=tuple, max_length=20)`
- `depends_on: tuple[PortableRef, ...] = Field(default_factory=tuple, max_length=10)`
- `mutually_exclusive_group: PortableRef | None = None`

### `lightbulb.profit_workflow_runtime.ProfitOptimizationPolicy`

class. Source: `lightbulb/profit_workflow_runtime.py:635`.

Fields:
- `target_metric: ProfitMetric`
- `target_value: Decimal`
- `max_actions: int = Field(default=3, ge=1, le=10)`
- `budget_cap: Decimal = Field(default=Decimal('10000'), ge=0, le=1000000000000)`
- `minimum_expected_profit: Decimal = Field(default=Decimal('0'), ge=0, le=1000000000000)`
- `minimum_confidence: Decimal = Field(default=Decimal('0.25'), ge=0, le=1)`
- `unverified_confidence_haircut: Decimal = Field(default=Decimal('0.50'), gt=0, le=1)`
- `minimum_sample_size: int = Field(default=100, ge=1, le=1000000000)`
- `max_observation_age_hours: int = Field(default=720, ge=1, le=8760)`
- `measurement_window_hours: int = Field(default=168, ge=1, le=2160)`
- `max_iterations: int = Field(default=3, ge=1, le=4)`

### `lightbulb.profit_workflow_runtime.PlanProfitWorkflowInput`

class. Source: `lightbulb/profit_workflow_runtime.py:670`.

Fields:
- `analysis_as_of: str`
- `plan_ref: PortableRef`
- `launch_ref: PortableRef`
- `objective: LongText`
- `account_bindings: tuple[ProfitConnectorAccountBinding, ...] = Field(default_factory=tuple, max_length=20)`
- `baseline: ProfitContributionLedger`
- `evidence: tuple[ProfitMetricEvidence, ...] = Field(default_factory=tuple, max_length=_MAX_EVIDENCE)`
- `candidates: tuple[ProfitLeverCandidate, ...] = Field(min_length=1, max_length=_MAX_CANDIDATES)`
- `policy: ProfitOptimizationPolicy`
- `source_plan_digests: tuple[Sha256Digest, ...] = Field(default_factory=tuple, max_length=20)`

### `lightbulb.profit_workflow_runtime.ProfitEvidenceScope`

class. Source: `lightbulb/profit_workflow_runtime.py:766`.

Fields:
- `status: Literal['caller_supplied_unverified', 'host_hmac_verified']`
- `receipt_key_id: str | None = Field(default=None, min_length=8, max_length=80, pattern='^[A-Za-z0-9][A-Za-z0-9._-]{7,79}$')`
- `exact_scope_digest: Sha256Digest | None = None`

### `lightbulb.profit_workflow_runtime.ProfitMetricFinding`

class. Source: `lightbulb/profit_workflow_runtime.py:797`.

Fields:
- `evidence_ref: PortableRef`
- `provider: Provider`
- `connector_account_ref: ShortText | None = None`
- `subject_account_refs: tuple[ShortText, ...] = Field(default_factory=tuple)`
- `metric: ProfitMetric`
- `value: Decimal`
- `unit: MetricUnit`
- `status: EvidenceEligibility`
- `age_hours: int = Field(ge=0, le=1000000)`
- `primary_metric: bool`
- `reason: ShortText`

### `lightbulb.profit_workflow_runtime.ProfitBaselineSummary`

class. Source: `lightbulb/profit_workflow_runtime.py:827`.

Fields:
- `currency: CurrencyCode`
- `gross_sales: Decimal`
- `net_revenue: Decimal`
- `total_attributable_cost: Decimal`
- `contribution_profit: Decimal`
- `contribution_margin_rate: Decimal | None = None`

### `lightbulb.profit_workflow_runtime.ProfitCandidateDecision`

class. Source: `lightbulb/profit_workflow_runtime.py:864`.

Fields:
- `candidate_ref: PortableRef`
- `rank: int = Field(ge=1, le=_MAX_CANDIDATES)`
- `disposition: CandidateDisposition`
- `declared_confidence: Decimal = Field(ge=0, le=1)`
- `effective_confidence: Decimal = Field(ge=0, le=1)`
- `gross_incremental_profit: Decimal`
- `risk_adjusted_profit: Decimal`
- `cash_required: Decimal = Field(ge=0)`
- `priority_score: Decimal`
- `evidence_verified: bool`
- `reason: ShortText`

### `lightbulb.profit_workflow_runtime.GovernedProfitAction`

class. Source: `lightbulb/profit_workflow_runtime.py:901`.

Fields:
- `ordinal: int = Field(ge=1, le=10)`
- `operation_ref: str = Field(min_length=1, max_length=180, pattern='^[a-z][a-z0-9_.:-]{0,179}$')`
- `candidate_ref: PortableRef`
- `title: ShortText`
- `capability: CapabilityRef`
- `execution_kind: ExecutionKind`
- `effect: ProfitEffect`
- `availability: CapabilityAvailability`
- `disposition: OperationDisposition`
- `target_account_ref: ShortText | None = None`
- `exact_scope_digest: Sha256Digest | None = None`
- `intent_parameters: tuple[ProfitActionParameter, ...] = Field(default_factory=tuple, max_length=_MAX_PARAMETERS)`
- `depends_on: tuple[str, ...] = Field(default_factory=tuple, max_length=10)`
- `expected_risk_adjusted_profit: Decimal`
- `approval_required: bool`
- `approval_unit: str | None = Field(default=None, min_length=1, max_length=500)`
- `dispatchable_by_planner: Literal[False] = False`
- `operation_digest: Sha256Digest = '0' * 64`

### `lightbulb.profit_workflow_runtime.ProfitCapabilityGap`

class. Source: `lightbulb/profit_workflow_runtime.py:964`.

Fields:
- `code: ShortText`
- `capability: CapabilityRef`
- `severity: Literal['info', 'blocking']`
- `message: LongText`

### `lightbulb.profit_workflow_runtime.ProfitEvaluationLoop`

class. Source: `lightbulb/profit_workflow_runtime.py:971`.

Fields:
- `target_metric: ProfitMetric`
- `target_unit: MetricUnit`
- `target_direction: TargetDirection`
- `target_value: Decimal`
- `minimum_sample_size: int = Field(ge=1)`
- `max_observation_age_hours: int = Field(ge=1)`
- `measurement_window_hours: int = Field(ge=1)`
- `max_iterations: int = Field(ge=1, le=4)`
- `stages: tuple[Literal['approve', 'materialize', 'observe', 'evaluate', 'revise'], ...]`
- `stop_conditions: tuple[Literal['target_met', 'iteration_limit_reached', 'approval_revoked', 'evidence_missing', 'stop_loss_triggered'], ...]`

### `lightbulb.profit_workflow_runtime.ProfitEffectBoundary`

class. Source: `lightbulb/profit_workflow_runtime.py:1018`.

Fields:
- `connector_reads: Literal[0] = 0`
- `connector_writes: Literal[0] = 0`
- `domain_actions: Literal[0] = 0`
- `approvals_consumed: Literal[0] = 0`
- `external_systems_changed: Literal[False] = False`
- `materialization_supported: Literal[False] = False`

### `lightbulb.profit_workflow_runtime.ProfitWorkflowPlan`

class. Source: `lightbulb/profit_workflow_runtime.py:1034`.

Fields:
- `schema_id: Literal['lightbulb.profit_workflow_plan.v1'] = Field(default=PROFIT_WORKFLOW_PLAN_SCHEMA, alias='schema')`
- `workflow_id: ProfitWorkflowId`
- `workflow_ordinal: int = Field(ge=1, le=10)`
- `blueprint_digest: Sha256Digest`
- `plan_ref: PortableRef`
- `launch_ref: PortableRef`
- `analysis_as_of: str`
- `objective: LongText`
- `source_plan_digests: tuple[Sha256Digest, ...]`
- `account_bindings: tuple[ProfitConnectorAccountBinding, ...]`
- `evidence_scope: ProfitEvidenceScope`
- `optimization_status: OptimizationStatus`
- `baseline: ProfitBaselineSummary`
- `metric_findings: tuple[ProfitMetricFinding, ...]`
- `candidate_decisions: tuple[ProfitCandidateDecision, ...]`
- `actions: tuple[GovernedProfitAction, ...]`
- `capability_gaps: tuple[ProfitCapabilityGap, ...]`
- `evaluation_loop: ProfitEvaluationLoop`
- `estimated_incremental_profit: Decimal`
- `estimated_post_plan_contribution_profit: Decimal`
- `estimates_are_assumptions: Literal[True] = True`
- `estimates_are_non_additive_across_workflows: Literal[True] = True`
- `effect_boundary: ProfitEffectBoundary = Field(default_factory=ProfitEffectBoundary)`
- `summary: LongText`
- `receipt_key_id: str | None = Field(default=None, min_length=8, max_length=80)`
- `exact_scope_digest: Sha256Digest | None = None`
- `plan_hmac: Sha256Digest | None = None`
- `plan_digest: Sha256Digest = '0' * 64`

#### Methods

##### `lightbulb.profit_workflow_runtime.ProfitWorkflowPlan.hmac_payload`



~~~python
def hmac_payload() -> dict[str, Any]
~~~


Source: `lightbulb/profit_workflow_runtime.py:1196`.

##### `lightbulb.profit_workflow_runtime.ProfitWorkflowPlan.to_dict`



~~~python
def to_dict() -> dict[str, Any]
~~~


Source: `lightbulb/profit_workflow_runtime.py:1204`.

### `lightbulb.profit_workflow_runtime.mint_profit_connector_account_binding`

function. Source: `lightbulb/profit_workflow_runtime.py:1336`.



~~~python
mint_profit_connector_account_binding(value: ProfitConnectorAccountBinding | Mapping[str, Any], *, scope: DynamicWorkflowScope | Mapping[str, Any], scope_keyring: ProfitScopeKeyRing, scope_key_id: str | None=None) -> ProfitConnectorAccountBinding
~~~


Seal one opaque connector-account reference to an exact host scope.

### `lightbulb.profit_workflow_runtime.mint_profit_metric_evidence`

function. Source: `lightbulb/profit_workflow_runtime.py:1408`.



~~~python
mint_profit_metric_evidence(value: ProfitMetricEvidence | Mapping[str, Any], *, scope: DynamicWorkflowScope | Mapping[str, Any], scope_keyring: ProfitScopeKeyRing, scope_key_id: str | None=None) -> ProfitMetricEvidence
~~~


Seal one host-verified metric observation with its exact workflow scope.

### `lightbulb.profit_workflow_runtime.plan_profit_workflow`

function. Source: `lightbulb/profit_workflow_runtime.py:1943`.



~~~python
plan_profit_workflow(workflow_id: ProfitWorkflowId | str, value: PlanProfitWorkflowInput | Mapping[str, Any], *, verified_scope: DynamicWorkflowScope | Mapping[str, Any] | None=None, scope_keyring: ProfitScopeKeyRing | None=None, scope_key_id: str | None=None) -> ProfitWorkflowPlan
~~~


Compile one deterministic, risk-adjusted, proposal-only profit workflow.

### `lightbulb.profit_workflow_runtime.verify_profit_workflow_plan`

function. Source: `lightbulb/profit_workflow_runtime.py:2077`.



~~~python
verify_profit_workflow_plan(value: ProfitWorkflowPlan | Mapping[str, Any], *, scope: DynamicWorkflowScope | Mapping[str, Any], scope_keyring: ProfitScopeKeyRing) -> ProfitWorkflowPlan
~~~


Revalidate and authenticate a host-bound plan before trusted use.

### `lightbulb.profit_workflow_runtime.ProfitActionExecutionReceipt`

class. Source: `lightbulb/profit_workflow_runtime.py:2129`.

Host-sealed proof that one exact planned action completed.

Fields:
- `schema_id: Literal['lightbulb.profit_action_execution_receipt.v1'] = Field(default=PROFIT_ACTION_EXECUTION_RECEIPT_SCHEMA, alias='schema')`
- `workflow_id: ProfitWorkflowId`
- `plan_digest: Sha256Digest`
- `run_ref: str = Field(min_length=1, max_length=160, pattern='^[A-Za-z0-9][A-Za-z0-9._:-]{0,159}$')`
- `iteration: int = Field(ge=1, le=4)`
- `operation_ref: str = Field(min_length=1, max_length=180, pattern='^[a-z][a-z0-9_.:-]{0,179}$')`
- `operation_digest: Sha256Digest`
- `capability: CapabilityRef`
- `target_account_ref: ShortText | None = None`
- `approval_unit: str | None = Field(default=None, min_length=1, max_length=500)`
- `approval_receipt_digest: Sha256Digest | None = None`
- `completed_at: str`
- `effect_receipt_digest: Sha256Digest`
- `receipt_key_id: str = Field(min_length=8, max_length=80)`
- `exact_scope_digest: Sha256Digest`
- `execution_hmac: Sha256Digest`
- `execution_digest: Sha256Digest = '0' * 64`

#### Methods

##### `lightbulb.profit_workflow_runtime.ProfitActionExecutionReceipt.hmac_payload`



~~~python
def hmac_payload() -> dict[str, Any]
~~~


Source: `lightbulb/profit_workflow_runtime.py:2182`.

### `lightbulb.profit_workflow_runtime.ProfitOutcomeEvidence`

class. Source: `lightbulb/profit_workflow_runtime.py:2191`.

Fields:
- `schema_id: Literal['lightbulb.profit_outcome_evidence.v1'] = Field(default=PROFIT_OUTCOME_EVIDENCE_SCHEMA, alias='schema')`
- `workflow_id: ProfitWorkflowId`
- `plan_digest: Sha256Digest`
- `run_ref: str = Field(min_length=1, max_length=160, pattern='^[A-Za-z0-9][A-Za-z0-9._:-]{0,159}$')`
- `iteration: int = Field(ge=1, le=4)`
- `commitment_ref: str = Field(min_length=1, max_length=420)`
- `action_receipts: tuple[ProfitActionExecutionReceipt, ...] = Field(min_length=1, max_length=10)`
- `observation: ProfitMetricEvidence`
- `receipt_key_id: str = Field(min_length=8, max_length=80)`
- `exact_scope_digest: Sha256Digest`
- `outcome_hmac: Sha256Digest`
- `outcome_digest: Sha256Digest = '0' * 64`

#### Methods

##### `lightbulb.profit_workflow_runtime.ProfitOutcomeEvidence.hmac_payload`



~~~python
def hmac_payload() -> dict[str, Any]
~~~


Source: `lightbulb/profit_workflow_runtime.py:2255`.

### `lightbulb.profit_workflow_runtime.ProfitWorkflowEvaluation`

class. Source: `lightbulb/profit_workflow_runtime.py:2271`.

Fields:
- `schema_id: Literal['lightbulb.profit_workflow_evaluation.v1'] = Field(default=PROFIT_WORKFLOW_EVALUATION_SCHEMA, alias='schema')`
- `workflow_id: ProfitWorkflowId`
- `plan_digest: Sha256Digest`
- `run_ref: str = Field(min_length=1, max_length=160, pattern='^[A-Za-z0-9][A-Za-z0-9._:-]{0,159}$')`
- `iteration: int = Field(ge=1, le=4)`
- `evaluated_at: str`
- `metric: ProfitMetric`
- `unit: MetricUnit`
- `observed_value: Decimal`
- `target_value: Decimal`
- `target_direction: TargetDirection`
- `decision: EvaluationDecision`
- `next_iteration: int | None = Field(default=None, ge=2, le=4)`
- `previous_evaluation_digest: Sha256Digest | None = None`
- `outcome_digest: Sha256Digest`
- `summary: LongText`
- `receipt_key_id: str = Field(min_length=8, max_length=80)`
- `exact_scope_digest: Sha256Digest`
- `evaluation_hmac: Sha256Digest`
- `evaluation_digest: Sha256Digest = '0' * 64`

#### Methods

##### `lightbulb.profit_workflow_runtime.ProfitWorkflowEvaluation.hmac_payload`



~~~python
def hmac_payload() -> dict[str, Any]
~~~


Source: `lightbulb/profit_workflow_runtime.py:2337`.

##### `lightbulb.profit_workflow_runtime.ProfitWorkflowEvaluation.to_dict`



~~~python
def to_dict() -> dict[str, Any]
~~~


Source: `lightbulb/profit_workflow_runtime.py:2345`.

### `lightbulb.profit_workflow_runtime.mint_profit_action_execution_receipt`

function. Source: `lightbulb/profit_workflow_runtime.py:2349`.



~~~python
mint_profit_action_execution_receipt(plan_value: ProfitWorkflowPlan | Mapping[str, Any], *, operation_ref: str, effect_receipt_digest: str, approval_receipt_digest: str | None=None, completed_at: datetime, run_ref: str, iteration: int, scope: DynamicWorkflowScope | Mapping[str, Any], scope_keyring: ProfitScopeKeyRing) -> ProfitActionExecutionReceipt
~~~


Mint trusted proof from one governed action result or local artifact.

### `lightbulb.profit_workflow_runtime.verify_profit_action_execution_receipt`

function. Source: `lightbulb/profit_workflow_runtime.py:2459`.



~~~python
verify_profit_action_execution_receipt(value: ProfitActionExecutionReceipt | Mapping[str, Any], *, plan: ProfitWorkflowPlan | Mapping[str, Any], scope: DynamicWorkflowScope | Mapping[str, Any], scope_keyring: ProfitScopeKeyRing) -> ProfitActionExecutionReceipt
~~~


Verify one action receipt against the current scope and authenticated plan.

### `lightbulb.profit_workflow_runtime.mint_profit_outcome_evidence`

function. Source: `lightbulb/profit_workflow_runtime.py:2480`.



~~~python
mint_profit_outcome_evidence(plan_value: ProfitWorkflowPlan | Mapping[str, Any], observation_value: ProfitMetricEvidence | Mapping[str, Any], *, action_receipts: Iterable[ProfitActionExecutionReceipt | Mapping[str, Any]], run_ref: str, iteration: int, scope: DynamicWorkflowScope | Mapping[str, Any], scope_keyring: ProfitScopeKeyRing) -> ProfitOutcomeEvidence
~~~


Bind one verified post-action observation to an exact plan/run/iteration.

### `lightbulb.profit_workflow_runtime.verify_profit_workflow_evaluation`

function. Source: `lightbulb/profit_workflow_runtime.py:2714`.



~~~python
verify_profit_workflow_evaluation(value: ProfitWorkflowEvaluation | Mapping[str, Any], *, plan: ProfitWorkflowPlan | Mapping[str, Any], scope: DynamicWorkflowScope | Mapping[str, Any], scope_keyring: ProfitScopeKeyRing) -> ProfitWorkflowEvaluation
~~~


### `lightbulb.profit_workflow_runtime.evaluate_profit_workflow_iteration`

function. Source: `lightbulb/profit_workflow_runtime.py:2748`.



~~~python
evaluate_profit_workflow_iteration(plan_value: ProfitWorkflowPlan | Mapping[str, Any], outcome_value: ProfitOutcomeEvidence | Mapping[str, Any], *, scope: DynamicWorkflowScope | Mapping[str, Any], scope_keyring: ProfitScopeKeyRing, evaluated_at: datetime, previous_evaluation: ProfitWorkflowEvaluation | Mapping[str, Any] | None=None) -> ProfitWorkflowEvaluation
~~~


Evaluate one fresh KPI window and authorize at most one next revision.

### `lightbulb.profit_workflow_runtime.ProfitFlywheelEdge`

class. Source: `lightbulb/profit_workflow_runtime.py:2868`.

Fields:
- `source: str = Field(min_length=3, max_length=160)`
- `target: str = Field(min_length=3, max_length=160)`
- `handoff: ShortText`
- `feedback: bool = False`

### `lightbulb.profit_workflow_runtime.ProfitFlywheelNode`

class. Source: `lightbulb/profit_workflow_runtime.py:2875`.

Fields:
- `workflow_id: ProfitWorkflowId`
- `plan_ref: PortableRef`
- `plan_digest: Sha256Digest`
- `optimization_status: OptimizationStatus`
- `selected_action_count: int = Field(ge=0, le=10)`
- `blocking_gap_count: int = Field(ge=0, le=100)`

### `lightbulb.profit_workflow_runtime.ProfitFlywheelPlan`

class. Source: `lightbulb/profit_workflow_runtime.py:2981`.

Fields:
- `schema_id: Literal['lightbulb.profit_flywheel_plan.v1'] = Field(default=PROFIT_FLYWHEEL_PLAN_SCHEMA, alias='schema')`
- `launch_ref: PortableRef`
- `analysis_as_of: str`
- `currency: CurrencyCode`
- `nodes: tuple[ProfitFlywheelNode, ...]`
- `edges: tuple[ProfitFlywheelEdge, ...]`
- `external_workflow_refs: tuple[str, ...] = ('gtm.plan_omnichannel_product_launch',)`
- `execution_order: tuple[str, ...]`
- `estimates_are_non_additive: Literal[True] = True`
- `materialization_supported: Literal[False] = False`
- `summary: LongText`
- `flywheel_digest: Sha256Digest = '0' * 64`

#### Methods

##### `lightbulb.profit_workflow_runtime.ProfitFlywheelPlan.to_dict`



~~~python
def to_dict() -> dict[str, Any]
~~~


Source: `lightbulb/profit_workflow_runtime.py:3072`.

### `lightbulb.profit_workflow_runtime.compile_profit_flywheel`

function. Source: `lightbulb/profit_workflow_runtime.py:3076`.



~~~python
compile_profit_flywheel(inputs_by_workflow: Mapping[ProfitWorkflowId | str, PlanProfitWorkflowInput | Mapping[str, Any]], *, verified_scope: DynamicWorkflowScope | Mapping[str, Any] | None=None, scope_keyring: ProfitScopeKeyRing | None=None, scope_key_id: str | None=None) -> ProfitFlywheelPlan
~~~


Compile all ten workflows and return a compact, content-addressed manifest.

## Module `lightbulb.project_autoresearch`

Typed facade for Spring-owned Project AutoResearch runs.

### `lightbulb.project_autoresearch.ProjectAutoResearchContractError`

class. Source: `lightbulb/project_autoresearch.py:62`.

A Spring response did not satisfy the public AutoResearch contract.

### `lightbulb.project_autoresearch.ProjectAutoResearchStartRequest`

class. Source: `lightbulb/project_autoresearch.py:116`.

Exact Spring start body; all research context remains server-owned.

Fields:
- `project_id: UUID`
- `confirm_paid_run: StrictBool`
- `idempotency_key: Annotated[StrictStr, Field(min_length=1, max_length=128, pattern=_IDEMPOTENCY_PATTERN)] | None = None`

#### Methods

##### `lightbulb.project_autoresearch.ProjectAutoResearchStartRequest.to_http_body`



~~~python
def to_http_body() -> dict[str, Any]
~~~


Source: `lightbulb/project_autoresearch.py:141`.

### `lightbulb.project_autoresearch.ProjectAutoResearchCancelRequest`

class. Source: `lightbulb/project_autoresearch.py:145`.

Exact Spring cancellation body, including server-checked confirmation.

Fields:
- `confirm_cancel: StrictBool`
- `reason: Annotated[StrictStr, Field(max_length=1000)] | None = None`
- `idempotency_key: Annotated[StrictStr, Field(min_length=1, max_length=128, pattern=_IDEMPOTENCY_PATTERN)] | None = None`

#### Methods

##### `lightbulb.project_autoresearch.ProjectAutoResearchCancelRequest.to_http_body`



~~~python
def to_http_body() -> dict[str, Any]
~~~


Source: `lightbulb/project_autoresearch.py:175`.

### `lightbulb.project_autoresearch.ProjectAutoResearchStartReceipt`

class. Source: `lightbulb/project_autoresearch.py:264`.

The 202 start variant, including the durable state as ``run_status``.

Fields:
- `status: Literal['started']`
- `run_status: ProjectAutoResearchRunState`

### `lightbulb.project_autoresearch.ProjectAutoResearchStatusReceipt`

class. Source: `lightbulb/project_autoresearch.py:271`.

The GET variant, whose ``status`` is the durable run state.

Fields:
- `status: ProjectAutoResearchRunState`

### `lightbulb.project_autoresearch.ProjectAutoResearchCancelReceipt`

class. Source: `lightbulb/project_autoresearch.py:277`.

The 202 cancellation variant returned after the canonical fence commits.

Fields:
- `status: Literal['cancelled']`

### `lightbulb.project_autoresearch.ProjectAutoResearchClient`

class. Source: `lightbulb/project_autoresearch.py:325`.

Company-pinned facade over the real ``LightbulbClient`` session path.

Fields:
- `inner: LightbulbClient`

#### Methods

##### `lightbulb.project_autoresearch.ProjectAutoResearchClient.cancel`



~~~python
def cancel(run_id: UUID | str, *, reason: str | None=None, idempotency_key: str | None=None, confirm_cancel: bool=False) -> ProjectAutoResearchCancelReceipt
~~~


Commit the canonical cancellation fence after literal confirmation.

Source: `lightbulb/project_autoresearch.py:399`.

##### `lightbulb.project_autoresearch.ProjectAutoResearchClient.start`



~~~python
def start(project_id: UUID | str, *, idempotency_key: str | None=None, confirm_paid_run: bool=False) -> ProjectAutoResearchStartReceipt
~~~


Start one server-resolved paid run after literal confirmation.

Source: `lightbulb/project_autoresearch.py:334`.

##### `lightbulb.project_autoresearch.ProjectAutoResearchClient.status`



~~~python
def status(run_id: UUID | str) -> ProjectAutoResearchStatusReceipt
~~~


Read one run through its exact current selected-company scope.

Source: `lightbulb/project_autoresearch.py:371`.

## Module `lightbulb.project_creation`

Typed, fail-closed contracts for the project-creation preflight journey.

### `lightbulb.project_creation.ProjectCreationPreflightError`

class. Source: `lightbulb/project_creation.py:271`.

The preflight stream or receipt failed authoritative validation.

### `lightbulb.project_creation.ProjectCreationDraft`

class. Source: `lightbulb/project_creation.py:302`.

The only user-authored fields accepted by the preflight request.

Fields:
- `schema_: Literal['project_creation_draft.v1'] = Field(default=PROJECT_CREATION_DRAFT_SCHEMA, alias='schema')`
- `name: Annotated[str, StringConstraints(min_length=1, max_length=PROJECT_NAME_MAX_CHARS)]`
- `instructions: Annotated[str, StringConstraints(max_length=PROJECT_INSTRUCTIONS_MAX_CHARS)] = ''`

#### Methods

##### `lightbulb.project_creation.ProjectCreationDraft.sha256`



~~~python
@property
def sha256() -> str
~~~


Source: `lightbulb/project_creation.py:338`.

### `lightbulb.project_creation.inspect_project_creation_world_ready`

function. Source: `lightbulb/project_creation.py:441`.



~~~python
inspect_project_creation_world_ready(*, name: str='', instructions: str='', tenant_id: object=None, company_id: object=None, project_id: object=None, participant_role: str='agent_worker', experience_lens: str='agent_protocol', play_style: str=PROJECT_PLAY_STYLE_DEFAULT, secure_receipt_verification: bool=True) -> dict[str, Any]
~~~


Return a local, non-sensitive readiness manifest for project review.

### `lightbulb.project_creation.PreflightCriticalityFinding`

class. Source: `lightbulb/project_creation.py:590`.

Compiler-owned explanation for why uncertainty blocks, warns, or does not.

Fields:
- `field: GapField`
- `finding: NonEmpty500`
- `plan_impact: NonEmpty500`
- `evidence_refs: list[NonEmpty1000] = Field(min_length=1, max_length=5)`
- `confidence: float = Field(ge=0.0, le=1.0, allow_inf_nan=False)`
- `resolution_prompt: Optional500`
- `resolution_mode: Literal['ask_user', 'bounded_public_research', 'state_assumption', 'none']`
- `resolution_cost: Literal['one_user_answer', 'one_bounded_research_pass', 'no_external_call', 'none']`
- `disposition: Literal['block', 'warn', 'assume', 'ignore']`

### `lightbulb.project_creation.ProjectCreationPreflight`

class. Source: `lightbulb/project_creation.py:784`.

Strict wire model emitted by the project preflight agent.

Fields:
- `schema_: Literal['project_creation_preflight.v1'] = Field(alias='schema')`
- `status: Literal['needs_input', 'ready']`
- `analysis_status: Literal['degraded', 'completed']`
- `analysis_reason: NonEmpty300 | None = None`
- `project_name: Annotated[str, StringConstraints(min_length=1, max_length=PROJECT_NAME_MAX_CHARS), _utf16_maximum(PROJECT_NAME_MAX_CHARS)]`
- `product_brief: NonEmpty2000`
- `facts: list[PreflightFact] = Field(max_length=2)`
- `assumptions: list[PreflightAssumption] = Field(max_length=5)`
- `conflicts: list[PreflightConflict] = Field(max_length=3)`
- `criticality_findings: list[PreflightCriticalityFinding] | None = Field(default=None, max_length=3)`
- `critical_gaps: list[PreflightCriticalGap] = Field(max_length=3)`
- `open_questions: list[PreflightOpenQuestion] = Field(max_length=3)`
- `next_question: Optional500`
- `coverage: PreflightCoverage`
- `coverage_map: list[PreflightCoverageEntry] = Field(min_length=8, max_length=8)`
- `coverage_score: float = Field(ge=0.0, le=1.0, allow_inf_nan=False)`
- `research_queries: list[PreflightResearchQuery] = Field(max_length=2)`
- `research: PreflightResearch`
- `safety: PreflightSafety`
- `cost_policy: PreflightCostPolicy`

### `lightbulb.project_creation.ProjectCreationEpisodeScope`

class. Source: `lightbulb/project_creation.py:977`.

Exact company-level scope carried by the trusted episode SSE event.

Fields:
- `tenant_id: str`
- `company_id: str`
- `execution_id: str`

### `lightbulb.project_creation.ProjectCreationPreflightRefinement`

class. Source: `lightbulb/project_creation.py:993`.

Trusted, bounded chain binding retained on a refined receipt.

Fields:
- `schema_: Literal['project_creation_preflight_refinement.v1'] = Field(default='project_creation_preflight_refinement.v1', alias='schema')`
- `execution_id: str`
- `root_execution_id: str`
- `parent_execution_id: str`
- `prior_episode_id: Annotated[str, StringConstraints(pattern='^ep_[0-9a-f]{32}$')]`
- `prior_draft_sha256: Annotated[str, StringConstraints(pattern='^[0-9a-f]{64}$')]`
- `refinement_depth: int = Field(ge=1, le=PROJECT_PREFLIGHT_MAX_REFINEMENT_DEPTH)`
- `target_field: GapField`
- `question: NonEmpty500`
- `answer_sha256: Annotated[str, StringConstraints(pattern='^[0-9a-f]{64}$')]`
- `draft_sha256: Annotated[str, StringConstraints(pattern='^[0-9a-f]{64}$')]`

### `lightbulb.project_creation.ProjectCreationPreflightReceipt`

class. Source: `lightbulb/project_creation.py:1057`.

Trusted execution and episode receipts bound to the normalized draft.

Fields:
- `schema_: Literal['project_creation_preflight_receipt.v1'] = Field(default=PROJECT_CREATION_PREFLIGHT_RECEIPT_SCHEMA, alias='schema')`
- `preflight_execution_id: str`
- `episode_id: Annotated[str, StringConstraints(pattern='^ep_[0-9a-f]{32}$')]`
- `episode_scope: ProjectCreationEpisodeScope`
- `draft: ProjectCreationDraft`
- `draft_sha256: Annotated[str, StringConstraints(pattern='^[0-9a-f]{64}$')]`
- `preflight: ProjectCreationPreflight`
- `refinement: ProjectCreationPreflightRefinement | None = None`

#### Methods

##### `lightbulb.project_creation.ProjectCreationPreflightReceipt.creation_allowed`



~~~python
@property
def creation_allowed() -> bool
~~~


Whether this trusted receipt may create its reversible project container.

Source: `lightbulb/project_creation.py:1116`.

## Module `lightbulb.project_feedback`

Typed, fail-closed semantic feedback for project-creation preflights.

### `lightbulb.project_feedback.ProjectPreflightFeedbackDimensions`

class. Source: `lightbulb/project_feedback.py:57`.

The only human judgments accepted by the semantic gate.

Fields:
- `helpfulness: SemanticFeedbackValue`
- `calibrated_criticality: SemanticFeedbackValue`
- `factual_grounding: SemanticFeedbackValue`

#### Methods

##### `lightbulb.project_feedback.ProjectPreflightFeedbackDimensions.positive_gate_passed`



~~~python
@property
def positive_gate_passed() -> bool
~~~


Source: `lightbulb/project_feedback.py:83`.

### `lightbulb.project_feedback.ProjectPreflightSemanticFeedbackReceipt`

class. Source: `lightbulb/project_feedback.py:108`.

Server-authored receipt for one exact, append-only feedback decision.

Fields:
- `feedback_id: CanonicalFeedbackId`
- `episode_id: CanonicalEpisodeId`
- `execution_id: str`
- `tenant_id: str`
- `company_id: str`
- `project_id: None`
- `user_id: str`
- `dimensions: ProjectPreflightFeedbackDimensions`
- `semantic_gate_passed: bool`
- `base_canonical_sha256: CanonicalSha256`
- `structural_evidence_sha256: CanonicalSha256`
- `receipt_sha256: CanonicalSha256`
- `retain_until: datetime`
- `created_at: datetime`

## Module `lightbulb.project_game`

Truthful, read-only campaign projections for human and agent project workers.

### `lightbulb.project_game.normalize_project_play_style`

function. Source: `lightbulb/project_game.py:109`.



~~~python
normalize_project_play_style(value: object, *, legacy_fallback: bool=False) -> str
~~~


Validate a creation preference or safely read a legacy plan value.

### `lightbulb.project_game.inspect_project_game_campaign`

function. Source: `lightbulb/project_game.py:5643`.



~~~python
inspect_project_game_campaign(*, project: object=None, plan: object=None, business_cockpit: object=None) -> dict[str, Any]
~~~


Build a bounded local campaign manifest from observed JSON objects.

## Module `lightbulb.project_game_snapshot`

Validation for the server-owned project snapshot.

### `lightbulb.project_game_snapshot.normalize_project_game_snapshot_uuid`

function. Source: `lightbulb/project_game_snapshot.py:183`.



~~~python
normalize_project_game_snapshot_uuid(value: Any, field: str) -> str
~~~


Return a canonical lower-case UUID for snapshot paths and scope headers.

### `lightbulb.project_game_snapshot.validate_project_game_snapshot`

function. Source: `lightbulb/project_game_snapshot.py:313`.



~~~python
validate_project_game_snapshot(value: Any, *, expected_tenant_id: Any, expected_company_id: Any, expected_project_id: Any) -> dict[str, Any]
~~~


Validate and detach one exact-scoped, non-authoritative snapshot.

## Module `lightbulb.project_learning_client`

Typed public facade for governed Project learning-run lifecycle calls.

### `lightbulb.project_learning_client.ProjectLearningContractError`

class. Source: `lightbulb/project_learning_client.py:173`.

Sanitized local request/response contract failure.

### `lightbulb.project_learning_client.ProjectLearningRunPrepareInput`

class. Source: `lightbulb/project_learning_client.py:188`.

Scope-free, secret-free input for one queued-run preparation.

Fields:
- `training_pack_receipt_id: UUID`
- `primary_metric: str = Field(min_length=1, max_length=256)`
- `runtime: LearningRuntime = 'automl'`
- `request_id: UUID | None = None`
- `direction: Literal['maximize', 'minimize'] = 'maximize'`
- `minimum_improvement: Decimal = Decimal('0.010000')`
- `max_cost_usd: Decimal = Decimal('0.000000')`
- `max_platform_cost_usd: Decimal = Decimal('5.000000')`
- `max_gpu_seconds: StrictInt = Field(default=3600, ge=0, le=31536000)`
- `max_tokens: StrictInt = Field(default=100000, ge=0, le=1000000000000)`
- `max_steps: StrictInt = Field(default=10000, ge=0, le=1000000000000)`
- `provider_account_fingerprint: str | None = None`
- `provider_binding_expires_at: FutureDatetime | None = None`
- `max_attempts: StrictInt = Field(default=3, ge=1, le=10)`
- `lease_seconds: StrictInt = Field(default=300, ge=60, le=7200)`
- `preemptible: StrictBool = True`
- `confirmation: Literal['publish_dataset_and_create_queued_learning_run']`
- `idempotency_key: str | None = None`

### `lightbulb.project_learning_client.LearningCapacityAdmission`

class. Source: `lightbulb/project_learning_client.py:267`.

Fresh, exact, redacted capacity decision accepted by Spring.

Fields:
- `schema_id: Literal['lightbulb.learning-capacity-plan.v1'] = Field(alias='schema')`
- `decision_id: str = Field(min_length=1, max_length=128)`
- `runtime: CapacityRuntime`
- `admission: Literal['admit']`
- `target_instances: StrictInt = Field(ge=1, le=10000)`
- `expires_at: FutureDatetime`
- `secrets_redacted: Literal[True]`

### `lightbulb.project_learning_client.ProjectLearningRunAdmissionInput`

class. Source: `lightbulb/project_learning_client.py:289`.

Scope-free, secret-free input for capacity/budget admission.

Fields:
- `runtime: LearningRuntime`
- `capacity_admission: LearningCapacityAdmission`
- `operator_approved: StrictBool = False`
- `confirmation: Literal['reserve_budget_and_admit_durable_learning_run']`
- `idempotency_key: str | None = None`

### `lightbulb.project_learning_client.ProjectLearningRunPreparedReceipt`

class. Source: `lightbulb/project_learning_client.py:317`.

Sanitized preparation summary, not a portable Spring authority receipt.

Fields:
- `schema_id: Literal['lightbulb.project_learning_run_receipt.v1'] = Field(alias='schema')`
- `receipt_id: UUID`
- `receipt_sha256: str = Field(pattern='^[0-9a-f]{64}$')`
- `recorded_at: AwareDatetime`
- `request_id: UUID`
- `training_pack_receipt_id: UUID`
- `project_id: UUID`
- `learning_run_id: UUID`
- `runtime: LearningRuntime`
- `memory_status: MemoryRunStatus`
- `status: Literal['durable_learning_run_queued', 'durable_learning_run_created']`
- `idempotent: StrictBool`
- `actor_binding: ActorBindingAssurance = 'spring_enforced_not_locally_reverified'`
- `dataset_custody_verified: Literal[True]`
- `worker_claim_completed: Literal[False]`
- `training_executed: Literal[False]`
- `production_promotion_authorized: Literal[False]`

### `lightbulb.project_learning_client.ProjectLearningRunAdmittedReceipt`

class. Source: `lightbulb/project_learning_client.py:346`.

Sanitized admission summary, not a portable Spring authority receipt.

Fields:
- `schema_id: Literal['lightbulb.project_learning_run_admission_receipt.v1'] = Field(alias='schema')`
- `receipt_id: UUID`
- `receipt_sha256: str = Field(pattern='^[0-9a-f]{64}$')`
- `recorded_at: AwareDatetime`
- `project_id: UUID`
- `learning_run_id: UUID`
- `prepared_run_receipt_id: UUID`
- `runtime: LearningRuntime`
- `memory_status: Literal['admitted']`
- `status: Literal['durable_learning_run_admitted']`
- `idempotent: StrictBool`
- `actor_binding: ActorBindingAssurance = 'spring_enforced_not_locally_reverified'`
- `capacity_decision_id: str`
- `operator_approval_required: StrictBool`
- `operator_approved: StrictBool`
- `memory_claim_candidate: Literal[True]`
- `worker_claim_completed: Literal[False]`
- `training_executed: Literal[False]`
- `production_promotion_authorized: Literal[False]`

### `lightbulb.project_learning_client.ProjectLearningRunInspection`

class. Source: `lightbulb/project_learning_client.py:374`.

One prepared run plus presence of later stored receipts.

Fields:
- `prepared_receipt_id: UUID`
- `project_id: UUID`
- `learning_run_id: UUID`
- `runtime: LearningRuntime`
- `prepared_status: Literal['durable_learning_run_queued', 'durable_learning_run_created']`
- `last_observed_memory_status: MemoryRunStatus`
- `admission_receipt_observed: StrictBool`
- `execution_receipt_observed: StrictBool`
- `terminal_result_receipt_observed: StrictBool`

### `lightbulb.project_learning_client.ProjectLearningRunLedger`

class. Source: `lightbulb/project_learning_client.py:393`.

Normalized last-observed ledger; never live worker telemetry.

Fields:
- `schema_id: Literal['lightbulb.project_learning_run_ledger.v1'] = Field(alias='schema')`
- `project_id: UUID`
- `status: LedgerStatus`
- `run_count: StrictInt = Field(ge=0, le=50)`
- `admitted_count: StrictInt = Field(ge=0, le=50)`
- `execution_observation_count: StrictInt = Field(ge=0, le=50)`
- `terminal_result_count: StrictInt = Field(ge=0, le=50)`
- `runs: list[ProjectLearningRunInspection]`
- `latest_run_id: UUID | None`
- `actor_binding: ActorBindingAssurance = 'spring_enforced_not_locally_reverified'`
- `statuses_are_last_observed_not_live_worker_telemetry: Literal[True]`
- `raw_lease_tokens_exposed: Literal[False]`
- `worker_claim_inferred: Literal[False]`
- `training_execution_inferred: Literal[False]`
- `production_promotion_authorized: Literal[False]`

### `lightbulb.project_learning_client.ProjectLearningClient`

class. Source: `lightbulb/project_learning_client.py:671`.

Typed facade over one authenticated selected-company client session.

#### Methods

##### `lightbulb.project_learning_client.ProjectLearningClient.admit`



~~~python
def admit(project_id: Any, learning_run_id: Any, request: ProjectLearningRunAdmissionInput | Mapping[str, Any]) -> ProjectLearningRunAdmittedReceipt
~~~


Reserve capacity/budget and make a run claimable without executing it.

Source: `lightbulb/project_learning_client.py:1267`.

##### `lightbulb.project_learning_client.ProjectLearningClient.inspect`



~~~python
def inspect(project_id: Any, *, limit: int=25) -> ProjectLearningRunLedger
~~~


Alias for :meth:`list`, emphasizing last-observed semantics.

Source: `lightbulb/project_learning_client.py:1111`.

##### `lightbulb.project_learning_client.ProjectLearningClient.list`



~~~python
def list(project_id: Any, *, limit: int=25) -> ProjectLearningRunLedger
~~~


Read last-observed Spring receipts without refreshing execution.

Source: `lightbulb/project_learning_client.py:820`.

##### `lightbulb.project_learning_client.ProjectLearningClient.prepare`



~~~python
def prepare(project_id: Any, request: ProjectLearningRunPrepareInput | Mapping[str, Any]) -> ProjectLearningRunPreparedReceipt
~~~


Publish immutable custody and prepare a run without executing it.

Source: `lightbulb/project_learning_client.py:1116`.

## Module `lightbulb.project_learning_events`

Sanitized Project learning receipts for the durable SDK event runtime.

### `lightbulb.project_learning_events.ProjectLearningReceiptValidationError`

class. Source: `lightbulb/project_learning_events.py:133`.

A source receipt cannot be safely projected into a workflow event.

### `lightbulb.project_learning_events.ProjectLearningWorkflowEventPayload`

class. Source: `lightbulb/project_learning_events.py:246`.

The complete allowlist permitted into a durable workflow event.

Fields:
- `source_receipt_schema: ReceiptSchema`
- `source_receipt_id: CanonicalUuid`
- `source_receipt_sha256: Sha256`
- `project_id: CanonicalUuid`
- `learning_run_id: CanonicalUuid`
- `runtime: LearningRuntime`
- `status: PrintableText`
- `memory_status: PrintableText`
- `prepared_run_receipt_id: CanonicalUuid | None = None`
- `admission_receipt_id: CanonicalUuid | None = None`
- `memory_snapshot_sha256: Sha256 | None = None`
- `attempt: int | None = Field(default=None, ge=1, le=10)`
- `checkpoint_count: int | None = Field(default=None, ge=0, le=100)`
- `terminal_result_observed: bool | None = None`

### `lightbulb.project_learning_events.project_learning_receipt_to_workflow_event`

function. Source: `lightbulb/project_learning_events.py:346`.



~~~python
project_learning_receipt_to_workflow_event(receipt: Mapping[str, Any], *, project_ref: str, expected_project_id: str) -> WorkflowEventEnvelope
~~~


Project one complete raw Spring learning receipt into a sanitized event.

## Module `lightbulb.project_learning_result_evaluations`

Independent Project Learning result and human-admission contracts.

### `lightbulb.project_learning_result_evaluations.build_project_learning_result_admission_request`

function. Source: `lightbulb/project_learning_result_evaluations.py:47`.



~~~python
build_project_learning_result_admission_request(decision: Any, rationale: Any, *, confirm_admission: bool=False) -> dict[str, Any]
~~~


Build one immutable human decision over an eligible technical result.

## Module `lightbulb.project_learning_reviews`

Human-reviewed shadow-learning admission for exact project mission receipts.

### `lightbulb.project_learning_reviews.build_project_learning_review_request`

function. Source: `lightbulb/project_learning_reviews.py:63`.



~~~python
build_project_learning_review_request(*, mission_run_receipt_id: Any, mission_action_receipt_id: Any, outcome_receipt_id: Any, decision: Any, skill_trial_arm: Any, selected_skill_ids: Sequence[Any] | None, label: Any, reason: Any, review_id: Any=None, evidence_refs: Sequence[Any] | None=None) -> dict[str, Any]
~~~


Grade one exact mission chain for shadow training; never update live state.

## Module `lightbulb.project_learning_runs`

Governed Project Training Quest request contracts.

### `lightbulb.project_learning_runs.build_project_learning_run_prepare_request`

function. Source: `lightbulb/project_learning_runs.py:120`.



~~~python
build_project_learning_run_prepare_request(training_pack_receipt_id: Any, primary_metric: Any, *, runtime: str='automl', request_id: Any=None, direction: str='maximize', minimum_improvement: Any='0.010000', max_cost_usd: Any='0.000000', max_platform_cost_usd: Any='5.000000', max_gpu_seconds: Any=3600, max_tokens: Any=100000, max_steps: Any=10000, provider_account_fingerprint: Any=None, provider_binding_expires_at: Any=None, max_attempts: Any=3, lease_seconds: Any=300, preemptible: bool=True, confirm_prepare: bool=False) -> dict[str, Any]
~~~


Build one exact, explicitly confirmed queued-run preparation request.

### `lightbulb.project_learning_runs.build_project_learning_run_admission_request`

function. Source: `lightbulb/project_learning_runs.py:214`.



~~~python
build_project_learning_run_admission_request(runtime: Any, capacity_admission: Mapping[str, Any], *, operator_approved: bool=False, confirm_admission: bool=False) -> dict[str, Any]
~~~


Build a separate cost/capacity admission request for an existing queued run.

## Module `lightbulb.project_missions`

Bounded mission-run requests for the shared human/agent project campaign.

### `lightbulb.project_missions.build_project_mission_run_start`

function. Source: `lightbulb/project_missions.py:74`.



~~~python
build_project_mission_run_start(*, mission_briefing: Mapping[str, Any], run_id: Any=None, play_style_id: Any=None, skill_trial_arm: Any=None, selected_skill_ids: Sequence[Any] | None=None, context_source_refs: Sequence[Any] | None=None, note: Any=None) -> dict[str, Any]
~~~


Lock the exact current briefing and planned shadow loadout before action.

### `lightbulb.project_missions.build_project_mission_action_binding`

function. Source: `lightbulb/project_missions.py:161`.



~~~python
build_project_mission_action_binding(*, mission_run_receipt_id: Any, action_event_id: Any, binding_id: Any=None, note: Any=None) -> dict[str, Any]
~~~


Bind one later same-project action event to a pre-existing mission run.

## Module `lightbulb.project_outcomes`

Typed request helpers for the shared Project Outcome Ledger.

### `lightbulb.project_outcomes.build_project_business_outcome_observation`

function. Source: `lightbulb/project_outcomes.py:110`.



~~~python
build_project_business_outcome_observation(*, metric_id: Any, metric_label: Any, direction: Any, baseline_value: Any, observed_value: Any, unit: Any=None, observed_at: Any=None, observation_id: Any=None, source_kind: str='human_attestation', source_event_id: Any=None, evidence_refs: Sequence[Any] | None=None, links: Mapping[str, Any] | None=None, note: Any=None) -> dict[str, Any]
~~~


Build the exact bounded body accepted by human and agent ledger paths.

## Module `lightbulb.project_policy`

Typed builders for the shared Project Strategy Lab contract.

### `lightbulb.project_policy.build_project_policy_assignment`

function. Source: `lightbulb/project_policy.py:159`.



~~~python
build_project_policy_assignment(*, metric_id: Any, direction: Any, actions: Sequence[Mapping[str, Any]], chosen_action_id: Any, behavior_policy: Mapping[str, Any], candidate_policies: Sequence[Mapping[str, Any]], assignment_id: Any=None, unit: Any=None, decided_at: Any=None, source_kind: str='human_attestation', source_event_id: Any=None, evidence_refs: Sequence[Any] | None=None, links: Mapping[str, Any] | None=None, note: Any=None) -> dict[str, Any]
~~~


Build the exact immutable assignment body accepted by Spring.

### `lightbulb.project_policy.build_project_policy_evaluation_request`

function. Source: `lightbulb/project_policy.py:236`.



~~~python
build_project_policy_evaluation_request(*, behavior_policy_id: Any, candidate_policy_id: Any, metric_id: Any, pairs: Sequence[Mapping[str, Any]], evaluation_id: Any=None, note: Any=None) -> dict[str, Any]
~~~


Build a bounded request from exact assignment/outcome receipt ids.

## Module `lightbulb.project_runtime`

Project-scoped composition and execution for custom agentic workflows.

### `lightbulb.project_runtime.RetryPolicy`

class. Source: `lightbulb/project_runtime.py:47`.

Bounded deterministic retries for durable primitive failures.

Fields:
- `max_attempts: int = Field(default=1, ge=1, le=10)`
- `initial_delay_seconds: int = Field(default=5, ge=1, le=86400)`
- `backoff_multiplier: int = Field(default=2, ge=1, le=10)`
- `max_delay_seconds: int = Field(default=300, ge=1, le=604800)`

#### Methods

##### `lightbulb.project_runtime.RetryPolicy.delay_seconds`



~~~python
def delay_seconds(failed_attempt: int) -> int
~~~


Return capped exponential backoff after a failed attempt.

Source: `lightbulb/project_runtime.py:65`.

### `lightbulb.project_runtime.ProjectPolicy`

class. Source: `lightbulb/project_runtime.py:75`.

Fields:
- `writes_require_approval: Literal[True] = True`
- `default_preview_only: bool = True`
- `max_workflow_steps: int = Field(default=50, ge=1, le=1000)`
- `max_step_visits: int = Field(default=3, ge=1, le=100)`
- `retry_policy: RetryPolicy = Field(default_factory=RetryPolicy)`

### `lightbulb.project_runtime.ProjectWorkflowStep`

class. Source: `lightbulb/project_runtime.py:85`.

Fields:
- `id: str`
- `primitive_ref: str`
- `input_mapping: Dict[str, Any] = Field(default_factory=dict)`
- `routes: Dict[str, str] = Field(default_factory=dict)`
- `next_step: str | None = None`

### `lightbulb.project_runtime.ProjectWorkflow`

class. Source: `lightbulb/project_runtime.py:128`.

Fields:
- `key: str`
- `version: str = Field(default='1.0.0', min_length=1, max_length=80)`
- `title: str = Field(min_length=1, max_length=300)`
- `trigger_event: str = Field(default='manual.requested', min_length=1, max_length=160)`
- `entry_step: str`
- `steps: list[ProjectWorkflowStep] = Field(min_length=1, max_length=1000)`

### `lightbulb.project_runtime.LightbulbProject`

class. Source: `lightbulb/project_runtime.py:170`.

Fields:
- `schema_id: str = Field(default=PROJECT_SPEC_SCHEMA, alias='schema')`
- `project_ref: str`
- `hosted_project_id: UUID | None = None`
- `name: str = Field(min_length=1, max_length=300)`
- `version: str = Field(default='1.0.0', min_length=1, max_length=80)`
- `primitive_refs: list[str] = Field(min_length=1, max_length=1000)`
- `connector_tools: list[str] = Field(default_factory=list, max_length=5000)`
- `secret_refs: Dict[str, str] = Field(default_factory=dict)`
- `workflows: list[ProjectWorkflow] = Field(default_factory=list, max_length=1000)`
- `policy: ProjectPolicy = Field(default_factory=ProjectPolicy)`
- `metadata: Dict[str, Any] = Field(default_factory=dict)`

#### Methods

##### `lightbulb.project_runtime.LightbulbProject.to_dict`



~~~python
def to_dict() -> Dict[str, Any]
~~~


Source: `lightbulb/project_runtime.py:225`.

### `lightbulb.project_runtime.ProjectValidationSeverity`

class. Source: `lightbulb/project_runtime.py:229`.

### `lightbulb.project_runtime.ProjectValidationIssue`

class. Source: `lightbulb/project_runtime.py:234`.

Fields:
- `severity: ProjectValidationSeverity`
- `code: str`
- `message: str`
- `ref: str | None = None`

### `lightbulb.project_runtime.ProjectValidationResult`

class. Source: `lightbulb/project_runtime.py:243`.

Fields:
- `schema_id: str = Field(default=PROJECT_VALIDATION_SCHEMA, alias='schema')`
- `valid: bool`
- `project_ref: str`
- `issues: list[ProjectValidationIssue] = Field(default_factory=list)`

#### Methods

##### `lightbulb.project_runtime.ProjectValidationResult.to_dict`



~~~python
def to_dict() -> Dict[str, Any]
~~~


Source: `lightbulb/project_runtime.py:251`.

### `lightbulb.project_runtime.ProjectWorkflowRunStatus`

class. Source: `lightbulb/project_runtime.py:267`.

### `lightbulb.project_runtime.ProjectWorkflowRun`

class. Source: `lightbulb/project_runtime.py:328`.

Fields:
- `schema_id: str = Field(default=PROJECT_WORKFLOW_RUN_SCHEMA, alias='schema')`
- `run_ref: str`
- `project_ref: str`
- `workflow_key: str`
- `status: ProjectWorkflowRunStatus`
- `step_runs: list[ProjectWorkflowStepRun] = Field(default_factory=list)`
- `events: list[PrimitiveEvent] = Field(default_factory=list)`
- `paused_step: str | None = None`
- `resume_at: datetime | None = None`
- `blockers: list[PrimitiveBlocker] = Field(default_factory=list)`

#### Methods

##### `lightbulb.project_runtime.ProjectWorkflowRun.to_dict`



~~~python
def to_dict() -> Dict[str, Any]
~~~


Source: `lightbulb/project_runtime.py:342`.

### `lightbulb.project_runtime.BindingResolutionError`

class. Source: `lightbulb/project_runtime.py:369`.

### `lightbulb.project_runtime.ProjectRuntime`

class. Source: `lightbulb/project_runtime.py:481`.

#### Methods

##### `lightbulb.project_runtime.ProjectRuntime.bind_workflow_learning_record`



~~~python
def bind_workflow_learning_record(run: ProjectWorkflowRun, *, scope: Any, skill_search_receipt: Any, typed_inputs: Any, typed_outputs: Any, evidence: Any, policy: Any, used_skill_binding_sha256s: Any=()) -> Any
~~~


Bind a completed standard run to proposal-only learning evidence.

Source: `lightbulb/project_runtime.py:552`.

##### `lightbulb.project_runtime.ProjectRuntime.durable`



~~~python
def durable(checkpoint_store: Any=None) -> Any
~~~


Add revisioned checkpoints, scheduling, events, and worker leases.

Source: `lightbulb/project_runtime.py:499`.

##### `lightbulb.project_runtime.ProjectRuntime.execute_primitive`



~~~python
def execute_primitive(primitive_ref: str, inputs: Mapping[str, Any], *, preview_only: bool | None=None, approval_refs: Mapping[str, str] | None=None, connector_account_refs: Mapping[str, str] | None=None, run_ref: str | None=None, idempotency_key: str | None=None, tenant_ref: str='authenticated', company_ref: str='selected', actor_ref: str | None=None) -> PrimitiveExecutionResult[Any]
~~~


Source: `lightbulb/project_runtime.py:648`.

##### `lightbulb.project_runtime.ProjectRuntime.implementation_manifest`



~~~python
def implementation_manifest() -> Dict[str, Any]
~~~


Source: `lightbulb/project_runtime.py:540`.

##### `lightbulb.project_runtime.ProjectRuntime.open_primitive_run`



~~~python
def open_primitive_run(*, run_ref: str, idempotency_key: str | None=None, preview_only: bool | None=None, approval_refs: Mapping[str, str] | None=None, connector_account_refs: Mapping[str, str] | None=None, tenant_ref: str='authenticated', company_ref: str='selected', actor_ref: str | None=None, workflow_key: str | None=None, source: str='lightbulb_project_runtime') -> PrimitiveRunSession
~~~


Open the Project adapter over the shared Executable Primitive Runtime.

Source: `lightbulb/project_runtime.py:606`.

##### `lightbulb.project_runtime.ProjectRuntime.run_workflow`



~~~python
def run_workflow(workflow_key: str, inputs: Mapping[str, Any], *, preview_only: bool | None=None, approval_refs: Mapping[str, str] | None=None, connector_account_refs: Mapping[str, str] | None=None, run_ref: str | None=None, idempotency_key: str | None=None, tenant_ref: str='authenticated', company_ref: str='selected', actor_ref: str | None=None) -> ProjectWorkflowRun
~~~


Source: `lightbulb/project_runtime.py:679`.

##### `lightbulb.project_runtime.ProjectRuntime.validate`



~~~python
def validate() -> ProjectValidationResult
~~~


Source: `lightbulb/project_runtime.py:510`.

## Module `lightbulb.project_science`

Typed builders for the shared Project Science Ledger.

### `lightbulb.project_science.build_project_science_evidence_observation`

function. Source: `lightbulb/project_science.py:123`.



~~~python
build_project_science_evidence_observation(*, stage: Any, summary: Any, business_metric_id: Any, expected_direction: Any, artifact_kind: Any, artifact_system: Any, artifact_reference: Any, artifact_digest_sha256: Any, producer_role: Any, tool_names: Sequence[Any] | None=None, skill_ids: Sequence[Any] | None=None, parent_receipt_ids: Sequence[Any] | None=None, artifact_schema: Any=None, observed_at: Any=None, evidence_id: Any=None, source_kind: str='human_attestation', source_event_id: Any=None, evidence_refs: Sequence[Any] | None=None) -> dict[str, Any]
~~~


Build the exact bounded body accepted by human and worker ledger paths.

## Module `lightbulb.project_shadow_learner_updates`

Bounded Project shadow-learner update contracts.

### `lightbulb.project_shadow_learner_updates.build_project_shadow_learner_target`

function. Source: `lightbulb/project_shadow_learner_updates.py:84`.



~~~python
build_project_shadow_learner_target(*, skill_id: Any, skill_handle: Any, expected_active_skill_revision: Any, expected_active_instruction_sha256: Any, expected_champion_candidate_id: Any, expected_champion_instruction_sha256: Any) -> dict[str, Any]
~~~


Build the only supported mutation target: one isolated Memory shadow slot.

### `lightbulb.project_shadow_learner_updates.normalize_project_shadow_learner_target`

function. Source: `lightbulb/project_shadow_learner_updates.py:126`.



~~~python
normalize_project_shadow_learner_target(value: Any) -> dict[str, Any]
~~~


Reject target widening before a worker can call the internal route.

### `lightbulb.project_shadow_learner_updates.build_project_shadow_learner_update_request`

function. Source: `lightbulb/project_shadow_learner_updates.py:157`.



~~~python
build_project_shadow_learner_update_request(*, update_id: Any, admission_receipt_id: Any, target: Any, confirm_update: bool=False) -> dict[str, Any]
~~~


Build an immutable apply request without sending it.

### `lightbulb.project_shadow_learner_updates.build_project_shadow_learner_rollback_request`

function. Source: `lightbulb/project_shadow_learner_updates.py:181`.



~~~python
build_project_shadow_learner_rollback_request(*, rollback_id: Any, confirm_rollback: bool=False) -> dict[str, Any]
~~~


Build an immutable rollback request without supplying a replacement state.

## Module `lightbulb.recovery_ingestion`

Durable, exact-scope ingestion for abandoned-checkout recovery.

### `lightbulb.recovery_ingestion.recovery_ingestion_scope_fingerprint`

function. Source: `lightbulb/recovery_ingestion.py:196`.



~~~python
recovery_ingestion_scope_fingerprint(scope: DynamicWorkflowScope | Mapping[str, Any]) -> str
~~~


Opaque full-scope partition for local ingestion checkpoints.

### `lightbulb.recovery_ingestion.ShopifyRecoveryMoney`

class. Source: `lightbulb/recovery_ingestion.py:217`.

Fields:
- `amount: Decimal`
- `currency_code: str = Field(alias='currencyCode', pattern='^[A-Z]{3}$')`

### `lightbulb.recovery_ingestion.ShopifyRecoveryMoneySet`

class. Source: `lightbulb/recovery_ingestion.py:227`.

Fields:
- `shop_money: ShopifyRecoveryMoney = Field(alias='shopMoney')`

### `lightbulb.recovery_ingestion.ShopifyRecoveryCustomer`

class. Source: `lightbulb/recovery_ingestion.py:231`.

Fields:
- `id: str`
- `email: str | None = Field(default=None, repr=False, max_length=998)`
- `display_name: str | None = Field(default=None, alias='displayName', max_length=500)`

### `lightbulb.recovery_ingestion.ShopifyRecoveryVariant`

class. Source: `lightbulb/recovery_ingestion.py:249`.

Fields:
- `price: Decimal`

### `lightbulb.recovery_ingestion.ShopifyRecoveryLineItem`

class. Source: `lightbulb/recovery_ingestion.py:258`.

Fields:
- `title: str = Field(min_length=1, max_length=500)`
- `quantity: int = Field(ge=1, le=1000000)`
- `variant: ShopifyRecoveryVariant | None = None`

### `lightbulb.recovery_ingestion.ShopifyRecoveryLineItemEdge`

class. Source: `lightbulb/recovery_ingestion.py:264`.

Fields:
- `node: ShopifyRecoveryLineItem`

### `lightbulb.recovery_ingestion.ShopifyRecoveryLineItems`

class. Source: `lightbulb/recovery_ingestion.py:268`.

Fields:
- `edges: tuple[ShopifyRecoveryLineItemEdge, ...] = Field(max_length=10)`

### `lightbulb.recovery_ingestion.ShopifyAbandonedCheckout`

class. Source: `lightbulb/recovery_ingestion.py:277`.

Exact normalized node emitted by the Rust Shopify adapter.

Fields:
- `id: str`
- `abandoned_checkout_url: str | None = Field(default=None, alias='abandonedCheckoutUrl', repr=False, max_length=2048)`
- `created_at: str = Field(alias='createdAt')`
- `updated_at: str = Field(alias='updatedAt')`
- `subtotal_price_set: ShopifyRecoveryMoneySet | None = Field(default=None, alias='subtotalPriceSet')`
- `total_line_items_price_set: ShopifyRecoveryMoneySet | None = Field(default=None, alias='totalLineItemsPriceSet')`
- `customer: ShopifyRecoveryCustomer | None = Field(default=None, repr=False)`
- `line_items: ShopifyRecoveryLineItems = Field(alias='lineItems')`
- `line_items_subtotal_price: ShopifyRecoveryMoney | None = Field(default=None, alias='lineItemsSubtotalPrice')`

#### Methods

##### `lightbulb.recovery_ingestion.ShopifyAbandonedCheckout.checkout_digest`



~~~python
@property
def checkout_digest() -> str
~~~


Source: `lightbulb/recovery_ingestion.py:337`.

### `lightbulb.recovery_ingestion.ShopifyAbandonedCheckoutOutput`

class. Source: `lightbulb/recovery_ingestion.py:341`.

Fields:
- `schema_id: Literal['lightbulb.shopify_abandoned_checkout_output.v1'] = Field(default=SHOPIFY_ABANDONED_CHECKOUT_OUTPUT_SCHEMA, alias='schema')`
- `abandoned_checkouts: tuple[ShopifyAbandonedCheckout, ...] = Field(max_length=_MAX_PROVIDER_PAGE_SIZE)`
- `total: int = Field(ge=0, le=_MAX_PROVIDER_PAGE_SIZE)`
- `next_cursor: str | None = Field(default=None, max_length=2048)`

### `lightbulb.recovery_ingestion.RecoveryEnrichmentFacts`

class. Source: `lightbulb/recovery_ingestion.py:381`.

Host-owned business facts absent from the Shopify checkout response.

Fields:
- `launch_ref: str = Field(pattern='^[a-z][a-z0-9_-]{0,63}$')`
- `gmail_account_ref: str = Field(min_length=1, max_length=200)`
- `expires_at: str`
- `consent_status: ConsentStatus`
- `cohort: RecoveryCohort`
- `inventory_available: bool`
- `prior_recovery_contacts: int = Field(ge=0, le=100)`
- `frequency_cap: int = Field(default=2, ge=1, le=5)`
- `baseline: ProfitContributionLedger`
- `historical_recovery_ledger: ProfitContributionLedger`
- `historical_sample_size: int = Field(ge=1, le=1000000000)`
- `historical_window_start: str`
- `historical_window_end: str`
- `expected_incremental_revenue: Decimal = Field(ge=0, le=1000000000)`
- `expected_incremental_cost: Decimal = Field(ge=0, le=1000000000)`
- `expected_confidence: Decimal = Field(gt=0, le=1)`
- `target_recovered_profit: Decimal = Field(ge=0, le=1000000000)`
- `minimum_margin_rate: Decimal = Field(default=Decimal('0.10'), ge=0, le=1)`
- `discount_percentage: Decimal | None = Field(default=None, gt=0, le=50)`
- `discount_expires_at: str | None = None`
- `email_subject: str = Field(min_length=1, max_length=998)`
- `reminder_body_template: str = Field(min_length=1, max_length=20000)`
- `incentive_body_template: str | None = Field(default=None, min_length=1, max_length=20000)`
- `measurement_window_hours: int = Field(default=72, ge=1, le=720)`
- `minimum_sample_size: int = Field(default=1, ge=1, le=1000000000)`
- `max_observation_age_hours: int = Field(default=168, ge=1, le=8760)`
- `max_iterations: int = Field(default=2, ge=1, le=4)`

### `lightbulb.recovery_ingestion.RecoveryEnrichmentRequest`

class. Source: `lightbulb/recovery_ingestion.py:458`.

Transient exact read handed to a trusted host enrichment authority.

Fields:
- `schema_id: Literal['lightbulb.recovery_enrichment_request.v1'] = Field(default=RECOVERY_ENRICHMENT_REQUEST_SCHEMA, alias='schema')`
- `ingestion_key: str = Field(pattern='^[0-9a-f]{64}$')`
- `scope: DynamicWorkflowScope`
- `exact_scope_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `project_id: UUID`
- `shopify_account_ref: str = Field(min_length=1, max_length=200)`
- `source_provenance: ConnectorExecutionProvenance`
- `checkout: ShopifyAbandonedCheckout = Field(repr=False)`
- `requested_at: str`
- `request_digest: str = Field(default='0' * 64, pattern='^[0-9a-f]{64}$')`

### `lightbulb.recovery_ingestion.RecoveryIngestionEnrichment`

class. Source: `lightbulb/recovery_ingestion.py:503`.

Short-lived host HMAC over all facts used to construct one case.

Fields:
- `schema_id: Literal['lightbulb.recovery_ingestion_enrichment.v1'] = Field(default=RECOVERY_ENRICHMENT_ATTESTATION_SCHEMA, alias='schema')`
- `request_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `ingestion_key: str = Field(pattern='^[0-9a-f]{64}$')`
- `checkout_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `source_request_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `source_receipt_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `case_input: AbandonedRecoveryCaseInput`
- `attested_at: str`
- `valid_until: str`
- `receipt_key_id: str = Field(min_length=8, max_length=80)`
- `exact_scope_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `attestation_hmac: str = Field(pattern='^[0-9a-f]{64}$')`
- `attestation_digest: str = Field(default='0' * 64, pattern='^[0-9a-f]{64}$')`

#### Methods

##### `lightbulb.recovery_ingestion.RecoveryIngestionEnrichment.hmac_payload`



~~~python
def hmac_payload() -> dict[str, Any]
~~~


Source: `lightbulb/recovery_ingestion.py:548`.

### `lightbulb.recovery_ingestion.RecoveryEnrichmentAuthority`

class. Source: `lightbulb/recovery_ingestion.py:558`.

Trusted host authority for consent, stock, frequency, and economics.

#### Methods

##### `lightbulb.recovery_ingestion.RecoveryEnrichmentAuthority.attest`



~~~python
def attest(request: RecoveryEnrichmentRequest) -> RecoveryIngestionEnrichment
~~~


Source: `lightbulb/recovery_ingestion.py:561`.

### `lightbulb.recovery_ingestion.RecoverySecretResolver`

class. Source: `lightbulb/recovery_ingestion.py:567`.

Resolve raw contact/URL/code transiently at planning or dispatch time.

#### Methods

##### `lightbulb.recovery_ingestion.RecoverySecretResolver.resolve`



~~~python
def resolve(enrichment: RecoveryIngestionEnrichment, *, scope: DynamicWorkflowScope) -> RecoveryResolvedSecrets
~~~


Source: `lightbulb/recovery_ingestion.py:570`.

### `lightbulb.recovery_ingestion.recovery_ingestion_key`

function. Source: `lightbulb/recovery_ingestion.py:578`.



~~~python
recovery_ingestion_key(*, scope_fingerprint: str, shopify_account_ref: str, checkout_ref: str, checkout_version: str) -> str
~~~


### `lightbulb.recovery_ingestion.mint_recovery_ingestion_enrichment`

function. Source: `lightbulb/recovery_ingestion.py:602`.



~~~python
mint_recovery_ingestion_enrichment(request_value: RecoveryEnrichmentRequest | Mapping[str, Any], facts_value: RecoveryEnrichmentFacts | Mapping[str, Any], *, resolved_secrets: RecoveryResolvedSecrets | Mapping[str, Any], attested_at: datetime, valid_until: datetime, scope_keyring: ProfitScopeKeyRing, scope_key_id: str | None=None) -> RecoveryIngestionEnrichment
~~~


Host helper that derives source-bound hashes and HMAC-seals enrichment.

### `lightbulb.recovery_ingestion.verify_recovery_ingestion_enrichment`

function. Source: `lightbulb/recovery_ingestion.py:748`.



~~~python
verify_recovery_ingestion_enrichment(value: RecoveryIngestionEnrichment | Mapping[str, Any], *, request: RecoveryEnrichmentRequest, now: datetime, scope_keyring: ProfitScopeKeyRing) -> RecoveryIngestionEnrichment
~~~


### `lightbulb.recovery_ingestion.RecoveryIngestionCheckpoint`

class. Source: `lightbulb/recovery_ingestion.py:847`.

Immutable privacy-safe handoff from ingestion to approval/dispatch.

Fields:
- `schema_id: Literal['lightbulb.recovery_ingestion_checkpoint.v1'] = Field(default=RECOVERY_INGESTION_CHECKPOINT_SCHEMA, alias='schema')`
- `ingestion_key: str = Field(pattern='^[0-9a-f]{64}$')`
- `scope_fingerprint: str = Field(pattern='^[0-9a-f]{64}$')`
- `project_ref: str = Field(min_length=1, max_length=200)`
- `exact_scope_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `shopify_account_ref: str = Field(min_length=1, max_length=200)`
- `expected_tool_version: int = Field(ge=1)`
- `expected_tenant_connector_id: UUID`
- `expected_route_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `checkout_ref: str = Field(min_length=1, max_length=200)`
- `checkout_version: str`
- `checkout_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `source_provenance: ConnectorExecutionProvenance`
- `enrichment: RecoveryIngestionEnrichment`
- `recovery_case: AbandonedRecoveryCase`
- `recovery_plan: AbandonedRecoveryPlan`
- `created_at: str`
- `checkpoint_digest: str = Field(default='0' * 64, pattern='^[0-9a-f]{64}$')`

### `lightbulb.recovery_ingestion.RecoveryIngestionFailure`

class. Source: `lightbulb/recovery_ingestion.py:913`.

Fields:
- `checkout_ref: str = Field(min_length=1, max_length=200)`
- `checkout_version: str`
- `code: Literal['contact_unavailable', 'enrichment_failed', 'secret_resolution_failed', 'planning_failed', 'checkpoint_conflict']`

### `lightbulb.recovery_ingestion.RecoveryIngestionRunResult`

class. Source: `lightbulb/recovery_ingestion.py:930`.

Fields:
- `schema_id: Literal['lightbulb.recovery_ingestion_run.v1'] = Field(default=RECOVERY_INGESTION_RUN_SCHEMA, alias='schema')`
- `status: Literal['completed', 'partial']`
- `source_receipt_digests: tuple[str, ...] = Field(min_length=1, max_length=_MAX_PAGES_PER_RUN)`
- `next_cursor: str | None = Field(default=None, max_length=2048)`
- `discovered: int = Field(ge=0, le=_MAX_ROWS_PER_RUN)`
- `planned: int = Field(ge=0, le=_MAX_ROWS_PER_RUN)`
- `replayed: int = Field(ge=0, le=_MAX_ROWS_PER_RUN)`
- `failures: tuple[RecoveryIngestionFailure, ...] = Field(max_length=_MAX_ROWS_PER_RUN)`
- `checkpoints: tuple[RecoveryIngestionCheckpoint, ...] = Field(max_length=_MAX_ROWS_PER_RUN)`

### `lightbulb.recovery_ingestion.RecoveryIngestionRepository`

class. Source: `lightbulb/recovery_ingestion.py:974`.

Fields:
- `scope_fingerprint: str`

#### Methods

##### `lightbulb.recovery_ingestion.RecoveryIngestionRepository.get`



~~~python
def get(ingestion_key: str) -> RecoveryIngestionCheckpoint | None
~~~


Source: `lightbulb/recovery_ingestion.py:977`.

##### `lightbulb.recovery_ingestion.RecoveryIngestionRepository.put`



~~~python
def put(checkpoint: RecoveryIngestionCheckpoint) -> None
~~~


Source: `lightbulb/recovery_ingestion.py:979`.

### `lightbulb.recovery_ingestion.InMemoryRecoveryIngestionRepository`

class. Source: `lightbulb/recovery_ingestion.py:982`.

#### Methods

##### `lightbulb.recovery_ingestion.InMemoryRecoveryIngestionRepository.get`



~~~python
def get(ingestion_key: str) -> RecoveryIngestionCheckpoint | None
~~~


Source: `lightbulb/recovery_ingestion.py:990`.

##### `lightbulb.recovery_ingestion.InMemoryRecoveryIngestionRepository.put`



~~~python
def put(checkpoint: RecoveryIngestionCheckpoint) -> None
~~~


Source: `lightbulb/recovery_ingestion.py:1001`.

### `lightbulb.recovery_ingestion.JsonFileRecoveryIngestionRepository`

class. Source: `lightbulb/recovery_ingestion.py:1021`.

Immutable atomic checkpoint store for one host/shared filesystem.

#### Methods

##### `lightbulb.recovery_ingestion.JsonFileRecoveryIngestionRepository.get`



~~~python
def get(ingestion_key: str) -> RecoveryIngestionCheckpoint | None
~~~


Source: `lightbulb/recovery_ingestion.py:1060`.

##### `lightbulb.recovery_ingestion.JsonFileRecoveryIngestionRepository.put`



~~~python
def put(checkpoint: RecoveryIngestionCheckpoint) -> None
~~~


Source: `lightbulb/recovery_ingestion.py:1086`.

### `lightbulb.recovery_ingestion.RecoveryIngestionError`

class. Source: `lightbulb/recovery_ingestion.py:1140`.

A bounded ingestion run could not establish trusted read custody.

### `lightbulb.recovery_ingestion.RecoveryIngestionWorker`

class. Source: `lightbulb/recovery_ingestion.py:1144`.

Host-started bounded read→attest→case→plan ingestion worker.

#### Methods

##### `lightbulb.recovery_ingestion.RecoveryIngestionWorker.resolve_dispatch_secrets`



~~~python
def resolve_dispatch_secrets(checkpoint: RecoveryIngestionCheckpoint) -> RecoveryResolvedSecrets
~~~


Resolve but never persist raw secrets for later approved dispatch.

Source: `lightbulb/recovery_ingestion.py:1346`.

##### `lightbulb.recovery_ingestion.RecoveryIngestionWorker.run_once`



~~~python
def run_once(*, now: datetime, limit: int=20, cursor: str | None=None) -> RecoveryIngestionRunResult
~~~


Process at most 250 rows across 20-row governed provider pages.

Source: `lightbulb/recovery_ingestion.py:1355`.

## Module `lightbulb.recursive_agents`

Typed public contract for governed recursive Lightbulb agent runs.

### `lightbulb.recursive_agents.runtime_agent_id`

function. Source: `lightbulb/recursive_agents.py:94`.



~~~python
runtime_agent_id(runtime_action_id: Any) -> str
~~~


Build the opaque recursive reference returned for an approved action.

### `lightbulb.recursive_agents.RecursiveAgentPolicy`

class. Source: `lightbulb/recursive_agents.py:108`.

Finite limits and an optional agent allowlist for one recursive run.

Fields:
- `max_depth: int = 2`
- `max_total_nodes: int = 8`
- `max_children: int = 3`
- `max_tokens: int = 120000`
- `max_cost_usd: float = 25.0`
- `max_runtime_seconds: int = 300`
- `max_repl_steps: int = 12`
- `max_delegation_context_bytes: int = 4096`
- `max_total_delegation_context_bytes: int = 32768`
- `root_budget_fraction: float = 0.5`
- `child_budget_fraction: float = 0.3`
- `allowed_agent_ids: Tuple[str, ...] = ()`

#### Methods

##### `lightbulb.recursive_agents.RecursiveAgentPolicy.from_value`



~~~python
def from_value(value: 'RecursiveAgentPolicy | Dict[str, Any] | None') -> 'RecursiveAgentPolicy'
~~~


Source: `lightbulb/recursive_agents.py:229`.

##### `lightbulb.recursive_agents.RecursiveAgentPolicy.to_dict`



~~~python
def to_dict() -> Dict[str, Any]
~~~


Source: `lightbulb/recursive_agents.py:209`.

### `lightbulb.recursive_agents.build_recursive_agent_inputs`

function. Source: `lightbulb/recursive_agents.py:266`.



~~~python
build_recursive_agent_inputs(inputs: Dict[str, Any] | None, policy: RecursiveAgentPolicy | Dict[str, Any] | None, *, execution_id: str | uuid.UUID | None=None) -> Dict[str, Any]
~~~


## Module `lightbulb.released_authority`

Fail-closed release authority contract for governed Lightbulb execution.

### `lightbulb.released_authority.released_authority_digest`

function. Source: `lightbulb/released_authority.py:35`.



~~~python
released_authority_digest(value: Any) -> str
~~~


Return SHA-256 over portable canonical JSON.

### `lightbulb.released_authority.AuthorityEffect`

class. Source: `lightbulb/released_authority.py:75`.

### `lightbulb.released_authority.EndpointAvailability`

class. Source: `lightbulb/released_authority.py:80`.

### `lightbulb.released_authority.EndpointAuthorityClass`

class. Source: `lightbulb/released_authority.py:85`.

### `lightbulb.released_authority.CredentialMechanism`

class. Source: `lightbulb/released_authority.py:90`.

### `lightbulb.released_authority.ApprovalPolicyClass`

class. Source: `lightbulb/released_authority.py:96`.

### `lightbulb.released_authority.RecoverySupport`

class. Source: `lightbulb/released_authority.py:102`.

### `lightbulb.released_authority.ConnectorCertificationState`

class. Source: `lightbulb/released_authority.py:109`.

### `lightbulb.released_authority.ProductionEnablementState`

class. Source: `lightbulb/released_authority.py:114`.

### `lightbulb.released_authority.GovernedEndpointAuthority`

class. Source: `lightbulb/released_authority.py:120`.

Fields:
- `endpoint_id: str = Field(min_length=1, max_length=200)`
- `method: Literal['GET', 'POST']`
- `path: str = Field(min_length=1, max_length=500)`
- `availability: EndpointAvailability`
- `authority_class: EndpointAuthorityClass`
- `required_feature_gates: tuple[str, ...] = Field(min_length=1, max_length=20)`
- `source_path: str`

### `lightbulb.released_authority.FeatureGateAuthority`

class. Source: `lightbulb/released_authority.py:164`.

Fields:
- `name: str`
- `default_value: str = Field(max_length=1000)`
- `production_value: str = Field(max_length=1000)`
- `dangerous: bool`
- `source_paths: tuple[str, ...] = Field(min_length=1, max_length=20)`

### `lightbulb.released_authority.CatalogToolAuthority`

class. Source: `lightbulb/released_authority.py:190`.

Fields:
- `name: str`
- `version: int = Field(ge=1)`

### `lightbulb.released_authority.ReviewedCatalogAuthority`

class. Source: `lightbulb/released_authority.py:203`.

Fields:
- `catalog_id: str = Field(min_length=1, max_length=200)`
- `name: str = Field(min_length=1, max_length=160)`
- `version: int = Field(ge=1)`
- `effect: AuthorityEffect`
- `tools: tuple[CatalogToolAuthority, ...] = Field(min_length=1, max_length=1000)`
- `catalog_digest: str = ''`
- `source_paths: tuple[str, ...] = Field(min_length=1, max_length=20)`

### `lightbulb.released_authority.ReleasedToolAuthority`

class. Source: `lightbulb/released_authority.py:262`.

Fields:
- `tool_name: str`
- `tool_version: int = Field(ge=1)`
- `provider: str = Field(min_length=1, max_length=64)`
- `effect: AuthorityEffect`
- `catalog_id: str = Field(min_length=1, max_length=200)`
- `credential_mechanism: CredentialMechanism`
- `approval_policy_class: ApprovalPolicyClass`
- `recovery_support: RecoverySupport`
- `production_recoverable: bool`
- `certification_state: ConnectorCertificationState`
- `certification_evidence_refs: tuple[str, ...] = Field(default_factory=tuple)`
- `production_enablement: ProductionEnablementState`
- `production_allowlisted: bool`
- `native_connector_required: bool`
- `exact_tool_binding_required: bool`
- `immutable_target_required: bool`
- `source_paths: tuple[str, ...] = Field(min_length=1, max_length=MAX_RELEASED_TOOL_SOURCE_PATHS)`

### `lightbulb.released_authority.ConnectorPairAuthority`

class. Source: `lightbulb/released_authority.py:352`.

Fields:
- `pair_id: str = Field(min_length=1, max_length=200)`
- `provider: str = Field(min_length=1, max_length=64)`
- `write_tool: str`
- `read_tool: str`
- `certification_state: ConnectorCertificationState`
- `certification_evidence_refs: tuple[str, ...] = Field(default_factory=tuple)`
- `production_enablement: ProductionEnablementState`

### `lightbulb.released_authority.RequiredMigrationAuthority`

class. Source: `lightbulb/released_authority.py:407`.

Fields:
- `version: str`
- `path: str`
- `sha256: str`

### `lightbulb.released_authority.AuthorityDocumentationContract`

class. Source: `lightbulb/released_authority.py:440`.

Fields:
- `generated_path: str`
- `claim_scan_globs: tuple[str, ...] = Field(min_length=1, max_length=20)`
- `claim_language_version: Literal['lightbulb.authority_claims.v1'] = 'lightbulb.authority_claims.v1'`

### `lightbulb.released_authority.FinancialApprovalLifecycleAuthority`

class. Source: `lightbulb/released_authority.py:475`.

Fields:
- `service_source_path: str`
- `worker_source_path: str`
- `scheduler_source_path: str`
- `scheduler_enabled_by_default: Literal[False]`
- `operator_rollout_state: Literal['DARK_DISABLED']`

### `lightbulb.released_authority.ReleasedFinancialApprovalAuthority`

class. Source: `lightbulb/released_authority.py:492`.

Fields:
- `approval_policy_class: ApprovalPolicyClass`
- `controlled_write_tools: tuple[str, ...] = Field(min_length=12, max_length=12)`
- `operational_classifier_tools: tuple[str, ...] = Field(min_length=9, max_length=9)`
- `unavailable_provider_fact_tools: tuple[str, ...] = Field(min_length=3, max_length=3)`
- `classifier_source_path: str`
- `provider_dispatch_surface: Literal['GOVERNED_WORKER_ONLY']`
- `public_direct_finance_surface: Literal['UNSHIPPED']`
- `direct_provider_mcp_runtime_state: Literal['DISABLED_SUPPRESSED_UNTIL_CANONICAL_GCE']`
- `dark_posture_source_paths: tuple[str, ...] = Field(min_length=22, max_length=22)`
- `emergency_authority_state: Literal['DARK_DISABLED']`
- `lifecycle: FinancialApprovalLifecycleAuthority`

### `lightbulb.released_authority.WorkflowPublicationAuthority`

class. Source: `lightbulb/released_authority.py:621`.

Fields:
- `completion_state: Literal['COMPLETE_SLICE5']`
- `transactional_publication_kinds: tuple[Literal['DIRECT_STEP_REQUEST', 'HITL_DECISION', 'HITL_REQUEST', 'STEP_REQUEST', 'WORKFLOW_DLQ', 'WORKFLOW_EVENT', 'WORKFLOW_REQUEST'], ...] = Field(min_length=7, max_length=7)`
- `payload_protection: Literal['DEDICATED_AES256_GCM_REQUIRED']`
- `production_relay_enabled: Literal[True]`
- `remaining_blockers: tuple[str, ...] = Field(min_length=0, max_length=0)`
- `configuration_source_paths: tuple[str, ...] = Field(min_length=23, max_length=23)`
- `persistence_source_paths: tuple[str, ...] = Field(min_length=19, max_length=19)`
- `spring_authority_source_paths: tuple[str, ...] = Field(min_length=28, max_length=28)`
- `worker_enforcement_source_paths: tuple[str, ...] = Field(min_length=4, max_length=4)`
- `operations_source_paths: tuple[str, ...] = Field(min_length=10, max_length=10)`
- `documentation_source_paths: tuple[str, ...] = Field(min_length=2, max_length=2)`
- `test_source_paths: tuple[str, ...] = Field(min_length=34, max_length=34)`

### `lightbulb.released_authority.ReleasedAuthorityLookupError`

class. Source: `lightbulb/released_authority.py:717`.

Raised when a caller requests authority absent from the released contract.

### `lightbulb.released_authority.ReleasedAuthorityManifest`

class. Source: `lightbulb/released_authority.py:721`.

Fields:
- `schema_name: Literal['lightbulb.released_authority_manifest.v1', 'lightbulb.released_authority_manifest.v2'] = Field(default=RELEASED_AUTHORITY_SCHEMA, alias='schema')`
- `version: Literal['1.0.0', '2.0.0'] = RELEASED_AUTHORITY_VERSION`
- `release_posture: Literal['DARK_BASELINE'] = 'DARK_BASELINE'`
- `production_enablement: ProductionEnablementState`
- `production_flyway_baseline: str`
- `endpoints: tuple[GovernedEndpointAuthority, ...]`
- `feature_gates: tuple[FeatureGateAuthority, ...] = Field(min_length=1)`
- `catalogs: tuple[ReviewedCatalogAuthority, ...]`
- `tools: tuple[ReleasedToolAuthority, ...]`
- `financial_approval: ReleasedFinancialApprovalAuthority`
- `workflow_publication: WorkflowPublicationAuthority | None = None`
- `connector_pairs: tuple[ConnectorPairAuthority, ...]`
- `required_migrations: tuple[RequiredMigrationAuthority, ...]`
- `documentation: AuthorityDocumentationContract`
- `source_file_digests: dict[str, str] = Field(min_length=1)`
- `manifest_digest: str = ''`

#### Methods

##### `lightbulb.released_authority.ReleasedAuthorityManifest.require_catalog`



~~~python
def require_catalog(catalog_id: str) -> ReviewedCatalogAuthority
~~~


Source: `lightbulb/released_authority.py:984`.

##### `lightbulb.released_authority.ReleasedAuthorityManifest.require_feature_gate`



~~~python
def require_feature_gate(name: str) -> FeatureGateAuthority
~~~


Source: `lightbulb/released_authority.py:991`.

##### `lightbulb.released_authority.ReleasedAuthorityManifest.require_tool`



~~~python
def require_tool(tool_name: str) -> ReleasedToolAuthority
~~~


Source: `lightbulb/released_authority.py:977`.

### `lightbulb.released_authority.ReleasedAuthorityManifestV2`

class. Source: `lightbulb/released_authority.py:999`.

Exact current v2 contract used to generate the public JSON Schema.

Fields:
- `schema_name: Literal['lightbulb.released_authority_manifest.v2'] = Field(default=RELEASED_AUTHORITY_SCHEMA, alias='schema')`
- `version: Literal['2.0.0'] = RELEASED_AUTHORITY_VERSION`
- `workflow_publication: WorkflowPublicationAuthority`

### `lightbulb.released_authority.load_released_authority_manifest`

function. Source: `lightbulb/released_authority.py:1010`.



~~~python
load_released_authority_manifest(path: str | Path) -> ReleasedAuthorityManifest
~~~


Load and semantically verify one checked-in released-authority artifact.

## Module `lightbulb.runtime_outcomes`

Sanitized runtime outcome telemetry for SDK business primitives.

### `lightbulb.runtime_outcomes.RuntimeOutcome`

class. Source: `lightbulb/runtime_outcomes.py:30`.

Fields:
- `schema_id: str = Field(default=RUNTIME_OUTCOME_SCHEMA, alias='schema')`
- `primitive_ref: str = Field(min_length=3, max_length=200)`
- `status: str = Field(min_length=1, max_length=80)`
- `latency_ms: float = Field(ge=0)`
- `approval_state: str = Field(default='not_required', max_length=80)`
- `error_kind: str | None = Field(default=None, max_length=120)`
- `occurred_at: datetime = Field(default_factory=lambda: datetime.now(timezone.utc))`
- `harness: str = Field(default='lightbulb_sdk', max_length=120)`
- `project_ref: str | None = Field(default=None, max_length=128)`
- `workflow_key: str | None = Field(default=None, max_length=128)`
- `run_ref: str | None = Field(default=None, max_length=200)`
- `step_id: str | None = Field(default=None, max_length=128)`
- `scope_fingerprint: str | None = Field(default=None, pattern='^[0-9a-f]{64}$')`

#### Methods

##### `lightbulb.runtime_outcomes.RuntimeOutcome.to_dict`



~~~python
def to_dict() -> dict[str, Any]
~~~


Source: `lightbulb/runtime_outcomes.py:47`.

##### `lightbulb.runtime_outcomes.RuntimeOutcome.to_improvement_dict`



~~~python
def to_improvement_dict() -> dict[str, Any]
~~~


Return only fields accepted by the proposal-only improvement loop.

Source: `lightbulb/runtime_outcomes.py:50`.

### `lightbulb.runtime_outcomes.RuntimeOutcomeRecorder`

class. Source: `lightbulb/runtime_outcomes.py:69`.

#### Methods

##### `lightbulb.runtime_outcomes.RuntimeOutcomeRecorder.drain`



~~~python
def drain() -> list[RuntimeOutcome]
~~~


Source: `lightbulb/runtime_outcomes.py:74`.

##### `lightbulb.runtime_outcomes.RuntimeOutcomeRecorder.record`



~~~python
def record(outcome: RuntimeOutcome) -> None
~~~


Source: `lightbulb/runtime_outcomes.py:70`.

##### `lightbulb.runtime_outcomes.RuntimeOutcomeRecorder.snapshot`



~~~python
def snapshot() -> list[RuntimeOutcome]
~~~


Source: `lightbulb/runtime_outcomes.py:72`.

### `lightbulb.runtime_outcomes.InMemoryOutcomeRecorder`

class. Source: `lightbulb/runtime_outcomes.py:77`.

Thread-safe bounded recorder suitable for one SDK or worker process.

#### Methods

##### `lightbulb.runtime_outcomes.InMemoryOutcomeRecorder.drain`



~~~python
def drain() -> list[RuntimeOutcome]
~~~


Source: `lightbulb/runtime_outcomes.py:95`.

##### `lightbulb.runtime_outcomes.InMemoryOutcomeRecorder.record`



~~~python
def record(outcome: RuntimeOutcome) -> None
~~~


Source: `lightbulb/runtime_outcomes.py:86`.

##### `lightbulb.runtime_outcomes.InMemoryOutcomeRecorder.snapshot`



~~~python
def snapshot() -> list[RuntimeOutcome]
~~~


Source: `lightbulb/runtime_outcomes.py:91`.

### `lightbulb.runtime_outcomes.JsonlOutcomeRecorder`

class. Source: `lightbulb/runtime_outcomes.py:161`.

Process-local durable recorder using replace-on-drain JSON Lines storage.

#### Methods

##### `lightbulb.runtime_outcomes.JsonlOutcomeRecorder.drain`



~~~python
def drain() -> list[RuntimeOutcome]
~~~


Source: `lightbulb/runtime_outcomes.py:232`.

##### `lightbulb.runtime_outcomes.JsonlOutcomeRecorder.record`



~~~python
def record(outcome: RuntimeOutcome) -> None
~~~


Source: `lightbulb/runtime_outcomes.py:201`.

##### `lightbulb.runtime_outcomes.JsonlOutcomeRecorder.snapshot`



~~~python
def snapshot() -> list[RuntimeOutcome]
~~~


Source: `lightbulb/runtime_outcomes.py:227`.

### `lightbulb.runtime_outcomes.CompositeOutcomeRecorder`

class. Source: `lightbulb/runtime_outcomes.py:272`.

Fan out records while exposing the first recorder as the local queue.

#### Methods

##### `lightbulb.runtime_outcomes.CompositeOutcomeRecorder.drain`



~~~python
def drain() -> list[RuntimeOutcome]
~~~


Source: `lightbulb/runtime_outcomes.py:295`.

##### `lightbulb.runtime_outcomes.CompositeOutcomeRecorder.record`



~~~python
def record(outcome: RuntimeOutcome) -> None
~~~


Source: `lightbulb/runtime_outcomes.py:280`.

##### `lightbulb.runtime_outcomes.CompositeOutcomeRecorder.snapshot`



~~~python
def snapshot() -> list[RuntimeOutcome]
~~~


Source: `lightbulb/runtime_outcomes.py:292`.

### `lightbulb.runtime_outcomes.improvement_outcomes`

function. Source: `lightbulb/runtime_outcomes.py:299`.



~~~python
improvement_outcomes(values: Iterable[RuntimeOutcome]) -> list[dict[str, Any]]
~~~


### `lightbulb.runtime_outcomes.outcome_recorder_from_env`

function. Source: `lightbulb/runtime_outcomes.py:305`.



~~~python
outcome_recorder_from_env(*, tenant_id: str | None=None, company_id: str | None=None) -> RuntimeOutcomeRecorder
~~~


Use durable JSONL telemetry when explicitly configured, else bounded memory.

## Module `lightbulb.sdk.client`

Curated public clients for the stable Lightbulb SDK surface.

### `lightbulb.sdk.client.Lightbulb`

class. Source: `lightbulb/sdk/client.py:26`.

Stable synchronous SDK facade.

Pass an existing :class:`~lightbulb.client.LightbulbClient` to preserve its
authentication, selected-company context, cookies, and connection pool, or
pass ``base_url`` and ``auth`` to construct one.

#### Methods

##### `lightbulb.sdk.client.Lightbulb.__enter__`



~~~python
def __enter__() -> 'Lightbulb'
~~~


Source: `lightbulb/sdk/client.py:89`.

##### `lightbulb.sdk.client.Lightbulb.__exit__`



~~~python
def __exit__(exc_type: Any, exc: Any, tb: Any) -> None
~~~


Source: `lightbulb/sdk/client.py:93`.

##### `lightbulb.sdk.client.Lightbulb.active_company_id`



~~~python
@property
def active_company_id() -> str | None
~~~


Source: `lightbulb/sdk/client.py:77`.

##### `lightbulb.sdk.client.Lightbulb.active_company_id`



~~~python
@active_company_id.setter
def active_company_id(value: str | None) -> None
~~~


Source: `lightbulb/sdk/client.py:81`.

##### `lightbulb.sdk.client.Lightbulb.close`



~~~python
def close() -> None
~~~


Source: `lightbulb/sdk/client.py:86`.

##### `lightbulb.sdk.client.Lightbulb.legacy_client`



~~~python
@property
def legacy_client() -> LightbulbClient
~~~


The exact wrapped legacy client, provided for incremental migration.

Source: `lightbulb/sdk/client.py:71`.

### `lightbulb.sdk.client.AsyncLightbulb`

class. Source: `lightbulb/sdk/client.py:97`.

Stable asynchronous SDK facade with async-native resource methods.

#### Methods

##### `lightbulb.sdk.client.AsyncLightbulb.__aenter__`



~~~python
async def __aenter__() -> 'AsyncLightbulb'
~~~


Source: `lightbulb/sdk/client.py:157`.

##### `lightbulb.sdk.client.AsyncLightbulb.__aexit__`



~~~python
async def __aexit__(exc_type: Any, exc: Any, tb: Any) -> None
~~~


Source: `lightbulb/sdk/client.py:161`.

##### `lightbulb.sdk.client.AsyncLightbulb.active_company_id`



~~~python
@property
def active_company_id() -> str | None
~~~


Source: `lightbulb/sdk/client.py:145`.

##### `lightbulb.sdk.client.AsyncLightbulb.active_company_id`



~~~python
@active_company_id.setter
def active_company_id(value: str | None) -> None
~~~


Source: `lightbulb/sdk/client.py:149`.

##### `lightbulb.sdk.client.AsyncLightbulb.close`



~~~python
async def close() -> None
~~~


Source: `lightbulb/sdk/client.py:154`.

##### `lightbulb.sdk.client.AsyncLightbulb.legacy_client`



~~~python
@property
def legacy_client() -> AsyncLightbulbClient
~~~


The exact wrapped async client, provided for incremental migration.

Source: `lightbulb/sdk/client.py:139`.

## Module `lightbulb.sdk.models`

Stable, typed response models for the curated Lightbulb SDK facade.

### `lightbulb.sdk.models.Company`

class. Source: `lightbulb/sdk/models.py:71`.

A company available to the authenticated tenant.

Fields:
- `id: str = Field(validation_alias=AliasChoices('id', 'company_id', 'companyId'))`
- `name: str`
- `tenant_id: str | None = Field(default=None, validation_alias=AliasChoices('tenant_id', 'tenantId'))`
- `slug: str | None = None`
- `status: str | None = None`
- `created_at: str | None = Field(default=None, validation_alias=AliasChoices('created_at', 'createdAt'))`
- `updated_at: str | None = Field(default=None, validation_alias=AliasChoices('updated_at', 'updatedAt'))`

### `lightbulb.sdk.models.Project`

class. Source: `lightbulb/sdk/models.py:99`.

A governed Lightbulb project.

Fields:
- `id: str = Field(validation_alias=AliasChoices('id', 'project_id', 'projectId'))`
- `name: str`
- `company_id: str | None = Field(default=None, validation_alias=AliasChoices('company_id', 'companyId'))`
- `description: str | None = None`
- `instructions: str | None = None`
- `status: str | None = None`
- `coding_harnesses: list[str] = Field(default_factory=list, validation_alias=AliasChoices('coding_harnesses', 'codingHarnesses'))`
- `primary_coding_harness: str | None = Field(default=None, validation_alias=AliasChoices('primary_coding_harness', 'primaryCodingHarness'))`
- `created_at: str | None = Field(default=None, validation_alias=AliasChoices('created_at', 'createdAt'))`
- `updated_at: str | None = Field(default=None, validation_alias=AliasChoices('updated_at', 'updatedAt'))`

### `lightbulb.sdk.models.WorkflowInstance`

class. Source: `lightbulb/sdk/models.py:140`.

A workflow definition or an executing workflow instance.

``kind`` makes the two public workflow discovery/execution representations
explicit.  A definition returned by ``workflows.list`` has
``kind="definition"``; ``get``, ``run``, and ``cancel`` return
``kind="instance"``.

Fields:
- `id: str = Field(validation_alias=AliasChoices('id', 'trace_id', 'traceId', 'instanceId'))`
- `internal_id: str | None = Field(default=None, validation_alias=AliasChoices('internal_id', 'internalId'))`
- `kind: str = 'instance'`
- `workflow_id: str | None = Field(default=None, validation_alias=AliasChoices('workflow_id', 'workflowId', 'workflow_definition_id', 'workflowDefinitionId', 'definition_id', 'definitionId'))`
- `workflow_type: str | None = Field(default=None, validation_alias=AliasChoices('workflow_type', 'workflowType'))`
- `status: str | None = Field(default=None, validation_alias=AliasChoices('status', 'state'))`
- `objective: str | None = None`
- `company_id: str | None = Field(default=None, validation_alias=AliasChoices('company_id', 'companyId'))`
- `project_id: str | None = Field(default=None, validation_alias=AliasChoices('project_id', 'projectId'))`
- `inputs: dict[str, Any] = Field(default_factory=dict, validation_alias=AliasChoices('inputs', 'input'))`
- `outputs: dict[str, Any] = Field(default_factory=dict, validation_alias=AliasChoices('outputs', 'output', 'result'))`
- `error: str | None = Field(default=None, validation_alias=AliasChoices('error', 'error_message', 'errorMessage', 'last_error', 'lastError'))`
- `created_at: str | None = Field(default=None, validation_alias=AliasChoices('created_at', 'createdAt', 'startedAt'))`
- `updated_at: str | None = Field(default=None, validation_alias=AliasChoices('updated_at', 'updatedAt', 'completedAt'))`

#### Methods

##### `lightbulb.sdk.models.WorkflowInstance.from_api`



~~~python
def from_api(payload: Mapping[str, Any], *, kind: str='instance') -> 'WorkflowInstance'
~~~


Source: `lightbulb/sdk/models.py:234`.

### `lightbulb.sdk.models.Approval`

class. Source: `lightbulb/sdk/models.py:267`.

A human-in-the-loop approval awaiting or recording a decision.

Fields:
- `id: str = Field(validation_alias=AliasChoices('id', 'task_id', 'taskId'))`
- `status: str | None = Field(default=None, validation_alias=AliasChoices('status', 'state'))`
- `title: str | None = None`
- `description: str | None = None`
- `workflow_instance_id: str | None = Field(default=None, validation_alias=AliasChoices('workflow_instance_id', 'workflowInstanceId', 'trace_id', 'traceId'))`
- `requested_by: str | None = Field(default=None, validation_alias=AliasChoices('requested_by', 'requestedBy'))`
- `comments: str | None = None`
- `created_at: str | None = Field(default=None, validation_alias=AliasChoices('created_at', 'createdAt'))`
- `updated_at: str | None = Field(default=None, validation_alias=AliasChoices('updated_at', 'updatedAt'))`

### `lightbulb.sdk.models.Artifact`

class. Source: `lightbulb/sdk/models.py:310`.

A Lightbulb output artifact or externally registered resource.

Fields:
- `id: str = Field(validation_alias=AliasChoices('id', 'artifact_id', 'artifactId'))`
- `type: str`
- `title: str | None = None`
- `summary: str | None = None`
- `uri: str | None = None`
- `content: str | None = None`
- `project_id: str | None = Field(default=None, validation_alias=AliasChoices('project_id', 'projectId'))`
- `source_agent: str | None = Field(default=None, validation_alias=AliasChoices('source_agent', 'sourceAgent'))`
- `created_at: str | None = Field(default=None, validation_alias=AliasChoices('created_at', 'createdAt'))`
- `updated_at: str | None = Field(default=None, validation_alias=AliasChoices('updated_at', 'updatedAt'))`

### `lightbulb.sdk.models.Page`

class. Source: `lightbulb/sdk/models.py:346`.

A stable page envelope used by every collection resource.

Fields:
- `items: list[T]`
- `next_cursor: str | None = Field(default=None, validation_alias=AliasChoices('next_cursor', 'nextCursor'))`
- `has_more: bool = Field(default=False, validation_alias=AliasChoices('has_more', 'hasMore'))`
- `total: int | None = None`

### `lightbulb.sdk.models.OperationReceipt`

class. Source: `lightbulb/sdk/models.py:361`.

Typed acknowledgement for a stable facade mutation.

Fields:
- `operation: str`
- `status: str`
- `id: str | None = Field(default=None, validation_alias=AliasChoices('id', 'receipt_id', 'receiptId'))`
- `resource_id: str | None = Field(default=None, validation_alias=AliasChoices('resource_id', 'resourceId'))`
- `request_id: str | None = Field(default=None, validation_alias=AliasChoices('request_id', 'requestId'))`
- `message: str | None = None`
- `result: dict[str, Any] = Field(default_factory=dict)`

## Module `lightbulb.sdk.resources`

Resource namespaces used by :mod:`lightbulb.sdk`.

### `lightbulb.sdk.resources.CompaniesResource`

resource. Source: `lightbulb/sdk/resources.py:113`.

#### Methods

##### `lightbulb.sdk.resources.CompaniesResource.get`



~~~python
def get(company_id: str) -> Company
~~~


Source: `lightbulb/sdk/resources.py:122`.

##### `lightbulb.sdk.resources.CompaniesResource.list`



~~~python
def list() -> Page[Company]
~~~


Source: `lightbulb/sdk/resources.py:114`.

##### `lightbulb.sdk.resources.CompaniesResource.select`



~~~python
def select(company_id: str) -> OperationReceipt
~~~


Source: `lightbulb/sdk/resources.py:126`.

### `lightbulb.sdk.resources.ProjectsResource`

resource. Source: `lightbulb/sdk/resources.py:136`.

#### Methods

##### `lightbulb.sdk.resources.ProjectsResource.create`



~~~python
def create(name: str | None=None, *, instructions: str='', coding_harness: str, confirm_create: bool=False, preflight_receipt: Any=None, workspace_id: str | None=None, repo_connection_id: str | None=None, idempotency_key: str | None=None, play_style: str | None=None) -> Project
~~~


Preflight and create a project through the governed legacy path.

``confirm_create=True`` remains mandatory in the underlying client.
A previously refined preflight receipt may be supplied to avoid
repeating preflight; otherwise ``name`` is required and a fresh
read-only preflight is performed first.

Source: `lightbulb/sdk/resources.py:160`.

##### `lightbulb.sdk.resources.ProjectsResource.get`



~~~python
def get(project_id: str, *, company_id: str | None=None) -> Project
~~~


Source: `lightbulb/sdk/resources.py:152`.

##### `lightbulb.sdk.resources.ProjectsResource.list`



~~~python
def list(*, company_id: str | None=None) -> Page[Project]
~~~


Source: `lightbulb/sdk/resources.py:137`.

### `lightbulb.sdk.resources.WorkflowsResource`

resource. Source: `lightbulb/sdk/resources.py:206`.

#### Methods

##### `lightbulb.sdk.resources.WorkflowsResource.cancel`



~~~python
def cancel(workflow_instance_id: str, *, company_id: str | None=None) -> OperationReceipt
~~~


Source: `lightbulb/sdk/resources.py:268`.

##### `lightbulb.sdk.resources.WorkflowsResource.get`



~~~python
def get(workflow_instance_id: str, *, company_id: str | None=None) -> WorkflowInstance
~~~


Source: `lightbulb/sdk/resources.py:225`.

##### `lightbulb.sdk.resources.WorkflowsResource.list`



~~~python
def list(*, company_id: str | None=None) -> Page[WorkflowInstance]
~~~


Source: `lightbulb/sdk/resources.py:207`.

##### `lightbulb.sdk.resources.WorkflowsResource.run`



~~~python
def run(workflow_type: str, objective: str, *, inputs: Mapping[str, Any] | None=None, company_id: str | None=None) -> WorkflowInstance
~~~


Source: `lightbulb/sdk/resources.py:243`.

### `lightbulb.sdk.resources.ApprovalsResource`

resource. Source: `lightbulb/sdk/resources.py:292`.

#### Methods

##### `lightbulb.sdk.resources.ApprovalsResource.approve`



~~~python
def approve(approval_id: str, *, comments: str='') -> OperationReceipt
~~~


Source: `lightbulb/sdk/resources.py:306`.

##### `lightbulb.sdk.resources.ApprovalsResource.get`



~~~python
def get(approval_id: str) -> Approval
~~~


Source: `lightbulb/sdk/resources.py:301`.

##### `lightbulb.sdk.resources.ApprovalsResource.list`



~~~python
def list() -> Page[Approval]
~~~


Source: `lightbulb/sdk/resources.py:293`.

##### `lightbulb.sdk.resources.ApprovalsResource.reject`



~~~python
def reject(approval_id: str, *, comments: str='') -> OperationReceipt
~~~


Source: `lightbulb/sdk/resources.py:320`.

### `lightbulb.sdk.resources.ArtifactsResource`

resource. Source: `lightbulb/sdk/resources.py:335`.

#### Methods

##### `lightbulb.sdk.resources.ArtifactsResource.get`



~~~python
def get(artifact_id: str) -> Artifact
~~~


Source: `lightbulb/sdk/resources.py:344`.

##### `lightbulb.sdk.resources.ArtifactsResource.list`



~~~python
def list(**filters: Any) -> Page[Artifact]
~~~


Source: `lightbulb/sdk/resources.py:336`.

##### `lightbulb.sdk.resources.ArtifactsResource.register`



~~~python
def register(*, type: str, title: str='', summary: str='', uri: str='', content: str='', project_id: str | None=None, source_agent: str='external_agent', metadata: Mapping[str, Any] | None=None, attach_workspace: bool=False) -> Artifact
~~~


Source: `lightbulb/sdk/resources.py:349`.

### `lightbulb.sdk.resources.AsyncCompaniesResource`

resource. Source: `lightbulb/sdk/resources.py:446`.

#### Methods

##### `lightbulb.sdk.resources.AsyncCompaniesResource.get`



~~~python
async def get(company_id: str) -> Company
~~~


Source: `lightbulb/sdk/resources.py:455`.

##### `lightbulb.sdk.resources.AsyncCompaniesResource.list`



~~~python
async def list() -> Page[Company]
~~~


Source: `lightbulb/sdk/resources.py:447`.

##### `lightbulb.sdk.resources.AsyncCompaniesResource.select`



~~~python
async def select(company_id: str) -> OperationReceipt
~~~


Source: `lightbulb/sdk/resources.py:459`.

### `lightbulb.sdk.resources.AsyncProjectsResource`

resource. Source: `lightbulb/sdk/resources.py:469`.

#### Methods

##### `lightbulb.sdk.resources.AsyncProjectsResource.create`



~~~python
async def create(name: str | None=None, *, instructions: str='', coding_harness: str, confirm_create: bool=False, preflight_receipt: Any=None, workspace_id: str | None=None, repo_connection_id: str | None=None, idempotency_key: str | None=None, play_style: str | None=None) -> Project
~~~


Source: `lightbulb/sdk/resources.py:495`.

##### `lightbulb.sdk.resources.AsyncProjectsResource.get`



~~~python
async def get(project_id: str, *, company_id: str | None=None) -> Project
~~~


Source: `lightbulb/sdk/resources.py:482`.

##### `lightbulb.sdk.resources.AsyncProjectsResource.list`



~~~python
async def list(*, company_id: str | None=None) -> Page[Project]
~~~


Source: `lightbulb/sdk/resources.py:470`.

### `lightbulb.sdk.resources.AsyncWorkflowsResource`

resource. Source: `lightbulb/sdk/resources.py:532`.

#### Methods

##### `lightbulb.sdk.resources.AsyncWorkflowsResource.cancel`



~~~python
async def cancel(workflow_instance_id: str, *, company_id: str | None=None) -> OperationReceipt
~~~


Source: `lightbulb/sdk/resources.py:618`.

##### `lightbulb.sdk.resources.AsyncWorkflowsResource.get`



~~~python
async def get(workflow_instance_id: str, *, company_id: str | None=None) -> WorkflowInstance
~~~


Source: `lightbulb/sdk/resources.py:552`.

##### `lightbulb.sdk.resources.AsyncWorkflowsResource.list`



~~~python
async def list(*, company_id: str | None=None) -> Page[WorkflowInstance]
~~~


Source: `lightbulb/sdk/resources.py:533`.

##### `lightbulb.sdk.resources.AsyncWorkflowsResource.run`



~~~python
async def run(workflow_type: str, objective: str, *, inputs: Mapping[str, Any] | None=None, company_id: str | None=None) -> WorkflowInstance
~~~


Source: `lightbulb/sdk/resources.py:570`.

### `lightbulb.sdk.resources.AsyncApprovalsResource`

resource. Source: `lightbulb/sdk/resources.py:638`.

#### Methods

##### `lightbulb.sdk.resources.AsyncApprovalsResource.approve`



~~~python
async def approve(approval_id: str, *, comments: str='') -> OperationReceipt
~~~


Source: `lightbulb/sdk/resources.py:655`.

##### `lightbulb.sdk.resources.AsyncApprovalsResource.get`



~~~python
async def get(approval_id: str) -> Approval
~~~


Source: `lightbulb/sdk/resources.py:647`.

##### `lightbulb.sdk.resources.AsyncApprovalsResource.list`



~~~python
async def list() -> Page[Approval]
~~~


Source: `lightbulb/sdk/resources.py:639`.

##### `lightbulb.sdk.resources.AsyncApprovalsResource.reject`



~~~python
async def reject(approval_id: str, *, comments: str='') -> OperationReceipt
~~~


Source: `lightbulb/sdk/resources.py:674`.

### `lightbulb.sdk.resources.AsyncArtifactsResource`

resource. Source: `lightbulb/sdk/resources.py:694`.

#### Methods

##### `lightbulb.sdk.resources.AsyncArtifactsResource.get`



~~~python
async def get(artifact_id: str) -> Artifact
~~~


Source: `lightbulb/sdk/resources.py:707`.

##### `lightbulb.sdk.resources.AsyncArtifactsResource.list`



~~~python
async def list(**filters: Any) -> Page[Artifact]
~~~


Source: `lightbulb/sdk/resources.py:695`.

##### `lightbulb.sdk.resources.AsyncArtifactsResource.register`



~~~python
async def register(*, type: str, title: str='', summary: str='', uri: str='', content: str='', project_id: str | None=None, source_agent: str='external_agent', metadata: Mapping[str, Any] | None=None, attach_workspace: bool=False) -> Artifact
~~~


Source: `lightbulb/sdk/resources.py:712`.

## Module `lightbulb.service_asset_remedy_lifecycle`

Deterministic warranty, depot-repair, and field-service projections.

### `lightbulb.service_asset_remedy_lifecycle.ServiceAssetRemedyError`

class. Source: `lightbulb/service_asset_remedy_lifecycle.py:100`.

Stable, fail-closed lifecycle error surfaced by the primitive wrapper.

### `lightbulb.service_asset_remedy_lifecycle.ServiceAssetRemedyScope`

class. Source: `lightbulb/service_asset_remedy_lifecycle.py:229`.

Fields:
- `schema_id: Literal['lightbulb.service_asset_remedy_scope.v1'] = Field(default=SERVICE_ASSET_REMEDY_SCOPE_SCHEMA, alias='schema')`
- `tenant_ref: str = Field(min_length=1, max_length=160)`
- `company_ref: str = Field(min_length=1, max_length=160)`
- `project_ref: str = Field(min_length=1, max_length=160)`
- `project_id: UUID`
- `customer_ref: str = Field(min_length=1, max_length=160)`
- `case_ref: str = Field(min_length=1, max_length=160)`
- `asset_ref: str = Field(min_length=1, max_length=160)`
- `product_ref: str = Field(min_length=1, max_length=160)`
- `serial_ref: str = Field(min_length=1, max_length=160)`
- `remedy_ref: str = Field(min_length=1, max_length=160)`
- `branch: ServiceAssetRemedyBranch`
- `resolution_due_at: str`

### `lightbulb.service_asset_remedy_lifecycle.service_asset_remedy_scope_digest`

function. Source: `lightbulb/service_asset_remedy_lifecycle.py:283`.



~~~python
service_asset_remedy_scope_digest(scope: ServiceAssetRemedyScope | Mapping[str, Any]) -> str
~~~


### `lightbulb.service_asset_remedy_lifecycle.ServiceAssetRemedyEvidence`

class. Source: `lightbulb/service_asset_remedy_lifecycle.py:290`.

Fields:
- `schema_id: Literal['lightbulb.service_asset_remedy_evidence.v1'] = Field(default=SERVICE_ASSET_REMEDY_EVIDENCE_SCHEMA, alias='schema')`
- `evidence_ref: str = Field(min_length=1, max_length=200)`
- `kind: str = Field(min_length=1, max_length=96)`
- `issuer_ref: Literal['spring-service-authority']`
- `custodian_ref: Literal['spring:service-evidence-vault']`
- `subject_ref: str = Field(min_length=1, max_length=200)`
- `sha256: str = Field(pattern='^[0-9a-f]{64}$')`
- `observed_at: str`
- `effective_at: str`
- `verification_grade: Literal['attested', 'verified']`
- `classification: Literal['restricted']`
- `retention_policy: Literal['customer-service-seven-years']`
- `retained_until: str`
- `single_use: Literal[True]`
- `causal_revision: int = Field(ge=0, le=MAX_SERVICE_ASSET_TRANSITIONS)`
- `causal_state_digest: str = Field(pattern='^[0-9a-f]{64}$')`

#### Methods

##### `lightbulb.service_asset_remedy_lifecycle.ServiceAssetRemedyEvidence.portable_ref`



~~~python
def portable_ref() -> PrimitiveEvidenceRef
~~~


Source: `lightbulb/service_asset_remedy_lifecycle.py:329`.

### `lightbulb.service_asset_remedy_lifecycle.ServiceAssetRemedyAuthorizationCommitment`

class. Source: `lightbulb/service_asset_remedy_lifecycle.py:346`.

Spring-attested commitment to one existing case/RMA proposal and branch.

Fields:
- `schema_id: Literal['lightbulb.service_asset_remedy_authorization_commitment.v1'] = Field(default=SERVICE_ASSET_REMEDY_AUTHORIZATION_SCHEMA, alias='schema')`
- `authorization_ref: str = Field(min_length=1, max_length=200)`
- `lifecycle_ref: str = Field(min_length=1, max_length=160)`
- `scope_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `source_case_snapshot_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `source_case_revision: int = Field(ge=1, le=128)`
- `remedy_proposal_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `remedy_kind: Literal['rma', 'field_service']`
- `authorized_branch: ServiceAssetRemedyBranch`
- `authorized_by_ref: str = Field(min_length=1, max_length=160)`
- `authorized_role: Literal['returns_authorizer', 'field_service_authorizer']`
- `proposed_by_ref: str = Field(min_length=1, max_length=160)`
- `case_owner_ref: str = Field(min_length=1, max_length=160)`
- `case_resolver_ref: str | None = Field(default=None, min_length=1, max_length=160)`
- `decision: Literal['approved']`
- `authorized_at: str`
- `expires_at: str`
- `single_use: Literal[True]`
- `sdk_execution_authority_granted: Literal[False]`
- `provider_write_authority_granted: Literal[False]`
- `authorization_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `evidence: ServiceAssetRemedyEvidence`

### `lightbulb.service_asset_remedy_lifecycle.service_asset_remedy_authorization_digest`

function. Source: `lightbulb/service_asset_remedy_lifecycle.py:453`.



~~~python
service_asset_remedy_authorization_digest(authorization: ServiceAssetRemedyAuthorizationCommitment | Mapping[str, Any]) -> str
~~~


### `lightbulb.service_asset_remedy_lifecycle.ServicePartCustody`

class. Source: `lightbulb/service_asset_remedy_lifecycle.py:462`.

Fields:
- `part_ref: str = Field(min_length=1, max_length=160)`
- `lot_ref: str | None = Field(default=None, min_length=1, max_length=160)`
- `serial_ref: str | None = Field(default=None, min_length=1, max_length=160)`
- `quantity: Decimal`
- `currency_code: str = Field(pattern='^[A-Z]{3}$')`
- `unit_cost: Decimal`
- `extended_cost: Decimal`
- `source_inventory_ref: str = Field(min_length=1, max_length=160)`
- `custody_event_ref: str = Field(min_length=1, max_length=160)`
- `from_custodian_ref: str = Field(min_length=1, max_length=160)`
- `to_technician_ref: str = Field(min_length=1, max_length=160)`
- `transferred_at: str`

### `lightbulb.service_asset_remedy_lifecycle.ServicePartInstallation`

class. Source: `lightbulb/service_asset_remedy_lifecycle.py:519`.

Candidate custody continuation from one prepared part to the serviced asset.

Fields:
- `part_ref: str = Field(min_length=1, max_length=160)`
- `lot_ref: str | None = Field(default=None, min_length=1, max_length=160)`
- `serial_ref: str | None = Field(default=None, min_length=1, max_length=160)`
- `quantity: Decimal`
- `source_custody_event_ref: str = Field(min_length=1, max_length=160)`
- `installation_event_ref: str = Field(min_length=1, max_length=160)`
- `from_technician_ref: str = Field(min_length=1, max_length=160)`
- `to_asset_ref: str = Field(min_length=1, max_length=160)`
- `installed_at: str`

### `lightbulb.service_asset_remedy_lifecycle.ValidateWarrantyEntitlementCommand`

class. Source: `lightbulb/service_asset_remedy_lifecycle.py:582`.

Fields:
- `schema_id: Literal['lightbulb.service_asset_validate_warranty_entitlement_command.v1'] = Field(default='lightbulb.service_asset_validate_warranty_entitlement_command.v1', alias='schema')`
- `kind: Literal['validate_warranty_entitlement']`
- `entitlement_ref: str = Field(min_length=1, max_length=160)`
- `warranty_policy_ref: str = Field(min_length=1, max_length=160)`
- `contract_ref: str = Field(min_length=1, max_length=160)`
- `asset_ref: str = Field(min_length=1, max_length=160)`
- `product_ref: str = Field(min_length=1, max_length=160)`
- `serial_ref: str = Field(min_length=1, max_length=160)`
- `customer_ref: str = Field(min_length=1, max_length=160)`
- `coverage_status: Literal['covered']`
- `coverage_started_at: str`
- `coverage_expires_at: str`
- `validated_at: str`
- `validator_ref: str = Field(min_length=1, max_length=160)`

### `lightbulb.service_asset_remedy_lifecycle.RecordDepotReceiptCommand`

class. Source: `lightbulb/service_asset_remedy_lifecycle.py:620`.

Fields:
- `schema_id: Literal['lightbulb.service_asset_record_depot_receipt_command.v1'] = Field(default='lightbulb.service_asset_record_depot_receipt_command.v1', alias='schema')`
- `kind: Literal['record_depot_receipt']`
- `rma_ref: str = Field(min_length=1, max_length=160)`
- `inbound_shipment_ref: str = Field(min_length=1, max_length=160)`
- `custody_event_ref: str = Field(min_length=1, max_length=160)`
- `carrier_ref: str = Field(min_length=1, max_length=160)`
- `depot_ref: str = Field(min_length=1, max_length=160)`
- `from_customer_ref: str = Field(min_length=1, max_length=160)`
- `asset_ref: str = Field(min_length=1, max_length=160)`
- `product_ref: str = Field(min_length=1, max_length=160)`
- `serial_ref: str = Field(min_length=1, max_length=160)`
- `received_at: str`
- `receiving_ref: str = Field(min_length=1, max_length=160)`

### `lightbulb.service_asset_remedy_lifecycle.PlanFieldServiceCommand`

class. Source: `lightbulb/service_asset_remedy_lifecycle.py:646`.

Fields:
- `schema_id: Literal['lightbulb.service_asset_plan_field_service_command.v1'] = Field(default='lightbulb.service_asset_plan_field_service_command.v1', alias='schema')`
- `kind: Literal['plan_field_service']`
- `work_order_ref: str = Field(min_length=1, max_length=160)`
- `service_location_ref: str = Field(min_length=1, max_length=160)`
- `dispatcher_ref: str = Field(min_length=1, max_length=160)`
- `technician_ref: str = Field(min_length=1, max_length=160)`
- `competency_ref: str = Field(min_length=1, max_length=160)`
- `safety_plan_ref: str = Field(min_length=1, max_length=160)`
- `scheduled_start_at: str`
- `scheduled_end_at: str`
- `planned_at: str`

### `lightbulb.service_asset_remedy_lifecycle.RecordDiagnosticCommand`

class. Source: `lightbulb/service_asset_remedy_lifecycle.py:680`.

Fields:
- `schema_id: Literal['lightbulb.service_asset_record_diagnostic_command.v1'] = Field(default='lightbulb.service_asset_record_diagnostic_command.v1', alias='schema')`
- `kind: Literal['record_diagnostic']`
- `diagnostic_ref: str = Field(min_length=1, max_length=160)`
- `remedy_ref: str = Field(min_length=1, max_length=160)`
- `asset_ref: str = Field(min_length=1, max_length=160)`
- `serial_ref: str = Field(min_length=1, max_length=160)`
- `failure_code_ref: str = Field(min_length=1, max_length=160)`
- `diagnostic_protocol_ref: str = Field(min_length=1, max_length=160)`
- `diagnostician_ref: str = Field(min_length=1, max_length=160)`
- `diagnosed_at: str`
- `repairability: Literal['repairable', 'replace_required']`

### `lightbulb.service_asset_remedy_lifecycle.PrepareServiceWorkCommand`

class. Source: `lightbulb/service_asset_remedy_lifecycle.py:702`.

Fields:
- `schema_id: Literal['lightbulb.service_asset_prepare_work_command.v1'] = Field(default='lightbulb.service_asset_prepare_work_command.v1', alias='schema')`
- `kind: Literal['prepare_service_work']`
- `work_order_ref: str = Field(min_length=1, max_length=160)`
- `technician_ref: str = Field(min_length=1, max_length=160)`
- `competency_ref: str = Field(min_length=1, max_length=160)`
- `competency_valid_until: str`
- `safety_plan_ref: str = Field(min_length=1, max_length=160)`
- `safety_acknowledged_at: str`
- `prepared_at: str`
- `parts: tuple[ServicePartCustody, ...] = Field(min_length=1, max_length=MAX_PARTS_PER_REMEDY)`

### `lightbulb.service_asset_remedy_lifecycle.RecordServiceWorkCompletionCommand`

class. Source: `lightbulb/service_asset_remedy_lifecycle.py:750`.

Fields:
- `schema_id: Literal['lightbulb.service_asset_record_work_completion_command.v1'] = Field(default='lightbulb.service_asset_record_work_completion_command.v1', alias='schema')`
- `kind: Literal['record_service_work_completion']`
- `completion_ref: str = Field(min_length=1, max_length=160)`
- `work_order_ref: str = Field(min_length=1, max_length=160)`
- `technician_ref: str = Field(min_length=1, max_length=160)`
- `asset_ref: str = Field(min_length=1, max_length=160)`
- `serial_ref: str = Field(min_length=1, max_length=160)`
- `outcome: Literal['repaired', 'replaced']`
- `replacement_asset_ref: str | None = Field(default=None, min_length=1, max_length=160)`
- `replacement_serial_ref: str | None = Field(default=None, min_length=1, max_length=160)`
- `removed_serial_ref: str | None = Field(default=None, min_length=1, max_length=160)`
- `parts: tuple[ServicePartCustody, ...] = Field(min_length=1, max_length=MAX_PARTS_PER_REMEDY)`
- `installations: tuple[ServicePartInstallation, ...] = Field(min_length=1, max_length=MAX_PARTS_PER_REMEDY)`
- `labor_minutes: int = Field(gt=0, le=129600)`
- `currency_code: str = Field(pattern='^[A-Z]{3}$')`
- `labor_hourly_rate: Decimal`
- `labor_cost: Decimal`
- `parts_cost: Decimal`
- `total_cost: Decimal`
- `started_at: str`
- `completed_at: str`

### `lightbulb.service_asset_remedy_lifecycle.VerifyIndependentRepairCommand`

class. Source: `lightbulb/service_asset_remedy_lifecycle.py:894`.

Fields:
- `schema_id: Literal['lightbulb.service_asset_verify_independent_repair_command.v1'] = Field(default='lightbulb.service_asset_verify_independent_repair_command.v1', alias='schema')`
- `kind: Literal['verify_independent_repair']`
- `inspection_ref: str = Field(min_length=1, max_length=160)`
- `completion_ref: str = Field(min_length=1, max_length=160)`
- `inspector_ref: str = Field(min_length=1, max_length=160)`
- `asset_ref: str = Field(min_length=1, max_length=160)`
- `serial_ref: str = Field(min_length=1, max_length=160)`
- `test_protocol_ref: str = Field(min_length=1, max_length=160)`
- `test_result: Literal['passed']`
- `inspected_at: str`

### `lightbulb.service_asset_remedy_lifecycle.RecordDepotReturnDeliveryCommand`

class. Source: `lightbulb/service_asset_remedy_lifecycle.py:917`.

Fields:
- `schema_id: Literal['lightbulb.service_asset_record_depot_return_delivery_command.v1'] = Field(default='lightbulb.service_asset_record_depot_return_delivery_command.v1', alias='schema')`
- `kind: Literal['record_depot_return_delivery']`
- `outbound_shipment_ref: str = Field(min_length=1, max_length=160)`
- `delivery_ref: str = Field(min_length=1, max_length=160)`
- `inspection_ref: str = Field(min_length=1, max_length=160)`
- `custody_event_ref: str = Field(min_length=1, max_length=160)`
- `from_depot_ref: str = Field(min_length=1, max_length=160)`
- `to_customer_ref: str = Field(min_length=1, max_length=160)`
- `carrier_ref: str = Field(min_length=1, max_length=160)`
- `asset_ref: str = Field(min_length=1, max_length=160)`
- `serial_ref: str = Field(min_length=1, max_length=160)`
- `delivered_at: str`
- `delivery_confirmer_ref: str = Field(min_length=1, max_length=160)`

### `lightbulb.service_asset_remedy_lifecycle.RecordFieldReinstallationCommand`

class. Source: `lightbulb/service_asset_remedy_lifecycle.py:943`.

Fields:
- `schema_id: Literal['lightbulb.service_asset_record_field_reinstallation_command.v1'] = Field(default='lightbulb.service_asset_record_field_reinstallation_command.v1', alias='schema')`
- `kind: Literal['record_field_reinstallation']`
- `reinstallation_ref: str = Field(min_length=1, max_length=160)`
- `delivery_ref: str = Field(min_length=1, max_length=160)`
- `inspection_ref: str = Field(min_length=1, max_length=160)`
- `service_location_ref: str = Field(min_length=1, max_length=160)`
- `asset_ref: str = Field(min_length=1, max_length=160)`
- `serial_ref: str = Field(min_length=1, max_length=160)`
- `technician_ref: str = Field(min_length=1, max_length=160)`
- `reinstalled_at: str`

### `lightbulb.service_asset_remedy_lifecycle.VerifyCustomerResolutionCommand`

class. Source: `lightbulb/service_asset_remedy_lifecycle.py:966`.

Fields:
- `schema_id: Literal['lightbulb.service_asset_verify_customer_resolution_command.v1'] = Field(default='lightbulb.service_asset_verify_customer_resolution_command.v1', alias='schema')`
- `kind: Literal['verify_customer_resolution']`
- `verification_ref: str = Field(min_length=1, max_length=160)`
- `case_ref: str = Field(min_length=1, max_length=160)`
- `delivery_ref: str = Field(min_length=1, max_length=160)`
- `customer_ref: str = Field(min_length=1, max_length=160)`
- `asset_ref: str = Field(min_length=1, max_length=160)`
- `serial_ref: str = Field(min_length=1, max_length=160)`
- `resolution_outcome: Literal['confirmed']`
- `verified_at: str`
- `verifier_ref: str = Field(min_length=1, max_length=160)`

### `lightbulb.service_asset_remedy_lifecycle.ProposeServiceClosureCandidateCommand`

class. Source: `lightbulb/service_asset_remedy_lifecycle.py:990`.

Fields:
- `schema_id: Literal['lightbulb.service_asset_propose_closure_candidate_command.v1'] = Field(default='lightbulb.service_asset_propose_closure_candidate_command.v1', alias='schema')`
- `kind: Literal['propose_service_closure_candidate']`
- `closure_candidate_ref: str = Field(min_length=1, max_length=160)`
- `case_ref: str = Field(min_length=1, max_length=160)`
- `resolution_verification_ref: str = Field(min_length=1, max_length=160)`
- `closer_ref: str = Field(min_length=1, max_length=160)`
- `proposed_at: str`

### `lightbulb.service_asset_remedy_lifecycle.service_asset_remedy_command_digest`

function. Source: `lightbulb/service_asset_remedy_lifecycle.py:1029`.



~~~python
service_asset_remedy_command_digest(command: ServiceAssetRemedyCommand | Mapping[str, Any]) -> str
~~~


### `lightbulb.service_asset_remedy_lifecycle.service_asset_remedy_idempotency_digest`

function. Source: `lightbulb/service_asset_remedy_lifecycle.py:1036`.



~~~python
service_asset_remedy_idempotency_digest(scope: ServiceAssetRemedyScope | Mapping[str, Any], lifecycle_ref: str, idempotency_key: str) -> str
~~~


### `lightbulb.service_asset_remedy_lifecycle.service_asset_remedy_root_commitment_digest`

function. Source: `lightbulb/service_asset_remedy_lifecycle.py:1056`.



~~~python
service_asset_remedy_root_commitment_digest(scope: ServiceAssetRemedyScope | Mapping[str, Any], authorization: ServiceAssetRemedyAuthorizationCommitment | Mapping[str, Any]) -> str
~~~


### `lightbulb.service_asset_remedy_lifecycle.service_asset_remedy_fact_evidence_digest`

function. Source: `lightbulb/service_asset_remedy_lifecycle.py:1228`.



~~~python
service_asset_remedy_fact_evidence_digest(*, scope_digest: str, root_commitment_digest: str, lifecycle_ref: str, transition_ref: str, command_digest: str) -> str
~~~


### `lightbulb.service_asset_remedy_lifecycle.service_asset_remedy_transition_evidence_digest`

function. Source: `lightbulb/service_asset_remedy_lifecycle.py:1248`.



~~~python
service_asset_remedy_transition_evidence_digest(*, content_digest: str, fact_evidence_digest: str) -> str
~~~


### `lightbulb.service_asset_remedy_lifecycle.ServiceAssetRemedyProjection`

class. Source: `lightbulb/service_asset_remedy_lifecycle.py:1260`.

Fields:
- `entitlement_ref: str | None = None`
- `warranty_policy_ref: str | None = None`
- `entitlement_validated_at: str | None = None`
- `coverage_expires_at: str | None = None`
- `rma_ref: str | None = None`
- `depot_ref: str | None = None`
- `inbound_shipment_ref: str | None = None`
- `inbound_custody_event_ref: str | None = None`
- `depot_received_at: str | None = None`
- `field_work_order_ref: str | None = None`
- `service_location_ref: str | None = None`
- `dispatcher_ref: str | None = None`
- `scheduled_technician_ref: str | None = None`
- `scheduled_competency_ref: str | None = None`
- `scheduled_safety_plan_ref: str | None = None`
- `scheduled_start_at: str | None = None`
- `scheduled_end_at: str | None = None`
- `diagnostic_ref: str | None = None`
- `failure_code_ref: str | None = None`
- `diagnostician_ref: str | None = None`
- `diagnosed_at: str | None = None`
- `repairability: Literal['repairable', 'replace_required'] | None = None`
- `work_order_ref: str | None = None`
- `technician_ref: str | None = None`
- `competency_ref: str | None = None`
- `competency_valid_until: str | None = None`
- `safety_plan_ref: str | None = None`
- `parts: tuple[ServicePartCustody, ...] = ()`
- `work_prepared_at: str | None = None`
- `completion_ref: str | None = None`
- `completion_outcome: Literal['repaired', 'replaced'] | None = None`
- `serviced_asset_ref: str | None = None`
- `serviced_serial_ref: str | None = None`
- `part_installations: tuple[ServicePartInstallation, ...] = ()`
- `work_started_at: str | None = None`
- `work_completed_at: str | None = None`
- `labor_minutes: int | None = Field(default=None, gt=0, le=129600)`
- `currency_code: str | None = Field(default=None, pattern='^[A-Z]{3}$')`
- `labor_hourly_rate: Decimal | None = None`
- `labor_cost: Decimal | None = None`
- `parts_cost: Decimal | None = None`
- `total_cost: Decimal | None = None`
- `inspection_ref: str | None = None`
- `inspector_ref: str | None = None`
- `inspected_at: str | None = None`
- `delivery_ref: str | None = None`
- `delivery_confirmer_ref: str | None = None`
- `outbound_shipment_ref: str | None = None`
- `delivery_custody_event_ref: str | None = None`
- `delivered_at: str | None = None`
- `resolution_verification_ref: str | None = None`
- `resolution_verifier_ref: str | None = None`
- `customer_verified_at: str | None = None`
- `closure_candidate_ref: str | None = None`
- `closure_reviewer_ref: str | None = None`
- `closure_proposed_at: str | None = None`

### `lightbulb.service_asset_remedy_lifecycle.ServiceAssetRemedyTransitionRecord`

class. Source: `lightbulb/service_asset_remedy_lifecycle.py:1839`.

Fields:
- `schema_id: Literal['lightbulb.service_asset_remedy_transition_record.v1'] = Field(default=SERVICE_ASSET_REMEDY_TRANSITION_RECORD_SCHEMA, alias='schema')`
- `revision: int = Field(ge=1, le=MAX_SERVICE_ASSET_TRANSITIONS)`
- `scope_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `root_commitment_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `lifecycle_ref: str = Field(min_length=1, max_length=160)`
- `transition_ref: str = Field(min_length=1, max_length=160)`
- `prior_state: ServiceAssetRemedyState | None = None`
- `target_state: ServiceAssetRemedyState`
- `prior_state_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `command: ServiceAssetRemedyCommand`
- `command_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `content_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `idempotency_key: str = Field(min_length=8, max_length=200)`
- `idempotency_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `requested_by_ref: str = Field(min_length=1, max_length=160)`
- `proposed_at: str`
- `evidence_refs: tuple[ServiceAssetRemedyEvidence, ServiceAssetRemedyEvidence]`
- `evidence_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `authoritative_case_changed: Literal[False]`
- `rma_or_work_order_created: Literal[False]`
- `dispatch_or_shipping_executed: Literal[False]`
- `repair_or_inventory_write_executed: Literal[False]`
- `warranty_decision_executed: Literal[False]`
- `closure_executed: Literal[False]`
- `provider_write_executed: Literal[False]`
- `transition_digest: str = Field(pattern='^[0-9a-f]{64}$')`

### `lightbulb.service_asset_remedy_lifecycle.ServiceAssetRemedySnapshot`

class. Source: `lightbulb/service_asset_remedy_lifecycle.py:2246`.

Fields:
- `schema_id: Literal['lightbulb.service_asset_remedy_snapshot.v1'] = Field(default=SERVICE_ASSET_REMEDY_SNAPSHOT_SCHEMA, alias='schema')`
- `scope: ServiceAssetRemedyScope`
- `scope_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `authorization: ServiceAssetRemedyAuthorizationCommitment`
- `source_case_snapshot_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `source_case_revision: int = Field(ge=1, le=128)`
- `remedy_proposal_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `authorization_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `root_commitment_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `lifecycle_ref: str = Field(min_length=1, max_length=160)`
- `revision: int = Field(ge=1, le=MAX_SERVICE_ASSET_TRANSITIONS)`
- `state: ServiceAssetRemedyState`
- `started_at: str`
- `updated_at: str`
- `history: tuple[ServiceAssetRemedyTransitionRecord, ...] = Field(min_length=1, max_length=MAX_SERVICE_ASSET_TRANSITIONS)`
- `projection: ServiceAssetRemedyProjection`
- `customer_resolution_verified: bool`
- `closure_candidate_materialized: bool`
- `authoritative_case_changed: Literal[False]`
- `rma_or_work_order_created: Literal[False]`
- `dispatch_or_shipping_executed: Literal[False]`
- `repair_or_inventory_write_executed: Literal[False]`
- `warranty_decision_executed: Literal[False]`
- `closure_executed: Literal[False]`
- `provider_write_executed: Literal[False]`
- `state_digest: str = Field(pattern='^[0-9a-f]{64}$')`

### `lightbulb.service_asset_remedy_lifecycle.service_asset_remedy_snapshot_digest`

function. Source: `lightbulb/service_asset_remedy_lifecycle.py:2350`.



~~~python
service_asset_remedy_snapshot_digest(snapshot: ServiceAssetRemedySnapshot | Mapping[str, Any]) -> str
~~~


### `lightbulb.service_asset_remedy_lifecycle.ServiceAssetRemedyTransitionRequest`

class. Source: `lightbulb/service_asset_remedy_lifecycle.py:2387`.

Fields:
- `schema_id: Literal['lightbulb.service_asset_remedy_transition_request.v1'] = Field(default=SERVICE_ASSET_REMEDY_REQUEST_SCHEMA, alias='schema')`
- `scope: ServiceAssetRemedyScope`
- `scope_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `authorization: ServiceAssetRemedyAuthorizationCommitment`
- `root_commitment_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `lifecycle_ref: str = Field(min_length=1, max_length=160)`
- `expected_revision: int = Field(ge=0, lt=MAX_SERVICE_ASSET_TRANSITIONS)`
- `expected_state: ServiceAssetRemedyState | None = None`
- `expected_state_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `prior_history: tuple[ServiceAssetRemedyTransitionRecord, ...] = Field(max_length=MAX_SERVICE_ASSET_TRANSITIONS - 1)`
- `transition_ref: str = Field(min_length=1, max_length=160)`
- `idempotency_key: str = Field(min_length=8, max_length=200)`
- `idempotency_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `requested_by_ref: str = Field(min_length=1, max_length=160)`
- `proposed_at: str`
- `command: ServiceAssetRemedyCommand`
- `command_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `content_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `evidence_refs: tuple[ServiceAssetRemedyEvidence, ServiceAssetRemedyEvidence]`
- `request_digest: str = Field(pattern='^[0-9a-f]{64}$')`

### `lightbulb.service_asset_remedy_lifecycle.ServiceAssetRemedyTransitionProposal`

class. Source: `lightbulb/service_asset_remedy_lifecycle.py:2504`.

Fields:
- `schema_id: Literal['lightbulb.service_asset_remedy_transition_proposal.v1'] = Field(default=SERVICE_ASSET_REMEDY_PROPOSAL_SCHEMA, alias='schema')`
- `scope_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `root_commitment_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `lifecycle_ref: str = Field(min_length=1, max_length=160)`
- `source_revision: int = Field(ge=0, lt=MAX_SERVICE_ASSET_TRANSITIONS)`
- `source_state_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `target_revision: int = Field(ge=1, le=MAX_SERVICE_ASSET_TRANSITIONS)`
- `target_state: ServiceAssetRemedyState`
- `transition_ref: str = Field(min_length=1, max_length=160)`
- `request_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `command_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `transition_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `candidate_state_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `deterministic_retry_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `source_authorization_commitment_present: Literal[True]`
- `sdk_execution_authority_granted: Literal[False]`
- `authoritative_case_changed: Literal[False]`
- `rma_or_work_order_created: Literal[False]`
- `dispatch_or_shipping_executed: Literal[False]`
- `repair_or_inventory_write_executed: Literal[False]`
- `warranty_decision_executed: Literal[False]`
- `closure_executed: Literal[False]`
- `provider_write_executed: Literal[False]`
- `spring_submission_executed: Literal[False]`
- `proposal_digest: str = Field(pattern='^[0-9a-f]{64}$')`

### `lightbulb.service_asset_remedy_lifecycle.ServiceAssetRemedyTransitionResult`

class. Source: `lightbulb/service_asset_remedy_lifecycle.py:2553`.

Fields:
- `schema_id: Literal['lightbulb.service_asset_remedy_transition_result.v1'] = Field(default=SERVICE_ASSET_REMEDY_RESULT_SCHEMA, alias='schema')`
- `proposal: ServiceAssetRemedyTransitionProposal`
- `candidate_snapshot: ServiceAssetRemedySnapshot`
- `sdk_execution_authority_granted: Literal[False]`
- `authoritative_case_changed: Literal[False]`
- `provider_write_executed: Literal[False]`
- `result_digest: str = Field(pattern='^[0-9a-f]{64}$')`

### `lightbulb.service_asset_remedy_lifecycle.propose_service_asset_remedy_transition`

function. Source: `lightbulb/service_asset_remedy_lifecycle.py:2594`.



~~~python
propose_service_asset_remedy_transition(request: ServiceAssetRemedyTransitionRequest | Mapping[str, Any]) -> ServiceAssetRemedyTransitionResult
~~~


Materialize one exact candidate after full immutable-history replay.

### `lightbulb.service_asset_remedy_lifecycle.ServiceAssetRemedyEffectBoundary`

class. Source: `lightbulb/service_asset_remedy_lifecycle.py:2791`.

Fields:
- `schema_id: Literal['lightbulb.service_asset_remedy_effect_boundary.v1'] = Field(default='lightbulb.service_asset_remedy_effect_boundary.v1', alias='schema')`
- `sdk_projection_only: Literal[True] = True`
- `read_only_validation_completed: Literal[True] = True`
- `source_authorization_is_sdk_execution_authority: Literal[False] = False`
- `warranty_decision_executed: Literal[False] = False`
- `refund_or_credit_authorized_or_executed: Literal[False] = False`
- `rma_created_or_executed: Literal[False] = False`
- `shipping_or_dispatch_executed: Literal[False] = False`
- `repair_or_replacement_executed: Literal[False] = False`
- `parts_or_inventory_write_executed: Literal[False] = False`
- `work_order_created_or_changed: Literal[False] = False`
- `case_mutated_or_closed: Literal[False] = False`
- `provider_or_spring_write_executed: Literal[False] = False`
- `connector_calls: Literal[False] = False`

### `lightbulb.service_asset_remedy_lifecycle.ProposeServiceAssetRemedyTransitionPrimitive`

class. Source: `lightbulb/service_asset_remedy_lifecycle.py:3058`.

Fields:
- `example_inputs: Mapping[str, Any] = _example_inputs()`

#### Methods

##### `lightbulb.service_asset_remedy_lifecycle.ProposeServiceAssetRemedyTransitionPrimitive.implementation_contract`



~~~python
def implementation_contract() -> dict[str, Any]
~~~


Source: `lightbulb/service_asset_remedy_lifecycle.py:3083`.

## Module `lightbulb.service_controls`

Deterministic customer-service intake, SLA, and resolution controls.

### `lightbulb.service_controls.ServiceControlPolicy`

class. Source: `lightbulb/service_controls.py:406`.

Fields:
- `minimum_evidence_grade: PrimitiveEvidenceVerificationGrade = PrimitiveEvidenceVerificationGrade.ATTESTED`
- `max_evidence_age_hours: int = Field(default=168, ge=1, le=8760)`
- `minimum_classification_confidence: Decimal = Field(default=Decimal('0.800000'), ge=0, le=1)`
- `require_owner_for_assignment: bool = True`
- `require_financial_remedy_approval: bool = True`
- `require_entitlement_for_service_remedy: bool = True`
- `require_customer_resolution_confirmation: bool = True`
- `allow_unreachable_customer_manual_review: bool = True`

### `lightbulb.service_controls.ServiceControlInput`

class. Source: `lightbulb/service_controls.py:428`.

Fields:
- `schema_id: Literal['lightbulb.service_control_input.v1'] = Field(default=SERVICE_CONTROL_INPUT_SCHEMA, alias='schema')`
- `evaluation_ref: OpaqueRef`
- `target: ServiceTarget`
- `analysis_as_of: str`
- `case: ServiceCaseSnapshot`
- `sla: ServiceSlaSnapshot`
- `remedy: RemedyRequest | None = None`
- `entitlement: EntitlementSnapshot | None = None`
- `fulfillment: ServiceFulfillmentSnapshot | None = None`
- `resolution: ResolutionSnapshot | None = None`
- `policy: ServiceControlPolicy = Field(default_factory=ServiceControlPolicy)`

### `lightbulb.service_controls.ServiceEffectBoundary`

class. Source: `lightbulb/service_controls.py:543`.

Fields:
- `case_assigned_or_closed: Literal[False] = False`
- `escalation_created_or_resolved: Literal[False] = False`
- `refund_or_credit_authorized: Literal[False] = False`
- `warranty_or_rma_authorized: Literal[False] = False`
- `field_service_dispatched: Literal[False] = False`
- `entitlement_changed: Literal[False] = False`
- `customer_outcome_claimed: Literal[False] = False`
- `trusted_host_authority_required: Literal[True] = True`

### `lightbulb.service_controls.ServiceControlResult`

class. Source: `lightbulb/service_controls.py:565`.

Fields:
- `schema_id: Literal['lightbulb.service_control_result.v1'] = Field(default=SERVICE_CONTROL_RESULT_SCHEMA, alias='schema')`
- `evaluation_ref: OpaqueRef`
- `target: ServiceTarget`
- `analysis_as_of: str`
- `proposed_disposition: Disposition`
- `assurance_grade: PrimitiveEvidenceVerificationGrade`
- `gates: tuple[ServiceGateResult, ...]`
- `findings: tuple[ServiceFinding, ...]`
- `source_snapshot_digests: dict[str, str]`
- `evidence_refs: tuple[OpaqueRef, ...]`
- `effect_boundary: ServiceEffectBoundary = Field(default_factory=ServiceEffectBoundary)`
- `result_digest: str = Field(default=_ZERO_DIGEST, pattern='^[0-9a-f]{64}$')`

### `lightbulb.service_controls.evaluate_service_case_controls`

function. Source: `lightbulb/service_controls.py:727`.



~~~python
evaluate_service_case_controls(value: ServiceControlInput | Mapping[str, Any]) -> ServiceControlResult
~~~


Evaluate intake or resolution controls without exercising host authority.

### `lightbulb.service_controls.EvaluateCaseResolutionControlsPrimitive`

class. Source: `lightbulb/service_controls.py:1226`.

#### Methods

##### `lightbulb.service_controls.EvaluateCaseResolutionControlsPrimitive.implementation_contract`



~~~python
def implementation_contract() -> dict[str, Any]
~~~


Source: `lightbulb/service_controls.py:1277`.

## Module `lightbulb.shopify_primitives`

Closed-world, proposal-only Shopify storefront planning.

### `lightbulb.shopify_primitives.ShopifyStorefrontPlanValidationError`

class. Source: `lightbulb/shopify_primitives.py:145`.

A storefront brief cannot be safely converted into a proposal.

### `lightbulb.shopify_primitives.ShopifyMoney`

class. Source: `lightbulb/shopify_primitives.py:149`.

Fields:
- `amount: Decimal = Field(gt=0, le=100000000)`
- `currency: Currency`

### `lightbulb.shopify_primitives.ShopifyVariantOption`

class. Source: `lightbulb/shopify_primitives.py:168`.

Fields:
- `name: ShortText`
- `value: ShortText`

### `lightbulb.shopify_primitives.ShopifyProductVariantBrief`

class. Source: `lightbulb/shopify_primitives.py:173`.

Fields:
- `variant_ref: PortableRef`
- `title: ShortText`
- `price: ShopifyMoney`
- `sku: Annotated[str, StringConstraints(min_length=1, max_length=64), AfterValidator(_bounded_text)] | None = None`
- `options: list[ShopifyVariantOption] = Field(default_factory=list, max_length=3)`

### `lightbulb.shopify_primitives.ShopifyProductBrief`

class. Source: `lightbulb/shopify_primitives.py:195`.

Fields:
- `product_ref: PortableRef`
- `title: ShortText`
- `description: HtmlText | None = None`
- `vendor: ShortText | None = None`
- `product_type: ShortText | None = None`
- `tags: list[ShortText] = Field(default_factory=list, max_length=50)`
- `price: ShopifyMoney`
- `variants: list[ShopifyProductVariantBrief] = Field(default_factory=list, max_length=_MAX_VARIANTS_PER_PRODUCT)`

### `lightbulb.shopify_primitives.ShopifyPageBrief`

class. Source: `lightbulb/shopify_primitives.py:226`.

Fields:
- `page_ref: PortableRef`
- `title: ShortText`
- `body_html: HtmlText`
- `handle: Handle | None = None`

### `lightbulb.shopify_primitives.ShopifyCollectionBrief`

class. Source: `lightbulb/shopify_primitives.py:233`.

Fields:
- `collection_ref: PortableRef`
- `title: ShortText`
- `description_html: HtmlText | None = None`
- `handle: Handle | None = None`
- `product_refs: list[PortableRef] = Field(min_length=1, max_length=_MAX_PRODUCTS)`

### `lightbulb.shopify_primitives.ExistingShopifyThemeBrief`

class. Source: `lightbulb/shopify_primitives.py:248`.

Fields:
- `strategy: Literal['retain_existing'] = 'retain_existing'`
- `reference_name: ShortText | None = None`
- `desired_adjustments: list[LongText] = Field(default_factory=list, max_length=20)`

### `lightbulb.shopify_primitives.ShopifyStorefrontBrief`

class. Source: `lightbulb/shopify_primitives.py:254`.

Fields:
- `storefront_name: ShortText`
- `brand_summary: LongText`
- `target_audience: LongText`
- `business_goal: LongText`
- `default_currency: Currency`
- `locale: Locale = 'en-US'`

### `lightbulb.shopify_primitives.PlanShopifyStorefrontInput`

class. Source: `lightbulb/shopify_primitives.py:263`.

Business content only; authority, scope, credentials, and actions are absent.

Fields:
- `brief: ShopifyStorefrontBrief`
- `products: list[ShopifyProductBrief] = Field(min_length=1, max_length=_MAX_PRODUCTS)`
- `collection: ShopifyCollectionBrief`
- `pages: list[ShopifyPageBrief] = Field(default_factory=list, max_length=_MAX_PAGES)`
- `existing_theme: ExistingShopifyThemeBrief`

### `lightbulb.shopify_primitives.ShopifyProposedOperation`

class. Source: `lightbulb/shopify_primitives.py:357`.

Fields:
- `ordinal: int = Field(ge=1, le=_MAX_PRODUCTS + _MAX_PAGES + 1)`
- `operation_id: OperationRef`
- `tool: ProposedTool`
- `effect: Literal['write'] = 'write'`
- `arguments: ProposedArguments`
- `depends_on: list[OperationRef] = Field(default_factory=list, max_length=_MAX_PRODUCTS)`
- `bindings: list[ShopifyOperationBinding] = Field(default_factory=list, max_length=1)`
- `status: Literal['proposal_only_not_executed'] = 'proposal_only_not_executed'`
- `requires_separate_approval: Literal[True] = True`
- `approval_unit: OperationRef`

### `lightbulb.shopify_primitives.ShopifyCapabilityGap`

class. Source: `lightbulb/shopify_primitives.py:394`.

Fields:
- `code: CapabilityGapCode`
- `affected_tools: list[ProposedTool] = Field(default_factory=list, max_length=3)`
- `required_read_tool: Literal['shopify.get_shop_info'] | None = None`
- `blocks_materialization: Literal[True] = True`
- `message: LongText`

### `lightbulb.shopify_primitives.ShopifyBlockedAction`

class. Source: `lightbulb/shopify_primitives.py:402`.

Fields:
- `ordinal: int = Field(ge=1, le=_MAX_PRODUCTS + _MAX_PAGES + 2)`
- `action_id: OperationRef`
- `action: Literal['publish_product', 'publish_collection', 'publish_page', 'publish_existing_theme']`
- `tool: BlockedGoLiveTool | None`
- `source_operation_id: OperationRef | None = None`
- `status: Literal['blocked'] = 'blocked'`
- `reason_codes: list[BlockedReasonCode] = Field(min_length=1, max_length=6)`
- `requires_separate_approval: Literal[True] = True`
- `approval_unit: OperationRef`
- `message: LongText`

### `lightbulb.shopify_primitives.ShopifyEffectBoundary`

class. Source: `lightbulb/shopify_primitives.py:437`.

Fields:
- `connector_calls_made: Literal[0] = 0`
- `writes_executed: Literal[0] = 0`
- `resources_created: Literal[0] = 0`
- `resources_updated: Literal[0] = 0`
- `resources_published: Literal[0] = 0`

### `lightbulb.shopify_primitives.ShopifyStorefrontPlanOutput`

class. Source: `lightbulb/shopify_primitives.py:445`.

Fields:
- `schema_id: Literal['lightbulb.shopify_storefront_plan.v1'] = Field(default=SHOPIFY_STOREFRONT_PLAN_SCHEMA, alias='schema')`
- `primitive_ref: Literal['commerce.plan_shopify_storefront'] = SHOPIFY_STOREFRONT_PRIMITIVE_REF`
- `status: Literal['planned_with_blockers'] = 'planned_with_blockers'`
- `proposal_only: Literal[True] = True`
- `materialization_supported: Literal[False] = False`
- `live_store_changed: Literal[False] = False`
- `deployment_guarantee: Literal['none'] = 'none'`
- `storefront_brief: ShopifyStorefrontBrief`
- `proposed_operations: list[ShopifyProposedOperation] = Field(min_length=2, max_length=_MAX_PRODUCTS + _MAX_PAGES + 1)`
- `blocked_actions: list[ShopifyBlockedAction] = Field(min_length=3, max_length=_MAX_PRODUCTS + _MAX_PAGES + 2)`
- `capability_gaps: list[ShopifyCapabilityGap] = Field(min_length=3, max_length=4)`
- `existing_theme: ShopifyExistingThemeDisposition`
- `effect_boundary: ShopifyEffectBoundary = Field(default_factory=ShopifyEffectBoundary)`
- `summary: LongText`
- `plan_digest: Annotated[str, StringConstraints(pattern='^[0-9a-f]{64}$')]`

#### Methods

##### `lightbulb.shopify_primitives.ShopifyStorefrontPlanOutput.to_dict`



~~~python
def to_dict() -> dict[str, Any]
~~~


Source: `lightbulb/shopify_primitives.py:475`.

### `lightbulb.shopify_primitives.plan_shopify_storefront`

function. Source: `lightbulb/shopify_primitives.py:749`.



~~~python
plan_shopify_storefront(value: PlanShopifyStorefrontInput | Mapping[str, Any]) -> ShopifyStorefrontPlanOutput
~~~


Compile a deterministic storefront proposal with zero connector effects.

### `lightbulb.shopify_primitives.PlanShopifyStorefrontPrimitive`

class. Source: `lightbulb/shopify_primitives.py:823`.

Plan a draft Shopify storefront without reading or changing a shop.

## Module `lightbulb.software_factory_runtime`

Durable orchestration facades that join effects to measured feedback loops.

### `lightbulb.software_factory_runtime.StorefrontObservationRoute`

class. Source: `lightbulb/software_factory_runtime.py:97`.

Exact governed analytics route selected by the authenticated host.

Fields:
- `provider: Literal['shopify', 'google_analytics'] = 'shopify'`
- `connector_account_ref: str = Field(min_length=1, max_length=200)`
- `tenant_connector_id: UUID`
- `expected_tool_version: int = Field(ge=1)`
- `expected_route_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `max_attempts: int = Field(default=3, ge=1, le=10)`

### `lightbulb.software_factory_runtime.ProfitObservationRoute`

class. Source: `lightbulb/software_factory_runtime.py:116`.

Exact governed or host observation route for one profit workflow.

Fields:
- `provider: Literal['shopify', 'google_analytics', 'host']`
- `source_capability: str = Field(min_length=3, max_length=200)`
- `expected_tool_version: int = Field(ge=1)`
- `expected_route_digest: str | None = Field(default=None, pattern='^[0-9a-f]{64}$')`
- `connector_account_ref: str | None = Field(default=None, max_length=200)`
- `tenant_connector_id: UUID | None = None`
- `max_attempts: int = Field(default=3, ge=1, le=10)`

### `lightbulb.software_factory_runtime.StorefrontLaunchLoopResult`

class. Source: `lightbulb/software_factory_runtime.py:166`.

One launch/resume result plus its durable observation commitment.

Fields:
- `schema_id: Literal['lightbulb.software_factory_storefront_loop_result.v1'] = Field(default=SOFTWARE_FACTORY_STOREFRONT_LOOP_RESULT_SCHEMA, alias='schema')`
- `status: StorefrontLoopStatus`
- `launch: ShopifyLaunchRunResult`
- `observation_job_ref: str | None = Field(default=None, max_length=200)`
- `observation_due_at: str | None = None`
- `observation_job_digest: str | None = Field(default=None, pattern='^[0-9a-f]{64}$')`
- `scheduling_error_code: str | None = Field(default=None, max_length=120)`
- `summary: str = Field(min_length=1, max_length=1000)`

#### Methods

##### `lightbulb.software_factory_runtime.StorefrontLaunchLoopResult.to_dict`



~~~python
def to_dict() -> dict[str, Any]
~~~


Source: `lightbulb/software_factory_runtime.py:214`.

### `lightbulb.software_factory_runtime.RecoveryLoopResult`

class. Source: `lightbulb/software_factory_runtime.py:218`.

One recovery/resume result plus its durable observation commitment.

Fields:
- `schema_id: Literal['lightbulb.software_factory_recovery_loop_result.v1'] = Field(default=SOFTWARE_FACTORY_RECOVERY_LOOP_RESULT_SCHEMA, alias='schema')`
- `status: RecoveryLoopStatus`
- `recovery: AbandonedRecoveryRun`
- `observation_job_ref: str | None = Field(default=None, max_length=200)`
- `observation_due_at: str | None = None`
- `observation_job_digest: str | None = Field(default=None, pattern='^[0-9a-f]{64}$')`
- `scheduling_error_code: str | None = Field(default=None, max_length=120)`
- `summary: str = Field(min_length=1, max_length=1000)`

#### Methods

##### `lightbulb.software_factory_runtime.RecoveryLoopResult.to_dict`



~~~python
def to_dict() -> dict[str, Any]
~~~


Source: `lightbulb/software_factory_runtime.py:267`.

### `lightbulb.software_factory_runtime.ProfitWorkflowLoopResult`

class. Source: `lightbulb/software_factory_runtime.py:271`.

One adjacent workflow execution plus its durable learning commitment.

Fields:
- `schema_id: Literal['lightbulb.software_factory_profit_loop_result.v1'] = Field(default=SOFTWARE_FACTORY_PROFIT_LOOP_RESULT_SCHEMA, alias='schema')`
- `status: ProfitLoopStatus`
- `execution: ProfitWorkflowExecutionRun`
- `observation_job_ref: str | None = Field(default=None, max_length=200)`
- `observation_due_at: str | None = None`
- `observation_job_digest: str | None = Field(default=None, pattern='^[0-9a-f]{64}$')`
- `scheduling_error_code: str | None = Field(default=None, max_length=120)`
- `summary: str = Field(min_length=1, max_length=1000)`

#### Methods

##### `lightbulb.software_factory_runtime.ProfitWorkflowLoopResult.to_dict`



~~~python
def to_dict() -> dict[str, Any]
~~~


Source: `lightbulb/software_factory_runtime.py:320`.

### `lightbulb.software_factory_runtime.LightbulbSoftwareFactoryRuntime`

class. Source: `lightbulb/software_factory_runtime.py:324`.

Join governed launches, durable observation jobs, and a bounded worker.

#### Methods

##### `lightbulb.software_factory_runtime.LightbulbSoftwareFactoryRuntime.run_abandoned_recovery`



~~~python
def run_abandoned_recovery(recovery_plan: AbandonedRecoveryPlan | Mapping[str, Any], case: AbandonedRecoveryCase | Mapping[str, Any], *, resolved_secrets: RecoveryResolvedSecrets | Mapping[str, Any], scope: DynamicWorkflowScope | Mapping[str, Any], scope_keyring: ProfitScopeKeyRing, execution_scope: ExecutionScope | Mapping[str, Any], executor: ConnectorExecutor, experiment_ref: str, run_ref: str, iteration: int=1, preview_only: bool=True, dispatch_at: datetime | None=None, dispatch_attestation: RecoveryDispatchAttestation | Mapping[str, Any] | None=None, contact_reservation: RecoveryContactReservation | Mapping[str, Any] | None=None, contact_reservation_authority: RecoveryContactReservationAuthority | None=None, approval_grants: Mapping[str, ProfitActionApprovalGrant | Mapping[str, Any]] | None=None, existing_receipts: Iterable[ProfitActionExecutionReceipt | Mapping[str, Any]]=(), expected_reader_version: int=1, previous_evaluation: ProfitWorkflowEvaluation | None=None) -> RecoveryLoopResult
~~~


Run/resume recovery and schedule its holdout evaluation on completion.

Source: `lightbulb/software_factory_runtime.py:445`.

##### `lightbulb.software_factory_runtime.LightbulbSoftwareFactoryRuntime.run_due_observations`



~~~python
def run_due_observations(*, now: datetime | None=None) -> tuple[ObservationRunResult, ...]
~~~


Source: `lightbulb/software_factory_runtime.py:680`.

##### `lightbulb.software_factory_runtime.LightbulbSoftwareFactoryRuntime.run_profit_workflow`



~~~python
def run_profit_workflow(plan: ProfitWorkflowPlan | Mapping[str, Any], *, scope: DynamicWorkflowScope | Mapping[str, Any], scope_keyring: ProfitScopeKeyRing, execution_scope: ExecutionScope | Mapping[str, Any], executor: ConnectorExecutor, connector_arguments: Mapping[str, Mapping[str, Any] | BaseModel], route: ProfitObservationRoute | Mapping[str, Any], run_ref: str, iteration: int=1, preview_only: bool=True, approval_grants: Mapping[str, ProfitActionApprovalGrant | Mapping[str, Any]] | None=None, existing_receipts: Iterable[ProfitActionExecutionReceipt | Mapping[str, Any]]=(), query_arguments: Mapping[str, Any] | None=None, previous_evaluation: ProfitWorkflowEvaluation | None=None) -> ProfitWorkflowLoopResult
~~~


Run/resume a materializable adjacent workflow and schedule learning.

Source: `lightbulb/software_factory_runtime.py:564`.

##### `lightbulb.software_factory_runtime.LightbulbSoftwareFactoryRuntime.run_storefront_launch`



~~~python
def run_storefront_launch(plan: OmnichannelProductLaunchPlan | Mapping[str, Any], *, scope: DynamicWorkflowScope | Mapping[str, Any], scope_keyring: ExactScopeDigestProvider, execution_scope: ExecutionScope | Mapping[str, Any], executor: ConnectorExecutor, route: StorefrontObservationRoute | Mapping[str, Any], run_ref: str, iteration: int=1, preview_only: bool=True, approval_grants: Iterable[ProductLaunchApprovalGrant | Mapping[str, Any]]=(), readiness_verifier: LandingReadinessVerifier | None=None) -> StorefrontLaunchLoopResult
~~~


Run/resume Shopify and schedule measurement on exact readiness.

Source: `lightbulb/software_factory_runtime.py:336`.

##### `lightbulb.software_factory_runtime.LightbulbSoftwareFactoryRuntime.serve_observations`



~~~python
def serve_observations(*, stop_requested: Callable[[], bool], max_cycles: int | None=None) -> int
~~~


Run the bounded durable worker in an application-owned process.

Source: `lightbulb/software_factory_runtime.py:687`.

## Module `lightbulb.stripe`

Typed client for the Stripe Orchestration Agent.

### `lightbulb.stripe.StripeWorkflow`

class. Source: `lightbulb/stripe.py:35`.

Names of the high-level composite workflows the orchestrator exposes.

#### Methods

##### `lightbulb.stripe.StripeWorkflow.all`



~~~python
def all() -> List[str]
~~~


Source: `lightbulb/stripe.py:44`.

### `lightbulb.stripe.StripeOrchestratorClient`

class. Source: `lightbulb/stripe.py:54`.

Thin wrapper over LightbulbClient that drives the Stripe orchestration agent through the platform's standard tool-invocation surface.

Fields:
- `inner: LightbulbClient`

#### Methods

##### `lightbulb.stripe.StripeOrchestratorClient.account_health`



~~~python
def account_health() -> Dict[str, Any]
~~~


Source: `lightbulb/stripe.py:175`.

##### `lightbulb.stripe.StripeOrchestratorClient.approve`



~~~python
def approve(approval_id: str, **extra: Any) -> Dict[str, Any]
~~~


Source: `lightbulb/stripe.py:153`.

##### `lightbulb.stripe.StripeOrchestratorClient.as_agent_toolkit_tools`



~~~python
def as_agent_toolkit_tools() -> List[Dict[str, Any]]
~~~


Return tool descriptors compatible with stripe-agent-toolkit shape.

Source: `lightbulb/stripe.py:201`.

##### `lightbulb.stripe.StripeOrchestratorClient.create_refund`



~~~python
def create_refund(charge_id: str, amount: int, **extra: Any) -> Dict[str, Any]
~~~


Source: `lightbulb/stripe.py:96`.

##### `lightbulb.stripe.StripeOrchestratorClient.dispatch`



~~~python
def dispatch(resource: str, verb: str, op_inputs: Optional[Dict[str, Any]]=None, *, stripe_account_id: Optional[str]=None) -> Dict[str, Any]
~~~


Send any (resource, verb) combination through the orchestrator.

Source: `lightbulb/stripe.py:62`.

##### `lightbulb.stripe.StripeOrchestratorClient.execute`



~~~python
def execute(approval_id: str) -> Dict[str, Any]
~~~


Source: `lightbulb/stripe.py:165`.

##### `lightbulb.stripe.StripeOrchestratorClient.forecast_snapshot`



~~~python
def forecast_snapshot() -> Dict[str, Any]
~~~


Source: `lightbulb/stripe.py:172`.

##### `lightbulb.stripe.StripeOrchestratorClient.list_customers`



~~~python
def list_customers(**filters: Any) -> Dict[str, Any]
~~~


Source: `lightbulb/stripe.py:87`.

##### `lightbulb.stripe.StripeOrchestratorClient.list_pending_approvals`



~~~python
def list_pending_approvals() -> Dict[str, Any]
~~~


Source: `lightbulb/stripe.py:150`.

##### `lightbulb.stripe.StripeOrchestratorClient.list_subscriptions`



~~~python
def list_subscriptions(**filters: Any) -> Dict[str, Any]
~~~


Source: `lightbulb/stripe.py:90`.

##### `lightbulb.stripe.StripeOrchestratorClient.mcp_invoke`



~~~python
def mcp_invoke(tool: str, arguments: Optional[Dict[str, Any]]=None, *, stripe_account_id: Optional[str]=None) -> Dict[str, Any]
~~~


Source: `lightbulb/stripe.py:192`.

##### `lightbulb.stripe.StripeOrchestratorClient.raw_api_request`



~~~python
def raw_api_request(api_path: str, *, method: str='GET', params: Optional[Dict[str, Any]]=None, stripe_account_id: Optional[str]=None, base_address: Optional[str]=None) -> Dict[str, Any]
~~~


Governed long-tail Stripe API request.

Source: `lightbulb/stripe.py:103`.

##### `lightbulb.stripe.StripeOrchestratorClient.reject`



~~~python
def reject(approval_id: str, reason: str='') -> Dict[str, Any]
~~~


Source: `lightbulb/stripe.py:159`.

##### `lightbulb.stripe.StripeOrchestratorClient.retrieve_charge`



~~~python
def retrieve_charge(charge_id: str) -> Dict[str, Any]
~~~


Source: `lightbulb/stripe.py:93`.

##### `lightbulb.stripe.StripeOrchestratorClient.run_preference_learner`



~~~python
def run_preference_learner() -> Dict[str, Any]
~~~


Source: `lightbulb/stripe.py:178`.

##### `lightbulb.stripe.StripeOrchestratorClient.run_workflow`



~~~python
def run_workflow(workflow: str) -> Dict[str, Any]
~~~


Source: `lightbulb/stripe.py:183`.

##### `lightbulb.stripe.StripeOrchestratorClient.twin_list`



~~~python
def twin_list(resource_kind: str, *, limit: int=50) -> Dict[str, Any]
~~~


Source: `lightbulb/stripe.py:134`.

##### `lightbulb.stripe.StripeOrchestratorClient.twin_retrieve`



~~~python
def twin_retrieve(*, stripe_account_id: str, resource_kind: str, external_id: str) -> Dict[str, Any]
~~~


Source: `lightbulb/stripe.py:140`.

## Module `lightbulb.supply_chain_controls`

Deterministic supply-chain planning and fulfillment control evaluation.

### `lightbulb.supply_chain_controls.supply_chain_snapshot_digest`

function. Source: `lightbulb/supply_chain_controls.py:284`.



~~~python
supply_chain_snapshot_digest(snapshot: BaseModel | Mapping[str, Any]) -> str
~~~


Return a canonical SHA-256 digest for one normalized snapshot.

### `lightbulb.supply_chain_controls.SupplyChainControlPolicy`

class. Source: `lightbulb/supply_chain_controls.py:319`.

Fields:
- `minimum_evidence_grade: PrimitiveEvidenceVerificationGrade = PrimitiveEvidenceVerificationGrade.ATTESTED`
- `max_evidence_age_hours: int = Field(default=168, ge=1, le=8760)`
- `max_forecast_age_hours: int = Field(default=168, ge=1, le=8760)`
- `minimum_forecast_confidence: Decimal = Field(default=Decimal('0.700000'), ge=0, le=1)`
- `forecast_plan_tolerance_ratio: Decimal = Field(default=Decimal('0.100000'), ge=0, le=1)`
- `minimum_supplier_on_time_ratio: Decimal = Field(default=Decimal('0.900000'), ge=0, le=1)`
- `maximum_supplier_defect_ratio: Decimal = Field(default=Decimal('0.050000'), ge=0, le=1)`
- `maximum_supplier_lead_time_days: int = Field(default=180, ge=1, le=3650)`
- `maximum_warehouse_utilization_ratio: Decimal = Field(default=Decimal('0.950000'), gt=0, le=1)`
- `minimum_inventory_accuracy_ratio: Decimal = Field(default=Decimal('0.980000'), ge=0, le=1)`

### `lightbulb.supply_chain_controls.PlanFulfillmentControlsInput`

class. Source: `lightbulb/supply_chain_controls.py:810`.

Fields:
- `schema_id: Literal['lightbulb.supply_chain_plan_fulfillment_controls_input.v1'] = Field(default=PLAN_FULFILLMENT_CONTROLS_INPUT_SCHEMA, alias='schema')`
- `control_ref: OpaqueRef`
- `company_ref: OpaqueRef`
- `analysis_as_of: str`
- `coverage: SupplyChainSnapshotCoverage`
- `planning_cycle: PlanningCycleSnapshot`
- `suppliers: tuple[SupplierPerformanceSnapshot, ...] = Field(max_length=200)`
- `demand_forecasts: tuple[DemandForecastSnapshot, ...] = Field(max_length=1000)`
- `plan_lines: tuple[SupplyDemandPlanLine, ...] = Field(min_length=1, max_length=1000)`
- `allocations: tuple[AllocationPlanLine, ...] = Field(max_length=2000)`
- `replenishments: tuple[ReplenishmentPlanLine, ...] = Field(max_length=1000)`
- `warehouses: tuple[WarehouseSnapshot, ...] = Field(max_length=200)`
- `shipments: tuple[ShipmentSnapshot, ...] = Field(max_length=2000)`
- `evidence_refs: tuple[PrimitiveEvidenceRef, ...] = Field(max_length=_MAX_EVIDENCE_REFS)`
- `policy: SupplyChainControlPolicy = Field(default_factory=SupplyChainControlPolicy)`

### `lightbulb.supply_chain_controls.SupplyChainEffectBoundary`

class. Source: `lightbulb/supply_chain_controls.py:972`.

Fields:
- `connector_reads: Literal[0] = 0`
- `connector_writes: Literal[0] = 0`
- `approvals_consumed: Literal[0] = 0`
- `inventory_changed: Literal[False] = False`
- `orders_created: Literal[False] = False`
- `allocations_committed: Literal[False] = False`
- `replenishments_committed: Literal[False] = False`
- `shipments_changed: Literal[False] = False`
- `fulfillment_authorized: Literal[False] = False`
- `external_systems_changed: Literal[False] = False`

### `lightbulb.supply_chain_controls.PlanFulfillmentControlsResult`

class. Source: `lightbulb/supply_chain_controls.py:985`.

Fields:
- `schema_id: Literal['lightbulb.supply_chain_plan_fulfillment_controls_result.v1'] = Field(default=PLAN_FULFILLMENT_CONTROLS_RESULT_SCHEMA, alias='schema')`
- `control_ref: OpaqueRef`
- `company_ref: OpaqueRef`
- `analysis_as_of: str`
- `assurance_grade: PrimitiveEvidenceVerificationGrade`
- `proposed_disposition: PlanFulfillmentDisposition`
- `fulfillment_authorized: Literal[False] = False`
- `gates: tuple[SupplyChainGateResult, ...]`
- `plan_line_results: tuple[PlanLineControlResult, ...]`
- `shipment_results: tuple[ShipmentControlResult, ...]`
- `findings: tuple[SupplyChainFinding, ...] = Field(max_length=_MAX_FINDINGS)`
- `source_snapshot_digests: dict[str, Sha256Digest]`
- `evidence_refs: tuple[OpaqueRef, ...] = Field(max_length=_MAX_EVIDENCE_REFS)`
- `operation_spec: PrimitiveOperationSpec`
- `operation_digest: Sha256Digest`
- `evidence_digest: Sha256Digest`
- `effect_boundary: SupplyChainEffectBoundary = Field(default_factory=SupplyChainEffectBoundary)`
- `result_digest: Sha256Digest = _ZERO_DIGEST`

### `lightbulb.supply_chain_controls.evaluate_plan_fulfillment_controls`

function. Source: `lightbulb/supply_chain_controls.py:1409`.



~~~python
evaluate_plan_fulfillment_controls(inputs: PlanFulfillmentControlsInput | Mapping[str, Any]) -> PlanFulfillmentControlsResult
~~~


Evaluate planning and fulfillment controls without changing operations.

### `lightbulb.supply_chain_controls.EvaluatePlanFulfillmentControlsPrimitive`

class. Source: `lightbulb/supply_chain_controls.py:3152`.

#### Methods

##### `lightbulb.supply_chain_controls.EvaluatePlanFulfillmentControlsPrimitive.implementation_contract`



~~~python
def implementation_contract() -> dict[str, Any]
~~~


Source: `lightbulb/supply_chain_controls.py:3177`.

## Module `lightbulb.supply_chain_execution_lifecycle`

Deterministic, non-authoritative supply-chain execution projections.

### `lightbulb.supply_chain_execution_lifecycle.SupplyChainExecutionError`

class. Source: `lightbulb/supply_chain_execution_lifecycle.py:99`.

Stable, fail-closed lifecycle error returned by the primitive wrapper.

### `lightbulb.supply_chain_execution_lifecycle.SupplyChainExecutionScope`

class. Source: `lightbulb/supply_chain_execution_lifecycle.py:224`.

Fields:
- `schema_id: Literal['lightbulb.supply_chain_execution_scope.v1'] = Field(default=SUPPLY_CHAIN_SCOPE_SCHEMA, alias='schema')`
- `tenant_ref: str = Field(min_length=1, max_length=160)`
- `company_ref: str = Field(min_length=1, max_length=160)`
- `project_ref: str = Field(min_length=1, max_length=160)`
- `project_id: UUID`
- `planning_cycle_ref: str = Field(min_length=1, max_length=160)`
- `item_ref: str = Field(min_length=1, max_length=160)`
- `source_location_ref: str = Field(min_length=1, max_length=160)`
- `destination_location_ref: str = Field(min_length=1, max_length=160)`
- `unit_of_measure: str = Field(min_length=1, max_length=32)`

### `lightbulb.supply_chain_execution_lifecycle.supply_chain_scope_digest`

function. Source: `lightbulb/supply_chain_execution_lifecycle.py:275`.



~~~python
supply_chain_scope_digest(scope: SupplyChainExecutionScope | Mapping[str, Any]) -> str
~~~


### `lightbulb.supply_chain_execution_lifecycle.SupplyChainExecutionEvidence`

class. Source: `lightbulb/supply_chain_execution_lifecycle.py:282`.

Fields:
- `schema_id: Literal['lightbulb.supply_chain_execution_evidence.v1'] = Field(default=SUPPLY_CHAIN_EVIDENCE_SCHEMA, alias='schema')`
- `evidence_ref: str = Field(min_length=1, max_length=200)`
- `kind: str = Field(min_length=1, max_length=80)`
- `issuer_ref: Literal['spring:supply-chain-authority']`
- `custodian_ref: Literal['spring:supply-chain-evidence-vault']`
- `subject_ref: str = Field(min_length=1, max_length=200)`
- `sha256: str = Field(pattern='^[0-9a-f]{64}$')`
- `observed_at: str`
- `effective_at: str`
- `verification_grade: Literal['attested', 'verified']`
- `classification: Literal['confidential', 'restricted'] = 'restricted'`
- `retention_policy: Literal['supply-chain-seven-years']`
- `single_use: Literal[True]`
- `causal_revision: int = Field(ge=0, le=MAX_TRANSITIONS)`
- `causal_state_digest: str = Field(pattern='^[0-9a-f]{64}$')`

#### Methods

##### `lightbulb.supply_chain_execution_lifecycle.SupplyChainExecutionEvidence.portable_ref`



~~~python
def portable_ref() -> PrimitiveEvidenceRef
~~~


Source: `lightbulb/supply_chain_execution_lifecycle.py:318`.

### `lightbulb.supply_chain_execution_lifecycle.SupplyChainApprovalEvidence`

class. Source: `lightbulb/supply_chain_execution_lifecycle.py:335`.

Fields:
- `schema_id: Literal['lightbulb.supply_chain_execution_approval.v1'] = Field(default=SUPPLY_CHAIN_APPROVAL_SCHEMA, alias='schema')`
- `approval_ref: str = Field(min_length=1, max_length=200)`
- `approval_receipt_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `scope_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `lifecycle_ref: str = Field(min_length=1, max_length=160)`
- `transition_ref: str = Field(min_length=1, max_length=160)`
- `command_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `idempotency_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `approved_by_ref: str = Field(min_length=1, max_length=160)`
- `approver_role: ApprovalRole`
- `approved_at: str`
- `expires_at: str`
- `decision: Literal['approved']`
- `single_use: Literal[True]`
- `sdk_execution_authority_granted: Literal[False]`
- `approval_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `evidence: SupplyChainExecutionEvidence`

### `lightbulb.supply_chain_execution_lifecycle.supply_chain_approval_digest`

function. Source: `lightbulb/supply_chain_execution_lifecycle.py:404`.



~~~python
supply_chain_approval_digest(approval: SupplyChainApprovalEvidence | Mapping[str, Any]) -> str
~~~


### `lightbulb.supply_chain_execution_lifecycle.ProjectDemandForecastCommand`

class. Source: `lightbulb/supply_chain_execution_lifecycle.py:432`.

Fields:
- `schema_id: Literal['lightbulb.supply_chain_project_demand_forecast_command.v1'] = Field(default='lightbulb.supply_chain_project_demand_forecast_command.v1', alias='schema')`
- `kind: Literal['project_demand_forecast']`
- `forecast_ref: str = Field(min_length=1, max_length=160)`
- `planning_cycle_ref: str = Field(min_length=1, max_length=160)`
- `item_ref: str = Field(min_length=1, max_length=160)`
- `source_location_ref: str = Field(min_length=1, max_length=160)`
- `unit_of_measure: str = Field(min_length=1, max_length=32)`
- `horizon_start: date`
- `horizon_end: date`
- `generated_at: str`
- `forecast_quantity: Decimal`
- `model_version: str = Field(min_length=1, max_length=80)`
- `planner_ref: str = Field(min_length=1, max_length=160)`

### `lightbulb.supply_chain_execution_lifecycle.ApproveSopCommand`

class. Source: `lightbulb/supply_chain_execution_lifecycle.py:480`.

Fields:
- `schema_id: Literal['lightbulb.supply_chain_approve_sop_command.v1'] = Field(default='lightbulb.supply_chain_approve_sop_command.v1', alias='schema')`
- `kind: Literal['approve_sop']`
- `sop_plan_ref: str = Field(min_length=1, max_length=160)`
- `forecast_ref: str = Field(min_length=1, max_length=160)`
- `approved_quantity: Decimal`
- `unit_of_measure: str = Field(min_length=1, max_length=32)`
- `submitted_by_ref: str = Field(min_length=1, max_length=160)`

### `lightbulb.supply_chain_execution_lifecycle.RecordMrpSupplyPlanCommand`

class. Source: `lightbulb/supply_chain_execution_lifecycle.py:497`.

Fields:
- `schema_id: Literal['lightbulb.supply_chain_record_mrp_supply_plan_command.v1'] = Field(default='lightbulb.supply_chain_record_mrp_supply_plan_command.v1', alias='schema')`
- `kind: Literal['record_mrp_supply_plan']`
- `mrp_run_ref: str = Field(min_length=1, max_length=160)`
- `sop_plan_ref: str = Field(min_length=1, max_length=160)`
- `unit_of_measure: str = Field(min_length=1, max_length=32)`
- `approved_demand_quantity: Decimal`
- `opening_on_hand_quantity: Decimal`
- `confirmed_inbound_quantity: Decimal`
- `planned_production_quantity: Decimal`
- `safety_stock_quantity: Decimal`
- `required_replenishment_quantity: Decimal`
- `planned_at: str`
- `planner_ref: str = Field(min_length=1, max_length=160)`

### `lightbulb.supply_chain_execution_lifecycle.AllocateSupplyCommand`

class. Source: `lightbulb/supply_chain_execution_lifecycle.py:556`.

Fields:
- `schema_id: Literal['lightbulb.supply_chain_allocate_supply_command.v1'] = Field(default='lightbulb.supply_chain_allocate_supply_command.v1', alias='schema')`
- `kind: Literal['allocate_supply']`
- `allocation_ref: str = Field(min_length=1, max_length=160)`
- `mrp_run_ref: str = Field(min_length=1, max_length=160)`
- `destination_location_ref: str = Field(min_length=1, max_length=160)`
- `unit_of_measure: str = Field(min_length=1, max_length=32)`
- `allocation_quantity: Decimal`
- `allocator_ref: str = Field(min_length=1, max_length=160)`

### `lightbulb.supply_chain_execution_lifecycle.PlanReplenishmentCommand`

class. Source: `lightbulb/supply_chain_execution_lifecycle.py:574`.

Fields:
- `schema_id: Literal['lightbulb.supply_chain_plan_replenishment_command.v1'] = Field(default='lightbulb.supply_chain_plan_replenishment_command.v1', alias='schema')`
- `kind: Literal['plan_replenishment']`
- `replenishment_ref: str = Field(min_length=1, max_length=160)`
- `mrp_run_ref: str = Field(min_length=1, max_length=160)`
- `allocation_ref: str = Field(min_length=1, max_length=160)`
- `status: Literal['planned', 'not_required']`
- `supplier_ref: str | None = Field(default=None, min_length=1, max_length=160)`
- `unit_of_measure: str = Field(min_length=1, max_length=32)`
- `replenishment_quantity: Decimal`
- `order_by: str`
- `expected_receipt_at: str`
- `planner_ref: str = Field(min_length=1, max_length=160)`

### `lightbulb.supply_chain_execution_lifecycle.ReleaseWarehouseCommand`

class. Source: `lightbulb/supply_chain_execution_lifecycle.py:614`.

Fields:
- `schema_id: Literal['lightbulb.supply_chain_release_warehouse_command.v1'] = Field(default='lightbulb.supply_chain_release_warehouse_command.v1', alias='schema')`
- `kind: Literal['release_warehouse']`
- `warehouse_release_ref: str = Field(min_length=1, max_length=160)`
- `allocation_ref: str = Field(min_length=1, max_length=160)`
- `source_location_ref: str = Field(min_length=1, max_length=160)`
- `unit_of_measure: str = Field(min_length=1, max_length=32)`
- `release_quantity: Decimal`
- `released_at: str`
- `warehouse_operator_ref: str = Field(min_length=1, max_length=160)`

### `lightbulb.supply_chain_execution_lifecycle.DispatchShipmentCommand`

class. Source: `lightbulb/supply_chain_execution_lifecycle.py:638`.

Fields:
- `schema_id: Literal['lightbulb.supply_chain_dispatch_shipment_command.v1'] = Field(default='lightbulb.supply_chain_dispatch_shipment_command.v1', alias='schema')`
- `kind: Literal['dispatch_shipment']`
- `shipment_ref: str = Field(min_length=1, max_length=160)`
- `warehouse_release_ref: str = Field(min_length=1, max_length=160)`
- `unit_of_measure: str = Field(min_length=1, max_length=32)`
- `shipment_quantity: Decimal`
- `carrier_ref: str = Field(min_length=1, max_length=160)`
- `custody_event_ref: str = Field(min_length=1, max_length=160)`
- `from_custodian_ref: str = Field(min_length=1, max_length=160)`
- `to_custodian_ref: str = Field(min_length=1, max_length=160)`
- `dispatched_at: str`
- `dispatcher_ref: str = Field(min_length=1, max_length=160)`

### `lightbulb.supply_chain_execution_lifecycle.RecordCustodyTransferCommand`

class. Source: `lightbulb/supply_chain_execution_lifecycle.py:671`.

Fields:
- `schema_id: Literal['lightbulb.supply_chain_record_custody_transfer_command.v1'] = Field(default='lightbulb.supply_chain_record_custody_transfer_command.v1', alias='schema')`
- `kind: Literal['record_custody_transfer']`
- `shipment_ref: str = Field(min_length=1, max_length=160)`
- `custody_event_ref: str = Field(min_length=1, max_length=160)`
- `sequence: int = Field(ge=2, le=MAX_CUSTODY_EVENTS)`
- `from_custodian_ref: str = Field(min_length=1, max_length=160)`
- `to_custodian_ref: str = Field(min_length=1, max_length=160)`
- `transferred_at: str`
- `recorder_ref: str = Field(min_length=1, max_length=160)`

### `lightbulb.supply_chain_execution_lifecycle.RecordDeliveryCommand`

class. Source: `lightbulb/supply_chain_execution_lifecycle.py:703`.

Fields:
- `schema_id: Literal['lightbulb.supply_chain_record_delivery_command.v1'] = Field(default='lightbulb.supply_chain_record_delivery_command.v1', alias='schema')`
- `kind: Literal['record_delivery']`
- `delivery_ref: str = Field(min_length=1, max_length=160)`
- `shipment_ref: str = Field(min_length=1, max_length=160)`
- `destination_location_ref: str = Field(min_length=1, max_length=160)`
- `unit_of_measure: str = Field(min_length=1, max_length=32)`
- `delivered_quantity: Decimal`
- `delivered_at: str`
- `receiving_custodian_ref: str = Field(min_length=1, max_length=160)`
- `recorder_ref: str = Field(min_length=1, max_length=160)`

### `lightbulb.supply_chain_execution_lifecycle.OpenShipmentExceptionCommand`

class. Source: `lightbulb/supply_chain_execution_lifecycle.py:736`.

Fields:
- `schema_id: Literal['lightbulb.supply_chain_open_shipment_exception_command.v1'] = Field(default='lightbulb.supply_chain_open_shipment_exception_command.v1', alias='schema')`
- `kind: Literal['open_shipment_exception']`
- `exception_ref: str = Field(min_length=1, max_length=160)`
- `shipment_ref: str = Field(min_length=1, max_length=160)`
- `category: Literal['delay', 'damage', 'loss', 'customs', 'temperature', 'capacity', 'address', 'other']`
- `severity: Literal['review', 'blocking']`
- `detected_at: str`
- `response_deadline_at: str`
- `reporter_ref: str = Field(min_length=1, max_length=160)`

### `lightbulb.supply_chain_execution_lifecycle.ResolveShipmentExceptionCommand`

class. Source: `lightbulb/supply_chain_execution_lifecycle.py:781`.

Fields:
- `schema_id: Literal['lightbulb.supply_chain_resolve_shipment_exception_command.v1'] = Field(default='lightbulb.supply_chain_resolve_shipment_exception_command.v1', alias='schema')`
- `kind: Literal['resolve_shipment_exception']`
- `resolution_ref: str = Field(min_length=1, max_length=160)`
- `exception_ref: str = Field(min_length=1, max_length=160)`
- `outcome: Literal['redelivery_planned', 'return_planned', 'carrier_claim_planned', 'closed_no_provider_write']`
- `resolved_at: str`
- `resolver_ref: str = Field(min_length=1, max_length=160)`

### `lightbulb.supply_chain_execution_lifecycle.MarkExecutionInDoubtCommand`

class. Source: `lightbulb/supply_chain_execution_lifecycle.py:806`.

Fields:
- `schema_id: Literal['lightbulb.supply_chain_mark_execution_in_doubt_command.v1'] = Field(default='lightbulb.supply_chain_mark_execution_in_doubt_command.v1', alias='schema')`
- `kind: Literal['mark_execution_in_doubt']`
- `ambiguity_ref: str = Field(min_length=1, max_length=160)`
- `ambiguous_operation_ref: str = Field(min_length=1, max_length=160)`
- `detected_at: str`
- `resolution_deadline_at: str`
- `detector_ref: str = Field(min_length=1, max_length=160)`

### `lightbulb.supply_chain_execution_lifecycle.ResolveExecutionInDoubtCommand`

class. Source: `lightbulb/supply_chain_execution_lifecycle.py:838`.

Fields:
- `schema_id: Literal['lightbulb.supply_chain_resolve_execution_in_doubt_command.v1'] = Field(default='lightbulb.supply_chain_resolve_execution_in_doubt_command.v1', alias='schema')`
- `kind: Literal['resolve_execution_in_doubt']`
- `recovery_ref: str = Field(min_length=1, max_length=160)`
- `ambiguity_ref: str = Field(min_length=1, max_length=160)`
- `outcome: Literal['effect_not_applied']`
- `resolved_at: str`
- `reconciler_ref: str = Field(min_length=1, max_length=160)`

### `lightbulb.supply_chain_execution_lifecycle.CloseExecutionCommand`

class. Source: `lightbulb/supply_chain_execution_lifecycle.py:858`.

Fields:
- `schema_id: Literal['lightbulb.supply_chain_close_execution_command.v1'] = Field(default='lightbulb.supply_chain_close_execution_command.v1', alias='schema')`
- `kind: Literal['close_execution']`
- `closure_ref: str = Field(min_length=1, max_length=160)`
- `closed_at: str`
- `closer_ref: str = Field(min_length=1, max_length=160)`

### `lightbulb.supply_chain_execution_lifecycle.supply_chain_command_digest`

function. Source: `lightbulb/supply_chain_execution_lifecycle.py:896`.



~~~python
supply_chain_command_digest(command: SupplyChainCommand | Mapping[str, Any]) -> str
~~~


### `lightbulb.supply_chain_execution_lifecycle.supply_chain_idempotency_digest`

function. Source: `lightbulb/supply_chain_execution_lifecycle.py:903`.



~~~python
supply_chain_idempotency_digest(scope: SupplyChainExecutionScope | Mapping[str, Any], lifecycle_ref: str, idempotency_key: str) -> str
~~~


### `lightbulb.supply_chain_execution_lifecycle.supply_chain_fact_evidence_digest`

function. Source: `lightbulb/supply_chain_execution_lifecycle.py:919`.



~~~python
supply_chain_fact_evidence_digest(scope: SupplyChainExecutionScope | Mapping[str, Any], lifecycle_ref: str, transition_ref: str, command: SupplyChainCommand | Mapping[str, Any]) -> str
~~~


### `lightbulb.supply_chain_execution_lifecycle.SupplyChainCustodyProjection`

class. Source: `lightbulb/supply_chain_execution_lifecycle.py:1029`.

Fields:
- `custody_event_ref: str = Field(min_length=1, max_length=160)`
- `sequence: int = Field(ge=1, le=MAX_CUSTODY_EVENTS)`
- `from_custodian_ref: str = Field(min_length=1, max_length=160)`
- `to_custodian_ref: str = Field(min_length=1, max_length=160)`
- `transferred_at: str`

### `lightbulb.supply_chain_execution_lifecycle.SupplyChainTransitionRecord`

class. Source: `lightbulb/supply_chain_execution_lifecycle.py:1069`.

Fields:
- `schema_id: Literal['lightbulb.supply_chain_execution_transition_record.v1'] = Field(default=SUPPLY_CHAIN_TRANSITION_RECORD_SCHEMA, alias='schema')`
- `revision: int = Field(ge=1, le=MAX_TRANSITIONS)`
- `scope_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `lifecycle_ref: str = Field(min_length=1, max_length=160)`
- `transition_ref: str = Field(min_length=1, max_length=160)`
- `prior_state: SupplyChainState | None = None`
- `prior_state_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `command: SupplyChainCommand`
- `command_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `content_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `idempotency_key: str = Field(min_length=8, max_length=200)`
- `idempotency_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `requested_by_ref: str = Field(min_length=1, max_length=160)`
- `proposed_at: str`
- `evidence_refs: list[SupplyChainExecutionEvidence] = Field(min_length=1, max_length=MAX_EVIDENCE_PER_TRANSITION)`
- `evidence_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `required_approver_role: ApprovalRole | None = None`
- `approval_ref: str | None = Field(default=None, min_length=1, max_length=200)`
- `approval_digest: str | None = Field(default=None, pattern='^[0-9a-f]{64}$')`
- `authoritative_state_changed: Literal[False]`
- `optimizer_executed: Literal[False]`
- `inventory_write_executed: Literal[False]`
- `warehouse_write_executed: Literal[False]`
- `carrier_write_executed: Literal[False]`
- `transition_digest: str = Field(pattern='^[0-9a-f]{64}$')`

### `lightbulb.supply_chain_execution_lifecycle.SupplyChainExecutionSnapshot`

class. Source: `lightbulb/supply_chain_execution_lifecycle.py:1174`.

Fields:
- `schema_id: Literal['lightbulb.supply_chain_execution_snapshot.v1'] = Field(default=SUPPLY_CHAIN_SNAPSHOT_SCHEMA, alias='schema')`
- `scope: SupplyChainExecutionScope`
- `scope_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `lifecycle_ref: str = Field(min_length=1, max_length=160)`
- `revision: int = Field(ge=1, le=MAX_TRANSITIONS)`
- `state: SupplyChainState`
- `forecast_ref: str | None = None`
- `forecast_quantity: Decimal | None = None`
- `forecast_generated_at: str | None = None`
- `sop_plan_ref: str | None = None`
- `approved_quantity: Decimal | None = None`
- `mrp_run_ref: str | None = None`
- `opening_on_hand_quantity: Decimal | None = None`
- `confirmed_inbound_quantity: Decimal | None = None`
- `planned_production_quantity: Decimal | None = None`
- `safety_stock_quantity: Decimal | None = None`
- `required_replenishment_quantity: Decimal | None = None`
- `allocation_ref: str | None = None`
- `allocation_quantity: Decimal | None = None`
- `replenishment_ref: str | None = None`
- `replenishment_quantity: Decimal | None = None`
- `replenishment_status: Literal['planned', 'not_required'] | None = None`
- `replenishment_expected_receipt_at: str | None = None`
- `supplier_ref: str | None = None`
- `warehouse_release_ref: str | None = None`
- `release_quantity: Decimal | None = None`
- `released_at: str | None = None`
- `shipment_ref: str | None = None`
- `shipment_quantity: Decimal | None = None`
- `carrier_ref: str | None = None`
- `dispatched_at: str | None = None`
- `current_custodian_ref: str | None = None`
- `custody_events: list[SupplyChainCustodyProjection] = Field(default_factory=list, max_length=MAX_CUSTODY_EVENTS)`
- `delivery_ref: str | None = None`
- `delivered_quantity: Decimal | None = None`
- `delivered_at: str | None = None`
- `exception_ref: str | None = None`
- `exception_deadline_at: str | None = None`
- `exception_detected_at: str | None = None`
- `exception_category: str | None = None`
- `exception_severity: str | None = None`
- `resolution_ref: str | None = None`
- `resolved_at: str | None = None`
- `resolution_outcome: str | None = None`
- `in_doubt_from_state: SupplyChainState | None = None`
- `ambiguity_ref: str | None = None`
- `ambiguous_operation_ref: str | None = None`
- `ambiguity_detected_at: str | None = None`
- `ambiguity_deadline_at: str | None = None`
- `recovery_ref: str | None = None`
- `recovery_outcome: str | None = None`
- `closure_ref: str | None = None`
- `closed_at: str | None = None`
- `transition_history: list[SupplyChainTransitionRecord] = Field(min_length=1, max_length=MAX_TRANSITIONS)`
- `state_digest: str = Field(pattern='^[0-9a-f]{64}$')`

### `lightbulb.supply_chain_execution_lifecycle.supply_chain_snapshot_digest`

function. Source: `lightbulb/supply_chain_execution_lifecycle.py:1796`.



~~~python
supply_chain_snapshot_digest(snapshot: SupplyChainExecutionSnapshot) -> str
~~~


### `lightbulb.supply_chain_execution_lifecycle.SupplyChainTransitionRequest`

class. Source: `lightbulb/supply_chain_execution_lifecycle.py:2095`.

Fields:
- `schema_id: Literal['lightbulb.supply_chain_execution_request.v1'] = Field(default=SUPPLY_CHAIN_REQUEST_SCHEMA, alias='schema')`
- `scope: SupplyChainExecutionScope`
- `scope_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `lifecycle_ref: str = Field(min_length=1, max_length=160)`
- `expected_revision: int = Field(ge=0, lt=MAX_TRANSITIONS)`
- `expected_state: SupplyChainState | None = None`
- `expected_state_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `expected_snapshot: SupplyChainExecutionSnapshot | None = None`
- `transition_ref: str = Field(min_length=1, max_length=160)`
- `idempotency_key: str = Field(min_length=8, max_length=200)`
- `idempotency_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `requested_by_ref: str = Field(min_length=1, max_length=160)`
- `proposed_at: str`
- `command: SupplyChainCommand`
- `command_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `content_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `evidence_refs: list[SupplyChainExecutionEvidence] = Field(min_length=1, max_length=MAX_EVIDENCE_PER_TRANSITION)`

### `lightbulb.supply_chain_execution_lifecycle.supply_chain_transition_content_digest`

function. Source: `lightbulb/supply_chain_execution_lifecycle.py:2189`.



~~~python
supply_chain_transition_content_digest(request: SupplyChainTransitionRequest | Mapping[str, Any]) -> str
~~~


### `lightbulb.supply_chain_execution_lifecycle.supply_chain_transition_evidence_digest`

function. Source: `lightbulb/supply_chain_execution_lifecycle.py:2246`.



~~~python
supply_chain_transition_evidence_digest(request: SupplyChainTransitionRequest | Mapping[str, Any]) -> str
~~~


### `lightbulb.supply_chain_execution_lifecycle.SupplyChainTransitionProposal`

class. Source: `lightbulb/supply_chain_execution_lifecycle.py:2271`.

Fields:
- `schema_id: Literal['lightbulb.supply_chain_execution_proposal.v1'] = Field(default=SUPPLY_CHAIN_PROPOSAL_SCHEMA, alias='schema')`
- `scope: SupplyChainExecutionScope`
- `lifecycle_ref: str = Field(min_length=1, max_length=160)`
- `source_revision: int = Field(ge=0, lt=MAX_TRANSITIONS)`
- `source_state_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `target_revision: int = Field(ge=1, le=MAX_TRANSITIONS)`
- `target_state: SupplyChainState`
- `transition_ref: str = Field(min_length=1, max_length=160)`
- `command_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `content_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `idempotency_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `transition_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `candidate_state_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `required_approver_role: ApprovalRole | None = None`
- `business_approval_evidence_present: bool`
- `authoritative_state_changed: Literal[False]`
- `optimizer_executed: Literal[False]`
- `inventory_or_provider_write_executed: Literal[False]`
- `spring_submission_executed: Literal[False]`
- `proposal_digest: str = Field(pattern='^[0-9a-f]{64}$')`

### `lightbulb.supply_chain_execution_lifecycle.SupplyChainTransitionResult`

class. Source: `lightbulb/supply_chain_execution_lifecycle.py:2311`.

Fields:
- `schema_id: Literal['lightbulb.supply_chain_execution_result.v1'] = Field(default=SUPPLY_CHAIN_RESULT_SCHEMA, alias='schema')`
- `proposal: SupplyChainTransitionProposal`
- `candidate_snapshot: SupplyChainExecutionSnapshot`
- `authority_boundary: Literal['sdk_candidate_only_spring_erp_wms_tms_authoritative'] = 'sdk_candidate_only_spring_erp_wms_tms_authoritative'`
- `recovery_semantics: Literal['no_sdk_effect_manual_spring_reconciliation_for_in_doubt_provider_execution'] = 'no_sdk_effect_manual_spring_reconciliation_for_in_doubt_provider_execution'`

### `lightbulb.supply_chain_execution_lifecycle.propose_supply_chain_execution_transition`

function. Source: `lightbulb/supply_chain_execution_lifecycle.py:2377`.



~~~python
propose_supply_chain_execution_transition(request: SupplyChainTransitionRequest | Mapping[str, Any]) -> SupplyChainTransitionResult
~~~


### `lightbulb.supply_chain_execution_lifecycle.ProposeSupplyChainExecutionTransitionPrimitive`

class. Source: `lightbulb/supply_chain_execution_lifecycle.py:2718`.

Fields:
- `example_inputs: Mapping[str, Any] = _example_inputs()`

#### Methods

##### `lightbulb.supply_chain_execution_lifecycle.ProposeSupplyChainExecutionTransitionPrimitive.implementation_contract`



~~~python
def implementation_contract() -> dict[str, Any]
~~~


Source: `lightbulb/supply_chain_execution_lifecycle.py:2739`.

## Module `lightbulb.tax_provision`

Tax set-aside estimator: the reserve a startup must not forget.

### `lightbulb.tax_provision.TaxProvisionError`

class. Source: `lightbulb/tax_provision.py:81`.

The tax-provision inputs cannot produce an honest estimate.

### `lightbulb.tax_provision.ResolvedRate`

class. Source: `lightbulb/tax_provision.py:208`.

Fields:
- `rate: Decimal = Field(ge=0, le=1)`
- `source: RateSource`
- `reference_url: HttpsUrl | None = None`
- `note: LongText`

### `lightbulb.tax_provision.TaxBasisInput`

class. Source: `lightbulb/tax_provision.py:220`.

Fields:
- `tax_type: TaxType`
- `basis_amount: Decimal = Field(ge=0)`
- `rate_override: Decimal | None = Field(default=None, ge=0, le=1)`
- `basis_label: ShortText | None = None`

### `lightbulb.tax_provision.TaxObligation`

class. Source: `lightbulb/tax_provision.py:239`.

Fields:
- `tax_type: TaxType`
- `taxable_basis: Decimal = Field(ge=0)`
- `rate: ResolvedRate`
- `set_aside: Decimal = Field(ge=0)`

### `lightbulb.tax_provision.SkippedBasis`

class. Source: `lightbulb/tax_provision.py:251`.

Fields:
- `tax_type: TaxType`
- `reason: ShortText`

### `lightbulb.tax_provision.TaxProvision`

class. Source: `lightbulb/tax_provision.py:256`.

Fields:
- `schema_id: Literal['lightbulb.tax_provision.v1'] = Field(default=TAX_PROVISION_SCHEMA, alias='schema')`
- `provision_ref: PortableRef`
- `as_of: str`
- `currency: CurrencyCode`
- `jurisdiction: Jurisdiction`
- `period_label: ShortText`
- `obligations: tuple[TaxObligation, ...] = Field(default_factory=tuple)`
- `skipped: tuple[SkippedBasis, ...] = Field(default_factory=tuple)`
- `total_set_aside: Decimal = Field(ge=0)`
- `uses_indicative_defaults: bool`
- `complete: bool`
- `disclaimer: LongText = _DISCLAIMER`
- `notes: tuple[ShortText, ...] = Field(default_factory=tuple, max_length=10)`
- `provision_digest: str = '0' * 64`

#### Methods

##### `lightbulb.tax_provision.TaxProvision.to_dict`



~~~python
def to_dict() -> dict[str, Any]
~~~


Source: `lightbulb/tax_provision.py:290`.

### `lightbulb.tax_provision.EstimateTaxSetAsideInput`

class. Source: `lightbulb/tax_provision.py:294`.

Fields:
- `provision_ref: PortableRef`
- `as_of: str`
- `currency: CurrencyCode`
- `jurisdiction: Jurisdiction`
- `period_label: ShortText`
- `bases: tuple[TaxBasisInput, ...] = Field(min_length=1, max_length=20)`

### `lightbulb.tax_provision.estimate_tax_set_aside`

function. Source: `lightbulb/tax_provision.py:332`.



~~~python
estimate_tax_set_aside(inputs: EstimateTaxSetAsideInput | Mapping[str, Any]) -> TaxProvision
~~~


Estimate the cash to reserve for tax across the supplied bases.

### `lightbulb.tax_provision.tax_rate_reference`

function. Source: `lightbulb/tax_provision.py:421`.



~~~python
tax_rate_reference() -> tuple[dict[str, Any], ...]
~~~


Discoverable list of indicative default rates and their sources.

### `lightbulb.tax_provision.EstimateTaxSetAsidePrimitive`

class. Source: `lightbulb/tax_provision.py:458`.

Estimate the cash to reserve for tax across the period's bases.

## Module `lightbulb.vendor_onboarding_lifecycle`

Bounded, evidence-bound vendor onboarding transition proposals.

### `lightbulb.vendor_onboarding_lifecycle.VendorOnboardingLifecycleError`

class. Source: `lightbulb/vendor_onboarding_lifecycle.py:91`.

Stable fail-closed error for an unparseable lifecycle request.

### `lightbulb.vendor_onboarding_lifecycle.VendorOnboardingScope`

class. Source: `lightbulb/vendor_onboarding_lifecycle.py:230`.

Fields:
- `schema_id: Literal['lightbulb.vendor_onboarding_scope.v1'] = Field(default=VENDOR_ONBOARDING_SCOPE_SCHEMA, alias='schema')`
- `tenant_ref: str = Field(min_length=1, max_length=160)`
- `company_ref: str = Field(min_length=1, max_length=160)`
- `project_ref: str = Field(min_length=1, max_length=160)`
- `project_id: UUID`
- `procurement_org_ref: str = Field(min_length=1, max_length=160)`
- `vendor_ref: str = Field(min_length=1, max_length=160)`
- `category_ref: str = Field(min_length=1, max_length=160)`
- `site_ref: str = Field(min_length=1, max_length=160)`
- `jurisdiction_ref: str = Field(min_length=2, max_length=80)`
- `retention_policy_ref: str = Field(min_length=1, max_length=160)`
- `evidence_custodian_ref: str = Field(min_length=1, max_length=200)`
- `spring_authority_ref: str = Field(min_length=1, max_length=200)`

### `lightbulb.vendor_onboarding_lifecycle.vendor_onboarding_scope_digest`

function. Source: `lightbulb/vendor_onboarding_lifecycle.py:280`.



~~~python
vendor_onboarding_scope_digest(scope: VendorOnboardingScope | Mapping[str, Any]) -> str
~~~


### `lightbulb.vendor_onboarding_lifecycle.VendorOnboardingEvidence`

class. Source: `lightbulb/vendor_onboarding_lifecycle.py:287`.

Fields:
- `schema_id: Literal['lightbulb.vendor_onboarding_evidence.v1'] = Field(default=VENDOR_ONBOARDING_EVIDENCE_SCHEMA, alias='schema')`
- `sequence: int = Field(ge=1, le=MAX_VENDOR_ONBOARDING_TRANSITIONS * EVIDENCE_PER_VENDOR_TRANSITION)`
- `evidence_ref: str = Field(min_length=1, max_length=200)`
- `kind: str = Field(min_length=1, max_length=100)`
- `issuer_ref: str = Field(min_length=1, max_length=200)`
- `custodian_ref: str = Field(min_length=1, max_length=200)`
- `subject_ref: str = Field(min_length=1, max_length=200)`
- `sha256: str = Field(pattern='^[0-9a-f]{64}$')`
- `observed_at: str`
- `effective_at: str`
- `verification_grade: PrimitiveEvidenceVerificationGrade`
- `classification: PrimitiveEvidenceClassification`
- `retention_policy: str = Field(min_length=1, max_length=160)`
- `jurisdiction: str = Field(min_length=2, max_length=80)`
- `retained_until: str`
- `single_use: Literal[True] = True`
- `causal_revision: int = Field(ge=0, le=MAX_VENDOR_ONBOARDING_TRANSITIONS)`
- `causal_state_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `predecessor_lineage_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `lineage_digest: str = Field(pattern='^[0-9a-f]{64}$')`

#### Methods

##### `lightbulb.vendor_onboarding_lifecycle.VendorOnboardingEvidence.portable_ref`



~~~python
def portable_ref() -> PrimitiveEvidenceRef
~~~


Source: `lightbulb/vendor_onboarding_lifecycle.py:366`.

### `lightbulb.vendor_onboarding_lifecycle.vendor_onboarding_evidence_lineage_digest`

function. Source: `lightbulb/vendor_onboarding_lifecycle.py:382`.



~~~python
vendor_onboarding_evidence_lineage_digest(evidence: VendorOnboardingEvidence | Mapping[str, Any]) -> str
~~~


### `lightbulb.vendor_onboarding_lifecycle.QualificationCondition`

class. Source: `lightbulb/vendor_onboarding_lifecycle.py:393`.

Fields:
- `condition_ref: str = Field(min_length=1, max_length=160)`
- `control_ref: str = Field(min_length=1, max_length=160)`
- `owner_role_ref: str = Field(min_length=1, max_length=160)`
- `severity: Literal['advisory', 'material', 'critical']`
- `due_at: str`

### `lightbulb.vendor_onboarding_lifecycle.CaptureVendorIdentityCommand`

class. Source: `lightbulb/vendor_onboarding_lifecycle.py:422`.

Fields:
- `kind: Literal['capture_vendor_identity'] = 'capture_vendor_identity'`
- `requester_ref: str = Field(min_length=1, max_length=160)`
- `vendor_ref: str = Field(min_length=1, max_length=160)`
- `legal_entity_ref: str = Field(min_length=1, max_length=160)`
- `legal_name_commitment: str = Field(pattern='^[0-9a-f]{64}$')`
- `registration_artifact_ref: str = Field(min_length=10, max_length=200)`
- `registration_artifact_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `tax_identity_artifact_ref: str = Field(min_length=10, max_length=200)`
- `tax_identity_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `beneficial_owner_artifact_ref: str = Field(min_length=10, max_length=200)`
- `beneficial_owner_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `registered_site_ref: str = Field(min_length=1, max_length=160)`
- `captured_at: str`

### `lightbulb.vendor_onboarding_lifecycle.ClearVendorDueDiligenceCommand`

class. Source: `lightbulb/vendor_onboarding_lifecycle.py:480`.

Fields:
- `kind: Literal['clear_vendor_due_diligence'] = 'clear_vendor_due_diligence'`
- `due_diligence_assessor_ref: str = Field(min_length=1, max_length=160)`
- `identity_command_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `beneficial_owner_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `sanctions_screening_ref: str = Field(min_length=1, max_length=200)`
- `sanctions_screening_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `sanctions_status: Literal['clear']`
- `kyc_aml_screening_ref: str = Field(min_length=1, max_length=200)`
- `kyc_aml_screening_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `kyc_aml_status: Literal['cleared']`
- `conflict_screening_ref: str = Field(min_length=1, max_length=200)`
- `conflict_screening_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `conflict_status: Literal['clear']`
- `screened_at: str`
- `valid_until: str`

### `lightbulb.vendor_onboarding_lifecycle.AssessVendorQualificationCommand`

class. Source: `lightbulb/vendor_onboarding_lifecycle.py:537`.

Fields:
- `kind: Literal['assess_vendor_qualification'] = 'assess_vendor_qualification'`
- `assessor_ref: str = Field(min_length=1, max_length=160)`
- `due_diligence_command_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `capability_evidence_ref: str = Field(min_length=1, max_length=200)`
- `capability_evidence_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `capability_score: int = Field(ge=0, le=100)`
- `quality_evidence_ref: str = Field(min_length=1, max_length=200)`
- `quality_evidence_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `quality_score: int = Field(ge=0, le=100)`
- `financial_evidence_ref: str = Field(min_length=1, max_length=200)`
- `financial_evidence_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `financial_score: int = Field(ge=0, le=100)`
- `cyber_evidence_ref: str = Field(min_length=1, max_length=200)`
- `cyber_evidence_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `cyber_score: int = Field(ge=0, le=100)`
- `ehs_evidence_ref: str = Field(min_length=1, max_length=200)`
- `ehs_evidence_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `ehs_score: int = Field(ge=0, le=100)`
- `insurance_artifact_ref: str = Field(min_length=10, max_length=200)`
- `insurance_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `insurance_valid_until: str`
- `certification_artifact_ref: str = Field(min_length=10, max_length=200)`
- `certification_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `certifications_valid_until: str`
- `assessed_at: str`

### `lightbulb.vendor_onboarding_lifecycle.ProposeVendorApprovalCommand`

class. Source: `lightbulb/vendor_onboarding_lifecycle.py:625`.

Fields:
- `kind: Literal['propose_vendor_approval'] = 'propose_vendor_approval'`
- `approver_ref: str = Field(min_length=1, max_length=160)`
- `assessment_command_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `decision: Literal['approved_with_controls'] = 'approved_with_controls'`
- `risk_tier: RiskTier`
- `conditions: tuple[QualificationCondition, ...] = Field(default_factory=tuple, max_length=20)`
- `monitoring_interval_days: int = Field(ge=1, le=365)`
- `approved_at: str`
- `approval_valid_until: str`
- `renewal_due_at: str`

### `lightbulb.vendor_onboarding_lifecycle.VerifyVendorBankControlCommand`

class. Source: `lightbulb/vendor_onboarding_lifecycle.py:696`.

Fields:
- `kind: Literal['verify_vendor_bank_control'] = 'verify_vendor_bank_control'`
- `approval_command_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `bank_submitter_ref: str = Field(min_length=1, max_length=160)`
- `bank_verifier_ref: str = Field(min_length=1, max_length=160)`
- `bank_account_artifact_ref: str = Field(min_length=10, max_length=200)`
- `bank_account_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `bank_change_kind: Literal['initial', 'change']`
- `prior_bank_account_digest: str | None = Field(default=None, pattern='^[0-9a-f]{64}$')`
- `bank_change_request_ref: str | None = Field(default=None, min_length=1, max_length=200)`
- `bank_change_request_digest: str | None = Field(default=None, pattern='^[0-9a-f]{64}$')`
- `verification_evidence_ref: str = Field(min_length=1, max_length=200)`
- `verification_evidence_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `verification_method: Literal['independent_callback', 'microdeposit', 'verified_bank_letter']`
- `submitted_at: str`
- `verified_at: str`

### `lightbulb.vendor_onboarding_lifecycle.RecordVendorSetupReadinessCommand`

class. Source: `lightbulb/vendor_onboarding_lifecycle.py:791`.

Fields:
- `kind: Literal['record_vendor_setup_readiness'] = 'record_vendor_setup_readiness'`
- `setup_specialist_ref: str = Field(min_length=1, max_length=160)`
- `bank_control_command_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `bank_account_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `purchasing_vendor_ref: str = Field(min_length=1, max_length=200)`
- `payment_vendor_ref: str = Field(min_length=1, max_length=200)`
- `category_assignment_ref: str = Field(min_length=1, max_length=200)`
- `category_ref: str = Field(min_length=1, max_length=160)`
- `site_assignment_ref: str = Field(min_length=1, max_length=200)`
- `site_ref: str = Field(min_length=1, max_length=160)`
- `payment_terms_ref: str = Field(min_length=1, max_length=160)`
- `purchasing_ready: Literal[True] = True`
- `payment_ready: Literal[True] = True`
- `category_ready: Literal[True] = True`
- `site_ready: Literal[True] = True`
- `setup_at: str`

### `lightbulb.vendor_onboarding_lifecycle.ProposeVendorActivationCommand`

class. Source: `lightbulb/vendor_onboarding_lifecycle.py:842`.

Fields:
- `kind: Literal['propose_vendor_activation'] = 'propose_vendor_activation'`
- `activator_ref: str = Field(min_length=1, max_length=160)`
- `setup_command_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `approval_command_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `bank_control_command_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `bank_account_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `monitoring_plan_ref: str = Field(min_length=1, max_length=200)`
- `monitoring_plan_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `suspension_policy_ref: str = Field(min_length=1, max_length=200)`
- `suspension_policy_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `sanctions_rescreen_due_at: str`
- `renewal_due_at: str`
- `activation_candidate_at: str`
- `automatic_activation: Literal[False] = False`

### `lightbulb.vendor_onboarding_lifecycle.vendor_onboarding_command_digest`

function. Source: `lightbulb/vendor_onboarding_lifecycle.py:906`.



~~~python
vendor_onboarding_command_digest(command: VendorOnboardingCommand | Mapping[str, Any]) -> str
~~~


### `lightbulb.vendor_onboarding_lifecycle.vendor_onboarding_idempotency_digest`

function. Source: `lightbulb/vendor_onboarding_lifecycle.py:984`.



~~~python
vendor_onboarding_idempotency_digest(scope: VendorOnboardingScope | Mapping[str, Any], lifecycle_ref: str, idempotency_key: str) -> str
~~~


### `lightbulb.vendor_onboarding_lifecycle.vendor_onboarding_fact_evidence_digest`

function. Source: `lightbulb/vendor_onboarding_lifecycle.py:1028`.



~~~python
vendor_onboarding_fact_evidence_digest(scope: VendorOnboardingScope | Mapping[str, Any], lifecycle_ref: str, transition_ref: str, command: VendorOnboardingCommand | Mapping[str, Any]) -> str
~~~


### `lightbulb.vendor_onboarding_lifecycle.vendor_onboarding_transition_commitment_digest`

function. Source: `lightbulb/vendor_onboarding_lifecycle.py:1044`.



~~~python
vendor_onboarding_transition_commitment_digest(*, content_digest: str, fact_evidence_digest: str) -> str
~~~


### `lightbulb.vendor_onboarding_lifecycle.VendorOnboardingTransitionRecord`

class. Source: `lightbulb/vendor_onboarding_lifecycle.py:1055`.

Fields:
- `schema_id: Literal['lightbulb.vendor_onboarding_transition.v1'] = Field(default=VENDOR_ONBOARDING_TRANSITION_SCHEMA, alias='schema')`
- `revision: int = Field(ge=1, le=MAX_VENDOR_ONBOARDING_TRANSITIONS)`
- `scope_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `lifecycle_ref: str = Field(min_length=1, max_length=160)`
- `prior_state: VendorOnboardingState | None = None`
- `prior_state_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `prior_evidence_lineage_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `state: VendorOnboardingState`
- `transition_ref: str = Field(min_length=1, max_length=160)`
- `idempotency_key: str = Field(min_length=8, max_length=200)`
- `idempotency_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `requested_by_ref: str = Field(min_length=1, max_length=160)`
- `proposed_at: str`
- `command: VendorOnboardingCommand`
- `command_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `content_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `evidence: tuple[VendorOnboardingEvidence, ...] = Field(min_length=EVIDENCE_PER_VENDOR_TRANSITION, max_length=EVIDENCE_PER_VENDOR_TRANSITION)`
- `evidence_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `evidence_lineage_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `authoritative_scope_verified: Literal[False] = False`
- `rbac_authorized: Literal[False] = False`
- `authoritative_evidence_verified: Literal[False] = False`
- `authoritative_approval_recorded: Literal[False] = False`
- `vendor_master_persisted: Literal[False] = False`
- `payment_setup_persisted: Literal[False] = False`
- `live_effect_executed: Literal[False] = False`
- `transition_digest: str = Field(pattern='^[0-9a-f]{64}$')`

### `lightbulb.vendor_onboarding_lifecycle.vendor_onboarding_snapshot_digest`

function. Source: `lightbulb/vendor_onboarding_lifecycle.py:1183`.



~~~python
vendor_onboarding_snapshot_digest(snapshot: 'VendorOnboardingSnapshot' | Mapping[str, Any]) -> str
~~~


### `lightbulb.vendor_onboarding_lifecycle.VendorOnboardingSnapshot`

class. Source: `lightbulb/vendor_onboarding_lifecycle.py:1194`.

Fields:
- `schema_id: Literal['lightbulb.vendor_onboarding_snapshot.v1'] = Field(default=VENDOR_ONBOARDING_SNAPSHOT_SCHEMA, alias='schema')`
- `scope: VendorOnboardingScope`
- `scope_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `lifecycle_ref: str = Field(min_length=1, max_length=160)`
- `revision: int = Field(ge=1, le=MAX_VENDOR_ONBOARDING_TRANSITIONS)`
- `state: VendorOnboardingState`
- `history: tuple[VendorOnboardingTransitionRecord, ...] = Field(min_length=1, max_length=MAX_VENDOR_ONBOARDING_TRANSITIONS)`
- `evidence_lineage_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `state_digest: str = Field(pattern='^[0-9a-f]{64}$')`

### `lightbulb.vendor_onboarding_lifecycle.VendorOnboardingTransitionRequest`

class. Source: `lightbulb/vendor_onboarding_lifecycle.py:1279`.

Fields:
- `schema_id: Literal['lightbulb.vendor_onboarding_request.v1'] = Field(default=VENDOR_ONBOARDING_REQUEST_SCHEMA, alias='schema')`
- `scope: VendorOnboardingScope`
- `scope_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `lifecycle_ref: str = Field(min_length=1, max_length=160)`
- `expected_revision: int = Field(ge=0, le=MAX_VENDOR_ONBOARDING_TRANSITIONS)`
- `expected_state: VendorOnboardingState | None = None`
- `expected_state_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `expected_evidence_lineage_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `expected_snapshot: VendorOnboardingSnapshot | None = None`
- `transition_ref: str = Field(min_length=1, max_length=160)`
- `idempotency_key: str = Field(min_length=8, max_length=200)`
- `idempotency_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `requested_by_ref: str = Field(min_length=1, max_length=160)`
- `proposed_at: str`
- `command: VendorOnboardingCommand`
- `command_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `content_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `evidence: tuple[VendorOnboardingEvidence, ...] = Field(min_length=EVIDENCE_PER_VENDOR_TRANSITION, max_length=EVIDENCE_PER_VENDOR_TRANSITION)`

### `lightbulb.vendor_onboarding_lifecycle.vendor_onboarding_transition_content_digest`

function. Source: `lightbulb/vendor_onboarding_lifecycle.py:1392`.



~~~python
vendor_onboarding_transition_content_digest(request: VendorOnboardingTransitionRequest | Mapping[str, Any]) -> str
~~~


### `lightbulb.vendor_onboarding_lifecycle.VendorOnboardingEffectBoundary`

class. Source: `lightbulb/vendor_onboarding_lifecycle.py:1437`.

Fields:
- `authoritative_scope_verified: Literal[False] = False`
- `rbac_authorized: Literal[False] = False`
- `authoritative_evidence_verified: Literal[False] = False`
- `authoritative_approval_recorded: Literal[False] = False`
- `private_artifacts_read: Literal[False] = False`
- `vendor_master_created_or_changed: Literal[False] = False`
- `payment_data_created_or_changed: Literal[False] = False`
- `purchase_or_payment_authorized: Literal[False] = False`
- `supplier_activated: Literal[False] = False`
- `supplier_suspended: Literal[False] = False`
- `persistence_executed: Literal[False] = False`
- `provider_write_executed: Literal[False] = False`
- `spring_submission_executed: Literal[False] = False`

### `lightbulb.vendor_onboarding_lifecycle.VendorOnboardingTransitionProposal`

class. Source: `lightbulb/vendor_onboarding_lifecycle.py:1453`.

Fields:
- `schema_id: Literal['lightbulb.vendor_onboarding_proposal.v1'] = Field(default=VENDOR_ONBOARDING_PROPOSAL_SCHEMA, alias='schema')`
- `scope: VendorOnboardingScope`
- `scope_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `lifecycle_ref: str = Field(min_length=1, max_length=160)`
- `source_revision: int = Field(ge=0, lt=MAX_VENDOR_ONBOARDING_TRANSITIONS)`
- `source_state: VendorOnboardingState | None = None`
- `source_state_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `source_evidence_lineage_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `target_revision: int = Field(ge=1, le=MAX_VENDOR_ONBOARDING_TRANSITIONS)`
- `target_state: VendorOnboardingState`
- `transition_ref: str = Field(min_length=1, max_length=160)`
- `command_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `content_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `idempotency_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `evidence_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `transition_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `candidate_state_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `candidate_evidence_lineage_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `effect_boundary: VendorOnboardingEffectBoundary`
- `proposal_digest: str = Field(pattern='^[0-9a-f]{64}$')`

### `lightbulb.vendor_onboarding_lifecycle.VendorOnboardingRecovery`

class. Source: `lightbulb/vendor_onboarding_lifecycle.py:2250`.

Fields:
- `disposition: RecoveryDisposition`
- `automatic_retry_allowed: Literal[False] = False`
- `instructions: str | None = Field(default=None, min_length=1, max_length=600)`

### `lightbulb.vendor_onboarding_lifecycle.VendorOnboardingTransitionReceipt`

class. Source: `lightbulb/vendor_onboarding_lifecycle.py:2266`.

Fields:
- `schema_id: Literal['lightbulb.vendor_onboarding_receipt.v1'] = Field(default=VENDOR_ONBOARDING_RECEIPT_SCHEMA, alias='schema')`
- `transition_ref: str = Field(min_length=1, max_length=160)`
- `idempotency_key: str = Field(min_length=8, max_length=200)`
- `request_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `command_kind: str = Field(min_length=1, max_length=100)`
- `command_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `evidence_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `status: Literal['candidate_materialized', 'rejected', 'in_doubt']`
- `from_revision: int = Field(ge=0, le=MAX_VENDOR_ONBOARDING_TRANSITIONS)`
- `to_revision: int = Field(ge=0, le=MAX_VENDOR_ONBOARDING_TRANSITIONS)`
- `from_state: VendorOnboardingState | None = None`
- `to_state: VendorOnboardingState | None = None`
- `from_state_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `to_state_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `from_evidence_lineage_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `to_evidence_lineage_digest: str = Field(pattern='^[0-9a-f]{64}$')`
- `transition_digest: str | None = Field(default=None, pattern='^[0-9a-f]{64}$')`
- `proposal_digest: str | None = Field(default=None, pattern='^[0-9a-f]{64}$')`
- `rejection_code: str | None = Field(default=None, min_length=1, max_length=120)`
- `recovery: VendorOnboardingRecovery`
- `authoritative_scope_verified: Literal[False] = False`
- `authoritative_approval_recorded: Literal[False] = False`
- `live_systems_changed: Literal[False] = False`
- `supplier_activated: Literal[False] = False`
- `receipt_digest: str = Field(pattern='^[0-9a-f]{64}$')`

### `lightbulb.vendor_onboarding_lifecycle.VendorOnboardingTransitionResult`

class. Source: `lightbulb/vendor_onboarding_lifecycle.py:2371`.

Fields:
- `schema_id: Literal['lightbulb.vendor_onboarding_result.v1'] = Field(default=VENDOR_ONBOARDING_RESULT_SCHEMA, alias='schema')`
- `candidate_validated: bool`
- `evaluated_request: VendorOnboardingTransitionRequest`
- `snapshot: VendorOnboardingSnapshot | None = None`
- `proposal: VendorOnboardingTransitionProposal | None = None`
- `transition_receipt: VendorOnboardingTransitionReceipt`
- `authority_boundary: Literal['sdk_candidate_only_spring_and_governed_systems_authoritative'] = 'sdk_candidate_only_spring_and_governed_systems_authoritative'`
- `result_digest: str = Field(pattern='^[0-9a-f]{64}$')`

### `lightbulb.vendor_onboarding_lifecycle.propose_vendor_onboarding_transition`

function. Source: `lightbulb/vendor_onboarding_lifecycle.py:2554`.



~~~python
propose_vendor_onboarding_transition(request: VendorOnboardingTransitionRequest | Mapping[str, Any]) -> VendorOnboardingTransitionResult
~~~


Validate one exact transition and return a sealed SDK-only outcome.

### `lightbulb.vendor_onboarding_lifecycle.ProposeVendorOnboardingTransitionPrimitive`

class. Source: `lightbulb/vendor_onboarding_lifecycle.py:2777`.

Fields:
- `example_inputs: Mapping[str, Any] = _example_inputs()`

#### Methods

##### `lightbulb.vendor_onboarding_lifecycle.ProposeVendorOnboardingTransitionPrimitive.implementation_contract`



~~~python
def implementation_contract() -> dict[str, Any]
~~~


Source: `lightbulb/vendor_onboarding_lifecycle.py:2802`.

## Module `lightbulb.workflow_improvement`

Continuous, proposal-only improvement loop for Lightbulb workflows.

### `lightbulb.workflow_improvement.ImprovementLoopAlreadyRunning`

class. Source: `lightbulb/workflow_improvement.py:148`.

Raised when another continuous improvement supervisor owns the output dir.

### `lightbulb.workflow_improvement.WorkflowImprovementBudgetExceeded`

class. Source: `lightbulb/workflow_improvement.py:152`.

Raised before an improvement cycle can exceed a hard local resource cap.

### `lightbulb.workflow_improvement.WorkflowImprovementStateError`

class. Source: `lightbulb/workflow_improvement.py:156`.

Raised when persisted supervisor state is unreadable or structurally unsafe.

### `lightbulb.workflow_improvement.WorkflowImprovementSupervisorBudget`

class. Source: `lightbulb/workflow_improvement.py:161`.

Finite resource authority for one local proposal-only supervisor run.

Fields:
- `max_iterations: int = DEFAULT_SUPERVISOR_MAX_ITERATIONS`
- `max_elapsed_seconds: int = DEFAULT_SUPERVISOR_MAX_ELAPSED_SECONDS`
- `max_no_progress_runs: int = DEFAULT_SUPERVISOR_MAX_NO_PROGRESS_RUNS`
- `max_observed_outcomes: int = DEFAULT_MAX_OBSERVED_OUTCOMES`
- `max_history_entries: int = DEFAULT_MAX_HISTORY_ENTRIES`
- `max_history_bytes: int = DEFAULT_MAX_HISTORY_BYTES`
- `max_queue_packets: int = DEFAULT_MAX_QUEUE_PACKETS`
- `max_managed_json_bytes: int = DEFAULT_MAX_MANAGED_JSON_BYTES`

#### Methods

##### `lightbulb.workflow_improvement.WorkflowImprovementSupervisorBudget.to_dict`



~~~python
def to_dict() -> dict[str, Any]
~~~


Source: `lightbulb/workflow_improvement.py:241`.

### `lightbulb.workflow_improvement.default_workflow_improvement_dir`

function. Source: `lightbulb/workflow_improvement.py:255`.



~~~python
default_workflow_improvement_dir() -> Path
~~~


### `lightbulb.workflow_improvement.synthetic_inputs_for_primitive`

function. Source: `lightbulb/workflow_improvement.py:574`.



~~~python
synthetic_inputs_for_primitive(primitive: BusinessPrimitive) -> dict[str, Any]
~~~


Generate non-sensitive inputs sufficient for contract simulation.

### `lightbulb.workflow_improvement.evaluate_workflow_improvement`

function. Source: `lightbulb/workflow_improvement.py:1225`.



~~~python
evaluate_workflow_improvement(*, observed_outcomes: Iterable[Any] | None=None, previous_report: dict[str, Any] | None=None, now: datetime | None=None, budget: WorkflowImprovementSupervisorBudget | None=None) -> dict[str, Any]
~~~


Evaluate contracts and propose approval-gated SDK work packets.

### `lightbulb.workflow_improvement.run_workflow_improvement_cycle`

function. Source: `lightbulb/workflow_improvement.py:1794`.



~~~python
run_workflow_improvement_cycle(output_dir: str | Path | None=None, *, observed_outcomes: Iterable[Any] | None=None, now: datetime | None=None, budget: WorkflowImprovementSupervisorBudget | None=None, _lock: bool=True) -> dict[str, Any]
~~~


Run one local evaluation cycle and persist its proposal-only artifacts.

### `lightbulb.workflow_improvement.run_continuous_workflow_improvement`

function. Source: `lightbulb/workflow_improvement.py:1826`.



~~~python
run_continuous_workflow_improvement(output_dir: str | Path | None=None, *, interval_seconds: float=900, max_iterations: int | None=None, max_elapsed_seconds: int | None=None, max_no_progress_runs: int | None=None, budget: WorkflowImprovementSupervisorBudget | None=None, observed_outcomes_provider: Callable[[], Iterable[Any] | None] | None=None, stop_file: str | Path | None=None, on_cycle: Callable[[dict[str, Any]], None] | None=None, retain_reports: bool=True, sleep_fn: Callable[[float], None]=time.sleep, now_fn: Callable[[], datetime]=lambda: datetime.now(timezone.utc), monotonic_fn: Callable[[], float]=time.monotonic) -> List[dict[str, Any]]
~~~


Run a finite, proposal-only supervisor and persist why it stopped.

### `lightbulb.workflow_improvement.list_workflow_improvement_packets`

function. Source: `lightbulb/workflow_improvement.py:2034`.



~~~python
list_workflow_improvement_packets(output_dir: str | Path | None=None, *, status: str | None=None) -> List[dict[str, Any]]
~~~


### `lightbulb.workflow_improvement.load_workflow_improvement_status`

function. Source: `lightbulb/workflow_improvement.py:2077`.



~~~python
load_workflow_improvement_status(output_dir: str | Path | None=None) -> dict[str, Any]
~~~


## Module `lightbulb.workflow_learning`

Fail-closed handoff from workflow delivery to paired-learning readiness.

### `lightbulb.workflow_learning.WorkflowLearningHandoffError`

class. Source: `lightbulb/workflow_learning.py:96`.

Raised when candidate evidence cannot safely cross the learning boundary.

### `lightbulb.workflow_learning.workflow_learning_candidate_manifest_sha256`

function. Source: `lightbulb/workflow_learning.py:126`.



~~~python
workflow_learning_candidate_manifest_sha256(value: Mapping[str, Any]) -> str
~~~


Validate and hash the exact candidate manifest used by Harness evidence.

### `lightbulb.workflow_learning.workflow_learning_candidate_attestation_scope_sha256`

function. Source: `lightbulb/workflow_learning.py:132`.



~~~python
workflow_learning_candidate_attestation_scope_sha256(*, packet_id: str, delivery_id: str, candidate_manifest: Mapping[str, Any]) -> str
~~~


Hash the exact delivery/candidate scope signed by the artifact producer.

### `lightbulb.workflow_learning.build_attested_workflow_learning_episode_manifest`

function. Source: `lightbulb/workflow_learning.py:477`.



~~~python
build_attested_workflow_learning_episode_manifest(input_custody: Mapping[str, Any], *, installation_id: str, revision_id: str, project_id: str | None=None) -> dict[str, Any]
~~~


Derive the only v2 episode manifest accepted from verified custody.

### `lightbulb.workflow_learning.compile_workflow_learning_handoff`

function. Source: `lightbulb/workflow_learning.py:812`.



~~~python
compile_workflow_learning_handoff(*, packet: Mapping[str, Any], delivery: Mapping[str, Any], audit_events: Iterable[Mapping[str, Any]], candidate_manifest: Mapping[str, Any], episode_manifest: Mapping[str, Any] | None, training_readiness: Mapping[str, Any], installation_id: str, revision_id: str, project_id: str | None=None, training_input_custody: Mapping[str, Any] | None=None, candidate_artifact_attestation: Mapping[str, Any] | None=None, now: datetime | None=None) -> dict[str, Any]
~~~


Compile a privacy-minimized candidate handoff with no training authority.

## Module `lightbulb.xero`

Typed client for the Xero deep-integration agent.

### `lightbulb.xero.XeroPlaybook`

class. Source: `lightbulb/xero.py:38`.

Well-known Xero playbook IDs.

#### Methods

##### `lightbulb.xero.XeroPlaybook.all`



~~~python
def all() -> List[str]
~~~


Source: `lightbulb/xero.py:50`.

### `lightbulb.xero.XeroAgentClient`

class. Source: `lightbulb/xero.py:63`.

Thin wrapper over LightbulbClient that targets ``/api/finance/xero``.

Fields:
- `inner: LightbulbClient`

#### Methods

##### `lightbulb.xero.XeroAgentClient.approve_proposal`



~~~python
def approve_proposal(proposal_id: str, body: Optional[Dict[str, Any]]=None) -> Dict[str, Any]
~~~


Approve a proposal so it can execute against Xero.

Source: `lightbulb/xero.py:103`.

##### `lightbulb.xero.XeroAgentClient.create_proposal`



~~~python
def create_proposal(body: Dict[str, Any]) -> Dict[str, Any]
~~~


Create a proposal (queues an HITL approval).

Source: `lightbulb/xero.py:92`.

##### `lightbulb.xero.XeroAgentClient.org_profile`



~~~python
def org_profile(xero_tenant_id: str) -> Dict[str, Any]
~~~


Get the Xero org profile (chart of accounts, tax rates, branding).

Source: `lightbulb/xero.py:149`.

##### `lightbulb.xero.XeroAgentClient.proposals`



~~~python
def proposals(body: Optional[Dict[str, Any]]=None) -> Dict[str, Any]
~~~


Generate proposals (reconciliation, AP, payroll, etc.) for the org.

Source: `lightbulb/xero.py:81`.

##### `lightbulb.xero.XeroAgentClient.propose_bill`



~~~python
def propose_bill(body: Dict[str, Any]) -> Dict[str, Any]
~~~


Propose an AP bill entry into Xero (HITL-gated).

Source: `lightbulb/xero.py:165`.

##### `lightbulb.xero.XeroAgentClient.propose_invoice`



~~~python
def propose_invoice(body: Dict[str, Any]) -> Dict[str, Any]
~~~


Propose an AR invoice entry into Xero (HITL-gated).

Source: `lightbulb/xero.py:161`.

##### `lightbulb.xero.XeroAgentClient.propose_journal`



~~~python
def propose_journal(body: Dict[str, Any]) -> Dict[str, Any]
~~~


Propose a manual journal entry into Xero (HITL-gated).

Source: `lightbulb/xero.py:169`.

##### `lightbulb.xero.XeroAgentClient.propose_payroll_trueup`



~~~python
def propose_payroll_trueup(body: Dict[str, Any]) -> Dict[str, Any]
~~~


Propose a payroll true-up adjustment into Xero (HITL-gated).

Source: `lightbulb/xero.py:173`.

##### `lightbulb.xero.XeroAgentClient.reject_proposal`



~~~python
def reject_proposal(proposal_id: str, *, reason: str='') -> Dict[str, Any]
~~~


Reject a Xero proposal.

Source: `lightbulb/xero.py:114`.

##### `lightbulb.xero.XeroAgentClient.run_playbook`



~~~python
def run_playbook(playbook_id: str, body: Optional[Dict[str, Any]]=None) -> Dict[str, Any]
~~~


Run a Xero playbook (e.g. month_end_close, ar_followup).

Source: `lightbulb/xero.py:138`.

##### `lightbulb.xero.XeroAgentClient.run_sync`



~~~python
def run_sync(body: Optional[Dict[str, Any]]=None) -> Dict[str, Any]
~~~


Trigger a Xero data sync (org rosters, AR/AP, payroll, ledger).

Source: `lightbulb/xero.py:127`.

##### `lightbulb.xero.XeroAgentClient.snapshot`



~~~python
def snapshot(body: Optional[Dict[str, Any]]=None) -> Dict[str, Any]
~~~


Fetch a multi-org Xero financial snapshot (cash, AR, AP, payroll, taxes).

Source: `lightbulb/xero.py:70`.

## Declared public exports

## Export declaration `lightbulb.__all__`

Source: `lightbulb/__init__.py`. Declared exports: 2537.

### `lightbulb.LightbulbClient`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import LightbulbClient
~~~


Binding: `lightbulb.client.LightbulbClient` → `lightbulb.client.LightbulbClient`.

Source: `lightbulb/client.py:2563`.

### `lightbulb.AsyncLightbulbClient`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import AsyncLightbulbClient
~~~


Binding: `lightbulb.async_client.AsyncLightbulbClient` → `lightbulb.async_client.AsyncLightbulbClient`.

Source: `lightbulb/async_client.py:181`.

### `lightbulb.BackpressurePolicy`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import BackpressurePolicy
~~~


Binding: `lightbulb.async_runtime.BackpressurePolicy` → `lightbulb.async_runtime.BackpressurePolicy`.

Source: `lightbulb/async_runtime.py:254`.

### `lightbulb.BackpressureStrategy`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import BackpressureStrategy
~~~


Binding: `lightbulb.async_runtime.BackpressureStrategy` → `lightbulb.async_runtime.BackpressureStrategy`.

Source: `lightbulb/async_runtime.py:203`.

### `lightbulb.BatchExecutionError`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import BatchExecutionError
~~~


Binding: `lightbulb.async_runtime.BatchExecutionError` → `lightbulb.async_runtime.BatchExecutionError`.

Source: `lightbulb/async_runtime.py:81`.

### `lightbulb.BatchItemResult`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import BatchItemResult
~~~


Binding: `lightbulb.async_runtime.BatchItemResult` → `lightbulb.async_runtime.BatchItemResult`.

Source: `lightbulb/async_runtime.py:92`.

### `lightbulb.PartitionedAsyncStream`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PartitionedAsyncStream
~~~


Binding: `lightbulb.async_runtime.PartitionedAsyncStream` → `lightbulb.async_runtime.PartitionedAsyncStream`.

Source: `lightbulb/async_runtime.py:290`.

### `lightbulb.PartitionedStreamContract`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PartitionedStreamContract
~~~


Binding: `lightbulb.async_runtime.PartitionedStreamContract` → `lightbulb.async_runtime.PartitionedStreamContract`.

Source: `lightbulb/async_runtime.py:261`.

### `lightbulb.ReplayMode`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ReplayMode
~~~


Binding: `lightbulb.async_runtime.ReplayMode` → `lightbulb.async_runtime.ReplayMode`.

Source: `lightbulb/async_runtime.py:197`.

### `lightbulb.ReplayPolicy`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ReplayPolicy
~~~


Binding: `lightbulb.async_runtime.ReplayPolicy` → `lightbulb.async_runtime.ReplayPolicy`.

Source: `lightbulb/async_runtime.py:239`.

### `lightbulb.StreamBackpressureError`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import StreamBackpressureError
~~~


Binding: `lightbulb.async_runtime.StreamBackpressureError` → `lightbulb.async_runtime.StreamBackpressureError`.

Source: `lightbulb/async_runtime.py:303`.

### `lightbulb.StreamContractError`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import StreamContractError
~~~


Binding: `lightbulb.async_runtime.StreamContractError` → `lightbulb.async_runtime.StreamContractError`.

Source: `lightbulb/async_runtime.py:299`.

### `lightbulb.StreamCursor`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import StreamCursor
~~~


Binding: `lightbulb.async_runtime.StreamCursor` → `lightbulb.async_runtime.StreamCursor`.

Source: `lightbulb/async_runtime.py:209`.

### `lightbulb.StreamPartition`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import StreamPartition
~~~


Binding: `lightbulb.async_runtime.StreamPartition` → `lightbulb.async_runtime.StreamPartition`.

Source: `lightbulb/async_runtime.py:219`.

### `lightbulb.StreamRecord`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import StreamRecord
~~~


Binding: `lightbulb.async_runtime.StreamRecord` → `lightbulb.async_runtime.StreamRecord`.

Source: `lightbulb/async_runtime.py:280`.

### `lightbulb.asyncify`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import asyncify
~~~


Binding: `lightbulb.async_runtime.asyncify` → `lightbulb.async_runtime.asyncify`.

Source: `lightbulb/async_runtime.py:58`.

### `lightbulb.bounded_map`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import bounded_map
~~~


Binding: `lightbulb.async_runtime.bounded_map` → `lightbulb.async_runtime.bounded_map`.

Source: `lightbulb/async_runtime.py:131`.

### `lightbulb.buffered_stream`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import buffered_stream
~~~


Binding: `lightbulb.async_runtime.buffered_stream` → `lightbulb.async_runtime.buffered_stream`.

Source: `lightbulb/async_runtime.py:315`.

### `lightbulb.DataLineage`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import DataLineage
~~~


Binding: `lightbulb.distributed_data.DataLineage` → `lightbulb.distributed_data.DataLineage`.

Source: `lightbulb/distributed_data.py:109`.

### `lightbulb.DistributedArrayMetadata`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import DistributedArrayMetadata
~~~


Binding: `lightbulb.distributed_data.DistributedArrayMetadata` → `lightbulb.distributed_data.DistributedArrayMetadata`.

Source: `lightbulb/distributed_data.py:166`.

### `lightbulb.DistributedHashMapMetadata`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import DistributedHashMapMetadata
~~~


Binding: `lightbulb.distributed_data.DistributedHashMapMetadata` → `lightbulb.distributed_data.DistributedHashMapMetadata`.

Source: `lightbulb/distributed_data.py:187`.

### `lightbulb.DistributedTensorMetadata`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import DistributedTensorMetadata
~~~


Binding: `lightbulb.distributed_data.DistributedTensorMetadata` → `lightbulb.distributed_data.DistributedTensorMetadata`.

Source: `lightbulb/distributed_data.py:171`.

### `lightbulb.LineageInput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import LineageInput
~~~


Binding: `lightbulb.distributed_data.LineageInput` → `lightbulb.distributed_data.LineageInput`.

Source: `lightbulb/distributed_data.py:84`.

### `lightbulb.MapConsistency`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import MapConsistency
~~~


Binding: `lightbulb.distributed_data.MapConsistency` → `lightbulb.distributed_data.MapConsistency`.

Source: `lightbulb/distributed_data.py:32`.

### `lightbulb.PartitionSpec`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PartitionSpec
~~~


Binding: `lightbulb.distributed_data.PartitionSpec` → `lightbulb.distributed_data.PartitionSpec`.

Source: `lightbulb/distributed_data.py:38`.

### `lightbulb.PartitionStrategy`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PartitionStrategy
~~~


Binding: `lightbulb.distributed_data.PartitionStrategy` → `lightbulb.distributed_data.PartitionStrategy`.

Source: `lightbulb/distributed_data.py:19`.

### `lightbulb.TensorOrder`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import TensorOrder
~~~


Binding: `lightbulb.distributed_data.TensorOrder` → `lightbulb.distributed_data.TensorOrder`.

Source: `lightbulb/distributed_data.py:27`.

### `lightbulb.RECURSIVE_AGENT_POLICY_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import RECURSIVE_AGENT_POLICY_SCHEMA
~~~


Binding: `lightbulb.recursive_agents.RECURSIVE_AGENT_POLICY_SCHEMA` → `lightbulb.recursive_agents.RECURSIVE_AGENT_POLICY_SCHEMA`.

Source: `lightbulb/recursive_agents.py:11`.

### `lightbulb.RECURSIVE_AGENT_RUN_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import RECURSIVE_AGENT_RUN_SCHEMA
~~~


Binding: `lightbulb.recursive_agents.RECURSIVE_AGENT_RUN_SCHEMA` → `lightbulb.recursive_agents.RECURSIVE_AGENT_RUN_SCHEMA`.

Source: `lightbulb/recursive_agents.py:12`.

### `lightbulb.RUNTIME_AGENT_ID_PREFIX`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import RUNTIME_AGENT_ID_PREFIX
~~~


Binding: `lightbulb.recursive_agents.RUNTIME_AGENT_ID_PREFIX` → `lightbulb.recursive_agents.RUNTIME_AGENT_ID_PREFIX`.

Source: `lightbulb/recursive_agents.py:14`.

### `lightbulb.RecursiveAgentPolicy`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import RecursiveAgentPolicy
~~~


Binding: `lightbulb.recursive_agents.RecursiveAgentPolicy` → `lightbulb.recursive_agents.RecursiveAgentPolicy`.

Source: `lightbulb/recursive_agents.py:108`.

### `lightbulb.build_recursive_agent_inputs`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import build_recursive_agent_inputs
~~~


Binding: `lightbulb.recursive_agents.build_recursive_agent_inputs` → `lightbulb.recursive_agents.build_recursive_agent_inputs`.

Source: `lightbulb/recursive_agents.py:266`.

### `lightbulb.runtime_agent_id`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import runtime_agent_id
~~~


Binding: `lightbulb.recursive_agents.runtime_agent_id` → `lightbulb.recursive_agents.runtime_agent_id`.

Source: `lightbulb/recursive_agents.py:94`.

### `lightbulb.ApiKeyAuth`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ApiKeyAuth
~~~


Binding: `lightbulb.auth.ApiKeyAuth` → `lightbulb.auth.ApiKeyAuth`.

Source: `lightbulb/auth.py:88`.

### `lightbulb.JwtAuth`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import JwtAuth
~~~


Binding: `lightbulb.auth.JwtAuth` → `lightbulb.auth.JwtAuth`.

Source: `lightbulb/auth.py:135`.

### `lightbulb.TwoFactorRequired`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import TwoFactorRequired
~~~


Binding: `lightbulb.auth.TwoFactorRequired` → `lightbulb.auth.TwoFactorRequired`.

Source: `lightbulb/auth.py:174`.

### `lightbulb.login`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import login
~~~


Binding: `lightbulb.auth.login` → `lightbulb.auth.login`.

Source: `lightbulb/auth.py:193`.

### `lightbulb.complete_2fa_login`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import complete_2fa_login
~~~


Binding: `lightbulb.auth.complete_2fa_login` → `lightbulb.auth.complete_2fa_login`.

Source: `lightbulb/auth.py:323`.

### `lightbulb.device_login`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import device_login
~~~


Binding: `lightbulb.auth.device_login` → `lightbulb.auth.device_login`.

Source: `lightbulb/auth.py:597`.

### `lightbulb.sso_redirect_url`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import sso_redirect_url
~~~


Binding: `lightbulb.auth.sso_redirect_url` → `lightbulb.auth.sso_redirect_url`.

Source: `lightbulb/auth.py:559`.

### `lightbulb.LightbulbError`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import LightbulbError
~~~


Binding: `lightbulb.errors.LightbulbError` → `lightbulb.errors.LightbulbError`.

Source: `lightbulb/errors.py:51`.

### `lightbulb.AuthenticationError`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import AuthenticationError
~~~


Binding: `lightbulb.errors.AuthenticationError` → `lightbulb.errors.AuthenticationError`.

Source: `lightbulb/errors.py:76`.

### `lightbulb.PermissionDenied`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PermissionDenied
~~~


Binding: `lightbulb.errors.PermissionDenied` → `lightbulb.errors.PermissionDenied`.

Source: `lightbulb/errors.py:81`.

### `lightbulb.NotFoundError`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import NotFoundError
~~~


Binding: `lightbulb.errors.NotFoundError` → `lightbulb.errors.NotFoundError`.

Source: `lightbulb/errors.py:86`.

### `lightbulb.ValidationError`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ValidationError
~~~


Binding: `lightbulb.errors.ValidationError` → `lightbulb.errors.ValidationError`.

Source: `lightbulb/errors.py:91`.

### `lightbulb.TransportError`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import TransportError
~~~


Binding: `lightbulb.errors.TransportError` → `lightbulb.errors.TransportError`.

Source: `lightbulb/errors.py:104`.

### `lightbulb.RateLimitedError`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import RateLimitedError
~~~


Binding: `lightbulb.errors.RateLimitedError` → `lightbulb.errors.RateLimitedError`.

Source: `lightbulb/errors.py:117`.

### `lightbulb.ServerError`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ServerError
~~~


Binding: `lightbulb.errors.ServerError` → `lightbulb.errors.ServerError`.

Source: `lightbulb/errors.py:132`.

### `lightbulb.from_response`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import from_response
~~~


Binding: `lightbulb.errors.from_response` → `lightbulb.errors.from_response`.

Source: `lightbulb/errors.py:176`.

### `lightbulb.wrap_http_error`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import wrap_http_error
~~~


Binding: `lightbulb.errors.wrap_http_error` → `lightbulb.errors.wrap_http_error`.

Source: `lightbulb/errors.py:192`.

### `lightbulb.wrap_transport_error`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import wrap_transport_error
~~~


Binding: `lightbulb.errors.wrap_transport_error` → `lightbulb.errors.wrap_transport_error`.

Source: `lightbulb/errors.py:197`.

### `lightbulb.raise_if_error`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import raise_if_error
~~~


Binding: `lightbulb.errors.raise_if_error` → `lightbulb.errors.raise_if_error`.

Source: `lightbulb/errors.py:221`.

### `lightbulb.StripeOrchestratorClient`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import StripeOrchestratorClient
~~~


Binding: `lightbulb.stripe.StripeOrchestratorClient` → `lightbulb.stripe.StripeOrchestratorClient`.

Source: `lightbulb/stripe.py:54`.

### `lightbulb.StripeWorkflow`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import StripeWorkflow
~~~


Binding: `lightbulb.stripe.StripeWorkflow` → `lightbulb.stripe.StripeWorkflow`.

Source: `lightbulb/stripe.py:35`.

### `lightbulb.XeroAgentClient`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import XeroAgentClient
~~~


Binding: `lightbulb.xero.XeroAgentClient` → `lightbulb.xero.XeroAgentClient`.

Source: `lightbulb/xero.py:63`.

### `lightbulb.XeroPlaybook`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import XeroPlaybook
~~~


Binding: `lightbulb.xero.XeroPlaybook` → `lightbulb.xero.XeroPlaybook`.

Source: `lightbulb/xero.py:38`.

### `lightbulb.FINANCE_ACCOUNTING_EXECUTABLE_PRIMITIVES`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import FINANCE_ACCOUNTING_EXECUTABLE_PRIMITIVES
~~~


Binding: `lightbulb.finance_accounting.FINANCE_ACCOUNTING_EXECUTABLE_PRIMITIVES` → `lightbulb.finance_accounting.FINANCE_ACCOUNTING_EXECUTABLE_PRIMITIVES`.

Source: `lightbulb/finance_accounting.py:1963`.

### `lightbulb.JOURNAL_ENTRY_CONTROL_EVALUATION_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import JOURNAL_ENTRY_CONTROL_EVALUATION_SCHEMA
~~~


Binding: `lightbulb.finance_accounting.JOURNAL_ENTRY_CONTROL_EVALUATION_SCHEMA` → `lightbulb.finance_accounting.JOURNAL_ENTRY_CONTROL_EVALUATION_SCHEMA`.

Source: `lightbulb/finance_accounting.py:50`.

### `lightbulb.JOURNAL_ENTRY_EVALUATION_OPERATION`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import JOURNAL_ENTRY_EVALUATION_OPERATION
~~~


Binding: `lightbulb.finance_accounting.JOURNAL_ENTRY_EVALUATION_OPERATION` → `lightbulb.finance_accounting.JOURNAL_ENTRY_EVALUATION_OPERATION`.

Source: `lightbulb/finance_accounting.py:744`.

### `lightbulb.JOURNAL_ENTRY_CONTROL_INPUT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import JOURNAL_ENTRY_CONTROL_INPUT_SCHEMA
~~~


Binding: `lightbulb.finance_accounting.JOURNAL_ENTRY_CONTROL_INPUT_SCHEMA` → `lightbulb.finance_accounting.JOURNAL_ENTRY_CONTROL_INPUT_SCHEMA`.

Source: `lightbulb/finance_accounting.py:49`.

### `lightbulb.PERIOD_CLOSE_EVALUATION_OPERATION`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PERIOD_CLOSE_EVALUATION_OPERATION
~~~


Binding: `lightbulb.finance_accounting.PERIOD_CLOSE_EVALUATION_OPERATION` → `lightbulb.finance_accounting.PERIOD_CLOSE_EVALUATION_OPERATION`.

Source: `lightbulb/finance_accounting.py:754`.

### `lightbulb.PERIOD_CLOSE_READINESS_EVALUATION_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PERIOD_CLOSE_READINESS_EVALUATION_SCHEMA
~~~


Binding: `lightbulb.finance_accounting.PERIOD_CLOSE_READINESS_EVALUATION_SCHEMA` → `lightbulb.finance_accounting.PERIOD_CLOSE_READINESS_EVALUATION_SCHEMA`.

Source: `lightbulb/finance_accounting.py:56`.

### `lightbulb.PERIOD_CLOSE_READINESS_INPUT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PERIOD_CLOSE_READINESS_INPUT_SCHEMA
~~~


Binding: `lightbulb.finance_accounting.PERIOD_CLOSE_READINESS_INPUT_SCHEMA` → `lightbulb.finance_accounting.PERIOD_CLOSE_READINESS_INPUT_SCHEMA`.

Source: `lightbulb/finance_accounting.py:53`.

### `lightbulb.AccountingApprovalGate`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import AccountingApprovalGate
~~~


Binding: `lightbulb.finance_accounting.AccountingApprovalGate` → `lightbulb.finance_accounting.AccountingApprovalGate`.

Source: `lightbulb/finance_accounting.py:293`.

### `lightbulb.AccountingControlGate`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import AccountingControlGate
~~~


Binding: `lightbulb.finance_accounting.AccountingControlGate` → `lightbulb.finance_accounting.AccountingControlGate`.

Source: `lightbulb/finance_accounting.py:279`.

### `lightbulb.AccountingEvidencePolicy`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import AccountingEvidencePolicy
~~~


Binding: `lightbulb.finance_accounting.AccountingEvidencePolicy` → `lightbulb.finance_accounting.AccountingEvidencePolicy`.

Source: `lightbulb/finance_accounting.py:252`.

### `lightbulb.AccountingPeriodContext`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import AccountingPeriodContext
~~~


Binding: `lightbulb.finance_accounting.AccountingPeriodContext` → `lightbulb.finance_accounting.AccountingPeriodContext`.

Source: `lightbulb/finance_accounting.py:212`.

### `lightbulb.AccountingPeriodState`

value. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import AccountingPeriodState
~~~


Binding: `lightbulb.finance_accounting.AccountingPeriodState` → `lightbulb.finance_accounting.AccountingPeriodState`.

Source: `lightbulb/finance_accounting.py:88`.

### `lightbulb.ApprovalStatus`

value. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ApprovalStatus
~~~


Binding: `lightbulb.finance_accounting.ApprovalStatus` → `lightbulb.finance_accounting.ApprovalStatus`.

Source: `lightbulb/finance_accounting.py:87`.

### `lightbulb.ChartAccountControl`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ChartAccountControl
~~~


Binding: `lightbulb.finance_accounting.ChartAccountControl` → `lightbulb.finance_accounting.ChartAccountControl`.

Source: `lightbulb/finance_accounting.py:232`.

### `lightbulb.CompanyAccountingContext`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CompanyAccountingContext
~~~


Binding: `lightbulb.finance_accounting.CompanyAccountingContext` → `lightbulb.finance_accounting.CompanyAccountingContext`.

Source: `lightbulb/finance_accounting.py:185`.

### `lightbulb.ConsolidationReadiness`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ConsolidationReadiness
~~~


Binding: `lightbulb.finance_accounting.ConsolidationReadiness` → `lightbulb.finance_accounting.ConsolidationReadiness`.

Source: `lightbulb/finance_accounting.py:453`.

### `lightbulb.ControlGateStatus`

value. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ControlGateStatus
~~~


Binding: `lightbulb.finance_accounting.ControlGateStatus` → `lightbulb.finance_accounting.ControlGateStatus`.

Source: `lightbulb/finance_accounting.py:86`.

### `lightbulb.EvaluateJournalEntryControlsPrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import EvaluateJournalEntryControlsPrimitive
~~~


Binding: `lightbulb.finance_accounting.EvaluateJournalEntryControlsPrimitive` → `lightbulb.finance_accounting.EvaluateJournalEntryControlsPrimitive`.

Source: `lightbulb/finance_accounting.py:1867`.

### `lightbulb.EvaluatePeriodCloseReadinessPrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import EvaluatePeriodCloseReadinessPrimitive
~~~


Binding: `lightbulb.finance_accounting.EvaluatePeriodCloseReadinessPrimitive` → `lightbulb.finance_accounting.EvaluatePeriodCloseReadinessPrimitive`.

Source: `lightbulb/finance_accounting.py:1913`.

### `lightbulb.FinanceControlDisposition`

value. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import FinanceControlDisposition
~~~


Binding: `lightbulb.finance_accounting.FinanceControlDisposition` → `lightbulb.finance_accounting.FinanceControlDisposition`.

Source: `lightbulb/finance_accounting.py:84`.

### `lightbulb.FinanceControlFinding`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import FinanceControlFinding
~~~


Binding: `lightbulb.finance_accounting.FinanceControlFinding` → `lightbulb.finance_accounting.FinanceControlFinding`.

Source: `lightbulb/finance_accounting.py:306`.

### `lightbulb.FinanceControlStatus`

value. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import FinanceControlStatus
~~~


Binding: `lightbulb.finance_accounting.FinanceControlStatus` → `lightbulb.finance_accounting.FinanceControlStatus`.

Source: `lightbulb/finance_accounting.py:85`.

### `lightbulb.JournalEntryControlEvaluation`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import JournalEntryControlEvaluation
~~~


Binding: `lightbulb.finance_accounting.JournalEntryControlEvaluation` → `lightbulb.finance_accounting.JournalEntryControlEvaluation`.

Source: `lightbulb/finance_accounting.py:671`.

### `lightbulb.JournalEntryControlInput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import JournalEntryControlInput
~~~


Binding: `lightbulb.finance_accounting.JournalEntryControlInput` → `lightbulb.finance_accounting.JournalEntryControlInput`.

Source: `lightbulb/finance_accounting.py:334`.

### `lightbulb.JournalEntryLine`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import JournalEntryLine
~~~


Binding: `lightbulb.finance_accounting.JournalEntryLine` → `lightbulb.finance_accounting.JournalEntryLine`.

Source: `lightbulb/finance_accounting.py:320`.

### `lightbulb.PeriodCloseReadinessEvaluation`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PeriodCloseReadinessEvaluation
~~~


Binding: `lightbulb.finance_accounting.PeriodCloseReadinessEvaluation` → `lightbulb.finance_accounting.PeriodCloseReadinessEvaluation`.

Source: `lightbulb/finance_accounting.py:696`.

### `lightbulb.PeriodCloseReadinessInput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PeriodCloseReadinessInput
~~~


Binding: `lightbulb.finance_accounting.PeriodCloseReadinessInput` → `lightbulb.finance_accounting.PeriodCloseReadinessInput`.

Source: `lightbulb/finance_accounting.py:496`.

### `lightbulb.ReconciliationControl`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ReconciliationControl
~~~


Binding: `lightbulb.finance_accounting.ReconciliationControl` → `lightbulb.finance_accounting.ReconciliationControl`.

Source: `lightbulb/finance_accounting.py:406`.

### `lightbulb.ReconciliationStatus`

value. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ReconciliationStatus
~~~


Binding: `lightbulb.finance_accounting.ReconciliationStatus` → `lightbulb.finance_accounting.ReconciliationStatus`.

Source: `lightbulb/finance_accounting.py:89`.

### `lightbulb.evaluate_journal_entry_controls`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import evaluate_journal_entry_controls
~~~


Binding: `lightbulb.finance_accounting.evaluate_journal_entry_controls` → `lightbulb.finance_accounting.evaluate_journal_entry_controls`.

Source: `lightbulb/finance_accounting.py:1085`.

### `lightbulb.evaluate_period_close_readiness`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import evaluate_period_close_readiness
~~~


Binding: `lightbulb.finance_accounting.evaluate_period_close_readiness` → `lightbulb.finance_accounting.evaluate_period_close_readiness`.

Source: `lightbulb/finance_accounting.py:1285`.

### `lightbulb.CONSOLIDATION_PACKAGE_CANDIDATE_INPUT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CONSOLIDATION_PACKAGE_CANDIDATE_INPUT_SCHEMA
~~~


Binding: `lightbulb.finance_consolidation_package.CONSOLIDATION_PACKAGE_CANDIDATE_INPUT_SCHEMA` → `lightbulb.finance_consolidation_package.CONSOLIDATION_PACKAGE_CANDIDATE_INPUT_SCHEMA`.

Source: `lightbulb/finance_consolidation_package.py:55`.

### `lightbulb.CONSOLIDATION_PACKAGE_CANDIDATE_RESULT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CONSOLIDATION_PACKAGE_CANDIDATE_RESULT_SCHEMA
~~~


Binding: `lightbulb.finance_consolidation_package.CONSOLIDATION_PACKAGE_CANDIDATE_RESULT_SCHEMA` → `lightbulb.finance_consolidation_package.CONSOLIDATION_PACKAGE_CANDIDATE_RESULT_SCHEMA`.

Source: `lightbulb/finance_consolidation_package.py:58`.

### `lightbulb.FINANCE_CONSOLIDATION_PACKAGE_EXECUTABLE_PRIMITIVES`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import FINANCE_CONSOLIDATION_PACKAGE_EXECUTABLE_PRIMITIVES
~~~


Binding: `lightbulb.finance_consolidation_package.FINANCE_CONSOLIDATION_PACKAGE_EXECUTABLE_PRIMITIVES` → `lightbulb.finance_consolidation_package.FINANCE_CONSOLIDATION_PACKAGE_EXECUTABLE_PRIMITIVES`.

Source: `lightbulb/finance_consolidation_package.py:524`.

### `lightbulb.ConsolidationPackageCandidateResult`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ConsolidationPackageCandidateResult
~~~


Binding: `lightbulb.finance_consolidation_package.ConsolidationPackageCandidateResult` → `lightbulb.finance_consolidation_package.ConsolidationPackageCandidateResult`.

Source: `lightbulb/finance_consolidation_package.py:262`.

### `lightbulb.PrepareConsolidationPackageInput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PrepareConsolidationPackageInput
~~~


Binding: `lightbulb.finance_consolidation_package.PrepareConsolidationPackageInput` → `lightbulb.finance_consolidation_package.PrepareConsolidationPackageInput`.

Source: `lightbulb/finance_consolidation_package.py:122`.

### `lightbulb.PrepareConsolidationPackagePrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PrepareConsolidationPackagePrimitive
~~~


Binding: `lightbulb.finance_consolidation_package.PrepareConsolidationPackagePrimitive` → `lightbulb.finance_consolidation_package.PrepareConsolidationPackagePrimitive`.

Source: `lightbulb/finance_consolidation_package.py:410`.

### `lightbulb.prepare_consolidation_package`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import prepare_consolidation_package
~~~


Binding: `lightbulb.finance_consolidation_package.prepare_consolidation_package` → `lightbulb.finance_consolidation_package.prepare_consolidation_package`.

Source: `lightbulb/finance_consolidation_package.py:334`.

### `lightbulb.CONSOLIDATION_TRANSITION_COMMAND_INPUT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CONSOLIDATION_TRANSITION_COMMAND_INPUT_SCHEMA
~~~


Binding: `lightbulb.finance_consolidation_transition.CONSOLIDATION_TRANSITION_COMMAND_INPUT_SCHEMA` → `lightbulb.finance_consolidation_transition.CONSOLIDATION_TRANSITION_COMMAND_INPUT_SCHEMA`.

Source: `lightbulb/finance_consolidation_transition.py:55`.

### `lightbulb.CONSOLIDATION_TRANSITION_COMMAND_RESULT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CONSOLIDATION_TRANSITION_COMMAND_RESULT_SCHEMA
~~~


Binding: `lightbulb.finance_consolidation_transition.CONSOLIDATION_TRANSITION_COMMAND_RESULT_SCHEMA` → `lightbulb.finance_consolidation_transition.CONSOLIDATION_TRANSITION_COMMAND_RESULT_SCHEMA`.

Source: `lightbulb/finance_consolidation_transition.py:58`.

### `lightbulb.FINANCE_CONSOLIDATION_TRANSITION_EXECUTABLE_PRIMITIVES`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import FINANCE_CONSOLIDATION_TRANSITION_EXECUTABLE_PRIMITIVES
~~~


Binding: `lightbulb.finance_consolidation_transition.FINANCE_CONSOLIDATION_TRANSITION_EXECUTABLE_PRIMITIVES` → `lightbulb.finance_consolidation_transition.FINANCE_CONSOLIDATION_TRANSITION_EXECUTABLE_PRIMITIVES`.

Source: `lightbulb/finance_consolidation_transition.py:589`.

### `lightbulb.ConsolidationArtifactEvidenceClaim`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ConsolidationArtifactEvidenceClaim
~~~


Binding: `lightbulb.finance_consolidation_transition.ConsolidationArtifactEvidenceClaim` → `lightbulb.finance_consolidation_transition.ConsolidationArtifactEvidenceClaim`.

Source: `lightbulb/finance_consolidation_transition.py:120`.

### `lightbulb.ConsolidationReviewEvidenceClaim`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ConsolidationReviewEvidenceClaim
~~~


Binding: `lightbulb.finance_consolidation_transition.ConsolidationReviewEvidenceClaim` → `lightbulb.finance_consolidation_transition.ConsolidationReviewEvidenceClaim`.

Source: `lightbulb/finance_consolidation_transition.py:139`.

### `lightbulb.ConsolidationTransitionCommandResult`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ConsolidationTransitionCommandResult
~~~


Binding: `lightbulb.finance_consolidation_transition.ConsolidationTransitionCommandResult` → `lightbulb.finance_consolidation_transition.ConsolidationTransitionCommandResult`.

Source: `lightbulb/finance_consolidation_transition.py:266`.

### `lightbulb.PrepareConsolidationTransitionCommandInput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PrepareConsolidationTransitionCommandInput
~~~


Binding: `lightbulb.finance_consolidation_transition.PrepareConsolidationTransitionCommandInput` → `lightbulb.finance_consolidation_transition.PrepareConsolidationTransitionCommandInput`.

Source: `lightbulb/finance_consolidation_transition.py:158`.

### `lightbulb.PrepareConsolidationTransitionCommandPrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PrepareConsolidationTransitionCommandPrimitive
~~~


Binding: `lightbulb.finance_consolidation_transition.PrepareConsolidationTransitionCommandPrimitive` → `lightbulb.finance_consolidation_transition.PrepareConsolidationTransitionCommandPrimitive`.

Source: `lightbulb/finance_consolidation_transition.py:469`.

### `lightbulb.prepare_consolidation_transition_command`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import prepare_consolidation_transition_command
~~~


Binding: `lightbulb.finance_consolidation_transition.prepare_consolidation_transition_command` → `lightbulb.finance_consolidation_transition.prepare_consolidation_transition_command`.

Source: `lightbulb/finance_consolidation_transition.py:369`.

### `lightbulb.ADJUSTMENT_JOURNAL_EVIDENCE_BINDING_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ADJUSTMENT_JOURNAL_EVIDENCE_BINDING_SCHEMA
~~~


Binding: `lightbulb.finance_adjusting_entries_package.ADJUSTMENT_JOURNAL_EVIDENCE_BINDING_SCHEMA` → `lightbulb.finance_adjusting_entries_package.ADJUSTMENT_JOURNAL_EVIDENCE_BINDING_SCHEMA`.

Source: `lightbulb/finance_adjusting_entries_package.py:71`.

### `lightbulb.ADJUSTING_ENTRIES_PACKAGE_CANDIDATE_INPUT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ADJUSTING_ENTRIES_PACKAGE_CANDIDATE_INPUT_SCHEMA
~~~


Binding: `lightbulb.finance_adjusting_entries_package.ADJUSTING_ENTRIES_PACKAGE_CANDIDATE_INPUT_SCHEMA` → `lightbulb.finance_adjusting_entries_package.ADJUSTING_ENTRIES_PACKAGE_CANDIDATE_INPUT_SCHEMA`.

Source: `lightbulb/finance_adjusting_entries_package.py:65`.

### `lightbulb.ADJUSTING_ENTRIES_PACKAGE_CANDIDATE_RESULT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ADJUSTING_ENTRIES_PACKAGE_CANDIDATE_RESULT_SCHEMA
~~~


Binding: `lightbulb.finance_adjusting_entries_package.ADJUSTING_ENTRIES_PACKAGE_CANDIDATE_RESULT_SCHEMA` → `lightbulb.finance_adjusting_entries_package.ADJUSTING_ENTRIES_PACKAGE_CANDIDATE_RESULT_SCHEMA`.

Source: `lightbulb/finance_adjusting_entries_package.py:68`.

### `lightbulb.FINANCE_ADJUSTING_ENTRIES_PACKAGE_EXECUTABLE_PRIMITIVES`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import FINANCE_ADJUSTING_ENTRIES_PACKAGE_EXECUTABLE_PRIMITIVES
~~~


Binding: `lightbulb.finance_adjusting_entries_package.FINANCE_ADJUSTING_ENTRIES_PACKAGE_EXECUTABLE_PRIMITIVES` → `lightbulb.finance_adjusting_entries_package.FINANCE_ADJUSTING_ENTRIES_PACKAGE_EXECUTABLE_PRIMITIVES`.

Source: `lightbulb/finance_adjusting_entries_package.py:770`.

### `lightbulb.AdjustmentJournalEvidenceBinding`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import AdjustmentJournalEvidenceBinding
~~~


Binding: `lightbulb.finance_adjusting_entries_package.AdjustmentJournalEvidenceBinding` → `lightbulb.finance_adjusting_entries_package.AdjustmentJournalEvidenceBinding`.

Source: `lightbulb/finance_adjusting_entries_package.py:252`.

### `lightbulb.AdjustmentJournalPostingEvidence`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import AdjustmentJournalPostingEvidence
~~~


Binding: `lightbulb.finance_adjusting_entries_package.AdjustmentJournalPostingEvidence` → `lightbulb.finance_adjusting_entries_package.AdjustmentJournalPostingEvidence`.

Source: `lightbulb/finance_adjusting_entries_package.py:135`.

### `lightbulb.AdjustingEntriesPackageCandidateResult`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import AdjustingEntriesPackageCandidateResult
~~~


Binding: `lightbulb.finance_adjusting_entries_package.AdjustingEntriesPackageCandidateResult` → `lightbulb.finance_adjusting_entries_package.AdjustingEntriesPackageCandidateResult`.

Source: `lightbulb/finance_adjusting_entries_package.py:504`.

### `lightbulb.PrepareAdjustingEntriesPackageInput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PrepareAdjustingEntriesPackageInput
~~~


Binding: `lightbulb.finance_adjusting_entries_package.PrepareAdjustingEntriesPackageInput` → `lightbulb.finance_adjusting_entries_package.PrepareAdjustingEntriesPackageInput`.

Source: `lightbulb/finance_adjusting_entries_package.py:305`.

### `lightbulb.PrepareAdjustingEntriesPackagePrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PrepareAdjustingEntriesPackagePrimitive
~~~


Binding: `lightbulb.finance_adjusting_entries_package.PrepareAdjustingEntriesPackagePrimitive` → `lightbulb.finance_adjusting_entries_package.PrepareAdjustingEntriesPackagePrimitive`.

Source: `lightbulb/finance_adjusting_entries_package.py:662`.

### `lightbulb.prepare_adjusting_entries_package`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import prepare_adjusting_entries_package
~~~


Binding: `lightbulb.finance_adjusting_entries_package.prepare_adjusting_entries_package` → `lightbulb.finance_adjusting_entries_package.prepare_adjusting_entries_package`.

Source: `lightbulb/finance_adjusting_entries_package.py:577`.

### `lightbulb.ADJUSTING_ENTRIES_TRANSITION_COMMAND_INPUT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ADJUSTING_ENTRIES_TRANSITION_COMMAND_INPUT_SCHEMA
~~~


Binding: `lightbulb.finance_adjusting_entries_transition.ADJUSTING_ENTRIES_TRANSITION_COMMAND_INPUT_SCHEMA` → `lightbulb.finance_adjusting_entries_transition.ADJUSTING_ENTRIES_TRANSITION_COMMAND_INPUT_SCHEMA`.

Source: `lightbulb/finance_adjusting_entries_transition.py:56`.

### `lightbulb.ADJUSTING_ENTRIES_TRANSITION_COMMAND_RESULT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ADJUSTING_ENTRIES_TRANSITION_COMMAND_RESULT_SCHEMA
~~~


Binding: `lightbulb.finance_adjusting_entries_transition.ADJUSTING_ENTRIES_TRANSITION_COMMAND_RESULT_SCHEMA` → `lightbulb.finance_adjusting_entries_transition.ADJUSTING_ENTRIES_TRANSITION_COMMAND_RESULT_SCHEMA`.

Source: `lightbulb/finance_adjusting_entries_transition.py:59`.

### `lightbulb.FINANCE_ADJUSTING_ENTRIES_TRANSITION_EXECUTABLE_PRIMITIVES`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import FINANCE_ADJUSTING_ENTRIES_TRANSITION_EXECUTABLE_PRIMITIVES
~~~


Binding: `lightbulb.finance_adjusting_entries_transition.FINANCE_ADJUSTING_ENTRIES_TRANSITION_EXECUTABLE_PRIMITIVES` → `lightbulb.finance_adjusting_entries_transition.FINANCE_ADJUSTING_ENTRIES_TRANSITION_EXECUTABLE_PRIMITIVES`.

Source: `lightbulb/finance_adjusting_entries_transition.py:594`.

### `lightbulb.AdjustmentPostingReviewEvidenceClaim`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import AdjustmentPostingReviewEvidenceClaim
~~~


Binding: `lightbulb.finance_adjusting_entries_transition.AdjustmentPostingReviewEvidenceClaim` → `lightbulb.finance_adjusting_entries_transition.AdjustmentPostingReviewEvidenceClaim`.

Source: `lightbulb/finance_adjusting_entries_transition.py:140`.

### `lightbulb.AdjustingEntriesArtifactEvidenceClaim`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import AdjustingEntriesArtifactEvidenceClaim
~~~


Binding: `lightbulb.finance_adjusting_entries_transition.AdjustingEntriesArtifactEvidenceClaim` → `lightbulb.finance_adjusting_entries_transition.AdjustingEntriesArtifactEvidenceClaim`.

Source: `lightbulb/finance_adjusting_entries_transition.py:121`.

### `lightbulb.AdjustingEntriesTransitionCommandResult`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import AdjustingEntriesTransitionCommandResult
~~~


Binding: `lightbulb.finance_adjusting_entries_transition.AdjustingEntriesTransitionCommandResult` → `lightbulb.finance_adjusting_entries_transition.AdjustingEntriesTransitionCommandResult`.

Source: `lightbulb/finance_adjusting_entries_transition.py:269`.

### `lightbulb.PrepareAdjustingEntriesTransitionCommandInput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PrepareAdjustingEntriesTransitionCommandInput
~~~


Binding: `lightbulb.finance_adjusting_entries_transition.PrepareAdjustingEntriesTransitionCommandInput` → `lightbulb.finance_adjusting_entries_transition.PrepareAdjustingEntriesTransitionCommandInput`.

Source: `lightbulb/finance_adjusting_entries_transition.py:159`.

### `lightbulb.PrepareAdjustingEntriesTransitionCommandPrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PrepareAdjustingEntriesTransitionCommandPrimitive
~~~


Binding: `lightbulb.finance_adjusting_entries_transition.PrepareAdjustingEntriesTransitionCommandPrimitive` → `lightbulb.finance_adjusting_entries_transition.PrepareAdjustingEntriesTransitionCommandPrimitive`.

Source: `lightbulb/finance_adjusting_entries_transition.py:473`.

### `lightbulb.prepare_adjusting_entries_transition_command`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import prepare_adjusting_entries_transition_command
~~~


Binding: `lightbulb.finance_adjusting_entries_transition.prepare_adjusting_entries_transition_command` → `lightbulb.finance_adjusting_entries_transition.prepare_adjusting_entries_transition_command`.

Source: `lightbulb/finance_adjusting_entries_transition.py:369`.

### `lightbulb.FINANCE_SUBLEDGER_LOCK_PACKAGE_EXECUTABLE_PRIMITIVES`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import FINANCE_SUBLEDGER_LOCK_PACKAGE_EXECUTABLE_PRIMITIVES
~~~


Binding: `lightbulb.finance_subledger_lock_package.FINANCE_SUBLEDGER_LOCK_PACKAGE_EXECUTABLE_PRIMITIVES` → `lightbulb.finance_subledger_lock_package.FINANCE_SUBLEDGER_LOCK_PACKAGE_EXECUTABLE_PRIMITIVES`.

Source: `lightbulb/finance_subledger_lock_package.py:531`.

### `lightbulb.SUBLEDGER_LOCK_PACKAGE_CANDIDATE_INPUT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SUBLEDGER_LOCK_PACKAGE_CANDIDATE_INPUT_SCHEMA
~~~


Binding: `lightbulb.finance_subledger_lock_package.SUBLEDGER_LOCK_PACKAGE_CANDIDATE_INPUT_SCHEMA` → `lightbulb.finance_subledger_lock_package.SUBLEDGER_LOCK_PACKAGE_CANDIDATE_INPUT_SCHEMA`.

Source: `lightbulb/finance_subledger_lock_package.py:50`.

### `lightbulb.SUBLEDGER_LOCK_PACKAGE_CANDIDATE_RESULT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SUBLEDGER_LOCK_PACKAGE_CANDIDATE_RESULT_SCHEMA
~~~


Binding: `lightbulb.finance_subledger_lock_package.SUBLEDGER_LOCK_PACKAGE_CANDIDATE_RESULT_SCHEMA` → `lightbulb.finance_subledger_lock_package.SUBLEDGER_LOCK_PACKAGE_CANDIDATE_RESULT_SCHEMA`.

Source: `lightbulb/finance_subledger_lock_package.py:53`.

### `lightbulb.PrepareSubledgerLockPackageInput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PrepareSubledgerLockPackageInput
~~~


Binding: `lightbulb.finance_subledger_lock_package.PrepareSubledgerLockPackageInput` → `lightbulb.finance_subledger_lock_package.PrepareSubledgerLockPackageInput`.

Source: `lightbulb/finance_subledger_lock_package.py:145`.

### `lightbulb.PrepareSubledgerLockPackagePrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PrepareSubledgerLockPackagePrimitive
~~~


Binding: `lightbulb.finance_subledger_lock_package.PrepareSubledgerLockPackagePrimitive` → `lightbulb.finance_subledger_lock_package.PrepareSubledgerLockPackagePrimitive`.

Source: `lightbulb/finance_subledger_lock_package.py:421`.

### `lightbulb.SubledgerLockObservation`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SubledgerLockObservation
~~~


Binding: `lightbulb.finance_subledger_lock_package.SubledgerLockObservation` → `lightbulb.finance_subledger_lock_package.SubledgerLockObservation`.

Source: `lightbulb/finance_subledger_lock_package.py:117`.

### `lightbulb.SubledgerLockPackageCandidateResult`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SubledgerLockPackageCandidateResult
~~~


Binding: `lightbulb.finance_subledger_lock_package.SubledgerLockPackageCandidateResult` → `lightbulb.finance_subledger_lock_package.SubledgerLockPackageCandidateResult`.

Source: `lightbulb/finance_subledger_lock_package.py:272`.

### `lightbulb.prepare_subledger_lock_package`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import prepare_subledger_lock_package
~~~


Binding: `lightbulb.finance_subledger_lock_package.prepare_subledger_lock_package` → `lightbulb.finance_subledger_lock_package.prepare_subledger_lock_package`.

Source: `lightbulb/finance_subledger_lock_package.py:340`.

### `lightbulb.FINANCE_SUBLEDGER_LOCK_TRANSITION_EXECUTABLE_PRIMITIVES`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import FINANCE_SUBLEDGER_LOCK_TRANSITION_EXECUTABLE_PRIMITIVES
~~~


Binding: `lightbulb.finance_subledger_lock_transition.FINANCE_SUBLEDGER_LOCK_TRANSITION_EXECUTABLE_PRIMITIVES` → `lightbulb.finance_subledger_lock_transition.FINANCE_SUBLEDGER_LOCK_TRANSITION_EXECUTABLE_PRIMITIVES`.

Source: `lightbulb/finance_subledger_lock_transition.py:576`.

### `lightbulb.SUBLEDGER_LOCK_TRANSITION_COMMAND_INPUT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SUBLEDGER_LOCK_TRANSITION_COMMAND_INPUT_SCHEMA
~~~


Binding: `lightbulb.finance_subledger_lock_transition.SUBLEDGER_LOCK_TRANSITION_COMMAND_INPUT_SCHEMA` → `lightbulb.finance_subledger_lock_transition.SUBLEDGER_LOCK_TRANSITION_COMMAND_INPUT_SCHEMA`.

Source: `lightbulb/finance_subledger_lock_transition.py:55`.

### `lightbulb.SUBLEDGER_LOCK_TRANSITION_COMMAND_RESULT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SUBLEDGER_LOCK_TRANSITION_COMMAND_RESULT_SCHEMA
~~~


Binding: `lightbulb.finance_subledger_lock_transition.SUBLEDGER_LOCK_TRANSITION_COMMAND_RESULT_SCHEMA` → `lightbulb.finance_subledger_lock_transition.SUBLEDGER_LOCK_TRANSITION_COMMAND_RESULT_SCHEMA`.

Source: `lightbulb/finance_subledger_lock_transition.py:58`.

### `lightbulb.PrepareSubledgerLockTransitionCommandInput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PrepareSubledgerLockTransitionCommandInput
~~~


Binding: `lightbulb.finance_subledger_lock_transition.PrepareSubledgerLockTransitionCommandInput` → `lightbulb.finance_subledger_lock_transition.PrepareSubledgerLockTransitionCommandInput`.

Source: `lightbulb/finance_subledger_lock_transition.py:158`.

### `lightbulb.PrepareSubledgerLockTransitionCommandPrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PrepareSubledgerLockTransitionCommandPrimitive
~~~


Binding: `lightbulb.finance_subledger_lock_transition.PrepareSubledgerLockTransitionCommandPrimitive` → `lightbulb.finance_subledger_lock_transition.PrepareSubledgerLockTransitionCommandPrimitive`.

Source: `lightbulb/finance_subledger_lock_transition.py:457`.

### `lightbulb.SubledgerLockArtifactEvidenceClaim`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SubledgerLockArtifactEvidenceClaim
~~~


Binding: `lightbulb.finance_subledger_lock_transition.SubledgerLockArtifactEvidenceClaim` → `lightbulb.finance_subledger_lock_transition.SubledgerLockArtifactEvidenceClaim`.

Source: `lightbulb/finance_subledger_lock_transition.py:120`.

### `lightbulb.SubledgerLockReviewEvidenceClaim`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SubledgerLockReviewEvidenceClaim
~~~


Binding: `lightbulb.finance_subledger_lock_transition.SubledgerLockReviewEvidenceClaim` → `lightbulb.finance_subledger_lock_transition.SubledgerLockReviewEvidenceClaim`.

Source: `lightbulb/finance_subledger_lock_transition.py:139`.

### `lightbulb.SubledgerLockTransitionCommandResult`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SubledgerLockTransitionCommandResult
~~~


Binding: `lightbulb.finance_subledger_lock_transition.SubledgerLockTransitionCommandResult` → `lightbulb.finance_subledger_lock_transition.SubledgerLockTransitionCommandResult`.

Source: `lightbulb/finance_subledger_lock_transition.py:266`.

### `lightbulb.prepare_subledger_lock_transition_command`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import prepare_subledger_lock_transition_command
~~~


Binding: `lightbulb.finance_subledger_lock_transition.prepare_subledger_lock_transition_command` → `lightbulb.finance_subledger_lock_transition.prepare_subledger_lock_transition_command`.

Source: `lightbulb/finance_subledger_lock_transition.py:358`.

### `lightbulb.FINANCE_CLOSE_LIFECYCLE_EXECUTABLE_PRIMITIVES`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import FINANCE_CLOSE_LIFECYCLE_EXECUTABLE_PRIMITIVES
~~~


Binding: `lightbulb.finance_close_lifecycle.FINANCE_CLOSE_LIFECYCLE_EXECUTABLE_PRIMITIVES` → `lightbulb.finance_close_lifecycle.FINANCE_CLOSE_LIFECYCLE_EXECUTABLE_PRIMITIVES`.

Source: `lightbulb/finance_close_lifecycle.py:2561`.

### `lightbulb.CLOSE_RECONCILIATION_READINESS_INPUT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CLOSE_RECONCILIATION_READINESS_INPUT_SCHEMA
~~~


Binding: `lightbulb.finance_close_reconciliation_readiness.CLOSE_RECONCILIATION_READINESS_INPUT_SCHEMA` → `lightbulb.finance_close_reconciliation_readiness.CLOSE_RECONCILIATION_READINESS_INPUT_SCHEMA`.

Source: `lightbulb/finance_close_reconciliation_readiness.py:53`.

### `lightbulb.CLOSE_RECONCILIATION_READINESS_RESULT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CLOSE_RECONCILIATION_READINESS_RESULT_SCHEMA
~~~


Binding: `lightbulb.finance_close_reconciliation_readiness.CLOSE_RECONCILIATION_READINESS_RESULT_SCHEMA` → `lightbulb.finance_close_reconciliation_readiness.CLOSE_RECONCILIATION_READINESS_RESULT_SCHEMA`.

Source: `lightbulb/finance_close_reconciliation_readiness.py:56`.

### `lightbulb.FINANCE_CLOSE_RECONCILIATION_READINESS_EXECUTABLE_PRIMITIVES`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import FINANCE_CLOSE_RECONCILIATION_READINESS_EXECUTABLE_PRIMITIVES
~~~


Binding: `lightbulb.finance_close_reconciliation_readiness.FINANCE_CLOSE_RECONCILIATION_READINESS_EXECUTABLE_PRIMITIVES` → `lightbulb.finance_close_reconciliation_readiness.FINANCE_CLOSE_RECONCILIATION_READINESS_EXECUTABLE_PRIMITIVES`.

Source: `lightbulb/finance_close_reconciliation_readiness.py:633`.

### `lightbulb.CloseReconciliationReadinessBlocker`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CloseReconciliationReadinessBlocker
~~~


Binding: `lightbulb.finance_close_reconciliation_readiness.CloseReconciliationReadinessBlocker` → `lightbulb.finance_close_reconciliation_readiness.CloseReconciliationReadinessBlocker`.

Source: `lightbulb/finance_close_reconciliation_readiness.py:246`.

### `lightbulb.CloseReconciliationReadinessInput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CloseReconciliationReadinessInput
~~~


Binding: `lightbulb.finance_close_reconciliation_readiness.CloseReconciliationReadinessInput` → `lightbulb.finance_close_reconciliation_readiness.CloseReconciliationReadinessInput`.

Source: `lightbulb/finance_close_reconciliation_readiness.py:184`.

### `lightbulb.CloseReconciliationReadinessResult`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CloseReconciliationReadinessResult
~~~


Binding: `lightbulb.finance_close_reconciliation_readiness.CloseReconciliationReadinessResult` → `lightbulb.finance_close_reconciliation_readiness.CloseReconciliationReadinessResult`.

Source: `lightbulb/finance_close_reconciliation_readiness.py:257`.

### `lightbulb.EvaluateCloseReconciliationReadinessPrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import EvaluateCloseReconciliationReadinessPrimitive
~~~


Binding: `lightbulb.finance_close_reconciliation_readiness.EvaluateCloseReconciliationReadinessPrimitive` → `lightbulb.finance_close_reconciliation_readiness.EvaluateCloseReconciliationReadinessPrimitive`.

Source: `lightbulb/finance_close_reconciliation_readiness.py:524`.

### `lightbulb.ReadinessBlockerCode`

value. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ReadinessBlockerCode
~~~


Binding: `lightbulb.finance_close_reconciliation_readiness.ReadinessBlockerCode` → `lightbulb.finance_close_reconciliation_readiness.ReadinessBlockerCode`.

Source: `lightbulb/finance_close_reconciliation_readiness.py:132`.

### `lightbulb.evaluate_close_reconciliation_readiness`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import evaluate_close_reconciliation_readiness
~~~


Binding: `lightbulb.finance_close_reconciliation_readiness.evaluate_close_reconciliation_readiness` → `lightbulb.finance_close_reconciliation_readiness.evaluate_close_reconciliation_readiness`.

Source: `lightbulb/finance_close_reconciliation_readiness.py:408`.

### `lightbulb.GENESIS_PERIOD_CLOSE_DIGEST`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GENESIS_PERIOD_CLOSE_DIGEST
~~~


Binding: `lightbulb.finance_close_lifecycle.GENESIS_PERIOD_CLOSE_DIGEST` → `lightbulb.finance_close_lifecycle.GENESIS_PERIOD_CLOSE_DIGEST`.

Source: `lightbulb/finance_close_lifecycle.py:70`.

### `lightbulb.MAX_PERIOD_CLOSE_TRANSITIONS`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import MAX_PERIOD_CLOSE_TRANSITIONS
~~~


Binding: `lightbulb.finance_close_lifecycle.MAX_PERIOD_CLOSE_TRANSITIONS` → `lightbulb.finance_close_lifecycle.MAX_PERIOD_CLOSE_TRANSITIONS`.

Source: `lightbulb/finance_close_lifecycle.py:71`.

### `lightbulb.PERIOD_CLOSE_TRANSITION_OPERATION`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PERIOD_CLOSE_TRANSITION_OPERATION
~~~


Binding: `lightbulb.finance_close_lifecycle.PERIOD_CLOSE_TRANSITION_OPERATION` → `lightbulb.finance_close_lifecycle.PERIOD_CLOSE_TRANSITION_OPERATION`.

Source: `lightbulb/finance_close_lifecycle.py:2238`.

### `lightbulb.AccountReconciliationRecord`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import AccountReconciliationRecord
~~~


Binding: `lightbulb.finance_close_lifecycle.AccountReconciliationRecord` → `lightbulb.finance_close_lifecycle.AccountReconciliationRecord`.

Source: `lightbulb/finance_close_lifecycle.py:518`.

### `lightbulb.AdjustingEntriesPackage`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import AdjustingEntriesPackage
~~~


Binding: `lightbulb.finance_close_lifecycle.AdjustingEntriesPackage` → `lightbulb.finance_close_lifecycle.AdjustingEntriesPackage`.

Source: `lightbulb/finance_close_lifecycle.py:710`.

### `lightbulb.AdjustingJournalEntry`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import AdjustingJournalEntry
~~~


Binding: `lightbulb.finance_close_lifecycle.AdjustingJournalEntry` → `lightbulb.finance_close_lifecycle.AdjustingJournalEntry`.

Source: `lightbulb/finance_close_lifecycle.py:672`.

### `lightbulb.CloseApprovalPackage`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CloseApprovalPackage
~~~


Binding: `lightbulb.finance_close_lifecycle.CloseApprovalPackage` → `lightbulb.finance_close_lifecycle.CloseApprovalPackage`.

Source: `lightbulb/finance_close_lifecycle.py:940`.

### `lightbulb.CloseEvidenceEnvelope`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CloseEvidenceEnvelope
~~~


Binding: `lightbulb.finance_close_lifecycle.CloseEvidenceEnvelope` → `lightbulb.finance_close_lifecycle.CloseEvidenceEnvelope`.

Source: `lightbulb/finance_close_lifecycle.py:388`.

### `lightbulb.ClosePeriodPackage`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ClosePeriodPackage
~~~


Binding: `lightbulb.finance_close_lifecycle.ClosePeriodPackage` → `lightbulb.finance_close_lifecycle.ClosePeriodPackage`.

Source: `lightbulb/finance_close_lifecycle.py:981`.

### `lightbulb.ConsolidationPackage`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ConsolidationPackage
~~~


Binding: `lightbulb.finance_close_lifecycle.ConsolidationPackage` → `lightbulb.finance_close_lifecycle.ConsolidationPackage`.

Source: `lightbulb/finance_close_lifecycle.py:844`.

### `lightbulb.EliminationEntry`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import EliminationEntry
~~~


Binding: `lightbulb.finance_close_lifecycle.EliminationEntry` → `lightbulb.finance_close_lifecycle.EliminationEntry`.

Source: `lightbulb/finance_close_lifecycle.py:808`.

### `lightbulb.PeriodCloseJournalEntryLine`

class alias. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PeriodCloseJournalEntryLine
~~~


Binding: `lightbulb.finance_close_lifecycle.JournalEntryLine` → `lightbulb.finance_close_lifecycle.JournalEntryLine`.

Source: `lightbulb/finance_close_lifecycle.py:657`.

### `lightbulb.OpenPeriodPackage`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import OpenPeriodPackage
~~~


Binding: `lightbulb.finance_close_lifecycle.OpenPeriodPackage` → `lightbulb.finance_close_lifecycle.OpenPeriodPackage`.

Source: `lightbulb/finance_close_lifecycle.py:432`.

### `lightbulb.PeriodCloseEffectBoundary`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PeriodCloseEffectBoundary
~~~


Binding: `lightbulb.finance_close_lifecycle.PeriodCloseEffectBoundary` → `lightbulb.finance_close_lifecycle.PeriodCloseEffectBoundary`.

Source: `lightbulb/finance_close_lifecycle.py:1947`.

### `lightbulb.PeriodCloseLifecycleInput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PeriodCloseLifecycleInput
~~~


Binding: `lightbulb.finance_close_lifecycle.PeriodCloseLifecycleInput` → `lightbulb.finance_close_lifecycle.PeriodCloseLifecycleInput`.

Source: `lightbulb/finance_close_lifecycle.py:1929`.

### `lightbulb.PeriodCloseLifecycleResult`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PeriodCloseLifecycleResult
~~~


Binding: `lightbulb.finance_close_lifecycle.PeriodCloseLifecycleResult` → `lightbulb.finance_close_lifecycle.PeriodCloseLifecycleResult`.

Source: `lightbulb/finance_close_lifecycle.py:2029`.

### `lightbulb.PeriodCloseLifecycleSnapshot`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PeriodCloseLifecycleSnapshot
~~~


Binding: `lightbulb.finance_close_lifecycle.PeriodCloseLifecycleSnapshot` → `lightbulb.finance_close_lifecycle.PeriodCloseLifecycleSnapshot`.

Source: `lightbulb/finance_close_lifecycle.py:1850`.

### `lightbulb.PeriodCloseRecovery`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PeriodCloseRecovery
~~~


Binding: `lightbulb.finance_close_lifecycle.PeriodCloseRecovery` → `lightbulb.finance_close_lifecycle.PeriodCloseRecovery`.

Source: `lightbulb/finance_close_lifecycle.py:1961`.

### `lightbulb.PeriodCloseScope`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PeriodCloseScope
~~~


Binding: `lightbulb.finance_close_lifecycle.PeriodCloseScope` → `lightbulb.finance_close_lifecycle.PeriodCloseScope`.

Source: `lightbulb/finance_close_lifecycle.py:282`.

### `lightbulb.PeriodCloseTransitionCandidate`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PeriodCloseTransitionCandidate
~~~


Binding: `lightbulb.finance_close_lifecycle.PeriodCloseTransitionCandidate` → `lightbulb.finance_close_lifecycle.PeriodCloseTransitionCandidate`.

Source: `lightbulb/finance_close_lifecycle.py:1467`.

### `lightbulb.PeriodCloseTransitionCommand`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PeriodCloseTransitionCommand
~~~


Binding: `lightbulb.finance_close_lifecycle.PeriodCloseTransitionCommand` → `lightbulb.finance_close_lifecycle.PeriodCloseTransitionCommand`.

Source: `lightbulb/finance_close_lifecycle.py:1045`.

### `lightbulb.PeriodCloseTransitionReceipt`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PeriodCloseTransitionReceipt
~~~


Binding: `lightbulb.finance_close_lifecycle.PeriodCloseTransitionReceipt` → `lightbulb.finance_close_lifecycle.PeriodCloseTransitionReceipt`.

Source: `lightbulb/finance_close_lifecycle.py:1975`.

### `lightbulb.ProposePeriodCloseTransitionPrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProposePeriodCloseTransitionPrimitive
~~~


Binding: `lightbulb.finance_close_lifecycle.ProposePeriodCloseTransitionPrimitive` → `lightbulb.finance_close_lifecycle.ProposePeriodCloseTransitionPrimitive`.

Source: `lightbulb/finance_close_lifecycle.py:2375`.

### `lightbulb.ReconciliationPackage`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ReconciliationPackage
~~~


Binding: `lightbulb.finance_close_lifecycle.ReconciliationPackage` → `lightbulb.finance_close_lifecycle.ReconciliationPackage`.

Source: `lightbulb/finance_close_lifecycle.py:587`.

### `lightbulb.SubledgerLockPackage`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SubledgerLockPackage
~~~


Binding: `lightbulb.finance_close_lifecycle.SubledgerLockPackage` → `lightbulb.finance_close_lifecycle.SubledgerLockPackage`.

Source: `lightbulb/finance_close_lifecycle.py:777`.

### `lightbulb.SubledgerReconciliationRecord`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SubledgerReconciliationRecord
~~~


Binding: `lightbulb.finance_close_lifecycle.SubledgerReconciliationRecord` → `lightbulb.finance_close_lifecycle.SubledgerReconciliationRecord`.

Source: `lightbulb/finance_close_lifecycle.py:550`.

### `lightbulb.SubledgerScopeBinding`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SubledgerScopeBinding
~~~


Binding: `lightbulb.finance_close_lifecycle.SubledgerScopeBinding` → `lightbulb.finance_close_lifecycle.SubledgerScopeBinding`.

Source: `lightbulb/finance_close_lifecycle.py:277`.

### `lightbulb.TrialBalanceLine`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import TrialBalanceLine
~~~


Binding: `lightbulb.finance_close_lifecycle.TrialBalanceLine` → `lightbulb.finance_close_lifecycle.TrialBalanceLine`.

Source: `lightbulb/finance_close_lifecycle.py:455`.

### `lightbulb.TrialBalancePackage`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import TrialBalancePackage
~~~


Binding: `lightbulb.finance_close_lifecycle.TrialBalancePackage` → `lightbulb.finance_close_lifecycle.TrialBalancePackage`.

Source: `lightbulb/finance_close_lifecycle.py:472`.

### `lightbulb.materialize_period_close_candidate`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import materialize_period_close_candidate
~~~


Binding: `lightbulb.finance_close_lifecycle.materialize_period_close_candidate` → `lightbulb.finance_close_lifecycle.materialize_period_close_candidate`.

Source: `lightbulb/finance_close_lifecycle.py:2144`.

### `lightbulb.period_close_command_content_digest`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import period_close_command_content_digest
~~~


Binding: `lightbulb.finance_close_lifecycle.period_close_command_content_digest` → `lightbulb.finance_close_lifecycle.period_close_command_content_digest`.

Source: `lightbulb/finance_close_lifecycle.py:1402`.

### `lightbulb.period_close_command_digest`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import period_close_command_digest
~~~


Binding: `lightbulb.finance_close_lifecycle.period_close_command_digest` → `lightbulb.finance_close_lifecycle.period_close_command_digest`.

Source: `lightbulb/finance_close_lifecycle.py:1416`.

### `lightbulb.period_close_scope_digest`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import period_close_scope_digest
~~~


Binding: `lightbulb.finance_close_lifecycle.period_close_scope_digest` → `lightbulb.finance_close_lifecycle.period_close_scope_digest`.

Source: `lightbulb/finance_close_lifecycle.py:383`.

### `lightbulb.seal_period_close_command`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import seal_period_close_command
~~~


Binding: `lightbulb.finance_close_lifecycle.seal_period_close_command` → `lightbulb.finance_close_lifecycle.seal_period_close_command`.

Source: `lightbulb/finance_close_lifecycle.py:1426`.

### `lightbulb.CLOSE_APPROVAL_OBSERVATION_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CLOSE_APPROVAL_OBSERVATION_SCHEMA
~~~


Binding: `lightbulb.finance_close_approval_package.CLOSE_APPROVAL_OBSERVATION_SCHEMA` → `lightbulb.finance_close_approval_package.CLOSE_APPROVAL_OBSERVATION_SCHEMA`.

Source: `lightbulb/finance_close_approval_package.py:58`.

### `lightbulb.CLOSE_APPROVAL_PACKAGE_CANDIDATE_INPUT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CLOSE_APPROVAL_PACKAGE_CANDIDATE_INPUT_SCHEMA
~~~


Binding: `lightbulb.finance_close_approval_package.CLOSE_APPROVAL_PACKAGE_CANDIDATE_INPUT_SCHEMA` → `lightbulb.finance_close_approval_package.CLOSE_APPROVAL_PACKAGE_CANDIDATE_INPUT_SCHEMA`.

Source: `lightbulb/finance_close_approval_package.py:52`.

### `lightbulb.CLOSE_APPROVAL_PACKAGE_CANDIDATE_RESULT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CLOSE_APPROVAL_PACKAGE_CANDIDATE_RESULT_SCHEMA
~~~


Binding: `lightbulb.finance_close_approval_package.CLOSE_APPROVAL_PACKAGE_CANDIDATE_RESULT_SCHEMA` → `lightbulb.finance_close_approval_package.CLOSE_APPROVAL_PACKAGE_CANDIDATE_RESULT_SCHEMA`.

Source: `lightbulb/finance_close_approval_package.py:55`.

### `lightbulb.FINANCE_CLOSE_APPROVAL_PACKAGE_EXECUTABLE_PRIMITIVES`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import FINANCE_CLOSE_APPROVAL_PACKAGE_EXECUTABLE_PRIMITIVES
~~~


Binding: `lightbulb.finance_close_approval_package.FINANCE_CLOSE_APPROVAL_PACKAGE_EXECUTABLE_PRIMITIVES` → `lightbulb.finance_close_approval_package.FINANCE_CLOSE_APPROVAL_PACKAGE_EXECUTABLE_PRIMITIVES`.

Source: `lightbulb/finance_close_approval_package.py:608`.

### `lightbulb.CloseApprovalObservation`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CloseApprovalObservation
~~~


Binding: `lightbulb.finance_close_approval_package.CloseApprovalObservation` → `lightbulb.finance_close_approval_package.CloseApprovalObservation`.

Source: `lightbulb/finance_close_approval_package.py:177`.

### `lightbulb.CloseApprovalPackageCandidateResult`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CloseApprovalPackageCandidateResult
~~~


Binding: `lightbulb.finance_close_approval_package.CloseApprovalPackageCandidateResult` → `lightbulb.finance_close_approval_package.CloseApprovalPackageCandidateResult`.

Source: `lightbulb/finance_close_approval_package.py:322`.

### `lightbulb.PrepareCloseApprovalPackageInput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PrepareCloseApprovalPackageInput
~~~


Binding: `lightbulb.finance_close_approval_package.PrepareCloseApprovalPackageInput` → `lightbulb.finance_close_approval_package.PrepareCloseApprovalPackageInput`.

Source: `lightbulb/finance_close_approval_package.py:212`.

### `lightbulb.PrepareCloseApprovalPackagePrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PrepareCloseApprovalPackagePrimitive
~~~


Binding: `lightbulb.finance_close_approval_package.PrepareCloseApprovalPackagePrimitive` → `lightbulb.finance_close_approval_package.PrepareCloseApprovalPackagePrimitive`.

Source: `lightbulb/finance_close_approval_package.py:494`.

### `lightbulb.close_approval_request_digest`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import close_approval_request_digest
~~~


Binding: `lightbulb.finance_close_approval_package.close_approval_request_digest` → `lightbulb.finance_close_approval_package.close_approval_request_digest`.

Source: `lightbulb/finance_close_approval_package.py:145`.

### `lightbulb.prepare_close_approval_package`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import prepare_close_approval_package
~~~


Binding: `lightbulb.finance_close_approval_package.prepare_close_approval_package` → `lightbulb.finance_close_approval_package.prepare_close_approval_package`.

Source: `lightbulb/finance_close_approval_package.py:381`.

### `lightbulb.FINANCE_CLOSE_AUDIT_PACKET_EXECUTABLE_PRIMITIVES`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import FINANCE_CLOSE_AUDIT_PACKET_EXECUTABLE_PRIMITIVES
~~~


Binding: `lightbulb.finance_close_audit_packet.FINANCE_CLOSE_AUDIT_PACKET_EXECUTABLE_PRIMITIVES` → `lightbulb.finance_close_audit_packet.FINANCE_CLOSE_AUDIT_PACKET_EXECUTABLE_PRIMITIVES`.

Source: `lightbulb/finance_close_audit_packet.py:790`.

### `lightbulb.FINANCE_CLOSE_AUDIT_PACKET_INPUT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import FINANCE_CLOSE_AUDIT_PACKET_INPUT_SCHEMA
~~~


Binding: `lightbulb.finance_close_audit_packet.FINANCE_CLOSE_AUDIT_PACKET_INPUT_SCHEMA` → `lightbulb.finance_close_audit_packet.FINANCE_CLOSE_AUDIT_PACKET_INPUT_SCHEMA`.

Source: `lightbulb/finance_close_audit_packet.py:53`.

### `lightbulb.FINANCE_CLOSE_AUDIT_PACKET_RESULT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import FINANCE_CLOSE_AUDIT_PACKET_RESULT_SCHEMA
~~~


Binding: `lightbulb.finance_close_audit_packet.FINANCE_CLOSE_AUDIT_PACKET_RESULT_SCHEMA` → `lightbulb.finance_close_audit_packet.FINANCE_CLOSE_AUDIT_PACKET_RESULT_SCHEMA`.

Source: `lightbulb/finance_close_audit_packet.py:56`.

### `lightbulb.FINANCE_CLOSE_EXECUTION_OBSERVATION_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import FINANCE_CLOSE_EXECUTION_OBSERVATION_SCHEMA
~~~


Binding: `lightbulb.finance_close_audit_packet.FINANCE_CLOSE_EXECUTION_OBSERVATION_SCHEMA` → `lightbulb.finance_close_audit_packet.FINANCE_CLOSE_EXECUTION_OBSERVATION_SCHEMA`.

Source: `lightbulb/finance_close_audit_packet.py:59`.

### `lightbulb.BuildFinanceCloseAuditPacketPrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import BuildFinanceCloseAuditPacketPrimitive
~~~


Binding: `lightbulb.finance_close_audit_packet.BuildFinanceCloseAuditPacketPrimitive` → `lightbulb.finance_close_audit_packet.BuildFinanceCloseAuditPacketPrimitive`.

Source: `lightbulb/finance_close_audit_packet.py:679`.

### `lightbulb.FinanceCloseAuditPacketInput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import FinanceCloseAuditPacketInput
~~~


Binding: `lightbulb.finance_close_audit_packet.FinanceCloseAuditPacketInput` → `lightbulb.finance_close_audit_packet.FinanceCloseAuditPacketInput`.

Source: `lightbulb/finance_close_audit_packet.py:224`.

### `lightbulb.FinanceCloseAuditPacketResult`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import FinanceCloseAuditPacketResult
~~~


Binding: `lightbulb.finance_close_audit_packet.FinanceCloseAuditPacketResult` → `lightbulb.finance_close_audit_packet.FinanceCloseAuditPacketResult`.

Source: `lightbulb/finance_close_audit_packet.py:428`.

### `lightbulb.FinanceCloseExecutionObservation`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import FinanceCloseExecutionObservation
~~~


Binding: `lightbulb.finance_close_audit_packet.FinanceCloseExecutionObservation` → `lightbulb.finance_close_audit_packet.FinanceCloseExecutionObservation`.

Source: `lightbulb/finance_close_audit_packet.py:175`.

### `lightbulb.FinanceCloseOutcomeSummary`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import FinanceCloseOutcomeSummary
~~~


Binding: `lightbulb.finance_close_audit_packet.FinanceCloseOutcomeSummary` → `lightbulb.finance_close_audit_packet.FinanceCloseOutcomeSummary`.

Source: `lightbulb/finance_close_audit_packet.py:404`.

### `lightbulb.FinanceCloseTransitionAuditRecord`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import FinanceCloseTransitionAuditRecord
~~~


Binding: `lightbulb.finance_close_audit_packet.FinanceCloseTransitionAuditRecord` → `lightbulb.finance_close_audit_packet.FinanceCloseTransitionAuditRecord`.

Source: `lightbulb/finance_close_audit_packet.py:387`.

### `lightbulb.build_finance_close_audit_packet`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import build_finance_close_audit_packet
~~~


Binding: `lightbulb.finance_close_audit_packet.build_finance_close_audit_packet` → `lightbulb.finance_close_audit_packet.build_finance_close_audit_packet`.

Source: `lightbulb/finance_close_audit_packet.py:537`.

### `lightbulb.CLOSE_APPROVAL_TRANSITION_COMMAND_INPUT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CLOSE_APPROVAL_TRANSITION_COMMAND_INPUT_SCHEMA
~~~


Binding: `lightbulb.finance_close_approval_transition.CLOSE_APPROVAL_TRANSITION_COMMAND_INPUT_SCHEMA` → `lightbulb.finance_close_approval_transition.CLOSE_APPROVAL_TRANSITION_COMMAND_INPUT_SCHEMA`.

Source: `lightbulb/finance_close_approval_transition.py:58`.

### `lightbulb.CLOSE_APPROVAL_TRANSITION_COMMAND_RESULT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CLOSE_APPROVAL_TRANSITION_COMMAND_RESULT_SCHEMA
~~~


Binding: `lightbulb.finance_close_approval_transition.CLOSE_APPROVAL_TRANSITION_COMMAND_RESULT_SCHEMA` → `lightbulb.finance_close_approval_transition.CLOSE_APPROVAL_TRANSITION_COMMAND_RESULT_SCHEMA`.

Source: `lightbulb/finance_close_approval_transition.py:61`.

### `lightbulb.FINANCE_CLOSE_APPROVAL_TRANSITION_EXECUTABLE_PRIMITIVES`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import FINANCE_CLOSE_APPROVAL_TRANSITION_EXECUTABLE_PRIMITIVES
~~~


Binding: `lightbulb.finance_close_approval_transition.FINANCE_CLOSE_APPROVAL_TRANSITION_EXECUTABLE_PRIMITIVES` → `lightbulb.finance_close_approval_transition.FINANCE_CLOSE_APPROVAL_TRANSITION_EXECUTABLE_PRIMITIVES`.

Source: `lightbulb/finance_close_approval_transition.py:688`.

### `lightbulb.CloseApprovalTransitionCommandResult`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CloseApprovalTransitionCommandResult
~~~


Binding: `lightbulb.finance_close_approval_transition.CloseApprovalTransitionCommandResult` → `lightbulb.finance_close_approval_transition.CloseApprovalTransitionCommandResult`.

Source: `lightbulb/finance_close_approval_transition.py:346`.

### `lightbulb.CloseReviewWorkpaperEvidenceClaim`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CloseReviewWorkpaperEvidenceClaim
~~~


Binding: `lightbulb.finance_close_approval_transition.CloseReviewWorkpaperEvidenceClaim` → `lightbulb.finance_close_approval_transition.CloseReviewWorkpaperEvidenceClaim`.

Source: `lightbulb/finance_close_approval_transition.py:127`.

### `lightbulb.PrepareCloseApprovalTransitionCommandInput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PrepareCloseApprovalTransitionCommandInput
~~~


Binding: `lightbulb.finance_close_approval_transition.PrepareCloseApprovalTransitionCommandInput` → `lightbulb.finance_close_approval_transition.PrepareCloseApprovalTransitionCommandInput`.

Source: `lightbulb/finance_close_approval_transition.py:190`.

### `lightbulb.PrepareCloseApprovalTransitionCommandPrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PrepareCloseApprovalTransitionCommandPrimitive
~~~


Binding: `lightbulb.finance_close_approval_transition.PrepareCloseApprovalTransitionCommandPrimitive` → `lightbulb.finance_close_approval_transition.PrepareCloseApprovalTransitionCommandPrimitive`.

Source: `lightbulb/finance_close_approval_transition.py:564`.

### `lightbulb.SpringCloseApprovalEvidenceClaim`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SpringCloseApprovalEvidenceClaim
~~~


Binding: `lightbulb.finance_close_approval_transition.SpringCloseApprovalEvidenceClaim` → `lightbulb.finance_close_approval_transition.SpringCloseApprovalEvidenceClaim`.

Source: `lightbulb/finance_close_approval_transition.py:146`.

### `lightbulb.prepare_close_approval_transition_command`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import prepare_close_approval_transition_command
~~~


Binding: `lightbulb.finance_close_approval_transition.prepare_close_approval_transition_command` → `lightbulb.finance_close_approval_transition.prepare_close_approval_transition_command`.

Source: `lightbulb/finance_close_approval_transition.py:465`.

### `lightbulb.CLOSE_PERIOD_PACKAGE_CANDIDATE_INPUT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CLOSE_PERIOD_PACKAGE_CANDIDATE_INPUT_SCHEMA
~~~


Binding: `lightbulb.finance_close_period_package.CLOSE_PERIOD_PACKAGE_CANDIDATE_INPUT_SCHEMA` → `lightbulb.finance_close_period_package.CLOSE_PERIOD_PACKAGE_CANDIDATE_INPUT_SCHEMA`.

Source: `lightbulb/finance_close_period_package.py:59`.

### `lightbulb.CLOSE_PERIOD_PACKAGE_CANDIDATE_RESULT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CLOSE_PERIOD_PACKAGE_CANDIDATE_RESULT_SCHEMA
~~~


Binding: `lightbulb.finance_close_period_package.CLOSE_PERIOD_PACKAGE_CANDIDATE_RESULT_SCHEMA` → `lightbulb.finance_close_period_package.CLOSE_PERIOD_PACKAGE_CANDIDATE_RESULT_SCHEMA`.

Source: `lightbulb/finance_close_period_package.py:62`.

### `lightbulb.CLOSE_READINESS_OBSERVATION_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CLOSE_READINESS_OBSERVATION_SCHEMA
~~~


Binding: `lightbulb.finance_close_period_package.CLOSE_READINESS_OBSERVATION_SCHEMA` → `lightbulb.finance_close_period_package.CLOSE_READINESS_OBSERVATION_SCHEMA`.

Source: `lightbulb/finance_close_period_package.py:65`.

### `lightbulb.FINANCE_CLOSE_PERIOD_PACKAGE_EXECUTABLE_PRIMITIVES`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import FINANCE_CLOSE_PERIOD_PACKAGE_EXECUTABLE_PRIMITIVES
~~~


Binding: `lightbulb.finance_close_period_package.FINANCE_CLOSE_PERIOD_PACKAGE_EXECUTABLE_PRIMITIVES` → `lightbulb.finance_close_period_package.FINANCE_CLOSE_PERIOD_PACKAGE_EXECUTABLE_PRIMITIVES`.

Source: `lightbulb/finance_close_period_package.py:842`.

### `lightbulb.ClosePeriodPackageCandidateResult`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ClosePeriodPackageCandidateResult
~~~


Binding: `lightbulb.finance_close_period_package.ClosePeriodPackageCandidateResult` → `lightbulb.finance_close_period_package.ClosePeriodPackageCandidateResult`.

Source: `lightbulb/finance_close_period_package.py:421`.

### `lightbulb.CloseReadinessObservation`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CloseReadinessObservation
~~~


Binding: `lightbulb.finance_close_period_package.CloseReadinessObservation` → `lightbulb.finance_close_period_package.CloseReadinessObservation`.

Source: `lightbulb/finance_close_period_package.py:162`.

### `lightbulb.PrepareClosePeriodPackageInput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PrepareClosePeriodPackageInput
~~~


Binding: `lightbulb.finance_close_period_package.PrepareClosePeriodPackageInput` → `lightbulb.finance_close_period_package.PrepareClosePeriodPackageInput`.

Source: `lightbulb/finance_close_period_package.py:200`.

### `lightbulb.PrepareClosePeriodPackagePrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PrepareClosePeriodPackagePrimitive
~~~


Binding: `lightbulb.finance_close_period_package.PrepareClosePeriodPackagePrimitive` → `lightbulb.finance_close_period_package.PrepareClosePeriodPackagePrimitive`.

Source: `lightbulb/finance_close_period_package.py:723`.

### `lightbulb.close_period_request_digest`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import close_period_request_digest
~~~


Binding: `lightbulb.finance_close_period_package.close_period_request_digest` → `lightbulb.finance_close_period_package.close_period_request_digest`.

Source: `lightbulb/finance_close_period_package.py:127`.

### `lightbulb.prepare_close_period_package`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import prepare_close_period_package
~~~


Binding: `lightbulb.finance_close_period_package.prepare_close_period_package` → `lightbulb.finance_close_period_package.prepare_close_period_package`.

Source: `lightbulb/finance_close_period_package.py:486`.

### `lightbulb.CLOSE_PERIOD_TRANSITION_COMMAND_INPUT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CLOSE_PERIOD_TRANSITION_COMMAND_INPUT_SCHEMA
~~~


Binding: `lightbulb.finance_close_period_transition.CLOSE_PERIOD_TRANSITION_COMMAND_INPUT_SCHEMA` → `lightbulb.finance_close_period_transition.CLOSE_PERIOD_TRANSITION_COMMAND_INPUT_SCHEMA`.

Source: `lightbulb/finance_close_period_transition.py:59`.

### `lightbulb.CLOSE_PERIOD_TRANSITION_COMMAND_RESULT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CLOSE_PERIOD_TRANSITION_COMMAND_RESULT_SCHEMA
~~~


Binding: `lightbulb.finance_close_period_transition.CLOSE_PERIOD_TRANSITION_COMMAND_RESULT_SCHEMA` → `lightbulb.finance_close_period_transition.CLOSE_PERIOD_TRANSITION_COMMAND_RESULT_SCHEMA`.

Source: `lightbulb/finance_close_period_transition.py:62`.

### `lightbulb.FINANCE_CLOSE_PERIOD_TRANSITION_EXECUTABLE_PRIMITIVES`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import FINANCE_CLOSE_PERIOD_TRANSITION_EXECUTABLE_PRIMITIVES
~~~


Binding: `lightbulb.finance_close_period_transition.FINANCE_CLOSE_PERIOD_TRANSITION_EXECUTABLE_PRIMITIVES` → `lightbulb.finance_close_period_transition.FINANCE_CLOSE_PERIOD_TRANSITION_EXECUTABLE_PRIMITIVES`.

Source: `lightbulb/finance_close_period_transition.py:687`.

### `lightbulb.ClosePeriodTransitionCommandResult`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ClosePeriodTransitionCommandResult
~~~


Binding: `lightbulb.finance_close_period_transition.ClosePeriodTransitionCommandResult` → `lightbulb.finance_close_period_transition.ClosePeriodTransitionCommandResult`.

Source: `lightbulb/finance_close_period_transition.py:346`.

### `lightbulb.CloseRequestEvidenceClaim`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CloseRequestEvidenceClaim
~~~


Binding: `lightbulb.finance_close_period_transition.CloseRequestEvidenceClaim` → `lightbulb.finance_close_period_transition.CloseRequestEvidenceClaim`.

Source: `lightbulb/finance_close_period_transition.py:128`.

### `lightbulb.PrepareClosePeriodTransitionCommandInput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PrepareClosePeriodTransitionCommandInput
~~~


Binding: `lightbulb.finance_close_period_transition.PrepareClosePeriodTransitionCommandInput` → `lightbulb.finance_close_period_transition.PrepareClosePeriodTransitionCommandInput`.

Source: `lightbulb/finance_close_period_transition.py:191`.

### `lightbulb.PrepareClosePeriodTransitionCommandPrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PrepareClosePeriodTransitionCommandPrimitive
~~~


Binding: `lightbulb.finance_close_period_transition.PrepareClosePeriodTransitionCommandPrimitive` → `lightbulb.finance_close_period_transition.PrepareClosePeriodTransitionCommandPrimitive`.

Source: `lightbulb/finance_close_period_transition.py:564`.

### `lightbulb.SpringCloseReadinessEvidenceClaim`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SpringCloseReadinessEvidenceClaim
~~~


Binding: `lightbulb.finance_close_period_transition.SpringCloseReadinessEvidenceClaim` → `lightbulb.finance_close_period_transition.SpringCloseReadinessEvidenceClaim`.

Source: `lightbulb/finance_close_period_transition.py:147`.

### `lightbulb.prepare_close_period_transition_command`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import prepare_close_period_transition_command
~~~


Binding: `lightbulb.finance_close_period_transition.prepare_close_period_transition_command` → `lightbulb.finance_close_period_transition.prepare_close_period_transition_command`.

Source: `lightbulb/finance_close_period_transition.py:465`.

### `lightbulb.FINANCE_CLOSE_EVIDENCE_BUNDLE_EXECUTABLE_PRIMITIVES`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import FINANCE_CLOSE_EVIDENCE_BUNDLE_EXECUTABLE_PRIMITIVES
~~~


Binding: `lightbulb.finance_close_evidence_bundle.FINANCE_CLOSE_EVIDENCE_BUNDLE_EXECUTABLE_PRIMITIVES` → `lightbulb.finance_close_evidence_bundle.FINANCE_CLOSE_EVIDENCE_BUNDLE_EXECUTABLE_PRIMITIVES`.

Source: `lightbulb/finance_close_evidence_bundle.py:665`.

### `lightbulb.FINANCE_CLOSE_EVIDENCE_BUNDLE_INPUT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import FINANCE_CLOSE_EVIDENCE_BUNDLE_INPUT_SCHEMA
~~~


Binding: `lightbulb.finance_close_evidence_bundle.FINANCE_CLOSE_EVIDENCE_BUNDLE_INPUT_SCHEMA` → `lightbulb.finance_close_evidence_bundle.FINANCE_CLOSE_EVIDENCE_BUNDLE_INPUT_SCHEMA`.

Source: `lightbulb/finance_close_evidence_bundle.py:58`.

### `lightbulb.FINANCE_CLOSE_EVIDENCE_BUNDLE_RESULT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import FINANCE_CLOSE_EVIDENCE_BUNDLE_RESULT_SCHEMA
~~~


Binding: `lightbulb.finance_close_evidence_bundle.FINANCE_CLOSE_EVIDENCE_BUNDLE_RESULT_SCHEMA` → `lightbulb.finance_close_evidence_bundle.FINANCE_CLOSE_EVIDENCE_BUNDLE_RESULT_SCHEMA`.

Source: `lightbulb/finance_close_evidence_bundle.py:62`.

### `lightbulb.FINANCE_CLOSE_EVIDENCE_BUNDLE_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import FINANCE_CLOSE_EVIDENCE_BUNDLE_SCHEMA
~~~


Binding: `lightbulb.finance_close_evidence_bundle.FINANCE_CLOSE_EVIDENCE_BUNDLE_SCHEMA` → `lightbulb.finance_close_evidence_bundle.FINANCE_CLOSE_EVIDENCE_BUNDLE_SCHEMA`.

Source: `lightbulb/finance_close_evidence_bundle.py:61`.

### `lightbulb.CloseEvidenceControlCode`

value. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CloseEvidenceControlCode
~~~


Binding: `lightbulb.finance_close_evidence_bundle.CloseEvidenceControlCode` → `lightbulb.finance_close_evidence_bundle.CloseEvidenceControlCode`.

Source: `lightbulb/finance_close_evidence_bundle.py:75`.

### `lightbulb.CloseEvidenceReadiness`

value. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CloseEvidenceReadiness
~~~


Binding: `lightbulb.finance_close_evidence_bundle.CloseEvidenceReadiness` → `lightbulb.finance_close_evidence_bundle.CloseEvidenceReadiness`.

Source: `lightbulb/finance_close_evidence_bundle.py:70`.

### `lightbulb.CloseSourceTransactionEvidence`

value. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CloseSourceTransactionEvidence
~~~


Binding: `lightbulb.finance_close_evidence_bundle.CloseSourceTransactionEvidence` → `lightbulb.finance_close_evidence_bundle.CloseSourceTransactionEvidence`.

Source: `lightbulb/finance_close_evidence_bundle.py:79`.

### `lightbulb.FinanceCloseEvidenceBundle`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import FinanceCloseEvidenceBundle
~~~


Binding: `lightbulb.finance_close_evidence_bundle.FinanceCloseEvidenceBundle` → `lightbulb.finance_close_evidence_bundle.FinanceCloseEvidenceBundle`.

Source: `lightbulb/finance_close_evidence_bundle.py:288`.

### `lightbulb.FinanceCloseEvidenceBundleInput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import FinanceCloseEvidenceBundleInput
~~~


Binding: `lightbulb.finance_close_evidence_bundle.FinanceCloseEvidenceBundleInput` → `lightbulb.finance_close_evidence_bundle.FinanceCloseEvidenceBundleInput`.

Source: `lightbulb/finance_close_evidence_bundle.py:145`.

### `lightbulb.FinanceCloseEvidenceBundleResult`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import FinanceCloseEvidenceBundleResult
~~~


Binding: `lightbulb.finance_close_evidence_bundle.FinanceCloseEvidenceBundleResult` → `lightbulb.finance_close_evidence_bundle.FinanceCloseEvidenceBundleResult`.

Source: `lightbulb/finance_close_evidence_bundle.py:375`.

### `lightbulb.PrepareCloseEvidenceBundlePrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PrepareCloseEvidenceBundlePrimitive
~~~


Binding: `lightbulb.finance_close_evidence_bundle.PrepareCloseEvidenceBundlePrimitive` → `lightbulb.finance_close_evidence_bundle.PrepareCloseEvidenceBundlePrimitive`.

Source: `lightbulb/finance_close_evidence_bundle.py:541`.

### `lightbulb.prepare_close_evidence_bundle`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import prepare_close_evidence_bundle
~~~


Binding: `lightbulb.finance_close_evidence_bundle.prepare_close_evidence_bundle` → `lightbulb.finance_close_evidence_bundle.prepare_close_evidence_bundle`.

Source: `lightbulb/finance_close_evidence_bundle.py:396`.

### `lightbulb.FINANCE_CLOSE_WORKSPACE_EXECUTABLE_PRIMITIVES`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import FINANCE_CLOSE_WORKSPACE_EXECUTABLE_PRIMITIVES
~~~


Binding: `lightbulb.finance_close_workspace.FINANCE_CLOSE_WORKSPACE_EXECUTABLE_PRIMITIVES` → `lightbulb.finance_close_workspace.FINANCE_CLOSE_WORKSPACE_EXECUTABLE_PRIMITIVES`.

Source: `lightbulb/finance_close_workspace.py:736`.

### `lightbulb.FINANCE_CLOSE_WORKSPACE_INPUT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import FINANCE_CLOSE_WORKSPACE_INPUT_SCHEMA
~~~


Binding: `lightbulb.finance_close_workspace.FINANCE_CLOSE_WORKSPACE_INPUT_SCHEMA` → `lightbulb.finance_close_workspace.FINANCE_CLOSE_WORKSPACE_INPUT_SCHEMA`.

Source: `lightbulb/finance_close_workspace.py:55`.

### `lightbulb.FINANCE_CLOSE_WORKSPACE_RESULT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import FINANCE_CLOSE_WORKSPACE_RESULT_SCHEMA
~~~


Binding: `lightbulb.finance_close_workspace.FINANCE_CLOSE_WORKSPACE_RESULT_SCHEMA` → `lightbulb.finance_close_workspace.FINANCE_CLOSE_WORKSPACE_RESULT_SCHEMA`.

Source: `lightbulb/finance_close_workspace.py:57`.

### `lightbulb.FINANCE_CLOSE_WORKSPACE_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import FINANCE_CLOSE_WORKSPACE_SCHEMA
~~~


Binding: `lightbulb.finance_close_workspace.FINANCE_CLOSE_WORKSPACE_SCHEMA` → `lightbulb.finance_close_workspace.FINANCE_CLOSE_WORKSPACE_SCHEMA`.

Source: `lightbulb/finance_close_workspace.py:56`.

### `lightbulb.CloseWorkspaceStage`

value. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CloseWorkspaceStage
~~~


Binding: `lightbulb.finance_close_workspace.CloseWorkspaceStage` → `lightbulb.finance_close_workspace.CloseWorkspaceStage`.

Source: `lightbulb/finance_close_workspace.py:63`.

### `lightbulb.CloseWorkspaceTaskStatus`

value. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CloseWorkspaceTaskStatus
~~~


Binding: `lightbulb.finance_close_workspace.CloseWorkspaceTaskStatus` → `lightbulb.finance_close_workspace.CloseWorkspaceTaskStatus`.

Source: `lightbulb/finance_close_workspace.py:75`.

### `lightbulb.FinanceCloseChecklistItem`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import FinanceCloseChecklistItem
~~~


Binding: `lightbulb.finance_close_workspace.FinanceCloseChecklistItem` → `lightbulb.finance_close_workspace.FinanceCloseChecklistItem`.

Source: `lightbulb/finance_close_workspace.py:343`.

### `lightbulb.FinanceCloseWorkspace`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import FinanceCloseWorkspace
~~~


Binding: `lightbulb.finance_close_workspace.FinanceCloseWorkspace` → `lightbulb.finance_close_workspace.FinanceCloseWorkspace`.

Source: `lightbulb/finance_close_workspace.py:358`.

### `lightbulb.FinanceCloseWorkspaceInput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import FinanceCloseWorkspaceInput
~~~


Binding: `lightbulb.finance_close_workspace.FinanceCloseWorkspaceInput` → `lightbulb.finance_close_workspace.FinanceCloseWorkspaceInput`.

Source: `lightbulb/finance_close_workspace.py:147`.

### `lightbulb.FinanceCloseWorkspaceResult`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import FinanceCloseWorkspaceResult
~~~


Binding: `lightbulb.finance_close_workspace.FinanceCloseWorkspaceResult` → `lightbulb.finance_close_workspace.FinanceCloseWorkspaceResult`.

Source: `lightbulb/finance_close_workspace.py:440`.

### `lightbulb.PrepareCloseWorkspacePrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PrepareCloseWorkspacePrimitive
~~~


Binding: `lightbulb.finance_close_workspace.PrepareCloseWorkspacePrimitive` → `lightbulb.finance_close_workspace.PrepareCloseWorkspacePrimitive`.

Source: `lightbulb/finance_close_workspace.py:609`.

### `lightbulb.prepare_close_workspace`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import prepare_close_workspace
~~~


Binding: `lightbulb.finance_close_workspace.prepare_close_workspace` → `lightbulb.finance_close_workspace.prepare_close_workspace`.

Source: `lightbulb/finance_close_workspace.py:484`.

### `lightbulb.CANONICAL_LEDGER_ACCOUNT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CANONICAL_LEDGER_ACCOUNT_SCHEMA
~~~


Binding: `lightbulb.finance_source_records.CANONICAL_LEDGER_ACCOUNT_SCHEMA` → `lightbulb.finance_source_records.CANONICAL_LEDGER_ACCOUNT_SCHEMA`.

Source: `lightbulb/finance_source_records.py:40`.

### `lightbulb.CANONICAL_LEDGER_SNAPSHOT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CANONICAL_LEDGER_SNAPSHOT_SCHEMA
~~~


Binding: `lightbulb.finance_source_records.CANONICAL_LEDGER_SNAPSHOT_SCHEMA` → `lightbulb.finance_source_records.CANONICAL_LEDGER_SNAPSHOT_SCHEMA`.

Source: `lightbulb/finance_source_records.py:42`.

### `lightbulb.CANONICAL_TRIAL_BALANCE_LINE_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CANONICAL_TRIAL_BALANCE_LINE_SCHEMA
~~~


Binding: `lightbulb.finance_source_records.CANONICAL_TRIAL_BALANCE_LINE_SCHEMA` → `lightbulb.finance_source_records.CANONICAL_TRIAL_BALANCE_LINE_SCHEMA`.

Source: `lightbulb/finance_source_records.py:41`.

### `lightbulb.FINANCE_LEDGER_SCOPE_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import FINANCE_LEDGER_SCOPE_SCHEMA
~~~


Binding: `lightbulb.finance_source_records.FINANCE_LEDGER_SCOPE_SCHEMA` → `lightbulb.finance_source_records.FINANCE_LEDGER_SCOPE_SCHEMA`.

Source: `lightbulb/finance_source_records.py:35`.

### `lightbulb.FINANCE_OBSERVATION_ENVELOPE_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import FINANCE_OBSERVATION_ENVELOPE_SCHEMA
~~~


Binding: `lightbulb.finance_source_records.FINANCE_OBSERVATION_ENVELOPE_SCHEMA` → `lightbulb.finance_source_records.FINANCE_OBSERVATION_ENVELOPE_SCHEMA`.

Source: `lightbulb/finance_source_records.py:39`.

### `lightbulb.FINANCE_SOURCE_CHECKPOINT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import FINANCE_SOURCE_CHECKPOINT_SCHEMA
~~~


Binding: `lightbulb.finance_source_records.FINANCE_SOURCE_CHECKPOINT_SCHEMA` → `lightbulb.finance_source_records.FINANCE_SOURCE_CHECKPOINT_SCHEMA`.

Source: `lightbulb/finance_source_records.py:37`.

### `lightbulb.FINANCE_SOURCE_IDENTITY_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import FINANCE_SOURCE_IDENTITY_SCHEMA
~~~


Binding: `lightbulb.finance_source_records.FINANCE_SOURCE_IDENTITY_SCHEMA` → `lightbulb.finance_source_records.FINANCE_SOURCE_IDENTITY_SCHEMA`.

Source: `lightbulb/finance_source_records.py:36`.

### `lightbulb.FINANCE_SOURCE_PAGE_EVIDENCE_KIND`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import FINANCE_SOURCE_PAGE_EVIDENCE_KIND
~~~


Binding: `lightbulb.finance_source_records.FINANCE_SOURCE_PAGE_EVIDENCE_KIND` → `lightbulb.finance_source_records.FINANCE_SOURCE_PAGE_EVIDENCE_KIND`.

Source: `lightbulb/finance_source_records.py:38`.

### `lightbulb.CanonicalLedgerAccount`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CanonicalLedgerAccount
~~~


Binding: `lightbulb.finance_source_records.CanonicalLedgerAccount` → `lightbulb.finance_source_records.CanonicalLedgerAccount`.

Source: `lightbulb/finance_source_records.py:509`.

### `lightbulb.CanonicalLedgerSnapshot`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CanonicalLedgerSnapshot
~~~


Binding: `lightbulb.finance_source_records.CanonicalLedgerSnapshot` → `lightbulb.finance_source_records.CanonicalLedgerSnapshot`.

Source: `lightbulb/finance_source_records.py:544`.

### `lightbulb.CanonicalTrialBalanceLine`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CanonicalTrialBalanceLine
~~~


Binding: `lightbulb.finance_source_records.CanonicalTrialBalanceLine` → `lightbulb.finance_source_records.CanonicalTrialBalanceLine`.

Source: `lightbulb/finance_source_records.py:524`.

### `lightbulb.FinanceLedgerScope`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import FinanceLedgerScope
~~~


Binding: `lightbulb.finance_source_records.FinanceLedgerScope` → `lightbulb.finance_source_records.FinanceLedgerScope`.

Source: `lightbulb/finance_source_records.py:260`.

### `lightbulb.FinanceObservationEnvelope`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import FinanceObservationEnvelope
~~~


Binding: `lightbulb.finance_source_records.FinanceObservationEnvelope` → `lightbulb.finance_source_records.FinanceObservationEnvelope`.

Source: `lightbulb/finance_source_records.py:371`.

### `lightbulb.FinanceSourceCheckpoint`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import FinanceSourceCheckpoint
~~~


Binding: `lightbulb.finance_source_records.FinanceSourceCheckpoint` → `lightbulb.finance_source_records.FinanceSourceCheckpoint`.

Source: `lightbulb/finance_source_records.py:324`.

### `lightbulb.FinanceSourceIdentity`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import FinanceSourceIdentity
~~~


Binding: `lightbulb.finance_source_records.FinanceSourceIdentity` → `lightbulb.finance_source_records.FinanceSourceIdentity`.

Source: `lightbulb/finance_source_records.py:300`.

### `lightbulb.finance_canonical_digest`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import finance_canonical_digest
~~~


Binding: `lightbulb.finance_source_records.finance_canonical_digest` → `lightbulb.finance_source_records.finance_canonical_digest`.

Source: `lightbulb/finance_source_records.py:154`.

### `lightbulb.finance_canonical_json`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import finance_canonical_json
~~~


Binding: `lightbulb.finance_source_records.finance_canonical_json` → `lightbulb.finance_source_records.finance_canonical_json`.

Source: `lightbulb/finance_source_records.py:142`.

### `lightbulb.FINANCE_LEDGER_MATERIALIZATION_EXECUTABLE_PRIMITIVES`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import FINANCE_LEDGER_MATERIALIZATION_EXECUTABLE_PRIMITIVES
~~~


Binding: `lightbulb.finance_ledger_materialization.FINANCE_LEDGER_MATERIALIZATION_EXECUTABLE_PRIMITIVES` → `lightbulb.finance_ledger_materialization.FINANCE_LEDGER_MATERIALIZATION_EXECUTABLE_PRIMITIVES`.

Source: `lightbulb/finance_ledger_materialization.py:718`.

### `lightbulb.LEDGER_SNAPSHOT_MATERIALIZATION_INPUT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import LEDGER_SNAPSHOT_MATERIALIZATION_INPUT_SCHEMA
~~~


Binding: `lightbulb.finance_ledger_materialization.LEDGER_SNAPSHOT_MATERIALIZATION_INPUT_SCHEMA` → `lightbulb.finance_ledger_materialization.LEDGER_SNAPSHOT_MATERIALIZATION_INPUT_SCHEMA`.

Source: `lightbulb/finance_ledger_materialization.py:46`.

### `lightbulb.LEDGER_SNAPSHOT_MATERIALIZATION_RESULT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import LEDGER_SNAPSHOT_MATERIALIZATION_RESULT_SCHEMA
~~~


Binding: `lightbulb.finance_ledger_materialization.LEDGER_SNAPSHOT_MATERIALIZATION_RESULT_SCHEMA` → `lightbulb.finance_ledger_materialization.LEDGER_SNAPSHOT_MATERIALIZATION_RESULT_SCHEMA`.

Source: `lightbulb/finance_ledger_materialization.py:49`.

### `lightbulb.LedgerSnapshotMaterializationInput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import LedgerSnapshotMaterializationInput
~~~


Binding: `lightbulb.finance_ledger_materialization.LedgerSnapshotMaterializationInput` → `lightbulb.finance_ledger_materialization.LedgerSnapshotMaterializationInput`.

Source: `lightbulb/finance_ledger_materialization.py:69`.

### `lightbulb.LedgerSnapshotMaterializationResult`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import LedgerSnapshotMaterializationResult
~~~


Binding: `lightbulb.finance_ledger_materialization.LedgerSnapshotMaterializationResult` → `lightbulb.finance_ledger_materialization.LedgerSnapshotMaterializationResult`.

Source: `lightbulb/finance_ledger_materialization.py:102`.

### `lightbulb.MaterializeLedgerSnapshotPrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import MaterializeLedgerSnapshotPrimitive
~~~


Binding: `lightbulb.finance_ledger_materialization.MaterializeLedgerSnapshotPrimitive` → `lightbulb.finance_ledger_materialization.MaterializeLedgerSnapshotPrimitive`.

Source: `lightbulb/finance_ledger_materialization.py:560`.

### `lightbulb.materialize_ledger_snapshot`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import materialize_ledger_snapshot
~~~


Binding: `lightbulb.finance_ledger_materialization.materialize_ledger_snapshot` → `lightbulb.finance_ledger_materialization.materialize_ledger_snapshot`.

Source: `lightbulb/finance_ledger_materialization.py:348`.

### `lightbulb.CLOSE_SOURCE_PAGE_CHECKPOINT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CLOSE_SOURCE_PAGE_CHECKPOINT_SCHEMA
~~~


Binding: `lightbulb.finance_close_source_transactions.CLOSE_SOURCE_PAGE_CHECKPOINT_SCHEMA` → `lightbulb.finance_close_source_transactions.CLOSE_SOURCE_PAGE_CHECKPOINT_SCHEMA`.

Source: `lightbulb/finance_close_source_transactions.py:67`.

### `lightbulb.CLOSE_SOURCE_TRANSACTION_INPUT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CLOSE_SOURCE_TRANSACTION_INPUT_SCHEMA
~~~


Binding: `lightbulb.finance_close_source_transactions.CLOSE_SOURCE_TRANSACTION_INPUT_SCHEMA` → `lightbulb.finance_close_source_transactions.CLOSE_SOURCE_TRANSACTION_INPUT_SCHEMA`.

Source: `lightbulb/finance_close_source_transactions.py:60`.

### `lightbulb.CLOSE_SOURCE_TRANSACTION_LINK_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CLOSE_SOURCE_TRANSACTION_LINK_SCHEMA
~~~


Binding: `lightbulb.finance_close_source_transactions.CLOSE_SOURCE_TRANSACTION_LINK_SCHEMA` → `lightbulb.finance_close_source_transactions.CLOSE_SOURCE_TRANSACTION_LINK_SCHEMA`.

Source: `lightbulb/finance_close_source_transactions.py:64`.

### `lightbulb.CLOSE_SOURCE_TRANSACTION_RESULT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CLOSE_SOURCE_TRANSACTION_RESULT_SCHEMA
~~~


Binding: `lightbulb.finance_close_source_transactions.CLOSE_SOURCE_TRANSACTION_RESULT_SCHEMA` → `lightbulb.finance_close_source_transactions.CLOSE_SOURCE_TRANSACTION_RESULT_SCHEMA`.

Source: `lightbulb/finance_close_source_transactions.py:70`.

### `lightbulb.CLOSE_SOURCE_TRANSACTION_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CLOSE_SOURCE_TRANSACTION_SCHEMA
~~~


Binding: `lightbulb.finance_close_source_transactions.CLOSE_SOURCE_TRANSACTION_SCHEMA` → `lightbulb.finance_close_source_transactions.CLOSE_SOURCE_TRANSACTION_SCHEMA`.

Source: `lightbulb/finance_close_source_transactions.py:63`.

### `lightbulb.FINANCE_CLOSE_SOURCE_TRANSACTION_EXECUTABLE_PRIMITIVES`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import FINANCE_CLOSE_SOURCE_TRANSACTION_EXECUTABLE_PRIMITIVES
~~~


Binding: `lightbulb.finance_close_source_transactions.FINANCE_CLOSE_SOURCE_TRANSACTION_EXECUTABLE_PRIMITIVES` → `lightbulb.finance_close_source_transactions.FINANCE_CLOSE_SOURCE_TRANSACTION_EXECUTABLE_PRIMITIVES`.

Source: `lightbulb/finance_close_source_transactions.py:1245`.

### `lightbulb.QUICKBOOKS_CLOSE_SOURCE_TOOL_VERSION`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import QUICKBOOKS_CLOSE_SOURCE_TOOL_VERSION
~~~


Binding: `lightbulb.finance_close_source_transactions.QUICKBOOKS_CLOSE_SOURCE_TOOL_VERSION` → `lightbulb.finance_close_source_transactions.QUICKBOOKS_CLOSE_SOURCE_TOOL_VERSION`.

Source: `lightbulb/finance_close_source_transactions.py:77`.

### `lightbulb.QUICKBOOKS_LIST_BILLS_TOOL`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import QUICKBOOKS_LIST_BILLS_TOOL
~~~


Binding: `lightbulb.finance_close_source_transactions.QUICKBOOKS_LIST_BILLS_TOOL` → `lightbulb.finance_close_source_transactions.QUICKBOOKS_LIST_BILLS_TOOL`.

Source: `lightbulb/finance_close_source_transactions.py:75`.

### `lightbulb.QUICKBOOKS_LIST_INVOICES_TOOL`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import QUICKBOOKS_LIST_INVOICES_TOOL
~~~


Binding: `lightbulb.finance_close_source_transactions.QUICKBOOKS_LIST_INVOICES_TOOL` → `lightbulb.finance_close_source_transactions.QUICKBOOKS_LIST_INVOICES_TOOL`.

Source: `lightbulb/finance_close_source_transactions.py:74`.

### `lightbulb.QUICKBOOKS_LIST_PAYMENTS_TOOL`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import QUICKBOOKS_LIST_PAYMENTS_TOOL
~~~


Binding: `lightbulb.finance_close_source_transactions.QUICKBOOKS_LIST_PAYMENTS_TOOL` → `lightbulb.finance_close_source_transactions.QUICKBOOKS_LIST_PAYMENTS_TOOL`.

Source: `lightbulb/finance_close_source_transactions.py:76`.

### `lightbulb.CloseSourcePageCheckpoint`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CloseSourcePageCheckpoint
~~~


Binding: `lightbulb.finance_close_source_transactions.CloseSourcePageCheckpoint` → `lightbulb.finance_close_source_transactions.CloseSourcePageCheckpoint`.

Source: `lightbulb/finance_close_source_transactions.py:332`.

### `lightbulb.CloseSourceTransaction`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CloseSourceTransaction
~~~


Binding: `lightbulb.finance_close_source_transactions.CloseSourceTransaction` → `lightbulb.finance_close_source_transactions.CloseSourceTransaction`.

Source: `lightbulb/finance_close_source_transactions.py:257`.

### `lightbulb.CloseSourceTransactionInput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CloseSourceTransactionInput
~~~


Binding: `lightbulb.finance_close_source_transactions.CloseSourceTransactionInput` → `lightbulb.finance_close_source_transactions.CloseSourceTransactionInput`.

Source: `lightbulb/finance_close_source_transactions.py:233`.

### `lightbulb.CloseSourceTransactionLink`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CloseSourceTransactionLink
~~~


Binding: `lightbulb.finance_close_source_transactions.CloseSourceTransactionLink` → `lightbulb.finance_close_source_transactions.CloseSourceTransactionLink`.

Source: `lightbulb/finance_close_source_transactions.py:248`.

### `lightbulb.CloseSourceTransactionResult`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CloseSourceTransactionResult
~~~


Binding: `lightbulb.finance_close_source_transactions.CloseSourceTransactionResult` → `lightbulb.finance_close_source_transactions.CloseSourceTransactionResult`.

Source: `lightbulb/finance_close_source_transactions.py:358`.

### `lightbulb.DiscoverCloseSourceTransactionsPrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import DiscoverCloseSourceTransactionsPrimitive
~~~


Binding: `lightbulb.finance_close_source_transactions.DiscoverCloseSourceTransactionsPrimitive` → `lightbulb.finance_close_source_transactions.DiscoverCloseSourceTransactionsPrimitive`.

Source: `lightbulb/finance_close_source_transactions.py:873`.

### `lightbulb.FINANCE_XERO_CLOSE_SOURCE_TRANSACTION_EXECUTABLE_PRIMITIVES`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import FINANCE_XERO_CLOSE_SOURCE_TRANSACTION_EXECUTABLE_PRIMITIVES
~~~


Binding: `lightbulb.finance_xero_close_source_transactions.FINANCE_XERO_CLOSE_SOURCE_TRANSACTION_EXECUTABLE_PRIMITIVES` → `lightbulb.finance_xero_close_source_transactions.FINANCE_XERO_CLOSE_SOURCE_TRANSACTION_EXECUTABLE_PRIMITIVES`.

Source: `lightbulb/finance_xero_close_source_transactions.py:1178`.

### `lightbulb.XERO_CLOSE_SOURCE_PAGE_CHECKPOINT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import XERO_CLOSE_SOURCE_PAGE_CHECKPOINT_SCHEMA
~~~


Binding: `lightbulb.finance_xero_close_source_transactions.XERO_CLOSE_SOURCE_PAGE_CHECKPOINT_SCHEMA` → `lightbulb.finance_xero_close_source_transactions.XERO_CLOSE_SOURCE_PAGE_CHECKPOINT_SCHEMA`.

Source: `lightbulb/finance_xero_close_source_transactions.py:71`.

### `lightbulb.XERO_CLOSE_SOURCE_PAGE_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import XERO_CLOSE_SOURCE_PAGE_SCHEMA
~~~


Binding: `lightbulb.finance_xero_close_source_transactions.XERO_CLOSE_SOURCE_PAGE_SCHEMA` → `lightbulb.finance_xero_close_source_transactions.XERO_CLOSE_SOURCE_PAGE_SCHEMA`.

Source: `lightbulb/finance_xero_close_source_transactions.py:77`.

### `lightbulb.XERO_CLOSE_SOURCE_TOOL_VERSION`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import XERO_CLOSE_SOURCE_TOOL_VERSION
~~~


Binding: `lightbulb.finance_xero_close_source_transactions.XERO_CLOSE_SOURCE_TOOL_VERSION` → `lightbulb.finance_xero_close_source_transactions.XERO_CLOSE_SOURCE_TOOL_VERSION`.

Source: `lightbulb/finance_xero_close_source_transactions.py:82`.

### `lightbulb.XERO_CLOSE_SOURCE_TRANSACTION_INPUT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import XERO_CLOSE_SOURCE_TRANSACTION_INPUT_SCHEMA
~~~


Binding: `lightbulb.finance_xero_close_source_transactions.XERO_CLOSE_SOURCE_TRANSACTION_INPUT_SCHEMA` → `lightbulb.finance_xero_close_source_transactions.XERO_CLOSE_SOURCE_TRANSACTION_INPUT_SCHEMA`.

Source: `lightbulb/finance_xero_close_source_transactions.py:62`.

### `lightbulb.XERO_CLOSE_SOURCE_TRANSACTION_LINK_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import XERO_CLOSE_SOURCE_TRANSACTION_LINK_SCHEMA
~~~


Binding: `lightbulb.finance_xero_close_source_transactions.XERO_CLOSE_SOURCE_TRANSACTION_LINK_SCHEMA` → `lightbulb.finance_xero_close_source_transactions.XERO_CLOSE_SOURCE_TRANSACTION_LINK_SCHEMA`.

Source: `lightbulb/finance_xero_close_source_transactions.py:68`.

### `lightbulb.XERO_CLOSE_SOURCE_TRANSACTION_RESULT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import XERO_CLOSE_SOURCE_TRANSACTION_RESULT_SCHEMA
~~~


Binding: `lightbulb.finance_xero_close_source_transactions.XERO_CLOSE_SOURCE_TRANSACTION_RESULT_SCHEMA` → `lightbulb.finance_xero_close_source_transactions.XERO_CLOSE_SOURCE_TRANSACTION_RESULT_SCHEMA`.

Source: `lightbulb/finance_xero_close_source_transactions.py:74`.

### `lightbulb.XERO_CLOSE_SOURCE_TRANSACTION_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import XERO_CLOSE_SOURCE_TRANSACTION_SCHEMA
~~~


Binding: `lightbulb.finance_xero_close_source_transactions.XERO_CLOSE_SOURCE_TRANSACTION_SCHEMA` → `lightbulb.finance_xero_close_source_transactions.XERO_CLOSE_SOURCE_TRANSACTION_SCHEMA`.

Source: `lightbulb/finance_xero_close_source_transactions.py:65`.

### `lightbulb.XERO_LIST_BILLS_TOOL`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import XERO_LIST_BILLS_TOOL
~~~


Binding: `lightbulb.finance_xero_close_source_transactions.XERO_LIST_BILLS_TOOL` → `lightbulb.finance_xero_close_source_transactions.XERO_LIST_BILLS_TOOL`.

Source: `lightbulb/finance_xero_close_source_transactions.py:80`.

### `lightbulb.XERO_LIST_INVOICES_TOOL`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import XERO_LIST_INVOICES_TOOL
~~~


Binding: `lightbulb.finance_xero_close_source_transactions.XERO_LIST_INVOICES_TOOL` → `lightbulb.finance_xero_close_source_transactions.XERO_LIST_INVOICES_TOOL`.

Source: `lightbulb/finance_xero_close_source_transactions.py:79`.

### `lightbulb.XERO_LIST_PAYMENTS_TOOL`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import XERO_LIST_PAYMENTS_TOOL
~~~


Binding: `lightbulb.finance_xero_close_source_transactions.XERO_LIST_PAYMENTS_TOOL` → `lightbulb.finance_xero_close_source_transactions.XERO_LIST_PAYMENTS_TOOL`.

Source: `lightbulb/finance_xero_close_source_transactions.py:81`.

### `lightbulb.DiscoverXeroCloseSourceTransactionsPrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import DiscoverXeroCloseSourceTransactionsPrimitive
~~~


Binding: `lightbulb.finance_xero_close_source_transactions.DiscoverXeroCloseSourceTransactionsPrimitive` → `lightbulb.finance_xero_close_source_transactions.DiscoverXeroCloseSourceTransactionsPrimitive`.

Source: `lightbulb/finance_xero_close_source_transactions.py:783`.

### `lightbulb.XeroCloseSourcePageCheckpoint`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import XeroCloseSourcePageCheckpoint
~~~


Binding: `lightbulb.finance_xero_close_source_transactions.XeroCloseSourcePageCheckpoint` → `lightbulb.finance_xero_close_source_transactions.XeroCloseSourcePageCheckpoint`.

Source: `lightbulb/finance_xero_close_source_transactions.py:307`.

### `lightbulb.XeroCloseSourceTransaction`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import XeroCloseSourceTransaction
~~~


Binding: `lightbulb.finance_xero_close_source_transactions.XeroCloseSourceTransaction` → `lightbulb.finance_xero_close_source_transactions.XeroCloseSourceTransaction`.

Source: `lightbulb/finance_xero_close_source_transactions.py:232`.

### `lightbulb.XeroCloseSourceTransactionInput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import XeroCloseSourceTransactionInput
~~~


Binding: `lightbulb.finance_xero_close_source_transactions.XeroCloseSourceTransactionInput` → `lightbulb.finance_xero_close_source_transactions.XeroCloseSourceTransactionInput`.

Source: `lightbulb/finance_xero_close_source_transactions.py:209`.

### `lightbulb.XeroCloseSourceTransactionLink`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import XeroCloseSourceTransactionLink
~~~


Binding: `lightbulb.finance_xero_close_source_transactions.XeroCloseSourceTransactionLink` → `lightbulb.finance_xero_close_source_transactions.XeroCloseSourceTransactionLink`.

Source: `lightbulb/finance_xero_close_source_transactions.py:224`.

### `lightbulb.XeroCloseSourceTransactionResult`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import XeroCloseSourceTransactionResult
~~~


Binding: `lightbulb.finance_xero_close_source_transactions.XeroCloseSourceTransactionResult` → `lightbulb.finance_xero_close_source_transactions.XeroCloseSourceTransactionResult`.

Source: `lightbulb/finance_xero_close_source_transactions.py:343`.

### `lightbulb.FINANCE_PROVIDER_PERIOD_STATUS_EXECUTABLE_PRIMITIVES`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import FINANCE_PROVIDER_PERIOD_STATUS_EXECUTABLE_PRIMITIVES
~~~


Binding: `lightbulb.finance_provider_period_status.FINANCE_PROVIDER_PERIOD_STATUS_EXECUTABLE_PRIMITIVES` → `lightbulb.finance_provider_period_status.FINANCE_PROVIDER_PERIOD_STATUS_EXECUTABLE_PRIMITIVES`.

Source: `lightbulb/finance_provider_period_status.py:773`.

### `lightbulb.PROVIDER_PERIOD_LOCK_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROVIDER_PERIOD_LOCK_SCHEMA
~~~


Binding: `lightbulb.finance_provider_period_status.PROVIDER_PERIOD_LOCK_SCHEMA` → `lightbulb.finance_provider_period_status.PROVIDER_PERIOD_LOCK_SCHEMA`.

Source: `lightbulb/finance_provider_period_status.py:60`.

### `lightbulb.PROVIDER_PERIOD_STATUS_INPUT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROVIDER_PERIOD_STATUS_INPUT_SCHEMA
~~~


Binding: `lightbulb.finance_provider_period_status.PROVIDER_PERIOD_STATUS_INPUT_SCHEMA` → `lightbulb.finance_provider_period_status.PROVIDER_PERIOD_STATUS_INPUT_SCHEMA`.

Source: `lightbulb/finance_provider_period_status.py:57`.

### `lightbulb.PROVIDER_PERIOD_STATUS_RESPONSE_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROVIDER_PERIOD_STATUS_RESPONSE_SCHEMA
~~~


Binding: `lightbulb.finance_provider_period_status.PROVIDER_PERIOD_STATUS_RESPONSE_SCHEMA` → `lightbulb.finance_provider_period_status.PROVIDER_PERIOD_STATUS_RESPONSE_SCHEMA`.

Source: `lightbulb/finance_provider_period_status.py:64`.

### `lightbulb.PROVIDER_PERIOD_STATUS_RESULT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROVIDER_PERIOD_STATUS_RESULT_SCHEMA
~~~


Binding: `lightbulb.finance_provider_period_status.PROVIDER_PERIOD_STATUS_RESULT_SCHEMA` → `lightbulb.finance_provider_period_status.PROVIDER_PERIOD_STATUS_RESULT_SCHEMA`.

Source: `lightbulb/finance_provider_period_status.py:61`.

### `lightbulb.PROVIDER_PERIOD_STATUS_TOOL_VERSION`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROVIDER_PERIOD_STATUS_TOOL_VERSION
~~~


Binding: `lightbulb.finance_provider_period_status.PROVIDER_PERIOD_STATUS_TOOL_VERSION` → `lightbulb.finance_provider_period_status.PROVIDER_PERIOD_STATUS_TOOL_VERSION`.

Source: `lightbulb/finance_provider_period_status.py:68`.

### `lightbulb.QUICKBOOKS_PERIOD_STATUS_TOOL`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import QUICKBOOKS_PERIOD_STATUS_TOOL
~~~


Binding: `lightbulb.finance_provider_period_status.QUICKBOOKS_PERIOD_STATUS_TOOL` → `lightbulb.finance_provider_period_status.QUICKBOOKS_PERIOD_STATUS_TOOL`.

Source: `lightbulb/finance_provider_period_status.py:66`.

### `lightbulb.XERO_PERIOD_STATUS_TOOL`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import XERO_PERIOD_STATUS_TOOL
~~~


Binding: `lightbulb.finance_provider_period_status.XERO_PERIOD_STATUS_TOOL` → `lightbulb.finance_provider_period_status.XERO_PERIOD_STATUS_TOOL`.

Source: `lightbulb/finance_provider_period_status.py:67`.

### `lightbulb.DiscoverProviderPeriodStatusPrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import DiscoverProviderPeriodStatusPrimitive
~~~


Binding: `lightbulb.finance_provider_period_status.DiscoverProviderPeriodStatusPrimitive` → `lightbulb.finance_provider_period_status.DiscoverProviderPeriodStatusPrimitive`.

Source: `lightbulb/finance_provider_period_status.py:506`.

### `lightbulb.ProviderPeriodLock`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProviderPeriodLock
~~~


Binding: `lightbulb.finance_provider_period_status.ProviderPeriodLock` → `lightbulb.finance_provider_period_status.ProviderPeriodLock`.

Source: `lightbulb/finance_provider_period_status.py:186`.

### `lightbulb.ProviderPeriodStatusInput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProviderPeriodStatusInput
~~~


Binding: `lightbulb.finance_provider_period_status.ProviderPeriodStatusInput` → `lightbulb.finance_provider_period_status.ProviderPeriodStatusInput`.

Source: `lightbulb/finance_provider_period_status.py:171`.

### `lightbulb.ProviderPeriodStatusResult`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProviderPeriodStatusResult
~~~


Binding: `lightbulb.finance_provider_period_status.ProviderPeriodStatusResult` → `lightbulb.finance_provider_period_status.ProviderPeriodStatusResult`.

Source: `lightbulb/finance_provider_period_status.py:206`.

### `lightbulb.FINANCE_GENERAL_LEDGER_EXECUTABLE_PRIMITIVES`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import FINANCE_GENERAL_LEDGER_EXECUTABLE_PRIMITIVES
~~~


Binding: `lightbulb.finance_general_ledger.FINANCE_GENERAL_LEDGER_EXECUTABLE_PRIMITIVES` → `lightbulb.finance_general_ledger.FINANCE_GENERAL_LEDGER_EXECUTABLE_PRIMITIVES`.

Source: `lightbulb/finance_general_ledger.py:1971`.

### `lightbulb.GENERAL_LEDGER_ACTIVITY_INPUT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GENERAL_LEDGER_ACTIVITY_INPUT_SCHEMA
~~~


Binding: `lightbulb.finance_general_ledger.GENERAL_LEDGER_ACTIVITY_INPUT_SCHEMA` → `lightbulb.finance_general_ledger.GENERAL_LEDGER_ACTIVITY_INPUT_SCHEMA`.

Source: `lightbulb/finance_general_ledger.py:62`.

### `lightbulb.GENERAL_LEDGER_ACTIVITY_LINE_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GENERAL_LEDGER_ACTIVITY_LINE_SCHEMA
~~~


Binding: `lightbulb.finance_general_ledger.GENERAL_LEDGER_ACTIVITY_LINE_SCHEMA` → `lightbulb.finance_general_ledger.GENERAL_LEDGER_ACTIVITY_LINE_SCHEMA`.

Source: `lightbulb/finance_general_ledger.py:65`.

### `lightbulb.GENERAL_LEDGER_ACTIVITY_RESULT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GENERAL_LEDGER_ACTIVITY_RESULT_SCHEMA
~~~


Binding: `lightbulb.finance_general_ledger.GENERAL_LEDGER_ACTIVITY_RESULT_SCHEMA` → `lightbulb.finance_general_ledger.GENERAL_LEDGER_ACTIVITY_RESULT_SCHEMA`.

Source: `lightbulb/finance_general_ledger.py:66`.

### `lightbulb.QUICKBOOKS_GENERAL_LEDGER_TOOL`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import QUICKBOOKS_GENERAL_LEDGER_TOOL
~~~


Binding: `lightbulb.finance_general_ledger.QUICKBOOKS_GENERAL_LEDGER_TOOL` → `lightbulb.finance_general_ledger.QUICKBOOKS_GENERAL_LEDGER_TOOL`.

Source: `lightbulb/finance_general_ledger.py:69`.

### `lightbulb.QUICKBOOKS_GENERAL_LEDGER_TOOL_VERSION`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import QUICKBOOKS_GENERAL_LEDGER_TOOL_VERSION
~~~


Binding: `lightbulb.finance_general_ledger.QUICKBOOKS_GENERAL_LEDGER_TOOL_VERSION` → `lightbulb.finance_general_ledger.QUICKBOOKS_GENERAL_LEDGER_TOOL_VERSION`.

Source: `lightbulb/finance_general_ledger.py:70`.

### `lightbulb.XERO_JOURNAL_TOOL`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import XERO_JOURNAL_TOOL
~~~


Binding: `lightbulb.finance_general_ledger.XERO_JOURNAL_TOOL` → `lightbulb.finance_general_ledger.XERO_JOURNAL_TOOL`.

Source: `lightbulb/finance_general_ledger.py:71`.

### `lightbulb.XERO_JOURNAL_TOOL_VERSION`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import XERO_JOURNAL_TOOL_VERSION
~~~


Binding: `lightbulb.finance_general_ledger.XERO_JOURNAL_TOOL_VERSION` → `lightbulb.finance_general_ledger.XERO_JOURNAL_TOOL_VERSION`.

Source: `lightbulb/finance_general_ledger.py:72`.

### `lightbulb.DiscoverGeneralLedgerActivityPrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import DiscoverGeneralLedgerActivityPrimitive
~~~


Binding: `lightbulb.finance_general_ledger.DiscoverGeneralLedgerActivityPrimitive` → `lightbulb.finance_general_ledger.DiscoverGeneralLedgerActivityPrimitive`.

Source: `lightbulb/finance_general_ledger.py:1459`.

### `lightbulb.GeneralLedgerActivityInput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GeneralLedgerActivityInput
~~~


Binding: `lightbulb.finance_general_ledger.GeneralLedgerActivityInput` → `lightbulb.finance_general_ledger.GeneralLedgerActivityInput`.

Source: `lightbulb/finance_general_ledger.py:267`.

### `lightbulb.GeneralLedgerActivityLine`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GeneralLedgerActivityLine
~~~


Binding: `lightbulb.finance_general_ledger.GeneralLedgerActivityLine` → `lightbulb.finance_general_ledger.GeneralLedgerActivityLine`.

Source: `lightbulb/finance_general_ledger.py:291`.

### `lightbulb.GeneralLedgerActivityObservation`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GeneralLedgerActivityObservation
~~~


Binding: `lightbulb.finance_general_ledger.GeneralLedgerActivityObservation` → `lightbulb.finance_general_ledger.GeneralLedgerActivityObservation`.

Source: `lightbulb/finance_general_ledger.py:405`.

### `lightbulb.GeneralLedgerActivityResult`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GeneralLedgerActivityResult
~~~


Binding: `lightbulb.finance_general_ledger.GeneralLedgerActivityResult` → `lightbulb.finance_general_ledger.GeneralLedgerActivityResult`.

Source: `lightbulb/finance_general_ledger.py:507`.

### `lightbulb.FINANCE_JOURNAL_LIFECYCLE_EXECUTABLE_PRIMITIVES`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import FINANCE_JOURNAL_LIFECYCLE_EXECUTABLE_PRIMITIVES
~~~


Binding: `lightbulb.finance_journal_lifecycle.FINANCE_JOURNAL_LIFECYCLE_EXECUTABLE_PRIMITIVES` → `lightbulb.finance_journal_lifecycle.FINANCE_JOURNAL_LIFECYCLE_EXECUTABLE_PRIMITIVES`.

Source: `lightbulb/finance_journal_lifecycle.py:3982`.

### `lightbulb.GOVERNED_LEDGER_READ_RECEIPT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GOVERNED_LEDGER_READ_RECEIPT_SCHEMA
~~~


Binding: `lightbulb.finance_journal_lifecycle.GOVERNED_LEDGER_READ_RECEIPT_SCHEMA` → `lightbulb.finance_journal_lifecycle.GOVERNED_LEDGER_READ_RECEIPT_SCHEMA`.

Source: `lightbulb/finance_journal_lifecycle.py:86`.

### `lightbulb.GOVERNED_FINANCE_WRITE_RESULT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GOVERNED_FINANCE_WRITE_RESULT_SCHEMA
~~~


Binding: `lightbulb.finance_journal_lifecycle.GOVERNED_FINANCE_WRITE_RESULT_SCHEMA` → `lightbulb.finance_journal_lifecycle.GOVERNED_FINANCE_WRITE_RESULT_SCHEMA`.

Source: `lightbulb/finance_journal_lifecycle.py:100`.

### `lightbulb.JOURNAL_ENTRY_POST_INPUT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import JOURNAL_ENTRY_POST_INPUT_SCHEMA
~~~


Binding: `lightbulb.finance_journal_lifecycle.JOURNAL_ENTRY_POST_INPUT_SCHEMA` → `lightbulb.finance_journal_lifecycle.JOURNAL_ENTRY_POST_INPUT_SCHEMA`.

Source: `lightbulb/finance_journal_lifecycle.py:93`.

### `lightbulb.JOURNAL_ENTRY_POST_RESULT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import JOURNAL_ENTRY_POST_RESULT_SCHEMA
~~~


Binding: `lightbulb.finance_journal_lifecycle.JOURNAL_ENTRY_POST_RESULT_SCHEMA` → `lightbulb.finance_journal_lifecycle.JOURNAL_ENTRY_POST_RESULT_SCHEMA`.

Source: `lightbulb/finance_journal_lifecycle.py:94`.

### `lightbulb.JOURNAL_ENTRY_PREPARATION_INPUT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import JOURNAL_ENTRY_PREPARATION_INPUT_SCHEMA
~~~


Binding: `lightbulb.finance_journal_lifecycle.JOURNAL_ENTRY_PREPARATION_INPUT_SCHEMA` → `lightbulb.finance_journal_lifecycle.JOURNAL_ENTRY_PREPARATION_INPUT_SCHEMA`.

Source: `lightbulb/finance_journal_lifecycle.py:89`.

### `lightbulb.JOURNAL_ENTRY_PREPARATION_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import JOURNAL_ENTRY_PREPARATION_SCHEMA
~~~


Binding: `lightbulb.finance_journal_lifecycle.JOURNAL_ENTRY_PREPARATION_SCHEMA` → `lightbulb.finance_journal_lifecycle.JOURNAL_ENTRY_PREPARATION_SCHEMA`.

Source: `lightbulb/finance_journal_lifecycle.py:92`.

### `lightbulb.JOURNAL_POST_READBACK_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import JOURNAL_POST_READBACK_SCHEMA
~~~


Binding: `lightbulb.finance_journal_lifecycle.JOURNAL_POST_READBACK_SCHEMA` → `lightbulb.finance_journal_lifecycle.JOURNAL_POST_READBACK_SCHEMA`.

Source: `lightbulb/finance_journal_lifecycle.py:95`.

### `lightbulb.JOURNAL_POST_RECOVERY_EVALUATION_OPERATION`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import JOURNAL_POST_RECOVERY_EVALUATION_OPERATION
~~~


Binding: `lightbulb.finance_journal_lifecycle.JOURNAL_POST_RECOVERY_EVALUATION_OPERATION` → `lightbulb.finance_journal_lifecycle.JOURNAL_POST_RECOVERY_EVALUATION_OPERATION`.

Source: `lightbulb/finance_journal_lifecycle.py:377`.

### `lightbulb.JOURNAL_POST_RECOVERY_INPUT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import JOURNAL_POST_RECOVERY_INPUT_SCHEMA
~~~


Binding: `lightbulb.finance_journal_lifecycle.JOURNAL_POST_RECOVERY_INPUT_SCHEMA` → `lightbulb.finance_journal_lifecycle.JOURNAL_POST_RECOVERY_INPUT_SCHEMA`.

Source: `lightbulb/finance_journal_lifecycle.py:96`.

### `lightbulb.JOURNAL_POST_RECOVERY_RESULT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import JOURNAL_POST_RECOVERY_RESULT_SCHEMA
~~~


Binding: `lightbulb.finance_journal_lifecycle.JOURNAL_POST_RECOVERY_RESULT_SCHEMA` → `lightbulb.finance_journal_lifecycle.JOURNAL_POST_RECOVERY_RESULT_SCHEMA`.

Source: `lightbulb/finance_journal_lifecycle.py:97`.

### `lightbulb.LEDGER_ACCOUNT_DISCOVERY_INPUT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import LEDGER_ACCOUNT_DISCOVERY_INPUT_SCHEMA
~~~


Binding: `lightbulb.finance_journal_lifecycle.LEDGER_ACCOUNT_DISCOVERY_INPUT_SCHEMA` → `lightbulb.finance_journal_lifecycle.LEDGER_ACCOUNT_DISCOVERY_INPUT_SCHEMA`.

Source: `lightbulb/finance_journal_lifecycle.py:74`.

### `lightbulb.LEDGER_ACCOUNT_DISCOVERY_RESULT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import LEDGER_ACCOUNT_DISCOVERY_RESULT_SCHEMA
~~~


Binding: `lightbulb.finance_journal_lifecycle.LEDGER_ACCOUNT_DISCOVERY_RESULT_SCHEMA` → `lightbulb.finance_journal_lifecycle.LEDGER_ACCOUNT_DISCOVERY_RESULT_SCHEMA`.

Source: `lightbulb/finance_journal_lifecycle.py:77`.

### `lightbulb.QUICKBOOKS_CREATE_JOURNAL_TOOL`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import QUICKBOOKS_CREATE_JOURNAL_TOOL
~~~


Binding: `lightbulb.finance_journal_lifecycle.QUICKBOOKS_CREATE_JOURNAL_TOOL` → `lightbulb.finance_journal_lifecycle.QUICKBOOKS_CREATE_JOURNAL_TOOL`.

Source: `lightbulb/finance_journal_lifecycle.py:110`.

### `lightbulb.QUICKBOOKS_GET_JOURNAL_TOOL`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import QUICKBOOKS_GET_JOURNAL_TOOL
~~~


Binding: `lightbulb.finance_journal_lifecycle.QUICKBOOKS_GET_JOURNAL_TOOL` → `lightbulb.finance_journal_lifecycle.QUICKBOOKS_GET_JOURNAL_TOOL`.

Source: `lightbulb/finance_journal_lifecycle.py:112`.

### `lightbulb.QUICKBOOKS_JOURNAL_EFFECT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import QUICKBOOKS_JOURNAL_EFFECT_SCHEMA
~~~


Binding: `lightbulb.finance_journal_lifecycle.QUICKBOOKS_JOURNAL_EFFECT_SCHEMA` → `lightbulb.finance_journal_lifecycle.QUICKBOOKS_JOURNAL_EFFECT_SCHEMA`.

Source: `lightbulb/finance_journal_lifecycle.py:101`.

### `lightbulb.QUICKBOOKS_LIST_ACCOUNTS_TOOL`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import QUICKBOOKS_LIST_ACCOUNTS_TOOL
~~~


Binding: `lightbulb.finance_journal_lifecycle.QUICKBOOKS_LIST_ACCOUNTS_TOOL` → `lightbulb.finance_journal_lifecycle.QUICKBOOKS_LIST_ACCOUNTS_TOOL`.

Source: `lightbulb/finance_journal_lifecycle.py:106`.

### `lightbulb.QUICKBOOKS_TRIAL_BALANCE_TOOL`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import QUICKBOOKS_TRIAL_BALANCE_TOOL
~~~


Binding: `lightbulb.finance_journal_lifecycle.QUICKBOOKS_TRIAL_BALANCE_TOOL` → `lightbulb.finance_journal_lifecycle.QUICKBOOKS_TRIAL_BALANCE_TOOL`.

Source: `lightbulb/finance_journal_lifecycle.py:107`.

### `lightbulb.XERO_CREATE_MANUAL_JOURNAL_TOOL`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import XERO_CREATE_MANUAL_JOURNAL_TOOL
~~~


Binding: `lightbulb.finance_journal_lifecycle.XERO_CREATE_MANUAL_JOURNAL_TOOL` → `lightbulb.finance_journal_lifecycle.XERO_CREATE_MANUAL_JOURNAL_TOOL`.

Source: `lightbulb/finance_journal_lifecycle.py:111`.

### `lightbulb.XERO_LIST_JOURNALS_TOOL`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import XERO_LIST_JOURNALS_TOOL
~~~


Binding: `lightbulb.finance_journal_lifecycle.XERO_LIST_JOURNALS_TOOL` → `lightbulb.finance_journal_lifecycle.XERO_LIST_JOURNALS_TOOL`.

Source: `lightbulb/finance_journal_lifecycle.py:113`.

### `lightbulb.DiscoverLedgerAccountsPrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import DiscoverLedgerAccountsPrimitive
~~~


Binding: `lightbulb.finance_journal_lifecycle.DiscoverLedgerAccountsPrimitive` → `lightbulb.finance_journal_lifecycle.DiscoverLedgerAccountsPrimitive`.

Source: `lightbulb/finance_journal_lifecycle.py:2603`.

### `lightbulb.DiscoverTrialBalancePrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import DiscoverTrialBalancePrimitive
~~~


Binding: `lightbulb.finance_journal_lifecycle.DiscoverTrialBalancePrimitive` → `lightbulb.finance_journal_lifecycle.DiscoverTrialBalancePrimitive`.

Source: `lightbulb/finance_journal_lifecycle.py:2998`.

### `lightbulb.DiscoveredTrialBalanceLine`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import DiscoveredTrialBalanceLine
~~~


Binding: `lightbulb.finance_journal_lifecycle.DiscoveredTrialBalanceLine` → `lightbulb.finance_journal_lifecycle.DiscoveredTrialBalanceLine`.

Source: `lightbulb/finance_journal_lifecycle.py:649`.

### `lightbulb.GovernedLedgerReadReceipt`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GovernedLedgerReadReceipt
~~~


Binding: `lightbulb.finance_journal_lifecycle.GovernedLedgerReadReceipt` → `lightbulb.finance_journal_lifecycle.GovernedLedgerReadReceipt`.

Source: `lightbulb/finance_journal_lifecycle.py:396`.

### `lightbulb.GovernedJournalWriteResult`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GovernedJournalWriteResult
~~~


Binding: `lightbulb.finance_journal_lifecycle.GovernedJournalWriteResult` → `lightbulb.finance_journal_lifecycle.GovernedJournalWriteResult`.

Source: `lightbulb/finance_journal_lifecycle.py:1039`.

### `lightbulb.JournalEntryPreparation`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import JournalEntryPreparation
~~~


Binding: `lightbulb.finance_journal_lifecycle.JournalEntryPreparation` → `lightbulb.finance_journal_lifecycle.JournalEntryPreparation`.

Source: `lightbulb/finance_journal_lifecycle.py:964`.

### `lightbulb.JournalPostReadback`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import JournalPostReadback
~~~


Binding: `lightbulb.finance_journal_lifecycle.JournalPostReadback` → `lightbulb.finance_journal_lifecycle.JournalPostReadback`.

Source: `lightbulb/finance_journal_lifecycle.py:1198`.

### `lightbulb.LedgerAccount`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import LedgerAccount
~~~


Binding: `lightbulb.finance_journal_lifecycle.LedgerAccount` → `lightbulb.finance_journal_lifecycle.LedgerAccount`.

Source: `lightbulb/finance_journal_lifecycle.py:427`.

### `lightbulb.LedgerAccountDiscoveryInput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import LedgerAccountDiscoveryInput
~~~


Binding: `lightbulb.finance_journal_lifecycle.LedgerAccountDiscoveryInput` → `lightbulb.finance_journal_lifecycle.LedgerAccountDiscoveryInput`.

Source: `lightbulb/finance_journal_lifecycle.py:388`.

### `lightbulb.LedgerAccountDiscoveryResult`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import LedgerAccountDiscoveryResult
~~~


Binding: `lightbulb.finance_journal_lifecycle.LedgerAccountDiscoveryResult` → `lightbulb.finance_journal_lifecycle.LedgerAccountDiscoveryResult`.

Source: `lightbulb/finance_journal_lifecycle.py:487`.

### `lightbulb.PostJournalEntryInput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PostJournalEntryInput
~~~


Binding: `lightbulb.finance_journal_lifecycle.PostJournalEntryInput` → `lightbulb.finance_journal_lifecycle.PostJournalEntryInput`.

Source: `lightbulb/finance_journal_lifecycle.py:1030`.

### `lightbulb.PostJournalEntryPrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PostJournalEntryPrimitive
~~~


Binding: `lightbulb.finance_journal_lifecycle.PostJournalEntryPrimitive` → `lightbulb.finance_journal_lifecycle.PostJournalEntryPrimitive`.

Source: `lightbulb/finance_journal_lifecycle.py:3305`.

### `lightbulb.PostJournalEntryResult`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PostJournalEntryResult
~~~


Binding: `lightbulb.finance_journal_lifecycle.PostJournalEntryResult` → `lightbulb.finance_journal_lifecycle.PostJournalEntryResult`.

Source: `lightbulb/finance_journal_lifecycle.py:1097`.

### `lightbulb.PrepareJournalEntryInput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PrepareJournalEntryInput
~~~


Binding: `lightbulb.finance_journal_lifecycle.PrepareJournalEntryInput` → `lightbulb.finance_journal_lifecycle.PrepareJournalEntryInput`.

Source: `lightbulb/finance_journal_lifecycle.py:939`.

### `lightbulb.PrepareJournalEntryPrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PrepareJournalEntryPrimitive
~~~


Binding: `lightbulb.finance_journal_lifecycle.PrepareJournalEntryPrimitive` → `lightbulb.finance_journal_lifecycle.PrepareJournalEntryPrimitive`.

Source: `lightbulb/finance_journal_lifecycle.py:3239`.

### `lightbulb.QuickBooksJournalEntryLine`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import QuickBooksJournalEntryLine
~~~


Binding: `lightbulb.finance_journal_lifecycle.QuickBooksJournalEntryLine` → `lightbulb.finance_journal_lifecycle.QuickBooksJournalEntryLine`.

Source: `lightbulb/finance_journal_lifecycle.py:805`.

### `lightbulb.QuickBooksJournalEntryLineDetail`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import QuickBooksJournalEntryLineDetail
~~~


Binding: `lightbulb.finance_journal_lifecycle.QuickBooksJournalEntryLineDetail` → `lightbulb.finance_journal_lifecycle.QuickBooksJournalEntryLineDetail`.

Source: `lightbulb/finance_journal_lifecycle.py:800`.

### `lightbulb.QuickBooksJournalEntryPayload`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import QuickBooksJournalEntryPayload
~~~


Binding: `lightbulb.finance_journal_lifecycle.QuickBooksJournalEntryPayload` → `lightbulb.finance_journal_lifecycle.QuickBooksJournalEntryPayload`.

Source: `lightbulb/finance_journal_lifecycle.py:815`.

### `lightbulb.QuickBooksValueRef`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import QuickBooksValueRef
~~~


Binding: `lightbulb.finance_journal_lifecycle.QuickBooksValueRef` → `lightbulb.finance_journal_lifecycle.QuickBooksValueRef`.

Source: `lightbulb/finance_journal_lifecycle.py:796`.

### `lightbulb.quickbooks_journal_effect_sha256`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import quickbooks_journal_effect_sha256
~~~


Binding: `lightbulb.finance_journal_lifecycle.quickbooks_journal_effect_sha256` → `lightbulb.finance_journal_lifecycle.quickbooks_journal_effect_sha256`.

Source: `lightbulb/finance_journal_lifecycle.py:832`.

### `lightbulb.ReconcileJournalPostInput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ReconcileJournalPostInput
~~~


Binding: `lightbulb.finance_journal_lifecycle.ReconcileJournalPostInput` → `lightbulb.finance_journal_lifecycle.ReconcileJournalPostInput`.

Source: `lightbulb/finance_journal_lifecycle.py:1293`.

### `lightbulb.ReconcileJournalPostPrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ReconcileJournalPostPrimitive
~~~


Binding: `lightbulb.finance_journal_lifecycle.ReconcileJournalPostPrimitive` → `lightbulb.finance_journal_lifecycle.ReconcileJournalPostPrimitive`.

Source: `lightbulb/finance_journal_lifecycle.py:3885`.

### `lightbulb.ReconcileJournalPostResult`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ReconcileJournalPostResult
~~~


Binding: `lightbulb.finance_journal_lifecycle.ReconcileJournalPostResult` → `lightbulb.finance_journal_lifecycle.ReconcileJournalPostResult`.

Source: `lightbulb/finance_journal_lifecycle.py:1462`.

### `lightbulb.prepare_journal_entry`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import prepare_journal_entry
~~~


Binding: `lightbulb.finance_journal_lifecycle.prepare_journal_entry` → `lightbulb.finance_journal_lifecycle.prepare_journal_entry`.

Source: `lightbulb/finance_journal_lifecycle.py:2289`.

### `lightbulb.reconcile_journal_post`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import reconcile_journal_post
~~~


Binding: `lightbulb.finance_journal_lifecycle.reconcile_journal_post` → `lightbulb.finance_journal_lifecycle.reconcile_journal_post`.

Source: `lightbulb/finance_journal_lifecycle.py:3752`.

### `lightbulb.TRIAL_BALANCE_DISCOVERY_INPUT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import TRIAL_BALANCE_DISCOVERY_INPUT_SCHEMA
~~~


Binding: `lightbulb.finance_journal_lifecycle.TRIAL_BALANCE_DISCOVERY_INPUT_SCHEMA` → `lightbulb.finance_journal_lifecycle.TRIAL_BALANCE_DISCOVERY_INPUT_SCHEMA`.

Source: `lightbulb/finance_journal_lifecycle.py:80`.

### `lightbulb.TRIAL_BALANCE_DISCOVERY_RESULT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import TRIAL_BALANCE_DISCOVERY_RESULT_SCHEMA
~~~


Binding: `lightbulb.finance_journal_lifecycle.TRIAL_BALANCE_DISCOVERY_RESULT_SCHEMA` → `lightbulb.finance_journal_lifecycle.TRIAL_BALANCE_DISCOVERY_RESULT_SCHEMA`.

Source: `lightbulb/finance_journal_lifecycle.py:83`.

### `lightbulb.TrialBalanceDiscoveryInput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import TrialBalanceDiscoveryInput
~~~


Binding: `lightbulb.finance_journal_lifecycle.TrialBalanceDiscoveryInput` → `lightbulb.finance_journal_lifecycle.TrialBalanceDiscoveryInput`.

Source: `lightbulb/finance_journal_lifecycle.py:622`.

### `lightbulb.TrialBalanceDiscoveryResult`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import TrialBalanceDiscoveryResult
~~~


Binding: `lightbulb.finance_journal_lifecycle.TrialBalanceDiscoveryResult` → `lightbulb.finance_journal_lifecycle.TrialBalanceDiscoveryResult`.

Source: `lightbulb/finance_journal_lifecycle.py:684`.

### `lightbulb.XeroManualJournalLine`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import XeroManualJournalLine
~~~


Binding: `lightbulb.finance_journal_lifecycle.XeroManualJournalLine` → `lightbulb.finance_journal_lifecycle.XeroManualJournalLine`.

Source: `lightbulb/finance_journal_lifecycle.py:907`.

### `lightbulb.XeroManualJournalPayload`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import XeroManualJournalPayload
~~~


Binding: `lightbulb.finance_journal_lifecycle.XeroManualJournalPayload` → `lightbulb.finance_journal_lifecycle.XeroManualJournalPayload`.

Source: `lightbulb/finance_journal_lifecycle.py:920`.

### `lightbulb.FINANCE_STRIPE_SETTLEMENT_EXECUTABLE_PRIMITIVES`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import FINANCE_STRIPE_SETTLEMENT_EXECUTABLE_PRIMITIVES
~~~


Binding: `lightbulb.finance_stripe_settlements.FINANCE_STRIPE_SETTLEMENT_EXECUTABLE_PRIMITIVES` → `lightbulb.finance_stripe_settlements.FINANCE_STRIPE_SETTLEMENT_EXECUTABLE_PRIMITIVES`.

Source: `lightbulb/finance_stripe_settlements.py:1021`.

### `lightbulb.STRIPE_LIST_BALANCE_TRANSACTIONS_TOOL`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import STRIPE_LIST_BALANCE_TRANSACTIONS_TOOL
~~~


Binding: `lightbulb.finance_stripe_settlements.STRIPE_LIST_BALANCE_TRANSACTIONS_TOOL` → `lightbulb.finance_stripe_settlements.STRIPE_LIST_BALANCE_TRANSACTIONS_TOOL`.

Source: `lightbulb/finance_stripe_settlements.py:67`.

### `lightbulb.STRIPE_SETTLEMENT_MOVEMENT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import STRIPE_SETTLEMENT_MOVEMENT_SCHEMA
~~~


Binding: `lightbulb.finance_stripe_settlements.STRIPE_SETTLEMENT_MOVEMENT_SCHEMA` → `lightbulb.finance_stripe_settlements.STRIPE_SETTLEMENT_MOVEMENT_SCHEMA`.

Source: `lightbulb/finance_stripe_settlements.py:63`.

### `lightbulb.STRIPE_SETTLEMENT_OBSERVATION_INPUT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import STRIPE_SETTLEMENT_OBSERVATION_INPUT_SCHEMA
~~~


Binding: `lightbulb.finance_stripe_settlements.STRIPE_SETTLEMENT_OBSERVATION_INPUT_SCHEMA` → `lightbulb.finance_stripe_settlements.STRIPE_SETTLEMENT_OBSERVATION_INPUT_SCHEMA`.

Source: `lightbulb/finance_stripe_settlements.py:60`.

### `lightbulb.STRIPE_SETTLEMENT_OBSERVATION_RESULT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import STRIPE_SETTLEMENT_OBSERVATION_RESULT_SCHEMA
~~~


Binding: `lightbulb.finance_stripe_settlements.STRIPE_SETTLEMENT_OBSERVATION_RESULT_SCHEMA` → `lightbulb.finance_stripe_settlements.STRIPE_SETTLEMENT_OBSERVATION_RESULT_SCHEMA`.

Source: `lightbulb/finance_stripe_settlements.py:64`.

### `lightbulb.STRIPE_SETTLEMENT_TOOL_VERSION`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import STRIPE_SETTLEMENT_TOOL_VERSION
~~~


Binding: `lightbulb.finance_stripe_settlements.STRIPE_SETTLEMENT_TOOL_VERSION` → `lightbulb.finance_stripe_settlements.STRIPE_SETTLEMENT_TOOL_VERSION`.

Source: `lightbulb/finance_stripe_settlements.py:68`.

### `lightbulb.DiscoverStripeSettlementMovementsPrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import DiscoverStripeSettlementMovementsPrimitive
~~~


Binding: `lightbulb.finance_stripe_settlements.DiscoverStripeSettlementMovementsPrimitive` → `lightbulb.finance_stripe_settlements.DiscoverStripeSettlementMovementsPrimitive`.

Source: `lightbulb/finance_stripe_settlements.py:677`.

### `lightbulb.StripeSettlementMovement`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import StripeSettlementMovement
~~~


Binding: `lightbulb.finance_stripe_settlements.StripeSettlementMovement` → `lightbulb.finance_stripe_settlements.StripeSettlementMovement`.

Source: `lightbulb/finance_stripe_settlements.py:183`.

### `lightbulb.StripeSettlementObservationInput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import StripeSettlementObservationInput
~~~


Binding: `lightbulb.finance_stripe_settlements.StripeSettlementObservationInput` → `lightbulb.finance_stripe_settlements.StripeSettlementObservationInput`.

Source: `lightbulb/finance_stripe_settlements.py:168`.

### `lightbulb.StripeSettlementObservationResult`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import StripeSettlementObservationResult
~~~


Binding: `lightbulb.finance_stripe_settlements.StripeSettlementObservationResult` → `lightbulb.finance_stripe_settlements.StripeSettlementObservationResult`.

Source: `lightbulb/finance_stripe_settlements.py:232`.

### `lightbulb.FINANCE_SETTLEMENT_RECONCILIATION_EXECUTABLE_PRIMITIVES`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import FINANCE_SETTLEMENT_RECONCILIATION_EXECUTABLE_PRIMITIVES
~~~


Binding: `lightbulb.finance_settlement_reconciliation.FINANCE_SETTLEMENT_RECONCILIATION_EXECUTABLE_PRIMITIVES` → `lightbulb.finance_settlement_reconciliation.FINANCE_SETTLEMENT_RECONCILIATION_EXECUTABLE_PRIMITIVES`.

Source: `lightbulb/finance_settlement_reconciliation.py:1291`.

### `lightbulb.STRIPE_LEDGER_RECONCILIATION_EXCEPTION_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import STRIPE_LEDGER_RECONCILIATION_EXCEPTION_SCHEMA
~~~


Binding: `lightbulb.finance_settlement_reconciliation.STRIPE_LEDGER_RECONCILIATION_EXCEPTION_SCHEMA` → `lightbulb.finance_settlement_reconciliation.STRIPE_LEDGER_RECONCILIATION_EXCEPTION_SCHEMA`.

Source: `lightbulb/finance_settlement_reconciliation.py:62`.

### `lightbulb.STRIPE_LEDGER_RECONCILIATION_INPUT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import STRIPE_LEDGER_RECONCILIATION_INPUT_SCHEMA
~~~


Binding: `lightbulb.finance_settlement_reconciliation.STRIPE_LEDGER_RECONCILIATION_INPUT_SCHEMA` → `lightbulb.finance_settlement_reconciliation.STRIPE_LEDGER_RECONCILIATION_INPUT_SCHEMA`.

Source: `lightbulb/finance_settlement_reconciliation.py:56`.

### `lightbulb.STRIPE_LEDGER_RECONCILIATION_MATCH_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import STRIPE_LEDGER_RECONCILIATION_MATCH_SCHEMA
~~~


Binding: `lightbulb.finance_settlement_reconciliation.STRIPE_LEDGER_RECONCILIATION_MATCH_SCHEMA` → `lightbulb.finance_settlement_reconciliation.STRIPE_LEDGER_RECONCILIATION_MATCH_SCHEMA`.

Source: `lightbulb/finance_settlement_reconciliation.py:59`.

### `lightbulb.STRIPE_LEDGER_RECONCILIATION_RESULT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import STRIPE_LEDGER_RECONCILIATION_RESULT_SCHEMA
~~~


Binding: `lightbulb.finance_settlement_reconciliation.STRIPE_LEDGER_RECONCILIATION_RESULT_SCHEMA` → `lightbulb.finance_settlement_reconciliation.STRIPE_LEDGER_RECONCILIATION_RESULT_SCHEMA`.

Source: `lightbulb/finance_settlement_reconciliation.py:65`.

### `lightbulb.ReconcileStripeSettlementsPrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ReconcileStripeSettlementsPrimitive
~~~


Binding: `lightbulb.finance_settlement_reconciliation.ReconcileStripeSettlementsPrimitive` → `lightbulb.finance_settlement_reconciliation.ReconcileStripeSettlementsPrimitive`.

Source: `lightbulb/finance_settlement_reconciliation.py:1166`.

### `lightbulb.ReconciliationExceptionKind`

value. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ReconciliationExceptionKind
~~~


Binding: `lightbulb.finance_settlement_reconciliation.ReconciliationExceptionKind` → `lightbulb.finance_settlement_reconciliation.ReconciliationExceptionKind`.

Source: `lightbulb/finance_settlement_reconciliation.py:336`.

### `lightbulb.StripeLedgerMatchProposal`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import StripeLedgerMatchProposal
~~~


Binding: `lightbulb.finance_settlement_reconciliation.StripeLedgerMatchProposal` → `lightbulb.finance_settlement_reconciliation.StripeLedgerMatchProposal`.

Source: `lightbulb/finance_settlement_reconciliation.py:420`.

### `lightbulb.StripeLedgerReconciliationException`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import StripeLedgerReconciliationException
~~~


Binding: `lightbulb.finance_settlement_reconciliation.StripeLedgerReconciliationException` → `lightbulb.finance_settlement_reconciliation.StripeLedgerReconciliationException`.

Source: `lightbulb/finance_settlement_reconciliation.py:349`.

### `lightbulb.StripeLedgerReconciliationInput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import StripeLedgerReconciliationInput
~~~


Binding: `lightbulb.finance_settlement_reconciliation.StripeLedgerReconciliationInput` → `lightbulb.finance_settlement_reconciliation.StripeLedgerReconciliationInput`.

Source: `lightbulb/finance_settlement_reconciliation.py:186`.

### `lightbulb.StripeLedgerReconciliationMatch`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import StripeLedgerReconciliationMatch
~~~


Binding: `lightbulb.finance_settlement_reconciliation.StripeLedgerReconciliationMatch` → `lightbulb.finance_settlement_reconciliation.StripeLedgerReconciliationMatch`.

Source: `lightbulb/finance_settlement_reconciliation.py:282`.

### `lightbulb.StripeLedgerReconciliationResult`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import StripeLedgerReconciliationResult
~~~


Binding: `lightbulb.finance_settlement_reconciliation.StripeLedgerReconciliationResult` → `lightbulb.finance_settlement_reconciliation.StripeLedgerReconciliationResult`.

Source: `lightbulb/finance_settlement_reconciliation.py:526`.

### `lightbulb.StripeLedgerReconciliationSummary`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import StripeLedgerReconciliationSummary
~~~


Binding: `lightbulb.finance_settlement_reconciliation.StripeLedgerReconciliationSummary` → `lightbulb.finance_settlement_reconciliation.StripeLedgerReconciliationSummary`.

Source: `lightbulb/finance_settlement_reconciliation.py:460`.

### `lightbulb.reconcile_stripe_settlements`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import reconcile_stripe_settlements
~~~


Binding: `lightbulb.finance_settlement_reconciliation.reconcile_stripe_settlements` → `lightbulb.finance_settlement_reconciliation.reconcile_stripe_settlements`.

Source: `lightbulb/finance_settlement_reconciliation.py:725`.

### `lightbulb.DEFAULT_AMOUNT_TOLERANCE`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import DEFAULT_AMOUNT_TOLERANCE
~~~


Binding: `lightbulb.finance_reconciliation.DEFAULT_AMOUNT_TOLERANCE` → `lightbulb.finance_reconciliation.DEFAULT_AMOUNT_TOLERANCE`.

Source: `lightbulb/finance_reconciliation.py:48`.

### `lightbulb.DEFAULT_LEDGER_LIMIT`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import DEFAULT_LEDGER_LIMIT
~~~


Binding: `lightbulb.finance_reconciliation.DEFAULT_LEDGER_LIMIT` → `lightbulb.finance_reconciliation.DEFAULT_LEDGER_LIMIT`.

Source: `lightbulb/finance_reconciliation.py:46`.

### `lightbulb.DEFAULT_STRIPE_LIMIT`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import DEFAULT_STRIPE_LIMIT
~~~


Binding: `lightbulb.finance_reconciliation.DEFAULT_STRIPE_LIMIT` → `lightbulb.finance_reconciliation.DEFAULT_STRIPE_LIMIT`.

Source: `lightbulb/finance_reconciliation.py:44`.

### `lightbulb.FINANCE_RECONCILIATION_REQUEST_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import FINANCE_RECONCILIATION_REQUEST_SCHEMA
~~~


Binding: `lightbulb.finance_reconciliation.FINANCE_RECONCILIATION_REQUEST_SCHEMA` → `lightbulb.finance_reconciliation.FINANCE_RECONCILIATION_REQUEST_SCHEMA`.

Source: `lightbulb/finance_reconciliation.py:35`.

### `lightbulb.FINANCE_RECONCILIATION_RESULT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import FINANCE_RECONCILIATION_RESULT_SCHEMA
~~~


Binding: `lightbulb.finance_reconciliation.FINANCE_RECONCILIATION_RESULT_SCHEMA` → `lightbulb.finance_reconciliation.FINANCE_RECONCILIATION_RESULT_SCHEMA`.

Source: `lightbulb/finance_reconciliation.py:36`.

### `lightbulb.FINANCE_RECONCILIATION_RUN_DETAILS_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import FINANCE_RECONCILIATION_RUN_DETAILS_SCHEMA
~~~


Binding: `lightbulb.finance_reconciliation.FINANCE_RECONCILIATION_RUN_DETAILS_SCHEMA` → `lightbulb.finance_reconciliation.FINANCE_RECONCILIATION_RUN_DETAILS_SCHEMA`.

Source: `lightbulb/finance_reconciliation.py:40`.

### `lightbulb.FINANCE_RECONCILIATION_RUN_SUMMARY_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import FINANCE_RECONCILIATION_RUN_SUMMARY_SCHEMA
~~~


Binding: `lightbulb.finance_reconciliation.FINANCE_RECONCILIATION_RUN_SUMMARY_SCHEMA` → `lightbulb.finance_reconciliation.FINANCE_RECONCILIATION_RUN_SUMMARY_SCHEMA`.

Source: `lightbulb/finance_reconciliation.py:37`.

### `lightbulb.MAX_LEDGER_LIMIT`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import MAX_LEDGER_LIMIT
~~~


Binding: `lightbulb.finance_reconciliation.MAX_LEDGER_LIMIT` → `lightbulb.finance_reconciliation.MAX_LEDGER_LIMIT`.

Source: `lightbulb/finance_reconciliation.py:47`.

### `lightbulb.FINANCE_RECONCILIATION_PACKAGE_EXECUTABLE_PRIMITIVES`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import FINANCE_RECONCILIATION_PACKAGE_EXECUTABLE_PRIMITIVES
~~~


Binding: `lightbulb.finance_reconciliation_package.FINANCE_RECONCILIATION_PACKAGE_EXECUTABLE_PRIMITIVES` → `lightbulb.finance_reconciliation_package.FINANCE_RECONCILIATION_PACKAGE_EXECUTABLE_PRIMITIVES`.

Source: `lightbulb/finance_reconciliation_package.py:517`.

### `lightbulb.RECONCILIATION_PACKAGE_CANDIDATE_INPUT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import RECONCILIATION_PACKAGE_CANDIDATE_INPUT_SCHEMA
~~~


Binding: `lightbulb.finance_reconciliation_package.RECONCILIATION_PACKAGE_CANDIDATE_INPUT_SCHEMA` → `lightbulb.finance_reconciliation_package.RECONCILIATION_PACKAGE_CANDIDATE_INPUT_SCHEMA`.

Source: `lightbulb/finance_reconciliation_package.py:58`.

### `lightbulb.RECONCILIATION_PACKAGE_CANDIDATE_RESULT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import RECONCILIATION_PACKAGE_CANDIDATE_RESULT_SCHEMA
~~~


Binding: `lightbulb.finance_reconciliation_package.RECONCILIATION_PACKAGE_CANDIDATE_RESULT_SCHEMA` → `lightbulb.finance_reconciliation_package.RECONCILIATION_PACKAGE_CANDIDATE_RESULT_SCHEMA`.

Source: `lightbulb/finance_reconciliation_package.py:61`.

### `lightbulb.PrepareReconciliationPackageInput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PrepareReconciliationPackageInput
~~~


Binding: `lightbulb.finance_reconciliation_package.PrepareReconciliationPackageInput` → `lightbulb.finance_reconciliation_package.PrepareReconciliationPackageInput`.

Source: `lightbulb/finance_reconciliation_package.py:125`.

### `lightbulb.PrepareReconciliationPackagePrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PrepareReconciliationPackagePrimitive
~~~


Binding: `lightbulb.finance_reconciliation_package.PrepareReconciliationPackagePrimitive` → `lightbulb.finance_reconciliation_package.PrepareReconciliationPackagePrimitive`.

Source: `lightbulb/finance_reconciliation_package.py:414`.

### `lightbulb.ReconciliationPackageCandidateResult`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ReconciliationPackageCandidateResult
~~~


Binding: `lightbulb.finance_reconciliation_package.ReconciliationPackageCandidateResult` → `lightbulb.finance_reconciliation_package.ReconciliationPackageCandidateResult`.

Source: `lightbulb/finance_reconciliation_package.py:203`.

### `lightbulb.prepare_reconciliation_package`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import prepare_reconciliation_package
~~~


Binding: `lightbulb.finance_reconciliation_package.prepare_reconciliation_package` → `lightbulb.finance_reconciliation_package.prepare_reconciliation_package`.

Source: `lightbulb/finance_reconciliation_package.py:246`.

### `lightbulb.FINANCE_RECONCILIATION_TRANSITION_EXECUTABLE_PRIMITIVES`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import FINANCE_RECONCILIATION_TRANSITION_EXECUTABLE_PRIMITIVES
~~~


Binding: `lightbulb.finance_reconciliation_transition.FINANCE_RECONCILIATION_TRANSITION_EXECUTABLE_PRIMITIVES` → `lightbulb.finance_reconciliation_transition.FINANCE_RECONCILIATION_TRANSITION_EXECUTABLE_PRIMITIVES`.

Source: `lightbulb/finance_reconciliation_transition.py:735`.

### `lightbulb.RECONCILIATION_TRANSITION_COMMAND_INPUT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import RECONCILIATION_TRANSITION_COMMAND_INPUT_SCHEMA
~~~


Binding: `lightbulb.finance_reconciliation_transition.RECONCILIATION_TRANSITION_COMMAND_INPUT_SCHEMA` → `lightbulb.finance_reconciliation_transition.RECONCILIATION_TRANSITION_COMMAND_INPUT_SCHEMA`.

Source: `lightbulb/finance_reconciliation_transition.py:70`.

### `lightbulb.RECONCILIATION_TRANSITION_COMMAND_RESULT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import RECONCILIATION_TRANSITION_COMMAND_RESULT_SCHEMA
~~~


Binding: `lightbulb.finance_reconciliation_transition.RECONCILIATION_TRANSITION_COMMAND_RESULT_SCHEMA` → `lightbulb.finance_reconciliation_transition.RECONCILIATION_TRANSITION_COMMAND_RESULT_SCHEMA`.

Source: `lightbulb/finance_reconciliation_transition.py:73`.

### `lightbulb.PrepareReconciliationTransitionCommandInput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PrepareReconciliationTransitionCommandInput
~~~


Binding: `lightbulb.finance_reconciliation_transition.PrepareReconciliationTransitionCommandInput` → `lightbulb.finance_reconciliation_transition.PrepareReconciliationTransitionCommandInput`.

Source: `lightbulb/finance_reconciliation_transition.py:173`.

### `lightbulb.PrepareReconciliationTransitionCommandPrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PrepareReconciliationTransitionCommandPrimitive
~~~


Binding: `lightbulb.finance_reconciliation_transition.PrepareReconciliationTransitionCommandPrimitive` → `lightbulb.finance_reconciliation_transition.PrepareReconciliationTransitionCommandPrimitive`.

Source: `lightbulb/finance_reconciliation_transition.py:618`.

### `lightbulb.ReconciliationArtifactEvidenceClaim`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ReconciliationArtifactEvidenceClaim
~~~


Binding: `lightbulb.finance_reconciliation_transition.ReconciliationArtifactEvidenceClaim` → `lightbulb.finance_reconciliation_transition.ReconciliationArtifactEvidenceClaim`.

Source: `lightbulb/finance_reconciliation_transition.py:135`.

### `lightbulb.ReconciliationReviewEvidenceClaim`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ReconciliationReviewEvidenceClaim
~~~


Binding: `lightbulb.finance_reconciliation_transition.ReconciliationReviewEvidenceClaim` → `lightbulb.finance_reconciliation_transition.ReconciliationReviewEvidenceClaim`.

Source: `lightbulb/finance_reconciliation_transition.py:154`.

### `lightbulb.ReconciliationTransitionCommandResult`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ReconciliationTransitionCommandResult
~~~


Binding: `lightbulb.finance_reconciliation_transition.ReconciliationTransitionCommandResult` → `lightbulb.finance_reconciliation_transition.ReconciliationTransitionCommandResult`.

Source: `lightbulb/finance_reconciliation_transition.py:279`.

### `lightbulb.prepare_reconciliation_transition_command`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import prepare_reconciliation_transition_command
~~~


Binding: `lightbulb.finance_reconciliation_transition.prepare_reconciliation_transition_command` → `lightbulb.finance_reconciliation_transition.prepare_reconciliation_transition_command`.

Source: `lightbulb/finance_reconciliation_transition.py:368`.

### `lightbulb.MAX_STRIPE_LIMIT`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import MAX_STRIPE_LIMIT
~~~


Binding: `lightbulb.finance_reconciliation.MAX_STRIPE_LIMIT` → `lightbulb.finance_reconciliation.MAX_STRIPE_LIMIT`.

Source: `lightbulb/finance_reconciliation.py:45`.

### `lightbulb.AuthorityLevel`

value. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import AuthorityLevel
~~~


Binding: `lightbulb.finance_reconciliation.AuthorityLevel` → `lightbulb.finance_reconciliation.AuthorityLevel`.

Source: `lightbulb/finance_reconciliation.py:59`.

### `lightbulb.FinanceReconciliationCompletedRunSummary`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import FinanceReconciliationCompletedRunSummary
~~~


Binding: `lightbulb.finance_reconciliation.FinanceReconciliationCompletedRunSummary` → `lightbulb.finance_reconciliation.FinanceReconciliationCompletedRunSummary`.

Source: `lightbulb/finance_reconciliation.py:537`.

### `lightbulb.FinanceReconciliationControlSummary`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import FinanceReconciliationControlSummary
~~~


Binding: `lightbulb.finance_reconciliation.FinanceReconciliationControlSummary` → `lightbulb.finance_reconciliation.FinanceReconciliationControlSummary`.

Source: `lightbulb/finance_reconciliation.py:271`.

### `lightbulb.FinanceReconciliationCoverage`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import FinanceReconciliationCoverage
~~~


Binding: `lightbulb.finance_reconciliation.FinanceReconciliationCoverage` → `lightbulb.finance_reconciliation.FinanceReconciliationCoverage`.

Source: `lightbulb/finance_reconciliation.py:201`.

### `lightbulb.FinanceReconciliationExceptions`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import FinanceReconciliationExceptions
~~~


Binding: `lightbulb.finance_reconciliation.FinanceReconciliationExceptions` → `lightbulb.finance_reconciliation.FinanceReconciliationExceptions`.

Source: `lightbulb/finance_reconciliation.py:320`.

### `lightbulb.FinanceReconciliationFailedRunSummary`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import FinanceReconciliationFailedRunSummary
~~~


Binding: `lightbulb.finance_reconciliation.FinanceReconciliationFailedRunSummary` → `lightbulb.finance_reconciliation.FinanceReconciliationFailedRunSummary`.

Source: `lightbulb/finance_reconciliation.py:568`.

### `lightbulb.FinanceReconciliationInvoice`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import FinanceReconciliationInvoice
~~~


Binding: `lightbulb.finance_reconciliation.FinanceReconciliationInvoice` → `lightbulb.finance_reconciliation.FinanceReconciliationInvoice`.

Source: `lightbulb/finance_reconciliation.py:282`.

### `lightbulb.FinanceReconciliationMatch`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import FinanceReconciliationMatch
~~~


Binding: `lightbulb.finance_reconciliation.FinanceReconciliationMatch` → `lightbulb.finance_reconciliation.FinanceReconciliationMatch`.

Source: `lightbulb/finance_reconciliation.py:302`.

### `lightbulb.FinanceReconciliationParameters`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import FinanceReconciliationParameters
~~~


Binding: `lightbulb.finance_reconciliation.FinanceReconciliationParameters` → `lightbulb.finance_reconciliation.FinanceReconciliationParameters`.

Source: `lightbulb/finance_reconciliation.py:189`.

### `lightbulb.FinanceReconciliationProposedAction`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import FinanceReconciliationProposedAction
~~~


Binding: `lightbulb.finance_reconciliation.FinanceReconciliationProposedAction` → `lightbulb.finance_reconciliation.FinanceReconciliationProposedAction`.

Source: `lightbulb/finance_reconciliation.py:350`.

### `lightbulb.FinanceReconciliationRequest`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import FinanceReconciliationRequest
~~~


Binding: `lightbulb.finance_reconciliation.FinanceReconciliationRequest` → `lightbulb.finance_reconciliation.FinanceReconciliationRequest`.

Source: `lightbulb/finance_reconciliation.py:148`.

### `lightbulb.FinanceReconciliationResult`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import FinanceReconciliationResult
~~~


Binding: `lightbulb.finance_reconciliation.FinanceReconciliationResult` → `lightbulb.finance_reconciliation.FinanceReconciliationResult`.

Source: `lightbulb/finance_reconciliation.py:357`.

### `lightbulb.FinanceReconciliationRunDetails`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import FinanceReconciliationRunDetails
~~~


Binding: `lightbulb.finance_reconciliation.FinanceReconciliationRunDetails` → `lightbulb.finance_reconciliation.FinanceReconciliationRunDetails`.

Source: `lightbulb/finance_reconciliation.py:653`.

### `lightbulb.FinanceReconciliationRunSummary`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import FinanceReconciliationRunSummary
~~~


Binding: `lightbulb.finance_reconciliation.FinanceReconciliationRunSummary` → `lightbulb.finance_reconciliation.FinanceReconciliationRunSummary`.

Source: `lightbulb/finance_reconciliation.py:589`.

### `lightbulb.FinanceReconciliationStoredFailure`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import FinanceReconciliationStoredFailure
~~~


Binding: `lightbulb.finance_reconciliation.FinanceReconciliationStoredFailure` → `lightbulb.finance_reconciliation.FinanceReconciliationStoredFailure`.

Source: `lightbulb/finance_reconciliation.py:584`.

### `lightbulb.FinanceReconciliationStoredRequest`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import FinanceReconciliationStoredRequest
~~~


Binding: `lightbulb.finance_reconciliation.FinanceReconciliationStoredRequest` → `lightbulb.finance_reconciliation.FinanceReconciliationStoredRequest`.

Source: `lightbulb/finance_reconciliation.py:506`.

### `lightbulb.FinanceReconciliationStoredSummary`

value. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import FinanceReconciliationStoredSummary
~~~


Binding: `lightbulb.finance_reconciliation.FinanceReconciliationStoredSummary` → `lightbulb.finance_reconciliation.FinanceReconciliationStoredSummary`.

Source: `lightbulb/finance_reconciliation.py:578`.

### `lightbulb.FinanceReconciliationTotals`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import FinanceReconciliationTotals
~~~


Binding: `lightbulb.finance_reconciliation.FinanceReconciliationTotals` → `lightbulb.finance_reconciliation.FinanceReconciliationTotals`.

Source: `lightbulb/finance_reconciliation.py:239`.

### `lightbulb.LedgerProvider`

value. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import LedgerProvider
~~~


Binding: `lightbulb.finance_reconciliation.LedgerProvider` → `lightbulb.finance_reconciliation.LedgerProvider`.

Source: `lightbulb/finance_reconciliation.py:56`.

### `lightbulb.LedgerProviderRequest`

value. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import LedgerProviderRequest
~~~


Binding: `lightbulb.finance_reconciliation.LedgerProviderRequest` → `lightbulb.finance_reconciliation.LedgerProviderRequest`.

Source: `lightbulb/finance_reconciliation.py:55`.

### `lightbulb.SimulationMode`

value. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SimulationMode
~~~


Binding: `lightbulb.finance_reconciliation.SimulationMode` → `lightbulb.finance_reconciliation.SimulationMode`.

Source: `lightbulb/finance_reconciliation.py:57`.

### `lightbulb.build_finance_reconciliation_request`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import build_finance_reconciliation_request
~~~


Binding: `lightbulb.finance_reconciliation.build_finance_reconciliation_request` → `lightbulb.finance_reconciliation.build_finance_reconciliation_request`.

Source: `lightbulb/finance_reconciliation.py:775`.

### `lightbulb.parse_finance_reconciliation_run_details`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import parse_finance_reconciliation_run_details
~~~


Binding: `lightbulb.finance_reconciliation.parse_finance_reconciliation_run_details` → `lightbulb.finance_reconciliation.parse_finance_reconciliation_run_details`.

Source: `lightbulb/finance_reconciliation.py:882`.

### `lightbulb.parse_finance_reconciliation_run_summaries`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import parse_finance_reconciliation_run_summaries
~~~


Binding: `lightbulb.finance_reconciliation.parse_finance_reconciliation_run_summaries` → `lightbulb.finance_reconciliation.parse_finance_reconciliation_run_summaries`.

Source: `lightbulb/finance_reconciliation.py:862`.

### `lightbulb.parse_finance_reconciliation_result`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import parse_finance_reconciliation_result
~~~


Binding: `lightbulb.finance_reconciliation.parse_finance_reconciliation_result` → `lightbulb.finance_reconciliation.parse_finance_reconciliation_result`.

Source: `lightbulb/finance_reconciliation.py:821`.

### `lightbulb.GOODS_RECEIPT_SNAPSHOT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GOODS_RECEIPT_SNAPSHOT_SCHEMA
~~~


Binding: `lightbulb.procurement_controls.GOODS_RECEIPT_SNAPSHOT_SCHEMA` → `lightbulb.procurement_controls.GOODS_RECEIPT_SNAPSHOT_SCHEMA`.

Source: `lightbulb/procurement_controls.py:51`.

### `lightbulb.PURCHASE_ORDER_SNAPSHOT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PURCHASE_ORDER_SNAPSHOT_SCHEMA
~~~


Binding: `lightbulb.procurement_controls.PURCHASE_ORDER_SNAPSHOT_SCHEMA` → `lightbulb.procurement_controls.PURCHASE_ORDER_SNAPSHOT_SCHEMA`.

Source: `lightbulb/procurement_controls.py:50`.

### `lightbulb.PURCHASE_REQUISITION_SNAPSHOT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PURCHASE_REQUISITION_SNAPSHOT_SCHEMA
~~~


Binding: `lightbulb.procurement_controls.PURCHASE_REQUISITION_SNAPSHOT_SCHEMA` → `lightbulb.procurement_controls.PURCHASE_REQUISITION_SNAPSHOT_SCHEMA`.

Source: `lightbulb/procurement_controls.py:49`.

### `lightbulb.PURCHASE_TO_PAY_CONTROLS_INPUT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PURCHASE_TO_PAY_CONTROLS_INPUT_SCHEMA
~~~


Binding: `lightbulb.procurement_controls.PURCHASE_TO_PAY_CONTROLS_INPUT_SCHEMA` → `lightbulb.procurement_controls.PURCHASE_TO_PAY_CONTROLS_INPUT_SCHEMA`.

Source: `lightbulb/procurement_controls.py:53`.

### `lightbulb.PURCHASE_TO_PAY_CONTROLS_OPERATION`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PURCHASE_TO_PAY_CONTROLS_OPERATION
~~~


Binding: `lightbulb.procurement_controls.PURCHASE_TO_PAY_CONTROLS_OPERATION` → `lightbulb.procurement_controls.PURCHASE_TO_PAY_CONTROLS_OPERATION`.

Source: `lightbulb/procurement_controls.py:757`.

### `lightbulb.PURCHASE_TO_PAY_CONTROLS_RESULT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PURCHASE_TO_PAY_CONTROLS_RESULT_SCHEMA
~~~


Binding: `lightbulb.procurement_controls.PURCHASE_TO_PAY_CONTROLS_RESULT_SCHEMA` → `lightbulb.procurement_controls.PURCHASE_TO_PAY_CONTROLS_RESULT_SCHEMA`.

Source: `lightbulb/procurement_controls.py:54`.

### `lightbulb.SUPPLIER_INVOICE_SNAPSHOT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SUPPLIER_INVOICE_SNAPSHOT_SCHEMA
~~~


Binding: `lightbulb.procurement_controls.SUPPLIER_INVOICE_SNAPSHOT_SCHEMA` → `lightbulb.procurement_controls.SUPPLIER_INVOICE_SNAPSHOT_SCHEMA`.

Source: `lightbulb/procurement_controls.py:52`.

### `lightbulb.VENDOR_QUALIFICATION_SNAPSHOT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import VENDOR_QUALIFICATION_SNAPSHOT_SCHEMA
~~~


Binding: `lightbulb.procurement_controls.VENDOR_QUALIFICATION_SNAPSHOT_SCHEMA` → `lightbulb.procurement_controls.VENDOR_QUALIFICATION_SNAPSHOT_SCHEMA`.

Source: `lightbulb/procurement_controls.py:48`.

### `lightbulb.EvaluatePurchaseToPayControlsPrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import EvaluatePurchaseToPayControlsPrimitive
~~~


Binding: `lightbulb.procurement_controls.EvaluatePurchaseToPayControlsPrimitive` → `lightbulb.procurement_controls.EvaluatePurchaseToPayControlsPrimitive`.

Source: `lightbulb/procurement_controls.py:1922`.

### `lightbulb.GoodsReceiptLine`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GoodsReceiptLine
~~~


Binding: `lightbulb.procurement_controls.GoodsReceiptLine` → `lightbulb.procurement_controls.GoodsReceiptLine`.

Source: `lightbulb/procurement_controls.py:421`.

### `lightbulb.GoodsReceiptSnapshot`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GoodsReceiptSnapshot
~~~


Binding: `lightbulb.procurement_controls.GoodsReceiptSnapshot` → `lightbulb.procurement_controls.GoodsReceiptSnapshot`.

Source: `lightbulb/procurement_controls.py:459`.

### `lightbulb.ProcurementEffectBoundary`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProcurementEffectBoundary
~~~


Binding: `lightbulb.procurement_controls.ProcurementEffectBoundary` → `lightbulb.procurement_controls.ProcurementEffectBoundary`.

Source: `lightbulb/procurement_controls.py:748`.

### `lightbulb.ProcurementMaterialTraceRef`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProcurementMaterialTraceRef
~~~


Binding: `lightbulb.procurement_controls.ProcurementMaterialTraceRef` → `lightbulb.procurement_controls.ProcurementMaterialTraceRef`.

Source: `lightbulb/procurement_controls.py:234`.

### `lightbulb.PurchaseOrderLine`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PurchaseOrderLine
~~~


Binding: `lightbulb.procurement_controls.PurchaseOrderLine` → `lightbulb.procurement_controls.PurchaseOrderLine`.

Source: `lightbulb/procurement_controls.py:353`.

### `lightbulb.PurchaseOrderSnapshot`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PurchaseOrderSnapshot
~~~


Binding: `lightbulb.procurement_controls.PurchaseOrderSnapshot` → `lightbulb.procurement_controls.PurchaseOrderSnapshot`.

Source: `lightbulb/procurement_controls.py:373`.

### `lightbulb.PurchaseRequisitionLine`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PurchaseRequisitionLine
~~~


Binding: `lightbulb.procurement_controls.PurchaseRequisitionLine` → `lightbulb.procurement_controls.PurchaseRequisitionLine`.

Source: `lightbulb/procurement_controls.py:283`.

### `lightbulb.PurchaseRequisitionSnapshot`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PurchaseRequisitionSnapshot
~~~


Binding: `lightbulb.procurement_controls.PurchaseRequisitionSnapshot` → `lightbulb.procurement_controls.PurchaseRequisitionSnapshot`.

Source: `lightbulb/procurement_controls.py:302`.

### `lightbulb.PurchaseToPayControlPolicy`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PurchaseToPayControlPolicy
~~~


Binding: `lightbulb.procurement_controls.PurchaseToPayControlPolicy` → `lightbulb.procurement_controls.PurchaseToPayControlPolicy`.

Source: `lightbulb/procurement_controls.py:564`.

### `lightbulb.PurchaseToPayControlsInput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PurchaseToPayControlsInput
~~~


Binding: `lightbulb.procurement_controls.PurchaseToPayControlsInput` → `lightbulb.procurement_controls.PurchaseToPayControlsInput`.

Source: `lightbulb/procurement_controls.py:602`.

### `lightbulb.PurchaseToPayControlsResult`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PurchaseToPayControlsResult
~~~


Binding: `lightbulb.procurement_controls.PurchaseToPayControlsResult` → `lightbulb.procurement_controls.PurchaseToPayControlsResult`.

Source: `lightbulb/procurement_controls.py:768`.

### `lightbulb.PurchaseToPayFinding`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PurchaseToPayFinding
~~~


Binding: `lightbulb.procurement_controls.PurchaseToPayFinding` → `lightbulb.procurement_controls.PurchaseToPayFinding`.

Source: `lightbulb/procurement_controls.py:680`.

### `lightbulb.PurchaseToPayGateResult`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PurchaseToPayGateResult
~~~


Binding: `lightbulb.procurement_controls.PurchaseToPayGateResult` → `lightbulb.procurement_controls.PurchaseToPayGateResult`.

Source: `lightbulb/procurement_controls.py:689`.

### `lightbulb.PurchaseToPayLineResult`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PurchaseToPayLineResult
~~~


Binding: `lightbulb.procurement_controls.PurchaseToPayLineResult` → `lightbulb.procurement_controls.PurchaseToPayLineResult`.

Source: `lightbulb/procurement_controls.py:700`.

### `lightbulb.SupplierInvoiceLine`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SupplierInvoiceLine
~~~


Binding: `lightbulb.procurement_controls.SupplierInvoiceLine` → `lightbulb.procurement_controls.SupplierInvoiceLine`.

Source: `lightbulb/procurement_controls.py:493`.

### `lightbulb.SupplierInvoiceSnapshot`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SupplierInvoiceSnapshot
~~~


Binding: `lightbulb.procurement_controls.SupplierInvoiceSnapshot` → `lightbulb.procurement_controls.SupplierInvoiceSnapshot`.

Source: `lightbulb/procurement_controls.py:513`.

### `lightbulb.VendorQualificationSnapshot`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import VendorQualificationSnapshot
~~~


Binding: `lightbulb.procurement_controls.VendorQualificationSnapshot` → `lightbulb.procurement_controls.VendorQualificationSnapshot`.

Source: `lightbulb/procurement_controls.py:239`.

### `lightbulb.evaluate_purchase_to_pay_controls`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import evaluate_purchase_to_pay_controls
~~~


Binding: `lightbulb.procurement_controls.evaluate_purchase_to_pay_controls` → `lightbulb.procurement_controls.evaluate_purchase_to_pay_controls`.

Source: `lightbulb/procurement_controls.py:1009`.

### `lightbulb.procurement_snapshot_digest`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import procurement_snapshot_digest
~~~


Binding: `lightbulb.procurement_controls.procurement_snapshot_digest` → `lightbulb.procurement_controls.procurement_snapshot_digest`.

Source: `lightbulb/procurement_controls.py:216`.

### `lightbulb.PROCURE_TO_PAY_LIFECYCLE_EXECUTABLE_PRIMITIVES`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROCURE_TO_PAY_LIFECYCLE_EXECUTABLE_PRIMITIVES
~~~


Binding: `lightbulb.procure_to_pay_lifecycle.PROCURE_TO_PAY_LIFECYCLE_EXECUTABLE_PRIMITIVES` → `lightbulb.procure_to_pay_lifecycle.PROCURE_TO_PAY_LIFECYCLE_EXECUTABLE_PRIMITIVES`.

Source: `lightbulb/procure_to_pay_lifecycle.py:2578`.

### `lightbulb.PROCURE_TO_PAY_LIFECYCLE_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROCURE_TO_PAY_LIFECYCLE_SCHEMA
~~~


Binding: `lightbulb.procure_to_pay_lifecycle.PROCURE_TO_PAY_LIFECYCLE_SCHEMA` → `lightbulb.procure_to_pay_lifecycle.PROCURE_TO_PAY_LIFECYCLE_SCHEMA`.

Source: `lightbulb/procure_to_pay_lifecycle.py:60`.

### `lightbulb.PROCURE_TO_PAY_PROPOSAL_RESULT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROCURE_TO_PAY_PROPOSAL_RESULT_SCHEMA
~~~


Binding: `lightbulb.procure_to_pay_lifecycle.PROCURE_TO_PAY_PROPOSAL_RESULT_SCHEMA` → `lightbulb.procure_to_pay_lifecycle.PROCURE_TO_PAY_PROPOSAL_RESULT_SCHEMA`.

Source: `lightbulb/procure_to_pay_lifecycle.py:67`.

### `lightbulb.PROCURE_TO_PAY_SCOPE_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROCURE_TO_PAY_SCOPE_SCHEMA
~~~


Binding: `lightbulb.procure_to_pay_lifecycle.PROCURE_TO_PAY_SCOPE_SCHEMA` → `lightbulb.procure_to_pay_lifecycle.PROCURE_TO_PAY_SCOPE_SCHEMA`.

Source: `lightbulb/procure_to_pay_lifecycle.py:59`.

### `lightbulb.PROCURE_TO_PAY_TRANSITION_PROPOSAL_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROCURE_TO_PAY_TRANSITION_PROPOSAL_SCHEMA
~~~


Binding: `lightbulb.procure_to_pay_lifecycle.PROCURE_TO_PAY_TRANSITION_PROPOSAL_SCHEMA` → `lightbulb.procure_to_pay_lifecycle.PROCURE_TO_PAY_TRANSITION_PROPOSAL_SCHEMA`.

Source: `lightbulb/procure_to_pay_lifecycle.py:64`.

### `lightbulb.PROCURE_TO_PAY_TRANSITION_REQUEST_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROCURE_TO_PAY_TRANSITION_REQUEST_SCHEMA
~~~


Binding: `lightbulb.procure_to_pay_lifecycle.PROCURE_TO_PAY_TRANSITION_REQUEST_SCHEMA` → `lightbulb.procure_to_pay_lifecycle.PROCURE_TO_PAY_TRANSITION_REQUEST_SCHEMA`.

Source: `lightbulb/procure_to_pay_lifecycle.py:61`.

### `lightbulb.PROCURE_TO_PAY_TRANSITION_VALIDATION_RESULT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROCURE_TO_PAY_TRANSITION_VALIDATION_RESULT_SCHEMA
~~~


Binding: `lightbulb.procure_to_pay_lifecycle.PROCURE_TO_PAY_TRANSITION_VALIDATION_RESULT_SCHEMA` → `lightbulb.procure_to_pay_lifecycle.PROCURE_TO_PAY_TRANSITION_VALIDATION_RESULT_SCHEMA`.

Source: `lightbulb/procure_to_pay_lifecycle.py:71`.

### `lightbulb.SPRING_PROCUREMENT_TRANSITION_OPERATION`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SPRING_PROCUREMENT_TRANSITION_OPERATION
~~~


Binding: `lightbulb.procure_to_pay_lifecycle.SPRING_PROCUREMENT_TRANSITION_OPERATION` → `lightbulb.procure_to_pay_lifecycle.SPRING_PROCUREMENT_TRANSITION_OPERATION`.

Source: `lightbulb/procure_to_pay_lifecycle.py:75`.

### `lightbulb.SPRING_TRANSITION_EVIDENCE_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SPRING_TRANSITION_EVIDENCE_SCHEMA
~~~


Binding: `lightbulb.procure_to_pay_lifecycle.SPRING_TRANSITION_EVIDENCE_SCHEMA` → `lightbulb.procure_to_pay_lifecycle.SPRING_TRANSITION_EVIDENCE_SCHEMA`.

Source: `lightbulb/procure_to_pay_lifecycle.py:68`.

### `lightbulb.PROCURE_TO_PAY_GENESIS_DIGEST`

constant alias. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROCURE_TO_PAY_GENESIS_DIGEST
~~~


Binding: `lightbulb.procure_to_pay_lifecycle.ZERO_DIGEST` → `lightbulb.procure_to_pay_lifecycle.ZERO_DIGEST`.

Source: `lightbulb/procure_to_pay_lifecycle.py:76`.

### `lightbulb.ApproveRequisitionCommand`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ApproveRequisitionCommand
~~~


Binding: `lightbulb.procure_to_pay_lifecycle.ApproveRequisitionCommand` → `lightbulb.procure_to_pay_lifecycle.ApproveRequisitionCommand`.

Source: `lightbulb/procure_to_pay_lifecycle.py:1021`.

### `lightbulb.CloseProcureToPayCommand`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CloseProcureToPayCommand
~~~


Binding: `lightbulb.procure_to_pay_lifecycle.CloseProcureToPayCommand` → `lightbulb.procure_to_pay_lifecycle.CloseProcureToPayCommand`.

Source: `lightbulb/procure_to_pay_lifecycle.py:1063`.

### `lightbulb.CreatePurchaseOrderCommand`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CreatePurchaseOrderCommand
~~~


Binding: `lightbulb.procure_to_pay_lifecycle.CreatePurchaseOrderCommand` → `lightbulb.procure_to_pay_lifecycle.CreatePurchaseOrderCommand`.

Source: `lightbulb/procure_to_pay_lifecycle.py:1025`.

### `lightbulb.CreateRequisitionCommand`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CreateRequisitionCommand
~~~


Binding: `lightbulb.procure_to_pay_lifecycle.CreateRequisitionCommand` → `lightbulb.procure_to_pay_lifecycle.CreateRequisitionCommand`.

Source: `lightbulb/procure_to_pay_lifecycle.py:1006`.

### `lightbulb.EvaluateThreeWayMatchCommand`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import EvaluateThreeWayMatchCommand
~~~


Binding: `lightbulb.procure_to_pay_lifecycle.EvaluateThreeWayMatchCommand` → `lightbulb.procure_to_pay_lifecycle.EvaluateThreeWayMatchCommand`.

Source: `lightbulb/procure_to_pay_lifecycle.py:1051`.

### `lightbulb.ExceptionResolution`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ExceptionResolution
~~~


Binding: `lightbulb.procure_to_pay_lifecycle.ExceptionResolution` → `lightbulb.procure_to_pay_lifecycle.ExceptionResolution`.

Source: `lightbulb/procure_to_pay_lifecycle.py:620`.

### `lightbulb.GoodsReceipt`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GoodsReceipt
~~~


Binding: `lightbulb.procure_to_pay_lifecycle.GoodsReceipt` → `lightbulb.procure_to_pay_lifecycle.GoodsReceipt`.

Source: `lightbulb/procure_to_pay_lifecycle.py:449`.

### `lightbulb.ProcureToPayGoodsReceiptLine`

class alias. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProcureToPayGoodsReceiptLine
~~~


Binding: `lightbulb.procure_to_pay_lifecycle.GoodsReceiptLine` → `lightbulb.procure_to_pay_lifecycle.GoodsReceiptLine`.

Source: `lightbulb/procure_to_pay_lifecycle.py:421`.

### `lightbulb.IssuePurchaseOrderCommand`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import IssuePurchaseOrderCommand
~~~


Binding: `lightbulb.procure_to_pay_lifecycle.IssuePurchaseOrderCommand` → `lightbulb.procure_to_pay_lifecycle.IssuePurchaseOrderCommand`.

Source: `lightbulb/procure_to_pay_lifecycle.py:1036`.

### `lightbulb.ProcureToPayClosure`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProcureToPayClosure
~~~


Binding: `lightbulb.procure_to_pay_lifecycle.ProcureToPayClosure` → `lightbulb.procure_to_pay_lifecycle.ProcureToPayClosure`.

Source: `lightbulb/procure_to_pay_lifecycle.py:632`.

### `lightbulb.ProcureToPayLifecycle`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProcureToPayLifecycle
~~~


Binding: `lightbulb.procure_to_pay_lifecycle.ProcureToPayLifecycle` → `lightbulb.procure_to_pay_lifecycle.ProcureToPayLifecycle`.

Source: `lightbulb/procure_to_pay_lifecycle.py:678`.

### `lightbulb.ProcureToPayLifecycleError`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProcureToPayLifecycleError
~~~


Binding: `lightbulb.procure_to_pay_lifecycle.ProcureToPayLifecycleError` → `lightbulb.procure_to_pay_lifecycle.ProcureToPayLifecycleError`.

Source: `lightbulb/procure_to_pay_lifecycle.py:1539`.

### `lightbulb.ProcureToPayProposalResult`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProcureToPayProposalResult
~~~


Binding: `lightbulb.procure_to_pay_lifecycle.ProcureToPayProposalResult` → `lightbulb.procure_to_pay_lifecycle.ProcureToPayProposalResult`.

Source: `lightbulb/procure_to_pay_lifecycle.py:1243`.

### `lightbulb.ProcureToPayScope`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProcureToPayScope
~~~


Binding: `lightbulb.procure_to_pay_lifecycle.ProcureToPayScope` → `lightbulb.procure_to_pay_lifecycle.ProcureToPayScope`.

Source: `lightbulb/procure_to_pay_lifecycle.py:246`.

### `lightbulb.ProcureToPayState`

value. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProcureToPayState
~~~


Binding: `lightbulb.procure_to_pay_lifecycle.ProcureToPayState` → `lightbulb.procure_to_pay_lifecycle.ProcureToPayState`.

Source: `lightbulb/procure_to_pay_lifecycle.py:642`.

### `lightbulb.ProcureToPayTransitionProposal`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProcureToPayTransitionProposal
~~~


Binding: `lightbulb.procure_to_pay_lifecycle.ProcureToPayTransitionProposal` → `lightbulb.procure_to_pay_lifecycle.ProcureToPayTransitionProposal`.

Source: `lightbulb/procure_to_pay_lifecycle.py:1199`.

### `lightbulb.ProcureToPayTransitionRecord`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProcureToPayTransitionRecord
~~~


Binding: `lightbulb.procure_to_pay_lifecycle.ProcureToPayTransitionRecord` → `lightbulb.procure_to_pay_lifecycle.ProcureToPayTransitionRecord`.

Source: `lightbulb/procure_to_pay_lifecycle.py:656`.

### `lightbulb.ProcureToPayTransitionRequest`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProcureToPayTransitionRequest
~~~


Binding: `lightbulb.procure_to_pay_lifecycle.ProcureToPayTransitionRequest` → `lightbulb.procure_to_pay_lifecycle.ProcureToPayTransitionRequest`.

Source: `lightbulb/procure_to_pay_lifecycle.py:1090`.

### `lightbulb.ProcureToPayTransitionValidationResult`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProcureToPayTransitionValidationResult
~~~


Binding: `lightbulb.procure_to_pay_lifecycle.ProcureToPayTransitionValidationResult` → `lightbulb.procure_to_pay_lifecycle.ProcureToPayTransitionValidationResult`.

Source: `lightbulb/procure_to_pay_lifecycle.py:1493`.

### `lightbulb.ProposeProcureToPayTransitionPrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProposeProcureToPayTransitionPrimitive
~~~


Binding: `lightbulb.procure_to_pay_lifecycle.ProposeProcureToPayTransitionPrimitive` → `lightbulb.procure_to_pay_lifecycle.ProposeProcureToPayTransitionPrimitive`.

Source: `lightbulb/procure_to_pay_lifecycle.py:2413`.

### `lightbulb.PurchaseOrder`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PurchaseOrder
~~~


Binding: `lightbulb.procure_to_pay_lifecycle.PurchaseOrder` → `lightbulb.procure_to_pay_lifecycle.PurchaseOrder`.

Source: `lightbulb/procure_to_pay_lifecycle.py:367`.

### `lightbulb.ProcureToPayPurchaseOrderLine`

class alias. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProcureToPayPurchaseOrderLine
~~~


Binding: `lightbulb.procure_to_pay_lifecycle.PurchaseOrderLine` → `lightbulb.procure_to_pay_lifecycle.PurchaseOrderLine`.

Source: `lightbulb/procure_to_pay_lifecycle.py:339`.

### `lightbulb.PurchaseRequisition`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PurchaseRequisition
~~~


Binding: `lightbulb.procure_to_pay_lifecycle.PurchaseRequisition` → `lightbulb.procure_to_pay_lifecycle.PurchaseRequisition`.

Source: `lightbulb/procure_to_pay_lifecycle.py:305`.

### `lightbulb.RecordGoodsReceiptCommand`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import RecordGoodsReceiptCommand
~~~


Binding: `lightbulb.procure_to_pay_lifecycle.RecordGoodsReceiptCommand` → `lightbulb.procure_to_pay_lifecycle.RecordGoodsReceiptCommand`.

Source: `lightbulb/procure_to_pay_lifecycle.py:1046`.

### `lightbulb.RequisitionLine`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import RequisitionLine
~~~


Binding: `lightbulb.procure_to_pay_lifecycle.RequisitionLine` → `lightbulb.procure_to_pay_lifecycle.RequisitionLine`.

Source: `lightbulb/procure_to_pay_lifecycle.py:274`.

### `lightbulb.ResolveMatchExceptionCommand`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ResolveMatchExceptionCommand
~~~


Binding: `lightbulb.procure_to_pay_lifecycle.ResolveMatchExceptionCommand` → `lightbulb.procure_to_pay_lifecycle.ResolveMatchExceptionCommand`.

Source: `lightbulb/procure_to_pay_lifecycle.py:1058`.

### `lightbulb.SpringProcureToPayTransitionEvidence`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SpringProcureToPayTransitionEvidence
~~~


Binding: `lightbulb.procure_to_pay_lifecycle.SpringProcureToPayTransitionEvidence` → `lightbulb.procure_to_pay_lifecycle.SpringProcureToPayTransitionEvidence`.

Source: `lightbulb/procure_to_pay_lifecycle.py:1322`.

### `lightbulb.SubmitRequisitionCommand`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SubmitRequisitionCommand
~~~


Binding: `lightbulb.procure_to_pay_lifecycle.SubmitRequisitionCommand` → `lightbulb.procure_to_pay_lifecycle.SubmitRequisitionCommand`.

Source: `lightbulb/procure_to_pay_lifecycle.py:1017`.

### `lightbulb.SupplierInvoice`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SupplierInvoice
~~~


Binding: `lightbulb.procure_to_pay_lifecycle.SupplierInvoice` → `lightbulb.procure_to_pay_lifecycle.SupplierInvoice`.

Source: `lightbulb/procure_to_pay_lifecycle.py:505`.

### `lightbulb.ProcureToPaySupplierInvoiceLine`

class alias. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProcureToPaySupplierInvoiceLine
~~~


Binding: `lightbulb.procure_to_pay_lifecycle.SupplierInvoiceLine` → `lightbulb.procure_to_pay_lifecycle.SupplierInvoiceLine`.

Source: `lightbulb/procure_to_pay_lifecycle.py:477`.

### `lightbulb.ThreeWayMatchFinding`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ThreeWayMatchFinding
~~~


Binding: `lightbulb.procure_to_pay_lifecycle.ThreeWayMatchFinding` → `lightbulb.procure_to_pay_lifecycle.ThreeWayMatchFinding`.

Source: `lightbulb/procure_to_pay_lifecycle.py:564`.

### `lightbulb.ThreeWayMatchPolicy`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ThreeWayMatchPolicy
~~~


Binding: `lightbulb.procure_to_pay_lifecycle.ThreeWayMatchPolicy` → `lightbulb.procure_to_pay_lifecycle.ThreeWayMatchPolicy`.

Source: `lightbulb/procure_to_pay_lifecycle.py:548`.

### `lightbulb.ThreeWayMatchResult`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ThreeWayMatchResult
~~~


Binding: `lightbulb.procure_to_pay_lifecycle.ThreeWayMatchResult` → `lightbulb.procure_to_pay_lifecycle.ThreeWayMatchResult`.

Source: `lightbulb/procure_to_pay_lifecycle.py:570`.

### `lightbulb.propose_transition`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import propose_transition
~~~


Binding: `lightbulb.procure_to_pay_lifecycle.propose_transition` → `lightbulb.procure_to_pay_lifecycle.propose_transition`.

Source: `lightbulb/procure_to_pay_lifecycle.py:2097`.

### `lightbulb.spring_authority_binding_digest`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import spring_authority_binding_digest
~~~


Binding: `lightbulb.procure_to_pay_lifecycle.spring_authority_binding_digest` → `lightbulb.procure_to_pay_lifecycle.spring_authority_binding_digest`.

Source: `lightbulb/procure_to_pay_lifecycle.py:1286`.

### `lightbulb.validate_transition_evidence`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import validate_transition_evidence
~~~


Binding: `lightbulb.procure_to_pay_lifecycle.validate_transition_evidence` → `lightbulb.procure_to_pay_lifecycle.validate_transition_evidence`.

Source: `lightbulb/procure_to_pay_lifecycle.py:2184`.

### `lightbulb.EVIDENCE_PER_VENDOR_TRANSITION`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import EVIDENCE_PER_VENDOR_TRANSITION
~~~


Binding: `lightbulb.vendor_onboarding_lifecycle.EVIDENCE_PER_VENDOR_TRANSITION` → `lightbulb.vendor_onboarding_lifecycle.EVIDENCE_PER_VENDOR_TRANSITION`.

Source: `lightbulb/vendor_onboarding_lifecycle.py:64`.

### `lightbulb.MAX_VENDOR_ONBOARDING_TRANSITIONS`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import MAX_VENDOR_ONBOARDING_TRANSITIONS
~~~


Binding: `lightbulb.vendor_onboarding_lifecycle.MAX_VENDOR_ONBOARDING_TRANSITIONS` → `lightbulb.vendor_onboarding_lifecycle.MAX_VENDOR_ONBOARDING_TRANSITIONS`.

Source: `lightbulb/vendor_onboarding_lifecycle.py:63`.

### `lightbulb.VENDOR_ONBOARDING_EVIDENCE_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import VENDOR_ONBOARDING_EVIDENCE_SCHEMA
~~~


Binding: `lightbulb.vendor_onboarding_lifecycle.VENDOR_ONBOARDING_EVIDENCE_SCHEMA` → `lightbulb.vendor_onboarding_lifecycle.VENDOR_ONBOARDING_EVIDENCE_SCHEMA`.

Source: `lightbulb/vendor_onboarding_lifecycle.py:55`.

### `lightbulb.VENDOR_ONBOARDING_LIFECYCLE_EXECUTABLE_PRIMITIVES`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import VENDOR_ONBOARDING_LIFECYCLE_EXECUTABLE_PRIMITIVES
~~~


Binding: `lightbulb.vendor_onboarding_lifecycle.VENDOR_ONBOARDING_LIFECYCLE_EXECUTABLE_PRIMITIVES` → `lightbulb.vendor_onboarding_lifecycle.VENDOR_ONBOARDING_LIFECYCLE_EXECUTABLE_PRIMITIVES`.

Source: `lightbulb/vendor_onboarding_lifecycle.py:3034`.

### `lightbulb.VENDOR_ONBOARDING_PROPOSAL_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import VENDOR_ONBOARDING_PROPOSAL_SCHEMA
~~~


Binding: `lightbulb.vendor_onboarding_lifecycle.VENDOR_ONBOARDING_PROPOSAL_SCHEMA` → `lightbulb.vendor_onboarding_lifecycle.VENDOR_ONBOARDING_PROPOSAL_SCHEMA`.

Source: `lightbulb/vendor_onboarding_lifecycle.py:59`.

### `lightbulb.VENDOR_ONBOARDING_RECEIPT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import VENDOR_ONBOARDING_RECEIPT_SCHEMA
~~~


Binding: `lightbulb.vendor_onboarding_lifecycle.VENDOR_ONBOARDING_RECEIPT_SCHEMA` → `lightbulb.vendor_onboarding_lifecycle.VENDOR_ONBOARDING_RECEIPT_SCHEMA`.

Source: `lightbulb/vendor_onboarding_lifecycle.py:60`.

### `lightbulb.VENDOR_ONBOARDING_REQUEST_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import VENDOR_ONBOARDING_REQUEST_SCHEMA
~~~


Binding: `lightbulb.vendor_onboarding_lifecycle.VENDOR_ONBOARDING_REQUEST_SCHEMA` → `lightbulb.vendor_onboarding_lifecycle.VENDOR_ONBOARDING_REQUEST_SCHEMA`.

Source: `lightbulb/vendor_onboarding_lifecycle.py:58`.

### `lightbulb.VENDOR_ONBOARDING_RESULT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import VENDOR_ONBOARDING_RESULT_SCHEMA
~~~


Binding: `lightbulb.vendor_onboarding_lifecycle.VENDOR_ONBOARDING_RESULT_SCHEMA` → `lightbulb.vendor_onboarding_lifecycle.VENDOR_ONBOARDING_RESULT_SCHEMA`.

Source: `lightbulb/vendor_onboarding_lifecycle.py:61`.

### `lightbulb.VENDOR_ONBOARDING_SCOPE_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import VENDOR_ONBOARDING_SCOPE_SCHEMA
~~~


Binding: `lightbulb.vendor_onboarding_lifecycle.VENDOR_ONBOARDING_SCOPE_SCHEMA` → `lightbulb.vendor_onboarding_lifecycle.VENDOR_ONBOARDING_SCOPE_SCHEMA`.

Source: `lightbulb/vendor_onboarding_lifecycle.py:54`.

### `lightbulb.VENDOR_ONBOARDING_SNAPSHOT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import VENDOR_ONBOARDING_SNAPSHOT_SCHEMA
~~~


Binding: `lightbulb.vendor_onboarding_lifecycle.VENDOR_ONBOARDING_SNAPSHOT_SCHEMA` → `lightbulb.vendor_onboarding_lifecycle.VENDOR_ONBOARDING_SNAPSHOT_SCHEMA`.

Source: `lightbulb/vendor_onboarding_lifecycle.py:57`.

### `lightbulb.VENDOR_ONBOARDING_TRANSITION_OPERATION`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import VENDOR_ONBOARDING_TRANSITION_OPERATION
~~~


Binding: `lightbulb.vendor_onboarding_lifecycle.VENDOR_ONBOARDING_TRANSITION_OPERATION` → `lightbulb.vendor_onboarding_lifecycle.VENDOR_ONBOARDING_TRANSITION_OPERATION`.

Source: `lightbulb/vendor_onboarding_lifecycle.py:2614`.

### `lightbulb.VENDOR_ONBOARDING_TRANSITION_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import VENDOR_ONBOARDING_TRANSITION_SCHEMA
~~~


Binding: `lightbulb.vendor_onboarding_lifecycle.VENDOR_ONBOARDING_TRANSITION_SCHEMA` → `lightbulb.vendor_onboarding_lifecycle.VENDOR_ONBOARDING_TRANSITION_SCHEMA`.

Source: `lightbulb/vendor_onboarding_lifecycle.py:56`.

### `lightbulb.VENDOR_ONBOARDING_ZERO_DIGEST`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import VENDOR_ONBOARDING_ZERO_DIGEST
~~~


Binding: `lightbulb.vendor_onboarding_lifecycle.VENDOR_ONBOARDING_ZERO_DIGEST` → `lightbulb.vendor_onboarding_lifecycle.VENDOR_ONBOARDING_ZERO_DIGEST`.

Source: `lightbulb/vendor_onboarding_lifecycle.py:62`.

### `lightbulb.AssessVendorQualificationCommand`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import AssessVendorQualificationCommand
~~~


Binding: `lightbulb.vendor_onboarding_lifecycle.AssessVendorQualificationCommand` → `lightbulb.vendor_onboarding_lifecycle.AssessVendorQualificationCommand`.

Source: `lightbulb/vendor_onboarding_lifecycle.py:537`.

### `lightbulb.CaptureVendorIdentityCommand`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CaptureVendorIdentityCommand
~~~


Binding: `lightbulb.vendor_onboarding_lifecycle.CaptureVendorIdentityCommand` → `lightbulb.vendor_onboarding_lifecycle.CaptureVendorIdentityCommand`.

Source: `lightbulb/vendor_onboarding_lifecycle.py:422`.

### `lightbulb.ClearVendorDueDiligenceCommand`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ClearVendorDueDiligenceCommand
~~~


Binding: `lightbulb.vendor_onboarding_lifecycle.ClearVendorDueDiligenceCommand` → `lightbulb.vendor_onboarding_lifecycle.ClearVendorDueDiligenceCommand`.

Source: `lightbulb/vendor_onboarding_lifecycle.py:480`.

### `lightbulb.ProposeVendorActivationCommand`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProposeVendorActivationCommand
~~~


Binding: `lightbulb.vendor_onboarding_lifecycle.ProposeVendorActivationCommand` → `lightbulb.vendor_onboarding_lifecycle.ProposeVendorActivationCommand`.

Source: `lightbulb/vendor_onboarding_lifecycle.py:842`.

### `lightbulb.ProposeVendorApprovalCommand`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProposeVendorApprovalCommand
~~~


Binding: `lightbulb.vendor_onboarding_lifecycle.ProposeVendorApprovalCommand` → `lightbulb.vendor_onboarding_lifecycle.ProposeVendorApprovalCommand`.

Source: `lightbulb/vendor_onboarding_lifecycle.py:625`.

### `lightbulb.ProposeVendorOnboardingTransitionPrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProposeVendorOnboardingTransitionPrimitive
~~~


Binding: `lightbulb.vendor_onboarding_lifecycle.ProposeVendorOnboardingTransitionPrimitive` → `lightbulb.vendor_onboarding_lifecycle.ProposeVendorOnboardingTransitionPrimitive`.

Source: `lightbulb/vendor_onboarding_lifecycle.py:2777`.

### `lightbulb.QualificationCondition`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import QualificationCondition
~~~


Binding: `lightbulb.vendor_onboarding_lifecycle.QualificationCondition` → `lightbulb.vendor_onboarding_lifecycle.QualificationCondition`.

Source: `lightbulb/vendor_onboarding_lifecycle.py:393`.

### `lightbulb.RecordVendorSetupReadinessCommand`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import RecordVendorSetupReadinessCommand
~~~


Binding: `lightbulb.vendor_onboarding_lifecycle.RecordVendorSetupReadinessCommand` → `lightbulb.vendor_onboarding_lifecycle.RecordVendorSetupReadinessCommand`.

Source: `lightbulb/vendor_onboarding_lifecycle.py:791`.

### `lightbulb.VendorOnboardingCommand`

value. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import VendorOnboardingCommand
~~~


Binding: `lightbulb.vendor_onboarding_lifecycle.VendorOnboardingCommand` → `lightbulb.vendor_onboarding_lifecycle.VendorOnboardingCommand`.

Source: `lightbulb/vendor_onboarding_lifecycle.py:891`.

### `lightbulb.VendorOnboardingEffectBoundary`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import VendorOnboardingEffectBoundary
~~~


Binding: `lightbulb.vendor_onboarding_lifecycle.VendorOnboardingEffectBoundary` → `lightbulb.vendor_onboarding_lifecycle.VendorOnboardingEffectBoundary`.

Source: `lightbulb/vendor_onboarding_lifecycle.py:1437`.

### `lightbulb.VendorOnboardingEvidence`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import VendorOnboardingEvidence
~~~


Binding: `lightbulb.vendor_onboarding_lifecycle.VendorOnboardingEvidence` → `lightbulb.vendor_onboarding_lifecycle.VendorOnboardingEvidence`.

Source: `lightbulb/vendor_onboarding_lifecycle.py:287`.

### `lightbulb.VendorOnboardingLifecycleError`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import VendorOnboardingLifecycleError
~~~


Binding: `lightbulb.vendor_onboarding_lifecycle.VendorOnboardingLifecycleError` → `lightbulb.vendor_onboarding_lifecycle.VendorOnboardingLifecycleError`.

Source: `lightbulb/vendor_onboarding_lifecycle.py:91`.

### `lightbulb.VendorOnboardingRecovery`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import VendorOnboardingRecovery
~~~


Binding: `lightbulb.vendor_onboarding_lifecycle.VendorOnboardingRecovery` → `lightbulb.vendor_onboarding_lifecycle.VendorOnboardingRecovery`.

Source: `lightbulb/vendor_onboarding_lifecycle.py:2250`.

### `lightbulb.VendorOnboardingScope`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import VendorOnboardingScope
~~~


Binding: `lightbulb.vendor_onboarding_lifecycle.VendorOnboardingScope` → `lightbulb.vendor_onboarding_lifecycle.VendorOnboardingScope`.

Source: `lightbulb/vendor_onboarding_lifecycle.py:230`.

### `lightbulb.VendorOnboardingSnapshot`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import VendorOnboardingSnapshot
~~~


Binding: `lightbulb.vendor_onboarding_lifecycle.VendorOnboardingSnapshot` → `lightbulb.vendor_onboarding_lifecycle.VendorOnboardingSnapshot`.

Source: `lightbulb/vendor_onboarding_lifecycle.py:1194`.

### `lightbulb.VendorOnboardingTransitionProposal`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import VendorOnboardingTransitionProposal
~~~


Binding: `lightbulb.vendor_onboarding_lifecycle.VendorOnboardingTransitionProposal` → `lightbulb.vendor_onboarding_lifecycle.VendorOnboardingTransitionProposal`.

Source: `lightbulb/vendor_onboarding_lifecycle.py:1453`.

### `lightbulb.VendorOnboardingTransitionReceipt`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import VendorOnboardingTransitionReceipt
~~~


Binding: `lightbulb.vendor_onboarding_lifecycle.VendorOnboardingTransitionReceipt` → `lightbulb.vendor_onboarding_lifecycle.VendorOnboardingTransitionReceipt`.

Source: `lightbulb/vendor_onboarding_lifecycle.py:2266`.

### `lightbulb.VendorOnboardingTransitionRecord`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import VendorOnboardingTransitionRecord
~~~


Binding: `lightbulb.vendor_onboarding_lifecycle.VendorOnboardingTransitionRecord` → `lightbulb.vendor_onboarding_lifecycle.VendorOnboardingTransitionRecord`.

Source: `lightbulb/vendor_onboarding_lifecycle.py:1055`.

### `lightbulb.VendorOnboardingTransitionRequest`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import VendorOnboardingTransitionRequest
~~~


Binding: `lightbulb.vendor_onboarding_lifecycle.VendorOnboardingTransitionRequest` → `lightbulb.vendor_onboarding_lifecycle.VendorOnboardingTransitionRequest`.

Source: `lightbulb/vendor_onboarding_lifecycle.py:1279`.

### `lightbulb.VendorOnboardingTransitionResult`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import VendorOnboardingTransitionResult
~~~


Binding: `lightbulb.vendor_onboarding_lifecycle.VendorOnboardingTransitionResult` → `lightbulb.vendor_onboarding_lifecycle.VendorOnboardingTransitionResult`.

Source: `lightbulb/vendor_onboarding_lifecycle.py:2371`.

### `lightbulb.VerifyVendorBankControlCommand`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import VerifyVendorBankControlCommand
~~~


Binding: `lightbulb.vendor_onboarding_lifecycle.VerifyVendorBankControlCommand` → `lightbulb.vendor_onboarding_lifecycle.VerifyVendorBankControlCommand`.

Source: `lightbulb/vendor_onboarding_lifecycle.py:696`.

### `lightbulb.propose_vendor_onboarding_transition`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import propose_vendor_onboarding_transition
~~~


Binding: `lightbulb.vendor_onboarding_lifecycle.propose_vendor_onboarding_transition` → `lightbulb.vendor_onboarding_lifecycle.propose_vendor_onboarding_transition`.

Source: `lightbulb/vendor_onboarding_lifecycle.py:2554`.

### `lightbulb.vendor_onboarding_command_digest`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import vendor_onboarding_command_digest
~~~


Binding: `lightbulb.vendor_onboarding_lifecycle.vendor_onboarding_command_digest` → `lightbulb.vendor_onboarding_lifecycle.vendor_onboarding_command_digest`.

Source: `lightbulb/vendor_onboarding_lifecycle.py:906`.

### `lightbulb.vendor_onboarding_evidence_lineage_digest`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import vendor_onboarding_evidence_lineage_digest
~~~


Binding: `lightbulb.vendor_onboarding_lifecycle.vendor_onboarding_evidence_lineage_digest` → `lightbulb.vendor_onboarding_lifecycle.vendor_onboarding_evidence_lineage_digest`.

Source: `lightbulb/vendor_onboarding_lifecycle.py:382`.

### `lightbulb.vendor_onboarding_fact_evidence_digest`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import vendor_onboarding_fact_evidence_digest
~~~


Binding: `lightbulb.vendor_onboarding_lifecycle.vendor_onboarding_fact_evidence_digest` → `lightbulb.vendor_onboarding_lifecycle.vendor_onboarding_fact_evidence_digest`.

Source: `lightbulb/vendor_onboarding_lifecycle.py:1028`.

### `lightbulb.vendor_onboarding_idempotency_digest`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import vendor_onboarding_idempotency_digest
~~~


Binding: `lightbulb.vendor_onboarding_lifecycle.vendor_onboarding_idempotency_digest` → `lightbulb.vendor_onboarding_lifecycle.vendor_onboarding_idempotency_digest`.

Source: `lightbulb/vendor_onboarding_lifecycle.py:984`.

### `lightbulb.vendor_onboarding_scope_digest`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import vendor_onboarding_scope_digest
~~~


Binding: `lightbulb.vendor_onboarding_lifecycle.vendor_onboarding_scope_digest` → `lightbulb.vendor_onboarding_lifecycle.vendor_onboarding_scope_digest`.

Source: `lightbulb/vendor_onboarding_lifecycle.py:280`.

### `lightbulb.vendor_onboarding_snapshot_digest`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import vendor_onboarding_snapshot_digest
~~~


Binding: `lightbulb.vendor_onboarding_lifecycle.vendor_onboarding_snapshot_digest` → `lightbulb.vendor_onboarding_lifecycle.vendor_onboarding_snapshot_digest`.

Source: `lightbulb/vendor_onboarding_lifecycle.py:1183`.

### `lightbulb.vendor_onboarding_transition_commitment_digest`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import vendor_onboarding_transition_commitment_digest
~~~


Binding: `lightbulb.vendor_onboarding_lifecycle.vendor_onboarding_transition_commitment_digest` → `lightbulb.vendor_onboarding_lifecycle.vendor_onboarding_transition_commitment_digest`.

Source: `lightbulb/vendor_onboarding_lifecycle.py:1044`.

### `lightbulb.vendor_onboarding_transition_content_digest`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import vendor_onboarding_transition_content_digest
~~~


Binding: `lightbulb.vendor_onboarding_lifecycle.vendor_onboarding_transition_content_digest` → `lightbulb.vendor_onboarding_lifecycle.vendor_onboarding_transition_content_digest`.

Source: `lightbulb/vendor_onboarding_lifecycle.py:1392`.

### `lightbulb.FINANCE_OPERATING_CONTROLS_INPUT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import FINANCE_OPERATING_CONTROLS_INPUT_SCHEMA
~~~


Binding: `lightbulb.finance_operating_controls.FINANCE_OPERATING_CONTROLS_INPUT_SCHEMA` → `lightbulb.finance_operating_controls.FINANCE_OPERATING_CONTROLS_INPUT_SCHEMA`.

Source: `lightbulb/finance_operating_controls.py:47`.

### `lightbulb.FINANCE_OPERATING_CONTROLS_OPERATION`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import FINANCE_OPERATING_CONTROLS_OPERATION
~~~


Binding: `lightbulb.finance_operating_controls.FINANCE_OPERATING_CONTROLS_OPERATION` → `lightbulb.finance_operating_controls.FINANCE_OPERATING_CONTROLS_OPERATION`.

Source: `lightbulb/finance_operating_controls.py:584`.

### `lightbulb.FINANCE_OPERATING_CONTROLS_RESULT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import FINANCE_OPERATING_CONTROLS_RESULT_SCHEMA
~~~


Binding: `lightbulb.finance_operating_controls.FINANCE_OPERATING_CONTROLS_RESULT_SCHEMA` → `lightbulb.finance_operating_controls.FINANCE_OPERATING_CONTROLS_RESULT_SCHEMA`.

Source: `lightbulb/finance_operating_controls.py:50`.

### `lightbulb.FINANCE_OPERATING_EXECUTABLE_PRIMITIVES`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import FINANCE_OPERATING_EXECUTABLE_PRIMITIVES
~~~


Binding: `lightbulb.finance_operating_controls.FINANCE_OPERATING_EXECUTABLE_PRIMITIVES` → `lightbulb.finance_operating_controls.FINANCE_OPERATING_EXECUTABLE_PRIMITIVES`.

Source: `lightbulb/finance_operating_controls.py:1224`.

### `lightbulb.EvaluateFinanceOperatingControlsPrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import EvaluateFinanceOperatingControlsPrimitive
~~~


Binding: `lightbulb.finance_operating_controls.EvaluateFinanceOperatingControlsPrimitive` → `lightbulb.finance_operating_controls.EvaluateFinanceOperatingControlsPrimitive`.

Source: `lightbulb/finance_operating_controls.py:1134`.

### `lightbulb.FinanceOperatingControlsInput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import FinanceOperatingControlsInput
~~~


Binding: `lightbulb.finance_operating_controls.FinanceOperatingControlsInput` → `lightbulb.finance_operating_controls.FinanceOperatingControlsInput`.

Source: `lightbulb/finance_operating_controls.py:405`.

### `lightbulb.FinanceOperatingControlsResult`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import FinanceOperatingControlsResult
~~~


Binding: `lightbulb.finance_operating_controls.FinanceOperatingControlsResult` → `lightbulb.finance_operating_controls.FinanceOperatingControlsResult`.

Source: `lightbulb/finance_operating_controls.py:489`.

### `lightbulb.FinanceOperatingDisposition`

value. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import FinanceOperatingDisposition
~~~


Binding: `lightbulb.finance_operating_controls.FinanceOperatingDisposition` → `lightbulb.finance_operating_controls.FinanceOperatingDisposition`.

Source: `lightbulb/finance_operating_controls.py:79`.

### `lightbulb.FinanceOperatingPolicy`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import FinanceOperatingPolicy
~~~


Binding: `lightbulb.finance_operating_controls.FinanceOperatingPolicy` → `lightbulb.finance_operating_controls.FinanceOperatingPolicy`.

Source: `lightbulb/finance_operating_controls.py:371`.

### `lightbulb.evaluate_finance_operating_controls`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import evaluate_finance_operating_controls
~~~


Binding: `lightbulb.finance_operating_controls.evaluate_finance_operating_controls` → `lightbulb.finance_operating_controls.evaluate_finance_operating_controls`.

Source: `lightbulb/finance_operating_controls.py:686`.

### `lightbulb.PLAN_FULFILLMENT_CONTROLS_INPUT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PLAN_FULFILLMENT_CONTROLS_INPUT_SCHEMA
~~~


Binding: `lightbulb.supply_chain_controls.PLAN_FULFILLMENT_CONTROLS_INPUT_SCHEMA` → `lightbulb.supply_chain_controls.PLAN_FULFILLMENT_CONTROLS_INPUT_SCHEMA`.

Source: `lightbulb/supply_chain_controls.py:59`.

### `lightbulb.PLAN_FULFILLMENT_CONTROLS_RESULT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PLAN_FULFILLMENT_CONTROLS_RESULT_SCHEMA
~~~


Binding: `lightbulb.supply_chain_controls.PLAN_FULFILLMENT_CONTROLS_RESULT_SCHEMA` → `lightbulb.supply_chain_controls.PLAN_FULFILLMENT_CONTROLS_RESULT_SCHEMA`.

Source: `lightbulb/supply_chain_controls.py:62`.

### `lightbulb.SUPPLY_CHAIN_EVALUATION_OPERATION`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SUPPLY_CHAIN_EVALUATION_OPERATION
~~~


Binding: `lightbulb.supply_chain_controls.SUPPLY_CHAIN_EVALUATION_OPERATION` → `lightbulb.supply_chain_controls.SUPPLY_CHAIN_EVALUATION_OPERATION`.

Source: `lightbulb/supply_chain_controls.py:1071`.

### `lightbulb.SUPPLY_CHAIN_EXECUTABLE_PRIMITIVES`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SUPPLY_CHAIN_EXECUTABLE_PRIMITIVES
~~~


Binding: `lightbulb.supply_chain_controls.SUPPLY_CHAIN_EXECUTABLE_PRIMITIVES` → `lightbulb.supply_chain_controls.SUPPLY_CHAIN_EXECUTABLE_PRIMITIVES`.

Source: `lightbulb/supply_chain_controls.py:3274`.

### `lightbulb.EvaluatePlanFulfillmentControlsPrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import EvaluatePlanFulfillmentControlsPrimitive
~~~


Binding: `lightbulb.supply_chain_controls.EvaluatePlanFulfillmentControlsPrimitive` → `lightbulb.supply_chain_controls.EvaluatePlanFulfillmentControlsPrimitive`.

Source: `lightbulb/supply_chain_controls.py:3152`.

### `lightbulb.PlanFulfillmentControlsInput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PlanFulfillmentControlsInput
~~~


Binding: `lightbulb.supply_chain_controls.PlanFulfillmentControlsInput` → `lightbulb.supply_chain_controls.PlanFulfillmentControlsInput`.

Source: `lightbulb/supply_chain_controls.py:810`.

### `lightbulb.PlanFulfillmentControlsResult`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PlanFulfillmentControlsResult
~~~


Binding: `lightbulb.supply_chain_controls.PlanFulfillmentControlsResult` → `lightbulb.supply_chain_controls.PlanFulfillmentControlsResult`.

Source: `lightbulb/supply_chain_controls.py:985`.

### `lightbulb.PlanFulfillmentDisposition`

value. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PlanFulfillmentDisposition
~~~


Binding: `lightbulb.supply_chain_controls.PlanFulfillmentDisposition` → `lightbulb.supply_chain_controls.PlanFulfillmentDisposition`.

Source: `lightbulb/supply_chain_controls.py:170`.

### `lightbulb.SupplyChainControlPolicy`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SupplyChainControlPolicy
~~~


Binding: `lightbulb.supply_chain_controls.SupplyChainControlPolicy` → `lightbulb.supply_chain_controls.SupplyChainControlPolicy`.

Source: `lightbulb/supply_chain_controls.py:319`.

### `lightbulb.SupplyChainEffectBoundary`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SupplyChainEffectBoundary
~~~


Binding: `lightbulb.supply_chain_controls.SupplyChainEffectBoundary` → `lightbulb.supply_chain_controls.SupplyChainEffectBoundary`.

Source: `lightbulb/supply_chain_controls.py:972`.

### `lightbulb.evaluate_plan_fulfillment_controls`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import evaluate_plan_fulfillment_controls
~~~


Binding: `lightbulb.supply_chain_controls.evaluate_plan_fulfillment_controls` → `lightbulb.supply_chain_controls.evaluate_plan_fulfillment_controls`.

Source: `lightbulb/supply_chain_controls.py:1409`.

### `lightbulb.SPRING_SUPPLY_CHAIN_EVIDENCE_CUSTODIAN`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SPRING_SUPPLY_CHAIN_EVIDENCE_CUSTODIAN
~~~


Binding: `lightbulb.supply_chain_execution_lifecycle.SPRING_SUPPLY_CHAIN_EVIDENCE_CUSTODIAN` → `lightbulb.supply_chain_execution_lifecycle.SPRING_SUPPLY_CHAIN_EVIDENCE_CUSTODIAN`.

Source: `lightbulb/supply_chain_execution_lifecycle.py:61`.

### `lightbulb.SPRING_SUPPLY_CHAIN_EVIDENCE_ISSUER`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SPRING_SUPPLY_CHAIN_EVIDENCE_ISSUER
~~~


Binding: `lightbulb.supply_chain_execution_lifecycle.SPRING_SUPPLY_CHAIN_EVIDENCE_ISSUER` → `lightbulb.supply_chain_execution_lifecycle.SPRING_SUPPLY_CHAIN_EVIDENCE_ISSUER`.

Source: `lightbulb/supply_chain_execution_lifecycle.py:60`.

### `lightbulb.SUPPLY_CHAIN_APPROVAL_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SUPPLY_CHAIN_APPROVAL_SCHEMA
~~~


Binding: `lightbulb.supply_chain_execution_lifecycle.SUPPLY_CHAIN_APPROVAL_SCHEMA` → `lightbulb.supply_chain_execution_lifecycle.SUPPLY_CHAIN_APPROVAL_SCHEMA`.

Source: `lightbulb/supply_chain_execution_lifecycle.py:52`.

### `lightbulb.SUPPLY_CHAIN_EVIDENCE_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SUPPLY_CHAIN_EVIDENCE_SCHEMA
~~~


Binding: `lightbulb.supply_chain_execution_lifecycle.SUPPLY_CHAIN_EVIDENCE_SCHEMA` → `lightbulb.supply_chain_execution_lifecycle.SUPPLY_CHAIN_EVIDENCE_SCHEMA`.

Source: `lightbulb/supply_chain_execution_lifecycle.py:51`.

### `lightbulb.SUPPLY_CHAIN_EXECUTION_LIFECYCLE_EXECUTABLE_PRIMITIVES`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SUPPLY_CHAIN_EXECUTION_LIFECYCLE_EXECUTABLE_PRIMITIVES
~~~


Binding: `lightbulb.supply_chain_execution_lifecycle.SUPPLY_CHAIN_EXECUTION_LIFECYCLE_EXECUTABLE_PRIMITIVES` → `lightbulb.supply_chain_execution_lifecycle.SUPPLY_CHAIN_EXECUTION_LIFECYCLE_EXECUTABLE_PRIMITIVES`.

Source: `lightbulb/supply_chain_execution_lifecycle.py:2875`.

### `lightbulb.SUPPLY_CHAIN_EXECUTION_TRANSITION_OPERATION`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SUPPLY_CHAIN_EXECUTION_TRANSITION_OPERATION
~~~


Binding: `lightbulb.supply_chain_execution_lifecycle.SUPPLY_CHAIN_EXECUTION_TRANSITION_OPERATION` → `lightbulb.supply_chain_execution_lifecycle.SUPPLY_CHAIN_EXECUTION_TRANSITION_OPERATION`.

Source: `lightbulb/supply_chain_execution_lifecycle.py:2533`.

### `lightbulb.SUPPLY_CHAIN_PROPOSAL_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SUPPLY_CHAIN_PROPOSAL_SCHEMA
~~~


Binding: `lightbulb.supply_chain_execution_lifecycle.SUPPLY_CHAIN_PROPOSAL_SCHEMA` → `lightbulb.supply_chain_execution_lifecycle.SUPPLY_CHAIN_PROPOSAL_SCHEMA`.

Source: `lightbulb/supply_chain_execution_lifecycle.py:58`.

### `lightbulb.SUPPLY_CHAIN_REQUEST_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SUPPLY_CHAIN_REQUEST_SCHEMA
~~~


Binding: `lightbulb.supply_chain_execution_lifecycle.SUPPLY_CHAIN_REQUEST_SCHEMA` → `lightbulb.supply_chain_execution_lifecycle.SUPPLY_CHAIN_REQUEST_SCHEMA`.

Source: `lightbulb/supply_chain_execution_lifecycle.py:57`.

### `lightbulb.SUPPLY_CHAIN_RESULT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SUPPLY_CHAIN_RESULT_SCHEMA
~~~


Binding: `lightbulb.supply_chain_execution_lifecycle.SUPPLY_CHAIN_RESULT_SCHEMA` → `lightbulb.supply_chain_execution_lifecycle.SUPPLY_CHAIN_RESULT_SCHEMA`.

Source: `lightbulb/supply_chain_execution_lifecycle.py:59`.

### `lightbulb.SUPPLY_CHAIN_SCOPE_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SUPPLY_CHAIN_SCOPE_SCHEMA
~~~


Binding: `lightbulb.supply_chain_execution_lifecycle.SUPPLY_CHAIN_SCOPE_SCHEMA` → `lightbulb.supply_chain_execution_lifecycle.SUPPLY_CHAIN_SCOPE_SCHEMA`.

Source: `lightbulb/supply_chain_execution_lifecycle.py:50`.

### `lightbulb.SUPPLY_CHAIN_SNAPSHOT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SUPPLY_CHAIN_SNAPSHOT_SCHEMA
~~~


Binding: `lightbulb.supply_chain_execution_lifecycle.SUPPLY_CHAIN_SNAPSHOT_SCHEMA` → `lightbulb.supply_chain_execution_lifecycle.SUPPLY_CHAIN_SNAPSHOT_SCHEMA`.

Source: `lightbulb/supply_chain_execution_lifecycle.py:56`.

### `lightbulb.SUPPLY_CHAIN_TRANSITION_RECORD_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SUPPLY_CHAIN_TRANSITION_RECORD_SCHEMA
~~~


Binding: `lightbulb.supply_chain_execution_lifecycle.SUPPLY_CHAIN_TRANSITION_RECORD_SCHEMA` → `lightbulb.supply_chain_execution_lifecycle.SUPPLY_CHAIN_TRANSITION_RECORD_SCHEMA`.

Source: `lightbulb/supply_chain_execution_lifecycle.py:53`.

### `lightbulb.SUPPLY_CHAIN_EXECUTION_GENESIS_DIGEST`

constant alias. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SUPPLY_CHAIN_EXECUTION_GENESIS_DIGEST
~~~


Binding: `lightbulb.supply_chain_execution_lifecycle.ZERO_DIGEST` → `lightbulb.supply_chain_execution_lifecycle.ZERO_DIGEST`.

Source: `lightbulb/supply_chain_execution_lifecycle.py:62`.

### `lightbulb.AllocateSupplyCommand`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import AllocateSupplyCommand
~~~


Binding: `lightbulb.supply_chain_execution_lifecycle.AllocateSupplyCommand` → `lightbulb.supply_chain_execution_lifecycle.AllocateSupplyCommand`.

Source: `lightbulb/supply_chain_execution_lifecycle.py:556`.

### `lightbulb.ApproveSopCommand`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ApproveSopCommand
~~~


Binding: `lightbulb.supply_chain_execution_lifecycle.ApproveSopCommand` → `lightbulb.supply_chain_execution_lifecycle.ApproveSopCommand`.

Source: `lightbulb/supply_chain_execution_lifecycle.py:480`.

### `lightbulb.CloseExecutionCommand`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CloseExecutionCommand
~~~


Binding: `lightbulb.supply_chain_execution_lifecycle.CloseExecutionCommand` → `lightbulb.supply_chain_execution_lifecycle.CloseExecutionCommand`.

Source: `lightbulb/supply_chain_execution_lifecycle.py:858`.

### `lightbulb.DispatchShipmentCommand`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import DispatchShipmentCommand
~~~


Binding: `lightbulb.supply_chain_execution_lifecycle.DispatchShipmentCommand` → `lightbulb.supply_chain_execution_lifecycle.DispatchShipmentCommand`.

Source: `lightbulb/supply_chain_execution_lifecycle.py:638`.

### `lightbulb.MarkExecutionInDoubtCommand`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import MarkExecutionInDoubtCommand
~~~


Binding: `lightbulb.supply_chain_execution_lifecycle.MarkExecutionInDoubtCommand` → `lightbulb.supply_chain_execution_lifecycle.MarkExecutionInDoubtCommand`.

Source: `lightbulb/supply_chain_execution_lifecycle.py:806`.

### `lightbulb.OpenShipmentExceptionCommand`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import OpenShipmentExceptionCommand
~~~


Binding: `lightbulb.supply_chain_execution_lifecycle.OpenShipmentExceptionCommand` → `lightbulb.supply_chain_execution_lifecycle.OpenShipmentExceptionCommand`.

Source: `lightbulb/supply_chain_execution_lifecycle.py:736`.

### `lightbulb.PlanReplenishmentCommand`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PlanReplenishmentCommand
~~~


Binding: `lightbulb.supply_chain_execution_lifecycle.PlanReplenishmentCommand` → `lightbulb.supply_chain_execution_lifecycle.PlanReplenishmentCommand`.

Source: `lightbulb/supply_chain_execution_lifecycle.py:574`.

### `lightbulb.ProjectDemandForecastCommand`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProjectDemandForecastCommand
~~~


Binding: `lightbulb.supply_chain_execution_lifecycle.ProjectDemandForecastCommand` → `lightbulb.supply_chain_execution_lifecycle.ProjectDemandForecastCommand`.

Source: `lightbulb/supply_chain_execution_lifecycle.py:432`.

### `lightbulb.ProposeSupplyChainExecutionTransitionPrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProposeSupplyChainExecutionTransitionPrimitive
~~~


Binding: `lightbulb.supply_chain_execution_lifecycle.ProposeSupplyChainExecutionTransitionPrimitive` → `lightbulb.supply_chain_execution_lifecycle.ProposeSupplyChainExecutionTransitionPrimitive`.

Source: `lightbulb/supply_chain_execution_lifecycle.py:2718`.

### `lightbulb.RecordCustodyTransferCommand`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import RecordCustodyTransferCommand
~~~


Binding: `lightbulb.supply_chain_execution_lifecycle.RecordCustodyTransferCommand` → `lightbulb.supply_chain_execution_lifecycle.RecordCustodyTransferCommand`.

Source: `lightbulb/supply_chain_execution_lifecycle.py:671`.

### `lightbulb.RecordDeliveryCommand`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import RecordDeliveryCommand
~~~


Binding: `lightbulb.supply_chain_execution_lifecycle.RecordDeliveryCommand` → `lightbulb.supply_chain_execution_lifecycle.RecordDeliveryCommand`.

Source: `lightbulb/supply_chain_execution_lifecycle.py:703`.

### `lightbulb.RecordMrpSupplyPlanCommand`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import RecordMrpSupplyPlanCommand
~~~


Binding: `lightbulb.supply_chain_execution_lifecycle.RecordMrpSupplyPlanCommand` → `lightbulb.supply_chain_execution_lifecycle.RecordMrpSupplyPlanCommand`.

Source: `lightbulb/supply_chain_execution_lifecycle.py:497`.

### `lightbulb.ReleaseWarehouseCommand`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ReleaseWarehouseCommand
~~~


Binding: `lightbulb.supply_chain_execution_lifecycle.ReleaseWarehouseCommand` → `lightbulb.supply_chain_execution_lifecycle.ReleaseWarehouseCommand`.

Source: `lightbulb/supply_chain_execution_lifecycle.py:614`.

### `lightbulb.ResolveExecutionInDoubtCommand`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ResolveExecutionInDoubtCommand
~~~


Binding: `lightbulb.supply_chain_execution_lifecycle.ResolveExecutionInDoubtCommand` → `lightbulb.supply_chain_execution_lifecycle.ResolveExecutionInDoubtCommand`.

Source: `lightbulb/supply_chain_execution_lifecycle.py:838`.

### `lightbulb.ResolveShipmentExceptionCommand`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ResolveShipmentExceptionCommand
~~~


Binding: `lightbulb.supply_chain_execution_lifecycle.ResolveShipmentExceptionCommand` → `lightbulb.supply_chain_execution_lifecycle.ResolveShipmentExceptionCommand`.

Source: `lightbulb/supply_chain_execution_lifecycle.py:781`.

### `lightbulb.SupplyChainApprovalEvidence`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SupplyChainApprovalEvidence
~~~


Binding: `lightbulb.supply_chain_execution_lifecycle.SupplyChainApprovalEvidence` → `lightbulb.supply_chain_execution_lifecycle.SupplyChainApprovalEvidence`.

Source: `lightbulb/supply_chain_execution_lifecycle.py:335`.

### `lightbulb.SupplyChainCommand`

value. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SupplyChainCommand
~~~


Binding: `lightbulb.supply_chain_execution_lifecycle.SupplyChainCommand` → `lightbulb.supply_chain_execution_lifecycle.SupplyChainCommand`.

Source: `lightbulb/supply_chain_execution_lifecycle.py:873`.

### `lightbulb.SupplyChainCustodyProjection`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SupplyChainCustodyProjection
~~~


Binding: `lightbulb.supply_chain_execution_lifecycle.SupplyChainCustodyProjection` → `lightbulb.supply_chain_execution_lifecycle.SupplyChainCustodyProjection`.

Source: `lightbulb/supply_chain_execution_lifecycle.py:1029`.

### `lightbulb.SupplyChainExecutionError`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SupplyChainExecutionError
~~~


Binding: `lightbulb.supply_chain_execution_lifecycle.SupplyChainExecutionError` → `lightbulb.supply_chain_execution_lifecycle.SupplyChainExecutionError`.

Source: `lightbulb/supply_chain_execution_lifecycle.py:99`.

### `lightbulb.SupplyChainExecutionEvidence`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SupplyChainExecutionEvidence
~~~


Binding: `lightbulb.supply_chain_execution_lifecycle.SupplyChainExecutionEvidence` → `lightbulb.supply_chain_execution_lifecycle.SupplyChainExecutionEvidence`.

Source: `lightbulb/supply_chain_execution_lifecycle.py:282`.

### `lightbulb.SupplyChainExecutionScope`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SupplyChainExecutionScope
~~~


Binding: `lightbulb.supply_chain_execution_lifecycle.SupplyChainExecutionScope` → `lightbulb.supply_chain_execution_lifecycle.SupplyChainExecutionScope`.

Source: `lightbulb/supply_chain_execution_lifecycle.py:224`.

### `lightbulb.SupplyChainExecutionSnapshot`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SupplyChainExecutionSnapshot
~~~


Binding: `lightbulb.supply_chain_execution_lifecycle.SupplyChainExecutionSnapshot` → `lightbulb.supply_chain_execution_lifecycle.SupplyChainExecutionSnapshot`.

Source: `lightbulb/supply_chain_execution_lifecycle.py:1174`.

### `lightbulb.SupplyChainTransitionProposal`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SupplyChainTransitionProposal
~~~


Binding: `lightbulb.supply_chain_execution_lifecycle.SupplyChainTransitionProposal` → `lightbulb.supply_chain_execution_lifecycle.SupplyChainTransitionProposal`.

Source: `lightbulb/supply_chain_execution_lifecycle.py:2271`.

### `lightbulb.SupplyChainTransitionRecord`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SupplyChainTransitionRecord
~~~


Binding: `lightbulb.supply_chain_execution_lifecycle.SupplyChainTransitionRecord` → `lightbulb.supply_chain_execution_lifecycle.SupplyChainTransitionRecord`.

Source: `lightbulb/supply_chain_execution_lifecycle.py:1069`.

### `lightbulb.SupplyChainTransitionRequest`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SupplyChainTransitionRequest
~~~


Binding: `lightbulb.supply_chain_execution_lifecycle.SupplyChainTransitionRequest` → `lightbulb.supply_chain_execution_lifecycle.SupplyChainTransitionRequest`.

Source: `lightbulb/supply_chain_execution_lifecycle.py:2095`.

### `lightbulb.SupplyChainTransitionResult`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SupplyChainTransitionResult
~~~


Binding: `lightbulb.supply_chain_execution_lifecycle.SupplyChainTransitionResult` → `lightbulb.supply_chain_execution_lifecycle.SupplyChainTransitionResult`.

Source: `lightbulb/supply_chain_execution_lifecycle.py:2311`.

### `lightbulb.propose_supply_chain_execution_transition`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import propose_supply_chain_execution_transition
~~~


Binding: `lightbulb.supply_chain_execution_lifecycle.propose_supply_chain_execution_transition` → `lightbulb.supply_chain_execution_lifecycle.propose_supply_chain_execution_transition`.

Source: `lightbulb/supply_chain_execution_lifecycle.py:2377`.

### `lightbulb.supply_chain_approval_digest`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import supply_chain_approval_digest
~~~


Binding: `lightbulb.supply_chain_execution_lifecycle.supply_chain_approval_digest` → `lightbulb.supply_chain_execution_lifecycle.supply_chain_approval_digest`.

Source: `lightbulb/supply_chain_execution_lifecycle.py:404`.

### `lightbulb.supply_chain_command_digest`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import supply_chain_command_digest
~~~


Binding: `lightbulb.supply_chain_execution_lifecycle.supply_chain_command_digest` → `lightbulb.supply_chain_execution_lifecycle.supply_chain_command_digest`.

Source: `lightbulb/supply_chain_execution_lifecycle.py:896`.

### `lightbulb.supply_chain_fact_evidence_digest`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import supply_chain_fact_evidence_digest
~~~


Binding: `lightbulb.supply_chain_execution_lifecycle.supply_chain_fact_evidence_digest` → `lightbulb.supply_chain_execution_lifecycle.supply_chain_fact_evidence_digest`.

Source: `lightbulb/supply_chain_execution_lifecycle.py:919`.

### `lightbulb.supply_chain_idempotency_digest`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import supply_chain_idempotency_digest
~~~


Binding: `lightbulb.supply_chain_execution_lifecycle.supply_chain_idempotency_digest` → `lightbulb.supply_chain_execution_lifecycle.supply_chain_idempotency_digest`.

Source: `lightbulb/supply_chain_execution_lifecycle.py:903`.

### `lightbulb.supply_chain_scope_digest`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import supply_chain_scope_digest
~~~


Binding: `lightbulb.supply_chain_execution_lifecycle.supply_chain_scope_digest` → `lightbulb.supply_chain_execution_lifecycle.supply_chain_scope_digest`.

Source: `lightbulb/supply_chain_execution_lifecycle.py:275`.

### `lightbulb.supply_chain_snapshot_digest`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import supply_chain_snapshot_digest
~~~


Binding: `lightbulb.supply_chain_execution_lifecycle.supply_chain_snapshot_digest` → `lightbulb.supply_chain_execution_lifecycle.supply_chain_snapshot_digest`.

Source: `lightbulb/supply_chain_execution_lifecycle.py:1796`.

### `lightbulb.supply_chain_transition_content_digest`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import supply_chain_transition_content_digest
~~~


Binding: `lightbulb.supply_chain_execution_lifecycle.supply_chain_transition_content_digest` → `lightbulb.supply_chain_execution_lifecycle.supply_chain_transition_content_digest`.

Source: `lightbulb/supply_chain_execution_lifecycle.py:2189`.

### `lightbulb.supply_chain_transition_evidence_digest`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import supply_chain_transition_evidence_digest
~~~


Binding: `lightbulb.supply_chain_execution_lifecycle.supply_chain_transition_evidence_digest` → `lightbulb.supply_chain_execution_lifecycle.supply_chain_transition_evidence_digest`.

Source: `lightbulb/supply_chain_execution_lifecycle.py:2246`.

### `lightbulb.MANUFACTURING_CONTROL_INPUT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import MANUFACTURING_CONTROL_INPUT_SCHEMA
~~~


Binding: `lightbulb.manufacturing_controls.MANUFACTURING_CONTROL_INPUT_SCHEMA` → `lightbulb.manufacturing_controls.MANUFACTURING_CONTROL_INPUT_SCHEMA`.

Source: `lightbulb/manufacturing_controls.py:50`.

### `lightbulb.MANUFACTURING_CONTROL_OPERATION`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import MANUFACTURING_CONTROL_OPERATION
~~~


Binding: `lightbulb.manufacturing_controls.MANUFACTURING_CONTROL_OPERATION` → `lightbulb.manufacturing_controls.MANUFACTURING_CONTROL_OPERATION`.

Source: `lightbulb/manufacturing_controls.py:749`.

### `lightbulb.MANUFACTURING_CONTROL_RESULT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import MANUFACTURING_CONTROL_RESULT_SCHEMA
~~~


Binding: `lightbulb.manufacturing_controls.MANUFACTURING_CONTROL_RESULT_SCHEMA` → `lightbulb.manufacturing_controls.MANUFACTURING_CONTROL_RESULT_SCHEMA`.

Source: `lightbulb/manufacturing_controls.py:51`.

### `lightbulb.ManufacturingControlInput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ManufacturingControlInput
~~~


Binding: `lightbulb.manufacturing_controls.ManufacturingControlInput` → `lightbulb.manufacturing_controls.ManufacturingControlInput`.

Source: `lightbulb/manufacturing_controls.py:636`.

### `lightbulb.ManufacturingControlPolicy`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ManufacturingControlPolicy
~~~


Binding: `lightbulb.manufacturing_controls.ManufacturingControlPolicy` → `lightbulb.manufacturing_controls.ManufacturingControlPolicy`.

Source: `lightbulb/manufacturing_controls.py:618`.

### `lightbulb.ManufacturingControlResult`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ManufacturingControlResult
~~~


Binding: `lightbulb.manufacturing_controls.ManufacturingControlResult` → `lightbulb.manufacturing_controls.ManufacturingControlResult`.

Source: `lightbulb/manufacturing_controls.py:760`.

### `lightbulb.ManufacturingEffectBoundary`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ManufacturingEffectBoundary
~~~


Binding: `lightbulb.manufacturing_controls.ManufacturingEffectBoundary` → `lightbulb.manufacturing_controls.ManufacturingEffectBoundary`.

Source: `lightbulb/manufacturing_controls.py:739`.

### `lightbulb.VerifyBomInventoryTraceabilityPrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import VerifyBomInventoryTraceabilityPrimitive
~~~


Binding: `lightbulb.manufacturing_controls.VerifyBomInventoryTraceabilityPrimitive` → `lightbulb.manufacturing_controls.VerifyBomInventoryTraceabilityPrimitive`.

Source: `lightbulb/manufacturing_controls.py:1604`.

### `lightbulb.evaluate_manufacturing_controls`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import evaluate_manufacturing_controls
~~~


Binding: `lightbulb.manufacturing_controls.evaluate_manufacturing_controls` → `lightbulb.manufacturing_controls.evaluate_manufacturing_controls`.

Source: `lightbulb/manufacturing_controls.py:937`.

### `lightbulb.GENESIS_SNAPSHOT_DIGEST`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GENESIS_SNAPSHOT_DIGEST
~~~


Binding: `lightbulb.manufacturing_execution_lifecycle.GENESIS_SNAPSHOT_DIGEST` → `lightbulb.manufacturing_execution_lifecycle.GENESIS_SNAPSHOT_DIGEST`.

Source: `lightbulb/manufacturing_execution_lifecycle.py:79`.

### `lightbulb.MANUFACTURING_EXECUTION_LIFECYCLE_EXECUTABLE_PRIMITIVES`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import MANUFACTURING_EXECUTION_LIFECYCLE_EXECUTABLE_PRIMITIVES
~~~


Binding: `lightbulb.manufacturing_execution_lifecycle.MANUFACTURING_EXECUTION_LIFECYCLE_EXECUTABLE_PRIMITIVES` → `lightbulb.manufacturing_execution_lifecycle.MANUFACTURING_EXECUTION_LIFECYCLE_EXECUTABLE_PRIMITIVES`.

Source: `lightbulb/manufacturing_execution_lifecycle.py:3026`.

### `lightbulb.MANUFACTURING_LIFECYCLE_INPUT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import MANUFACTURING_LIFECYCLE_INPUT_SCHEMA
~~~


Binding: `lightbulb.manufacturing_execution_lifecycle.MANUFACTURING_LIFECYCLE_INPUT_SCHEMA` → `lightbulb.manufacturing_execution_lifecycle.MANUFACTURING_LIFECYCLE_INPUT_SCHEMA`.

Source: `lightbulb/manufacturing_execution_lifecycle.py:69`.

### `lightbulb.MANUFACTURING_LIFECYCLE_RESULT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import MANUFACTURING_LIFECYCLE_RESULT_SCHEMA
~~~


Binding: `lightbulb.manufacturing_execution_lifecycle.MANUFACTURING_LIFECYCLE_RESULT_SCHEMA` → `lightbulb.manufacturing_execution_lifecycle.MANUFACTURING_LIFECYCLE_RESULT_SCHEMA`.

Source: `lightbulb/manufacturing_execution_lifecycle.py:75`.

### `lightbulb.MANUFACTURING_LIFECYCLE_SNAPSHOT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import MANUFACTURING_LIFECYCLE_SNAPSHOT_SCHEMA
~~~


Binding: `lightbulb.manufacturing_execution_lifecycle.MANUFACTURING_LIFECYCLE_SNAPSHOT_SCHEMA` → `lightbulb.manufacturing_execution_lifecycle.MANUFACTURING_LIFECYCLE_SNAPSHOT_SCHEMA`.

Source: `lightbulb/manufacturing_execution_lifecycle.py:66`.

### `lightbulb.MANUFACTURING_TRANSITION_OPERATION`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import MANUFACTURING_TRANSITION_OPERATION
~~~


Binding: `lightbulb.manufacturing_execution_lifecycle.MANUFACTURING_TRANSITION_OPERATION` → `lightbulb.manufacturing_execution_lifecycle.MANUFACTURING_TRANSITION_OPERATION`.

Source: `lightbulb/manufacturing_execution_lifecycle.py:1876`.

### `lightbulb.MANUFACTURING_TRANSITION_RECEIPT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import MANUFACTURING_TRANSITION_RECEIPT_SCHEMA
~~~


Binding: `lightbulb.manufacturing_execution_lifecycle.MANUFACTURING_TRANSITION_RECEIPT_SCHEMA` → `lightbulb.manufacturing_execution_lifecycle.MANUFACTURING_TRANSITION_RECEIPT_SCHEMA`.

Source: `lightbulb/manufacturing_execution_lifecycle.py:72`.

### `lightbulb.AdvanceManufacturingExecutionLifecyclePrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import AdvanceManufacturingExecutionLifecyclePrimitive
~~~


Binding: `lightbulb.manufacturing_execution_lifecycle.AdvanceManufacturingExecutionLifecyclePrimitive` → `lightbulb.manufacturing_execution_lifecycle.AdvanceManufacturingExecutionLifecyclePrimitive`.

Source: `lightbulb/manufacturing_execution_lifecycle.py:2849`.

### `lightbulb.AppliedManufacturingTransition`

class alias. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import AppliedManufacturingTransition
~~~


Binding: `lightbulb.manufacturing_execution_lifecycle.AppliedManufacturingTransition` → `lightbulb.manufacturing_execution_lifecycle.MaterializedCandidateManufacturingTransition`.

Source: `lightbulb/manufacturing_execution_lifecycle.py:845`.

### `lightbulb.CloseNonconformanceCommand`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CloseNonconformanceCommand
~~~


Binding: `lightbulb.manufacturing_execution_lifecycle.CloseNonconformanceCommand` → `lightbulb.manufacturing_execution_lifecycle.CloseNonconformanceCommand`.

Source: `lightbulb/manufacturing_execution_lifecycle.py:1620`.

### `lightbulb.CompleteOperationCommand`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CompleteOperationCommand
~~~


Binding: `lightbulb.manufacturing_execution_lifecycle.CompleteOperationCommand` → `lightbulb.manufacturing_execution_lifecycle.CompleteOperationCommand`.

Source: `lightbulb/manufacturing_execution_lifecycle.py:1527`.

### `lightbulb.CreateProductionOrderCommand`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CreateProductionOrderCommand
~~~


Binding: `lightbulb.manufacturing_execution_lifecycle.CreateProductionOrderCommand` → `lightbulb.manufacturing_execution_lifecycle.CreateProductionOrderCommand`.

Source: `lightbulb/manufacturing_execution_lifecycle.py:1502`.

### `lightbulb.ManufacturingExecutionLifecycleInput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ManufacturingExecutionLifecycleInput
~~~


Binding: `lightbulb.manufacturing_execution_lifecycle.ManufacturingExecutionLifecycleInput` → `lightbulb.manufacturing_execution_lifecycle.ManufacturingExecutionLifecycleInput`.

Source: `lightbulb/manufacturing_execution_lifecycle.py:1746`.

### `lightbulb.ManufacturingExecutionLifecycleResult`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ManufacturingExecutionLifecycleResult
~~~


Binding: `lightbulb.manufacturing_execution_lifecycle.ManufacturingExecutionLifecycleResult` → `lightbulb.manufacturing_execution_lifecycle.ManufacturingExecutionLifecycleResult`.

Source: `lightbulb/manufacturing_execution_lifecycle.py:1848`.

### `lightbulb.ManufacturingExecutionLifecycleSnapshot`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ManufacturingExecutionLifecycleSnapshot
~~~


Binding: `lightbulb.manufacturing_execution_lifecycle.ManufacturingExecutionLifecycleSnapshot` → `lightbulb.manufacturing_execution_lifecycle.ManufacturingExecutionLifecycleSnapshot`.

Source: `lightbulb/manufacturing_execution_lifecycle.py:975`.

### `lightbulb.ManufacturingLifecycleScope`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ManufacturingLifecycleScope
~~~


Binding: `lightbulb.manufacturing_execution_lifecycle.ManufacturingLifecycleScope` → `lightbulb.manufacturing_execution_lifecycle.ManufacturingLifecycleScope`.

Source: `lightbulb/manufacturing_execution_lifecycle.py:319`.

### `lightbulb.MaterializedCandidateManufacturingTransition`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import MaterializedCandidateManufacturingTransition
~~~


Binding: `lightbulb.manufacturing_execution_lifecycle.MaterializedCandidateManufacturingTransition` → `lightbulb.manufacturing_execution_lifecycle.MaterializedCandidateManufacturingTransition`.

Source: `lightbulb/manufacturing_execution_lifecycle.py:845`.

### `lightbulb.ManufacturingOrderState`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ManufacturingOrderState
~~~


Binding: `lightbulb.manufacturing_execution_lifecycle.ManufacturingOrderState` → `lightbulb.manufacturing_execution_lifecycle.ManufacturingOrderState`.

Source: `lightbulb/manufacturing_execution_lifecycle.py:913`.

### `lightbulb.ManufacturingTransitionReceipt`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ManufacturingTransitionReceipt
~~~


Binding: `lightbulb.manufacturing_execution_lifecycle.ManufacturingTransitionReceipt` → `lightbulb.manufacturing_execution_lifecycle.ManufacturingTransitionReceipt`.

Source: `lightbulb/manufacturing_execution_lifecycle.py:1795`.

### `lightbulb.MaterialInputTrace`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import MaterialInputTrace
~~~


Binding: `lightbulb.manufacturing_execution_lifecycle.MaterialInputTrace` → `lightbulb.manufacturing_execution_lifecycle.MaterialInputTrace`.

Source: `lightbulb/manufacturing_execution_lifecycle.py:570`.

### `lightbulb.Nonconformance`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import Nonconformance
~~~


Binding: `lightbulb.manufacturing_execution_lifecycle.Nonconformance` → `lightbulb.manufacturing_execution_lifecycle.Nonconformance`.

Source: `lightbulb/manufacturing_execution_lifecycle.py:749`.

### `lightbulb.OpenNonconformanceCommand`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import OpenNonconformanceCommand
~~~


Binding: `lightbulb.manufacturing_execution_lifecycle.OpenNonconformanceCommand` → `lightbulb.manufacturing_execution_lifecycle.OpenNonconformanceCommand`.

Source: `lightbulb/manufacturing_execution_lifecycle.py:1595`.

### `lightbulb.OperationCompletion`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import OperationCompletion
~~~


Binding: `lightbulb.manufacturing_execution_lifecycle.OperationCompletion` → `lightbulb.manufacturing_execution_lifecycle.OperationCompletion`.

Source: `lightbulb/manufacturing_execution_lifecycle.py:610`.

### `lightbulb.PlaceQualityHoldCommand`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PlaceQualityHoldCommand
~~~


Binding: `lightbulb.manufacturing_execution_lifecycle.PlaceQualityHoldCommand` → `lightbulb.manufacturing_execution_lifecycle.PlaceQualityHoldCommand`.

Source: `lightbulb/manufacturing_execution_lifecycle.py:1572`.

### `lightbulb.ProducedTrace`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProducedTrace
~~~


Binding: `lightbulb.manufacturing_execution_lifecycle.ProducedTrace` → `lightbulb.manufacturing_execution_lifecycle.ProducedTrace`.

Source: `lightbulb/manufacturing_execution_lifecycle.py:591`.

### `lightbulb.ProductionOrderPlan`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProductionOrderPlan
~~~


Binding: `lightbulb.manufacturing_execution_lifecycle.ProductionOrderPlan` → `lightbulb.manufacturing_execution_lifecycle.ProductionOrderPlan`.

Source: `lightbulb/manufacturing_execution_lifecycle.py:536`.

### `lightbulb.QualityHold`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import QualityHold
~~~


Binding: `lightbulb.manufacturing_execution_lifecycle.QualityHold` → `lightbulb.manufacturing_execution_lifecycle.QualityHold`.

Source: `lightbulb/manufacturing_execution_lifecycle.py:683`.

### `lightbulb.ReleaseQualityHoldCommand`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ReleaseQualityHoldCommand
~~~


Binding: `lightbulb.manufacturing_execution_lifecycle.ReleaseQualityHoldCommand` → `lightbulb.manufacturing_execution_lifecycle.ReleaseQualityHoldCommand`.

Source: `lightbulb/manufacturing_execution_lifecycle.py:1669`.

### `lightbulb.ReleasedBomComponent`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ReleasedBomComponent
~~~


Binding: `lightbulb.manufacturing_execution_lifecycle.ReleasedBomComponent` → `lightbulb.manufacturing_execution_lifecycle.ReleasedBomComponent`.

Source: `lightbulb/manufacturing_execution_lifecycle.py:340`.

### `lightbulb.ReleasedBomSnapshot`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ReleasedBomSnapshot
~~~


Binding: `lightbulb.manufacturing_execution_lifecycle.ReleasedBomSnapshot` → `lightbulb.manufacturing_execution_lifecycle.ReleasedBomSnapshot`.

Source: `lightbulb/manufacturing_execution_lifecycle.py:361`.

### `lightbulb.ReleasedManufacturingDefinition`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ReleasedManufacturingDefinition
~~~


Binding: `lightbulb.manufacturing_execution_lifecycle.ReleasedManufacturingDefinition` → `lightbulb.manufacturing_execution_lifecycle.ReleasedManufacturingDefinition`.

Source: `lightbulb/manufacturing_execution_lifecycle.py:488`.

### `lightbulb.ReleasedRoutingOperation`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ReleasedRoutingOperation
~~~


Binding: `lightbulb.manufacturing_execution_lifecycle.ReleasedRoutingOperation` → `lightbulb.manufacturing_execution_lifecycle.ReleasedRoutingOperation`.

Source: `lightbulb/manufacturing_execution_lifecycle.py:418`.

### `lightbulb.ReleasedRoutingSnapshot`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ReleasedRoutingSnapshot
~~~


Binding: `lightbulb.manufacturing_execution_lifecycle.ReleasedRoutingSnapshot` → `lightbulb.manufacturing_execution_lifecycle.ReleasedRoutingSnapshot`.

Source: `lightbulb/manufacturing_execution_lifecycle.py:443`.

### `lightbulb.advance_manufacturing_execution_lifecycle`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import advance_manufacturing_execution_lifecycle
~~~


Binding: `lightbulb.manufacturing_execution_lifecycle.advance_manufacturing_execution_lifecycle` → `lightbulb.manufacturing_execution_lifecycle.advance_manufacturing_execution_lifecycle`.

Source: `lightbulb/manufacturing_execution_lifecycle.py:2676`.

### `lightbulb.build_released_manufacturing_definition`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import build_released_manufacturing_definition
~~~


Binding: `lightbulb.manufacturing_execution_lifecycle.build_released_manufacturing_definition` → `lightbulb.manufacturing_execution_lifecycle.build_released_manufacturing_definition`.

Source: `lightbulb/manufacturing_execution_lifecycle.py:518`.

### `lightbulb.manufacturing_command_digest`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import manufacturing_command_digest
~~~


Binding: `lightbulb.manufacturing_execution_lifecycle.manufacturing_command_digest` → `lightbulb.manufacturing_execution_lifecycle.manufacturing_command_digest`.

Source: `lightbulb/manufacturing_execution_lifecycle.py:1714`.

### `lightbulb.manufacturing_scope_digest`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import manufacturing_scope_digest
~~~


Binding: `lightbulb.manufacturing_execution_lifecycle.manufacturing_scope_digest` → `lightbulb.manufacturing_execution_lifecycle.manufacturing_scope_digest`.

Source: `lightbulb/manufacturing_execution_lifecycle.py:327`.

### `lightbulb.manufacturing_snapshot_digest`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import manufacturing_snapshot_digest
~~~


Binding: `lightbulb.manufacturing_execution_lifecycle.manufacturing_snapshot_digest` → `lightbulb.manufacturing_execution_lifecycle.manufacturing_snapshot_digest`.

Source: `lightbulb/manufacturing_execution_lifecycle.py:1442`.

### `lightbulb.released_bom_content_digest`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import released_bom_content_digest
~~~


Binding: `lightbulb.manufacturing_execution_lifecycle.released_bom_content_digest` → `lightbulb.manufacturing_execution_lifecycle.released_bom_content_digest`.

Source: `lightbulb/manufacturing_execution_lifecycle.py:217`.

### `lightbulb.released_routing_content_digest`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import released_routing_content_digest
~~~


Binding: `lightbulb.manufacturing_execution_lifecycle.released_routing_content_digest` → `lightbulb.manufacturing_execution_lifecycle.released_routing_content_digest`.

Source: `lightbulb/manufacturing_execution_lifecycle.py:257`.

### `lightbulb.seal_manufacturing_command`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import seal_manufacturing_command
~~~


Binding: `lightbulb.manufacturing_execution_lifecycle.seal_manufacturing_command` → `lightbulb.manufacturing_execution_lifecycle.seal_manufacturing_command`.

Source: `lightbulb/manufacturing_execution_lifecycle.py:1727`.

### `lightbulb.FIELD_QUALITY_CONTROL_INPUT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import FIELD_QUALITY_CONTROL_INPUT_SCHEMA
~~~


Binding: `lightbulb.manufacturing_field_quality.FIELD_QUALITY_CONTROL_INPUT_SCHEMA` → `lightbulb.manufacturing_field_quality.FIELD_QUALITY_CONTROL_INPUT_SCHEMA`.

Source: `lightbulb/manufacturing_field_quality.py:44`.

### `lightbulb.FIELD_QUALITY_CONTROL_OPERATION`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import FIELD_QUALITY_CONTROL_OPERATION
~~~


Binding: `lightbulb.manufacturing_field_quality.FIELD_QUALITY_CONTROL_OPERATION` → `lightbulb.manufacturing_field_quality.FIELD_QUALITY_CONTROL_OPERATION`.

Source: `lightbulb/manufacturing_field_quality.py:482`.

### `lightbulb.FIELD_QUALITY_CONTROL_RESULT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import FIELD_QUALITY_CONTROL_RESULT_SCHEMA
~~~


Binding: `lightbulb.manufacturing_field_quality.FIELD_QUALITY_CONTROL_RESULT_SCHEMA` → `lightbulb.manufacturing_field_quality.FIELD_QUALITY_CONTROL_RESULT_SCHEMA`.

Source: `lightbulb/manufacturing_field_quality.py:45`.

### `lightbulb.FIELD_QUALITY_EXECUTABLE_PRIMITIVES`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import FIELD_QUALITY_EXECUTABLE_PRIMITIVES
~~~


Binding: `lightbulb.manufacturing_field_quality.FIELD_QUALITY_EXECUTABLE_PRIMITIVES` → `lightbulb.manufacturing_field_quality.FIELD_QUALITY_EXECUTABLE_PRIMITIVES`.

Source: `lightbulb/manufacturing_field_quality.py:1039`.

### `lightbulb.EvaluateFieldQualityControlsPrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import EvaluateFieldQualityControlsPrimitive
~~~


Binding: `lightbulb.manufacturing_field_quality.EvaluateFieldQualityControlsPrimitive` → `lightbulb.manufacturing_field_quality.EvaluateFieldQualityControlsPrimitive`.

Source: `lightbulb/manufacturing_field_quality.py:951`.

### `lightbulb.FieldQualityControlInput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import FieldQualityControlInput
~~~


Binding: `lightbulb.manufacturing_field_quality.FieldQualityControlInput` → `lightbulb.manufacturing_field_quality.FieldQualityControlInput`.

Source: `lightbulb/manufacturing_field_quality.py:310`.

### `lightbulb.FieldQualityControlPolicy`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import FieldQualityControlPolicy
~~~


Binding: `lightbulb.manufacturing_field_quality.FieldQualityControlPolicy` → `lightbulb.manufacturing_field_quality.FieldQualityControlPolicy`.

Source: `lightbulb/manufacturing_field_quality.py:288`.

### `lightbulb.FieldQualityControlResult`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import FieldQualityControlResult
~~~


Binding: `lightbulb.manufacturing_field_quality.FieldQualityControlResult` → `lightbulb.manufacturing_field_quality.FieldQualityControlResult`.

Source: `lightbulb/manufacturing_field_quality.py:378`.

### `lightbulb.evaluate_field_quality_controls`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import evaluate_field_quality_controls
~~~


Binding: `lightbulb.manufacturing_field_quality.evaluate_field_quality_controls` → `lightbulb.manufacturing_field_quality.evaluate_field_quality_controls`.

Source: `lightbulb/manufacturing_field_quality.py:552`.

### `lightbulb.GENESIS_MAINTENANCE_DIGEST`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GENESIS_MAINTENANCE_DIGEST
~~~


Binding: `lightbulb.maintenance_work_order_lifecycle.GENESIS_MAINTENANCE_DIGEST` → `lightbulb.maintenance_work_order_lifecycle.GENESIS_MAINTENANCE_DIGEST`.

Source: `lightbulb/maintenance_work_order_lifecycle.py:59`.

### `lightbulb.MAINTENANCE_EVIDENCE_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import MAINTENANCE_EVIDENCE_SCHEMA
~~~


Binding: `lightbulb.maintenance_work_order_lifecycle.MAINTENANCE_EVIDENCE_SCHEMA` → `lightbulb.maintenance_work_order_lifecycle.MAINTENANCE_EVIDENCE_SCHEMA`.

Source: `lightbulb/maintenance_work_order_lifecycle.py:53`.

### `lightbulb.MAINTENANCE_PROPOSAL_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import MAINTENANCE_PROPOSAL_SCHEMA
~~~


Binding: `lightbulb.maintenance_work_order_lifecycle.MAINTENANCE_PROPOSAL_SCHEMA` → `lightbulb.maintenance_work_order_lifecycle.MAINTENANCE_PROPOSAL_SCHEMA`.

Source: `lightbulb/maintenance_work_order_lifecycle.py:57`.

### `lightbulb.MAINTENANCE_REQUEST_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import MAINTENANCE_REQUEST_SCHEMA
~~~


Binding: `lightbulb.maintenance_work_order_lifecycle.MAINTENANCE_REQUEST_SCHEMA` → `lightbulb.maintenance_work_order_lifecycle.MAINTENANCE_REQUEST_SCHEMA`.

Source: `lightbulb/maintenance_work_order_lifecycle.py:56`.

### `lightbulb.MAINTENANCE_RESULT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import MAINTENANCE_RESULT_SCHEMA
~~~


Binding: `lightbulb.maintenance_work_order_lifecycle.MAINTENANCE_RESULT_SCHEMA` → `lightbulb.maintenance_work_order_lifecycle.MAINTENANCE_RESULT_SCHEMA`.

Source: `lightbulb/maintenance_work_order_lifecycle.py:58`.

### `lightbulb.MAINTENANCE_SCOPE_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import MAINTENANCE_SCOPE_SCHEMA
~~~


Binding: `lightbulb.maintenance_work_order_lifecycle.MAINTENANCE_SCOPE_SCHEMA` → `lightbulb.maintenance_work_order_lifecycle.MAINTENANCE_SCOPE_SCHEMA`.

Source: `lightbulb/maintenance_work_order_lifecycle.py:52`.

### `lightbulb.MAINTENANCE_SNAPSHOT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import MAINTENANCE_SNAPSHOT_SCHEMA
~~~


Binding: `lightbulb.maintenance_work_order_lifecycle.MAINTENANCE_SNAPSHOT_SCHEMA` → `lightbulb.maintenance_work_order_lifecycle.MAINTENANCE_SNAPSHOT_SCHEMA`.

Source: `lightbulb/maintenance_work_order_lifecycle.py:55`.

### `lightbulb.MAINTENANCE_TRANSITION_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import MAINTENANCE_TRANSITION_SCHEMA
~~~


Binding: `lightbulb.maintenance_work_order_lifecycle.MAINTENANCE_TRANSITION_SCHEMA` → `lightbulb.maintenance_work_order_lifecycle.MAINTENANCE_TRANSITION_SCHEMA`.

Source: `lightbulb/maintenance_work_order_lifecycle.py:54`.

### `lightbulb.MAINTENANCE_WORK_ORDER_LIFECYCLE_EXECUTABLE_PRIMITIVES`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import MAINTENANCE_WORK_ORDER_LIFECYCLE_EXECUTABLE_PRIMITIVES
~~~


Binding: `lightbulb.maintenance_work_order_lifecycle.MAINTENANCE_WORK_ORDER_LIFECYCLE_EXECUTABLE_PRIMITIVES` → `lightbulb.maintenance_work_order_lifecycle.MAINTENANCE_WORK_ORDER_LIFECYCLE_EXECUTABLE_PRIMITIVES`.

Source: `lightbulb/maintenance_work_order_lifecycle.py:2966`.

### `lightbulb.MAINTENANCE_WORK_ORDER_TRANSITION_OPERATION`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import MAINTENANCE_WORK_ORDER_TRANSITION_OPERATION
~~~


Binding: `lightbulb.maintenance_work_order_lifecycle.MAINTENANCE_WORK_ORDER_TRANSITION_OPERATION` → `lightbulb.maintenance_work_order_lifecycle.MAINTENANCE_WORK_ORDER_TRANSITION_OPERATION`.

Source: `lightbulb/maintenance_work_order_lifecycle.py:2601`.

### `lightbulb.MAX_MAINTENANCE_TRANSITIONS`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import MAX_MAINTENANCE_TRANSITIONS
~~~


Binding: `lightbulb.maintenance_work_order_lifecycle.MAX_MAINTENANCE_TRANSITIONS` → `lightbulb.maintenance_work_order_lifecycle.MAX_MAINTENANCE_TRANSITIONS`.

Source: `lightbulb/maintenance_work_order_lifecycle.py:60`.

### `lightbulb.AuthorizeAndScheduleCommand`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import AuthorizeAndScheduleCommand
~~~


Binding: `lightbulb.maintenance_work_order_lifecycle.AuthorizeAndScheduleCommand` → `lightbulb.maintenance_work_order_lifecycle.AuthorizeAndScheduleCommand`.

Source: `lightbulb/maintenance_work_order_lifecycle.py:863`.

### `lightbulb.ChecklistCompletion`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ChecklistCompletion
~~~


Binding: `lightbulb.maintenance_work_order_lifecycle.ChecklistCompletion` → `lightbulb.maintenance_work_order_lifecycle.ChecklistCompletion`.

Source: `lightbulb/maintenance_work_order_lifecycle.py:576`.

### `lightbulb.InspectionTest`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import InspectionTest
~~~


Binding: `lightbulb.maintenance_work_order_lifecycle.InspectionTest` → `lightbulb.maintenance_work_order_lifecycle.InspectionTest`.

Source: `lightbulb/maintenance_work_order_lifecycle.py:678`.

### `lightbulb.LaborEntry`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import LaborEntry
~~~


Binding: `lightbulb.maintenance_work_order_lifecycle.LaborEntry` → `lightbulb.maintenance_work_order_lifecycle.LaborEntry`.

Source: `lightbulb/maintenance_work_order_lifecycle.py:595`.

### `lightbulb.LaborReservation`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import LaborReservation
~~~


Binding: `lightbulb.maintenance_work_order_lifecycle.LaborReservation` → `lightbulb.maintenance_work_order_lifecycle.LaborReservation`.

Source: `lightbulb/maintenance_work_order_lifecycle.py:527`.

### `lightbulb.MaintenanceChecklistItem`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import MaintenanceChecklistItem
~~~


Binding: `lightbulb.maintenance_work_order_lifecycle.MaintenanceChecklistItem` → `lightbulb.maintenance_work_order_lifecycle.MaintenanceChecklistItem`.

Source: `lightbulb/maintenance_work_order_lifecycle.py:436`.

### `lightbulb.MaintenanceCommand`

value. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import MaintenanceCommand
~~~


Binding: `lightbulb.maintenance_work_order_lifecycle.MaintenanceCommand` → `lightbulb.maintenance_work_order_lifecycle.MaintenanceCommand`.

Source: `lightbulb/maintenance_work_order_lifecycle.py:1163`.

### `lightbulb.MaintenanceEffectBoundary`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import MaintenanceEffectBoundary
~~~


Binding: `lightbulb.maintenance_work_order_lifecycle.MaintenanceEffectBoundary` → `lightbulb.maintenance_work_order_lifecycle.MaintenanceEffectBoundary`.

Source: `lightbulb/maintenance_work_order_lifecycle.py:1694`.

### `lightbulb.MaintenanceEvidence`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import MaintenanceEvidence
~~~


Binding: `lightbulb.maintenance_work_order_lifecycle.MaintenanceEvidence` → `lightbulb.maintenance_work_order_lifecycle.MaintenanceEvidence`.

Source: `lightbulb/maintenance_work_order_lifecycle.py:331`.

### `lightbulb.MaintenanceTransitionProposal`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import MaintenanceTransitionProposal
~~~


Binding: `lightbulb.maintenance_work_order_lifecycle.MaintenanceTransitionProposal` → `lightbulb.maintenance_work_order_lifecycle.MaintenanceTransitionProposal`.

Source: `lightbulb/maintenance_work_order_lifecycle.py:1710`.

### `lightbulb.MaintenanceTransitionRecord`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import MaintenanceTransitionRecord
~~~


Binding: `lightbulb.maintenance_work_order_lifecycle.MaintenanceTransitionRecord` → `lightbulb.maintenance_work_order_lifecycle.MaintenanceTransitionRecord`.

Source: `lightbulb/maintenance_work_order_lifecycle.py:1271`.

### `lightbulb.MaintenanceTransitionRequest`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import MaintenanceTransitionRequest
~~~


Binding: `lightbulb.maintenance_work_order_lifecycle.MaintenanceTransitionRequest` → `lightbulb.maintenance_work_order_lifecycle.MaintenanceTransitionRequest`.

Source: `lightbulb/maintenance_work_order_lifecycle.py:1524`.

### `lightbulb.MaintenanceTransitionResult`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import MaintenanceTransitionResult
~~~


Binding: `lightbulb.maintenance_work_order_lifecycle.MaintenanceTransitionResult` → `lightbulb.maintenance_work_order_lifecycle.MaintenanceTransitionResult`.

Source: `lightbulb/maintenance_work_order_lifecycle.py:1752`.

### `lightbulb.MaintenanceWorkOrderError`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import MaintenanceWorkOrderError
~~~


Binding: `lightbulb.maintenance_work_order_lifecycle.MaintenanceWorkOrderError` → `lightbulb.maintenance_work_order_lifecycle.MaintenanceWorkOrderError`.

Source: `lightbulb/maintenance_work_order_lifecycle.py:84`.

### `lightbulb.MaintenanceWorkOrderScope`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import MaintenanceWorkOrderScope
~~~


Binding: `lightbulb.maintenance_work_order_lifecycle.MaintenanceWorkOrderScope` → `lightbulb.maintenance_work_order_lifecycle.MaintenanceWorkOrderScope`.

Source: `lightbulb/maintenance_work_order_lifecycle.py:274`.

### `lightbulb.MaintenanceWorkOrderSnapshot`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import MaintenanceWorkOrderSnapshot
~~~


Binding: `lightbulb.maintenance_work_order_lifecycle.MaintenanceWorkOrderSnapshot` → `lightbulb.maintenance_work_order_lifecycle.MaintenanceWorkOrderSnapshot`.

Source: `lightbulb/maintenance_work_order_lifecycle.py:1397`.

### `lightbulb.PartReservation`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PartReservation
~~~


Binding: `lightbulb.maintenance_work_order_lifecycle.PartReservation` → `lightbulb.maintenance_work_order_lifecycle.PartReservation`.

Source: `lightbulb/maintenance_work_order_lifecycle.py:466`.

### `lightbulb.PartUsage`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PartUsage
~~~


Binding: `lightbulb.maintenance_work_order_lifecycle.PartUsage` → `lightbulb.maintenance_work_order_lifecycle.PartUsage`.

Source: `lightbulb/maintenance_work_order_lifecycle.py:618`.

### `lightbulb.PlanMaintenanceCommand`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PlanMaintenanceCommand
~~~


Binding: `lightbulb.maintenance_work_order_lifecycle.PlanMaintenanceCommand` → `lightbulb.maintenance_work_order_lifecycle.PlanMaintenanceCommand`.

Source: `lightbulb/maintenance_work_order_lifecycle.py:773`.

### `lightbulb.ProposeMaintenanceCloseCommand`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProposeMaintenanceCloseCommand
~~~


Binding: `lightbulb.maintenance_work_order_lifecycle.ProposeMaintenanceCloseCommand` → `lightbulb.maintenance_work_order_lifecycle.ProposeMaintenanceCloseCommand`.

Source: `lightbulb/maintenance_work_order_lifecycle.py:1105`.

### `lightbulb.ProposeMaintenanceWorkOrderTransitionPrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProposeMaintenanceWorkOrderTransitionPrimitive
~~~


Binding: `lightbulb.maintenance_work_order_lifecycle.ProposeMaintenanceWorkOrderTransitionPrimitive` → `lightbulb.maintenance_work_order_lifecycle.ProposeMaintenanceWorkOrderTransitionPrimitive`.

Source: `lightbulb/maintenance_work_order_lifecycle.py:2782`.

### `lightbulb.ProposeReturnToServiceCommand`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProposeReturnToServiceCommand
~~~


Binding: `lightbulb.maintenance_work_order_lifecycle.ProposeReturnToServiceCommand` → `lightbulb.maintenance_work_order_lifecycle.ProposeReturnToServiceCommand`.

Source: `lightbulb/maintenance_work_order_lifecycle.py:1067`.

### `lightbulb.RecordIndependentInspectionCommand`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import RecordIndependentInspectionCommand
~~~


Binding: `lightbulb.maintenance_work_order_lifecycle.RecordIndependentInspectionCommand` → `lightbulb.maintenance_work_order_lifecycle.RecordIndependentInspectionCommand`.

Source: `lightbulb/maintenance_work_order_lifecycle.py:1035`.

### `lightbulb.RecordMaintenanceExecutionCommand`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import RecordMaintenanceExecutionCommand
~~~


Binding: `lightbulb.maintenance_work_order_lifecycle.RecordMaintenanceExecutionCommand` → `lightbulb.maintenance_work_order_lifecycle.RecordMaintenanceExecutionCommand`.

Source: `lightbulb/maintenance_work_order_lifecycle.py:959`.

### `lightbulb.RecordWorkRequestCommand`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import RecordWorkRequestCommand
~~~


Binding: `lightbulb.maintenance_work_order_lifecycle.RecordWorkRequestCommand` → `lightbulb.maintenance_work_order_lifecycle.RecordWorkRequestCommand`.

Source: `lightbulb/maintenance_work_order_lifecycle.py:726`.

### `lightbulb.ToolReservation`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ToolReservation
~~~


Binding: `lightbulb.maintenance_work_order_lifecycle.ToolReservation` → `lightbulb.maintenance_work_order_lifecycle.ToolReservation`.

Source: `lightbulb/maintenance_work_order_lifecycle.py:560`.

### `lightbulb.maintenance_command_digest`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import maintenance_command_digest
~~~


Binding: `lightbulb.maintenance_work_order_lifecycle.maintenance_command_digest` → `lightbulb.maintenance_work_order_lifecycle.maintenance_command_digest`.

Source: `lightbulb/maintenance_work_order_lifecycle.py:1178`.

### `lightbulb.maintenance_evidence_lineage_digest`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import maintenance_evidence_lineage_digest
~~~


Binding: `lightbulb.maintenance_work_order_lifecycle.maintenance_evidence_lineage_digest` → `lightbulb.maintenance_work_order_lifecycle.maintenance_evidence_lineage_digest`.

Source: `lightbulb/maintenance_work_order_lifecycle.py:425`.

### `lightbulb.maintenance_fact_evidence_digest`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import maintenance_fact_evidence_digest
~~~


Binding: `lightbulb.maintenance_work_order_lifecycle.maintenance_fact_evidence_digest` → `lightbulb.maintenance_work_order_lifecycle.maintenance_fact_evidence_digest`.

Source: `lightbulb/maintenance_work_order_lifecycle.py:1667`.

### `lightbulb.maintenance_idempotency_digest`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import maintenance_idempotency_digest
~~~


Binding: `lightbulb.maintenance_work_order_lifecycle.maintenance_idempotency_digest` → `lightbulb.maintenance_work_order_lifecycle.maintenance_idempotency_digest`.

Source: `lightbulb/maintenance_work_order_lifecycle.py:1482`.

### `lightbulb.maintenance_scope_digest`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import maintenance_scope_digest
~~~


Binding: `lightbulb.maintenance_work_order_lifecycle.maintenance_scope_digest` → `lightbulb.maintenance_work_order_lifecycle.maintenance_scope_digest`.

Source: `lightbulb/maintenance_work_order_lifecycle.py:324`.

### `lightbulb.maintenance_snapshot_digest`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import maintenance_snapshot_digest
~~~


Binding: `lightbulb.maintenance_work_order_lifecycle.maintenance_snapshot_digest` → `lightbulb.maintenance_work_order_lifecycle.maintenance_snapshot_digest`.

Source: `lightbulb/maintenance_work_order_lifecycle.py:1386`.

### `lightbulb.maintenance_transition_commitment_digest`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import maintenance_transition_commitment_digest
~~~


Binding: `lightbulb.maintenance_work_order_lifecycle.maintenance_transition_commitment_digest` → `lightbulb.maintenance_work_order_lifecycle.maintenance_transition_commitment_digest`.

Source: `lightbulb/maintenance_work_order_lifecycle.py:1683`.

### `lightbulb.maintenance_transition_content_digest`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import maintenance_transition_content_digest
~~~


Binding: `lightbulb.maintenance_work_order_lifecycle.maintenance_transition_content_digest` → `lightbulb.maintenance_work_order_lifecycle.maintenance_transition_content_digest`.

Source: `lightbulb/maintenance_work_order_lifecycle.py:1621`.

### `lightbulb.propose_maintenance_work_order_transition`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import propose_maintenance_work_order_transition
~~~


Binding: `lightbulb.maintenance_work_order_lifecycle.propose_maintenance_work_order_transition` → `lightbulb.maintenance_work_order_lifecycle.propose_maintenance_work_order_transition`.

Source: `lightbulb/maintenance_work_order_lifecycle.py:2425`.

### `lightbulb.COMMERCIAL_CONTROL_INPUT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import COMMERCIAL_CONTROL_INPUT_SCHEMA
~~~


Binding: `lightbulb.commercial_controls.COMMERCIAL_CONTROL_INPUT_SCHEMA` → `lightbulb.commercial_controls.COMMERCIAL_CONTROL_INPUT_SCHEMA`.

Source: `lightbulb/commercial_controls.py:48`.

### `lightbulb.COMMERCIAL_CONTROL_OPERATION`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import COMMERCIAL_CONTROL_OPERATION
~~~


Binding: `lightbulb.commercial_controls.COMMERCIAL_CONTROL_OPERATION` → `lightbulb.commercial_controls.COMMERCIAL_CONTROL_OPERATION`.

Source: `lightbulb/commercial_controls.py:934`.

### `lightbulb.COMMERCIAL_CONTROL_PROPOSAL_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import COMMERCIAL_CONTROL_PROPOSAL_SCHEMA
~~~


Binding: `lightbulb.commercial_controls.COMMERCIAL_CONTROL_PROPOSAL_SCHEMA` → `lightbulb.commercial_controls.COMMERCIAL_CONTROL_PROPOSAL_SCHEMA`.

Source: `lightbulb/commercial_controls.py:51`.

### `lightbulb.CommercialControlPolicy`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommercialControlPolicy
~~~


Binding: `lightbulb.commercial_controls.CommercialControlPolicy` → `lightbulb.commercial_controls.CommercialControlPolicy`.

Source: `lightbulb/commercial_controls.py:261`.

### `lightbulb.CommercialEffectBoundary`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommercialEffectBoundary
~~~


Binding: `lightbulb.commercial_controls.CommercialEffectBoundary` → `lightbulb.commercial_controls.CommercialEffectBoundary`.

Source: `lightbulb/commercial_controls.py:910`.

### `lightbulb.EvaluateQuoteOrderContractControlsPrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import EvaluateQuoteOrderContractControlsPrimitive
~~~


Binding: `lightbulb.commercial_controls.EvaluateQuoteOrderContractControlsPrimitive` → `lightbulb.commercial_controls.EvaluateQuoteOrderContractControlsPrimitive`.

Source: `lightbulb/commercial_controls.py:2890`.

### `lightbulb.QuoteOrderContractControlsInput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import QuoteOrderContractControlsInput
~~~


Binding: `lightbulb.commercial_controls.QuoteOrderContractControlsInput` → `lightbulb.commercial_controls.QuoteOrderContractControlsInput`.

Source: `lightbulb/commercial_controls.py:834`.

### `lightbulb.QuoteOrderContractControlsProposal`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import QuoteOrderContractControlsProposal
~~~


Binding: `lightbulb.commercial_controls.QuoteOrderContractControlsProposal` → `lightbulb.commercial_controls.QuoteOrderContractControlsProposal`.

Source: `lightbulb/commercial_controls.py:945`.

### `lightbulb.evaluate_quote_order_contract_controls`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import evaluate_quote_order_contract_controls
~~~


Binding: `lightbulb.commercial_controls.evaluate_quote_order_contract_controls` → `lightbulb.commercial_controls.evaluate_quote_order_contract_controls`.

Source: `lightbulb/commercial_controls.py:2558`.

### `lightbulb.COMMERCIAL_LIFECYCLE_INPUT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import COMMERCIAL_LIFECYCLE_INPUT_SCHEMA
~~~


Binding: `lightbulb.commercial_operations_lifecycle.COMMERCIAL_LIFECYCLE_INPUT_SCHEMA` → `lightbulb.commercial_operations_lifecycle.COMMERCIAL_LIFECYCLE_INPUT_SCHEMA`.

Source: `lightbulb/commercial_operations_lifecycle.py:76`.

### `lightbulb.COMMERCIAL_LIFECYCLE_RESULT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import COMMERCIAL_LIFECYCLE_RESULT_SCHEMA
~~~


Binding: `lightbulb.commercial_operations_lifecycle.COMMERCIAL_LIFECYCLE_RESULT_SCHEMA` → `lightbulb.commercial_operations_lifecycle.COMMERCIAL_LIFECYCLE_RESULT_SCHEMA`.

Source: `lightbulb/commercial_operations_lifecycle.py:80`.

### `lightbulb.COMMERCIAL_LIFECYCLE_SNAPSHOT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import COMMERCIAL_LIFECYCLE_SNAPSHOT_SCHEMA
~~~


Binding: `lightbulb.commercial_operations_lifecycle.COMMERCIAL_LIFECYCLE_SNAPSHOT_SCHEMA` → `lightbulb.commercial_operations_lifecycle.COMMERCIAL_LIFECYCLE_SNAPSHOT_SCHEMA`.

Source: `lightbulb/commercial_operations_lifecycle.py:73`.

### `lightbulb.COMMERCIAL_OPERATIONS_LIFECYCLE_EXECUTABLE_PRIMITIVES`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import COMMERCIAL_OPERATIONS_LIFECYCLE_EXECUTABLE_PRIMITIVES
~~~


Binding: `lightbulb.commercial_operations_lifecycle.COMMERCIAL_OPERATIONS_LIFECYCLE_EXECUTABLE_PRIMITIVES` → `lightbulb.commercial_operations_lifecycle.COMMERCIAL_OPERATIONS_LIFECYCLE_EXECUTABLE_PRIMITIVES`.

Source: `lightbulb/commercial_operations_lifecycle.py:3560`.

### `lightbulb.COMMERCIAL_TRANSITION_OPERATION`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import COMMERCIAL_TRANSITION_OPERATION
~~~


Binding: `lightbulb.commercial_operations_lifecycle.COMMERCIAL_TRANSITION_OPERATION` → `lightbulb.commercial_operations_lifecycle.COMMERCIAL_TRANSITION_OPERATION`.

Source: `lightbulb/commercial_operations_lifecycle.py:3199`.

### `lightbulb.COMMERCIAL_TRANSITION_RECEIPT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import COMMERCIAL_TRANSITION_RECEIPT_SCHEMA
~~~


Binding: `lightbulb.commercial_operations_lifecycle.COMMERCIAL_TRANSITION_RECEIPT_SCHEMA` → `lightbulb.commercial_operations_lifecycle.COMMERCIAL_TRANSITION_RECEIPT_SCHEMA`.

Source: `lightbulb/commercial_operations_lifecycle.py:77`.

### `lightbulb.COMMERCIAL_GENESIS_SNAPSHOT_DIGEST`

constant alias. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import COMMERCIAL_GENESIS_SNAPSHOT_DIGEST
~~~


Binding: `lightbulb.commercial_operations_lifecycle.GENESIS_SNAPSHOT_DIGEST` → `lightbulb.commercial_operations_lifecycle.GENESIS_SNAPSHOT_DIGEST`.

Source: `lightbulb/commercial_operations_lifecycle.py:84`.

### `lightbulb.MAX_COMMERCIAL_TRANSITIONS`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import MAX_COMMERCIAL_TRANSITIONS
~~~


Binding: `lightbulb.commercial_operations_lifecycle.MAX_COMMERCIAL_TRANSITIONS` → `lightbulb.commercial_operations_lifecycle.MAX_COMMERCIAL_TRANSITIONS`.

Source: `lightbulb/commercial_operations_lifecycle.py:85`.

### `lightbulb.ActivateSubscriptionCommand`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ActivateSubscriptionCommand
~~~


Binding: `lightbulb.commercial_operations_lifecycle.ActivateSubscriptionCommand` → `lightbulb.commercial_operations_lifecycle.ActivateSubscriptionCommand`.

Source: `lightbulb/commercial_operations_lifecycle.py:780`.

### `lightbulb.AttributeChannelCommand`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import AttributeChannelCommand
~~~


Binding: `lightbulb.commercial_operations_lifecycle.AttributeChannelCommand` → `lightbulb.commercial_operations_lifecycle.AttributeChannelCommand`.

Source: `lightbulb/commercial_operations_lifecycle.py:1330`.

### `lightbulb.CommercialLifecycleScope`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommercialLifecycleScope
~~~


Binding: `lightbulb.commercial_operations_lifecycle.CommercialLifecycleScope` → `lightbulb.commercial_operations_lifecycle.CommercialLifecycleScope`.

Source: `lightbulb/commercial_operations_lifecycle.py:367`.

### `lightbulb.CommercialOperationsLifecycleInput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommercialOperationsLifecycleInput
~~~


Binding: `lightbulb.commercial_operations_lifecycle.CommercialOperationsLifecycleInput` → `lightbulb.commercial_operations_lifecycle.CommercialOperationsLifecycleInput`.

Source: `lightbulb/commercial_operations_lifecycle.py:1846`.

### `lightbulb.CommercialOperationsLifecycleResult`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommercialOperationsLifecycleResult
~~~


Binding: `lightbulb.commercial_operations_lifecycle.CommercialOperationsLifecycleResult` → `lightbulb.commercial_operations_lifecycle.CommercialOperationsLifecycleResult`.

Source: `lightbulb/commercial_operations_lifecycle.py:1948`.

### `lightbulb.CommercialOperationsLifecycleSnapshot`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommercialOperationsLifecycleSnapshot
~~~


Binding: `lightbulb.commercial_operations_lifecycle.CommercialOperationsLifecycleSnapshot` → `lightbulb.commercial_operations_lifecycle.CommercialOperationsLifecycleSnapshot`.

Source: `lightbulb/commercial_operations_lifecycle.py:1723`.

### `lightbulb.CommercialRecurringBillingLine`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommercialRecurringBillingLine
~~~


Binding: `lightbulb.commercial_operations_lifecycle.CommercialRecurringBillingLine` → `lightbulb.commercial_operations_lifecycle.CommercialRecurringBillingLine`.

Source: `lightbulb/commercial_operations_lifecycle.py:827`.

### `lightbulb.CommercialRecurringBillingProposal`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommercialRecurringBillingProposal
~~~


Binding: `lightbulb.commercial_operations_lifecycle.CommercialRecurringBillingProposal` → `lightbulb.commercial_operations_lifecycle.CommercialRecurringBillingProposal`.

Source: `lightbulb/commercial_operations_lifecycle.py:850`.

### `lightbulb.CommercialTransitionCandidate`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommercialTransitionCandidate
~~~


Binding: `lightbulb.commercial_operations_lifecycle.CommercialTransitionCandidate` → `lightbulb.commercial_operations_lifecycle.CommercialTransitionCandidate`.

Source: `lightbulb/commercial_operations_lifecycle.py:1623`.

### `lightbulb.CommercialTransitionReceipt`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommercialTransitionReceipt
~~~


Binding: `lightbulb.commercial_operations_lifecycle.CommercialTransitionReceipt` → `lightbulb.commercial_operations_lifecycle.CommercialTransitionReceipt`.

Source: `lightbulb/commercial_operations_lifecycle.py:1896`.

### `lightbulb.CommercialTransitionRecovery`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommercialTransitionRecovery
~~~


Binding: `lightbulb.commercial_operations_lifecycle.CommercialTransitionRecovery` → `lightbulb.commercial_operations_lifecycle.CommercialTransitionRecovery`.

Source: `lightbulb/commercial_operations_lifecycle.py:1880`.

### `lightbulb.PrepareCommissionRevOpsHandoffCommand`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PrepareCommissionRevOpsHandoffCommand
~~~


Binding: `lightbulb.commercial_operations_lifecycle.PrepareCommissionRevOpsHandoffCommand` → `lightbulb.commercial_operations_lifecycle.PrepareCommissionRevOpsHandoffCommand`.

Source: `lightbulb/commercial_operations_lifecycle.py:1373`.

### `lightbulb.PrepareRenewalCommand`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PrepareRenewalCommand
~~~


Binding: `lightbulb.commercial_operations_lifecycle.PrepareRenewalCommand` → `lightbulb.commercial_operations_lifecycle.PrepareRenewalCommand`.

Source: `lightbulb/commercial_operations_lifecycle.py:1196`.

### `lightbulb.ProposeCommercialOperationsTransitionPrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProposeCommercialOperationsTransitionPrimitive
~~~


Binding: `lightbulb.commercial_operations_lifecycle.ProposeCommercialOperationsTransitionPrimitive` → `lightbulb.commercial_operations_lifecycle.ProposeCommercialOperationsTransitionPrimitive`.

Source: `lightbulb/commercial_operations_lifecycle.py:3353`.

### `lightbulb.ProposeQuoteCommand`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProposeQuoteCommand
~~~


Binding: `lightbulb.commercial_operations_lifecycle.ProposeQuoteCommand` → `lightbulb.commercial_operations_lifecycle.ProposeQuoteCommand`.

Source: `lightbulb/commercial_operations_lifecycle.py:578`.

### `lightbulb.ProposeRecurringBillingCommand`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProposeRecurringBillingCommand
~~~


Binding: `lightbulb.commercial_operations_lifecycle.ProposeRecurringBillingCommand` → `lightbulb.commercial_operations_lifecycle.ProposeRecurringBillingCommand`.

Source: `lightbulb/commercial_operations_lifecycle.py:1132`.

### `lightbulb.ProposeUsageBillingCommand`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProposeUsageBillingCommand
~~~


Binding: `lightbulb.commercial_operations_lifecycle.ProposeUsageBillingCommand` → `lightbulb.commercial_operations_lifecycle.ProposeUsageBillingCommand`.

Source: `lightbulb/commercial_operations_lifecycle.py:940`.

### `lightbulb.ReviewContractOrderCommand`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ReviewContractOrderCommand
~~~


Binding: `lightbulb.commercial_operations_lifecycle.ReviewContractOrderCommand` → `lightbulb.commercial_operations_lifecycle.ReviewContractOrderCommand`.

Source: `lightbulb/commercial_operations_lifecycle.py:691`.

### `lightbulb.commercial_command_digest`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import commercial_command_digest
~~~


Binding: `lightbulb.commercial_operations_lifecycle.commercial_command_digest` → `lightbulb.commercial_operations_lifecycle.commercial_command_digest`.

Source: `lightbulb/commercial_operations_lifecycle.py:1572`.

### `lightbulb.commercial_command_evidence_digest`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import commercial_command_evidence_digest
~~~


Binding: `lightbulb.commercial_operations_lifecycle.commercial_command_evidence_digest` → `lightbulb.commercial_operations_lifecycle.commercial_command_evidence_digest`.

Source: `lightbulb/commercial_operations_lifecycle.py:1544`.

### `lightbulb.commercial_scope_digest`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import commercial_scope_digest
~~~


Binding: `lightbulb.commercial_operations_lifecycle.commercial_scope_digest` → `lightbulb.commercial_operations_lifecycle.commercial_scope_digest`.

Source: `lightbulb/commercial_operations_lifecycle.py:394`.

### `lightbulb.materialize_commercial_operations_candidate`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import materialize_commercial_operations_candidate
~~~


Binding: `lightbulb.commercial_operations_lifecycle.materialize_commercial_operations_candidate` → `lightbulb.commercial_operations_lifecycle.materialize_commercial_operations_candidate`.

Source: `lightbulb/commercial_operations_lifecycle.py:3153`.

### `lightbulb.seal_commercial_command`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import seal_commercial_command
~~~


Binding: `lightbulb.commercial_operations_lifecycle.seal_commercial_command` → `lightbulb.commercial_operations_lifecycle.seal_commercial_command`.

Source: `lightbulb/commercial_operations_lifecycle.py:1594`.

### `lightbulb.SERVICE_CONTROL_INPUT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SERVICE_CONTROL_INPUT_SCHEMA
~~~


Binding: `lightbulb.service_controls.SERVICE_CONTROL_INPUT_SCHEMA` → `lightbulb.service_controls.SERVICE_CONTROL_INPUT_SCHEMA`.

Source: `lightbulb/service_controls.py:47`.

### `lightbulb.SERVICE_CONTROL_OPERATION`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SERVICE_CONTROL_OPERATION
~~~


Binding: `lightbulb.service_controls.SERVICE_CONTROL_OPERATION` → `lightbulb.service_controls.SERVICE_CONTROL_OPERATION`.

Source: `lightbulb/service_controls.py:554`.

### `lightbulb.SERVICE_CONTROL_RESULT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SERVICE_CONTROL_RESULT_SCHEMA
~~~


Binding: `lightbulb.service_controls.SERVICE_CONTROL_RESULT_SCHEMA` → `lightbulb.service_controls.SERVICE_CONTROL_RESULT_SCHEMA`.

Source: `lightbulb/service_controls.py:48`.

### `lightbulb.EvaluateCaseResolutionControlsPrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import EvaluateCaseResolutionControlsPrimitive
~~~


Binding: `lightbulb.service_controls.EvaluateCaseResolutionControlsPrimitive` → `lightbulb.service_controls.EvaluateCaseResolutionControlsPrimitive`.

Source: `lightbulb/service_controls.py:1226`.

### `lightbulb.ServiceControlInput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ServiceControlInput
~~~


Binding: `lightbulb.service_controls.ServiceControlInput` → `lightbulb.service_controls.ServiceControlInput`.

Source: `lightbulb/service_controls.py:428`.

### `lightbulb.ServiceControlPolicy`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ServiceControlPolicy
~~~


Binding: `lightbulb.service_controls.ServiceControlPolicy` → `lightbulb.service_controls.ServiceControlPolicy`.

Source: `lightbulb/service_controls.py:406`.

### `lightbulb.ServiceControlResult`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ServiceControlResult
~~~


Binding: `lightbulb.service_controls.ServiceControlResult` → `lightbulb.service_controls.ServiceControlResult`.

Source: `lightbulb/service_controls.py:565`.

### `lightbulb.ServiceEffectBoundary`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ServiceEffectBoundary
~~~


Binding: `lightbulb.service_controls.ServiceEffectBoundary` → `lightbulb.service_controls.ServiceEffectBoundary`.

Source: `lightbulb/service_controls.py:543`.

### `lightbulb.evaluate_service_case_controls`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import evaluate_service_case_controls
~~~


Binding: `lightbulb.service_controls.evaluate_service_case_controls` → `lightbulb.service_controls.evaluate_service_case_controls`.

Source: `lightbulb/service_controls.py:727`.

### `lightbulb.MAX_SERVICE_ASSET_TRANSITIONS`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import MAX_SERVICE_ASSET_TRANSITIONS
~~~


Binding: `lightbulb.service_asset_remedy_lifecycle.MAX_SERVICE_ASSET_TRANSITIONS` → `lightbulb.service_asset_remedy_lifecycle.MAX_SERVICE_ASSET_TRANSITIONS`.

Source: `lightbulb/service_asset_remedy_lifecycle.py:74`.

### `lightbulb.SERVICE_ASSET_REMEDY_AUTHORIZATION_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SERVICE_ASSET_REMEDY_AUTHORIZATION_SCHEMA
~~~


Binding: `lightbulb.service_asset_remedy_lifecycle.SERVICE_ASSET_REMEDY_AUTHORIZATION_SCHEMA` → `lightbulb.service_asset_remedy_lifecycle.SERVICE_ASSET_REMEDY_AUTHORIZATION_SCHEMA`.

Source: `lightbulb/service_asset_remedy_lifecycle.py:55`.

### `lightbulb.SERVICE_ASSET_REMEDY_EVIDENCE_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SERVICE_ASSET_REMEDY_EVIDENCE_SCHEMA
~~~


Binding: `lightbulb.service_asset_remedy_lifecycle.SERVICE_ASSET_REMEDY_EVIDENCE_SCHEMA` → `lightbulb.service_asset_remedy_lifecycle.SERVICE_ASSET_REMEDY_EVIDENCE_SCHEMA`.

Source: `lightbulb/service_asset_remedy_lifecycle.py:54`.

### `lightbulb.SERVICE_ASSET_REMEDY_LIFECYCLE_EXECUTABLE_PRIMITIVES`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SERVICE_ASSET_REMEDY_LIFECYCLE_EXECUTABLE_PRIMITIVES
~~~


Binding: `lightbulb.service_asset_remedy_lifecycle.SERVICE_ASSET_REMEDY_LIFECYCLE_EXECUTABLE_PRIMITIVES` → `lightbulb.service_asset_remedy_lifecycle.SERVICE_ASSET_REMEDY_LIFECYCLE_EXECUTABLE_PRIMITIVES`.

Source: `lightbulb/service_asset_remedy_lifecycle.py:3238`.

### `lightbulb.SERVICE_ASSET_REMEDY_PROPOSAL_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SERVICE_ASSET_REMEDY_PROPOSAL_SCHEMA
~~~


Binding: `lightbulb.service_asset_remedy_lifecycle.SERVICE_ASSET_REMEDY_PROPOSAL_SCHEMA` → `lightbulb.service_asset_remedy_lifecycle.SERVICE_ASSET_REMEDY_PROPOSAL_SCHEMA`.

Source: `lightbulb/service_asset_remedy_lifecycle.py:65`.

### `lightbulb.SERVICE_ASSET_REMEDY_REQUEST_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SERVICE_ASSET_REMEDY_REQUEST_SCHEMA
~~~


Binding: `lightbulb.service_asset_remedy_lifecycle.SERVICE_ASSET_REMEDY_REQUEST_SCHEMA` → `lightbulb.service_asset_remedy_lifecycle.SERVICE_ASSET_REMEDY_REQUEST_SCHEMA`.

Source: `lightbulb/service_asset_remedy_lifecycle.py:62`.

### `lightbulb.SERVICE_ASSET_REMEDY_RESULT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SERVICE_ASSET_REMEDY_RESULT_SCHEMA
~~~


Binding: `lightbulb.service_asset_remedy_lifecycle.SERVICE_ASSET_REMEDY_RESULT_SCHEMA` → `lightbulb.service_asset_remedy_lifecycle.SERVICE_ASSET_REMEDY_RESULT_SCHEMA`.

Source: `lightbulb/service_asset_remedy_lifecycle.py:68`.

### `lightbulb.SERVICE_ASSET_REMEDY_SCOPE_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SERVICE_ASSET_REMEDY_SCOPE_SCHEMA
~~~


Binding: `lightbulb.service_asset_remedy_lifecycle.SERVICE_ASSET_REMEDY_SCOPE_SCHEMA` → `lightbulb.service_asset_remedy_lifecycle.SERVICE_ASSET_REMEDY_SCOPE_SCHEMA`.

Source: `lightbulb/service_asset_remedy_lifecycle.py:53`.

### `lightbulb.SERVICE_ASSET_REMEDY_SNAPSHOT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SERVICE_ASSET_REMEDY_SNAPSHOT_SCHEMA
~~~


Binding: `lightbulb.service_asset_remedy_lifecycle.SERVICE_ASSET_REMEDY_SNAPSHOT_SCHEMA` → `lightbulb.service_asset_remedy_lifecycle.SERVICE_ASSET_REMEDY_SNAPSHOT_SCHEMA`.

Source: `lightbulb/service_asset_remedy_lifecycle.py:61`.

### `lightbulb.SERVICE_ASSET_REMEDY_TRANSITION_OPERATION`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SERVICE_ASSET_REMEDY_TRANSITION_OPERATION
~~~


Binding: `lightbulb.service_asset_remedy_lifecycle.SERVICE_ASSET_REMEDY_TRANSITION_OPERATION` → `lightbulb.service_asset_remedy_lifecycle.SERVICE_ASSET_REMEDY_TRANSITION_OPERATION`.

Source: `lightbulb/service_asset_remedy_lifecycle.py:2811`.

### `lightbulb.SERVICE_ASSET_REMEDY_TRANSITION_RECORD_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SERVICE_ASSET_REMEDY_TRANSITION_RECORD_SCHEMA
~~~


Binding: `lightbulb.service_asset_remedy_lifecycle.SERVICE_ASSET_REMEDY_TRANSITION_RECORD_SCHEMA` → `lightbulb.service_asset_remedy_lifecycle.SERVICE_ASSET_REMEDY_TRANSITION_RECORD_SCHEMA`.

Source: `lightbulb/service_asset_remedy_lifecycle.py:58`.

### `lightbulb.SERVICE_ASSET_REMEDY_ZERO_DIGEST`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SERVICE_ASSET_REMEDY_ZERO_DIGEST
~~~


Binding: `lightbulb.service_asset_remedy_lifecycle.SERVICE_ASSET_REMEDY_ZERO_DIGEST` → `lightbulb.service_asset_remedy_lifecycle.SERVICE_ASSET_REMEDY_ZERO_DIGEST`.

Source: `lightbulb/service_asset_remedy_lifecycle.py:73`.

### `lightbulb.SPRING_SERVICE_ASSET_EVIDENCE_CUSTODIAN`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SPRING_SERVICE_ASSET_EVIDENCE_CUSTODIAN
~~~


Binding: `lightbulb.service_asset_remedy_lifecycle.SPRING_SERVICE_ASSET_EVIDENCE_CUSTODIAN` → `lightbulb.service_asset_remedy_lifecycle.SPRING_SERVICE_ASSET_EVIDENCE_CUSTODIAN`.

Source: `lightbulb/service_asset_remedy_lifecycle.py:72`.

### `lightbulb.SPRING_SERVICE_ASSET_EVIDENCE_ISSUER`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SPRING_SERVICE_ASSET_EVIDENCE_ISSUER
~~~


Binding: `lightbulb.service_asset_remedy_lifecycle.SPRING_SERVICE_ASSET_EVIDENCE_ISSUER` → `lightbulb.service_asset_remedy_lifecycle.SPRING_SERVICE_ASSET_EVIDENCE_ISSUER`.

Source: `lightbulb/service_asset_remedy_lifecycle.py:71`.

### `lightbulb.PlanFieldServiceCommand`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PlanFieldServiceCommand
~~~


Binding: `lightbulb.service_asset_remedy_lifecycle.PlanFieldServiceCommand` → `lightbulb.service_asset_remedy_lifecycle.PlanFieldServiceCommand`.

Source: `lightbulb/service_asset_remedy_lifecycle.py:646`.

### `lightbulb.PrepareServiceWorkCommand`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PrepareServiceWorkCommand
~~~


Binding: `lightbulb.service_asset_remedy_lifecycle.PrepareServiceWorkCommand` → `lightbulb.service_asset_remedy_lifecycle.PrepareServiceWorkCommand`.

Source: `lightbulb/service_asset_remedy_lifecycle.py:702`.

### `lightbulb.ProposeServiceAssetRemedyTransitionPrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProposeServiceAssetRemedyTransitionPrimitive
~~~


Binding: `lightbulb.service_asset_remedy_lifecycle.ProposeServiceAssetRemedyTransitionPrimitive` → `lightbulb.service_asset_remedy_lifecycle.ProposeServiceAssetRemedyTransitionPrimitive`.

Source: `lightbulb/service_asset_remedy_lifecycle.py:3058`.

### `lightbulb.ProposeServiceClosureCandidateCommand`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProposeServiceClosureCandidateCommand
~~~


Binding: `lightbulb.service_asset_remedy_lifecycle.ProposeServiceClosureCandidateCommand` → `lightbulb.service_asset_remedy_lifecycle.ProposeServiceClosureCandidateCommand`.

Source: `lightbulb/service_asset_remedy_lifecycle.py:990`.

### `lightbulb.RecordDepotReceiptCommand`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import RecordDepotReceiptCommand
~~~


Binding: `lightbulb.service_asset_remedy_lifecycle.RecordDepotReceiptCommand` → `lightbulb.service_asset_remedy_lifecycle.RecordDepotReceiptCommand`.

Source: `lightbulb/service_asset_remedy_lifecycle.py:620`.

### `lightbulb.RecordDepotReturnDeliveryCommand`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import RecordDepotReturnDeliveryCommand
~~~


Binding: `lightbulb.service_asset_remedy_lifecycle.RecordDepotReturnDeliveryCommand` → `lightbulb.service_asset_remedy_lifecycle.RecordDepotReturnDeliveryCommand`.

Source: `lightbulb/service_asset_remedy_lifecycle.py:917`.

### `lightbulb.RecordDiagnosticCommand`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import RecordDiagnosticCommand
~~~


Binding: `lightbulb.service_asset_remedy_lifecycle.RecordDiagnosticCommand` → `lightbulb.service_asset_remedy_lifecycle.RecordDiagnosticCommand`.

Source: `lightbulb/service_asset_remedy_lifecycle.py:680`.

### `lightbulb.RecordFieldReinstallationCommand`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import RecordFieldReinstallationCommand
~~~


Binding: `lightbulb.service_asset_remedy_lifecycle.RecordFieldReinstallationCommand` → `lightbulb.service_asset_remedy_lifecycle.RecordFieldReinstallationCommand`.

Source: `lightbulb/service_asset_remedy_lifecycle.py:943`.

### `lightbulb.RecordServiceWorkCompletionCommand`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import RecordServiceWorkCompletionCommand
~~~


Binding: `lightbulb.service_asset_remedy_lifecycle.RecordServiceWorkCompletionCommand` → `lightbulb.service_asset_remedy_lifecycle.RecordServiceWorkCompletionCommand`.

Source: `lightbulb/service_asset_remedy_lifecycle.py:750`.

### `lightbulb.ServiceAssetRemedyAuthorizationCommitment`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ServiceAssetRemedyAuthorizationCommitment
~~~


Binding: `lightbulb.service_asset_remedy_lifecycle.ServiceAssetRemedyAuthorizationCommitment` → `lightbulb.service_asset_remedy_lifecycle.ServiceAssetRemedyAuthorizationCommitment`.

Source: `lightbulb/service_asset_remedy_lifecycle.py:346`.

### `lightbulb.ServiceAssetRemedyBranch`

value. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ServiceAssetRemedyBranch
~~~


Binding: `lightbulb.service_asset_remedy_lifecycle.ServiceAssetRemedyBranch` → `lightbulb.service_asset_remedy_lifecycle.ServiceAssetRemedyBranch`.

Source: `lightbulb/service_asset_remedy_lifecycle.py:84`.

### `lightbulb.ServiceAssetRemedyCommand`

value. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ServiceAssetRemedyCommand
~~~


Binding: `lightbulb.service_asset_remedy_lifecycle.ServiceAssetRemedyCommand` → `lightbulb.service_asset_remedy_lifecycle.ServiceAssetRemedyCommand`.

Source: `lightbulb/service_asset_remedy_lifecycle.py:1010`.

### `lightbulb.ServiceAssetRemedyEffectBoundary`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ServiceAssetRemedyEffectBoundary
~~~


Binding: `lightbulb.service_asset_remedy_lifecycle.ServiceAssetRemedyEffectBoundary` → `lightbulb.service_asset_remedy_lifecycle.ServiceAssetRemedyEffectBoundary`.

Source: `lightbulb/service_asset_remedy_lifecycle.py:2791`.

### `lightbulb.ServiceAssetRemedyError`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ServiceAssetRemedyError
~~~


Binding: `lightbulb.service_asset_remedy_lifecycle.ServiceAssetRemedyError` → `lightbulb.service_asset_remedy_lifecycle.ServiceAssetRemedyError`.

Source: `lightbulb/service_asset_remedy_lifecycle.py:100`.

### `lightbulb.ServiceAssetRemedyEvidence`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ServiceAssetRemedyEvidence
~~~


Binding: `lightbulb.service_asset_remedy_lifecycle.ServiceAssetRemedyEvidence` → `lightbulb.service_asset_remedy_lifecycle.ServiceAssetRemedyEvidence`.

Source: `lightbulb/service_asset_remedy_lifecycle.py:290`.

### `lightbulb.ServiceAssetRemedyProjection`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ServiceAssetRemedyProjection
~~~


Binding: `lightbulb.service_asset_remedy_lifecycle.ServiceAssetRemedyProjection` → `lightbulb.service_asset_remedy_lifecycle.ServiceAssetRemedyProjection`.

Source: `lightbulb/service_asset_remedy_lifecycle.py:1260`.

### `lightbulb.ServiceAssetRemedyScope`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ServiceAssetRemedyScope
~~~


Binding: `lightbulb.service_asset_remedy_lifecycle.ServiceAssetRemedyScope` → `lightbulb.service_asset_remedy_lifecycle.ServiceAssetRemedyScope`.

Source: `lightbulb/service_asset_remedy_lifecycle.py:229`.

### `lightbulb.ServiceAssetRemedySnapshot`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ServiceAssetRemedySnapshot
~~~


Binding: `lightbulb.service_asset_remedy_lifecycle.ServiceAssetRemedySnapshot` → `lightbulb.service_asset_remedy_lifecycle.ServiceAssetRemedySnapshot`.

Source: `lightbulb/service_asset_remedy_lifecycle.py:2246`.

### `lightbulb.ServiceAssetRemedyState`

value. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ServiceAssetRemedyState
~~~


Binding: `lightbulb.service_asset_remedy_lifecycle.ServiceAssetRemedyState` → `lightbulb.service_asset_remedy_lifecycle.ServiceAssetRemedyState`.

Source: `lightbulb/service_asset_remedy_lifecycle.py:85`.

### `lightbulb.ServiceAssetRemedyTransitionProposal`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ServiceAssetRemedyTransitionProposal
~~~


Binding: `lightbulb.service_asset_remedy_lifecycle.ServiceAssetRemedyTransitionProposal` → `lightbulb.service_asset_remedy_lifecycle.ServiceAssetRemedyTransitionProposal`.

Source: `lightbulb/service_asset_remedy_lifecycle.py:2504`.

### `lightbulb.ServiceAssetRemedyTransitionRecord`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ServiceAssetRemedyTransitionRecord
~~~


Binding: `lightbulb.service_asset_remedy_lifecycle.ServiceAssetRemedyTransitionRecord` → `lightbulb.service_asset_remedy_lifecycle.ServiceAssetRemedyTransitionRecord`.

Source: `lightbulb/service_asset_remedy_lifecycle.py:1839`.

### `lightbulb.ServiceAssetRemedyTransitionRequest`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ServiceAssetRemedyTransitionRequest
~~~


Binding: `lightbulb.service_asset_remedy_lifecycle.ServiceAssetRemedyTransitionRequest` → `lightbulb.service_asset_remedy_lifecycle.ServiceAssetRemedyTransitionRequest`.

Source: `lightbulb/service_asset_remedy_lifecycle.py:2387`.

### `lightbulb.ServiceAssetRemedyTransitionResult`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ServiceAssetRemedyTransitionResult
~~~


Binding: `lightbulb.service_asset_remedy_lifecycle.ServiceAssetRemedyTransitionResult` → `lightbulb.service_asset_remedy_lifecycle.ServiceAssetRemedyTransitionResult`.

Source: `lightbulb/service_asset_remedy_lifecycle.py:2553`.

### `lightbulb.ServicePartCustody`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ServicePartCustody
~~~


Binding: `lightbulb.service_asset_remedy_lifecycle.ServicePartCustody` → `lightbulb.service_asset_remedy_lifecycle.ServicePartCustody`.

Source: `lightbulb/service_asset_remedy_lifecycle.py:462`.

### `lightbulb.ServicePartInstallation`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ServicePartInstallation
~~~


Binding: `lightbulb.service_asset_remedy_lifecycle.ServicePartInstallation` → `lightbulb.service_asset_remedy_lifecycle.ServicePartInstallation`.

Source: `lightbulb/service_asset_remedy_lifecycle.py:519`.

### `lightbulb.ValidateWarrantyEntitlementCommand`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ValidateWarrantyEntitlementCommand
~~~


Binding: `lightbulb.service_asset_remedy_lifecycle.ValidateWarrantyEntitlementCommand` → `lightbulb.service_asset_remedy_lifecycle.ValidateWarrantyEntitlementCommand`.

Source: `lightbulb/service_asset_remedy_lifecycle.py:582`.

### `lightbulb.VerifyCustomerResolutionCommand`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import VerifyCustomerResolutionCommand
~~~


Binding: `lightbulb.service_asset_remedy_lifecycle.VerifyCustomerResolutionCommand` → `lightbulb.service_asset_remedy_lifecycle.VerifyCustomerResolutionCommand`.

Source: `lightbulb/service_asset_remedy_lifecycle.py:966`.

### `lightbulb.VerifyIndependentRepairCommand`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import VerifyIndependentRepairCommand
~~~


Binding: `lightbulb.service_asset_remedy_lifecycle.VerifyIndependentRepairCommand` → `lightbulb.service_asset_remedy_lifecycle.VerifyIndependentRepairCommand`.

Source: `lightbulb/service_asset_remedy_lifecycle.py:894`.

### `lightbulb.propose_service_asset_remedy_transition`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import propose_service_asset_remedy_transition
~~~


Binding: `lightbulb.service_asset_remedy_lifecycle.propose_service_asset_remedy_transition` → `lightbulb.service_asset_remedy_lifecycle.propose_service_asset_remedy_transition`.

Source: `lightbulb/service_asset_remedy_lifecycle.py:2594`.

### `lightbulb.service_asset_remedy_authorization_digest`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import service_asset_remedy_authorization_digest
~~~


Binding: `lightbulb.service_asset_remedy_lifecycle.service_asset_remedy_authorization_digest` → `lightbulb.service_asset_remedy_lifecycle.service_asset_remedy_authorization_digest`.

Source: `lightbulb/service_asset_remedy_lifecycle.py:453`.

### `lightbulb.service_asset_remedy_command_digest`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import service_asset_remedy_command_digest
~~~


Binding: `lightbulb.service_asset_remedy_lifecycle.service_asset_remedy_command_digest` → `lightbulb.service_asset_remedy_lifecycle.service_asset_remedy_command_digest`.

Source: `lightbulb/service_asset_remedy_lifecycle.py:1029`.

### `lightbulb.service_asset_remedy_fact_evidence_digest`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import service_asset_remedy_fact_evidence_digest
~~~


Binding: `lightbulb.service_asset_remedy_lifecycle.service_asset_remedy_fact_evidence_digest` → `lightbulb.service_asset_remedy_lifecycle.service_asset_remedy_fact_evidence_digest`.

Source: `lightbulb/service_asset_remedy_lifecycle.py:1228`.

### `lightbulb.service_asset_remedy_idempotency_digest`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import service_asset_remedy_idempotency_digest
~~~


Binding: `lightbulb.service_asset_remedy_lifecycle.service_asset_remedy_idempotency_digest` → `lightbulb.service_asset_remedy_lifecycle.service_asset_remedy_idempotency_digest`.

Source: `lightbulb/service_asset_remedy_lifecycle.py:1036`.

### `lightbulb.service_asset_remedy_root_commitment_digest`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import service_asset_remedy_root_commitment_digest
~~~


Binding: `lightbulb.service_asset_remedy_lifecycle.service_asset_remedy_root_commitment_digest` → `lightbulb.service_asset_remedy_lifecycle.service_asset_remedy_root_commitment_digest`.

Source: `lightbulb/service_asset_remedy_lifecycle.py:1056`.

### `lightbulb.service_asset_remedy_scope_digest`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import service_asset_remedy_scope_digest
~~~


Binding: `lightbulb.service_asset_remedy_lifecycle.service_asset_remedy_scope_digest` → `lightbulb.service_asset_remedy_lifecycle.service_asset_remedy_scope_digest`.

Source: `lightbulb/service_asset_remedy_lifecycle.py:283`.

### `lightbulb.service_asset_remedy_snapshot_digest`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import service_asset_remedy_snapshot_digest
~~~


Binding: `lightbulb.service_asset_remedy_lifecycle.service_asset_remedy_snapshot_digest` → `lightbulb.service_asset_remedy_lifecycle.service_asset_remedy_snapshot_digest`.

Source: `lightbulb/service_asset_remedy_lifecycle.py:2350`.

### `lightbulb.service_asset_remedy_transition_evidence_digest`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import service_asset_remedy_transition_evidence_digest
~~~


Binding: `lightbulb.service_asset_remedy_lifecycle.service_asset_remedy_transition_evidence_digest` → `lightbulb.service_asset_remedy_lifecycle.service_asset_remedy_transition_evidence_digest`.

Source: `lightbulb/service_asset_remedy_lifecycle.py:1248`.

### `lightbulb.CASE_INTAKE_OPERATION`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CASE_INTAKE_OPERATION
~~~


Binding: `lightbulb.customer_service_lifecycle.CASE_INTAKE_OPERATION` → `lightbulb.customer_service_lifecycle.CASE_INTAKE_OPERATION`.

Source: `lightbulb/customer_service_lifecycle.py:1134`.

### `lightbulb.CASE_ROUTING_OPERATION`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CASE_ROUTING_OPERATION
~~~


Binding: `lightbulb.customer_service_lifecycle.CASE_ROUTING_OPERATION` → `lightbulb.customer_service_lifecycle.CASE_ROUTING_OPERATION`.

Source: `lightbulb/customer_service_lifecycle.py:1143`.

### `lightbulb.CUSTOMER_SERVICE_LIFECYCLE_EXECUTABLE_PRIMITIVES`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CUSTOMER_SERVICE_LIFECYCLE_EXECUTABLE_PRIMITIVES
~~~


Binding: `lightbulb.customer_service_lifecycle.CUSTOMER_SERVICE_LIFECYCLE_EXECUTABLE_PRIMITIVES` → `lightbulb.customer_service_lifecycle.CUSTOMER_SERVICE_LIFECYCLE_EXECUTABLE_PRIMITIVES`.

Source: `lightbulb/customer_service_lifecycle.py:2793`.

### `lightbulb.REMEDY_PROPOSAL_OPERATION`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import REMEDY_PROPOSAL_OPERATION
~~~


Binding: `lightbulb.customer_service_lifecycle.REMEDY_PROPOSAL_OPERATION` → `lightbulb.customer_service_lifecycle.REMEDY_PROPOSAL_OPERATION`.

Source: `lightbulb/customer_service_lifecycle.py:1170`.

### `lightbulb.RESOLUTION_SUBMISSION_OPERATION`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import RESOLUTION_SUBMISSION_OPERATION
~~~


Binding: `lightbulb.customer_service_lifecycle.RESOLUTION_SUBMISSION_OPERATION` → `lightbulb.customer_service_lifecycle.RESOLUTION_SUBMISSION_OPERATION`.

Source: `lightbulb/customer_service_lifecycle.py:1152`.

### `lightbulb.RESOLUTION_VERIFICATION_OPERATION`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import RESOLUTION_VERIFICATION_OPERATION
~~~


Binding: `lightbulb.customer_service_lifecycle.RESOLUTION_VERIFICATION_OPERATION` → `lightbulb.customer_service_lifecycle.RESOLUTION_VERIFICATION_OPERATION`.

Source: `lightbulb/customer_service_lifecycle.py:1161`.

### `lightbulb.SERVICE_CASE_INTAKE_INPUT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SERVICE_CASE_INTAKE_INPUT_SCHEMA
~~~


Binding: `lightbulb.customer_service_lifecycle.SERVICE_CASE_INTAKE_INPUT_SCHEMA` → `lightbulb.customer_service_lifecycle.SERVICE_CASE_INTAKE_INPUT_SCHEMA`.

Source: `lightbulb/customer_service_lifecycle.py:61`.

### `lightbulb.SERVICE_CASE_LIFECYCLE_SNAPSHOT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SERVICE_CASE_LIFECYCLE_SNAPSHOT_SCHEMA
~~~


Binding: `lightbulb.customer_service_lifecycle.SERVICE_CASE_LIFECYCLE_SNAPSHOT_SCHEMA` → `lightbulb.customer_service_lifecycle.SERVICE_CASE_LIFECYCLE_SNAPSHOT_SCHEMA`.

Source: `lightbulb/customer_service_lifecycle.py:60`.

### `lightbulb.SERVICE_CASE_ROUTE_INPUT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SERVICE_CASE_ROUTE_INPUT_SCHEMA
~~~


Binding: `lightbulb.customer_service_lifecycle.SERVICE_CASE_ROUTE_INPUT_SCHEMA` → `lightbulb.customer_service_lifecycle.SERVICE_CASE_ROUTE_INPUT_SCHEMA`.

Source: `lightbulb/customer_service_lifecycle.py:62`.

### `lightbulb.SERVICE_CONTACT_POLICY_BINDING_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SERVICE_CONTACT_POLICY_BINDING_SCHEMA
~~~


Binding: `lightbulb.customer_service_lifecycle.SERVICE_CONTACT_POLICY_BINDING_SCHEMA` → `lightbulb.customer_service_lifecycle.SERVICE_CONTACT_POLICY_BINDING_SCHEMA`.

Source: `lightbulb/customer_service_lifecycle.py:57`.

### `lightbulb.SERVICE_REMEDY_AUTHORIZATION_PROPOSAL_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SERVICE_REMEDY_AUTHORIZATION_PROPOSAL_SCHEMA
~~~


Binding: `lightbulb.customer_service_lifecycle.SERVICE_REMEDY_AUTHORIZATION_PROPOSAL_SCHEMA` → `lightbulb.customer_service_lifecycle.SERVICE_REMEDY_AUTHORIZATION_PROPOSAL_SCHEMA`.

Source: `lightbulb/customer_service_lifecycle.py:70`.

### `lightbulb.SERVICE_REMEDY_PROPOSAL_INPUT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SERVICE_REMEDY_PROPOSAL_INPUT_SCHEMA
~~~


Binding: `lightbulb.customer_service_lifecycle.SERVICE_REMEDY_PROPOSAL_INPUT_SCHEMA` → `lightbulb.customer_service_lifecycle.SERVICE_REMEDY_PROPOSAL_INPUT_SCHEMA`.

Source: `lightbulb/customer_service_lifecycle.py:69`.

### `lightbulb.SERVICE_REMEDY_PROPOSAL_RESULT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SERVICE_REMEDY_PROPOSAL_RESULT_SCHEMA
~~~


Binding: `lightbulb.customer_service_lifecycle.SERVICE_REMEDY_PROPOSAL_RESULT_SCHEMA` → `lightbulb.customer_service_lifecycle.SERVICE_REMEDY_PROPOSAL_RESULT_SCHEMA`.

Source: `lightbulb/customer_service_lifecycle.py:73`.

### `lightbulb.SERVICE_RESOLUTION_SUBMISSION_INPUT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SERVICE_RESOLUTION_SUBMISSION_INPUT_SCHEMA
~~~


Binding: `lightbulb.customer_service_lifecycle.SERVICE_RESOLUTION_SUBMISSION_INPUT_SCHEMA` → `lightbulb.customer_service_lifecycle.SERVICE_RESOLUTION_SUBMISSION_INPUT_SCHEMA`.

Source: `lightbulb/customer_service_lifecycle.py:63`.

### `lightbulb.SERVICE_RESOLUTION_VERIFICATION_COMMITMENT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SERVICE_RESOLUTION_VERIFICATION_COMMITMENT_SCHEMA
~~~


Binding: `lightbulb.customer_service_lifecycle.SERVICE_RESOLUTION_VERIFICATION_COMMITMENT_SCHEMA` → `lightbulb.customer_service_lifecycle.SERVICE_RESOLUTION_VERIFICATION_COMMITMENT_SCHEMA`.

Source: `lightbulb/customer_service_lifecycle.py:74`.

### `lightbulb.SERVICE_RESOLUTION_VERIFICATION_INPUT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SERVICE_RESOLUTION_VERIFICATION_INPUT_SCHEMA
~~~


Binding: `lightbulb.customer_service_lifecycle.SERVICE_RESOLUTION_VERIFICATION_INPUT_SCHEMA` → `lightbulb.customer_service_lifecycle.SERVICE_RESOLUTION_VERIFICATION_INPUT_SCHEMA`.

Source: `lightbulb/customer_service_lifecycle.py:66`.

### `lightbulb.SERVICE_SCOPE_BINDING_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SERVICE_SCOPE_BINDING_SCHEMA
~~~


Binding: `lightbulb.customer_service_lifecycle.SERVICE_SCOPE_BINDING_SCHEMA` → `lightbulb.customer_service_lifecycle.SERVICE_SCOPE_BINDING_SCHEMA`.

Source: `lightbulb/customer_service_lifecycle.py:56`.

### `lightbulb.SERVICE_SLA_POLICY_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SERVICE_SLA_POLICY_SCHEMA
~~~


Binding: `lightbulb.customer_service_lifecycle.SERVICE_SLA_POLICY_SCHEMA` → `lightbulb.customer_service_lifecycle.SERVICE_SLA_POLICY_SCHEMA`.

Source: `lightbulb/customer_service_lifecycle.py:58`.

### `lightbulb.SERVICE_TRANSITION_FENCE_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SERVICE_TRANSITION_FENCE_SCHEMA
~~~


Binding: `lightbulb.customer_service_lifecycle.SERVICE_TRANSITION_FENCE_SCHEMA` → `lightbulb.customer_service_lifecycle.SERVICE_TRANSITION_FENCE_SCHEMA`.

Source: `lightbulb/customer_service_lifecycle.py:59`.

### `lightbulb.SPRING_SERVICE_EVIDENCE_ISSUER`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SPRING_SERVICE_EVIDENCE_ISSUER
~~~


Binding: `lightbulb.customer_service_lifecycle.SPRING_SERVICE_EVIDENCE_ISSUER` → `lightbulb.customer_service_lifecycle.SPRING_SERVICE_EVIDENCE_ISSUER`.

Source: `lightbulb/customer_service_lifecycle.py:77`.

### `lightbulb.IntakeAndClassifyServiceCasePrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import IntakeAndClassifyServiceCasePrimitive
~~~


Binding: `lightbulb.customer_service_lifecycle.IntakeAndClassifyServiceCasePrimitive` → `lightbulb.customer_service_lifecycle.IntakeAndClassifyServiceCasePrimitive`.

Source: `lightbulb/customer_service_lifecycle.py:1605`.

### `lightbulb.IntakeServiceCaseInput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import IntakeServiceCaseInput
~~~


Binding: `lightbulb.customer_service_lifecycle.IntakeServiceCaseInput` → `lightbulb.customer_service_lifecycle.IntakeServiceCaseInput`.

Source: `lightbulb/customer_service_lifecycle.py:709`.

### `lightbulb.ProposeServiceRemedyAuthorizationPrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProposeServiceRemedyAuthorizationPrimitive
~~~


Binding: `lightbulb.customer_service_lifecycle.ProposeServiceRemedyAuthorizationPrimitive` → `lightbulb.customer_service_lifecycle.ProposeServiceRemedyAuthorizationPrimitive`.

Source: `lightbulb/customer_service_lifecycle.py:2238`.

### `lightbulb.ProposeServiceRemedyInput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProposeServiceRemedyInput
~~~


Binding: `lightbulb.customer_service_lifecycle.ProposeServiceRemedyInput` → `lightbulb.customer_service_lifecycle.ProposeServiceRemedyInput`.

Source: `lightbulb/customer_service_lifecycle.py:855`.

### `lightbulb.RouteAndEscalateServiceCasePrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import RouteAndEscalateServiceCasePrimitive
~~~


Binding: `lightbulb.customer_service_lifecycle.RouteAndEscalateServiceCasePrimitive` → `lightbulb.customer_service_lifecycle.RouteAndEscalateServiceCasePrimitive`.

Source: `lightbulb/customer_service_lifecycle.py:1769`.

### `lightbulb.RouteServiceCaseInput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import RouteServiceCaseInput
~~~


Binding: `lightbulb.customer_service_lifecycle.RouteServiceCaseInput` → `lightbulb.customer_service_lifecycle.RouteServiceCaseInput`.

Source: `lightbulb/customer_service_lifecycle.py:759`.

### `lightbulb.ServiceCaseLifecycleSnapshot`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ServiceCaseLifecycleSnapshot
~~~


Binding: `lightbulb.customer_service_lifecycle.ServiceCaseLifecycleSnapshot` → `lightbulb.customer_service_lifecycle.ServiceCaseLifecycleSnapshot`.

Source: `lightbulb/customer_service_lifecycle.py:422`.

### `lightbulb.ServiceContactPolicyBinding`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ServiceContactPolicyBinding
~~~


Binding: `lightbulb.customer_service_lifecycle.ServiceContactPolicyBinding` → `lightbulb.customer_service_lifecycle.ServiceContactPolicyBinding`.

Source: `lightbulb/customer_service_lifecycle.py:237`.

### `lightbulb.ServiceRemedyAuthorizationProposal`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ServiceRemedyAuthorizationProposal
~~~


Binding: `lightbulb.customer_service_lifecycle.ServiceRemedyAuthorizationProposal` → `lightbulb.customer_service_lifecycle.ServiceRemedyAuthorizationProposal`.

Source: `lightbulb/customer_service_lifecycle.py:931`.

### `lightbulb.ServiceRemedyProposalResult`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ServiceRemedyProposalResult
~~~


Binding: `lightbulb.customer_service_lifecycle.ServiceRemedyProposalResult` → `lightbulb.customer_service_lifecycle.ServiceRemedyProposalResult`.

Source: `lightbulb/customer_service_lifecycle.py:1083`.

### `lightbulb.ServiceRiskSignals`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ServiceRiskSignals
~~~


Binding: `lightbulb.customer_service_lifecycle.ServiceRiskSignals` → `lightbulb.customer_service_lifecycle.ServiceRiskSignals`.

Source: `lightbulb/customer_service_lifecycle.py:384`.

### `lightbulb.ServiceScopeBinding`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ServiceScopeBinding
~~~


Binding: `lightbulb.customer_service_lifecycle.ServiceScopeBinding` → `lightbulb.customer_service_lifecycle.ServiceScopeBinding`.

Source: `lightbulb/customer_service_lifecycle.py:209`.

### `lightbulb.ServiceSlaPolicy`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ServiceSlaPolicy
~~~


Binding: `lightbulb.customer_service_lifecycle.ServiceSlaPolicy` → `lightbulb.customer_service_lifecycle.ServiceSlaPolicy`.

Source: `lightbulb/customer_service_lifecycle.py:326`.

### `lightbulb.ServiceSlaTarget`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ServiceSlaTarget
~~~


Binding: `lightbulb.customer_service_lifecycle.ServiceSlaTarget` → `lightbulb.customer_service_lifecycle.ServiceSlaTarget`.

Source: `lightbulb/customer_service_lifecycle.py:315`.

### `lightbulb.ServiceTransitionFence`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ServiceTransitionFence
~~~


Binding: `lightbulb.customer_service_lifecycle.ServiceTransitionFence` → `lightbulb.customer_service_lifecycle.ServiceTransitionFence`.

Source: `lightbulb/customer_service_lifecycle.py:403`.

### `lightbulb.SubmitServiceResolutionInput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SubmitServiceResolutionInput
~~~


Binding: `lightbulb.customer_service_lifecycle.SubmitServiceResolutionInput` → `lightbulb.customer_service_lifecycle.SubmitServiceResolutionInput`.

Source: `lightbulb/customer_service_lifecycle.py:792`.

### `lightbulb.SubmitServiceResolutionPrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SubmitServiceResolutionPrimitive
~~~


Binding: `lightbulb.customer_service_lifecycle.SubmitServiceResolutionPrimitive` → `lightbulb.customer_service_lifecycle.SubmitServiceResolutionPrimitive`.

Source: `lightbulb/customer_service_lifecycle.py:1957`.

### `lightbulb.VerifyServiceResolutionInput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import VerifyServiceResolutionInput
~~~


Binding: `lightbulb.customer_service_lifecycle.VerifyServiceResolutionInput` → `lightbulb.customer_service_lifecycle.VerifyServiceResolutionInput`.

Source: `lightbulb/customer_service_lifecycle.py:825`.

### `lightbulb.VerifyServiceResolutionPrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import VerifyServiceResolutionPrimitive
~~~


Binding: `lightbulb.customer_service_lifecycle.VerifyServiceResolutionPrimitive` → `lightbulb.customer_service_lifecycle.VerifyServiceResolutionPrimitive`.

Source: `lightbulb/customer_service_lifecycle.py:2072`.

### `lightbulb.service_case_snapshot_digest`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import service_case_snapshot_digest
~~~


Binding: `lightbulb.customer_service_lifecycle.service_case_snapshot_digest` → `lightbulb.customer_service_lifecycle.service_case_snapshot_digest`.

Source: `lightbulb/customer_service_lifecycle.py:672`.

### `lightbulb.service_contact_policy_digest`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import service_contact_policy_digest
~~~


Binding: `lightbulb.customer_service_lifecycle.service_contact_policy_digest` → `lightbulb.customer_service_lifecycle.service_contact_policy_digest`.

Source: `lightbulb/customer_service_lifecycle.py:287`.

### `lightbulb.service_resolution_verification_digest`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import service_resolution_verification_digest
~~~


Binding: `lightbulb.customer_service_lifecycle.service_resolution_verification_digest` → `lightbulb.customer_service_lifecycle.service_resolution_verification_digest`.

Source: `lightbulb/customer_service_lifecycle.py:1491`.

### `lightbulb.service_sla_policy_digest`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import service_sla_policy_digest
~~~


Binding: `lightbulb.customer_service_lifecycle.service_sla_policy_digest` → `lightbulb.customer_service_lifecycle.service_sla_policy_digest`.

Source: `lightbulb/customer_service_lifecycle.py:366`.

### `lightbulb.service_transition_idempotency_digest`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import service_transition_idempotency_digest
~~~


Binding: `lightbulb.customer_service_lifecycle.service_transition_idempotency_digest` → `lightbulb.customer_service_lifecycle.service_transition_idempotency_digest`.

Source: `lightbulb/customer_service_lifecycle.py:684`.

### `lightbulb.PEOPLE_CONTROL_INPUT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PEOPLE_CONTROL_INPUT_SCHEMA
~~~


Binding: `lightbulb.people_controls.PEOPLE_CONTROL_INPUT_SCHEMA` → `lightbulb.people_controls.PEOPLE_CONTROL_INPUT_SCHEMA`.

Source: `lightbulb/people_controls.py:46`.

### `lightbulb.PEOPLE_CONTROL_OPERATION`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PEOPLE_CONTROL_OPERATION
~~~


Binding: `lightbulb.people_controls.PEOPLE_CONTROL_OPERATION` → `lightbulb.people_controls.PEOPLE_CONTROL_OPERATION`.

Source: `lightbulb/people_controls.py:671`.

### `lightbulb.PEOPLE_CONTROL_RESULT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PEOPLE_CONTROL_RESULT_SCHEMA
~~~


Binding: `lightbulb.people_controls.PEOPLE_CONTROL_RESULT_SCHEMA` → `lightbulb.people_controls.PEOPLE_CONTROL_RESULT_SCHEMA`.

Source: `lightbulb/people_controls.py:47`.

### `lightbulb.EvaluateWorkerLifecycleControlsPrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import EvaluateWorkerLifecycleControlsPrimitive
~~~


Binding: `lightbulb.people_controls.EvaluateWorkerLifecycleControlsPrimitive` → `lightbulb.people_controls.EvaluateWorkerLifecycleControlsPrimitive`.

Source: `lightbulb/people_controls.py:1493`.

### `lightbulb.PeopleControlInput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PeopleControlInput
~~~


Binding: `lightbulb.people_controls.PeopleControlInput` → `lightbulb.people_controls.PeopleControlInput`.

Source: `lightbulb/people_controls.py:523`.

### `lightbulb.PeopleControlPolicy`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PeopleControlPolicy
~~~


Binding: `lightbulb.people_controls.PeopleControlPolicy` → `lightbulb.people_controls.PeopleControlPolicy`.

Source: `lightbulb/people_controls.py:510`.

### `lightbulb.PeopleControlResult`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PeopleControlResult
~~~


Binding: `lightbulb.people_controls.PeopleControlResult` → `lightbulb.people_controls.PeopleControlResult`.

Source: `lightbulb/people_controls.py:682`.

### `lightbulb.PeopleEffectBoundary`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PeopleEffectBoundary
~~~


Binding: `lightbulb.people_controls.PeopleEffectBoundary` → `lightbulb.people_controls.PeopleEffectBoundary`.

Source: `lightbulb/people_controls.py:661`.

### `lightbulb.evaluate_people_controls`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import evaluate_people_controls
~~~


Binding: `lightbulb.people_controls.evaluate_people_controls` → `lightbulb.people_controls.evaluate_people_controls`.

Source: `lightbulb/people_controls.py:855`.

### `lightbulb.PEOPLE_ACCESS_REVOCATION_EVIDENCE_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PEOPLE_ACCESS_REVOCATION_EVIDENCE_SCHEMA
~~~


Binding: `lightbulb.people_operations_lifecycle.PEOPLE_ACCESS_REVOCATION_EVIDENCE_SCHEMA` → `lightbulb.people_operations_lifecycle.PEOPLE_ACCESS_REVOCATION_EVIDENCE_SCHEMA`.

Source: `lightbulb/people_operations_lifecycle.py:68`.

### `lightbulb.PEOPLE_APPROVAL_EVIDENCE_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PEOPLE_APPROVAL_EVIDENCE_SCHEMA
~~~


Binding: `lightbulb.people_operations_lifecycle.PEOPLE_APPROVAL_EVIDENCE_SCHEMA` → `lightbulb.people_operations_lifecycle.PEOPLE_APPROVAL_EVIDENCE_SCHEMA`.

Source: `lightbulb/people_operations_lifecycle.py:56`.

### `lightbulb.PEOPLE_OPERATIONS_LIFECYCLE_EXECUTABLE_PRIMITIVES`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PEOPLE_OPERATIONS_LIFECYCLE_EXECUTABLE_PRIMITIVES
~~~


Binding: `lightbulb.people_operations_lifecycle.PEOPLE_OPERATIONS_LIFECYCLE_EXECUTABLE_PRIMITIVES` → `lightbulb.people_operations_lifecycle.PEOPLE_OPERATIONS_LIFECYCLE_EXECUTABLE_PRIMITIVES`.

Source: `lightbulb/people_operations_lifecycle.py:2895`.

### `lightbulb.PEOPLE_OPERATIONS_SCOPE_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PEOPLE_OPERATIONS_SCOPE_SCHEMA
~~~


Binding: `lightbulb.people_operations_lifecycle.PEOPLE_OPERATIONS_SCOPE_SCHEMA` → `lightbulb.people_operations_lifecycle.PEOPLE_OPERATIONS_SCOPE_SCHEMA`.

Source: `lightbulb/people_operations_lifecycle.py:54`.

### `lightbulb.PEOPLE_OPERATIONS_SNAPSHOT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PEOPLE_OPERATIONS_SNAPSHOT_SCHEMA
~~~


Binding: `lightbulb.people_operations_lifecycle.PEOPLE_OPERATIONS_SNAPSHOT_SCHEMA` → `lightbulb.people_operations_lifecycle.PEOPLE_OPERATIONS_SNAPSHOT_SCHEMA`.

Source: `lightbulb/people_operations_lifecycle.py:59`.

### `lightbulb.PEOPLE_PAY_PERIOD_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PEOPLE_PAY_PERIOD_SCHEMA
~~~


Binding: `lightbulb.people_operations_lifecycle.PEOPLE_PAY_PERIOD_SCHEMA` → `lightbulb.people_operations_lifecycle.PEOPLE_PAY_PERIOD_SCHEMA`.

Source: `lightbulb/people_operations_lifecycle.py:55`.

### `lightbulb.PEOPLE_PAYROLL_CALCULATION_BASIS_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PEOPLE_PAYROLL_CALCULATION_BASIS_SCHEMA
~~~


Binding: `lightbulb.people_operations_lifecycle.PEOPLE_PAYROLL_CALCULATION_BASIS_SCHEMA` → `lightbulb.people_operations_lifecycle.PEOPLE_PAYROLL_CALCULATION_BASIS_SCHEMA`.

Source: `lightbulb/people_operations_lifecycle.py:65`.

### `lightbulb.PEOPLE_TRANSITION_CANDIDATE_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PEOPLE_TRANSITION_CANDIDATE_SCHEMA
~~~


Binding: `lightbulb.people_operations_lifecycle.PEOPLE_TRANSITION_CANDIDATE_SCHEMA` → `lightbulb.people_operations_lifecycle.PEOPLE_TRANSITION_CANDIDATE_SCHEMA`.

Source: `lightbulb/people_operations_lifecycle.py:58`.

### `lightbulb.PEOPLE_TRANSITION_EVIDENCE_COMMITMENT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PEOPLE_TRANSITION_EVIDENCE_COMMITMENT_SCHEMA
~~~


Binding: `lightbulb.people_operations_lifecycle.PEOPLE_TRANSITION_EVIDENCE_COMMITMENT_SCHEMA` → `lightbulb.people_operations_lifecycle.PEOPLE_TRANSITION_EVIDENCE_COMMITMENT_SCHEMA`.

Source: `lightbulb/people_operations_lifecycle.py:62`.

### `lightbulb.PEOPLE_TRANSITION_OPERATION`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PEOPLE_TRANSITION_OPERATION
~~~


Binding: `lightbulb.people_operations_lifecycle.PEOPLE_TRANSITION_OPERATION` → `lightbulb.people_operations_lifecycle.PEOPLE_TRANSITION_OPERATION`.

Source: `lightbulb/people_operations_lifecycle.py:2515`.

### `lightbulb.PEOPLE_TRANSITION_PROPOSAL_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PEOPLE_TRANSITION_PROPOSAL_SCHEMA
~~~


Binding: `lightbulb.people_operations_lifecycle.PEOPLE_TRANSITION_PROPOSAL_SCHEMA` → `lightbulb.people_operations_lifecycle.PEOPLE_TRANSITION_PROPOSAL_SCHEMA`.

Source: `lightbulb/people_operations_lifecycle.py:60`.

### `lightbulb.PEOPLE_TRANSITION_REQUEST_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PEOPLE_TRANSITION_REQUEST_SCHEMA
~~~


Binding: `lightbulb.people_operations_lifecycle.PEOPLE_TRANSITION_REQUEST_SCHEMA` → `lightbulb.people_operations_lifecycle.PEOPLE_TRANSITION_REQUEST_SCHEMA`.

Source: `lightbulb/people_operations_lifecycle.py:57`.

### `lightbulb.PEOPLE_TRANSITION_RESULT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PEOPLE_TRANSITION_RESULT_SCHEMA
~~~


Binding: `lightbulb.people_operations_lifecycle.PEOPLE_TRANSITION_RESULT_SCHEMA` → `lightbulb.people_operations_lifecycle.PEOPLE_TRANSITION_RESULT_SCHEMA`.

Source: `lightbulb/people_operations_lifecycle.py:61`.

### `lightbulb.SPRING_PEOPLE_EVIDENCE_ISSUER`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SPRING_PEOPLE_EVIDENCE_ISSUER
~~~


Binding: `lightbulb.people_operations_lifecycle.SPRING_PEOPLE_EVIDENCE_ISSUER` → `lightbulb.people_operations_lifecycle.SPRING_PEOPLE_EVIDENCE_ISSUER`.

Source: `lightbulb/people_operations_lifecycle.py:71`.

### `lightbulb.PEOPLE_OPERATIONS_GENESIS_DIGEST`

constant alias. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PEOPLE_OPERATIONS_GENESIS_DIGEST
~~~


Binding: `lightbulb.people_operations_lifecycle.ZERO_DIGEST` → `lightbulb.people_operations_lifecycle.ZERO_DIGEST`.

Source: `lightbulb/people_operations_lifecycle.py:72`.

### `lightbulb.AccessRevocationProjection`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import AccessRevocationProjection
~~~


Binding: `lightbulb.people_operations_lifecycle.AccessRevocationProjection` → `lightbulb.people_operations_lifecycle.AccessRevocationProjection`.

Source: `lightbulb/people_operations_lifecycle.py:931`.

### `lightbulb.ActivateWorkerCommand`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ActivateWorkerCommand
~~~


Binding: `lightbulb.people_operations_lifecycle.ActivateWorkerCommand` → `lightbulb.people_operations_lifecycle.ActivateWorkerCommand`.

Source: `lightbulb/people_operations_lifecycle.py:450`.

### `lightbulb.AdvanceCandidateCommand`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import AdvanceCandidateCommand
~~~


Binding: `lightbulb.people_operations_lifecycle.AdvanceCandidateCommand` → `lightbulb.people_operations_lifecycle.AdvanceCandidateCommand`.

Source: `lightbulb/people_operations_lifecycle.py:440`.

### `lightbulb.CertificationProjection`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CertificationProjection
~~~


Binding: `lightbulb.people_operations_lifecycle.CertificationProjection` → `lightbulb.people_operations_lifecycle.CertificationProjection`.

Source: `lightbulb/people_operations_lifecycle.py:917`.

### `lightbulb.CompleteOffboardingCommand`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CompleteOffboardingCommand
~~~


Binding: `lightbulb.people_operations_lifecycle.CompleteOffboardingCommand` → `lightbulb.people_operations_lifecycle.CompleteOffboardingCommand`.

Source: `lightbulb/people_operations_lifecycle.py:780`.

### `lightbulb.CreateCandidateCommand`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CreateCandidateCommand
~~~


Binding: `lightbulb.people_operations_lifecycle.CreateCandidateCommand` → `lightbulb.people_operations_lifecycle.CreateCandidateCommand`.

Source: `lightbulb/people_operations_lifecycle.py:428`.

### `lightbulb.InitiateOffboardingCommand`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import InitiateOffboardingCommand
~~~


Binding: `lightbulb.people_operations_lifecycle.InitiateOffboardingCommand` → `lightbulb.people_operations_lifecycle.InitiateOffboardingCommand`.

Source: `lightbulb/people_operations_lifecycle.py:722`.

### `lightbulb.PeopleApprovalEvidence`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PeopleApprovalEvidence
~~~


Binding: `lightbulb.people_operations_lifecycle.PeopleApprovalEvidence` → `lightbulb.people_operations_lifecycle.PeopleApprovalEvidence`.

Source: `lightbulb/people_operations_lifecycle.py:357`.

### `lightbulb.PeopleOperationsLifecycleError`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PeopleOperationsLifecycleError
~~~


Binding: `lightbulb.people_operations_lifecycle.PeopleOperationsLifecycleError` → `lightbulb.people_operations_lifecycle.PeopleOperationsLifecycleError`.

Source: `lightbulb/people_operations_lifecycle.py:1398`.

### `lightbulb.PeopleOperationsScope`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PeopleOperationsScope
~~~


Binding: `lightbulb.people_operations_lifecycle.PeopleOperationsScope` → `lightbulb.people_operations_lifecycle.PeopleOperationsScope`.

Source: `lightbulb/people_operations_lifecycle.py:286`.

### `lightbulb.PeopleOperationsSnapshot`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PeopleOperationsSnapshot
~~~


Binding: `lightbulb.people_operations_lifecycle.PeopleOperationsSnapshot` → `lightbulb.people_operations_lifecycle.PeopleOperationsSnapshot`.

Source: `lightbulb/people_operations_lifecycle.py:944`.

### `lightbulb.PeoplePayPeriod`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PeoplePayPeriod
~~~


Binding: `lightbulb.people_operations_lifecycle.PeoplePayPeriod` → `lightbulb.people_operations_lifecycle.PeoplePayPeriod`.

Source: `lightbulb/people_operations_lifecycle.py:332`.

### `lightbulb.PeopleTransitionCandidate`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PeopleTransitionCandidate
~~~


Binding: `lightbulb.people_operations_lifecycle.PeopleTransitionCandidate` → `lightbulb.people_operations_lifecycle.PeopleTransitionCandidate`.

Source: `lightbulb/people_operations_lifecycle.py:824`.

### `lightbulb.PeopleTransitionProposal`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PeopleTransitionProposal
~~~


Binding: `lightbulb.people_operations_lifecycle.PeopleTransitionProposal` → `lightbulb.people_operations_lifecycle.PeopleTransitionProposal`.

Source: `lightbulb/people_operations_lifecycle.py:1323`.

### `lightbulb.PeopleTransitionRequest`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PeopleTransitionRequest
~~~


Binding: `lightbulb.people_operations_lifecycle.PeopleTransitionRequest` → `lightbulb.people_operations_lifecycle.PeopleTransitionRequest`.

Source: `lightbulb/people_operations_lifecycle.py:1169`.

### `lightbulb.PeopleTransitionResult`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PeopleTransitionResult
~~~


Binding: `lightbulb.people_operations_lifecycle.PeopleTransitionResult` → `lightbulb.people_operations_lifecycle.PeopleTransitionResult`.

Source: `lightbulb/people_operations_lifecycle.py:1359`.

### `lightbulb.PreparePayrollHandoffCommand`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PreparePayrollHandoffCommand
~~~


Binding: `lightbulb.people_operations_lifecycle.PreparePayrollHandoffCommand` → `lightbulb.people_operations_lifecycle.PreparePayrollHandoffCommand`.

Source: `lightbulb/people_operations_lifecycle.py:664`.

### `lightbulb.ProposePeopleOperationsTransitionPrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProposePeopleOperationsTransitionPrimitive
~~~


Binding: `lightbulb.people_operations_lifecycle.ProposePeopleOperationsTransitionPrimitive` → `lightbulb.people_operations_lifecycle.ProposePeopleOperationsTransitionPrimitive`.

Source: `lightbulb/people_operations_lifecycle.py:2716`.

### `lightbulb.RecordApprovedLeaveCommand`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import RecordApprovedLeaveCommand
~~~


Binding: `lightbulb.people_operations_lifecycle.RecordApprovedLeaveCommand` → `lightbulb.people_operations_lifecycle.RecordApprovedLeaveCommand`.

Source: `lightbulb/people_operations_lifecycle.py:553`.

### `lightbulb.RecordApprovedTimecardCommand`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import RecordApprovedTimecardCommand
~~~


Binding: `lightbulb.people_operations_lifecycle.RecordApprovedTimecardCommand` → `lightbulb.people_operations_lifecycle.RecordApprovedTimecardCommand`.

Source: `lightbulb/people_operations_lifecycle.py:520`.

### `lightbulb.RecordCertificationCommand`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import RecordCertificationCommand
~~~


Binding: `lightbulb.people_operations_lifecycle.RecordCertificationCommand` → `lightbulb.people_operations_lifecycle.RecordCertificationCommand`.

Source: `lightbulb/people_operations_lifecycle.py:638`.

### `lightbulb.RecordPerformanceCompensationCommand`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import RecordPerformanceCompensationCommand
~~~


Binding: `lightbulb.people_operations_lifecycle.RecordPerformanceCompensationCommand` → `lightbulb.people_operations_lifecycle.RecordPerformanceCompensationCommand`.

Source: `lightbulb/people_operations_lifecycle.py:597`.

### `lightbulb.ScheduleShiftCommand`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ScheduleShiftCommand
~~~


Binding: `lightbulb.people_operations_lifecycle.ScheduleShiftCommand` → `lightbulb.people_operations_lifecycle.ScheduleShiftCommand`.

Source: `lightbulb/people_operations_lifecycle.py:478`.

### `lightbulb.VerifyAccessRevocationCommand`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import VerifyAccessRevocationCommand
~~~


Binding: `lightbulb.people_operations_lifecycle.VerifyAccessRevocationCommand` → `lightbulb.people_operations_lifecycle.VerifyAccessRevocationCommand`.

Source: `lightbulb/people_operations_lifecycle.py:761`.

### `lightbulb.people_access_revocation_evidence_digest`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import people_access_revocation_evidence_digest
~~~


Binding: `lightbulb.people_operations_lifecycle.people_access_revocation_evidence_digest` → `lightbulb.people_operations_lifecycle.people_access_revocation_evidence_digest`.

Source: `lightbulb/people_operations_lifecycle.py:1305`.

### `lightbulb.people_approval_digest`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import people_approval_digest
~~~


Binding: `lightbulb.people_operations_lifecycle.people_approval_digest` → `lightbulb.people_operations_lifecycle.people_approval_digest`.

Source: `lightbulb/people_operations_lifecycle.py:409`.

### `lightbulb.people_command_digest`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import people_command_digest
~~~


Binding: `lightbulb.people_operations_lifecycle.people_command_digest` → `lightbulb.people_operations_lifecycle.people_command_digest`.

Source: `lightbulb/people_operations_lifecycle.py:817`.

### `lightbulb.people_idempotency_digest`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import people_idempotency_digest
~~~


Binding: `lightbulb.people_operations_lifecycle.people_idempotency_digest` → `lightbulb.people_operations_lifecycle.people_idempotency_digest`.

Source: `lightbulb/people_operations_lifecycle.py:1220`.

### `lightbulb.people_payroll_calculation_basis_digest`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import people_payroll_calculation_basis_digest
~~~


Binding: `lightbulb.people_operations_lifecycle.people_payroll_calculation_basis_digest` → `lightbulb.people_operations_lifecycle.people_payroll_calculation_basis_digest`.

Source: `lightbulb/people_operations_lifecycle.py:1153`.

### `lightbulb.people_scope_digest`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import people_scope_digest
~~~


Binding: `lightbulb.people_operations_lifecycle.people_scope_digest` → `lightbulb.people_operations_lifecycle.people_scope_digest`.

Source: `lightbulb/people_operations_lifecycle.py:327`.

### `lightbulb.people_snapshot_digest`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import people_snapshot_digest
~~~


Binding: `lightbulb.people_operations_lifecycle.people_snapshot_digest` → `lightbulb.people_operations_lifecycle.people_snapshot_digest`.

Source: `lightbulb/people_operations_lifecycle.py:1079`.

### `lightbulb.people_transition_candidate_digest`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import people_transition_candidate_digest
~~~


Binding: `lightbulb.people_operations_lifecycle.people_transition_candidate_digest` → `lightbulb.people_operations_lifecycle.people_transition_candidate_digest`.

Source: `lightbulb/people_operations_lifecycle.py:905`.

### `lightbulb.people_transition_evidence_digest`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import people_transition_evidence_digest
~~~


Binding: `lightbulb.people_operations_lifecycle.people_transition_evidence_digest` → `lightbulb.people_operations_lifecycle.people_transition_evidence_digest`.

Source: `lightbulb/people_operations_lifecycle.py:1235`.

### `lightbulb.propose_people_operations_transition`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import propose_people_operations_transition
~~~


Binding: `lightbulb.people_operations_lifecycle.propose_people_operations_transition` → `lightbulb.people_operations_lifecycle.propose_people_operations_transition`.

Source: `lightbulb/people_operations_lifecycle.py:2366`.

### `lightbulb.PRODUCT_GOVERNANCE_CONTROL_OPERATION`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PRODUCT_GOVERNANCE_CONTROL_OPERATION
~~~


Binding: `lightbulb.product_governance.PRODUCT_GOVERNANCE_CONTROL_OPERATION` → `lightbulb.product_governance.PRODUCT_GOVERNANCE_CONTROL_OPERATION`.

Source: `lightbulb/product_governance.py:1294`.

### `lightbulb.RELEASE_GOVERNANCE_INPUT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import RELEASE_GOVERNANCE_INPUT_SCHEMA
~~~


Binding: `lightbulb.product_governance.RELEASE_GOVERNANCE_INPUT_SCHEMA` → `lightbulb.product_governance.RELEASE_GOVERNANCE_INPUT_SCHEMA`.

Source: `lightbulb/product_governance.py:65`.

### `lightbulb.RELEASE_GOVERNANCE_RESULT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import RELEASE_GOVERNANCE_RESULT_SCHEMA
~~~


Binding: `lightbulb.product_governance.RELEASE_GOVERNANCE_RESULT_SCHEMA` → `lightbulb.product_governance.RELEASE_GOVERNANCE_RESULT_SCHEMA`.

Source: `lightbulb/product_governance.py:66`.

### `lightbulb.EvaluateReleaseGovernanceControlsPrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import EvaluateReleaseGovernanceControlsPrimitive
~~~


Binding: `lightbulb.product_governance.EvaluateReleaseGovernanceControlsPrimitive` → `lightbulb.product_governance.EvaluateReleaseGovernanceControlsPrimitive`.

Source: `lightbulb/product_governance.py:3009`.

### `lightbulb.ProductGovernanceEffectBoundary`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProductGovernanceEffectBoundary
~~~


Binding: `lightbulb.product_governance.ProductGovernanceEffectBoundary` → `lightbulb.product_governance.ProductGovernanceEffectBoundary`.

Source: `lightbulb/product_governance.py:1277`.

### `lightbulb.ReleaseGovernanceInput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ReleaseGovernanceInput
~~~


Binding: `lightbulb.product_governance.ReleaseGovernanceInput` → `lightbulb.product_governance.ReleaseGovernanceInput`.

Source: `lightbulb/product_governance.py:977`.

### `lightbulb.ReleaseGovernancePolicy`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ReleaseGovernancePolicy
~~~


Binding: `lightbulb.product_governance.ReleaseGovernancePolicy` → `lightbulb.product_governance.ReleaseGovernancePolicy`.

Source: `lightbulb/product_governance.py:922`.

### `lightbulb.ReleaseGovernanceResult`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ReleaseGovernanceResult
~~~


Binding: `lightbulb.product_governance.ReleaseGovernanceResult` → `lightbulb.product_governance.ReleaseGovernanceResult`.

Source: `lightbulb/product_governance.py:1305`.

### `lightbulb.evaluate_release_governance_controls`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import evaluate_release_governance_controls
~~~


Binding: `lightbulb.product_governance.evaluate_release_governance_controls` → `lightbulb.product_governance.evaluate_release_governance_controls`.

Source: `lightbulb/product_governance.py:1502`.

### `lightbulb.PRODUCT_ENGINEERING_GENESIS_SNAPSHOT_DIGEST`

constant alias. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PRODUCT_ENGINEERING_GENESIS_SNAPSHOT_DIGEST
~~~


Binding: `lightbulb.product_engineering_lifecycle.GENESIS_SNAPSHOT_DIGEST` → `lightbulb.product_engineering_lifecycle.GENESIS_SNAPSHOT_DIGEST`.

Source: `lightbulb/product_engineering_lifecycle.py:77`.

### `lightbulb.MAX_PRODUCT_ENGINEERING_TRANSITIONS`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import MAX_PRODUCT_ENGINEERING_TRANSITIONS
~~~


Binding: `lightbulb.product_engineering_lifecycle.MAX_PRODUCT_ENGINEERING_TRANSITIONS` → `lightbulb.product_engineering_lifecycle.MAX_PRODUCT_ENGINEERING_TRANSITIONS`.

Source: `lightbulb/product_engineering_lifecycle.py:78`.

### `lightbulb.PRODUCT_ENGINEERING_LIFECYCLE_EXECUTABLE_PRIMITIVES`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PRODUCT_ENGINEERING_LIFECYCLE_EXECUTABLE_PRIMITIVES
~~~


Binding: `lightbulb.product_engineering_lifecycle.PRODUCT_ENGINEERING_LIFECYCLE_EXECUTABLE_PRIMITIVES` → `lightbulb.product_engineering_lifecycle.PRODUCT_ENGINEERING_LIFECYCLE_EXECUTABLE_PRIMITIVES`.

Source: `lightbulb/product_engineering_lifecycle.py:3034`.

### `lightbulb.PRODUCT_ENGINEERING_TRANSITION_OPERATION`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PRODUCT_ENGINEERING_TRANSITION_OPERATION
~~~


Binding: `lightbulb.product_engineering_lifecycle.PRODUCT_ENGINEERING_TRANSITION_OPERATION` → `lightbulb.product_engineering_lifecycle.PRODUCT_ENGINEERING_TRANSITION_OPERATION`.

Source: `lightbulb/product_engineering_lifecycle.py:2324`.

### `lightbulb.BaselineEngineeringCommand`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import BaselineEngineeringCommand
~~~


Binding: `lightbulb.product_engineering_lifecycle.BaselineEngineeringCommand` → `lightbulb.product_engineering_lifecycle.BaselineEngineeringCommand`.

Source: `lightbulb/product_engineering_lifecycle.py:1171`.

### `lightbulb.BaselineRequirementsCommand`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import BaselineRequirementsCommand
~~~


Binding: `lightbulb.product_engineering_lifecycle.BaselineRequirementsCommand` → `lightbulb.product_engineering_lifecycle.BaselineRequirementsCommand`.

Source: `lightbulb/product_engineering_lifecycle.py:1144`.

### `lightbulb.BomComponentRecord`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import BomComponentRecord
~~~


Binding: `lightbulb.product_engineering_lifecycle.BomComponentRecord` → `lightbulb.product_engineering_lifecycle.BomComponentRecord`.

Source: `lightbulb/product_engineering_lifecycle.py:522`.

### `lightbulb.CertifiedLifecycleActor`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CertifiedLifecycleActor
~~~


Binding: `lightbulb.product_engineering_lifecycle.CertifiedLifecycleActor` → `lightbulb.product_engineering_lifecycle.CertifiedLifecycleActor`.

Source: `lightbulb/product_engineering_lifecycle.py:345`.

### `lightbulb.DesignActionRecord`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import DesignActionRecord
~~~


Binding: `lightbulb.product_engineering_lifecycle.DesignActionRecord` → `lightbulb.product_engineering_lifecycle.DesignActionRecord`.

Source: `lightbulb/product_engineering_lifecycle.py:593`.

### `lightbulb.DesignReviewCandidate`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import DesignReviewCandidate
~~~


Binding: `lightbulb.product_engineering_lifecycle.DesignReviewCandidate` → `lightbulb.product_engineering_lifecycle.DesignReviewCandidate`.

Source: `lightbulb/product_engineering_lifecycle.py:606`.

### `lightbulb.EngineeringBaselineCandidate`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import EngineeringBaselineCandidate
~~~


Binding: `lightbulb.product_engineering_lifecycle.EngineeringBaselineCandidate` → `lightbulb.product_engineering_lifecycle.EngineeringBaselineCandidate`.

Source: `lightbulb/product_engineering_lifecycle.py:542`.

### `lightbulb.EngineeringChangeCandidate`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import EngineeringChangeCandidate
~~~


Binding: `lightbulb.product_engineering_lifecycle.EngineeringChangeCandidate` → `lightbulb.product_engineering_lifecycle.EngineeringChangeCandidate`.

Source: `lightbulb/product_engineering_lifecycle.py:665`.

### `lightbulb.IssueDispositionCandidate`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import IssueDispositionCandidate
~~~


Binding: `lightbulb.product_engineering_lifecycle.IssueDispositionCandidate` → `lightbulb.product_engineering_lifecycle.IssueDispositionCandidate`.

Source: `lightbulb/product_engineering_lifecycle.py:953`.

### `lightbulb.ObserveProductTelemetryCommand`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ObserveProductTelemetryCommand
~~~


Binding: `lightbulb.product_engineering_lifecycle.ObserveProductTelemetryCommand` → `lightbulb.product_engineering_lifecycle.ObserveProductTelemetryCommand`.

Source: `lightbulb/product_engineering_lifecycle.py:1253`.

### `lightbulb.ProductEngineeringLifecycleInput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProductEngineeringLifecycleInput
~~~


Binding: `lightbulb.product_engineering_lifecycle.ProductEngineeringLifecycleInput` → `lightbulb.product_engineering_lifecycle.ProductEngineeringLifecycleInput`.

Source: `lightbulb/product_engineering_lifecycle.py:2214`.

### `lightbulb.ProductEngineeringLifecycleResult`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProductEngineeringLifecycleResult
~~~


Binding: `lightbulb.product_engineering_lifecycle.ProductEngineeringLifecycleResult` → `lightbulb.product_engineering_lifecycle.ProductEngineeringLifecycleResult`.

Source: `lightbulb/product_engineering_lifecycle.py:2288`.

### `lightbulb.ProductEngineeringLifecycleScope`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProductEngineeringLifecycleScope
~~~


Binding: `lightbulb.product_engineering_lifecycle.ProductEngineeringLifecycleScope` → `lightbulb.product_engineering_lifecycle.ProductEngineeringLifecycleScope`.

Source: `lightbulb/product_engineering_lifecycle.py:263`.

### `lightbulb.ProductEngineeringLifecycleSnapshot`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProductEngineeringLifecycleSnapshot
~~~


Binding: `lightbulb.product_engineering_lifecycle.ProductEngineeringLifecycleSnapshot` → `lightbulb.product_engineering_lifecycle.ProductEngineeringLifecycleSnapshot`.

Source: `lightbulb/product_engineering_lifecycle.py:2057`.

### `lightbulb.ProductEngineeringTransitionReceipt`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProductEngineeringTransitionReceipt
~~~


Binding: `lightbulb.product_engineering_lifecycle.ProductEngineeringTransitionReceipt` → `lightbulb.product_engineering_lifecycle.ProductEngineeringTransitionReceipt`.

Source: `lightbulb/product_engineering_lifecycle.py:2245`.

### `lightbulb.ProductIssueRecord`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProductIssueRecord
~~~


Binding: `lightbulb.product_engineering_lifecycle.ProductIssueRecord` → `lightbulb.product_engineering_lifecycle.ProductIssueRecord`.

Source: `lightbulb/product_engineering_lifecycle.py:908`.

### `lightbulb.ProductTelemetryCandidate`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProductTelemetryCandidate
~~~


Binding: `lightbulb.product_engineering_lifecycle.ProductTelemetryCandidate` → `lightbulb.product_engineering_lifecycle.ProductTelemetryCandidate`.

Source: `lightbulb/product_engineering_lifecycle.py:865`.

### `lightbulb.ProposeIssueDispositionCommand`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProposeIssueDispositionCommand
~~~


Binding: `lightbulb.product_engineering_lifecycle.ProposeIssueDispositionCommand` → `lightbulb.product_engineering_lifecycle.ProposeIssueDispositionCommand`.

Source: `lightbulb/product_engineering_lifecycle.py:1268`.

### `lightbulb.ProposeProductEngineeringTransitionPrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProposeProductEngineeringTransitionPrimitive
~~~


Binding: `lightbulb.product_engineering_lifecycle.ProposeProductEngineeringTransitionPrimitive` → `lightbulb.product_engineering_lifecycle.ProposeProductEngineeringTransitionPrimitive`.

Source: `lightbulb/product_engineering_lifecycle.py:2838`.

### `lightbulb.ReleaseArtifactRecord`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ReleaseArtifactRecord
~~~


Binding: `lightbulb.product_engineering_lifecycle.ReleaseArtifactRecord` → `lightbulb.product_engineering_lifecycle.ReleaseArtifactRecord`.

Source: `lightbulb/product_engineering_lifecycle.py:779`.

### `lightbulb.ReleaseCandidateRecord`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ReleaseCandidateRecord
~~~


Binding: `lightbulb.product_engineering_lifecycle.ReleaseCandidateRecord` → `lightbulb.product_engineering_lifecycle.ReleaseCandidateRecord`.

Source: `lightbulb/product_engineering_lifecycle.py:792`.

### `lightbulb.ReleaseTargetCandidate`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ReleaseTargetCandidate
~~~


Binding: `lightbulb.product_engineering_lifecycle.ReleaseTargetCandidate` → `lightbulb.product_engineering_lifecycle.ReleaseTargetCandidate`.

Source: `lightbulb/product_engineering_lifecycle.py:447`.

### `lightbulb.RequirementRecord`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import RequirementRecord
~~~


Binding: `lightbulb.product_engineering_lifecycle.RequirementRecord` → `lightbulb.product_engineering_lifecycle.RequirementRecord`.

Source: `lightbulb/product_engineering_lifecycle.py:404`.

### `lightbulb.RequirementsBaselineCandidate`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import RequirementsBaselineCandidate
~~~


Binding: `lightbulb.product_engineering_lifecycle.RequirementsBaselineCandidate` → `lightbulb.product_engineering_lifecycle.RequirementsBaselineCandidate`.

Source: `lightbulb/product_engineering_lifecycle.py:425`.

### `lightbulb.ReviewDesignCommand`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ReviewDesignCommand
~~~


Binding: `lightbulb.product_engineering_lifecycle.ReviewDesignCommand` → `lightbulb.product_engineering_lifecycle.ReviewDesignCommand`.

Source: `lightbulb/product_engineering_lifecycle.py:1186`.

### `lightbulb.SpecificationRecord`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SpecificationRecord
~~~


Binding: `lightbulb.product_engineering_lifecycle.SpecificationRecord` → `lightbulb.product_engineering_lifecycle.SpecificationRecord`.

Source: `lightbulb/product_engineering_lifecycle.py:480`.

### `lightbulb.TargetReleaseCommand`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import TargetReleaseCommand
~~~


Binding: `lightbulb.product_engineering_lifecycle.TargetReleaseCommand` → `lightbulb.product_engineering_lifecycle.TargetReleaseCommand`.

Source: `lightbulb/product_engineering_lifecycle.py:1159`.

### `lightbulb.TelemetrySignalRecord`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import TelemetrySignalRecord
~~~


Binding: `lightbulb.product_engineering_lifecycle.TelemetrySignalRecord` → `lightbulb.product_engineering_lifecycle.TelemetrySignalRecord`.

Source: `lightbulb/product_engineering_lifecycle.py:846`.

### `lightbulb.TestRecord`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import TestRecord
~~~


Binding: `lightbulb.product_engineering_lifecycle.TestRecord` → `lightbulb.product_engineering_lifecycle.TestRecord`.

Source: `lightbulb/product_engineering_lifecycle.py:721`.

### `lightbulb.ValidateEngineeringChangeCommand`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ValidateEngineeringChangeCommand
~~~


Binding: `lightbulb.product_engineering_lifecycle.ValidateEngineeringChangeCommand` → `lightbulb.product_engineering_lifecycle.ValidateEngineeringChangeCommand`.

Source: `lightbulb/product_engineering_lifecycle.py:1201`.

### `lightbulb.ValidateReleaseCandidateCommand`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ValidateReleaseCandidateCommand
~~~


Binding: `lightbulb.product_engineering_lifecycle.ValidateReleaseCandidateCommand` → `lightbulb.product_engineering_lifecycle.ValidateReleaseCandidateCommand`.

Source: `lightbulb/product_engineering_lifecycle.py:1238`.

### `lightbulb.ValidateVerificationCommand`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ValidateVerificationCommand
~~~


Binding: `lightbulb.product_engineering_lifecycle.ValidateVerificationCommand` → `lightbulb.product_engineering_lifecycle.ValidateVerificationCommand`.

Source: `lightbulb/product_engineering_lifecycle.py:1223`.

### `lightbulb.VerificationValidationCandidate`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import VerificationValidationCandidate
~~~


Binding: `lightbulb.product_engineering_lifecycle.VerificationValidationCandidate` → `lightbulb.product_engineering_lifecycle.VerificationValidationCandidate`.

Source: `lightbulb/product_engineering_lifecycle.py:761`.

### `lightbulb.materialize_product_engineering_candidate`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import materialize_product_engineering_candidate
~~~


Binding: `lightbulb.product_engineering_lifecycle.materialize_product_engineering_candidate` → `lightbulb.product_engineering_lifecycle.materialize_product_engineering_candidate`.

Source: `lightbulb/product_engineering_lifecycle.py:2570`.

### `lightbulb.product_engineering_scope_digest`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import product_engineering_scope_digest
~~~


Binding: `lightbulb.product_engineering_lifecycle.product_engineering_scope_digest` → `lightbulb.product_engineering_lifecycle.product_engineering_scope_digest`.

Source: `lightbulb/product_engineering_lifecycle.py:305`.

### `lightbulb.product_engineering_snapshot_digest`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import product_engineering_snapshot_digest
~~~


Binding: `lightbulb.product_engineering_lifecycle.product_engineering_snapshot_digest` → `lightbulb.product_engineering_lifecycle.product_engineering_snapshot_digest`.

Source: `lightbulb/product_engineering_lifecycle.py:2197`.

### `lightbulb.seal_product_engineering_command`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import seal_product_engineering_command
~~~


Binding: `lightbulb.product_engineering_lifecycle.seal_product_engineering_command` → `lightbulb.product_engineering_lifecycle.seal_product_engineering_command`.

Source: `lightbulb/product_engineering_lifecycle.py:1299`.

### `lightbulb.REGULATED_CONTROLS_INPUT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import REGULATED_CONTROLS_INPUT_SCHEMA
~~~


Binding: `lightbulb.compliance_controls.REGULATED_CONTROLS_INPUT_SCHEMA` → `lightbulb.compliance_controls.REGULATED_CONTROLS_INPUT_SCHEMA`.

Source: `lightbulb/compliance_controls.py:46`.

### `lightbulb.REGULATED_CONTROLS_OPERATION`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import REGULATED_CONTROLS_OPERATION
~~~


Binding: `lightbulb.compliance_controls.REGULATED_CONTROLS_OPERATION` → `lightbulb.compliance_controls.REGULATED_CONTROLS_OPERATION`.

Source: `lightbulb/compliance_controls.py:621`.

### `lightbulb.REGULATED_CONTROLS_RESULT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import REGULATED_CONTROLS_RESULT_SCHEMA
~~~


Binding: `lightbulb.compliance_controls.REGULATED_CONTROLS_RESULT_SCHEMA` → `lightbulb.compliance_controls.REGULATED_CONTROLS_RESULT_SCHEMA`.

Source: `lightbulb/compliance_controls.py:47`.

### `lightbulb.ComplianceEffectBoundary`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ComplianceEffectBoundary
~~~


Binding: `lightbulb.compliance_controls.ComplianceEffectBoundary` → `lightbulb.compliance_controls.ComplianceEffectBoundary`.

Source: `lightbulb/compliance_controls.py:609`.

### `lightbulb.EvaluateRegulatedControlsPrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import EvaluateRegulatedControlsPrimitive
~~~


Binding: `lightbulb.compliance_controls.EvaluateRegulatedControlsPrimitive` → `lightbulb.compliance_controls.EvaluateRegulatedControlsPrimitive`.

Source: `lightbulb/compliance_controls.py:1489`.

### `lightbulb.RegulatedControlPolicy`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import RegulatedControlPolicy
~~~


Binding: `lightbulb.compliance_controls.RegulatedControlPolicy` → `lightbulb.compliance_controls.RegulatedControlPolicy`.

Source: `lightbulb/compliance_controls.py:189`.

### `lightbulb.RegulatedControlsInput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import RegulatedControlsInput
~~~


Binding: `lightbulb.compliance_controls.RegulatedControlsInput` → `lightbulb.compliance_controls.RegulatedControlsInput`.

Source: `lightbulb/compliance_controls.py:469`.

### `lightbulb.RegulatedControlsResult`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import RegulatedControlsResult
~~~


Binding: `lightbulb.compliance_controls.RegulatedControlsResult` → `lightbulb.compliance_controls.RegulatedControlsResult`.

Source: `lightbulb/compliance_controls.py:632`.

### `lightbulb.evaluate_regulated_controls`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import evaluate_regulated_controls
~~~


Binding: `lightbulb.compliance_controls.evaluate_regulated_controls` → `lightbulb.compliance_controls.evaluate_regulated_controls`.

Source: `lightbulb/compliance_controls.py:838`.

### `lightbulb.COMPLIANCE_RISK_COMMAND_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import COMPLIANCE_RISK_COMMAND_SCHEMA
~~~


Binding: `lightbulb.compliance_risk_lifecycle.COMPLIANCE_RISK_COMMAND_SCHEMA` → `lightbulb.compliance_risk_lifecycle.COMPLIANCE_RISK_COMMAND_SCHEMA`.

Source: `lightbulb/compliance_risk_lifecycle.py:65`.

### `lightbulb.COMPLIANCE_RISK_INPUT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import COMPLIANCE_RISK_INPUT_SCHEMA
~~~


Binding: `lightbulb.compliance_risk_lifecycle.COMPLIANCE_RISK_INPUT_SCHEMA` → `lightbulb.compliance_risk_lifecycle.COMPLIANCE_RISK_INPUT_SCHEMA`.

Source: `lightbulb/compliance_risk_lifecycle.py:66`.

### `lightbulb.COMPLIANCE_RISK_LIFECYCLE_EXECUTABLE_PRIMITIVES`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import COMPLIANCE_RISK_LIFECYCLE_EXECUTABLE_PRIMITIVES
~~~


Binding: `lightbulb.compliance_risk_lifecycle.COMPLIANCE_RISK_LIFECYCLE_EXECUTABLE_PRIMITIVES` → `lightbulb.compliance_risk_lifecycle.COMPLIANCE_RISK_LIFECYCLE_EXECUTABLE_PRIMITIVES`.

Source: `lightbulb/compliance_risk_lifecycle.py:2299`.

### `lightbulb.COMPLIANCE_RISK_RECEIPT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import COMPLIANCE_RISK_RECEIPT_SCHEMA
~~~


Binding: `lightbulb.compliance_risk_lifecycle.COMPLIANCE_RISK_RECEIPT_SCHEMA` → `lightbulb.compliance_risk_lifecycle.COMPLIANCE_RISK_RECEIPT_SCHEMA`.

Source: `lightbulb/compliance_risk_lifecycle.py:67`.

### `lightbulb.COMPLIANCE_RISK_RESULT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import COMPLIANCE_RISK_RESULT_SCHEMA
~~~


Binding: `lightbulb.compliance_risk_lifecycle.COMPLIANCE_RISK_RESULT_SCHEMA` → `lightbulb.compliance_risk_lifecycle.COMPLIANCE_RISK_RESULT_SCHEMA`.

Source: `lightbulb/compliance_risk_lifecycle.py:68`.

### `lightbulb.COMPLIANCE_RISK_SCOPE_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import COMPLIANCE_RISK_SCOPE_SCHEMA
~~~


Binding: `lightbulb.compliance_risk_lifecycle.COMPLIANCE_RISK_SCOPE_SCHEMA` → `lightbulb.compliance_risk_lifecycle.COMPLIANCE_RISK_SCOPE_SCHEMA`.

Source: `lightbulb/compliance_risk_lifecycle.py:63`.

### `lightbulb.COMPLIANCE_RISK_SNAPSHOT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import COMPLIANCE_RISK_SNAPSHOT_SCHEMA
~~~


Binding: `lightbulb.compliance_risk_lifecycle.COMPLIANCE_RISK_SNAPSHOT_SCHEMA` → `lightbulb.compliance_risk_lifecycle.COMPLIANCE_RISK_SNAPSHOT_SCHEMA`.

Source: `lightbulb/compliance_risk_lifecycle.py:64`.

### `lightbulb.COMPLIANCE_RISK_TRANSITION_OPERATION`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import COMPLIANCE_RISK_TRANSITION_OPERATION
~~~


Binding: `lightbulb.compliance_risk_lifecycle.COMPLIANCE_RISK_TRANSITION_OPERATION` → `lightbulb.compliance_risk_lifecycle.COMPLIANCE_RISK_TRANSITION_OPERATION`.

Source: `lightbulb/compliance_risk_lifecycle.py:1974`.

### `lightbulb.COMPLIANCE_RISK_GENESIS_STATE_DIGEST`

constant alias. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import COMPLIANCE_RISK_GENESIS_STATE_DIGEST
~~~


Binding: `lightbulb.compliance_risk_lifecycle.GENESIS_STATE_DIGEST` → `lightbulb.compliance_risk_lifecycle.GENESIS_STATE_DIGEST`.

Source: `lightbulb/compliance_risk_lifecycle.py:70`.

### `lightbulb.MAX_COMPLIANCE_RISK_TRANSITIONS`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import MAX_COMPLIANCE_RISK_TRANSITIONS
~~~


Binding: `lightbulb.compliance_risk_lifecycle.MAX_COMPLIANCE_RISK_TRANSITIONS` → `lightbulb.compliance_risk_lifecycle.MAX_COMPLIANCE_RISK_TRANSITIONS`.

Source: `lightbulb/compliance_risk_lifecycle.py:71`.

### `lightbulb.ComplianceRiskCaseKind`

value. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ComplianceRiskCaseKind
~~~


Binding: `lightbulb.compliance_risk_lifecycle.ComplianceRiskCaseKind` → `lightbulb.compliance_risk_lifecycle.ComplianceRiskCaseKind`.

Source: `lightbulb/compliance_risk_lifecycle.py:123`.

### `lightbulb.ComplianceRiskEffectBoundary`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ComplianceRiskEffectBoundary
~~~


Binding: `lightbulb.compliance_risk_lifecycle.ComplianceRiskEffectBoundary` → `lightbulb.compliance_risk_lifecycle.ComplianceRiskEffectBoundary`.

Source: `lightbulb/compliance_risk_lifecycle.py:1533`.

### `lightbulb.ComplianceRiskLifecycleInput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ComplianceRiskLifecycleInput
~~~


Binding: `lightbulb.compliance_risk_lifecycle.ComplianceRiskLifecycleInput` → `lightbulb.compliance_risk_lifecycle.ComplianceRiskLifecycleInput`.

Source: `lightbulb/compliance_risk_lifecycle.py:1492`.

### `lightbulb.ComplianceRiskLifecycleResult`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ComplianceRiskLifecycleResult
~~~


Binding: `lightbulb.compliance_risk_lifecycle.ComplianceRiskLifecycleResult` → `lightbulb.compliance_risk_lifecycle.ComplianceRiskLifecycleResult`.

Source: `lightbulb/compliance_risk_lifecycle.py:1606`.

### `lightbulb.ComplianceRiskLifecycleSnapshot`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ComplianceRiskLifecycleSnapshot
~~~


Binding: `lightbulb.compliance_risk_lifecycle.ComplianceRiskLifecycleSnapshot` → `lightbulb.compliance_risk_lifecycle.ComplianceRiskLifecycleSnapshot`.

Source: `lightbulb/compliance_risk_lifecycle.py:1383`.

### `lightbulb.ComplianceRiskScope`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ComplianceRiskScope
~~~


Binding: `lightbulb.compliance_risk_lifecycle.ComplianceRiskScope` → `lightbulb.compliance_risk_lifecycle.ComplianceRiskScope`.

Source: `lightbulb/compliance_risk_lifecycle.py:318`.

### `lightbulb.ComplianceRiskTransitionCandidate`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ComplianceRiskTransitionCandidate
~~~


Binding: `lightbulb.compliance_risk_lifecycle.ComplianceRiskTransitionCandidate` → `lightbulb.compliance_risk_lifecycle.ComplianceRiskTransitionCandidate`.

Source: `lightbulb/compliance_risk_lifecycle.py:1285`.

### `lightbulb.ComplianceRiskTransitionCommand`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ComplianceRiskTransitionCommand
~~~


Binding: `lightbulb.compliance_risk_lifecycle.ComplianceRiskTransitionCommand` → `lightbulb.compliance_risk_lifecycle.ComplianceRiskTransitionCommand`.

Source: `lightbulb/compliance_risk_lifecycle.py:867`.

### `lightbulb.ProposeComplianceRiskTransitionPrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProposeComplianceRiskTransitionPrimitive
~~~


Binding: `lightbulb.compliance_risk_lifecycle.ProposeComplianceRiskTransitionPrimitive` → `lightbulb.compliance_risk_lifecycle.ProposeComplianceRiskTransitionPrimitive`.

Source: `lightbulb/compliance_risk_lifecycle.py:2103`.

### `lightbulb.RegulatedDomain`

value. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import RegulatedDomain
~~~


Binding: `lightbulb.compliance_risk_lifecycle.RegulatedDomain` → `lightbulb.compliance_risk_lifecycle.RegulatedDomain`.

Source: `lightbulb/compliance_risk_lifecycle.py:132`.

### `lightbulb.RegulatedEvidenceEnvelope`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import RegulatedEvidenceEnvelope
~~~


Binding: `lightbulb.compliance_risk_lifecycle.RegulatedEvidenceEnvelope` → `lightbulb.compliance_risk_lifecycle.RegulatedEvidenceEnvelope`.

Source: `lightbulb/compliance_risk_lifecycle.py:392`.

### `lightbulb.compliance_risk_command_content_digest`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import compliance_risk_command_content_digest
~~~


Binding: `lightbulb.compliance_risk_lifecycle.compliance_risk_command_content_digest` → `lightbulb.compliance_risk_lifecycle.compliance_risk_command_content_digest`.

Source: `lightbulb/compliance_risk_lifecycle.py:1220`.

### `lightbulb.compliance_risk_command_digest`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import compliance_risk_command_digest
~~~


Binding: `lightbulb.compliance_risk_lifecycle.compliance_risk_command_digest` → `lightbulb.compliance_risk_lifecycle.compliance_risk_command_digest`.

Source: `lightbulb/compliance_risk_lifecycle.py:1234`.

### `lightbulb.compliance_risk_scope_digest`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import compliance_risk_scope_digest
~~~


Binding: `lightbulb.compliance_risk_lifecycle.compliance_risk_scope_digest` → `lightbulb.compliance_risk_lifecycle.compliance_risk_scope_digest`.

Source: `lightbulb/compliance_risk_lifecycle.py:385`.

### `lightbulb.materialize_compliance_risk_candidate`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import materialize_compliance_risk_candidate
~~~


Binding: `lightbulb.compliance_risk_lifecycle.materialize_compliance_risk_candidate` → `lightbulb.compliance_risk_lifecycle.materialize_compliance_risk_candidate`.

Source: `lightbulb/compliance_risk_lifecycle.py:1935`.

### `lightbulb.seal_compliance_risk_command`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import seal_compliance_risk_command
~~~


Binding: `lightbulb.compliance_risk_lifecycle.seal_compliance_risk_command` → `lightbulb.compliance_risk_lifecycle.seal_compliance_risk_command`.

Source: `lightbulb/compliance_risk_lifecycle.py:1244`.

### `lightbulb.OPERATIONAL_READINESS_EXECUTABLE_PRIMITIVES`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import OPERATIONAL_READINESS_EXECUTABLE_PRIMITIVES
~~~


Binding: `lightbulb.operational_readiness.OPERATIONAL_READINESS_EXECUTABLE_PRIMITIVES` → `lightbulb.operational_readiness.OPERATIONAL_READINESS_EXECUTABLE_PRIMITIVES`.

Source: `lightbulb/operational_readiness.py:1617`.

### `lightbulb.OPERATIONAL_READINESS_INPUT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import OPERATIONAL_READINESS_INPUT_SCHEMA
~~~


Binding: `lightbulb.operational_readiness.OPERATIONAL_READINESS_INPUT_SCHEMA` → `lightbulb.operational_readiness.OPERATIONAL_READINESS_INPUT_SCHEMA`.

Source: `lightbulb/operational_readiness.py:47`.

### `lightbulb.OPERATIONAL_READINESS_OPERATION`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import OPERATIONAL_READINESS_OPERATION
~~~


Binding: `lightbulb.operational_readiness.OPERATIONAL_READINESS_OPERATION` → `lightbulb.operational_readiness.OPERATIONAL_READINESS_OPERATION`.

Source: `lightbulb/operational_readiness.py:801`.

### `lightbulb.OPERATIONAL_READINESS_RESULT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import OPERATIONAL_READINESS_RESULT_SCHEMA
~~~


Binding: `lightbulb.operational_readiness.OPERATIONAL_READINESS_RESULT_SCHEMA` → `lightbulb.operational_readiness.OPERATIONAL_READINESS_RESULT_SCHEMA`.

Source: `lightbulb/operational_readiness.py:48`.

### `lightbulb.EvaluateOperationalReadinessPrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import EvaluateOperationalReadinessPrimitive
~~~


Binding: `lightbulb.operational_readiness.EvaluateOperationalReadinessPrimitive` → `lightbulb.operational_readiness.EvaluateOperationalReadinessPrimitive`.

Source: `lightbulb/operational_readiness.py:1530`.

### `lightbulb.OperationalReadinessInput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import OperationalReadinessInput
~~~


Binding: `lightbulb.operational_readiness.OperationalReadinessInput` → `lightbulb.operational_readiness.OperationalReadinessInput`.

Source: `lightbulb/operational_readiness.py:595`.

### `lightbulb.OperationalReadinessPolicy`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import OperationalReadinessPolicy
~~~


Binding: `lightbulb.operational_readiness.OperationalReadinessPolicy` → `lightbulb.operational_readiness.OperationalReadinessPolicy`.

Source: `lightbulb/operational_readiness.py:508`.

### `lightbulb.OperationalReadinessResult`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import OperationalReadinessResult
~~~


Binding: `lightbulb.operational_readiness.OperationalReadinessResult` → `lightbulb.operational_readiness.OperationalReadinessResult`.

Source: `lightbulb/operational_readiness.py:719`.

### `lightbulb.ReadinessDisposition`

value. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ReadinessDisposition
~~~


Binding: `lightbulb.operational_readiness.ReadinessDisposition` → `lightbulb.operational_readiness.ReadinessDisposition`.

Source: `lightbulb/operational_readiness.py:83`.

### `lightbulb.evaluate_operational_readiness`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import evaluate_operational_readiness
~~~


Binding: `lightbulb.operational_readiness.evaluate_operational_readiness` → `lightbulb.operational_readiness.evaluate_operational_readiness`.

Source: `lightbulb/operational_readiness.py:915`.

### `lightbulb.PRODUCTION_CONNECTOR_CONFORMANCE_EXECUTABLE_PRIMITIVES`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PRODUCTION_CONNECTOR_CONFORMANCE_EXECUTABLE_PRIMITIVES
~~~


Binding: `lightbulb.production_connector_conformance.PRODUCTION_CONNECTOR_CONFORMANCE_EXECUTABLE_PRIMITIVES` → `lightbulb.production_connector_conformance.PRODUCTION_CONNECTOR_CONFORMANCE_EXECUTABLE_PRIMITIVES`.

Source: `lightbulb/production_connector_conformance.py:2412`.

### `lightbulb.PRODUCTION_CONNECTOR_CONFORMANCE_INPUT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PRODUCTION_CONNECTOR_CONFORMANCE_INPUT_SCHEMA
~~~


Binding: `lightbulb.production_connector_conformance.PRODUCTION_CONNECTOR_CONFORMANCE_INPUT_SCHEMA` → `lightbulb.production_connector_conformance.PRODUCTION_CONNECTOR_CONFORMANCE_INPUT_SCHEMA`.

Source: `lightbulb/production_connector_conformance.py:55`.

### `lightbulb.PRODUCTION_CONNECTOR_CONFORMANCE_OPERATION`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PRODUCTION_CONNECTOR_CONFORMANCE_OPERATION
~~~


Binding: `lightbulb.production_connector_conformance.PRODUCTION_CONNECTOR_CONFORMANCE_OPERATION` → `lightbulb.production_connector_conformance.PRODUCTION_CONNECTOR_CONFORMANCE_OPERATION`.

Source: `lightbulb/production_connector_conformance.py:1236`.

### `lightbulb.PRODUCTION_CONNECTOR_CONFORMANCE_RESULT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PRODUCTION_CONNECTOR_CONFORMANCE_RESULT_SCHEMA
~~~


Binding: `lightbulb.production_connector_conformance.PRODUCTION_CONNECTOR_CONFORMANCE_RESULT_SCHEMA` → `lightbulb.production_connector_conformance.PRODUCTION_CONNECTOR_CONFORMANCE_RESULT_SCHEMA`.

Source: `lightbulb/production_connector_conformance.py:58`.

### `lightbulb.EvaluateProductionConnectorConformancePrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import EvaluateProductionConnectorConformancePrimitive
~~~


Binding: `lightbulb.production_connector_conformance.EvaluateProductionConnectorConformancePrimitive` → `lightbulb.production_connector_conformance.EvaluateProductionConnectorConformancePrimitive`.

Source: `lightbulb/production_connector_conformance.py:2259`.

### `lightbulb.ProductionConnectorConformanceEffectBoundary`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProductionConnectorConformanceEffectBoundary
~~~


Binding: `lightbulb.production_connector_conformance.ProductionConnectorConformanceEffectBoundary` → `lightbulb.production_connector_conformance.ProductionConnectorConformanceEffectBoundary`.

Source: `lightbulb/production_connector_conformance.py:1035`.

### `lightbulb.ProductionConnectorConformanceInput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProductionConnectorConformanceInput
~~~


Binding: `lightbulb.production_connector_conformance.ProductionConnectorConformanceInput` → `lightbulb.production_connector_conformance.ProductionConnectorConformanceInput`.

Source: `lightbulb/production_connector_conformance.py:930`.

### `lightbulb.ProductionConnectorConformancePolicy`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProductionConnectorConformancePolicy
~~~


Binding: `lightbulb.production_connector_conformance.ProductionConnectorConformancePolicy` → `lightbulb.production_connector_conformance.ProductionConnectorConformancePolicy`.

Source: `lightbulb/production_connector_conformance.py:839`.

### `lightbulb.ProductionConnectorConformanceResult`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProductionConnectorConformanceResult
~~~


Binding: `lightbulb.production_connector_conformance.ProductionConnectorConformanceResult` → `lightbulb.production_connector_conformance.ProductionConnectorConformanceResult`.

Source: `lightbulb/production_connector_conformance.py:1069`.

### `lightbulb.evaluate_production_connector_conformance`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import evaluate_production_connector_conformance
~~~


Binding: `lightbulb.production_connector_conformance.evaluate_production_connector_conformance` → `lightbulb.production_connector_conformance.evaluate_production_connector_conformance`.

Source: `lightbulb/production_connector_conformance.py:1751`.

### `lightbulb.GOVERNED_FINANCE_READ_COMMITMENT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GOVERNED_FINANCE_READ_COMMITMENT_SCHEMA
~~~


Binding: `lightbulb.production_connector_read_conformance.GOVERNED_FINANCE_READ_COMMITMENT_SCHEMA` → `lightbulb.production_connector_read_conformance.GOVERNED_FINANCE_READ_COMMITMENT_SCHEMA`.

Source: `lightbulb/production_connector_read_conformance.py:69`.

### `lightbulb.GOVERNED_OUTPUT_COMMITMENT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GOVERNED_OUTPUT_COMMITMENT_SCHEMA
~~~


Binding: `lightbulb.production_connector_read_conformance.GOVERNED_OUTPUT_COMMITMENT_SCHEMA` → `lightbulb.production_connector_read_conformance.GOVERNED_OUTPUT_COMMITMENT_SCHEMA`.

Source: `lightbulb/production_connector_read_conformance.py:68`.

### `lightbulb.GOVERNED_READ_ATTESTATION_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GOVERNED_READ_ATTESTATION_SCHEMA
~~~


Binding: `lightbulb.production_connector_read_conformance.GOVERNED_READ_ATTESTATION_SCHEMA` → `lightbulb.production_connector_read_conformance.GOVERNED_READ_ATTESTATION_SCHEMA`.

Source: `lightbulb/production_connector_read_conformance.py:64`.

### `lightbulb.HOSTED_READ_SCHEMA_ATTESTATION_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import HOSTED_READ_SCHEMA_ATTESTATION_SCHEMA
~~~


Binding: `lightbulb.production_connector_read_conformance.HOSTED_READ_SCHEMA_ATTESTATION_SCHEMA` → `lightbulb.production_connector_read_conformance.HOSTED_READ_SCHEMA_ATTESTATION_SCHEMA`.

Source: `lightbulb/production_connector_read_conformance.py:63`.

### `lightbulb.PRODUCTION_CONNECTOR_READ_CONFORMANCE_EXECUTABLE_PRIMITIVES`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PRODUCTION_CONNECTOR_READ_CONFORMANCE_EXECUTABLE_PRIMITIVES
~~~


Binding: `lightbulb.production_connector_read_conformance.PRODUCTION_CONNECTOR_READ_CONFORMANCE_EXECUTABLE_PRIMITIVES` → `lightbulb.production_connector_read_conformance.PRODUCTION_CONNECTOR_READ_CONFORMANCE_EXECUTABLE_PRIMITIVES`.

Source: `lightbulb/production_connector_read_conformance.py:1968`.

### `lightbulb.PRODUCTION_CONNECTOR_READ_CONFORMANCE_INPUT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PRODUCTION_CONNECTOR_READ_CONFORMANCE_INPUT_SCHEMA
~~~


Binding: `lightbulb.production_connector_read_conformance.PRODUCTION_CONNECTOR_READ_CONFORMANCE_INPUT_SCHEMA` → `lightbulb.production_connector_read_conformance.PRODUCTION_CONNECTOR_READ_CONFORMANCE_INPUT_SCHEMA`.

Source: `lightbulb/production_connector_read_conformance.py:57`.

### `lightbulb.PRODUCTION_CONNECTOR_READ_CONFORMANCE_OPERATION`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PRODUCTION_CONNECTOR_READ_CONFORMANCE_OPERATION
~~~


Binding: `lightbulb.production_connector_read_conformance.PRODUCTION_CONNECTOR_READ_CONFORMANCE_OPERATION` → `lightbulb.production_connector_read_conformance.PRODUCTION_CONNECTOR_READ_CONFORMANCE_OPERATION`.

Source: `lightbulb/production_connector_read_conformance.py:722`.

### `lightbulb.PRODUCTION_CONNECTOR_READ_CONFORMANCE_RESULT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PRODUCTION_CONNECTOR_READ_CONFORMANCE_RESULT_SCHEMA
~~~


Binding: `lightbulb.production_connector_read_conformance.PRODUCTION_CONNECTOR_READ_CONFORMANCE_RESULT_SCHEMA` → `lightbulb.production_connector_read_conformance.PRODUCTION_CONNECTOR_READ_CONFORMANCE_RESULT_SCHEMA`.

Source: `lightbulb/production_connector_read_conformance.py:60`.

### `lightbulb.PROVIDER_READ_OUTCOME_ATTESTATION_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROVIDER_READ_OUTCOME_ATTESTATION_SCHEMA
~~~


Binding: `lightbulb.production_connector_read_conformance.PROVIDER_READ_OUTCOME_ATTESTATION_SCHEMA` → `lightbulb.production_connector_read_conformance.PROVIDER_READ_OUTCOME_ATTESTATION_SCHEMA`.

Source: `lightbulb/production_connector_read_conformance.py:65`.

### `lightbulb.EvaluateProductionConnectorReadConformancePrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import EvaluateProductionConnectorReadConformancePrimitive
~~~


Binding: `lightbulb.production_connector_read_conformance.EvaluateProductionConnectorReadConformancePrimitive` → `lightbulb.production_connector_read_conformance.EvaluateProductionConnectorReadConformancePrimitive`.

Source: `lightbulb/production_connector_read_conformance.py:1813`.

### `lightbulb.GovernedReadAttestation`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GovernedReadAttestation
~~~


Binding: `lightbulb.production_connector_read_conformance.GovernedReadAttestation` → `lightbulb.production_connector_read_conformance.GovernedReadAttestation`.

Source: `lightbulb/production_connector_read_conformance.py:339`.

### `lightbulb.HostedReadSchemaAttestation`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import HostedReadSchemaAttestation
~~~


Binding: `lightbulb.production_connector_read_conformance.HostedReadSchemaAttestation` → `lightbulb.production_connector_read_conformance.HostedReadSchemaAttestation`.

Source: `lightbulb/production_connector_read_conformance.py:298`.

### `lightbulb.ProductionConnectorReadConformanceEffectBoundary`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProductionConnectorReadConformanceEffectBoundary
~~~


Binding: `lightbulb.production_connector_read_conformance.ProductionConnectorReadConformanceEffectBoundary` → `lightbulb.production_connector_read_conformance.ProductionConnectorReadConformanceEffectBoundary`.

Source: `lightbulb/production_connector_read_conformance.py:711`.

### `lightbulb.ProductionConnectorReadConformanceInput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProductionConnectorReadConformanceInput
~~~


Binding: `lightbulb.production_connector_read_conformance.ProductionConnectorReadConformanceInput` → `lightbulb.production_connector_read_conformance.ProductionConnectorReadConformanceInput`.

Source: `lightbulb/production_connector_read_conformance.py:610`.

### `lightbulb.ProductionConnectorReadConformancePolicy`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProductionConnectorReadConformancePolicy
~~~


Binding: `lightbulb.production_connector_read_conformance.ProductionConnectorReadConformancePolicy` → `lightbulb.production_connector_read_conformance.ProductionConnectorReadConformancePolicy`.

Source: `lightbulb/production_connector_read_conformance.py:487`.

### `lightbulb.ProductionConnectorReadConformanceResult`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProductionConnectorReadConformanceResult
~~~


Binding: `lightbulb.production_connector_read_conformance.ProductionConnectorReadConformanceResult` → `lightbulb.production_connector_read_conformance.ProductionConnectorReadConformanceResult`.

Source: `lightbulb/production_connector_read_conformance.py:757`.

### `lightbulb.ProductionReadConformanceDisposition`

value. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProductionReadConformanceDisposition
~~~


Binding: `lightbulb.production_connector_read_conformance.ProductionReadConformanceDisposition` → `lightbulb.production_connector_read_conformance.ProductionReadConformanceDisposition`.

Source: `lightbulb/production_connector_read_conformance.py:164`.

### `lightbulb.ProductionReadConformanceFinding`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProductionReadConformanceFinding
~~~


Binding: `lightbulb.production_connector_read_conformance.ProductionReadConformanceFinding` → `lightbulb.production_connector_read_conformance.ProductionReadConformanceFinding`.

Source: `lightbulb/production_connector_read_conformance.py:662`.

### `lightbulb.ProductionReadToolProof`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProductionReadToolProof
~~~


Binding: `lightbulb.production_connector_read_conformance.ProductionReadToolProof` → `lightbulb.production_connector_read_conformance.ProductionReadToolProof`.

Source: `lightbulb/production_connector_read_conformance.py:508`.

### `lightbulb.ProductionReadToolRequirement`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProductionReadToolRequirement
~~~


Binding: `lightbulb.production_connector_read_conformance.ProductionReadToolRequirement` → `lightbulb.production_connector_read_conformance.ProductionReadToolRequirement`.

Source: `lightbulb/production_connector_read_conformance.py:445`.

### `lightbulb.ProductionReadToolResult`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProductionReadToolResult
~~~


Binding: `lightbulb.production_connector_read_conformance.ProductionReadToolResult` → `lightbulb.production_connector_read_conformance.ProductionReadToolResult`.

Source: `lightbulb/production_connector_read_conformance.py:680`.

### `lightbulb.ProviderReadOutcomeAttestation`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProviderReadOutcomeAttestation
~~~


Binding: `lightbulb.production_connector_read_conformance.ProviderReadOutcomeAttestation` → `lightbulb.production_connector_read_conformance.ProviderReadOutcomeAttestation`.

Source: `lightbulb/production_connector_read_conformance.py:405`.

### `lightbulb.ReadConformanceGate`

value. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ReadConformanceGate
~~~


Binding: `lightbulb.production_connector_read_conformance.ReadConformanceGate` → `lightbulb.production_connector_read_conformance.ReadConformanceGate`.

Source: `lightbulb/production_connector_read_conformance.py:154`.

### `lightbulb.ReadConformanceGateStatus`

value. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ReadConformanceGateStatus
~~~


Binding: `lightbulb.production_connector_read_conformance.ReadConformanceGateStatus` → `lightbulb.production_connector_read_conformance.ReadConformanceGateStatus`.

Source: `lightbulb/production_connector_read_conformance.py:163`.

### `lightbulb.evaluate_production_connector_read_conformance`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import evaluate_production_connector_read_conformance
~~~


Binding: `lightbulb.production_connector_read_conformance.evaluate_production_connector_read_conformance` → `lightbulb.production_connector_read_conformance.evaluate_production_connector_read_conformance`.

Source: `lightbulb/production_connector_read_conformance.py:1253`.

### `lightbulb.CROSS_CHANNEL_IDENTITY_INPUT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CROSS_CHANNEL_IDENTITY_INPUT_SCHEMA
~~~


Binding: `lightbulb.communication_omnichannel.CROSS_CHANNEL_IDENTITY_INPUT_SCHEMA` → `lightbulb.communication_omnichannel.CROSS_CHANNEL_IDENTITY_INPUT_SCHEMA`.

Source: `lightbulb/communication_omnichannel.py:147`.

### `lightbulb.CROSS_CHANNEL_IDENTITY_PROPOSAL_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CROSS_CHANNEL_IDENTITY_PROPOSAL_SCHEMA
~~~


Binding: `lightbulb.communication_omnichannel.CROSS_CHANNEL_IDENTITY_PROPOSAL_SCHEMA` → `lightbulb.communication_omnichannel.CROSS_CHANNEL_IDENTITY_PROPOSAL_SCHEMA`.

Source: `lightbulb/communication_omnichannel.py:150`.

### `lightbulb.IDENTITY_RESOLUTION_OPERATION`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import IDENTITY_RESOLUTION_OPERATION
~~~


Binding: `lightbulb.communication_omnichannel.IDENTITY_RESOLUTION_OPERATION` → `lightbulb.communication_omnichannel.IDENTITY_RESOLUTION_OPERATION`.

Source: `lightbulb/communication_omnichannel.py:468`.

### `lightbulb.JURISDICTION_POLICY_OPERATION`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import JURISDICTION_POLICY_OPERATION
~~~


Binding: `lightbulb.communication_omnichannel.JURISDICTION_POLICY_OPERATION` → `lightbulb.communication_omnichannel.JURISDICTION_POLICY_OPERATION`.

Source: `lightbulb/communication_omnichannel.py:477`.

### `lightbulb.JURISDICTION_CHANNEL_POLICY_INPUT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import JURISDICTION_CHANNEL_POLICY_INPUT_SCHEMA
~~~


Binding: `lightbulb.communication_omnichannel.JURISDICTION_CHANNEL_POLICY_INPUT_SCHEMA` → `lightbulb.communication_omnichannel.JURISDICTION_CHANNEL_POLICY_INPUT_SCHEMA`.

Source: `lightbulb/communication_omnichannel.py:153`.

### `lightbulb.JURISDICTION_CHANNEL_POLICY_PROPOSAL_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import JURISDICTION_CHANNEL_POLICY_PROPOSAL_SCHEMA
~~~


Binding: `lightbulb.communication_omnichannel.JURISDICTION_CHANNEL_POLICY_PROPOSAL_SCHEMA` → `lightbulb.communication_omnichannel.JURISDICTION_CHANNEL_POLICY_PROPOSAL_SCHEMA`.

Source: `lightbulb/communication_omnichannel.py:156`.

### `lightbulb.PROVIDER_OBSERVATION_INPUT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROVIDER_OBSERVATION_INPUT_SCHEMA
~~~


Binding: `lightbulb.communication_omnichannel.PROVIDER_OBSERVATION_INPUT_SCHEMA` → `lightbulb.communication_omnichannel.PROVIDER_OBSERVATION_INPUT_SCHEMA`.

Source: `lightbulb/communication_omnichannel.py:161`.

### `lightbulb.PROVIDER_OBSERVATION_OPERATION`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROVIDER_OBSERVATION_OPERATION
~~~


Binding: `lightbulb.communication_omnichannel.PROVIDER_OBSERVATION_OPERATION` → `lightbulb.communication_omnichannel.PROVIDER_OBSERVATION_OPERATION`.

Source: `lightbulb/communication_omnichannel.py:495`.

### `lightbulb.PROVIDER_OBSERVATION_PROPOSAL_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROVIDER_OBSERVATION_PROPOSAL_SCHEMA
~~~


Binding: `lightbulb.communication_omnichannel.PROVIDER_OBSERVATION_PROPOSAL_SCHEMA` → `lightbulb.communication_omnichannel.PROVIDER_OBSERVATION_PROPOSAL_SCHEMA`.

Source: `lightbulb/communication_omnichannel.py:164`.

### `lightbulb.TWILIO_LOOKUP_CALL_STATUS_TOOL`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import TWILIO_LOOKUP_CALL_STATUS_TOOL
~~~


Binding: `lightbulb.communication_omnichannel.TWILIO_LOOKUP_CALL_STATUS_TOOL` → `lightbulb.communication_omnichannel.TWILIO_LOOKUP_CALL_STATUS_TOOL`.

Source: `lightbulb/communication_omnichannel.py:129`.

### `lightbulb.TWILIO_PLACE_CALL_TURN_TOOL`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import TWILIO_PLACE_CALL_TURN_TOOL
~~~


Binding: `lightbulb.communication_omnichannel.TWILIO_PLACE_CALL_TURN_TOOL` → `lightbulb.communication_omnichannel.TWILIO_PLACE_CALL_TURN_TOOL`.

Source: `lightbulb/communication_omnichannel.py:128`.

### `lightbulb.TWILIO_VOICE_MATERIALIZATION_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import TWILIO_VOICE_MATERIALIZATION_SCHEMA
~~~


Binding: `lightbulb.communication_omnichannel.TWILIO_VOICE_MATERIALIZATION_SCHEMA` → `lightbulb.communication_omnichannel.TWILIO_VOICE_MATERIALIZATION_SCHEMA`.

Source: `lightbulb/communication_omnichannel.py:176`.

### `lightbulb.TWILIO_VOICE_OBSERVATION_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import TWILIO_VOICE_OBSERVATION_SCHEMA
~~~


Binding: `lightbulb.communication_omnichannel.TWILIO_VOICE_OBSERVATION_SCHEMA` → `lightbulb.communication_omnichannel.TWILIO_VOICE_OBSERVATION_SCHEMA`.

Source: `lightbulb/communication_omnichannel.py:179`.

### `lightbulb.TWILIO_VOICE_STATUS_ROUTE_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import TWILIO_VOICE_STATUS_ROUTE_SCHEMA
~~~


Binding: `lightbulb.communication_omnichannel.TWILIO_VOICE_STATUS_ROUTE_SCHEMA` → `lightbulb.communication_omnichannel.TWILIO_VOICE_STATUS_ROUTE_SCHEMA`.

Source: `lightbulb/communication_omnichannel.py:171`.

### `lightbulb.TWILIO_VOICE_WRITE_ROUTE_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import TWILIO_VOICE_WRITE_ROUTE_SCHEMA
~~~


Binding: `lightbulb.communication_omnichannel.TWILIO_VOICE_WRITE_ROUTE_SCHEMA` → `lightbulb.communication_omnichannel.TWILIO_VOICE_WRITE_ROUTE_SCHEMA`.

Source: `lightbulb/communication_omnichannel.py:170`.

### `lightbulb.VOICE_CALL_PLAN_INPUT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import VOICE_CALL_PLAN_INPUT_SCHEMA
~~~


Binding: `lightbulb.communication_omnichannel.VOICE_CALL_PLAN_INPUT_SCHEMA` → `lightbulb.communication_omnichannel.VOICE_CALL_PLAN_INPUT_SCHEMA`.

Source: `lightbulb/communication_omnichannel.py:159`.

### `lightbulb.VOICE_CALL_PLAN_OPERATION`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import VOICE_CALL_PLAN_OPERATION
~~~


Binding: `lightbulb.communication_omnichannel.VOICE_CALL_PLAN_OPERATION` → `lightbulb.communication_omnichannel.VOICE_CALL_PLAN_OPERATION`.

Source: `lightbulb/communication_omnichannel.py:486`.

### `lightbulb.VOICE_CALL_PLAN_PROPOSAL_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import VOICE_CALL_PLAN_PROPOSAL_SCHEMA
~~~


Binding: `lightbulb.communication_omnichannel.VOICE_CALL_PLAN_PROPOSAL_SCHEMA` → `lightbulb.communication_omnichannel.VOICE_CALL_PLAN_PROPOSAL_SCHEMA`.

Source: `lightbulb/communication_omnichannel.py:160`.

### `lightbulb.CommunicationJurisdictionPolicyDecision`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommunicationJurisdictionPolicyDecision
~~~


Binding: `lightbulb.communication_omnichannel.CommunicationJurisdictionPolicyDecision` → `lightbulb.communication_omnichannel.CommunicationJurisdictionPolicyDecision`.

Source: `lightbulb/communication_omnichannel.py:689`.

### `lightbulb.CommunicationTwilioVoiceStatusRoute`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommunicationTwilioVoiceStatusRoute
~~~


Binding: `lightbulb.communication_omnichannel.CommunicationTwilioVoiceStatusRoute` → `lightbulb.communication_omnichannel.CommunicationTwilioVoiceStatusRoute`.

Source: `lightbulb/communication_omnichannel.py:1263`.

### `lightbulb.CommunicationTwilioVoiceWriteRoute`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommunicationTwilioVoiceWriteRoute
~~~


Binding: `lightbulb.communication_omnichannel.CommunicationTwilioVoiceWriteRoute` → `lightbulb.communication_omnichannel.CommunicationTwilioVoiceWriteRoute`.

Source: `lightbulb/communication_omnichannel.py:1248`.

### `lightbulb.CrossChannelIdentityInput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CrossChannelIdentityInput
~~~


Binding: `lightbulb.communication_omnichannel.CrossChannelIdentityInput` → `lightbulb.communication_omnichannel.CrossChannelIdentityInput`.

Source: `lightbulb/communication_omnichannel.py:506`.

### `lightbulb.CrossChannelIdentityProposal`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CrossChannelIdentityProposal
~~~


Binding: `lightbulb.communication_omnichannel.CrossChannelIdentityProposal` → `lightbulb.communication_omnichannel.CrossChannelIdentityProposal`.

Source: `lightbulb/communication_omnichannel.py:544`.

### `lightbulb.EvaluateJurisdictionChannelPolicyPrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import EvaluateJurisdictionChannelPolicyPrimitive
~~~


Binding: `lightbulb.communication_omnichannel.EvaluateJurisdictionChannelPolicyPrimitive` → `lightbulb.communication_omnichannel.EvaluateJurisdictionChannelPolicyPrimitive`.

Source: `lightbulb/communication_omnichannel.py:3837`.

### `lightbulb.JurisdictionChannelPolicyInput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import JurisdictionChannelPolicyInput
~~~


Binding: `lightbulb.communication_omnichannel.JurisdictionChannelPolicyInput` → `lightbulb.communication_omnichannel.JurisdictionChannelPolicyInput`.

Source: `lightbulb/communication_omnichannel.py:768`.

### `lightbulb.JurisdictionChannelPolicyProposal`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import JurisdictionChannelPolicyProposal
~~~


Binding: `lightbulb.communication_omnichannel.JurisdictionChannelPolicyProposal` → `lightbulb.communication_omnichannel.JurisdictionChannelPolicyProposal`.

Source: `lightbulb/communication_omnichannel.py:814`.

### `lightbulb.NormalizeProviderOutcomePrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import NormalizeProviderOutcomePrimitive
~~~


Binding: `lightbulb.communication_omnichannel.NormalizeProviderOutcomePrimitive` → `lightbulb.communication_omnichannel.NormalizeProviderOutcomePrimitive`.

Source: `lightbulb/communication_omnichannel.py:3935`.

### `lightbulb.NormalizedOutcome`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import NormalizedOutcome
~~~


Binding: `lightbulb.communication_omnichannel.NormalizedOutcome` → `lightbulb.communication_omnichannel.NormalizedOutcome`.

Source: `lightbulb/communication_omnichannel.py:328`.

### `lightbulb.NormalizedTransportState`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import NormalizedTransportState
~~~


Binding: `lightbulb.communication_omnichannel.NormalizedTransportState` → `lightbulb.communication_omnichannel.NormalizedTransportState`.

Source: `lightbulb/communication_omnichannel.py:319`.

### `lightbulb.OmnichannelEffectBoundary`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import OmnichannelEffectBoundary
~~~


Binding: `lightbulb.communication_omnichannel.OmnichannelEffectBoundary` → `lightbulb.communication_omnichannel.OmnichannelEffectBoundary`.

Source: `lightbulb/communication_omnichannel.py:348`.

### `lightbulb.OmnichannelEvidencePolicy`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import OmnichannelEvidencePolicy
~~~


Binding: `lightbulb.communication_omnichannel.OmnichannelEvidencePolicy` → `lightbulb.communication_omnichannel.OmnichannelEvidencePolicy`.

Source: `lightbulb/communication_omnichannel.py:363`.

### `lightbulb.PlanGovernedVoiceCallPrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PlanGovernedVoiceCallPrimitive
~~~


Binding: `lightbulb.communication_omnichannel.PlanGovernedVoiceCallPrimitive` → `lightbulb.communication_omnichannel.PlanGovernedVoiceCallPrimitive`.

Source: `lightbulb/communication_omnichannel.py:3884`.

### `lightbulb.ProviderObservationInput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProviderObservationInput
~~~


Binding: `lightbulb.communication_omnichannel.ProviderObservationInput` → `lightbulb.communication_omnichannel.ProviderObservationInput`.

Source: `lightbulb/communication_omnichannel.py:2009`.

### `lightbulb.ProviderObservationProposal`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProviderObservationProposal
~~~


Binding: `lightbulb.communication_omnichannel.ProviderObservationProposal` → `lightbulb.communication_omnichannel.ProviderObservationProposal`.

Source: `lightbulb/communication_omnichannel.py:2066`.

### `lightbulb.ResolveCrossChannelIdentityPrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ResolveCrossChannelIdentityPrimitive
~~~


Binding: `lightbulb.communication_omnichannel.ResolveCrossChannelIdentityPrimitive` → `lightbulb.communication_omnichannel.ResolveCrossChannelIdentityPrimitive`.

Source: `lightbulb/communication_omnichannel.py:3791`.

### `lightbulb.TwilioVoiceDispatchReceipt`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import TwilioVoiceDispatchReceipt
~~~


Binding: `lightbulb.communication_omnichannel.TwilioVoiceDispatchReceipt` → `lightbulb.communication_omnichannel.TwilioVoiceDispatchReceipt`.

Source: `lightbulb/communication_omnichannel.py:1432`.

### `lightbulb.TwilioVoiceExecutionEffectBoundary`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import TwilioVoiceExecutionEffectBoundary
~~~


Binding: `lightbulb.communication_omnichannel.TwilioVoiceExecutionEffectBoundary` → `lightbulb.communication_omnichannel.TwilioVoiceExecutionEffectBoundary`.

Source: `lightbulb/communication_omnichannel.py:1422`.

### `lightbulb.TwilioVoiceMaterializationResult`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import TwilioVoiceMaterializationResult
~~~


Binding: `lightbulb.communication_omnichannel.TwilioVoiceMaterializationResult` → `lightbulb.communication_omnichannel.TwilioVoiceMaterializationResult`.

Source: `lightbulb/communication_omnichannel.py:1458`.

### `lightbulb.TwilioVoiceObservationResult`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import TwilioVoiceObservationResult
~~~


Binding: `lightbulb.communication_omnichannel.TwilioVoiceObservationResult` → `lightbulb.communication_omnichannel.TwilioVoiceObservationResult`.

Source: `lightbulb/communication_omnichannel.py:1484`.

### `lightbulb.VoiceCallPlanInput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import VoiceCallPlanInput
~~~


Binding: `lightbulb.communication_omnichannel.VoiceCallPlanInput` → `lightbulb.communication_omnichannel.VoiceCallPlanInput`.

Source: `lightbulb/communication_omnichannel.py:996`.

### `lightbulb.VoiceCallPlanProposal`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import VoiceCallPlanProposal
~~~


Binding: `lightbulb.communication_omnichannel.VoiceCallPlanProposal` → `lightbulb.communication_omnichannel.VoiceCallPlanProposal`.

Source: `lightbulb/communication_omnichannel.py:1060`.

### `lightbulb.evaluate_jurisdiction_channel_policy`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import evaluate_jurisdiction_channel_policy
~~~


Binding: `lightbulb.communication_omnichannel.evaluate_jurisdiction_channel_policy` → `lightbulb.communication_omnichannel.evaluate_jurisdiction_channel_policy`.

Source: `lightbulb/communication_omnichannel.py:865`.

### `lightbulb.materialize_twilio_sms_communication_turn`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import materialize_twilio_sms_communication_turn
~~~


Binding: `lightbulb.communication_omnichannel.materialize_twilio_sms_communication_turn` → `lightbulb.communication_omnichannel.materialize_twilio_sms_communication_turn`.

Source: `lightbulb/communication_omnichannel.py:3180`.

### `lightbulb.materialize_twilio_voice_call`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import materialize_twilio_voice_call
~~~


Binding: `lightbulb.communication_omnichannel.materialize_twilio_voice_call` → `lightbulb.communication_omnichannel.materialize_twilio_voice_call`.

Source: `lightbulb/communication_omnichannel.py:1556`.

### `lightbulb.materialize_whatsapp_service_window_communication_turn`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import materialize_whatsapp_service_window_communication_turn
~~~


Binding: `lightbulb.communication_omnichannel.materialize_whatsapp_service_window_communication_turn` → `lightbulb.communication_omnichannel.materialize_whatsapp_service_window_communication_turn`.

Source: `lightbulb/communication_omnichannel.py:3202`.

### `lightbulb.materialize_whatsapp_template_communication_turn`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import materialize_whatsapp_template_communication_turn
~~~


Binding: `lightbulb.communication_omnichannel.materialize_whatsapp_template_communication_turn` → `lightbulb.communication_omnichannel.materialize_whatsapp_template_communication_turn`.

Source: `lightbulb/communication_omnichannel.py:3191`.

### `lightbulb.normalize_provider_outcome`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import normalize_provider_outcome
~~~


Binding: `lightbulb.communication_omnichannel.normalize_provider_outcome` → `lightbulb.communication_omnichannel.normalize_provider_outcome`.

Source: `lightbulb/communication_omnichannel.py:2253`.

### `lightbulb.observe_twilio_sms_delivery`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import observe_twilio_sms_delivery
~~~


Binding: `lightbulb.communication_omnichannel.observe_twilio_sms_delivery` → `lightbulb.communication_omnichannel.observe_twilio_sms_delivery`.

Source: `lightbulb/communication_omnichannel.py:3292`.

### `lightbulb.observe_twilio_voice_call`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import observe_twilio_voice_call
~~~


Binding: `lightbulb.communication_omnichannel.observe_twilio_voice_call` → `lightbulb.communication_omnichannel.observe_twilio_voice_call`.

Source: `lightbulb/communication_omnichannel.py:1761`.

### `lightbulb.plan_governed_voice_call`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import plan_governed_voice_call
~~~


Binding: `lightbulb.communication_omnichannel.plan_governed_voice_call` → `lightbulb.communication_omnichannel.plan_governed_voice_call`.

Source: `lightbulb/communication_omnichannel.py:1122`.

### `lightbulb.resolve_cross_channel_identity`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import resolve_cross_channel_identity
~~~


Binding: `lightbulb.communication_omnichannel.resolve_cross_channel_identity` → `lightbulb.communication_omnichannel.resolve_cross_channel_identity`.

Source: `lightbulb/communication_omnichannel.py:592`.

### `lightbulb.COMMUNICATION_WHATSAPP_OBSERVATION_RESULT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import COMMUNICATION_WHATSAPP_OBSERVATION_RESULT_SCHEMA
~~~


Binding: `lightbulb.communication_whatsapp_observer.COMMUNICATION_WHATSAPP_OBSERVATION_RESULT_SCHEMA` → `lightbulb.communication_whatsapp_observer.COMMUNICATION_WHATSAPP_OBSERVATION_RESULT_SCHEMA`.

Source: `lightbulb/communication_whatsapp_observer.py:68`.

### `lightbulb.COMMUNICATION_WHATSAPP_WEBHOOK_OBSERVATION_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import COMMUNICATION_WHATSAPP_WEBHOOK_OBSERVATION_SCHEMA
~~~


Binding: `lightbulb.communication_whatsapp_observer.COMMUNICATION_WHATSAPP_WEBHOOK_OBSERVATION_SCHEMA` → `lightbulb.communication_whatsapp_observer.COMMUNICATION_WHATSAPP_WEBHOOK_OBSERVATION_SCHEMA`.

Source: `lightbulb/communication_whatsapp_observer.py:65`.

### `lightbulb.CommunicationWhatsAppWebhookObservation`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommunicationWhatsAppWebhookObservation
~~~


Binding: `lightbulb.communication_whatsapp_observer.CommunicationWhatsAppWebhookObservation` → `lightbulb.communication_whatsapp_observer.CommunicationWhatsAppWebhookObservation`.

Source: `lightbulb/communication_whatsapp_observer.py:313`.

### `lightbulb.WhatsAppObservationEffectBoundary`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import WhatsAppObservationEffectBoundary
~~~


Binding: `lightbulb.communication_whatsapp_observer.WhatsAppObservationEffectBoundary` → `lightbulb.communication_whatsapp_observer.WhatsAppObservationEffectBoundary`.

Source: `lightbulb/communication_whatsapp_observer.py:467`.

### `lightbulb.WhatsAppObservationResult`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import WhatsAppObservationResult
~~~


Binding: `lightbulb.communication_whatsapp_observer.WhatsAppObservationResult` → `lightbulb.communication_whatsapp_observer.WhatsAppObservationResult`.

Source: `lightbulb/communication_whatsapp_observer.py:509`.

### `lightbulb.communication_whatsapp_private_event_id_commitment`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import communication_whatsapp_private_event_id_commitment
~~~


Binding: `lightbulb.communication_whatsapp_observer.communication_whatsapp_private_event_id_commitment` → `lightbulb.communication_whatsapp_observer.communication_whatsapp_private_event_id_commitment`.

Source: `lightbulb/communication_whatsapp_observer.py:186`.

### `lightbulb.observe_whatsapp_delivery`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import observe_whatsapp_delivery
~~~


Binding: `lightbulb.communication_whatsapp_observer.observe_whatsapp_delivery` → `lightbulb.communication_whatsapp_observer.observe_whatsapp_delivery`.

Source: `lightbulb/communication_whatsapp_observer.py:809`.

### `lightbulb.whatsapp_provider_event_identity_digest`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import whatsapp_provider_event_identity_digest
~~~


Binding: `lightbulb.communication_whatsapp_observer.whatsapp_provider_event_identity_digest` → `lightbulb.communication_whatsapp_observer.whatsapp_provider_event_identity_digest`.

Source: `lightbulb/communication_whatsapp_observer.py:231`.

### `lightbulb.whatsapp_webhook_event_digest`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import whatsapp_webhook_event_digest
~~~


Binding: `lightbulb.communication_whatsapp_observer.whatsapp_webhook_event_digest` → `lightbulb.communication_whatsapp_observer.whatsapp_webhook_event_digest`.

Source: `lightbulb/communication_whatsapp_observer.py:257`.

### `lightbulb.AsyncInvestmentAgentClient`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import AsyncInvestmentAgentClient
~~~


Binding: `lightbulb.investment.AsyncInvestmentAgentClient` → `lightbulb.investment.AsyncInvestmentAgentClient`.

Source: `lightbulb/investment.py:310`.

### `lightbulb.InvestmentAction`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import InvestmentAction
~~~


Binding: `lightbulb.investment.InvestmentAction` → `lightbulb.investment.InvestmentAction`.

Source: `lightbulb/investment.py:21`.

### `lightbulb.InvestmentAgentClient`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import InvestmentAgentClient
~~~


Binding: `lightbulb.investment.InvestmentAgentClient` → `lightbulb.investment.InvestmentAgentClient`.

Source: `lightbulb/investment.py:216`.

### `lightbulb.InvestmentEffect`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import InvestmentEffect
~~~


Binding: `lightbulb.investment.InvestmentEffect` → `lightbulb.investment.InvestmentEffect`.

Source: `lightbulb/investment.py:46`.

### `lightbulb.InvestmentEffectIntent`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import InvestmentEffectIntent
~~~


Binding: `lightbulb.investment.InvestmentEffectIntent` → `lightbulb.investment.InvestmentEffectIntent`.

Source: `lightbulb/investment.py:56`.

### `lightbulb.InvestmentSafetyError`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import InvestmentSafetyError
~~~


Binding: `lightbulb.investment.InvestmentSafetyError` → `lightbulb.investment.InvestmentSafetyError`.

Source: `lightbulb/investment.py:82`.

### `lightbulb.JiraClient`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import JiraClient
~~~


Binding: `lightbulb.connectors.JiraClient` → `lightbulb.connectors.JiraClient`.

Source: `lightbulb/connectors.py:122`.

### `lightbulb.SlackClient`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SlackClient
~~~


Binding: `lightbulb.connectors.SlackClient` → `lightbulb.connectors.SlackClient`.

Source: `lightbulb/connectors.py:39`.

### `lightbulb.BambooHRClient`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import BambooHRClient
~~~


Binding: `lightbulb.connectors.BambooHRClient` → `lightbulb.connectors.BambooHRClient`.

Source: `lightbulb/connectors.py:191`.

### `lightbulb.GreenhouseClient`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GreenhouseClient
~~~


Binding: `lightbulb.connectors.GreenhouseClient` → `lightbulb.connectors.GreenhouseClient`.

Source: `lightbulb/connectors.py:225`.

### `lightbulb.MondayClient`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import MondayClient
~~~


Binding: `lightbulb.connectors.MondayClient` → `lightbulb.connectors.MondayClient`.

Source: `lightbulb/connectors.py:255`.

### `lightbulb.CONNECTOR_EXECUTION_PROVENANCE_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CONNECTOR_EXECUTION_PROVENANCE_SCHEMA
~~~


Binding: `lightbulb.connector_execution.CONNECTOR_EXECUTION_PROVENANCE_SCHEMA` → `lightbulb.connector_execution.CONNECTOR_EXECUTION_PROVENANCE_SCHEMA`.

Source: `lightbulb/connector_execution.py:48`.

### `lightbulb.CONNECTOR_EXECUTION_REQUEST_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CONNECTOR_EXECUTION_REQUEST_SCHEMA
~~~


Binding: `lightbulb.connector_execution.CONNECTOR_EXECUTION_REQUEST_SCHEMA` → `lightbulb.connector_execution.CONNECTOR_EXECUTION_REQUEST_SCHEMA`.

Source: `lightbulb/connector_execution.py:46`.

### `lightbulb.CONNECTOR_EXECUTION_RESULT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CONNECTOR_EXECUTION_RESULT_SCHEMA
~~~


Binding: `lightbulb.connector_execution.CONNECTOR_EXECUTION_RESULT_SCHEMA` → `lightbulb.connector_execution.CONNECTOR_EXECUTION_RESULT_SCHEMA`.

Source: `lightbulb/connector_execution.py:47`.

### `lightbulb.ConnectorEffect`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ConnectorEffect
~~~


Binding: `lightbulb.connector_execution.ConnectorEffect` → `lightbulb.connector_execution.ConnectorEffect`.

Source: `lightbulb/connector_execution.py:110`.

### `lightbulb.ConnectorErrorKind`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ConnectorErrorKind
~~~


Binding: `lightbulb.connector_execution.ConnectorErrorKind` → `lightbulb.connector_execution.ConnectorErrorKind`.

Source: `lightbulb/connector_execution.py:124`.

### `lightbulb.ConnectorExecutionRequest`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ConnectorExecutionRequest
~~~


Binding: `lightbulb.connector_execution.ConnectorExecutionRequest` → `lightbulb.connector_execution.ConnectorExecutionRequest`.

Source: `lightbulb/connector_execution.py:466`.

### `lightbulb.ConnectorExecutionProvenance`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ConnectorExecutionProvenance
~~~


Binding: `lightbulb.connector_execution.ConnectorExecutionProvenance` → `lightbulb.connector_execution.ConnectorExecutionProvenance`.

Source: `lightbulb/connector_execution.py:137`.

### `lightbulb.ConnectorExecutionResult`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ConnectorExecutionResult
~~~


Binding: `lightbulb.connector_execution.ConnectorExecutionResult` → `lightbulb.connector_execution.ConnectorExecutionResult`.

Source: `lightbulb/connector_execution.py:555`.

### `lightbulb.ConnectorExecutionStatus`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ConnectorExecutionStatus
~~~


Binding: `lightbulb.connector_execution.ConnectorExecutionStatus` → `lightbulb.connector_execution.ConnectorExecutionStatus`.

Source: `lightbulb/connector_execution.py:116`.

### `lightbulb.ConnectorExecutor`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ConnectorExecutor
~~~


Binding: `lightbulb.connector_execution.ConnectorExecutor` → `lightbulb.connector_execution.ConnectorExecutor`.

Source: `lightbulb/connector_execution.py:626`.

### `lightbulb.ExecutionScope`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ExecutionScope
~~~


Binding: `lightbulb.connector_execution.ExecutionScope` → `lightbulb.connector_execution.ExecutionScope`.

Source: `lightbulb/connector_execution.py:219`.

### `lightbulb.HostedConnectorExecutor`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import HostedConnectorExecutor
~~~


Binding: `lightbulb.connector_execution.HostedConnectorExecutor` → `lightbulb.connector_execution.HostedConnectorExecutor`.

Source: `lightbulb/connector_execution.py:787`.

### `lightbulb.InMemoryConnectorExecutor`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import InMemoryConnectorExecutor
~~~


Binding: `lightbulb.connector_execution.InMemoryConnectorExecutor` → `lightbulb.connector_execution.InMemoryConnectorExecutor`.

Source: `lightbulb/connector_execution.py:1114`.

### `lightbulb.TrustedWorkflowIdentity`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import TrustedWorkflowIdentity
~~~


Binding: `lightbulb.connector_execution.TrustedWorkflowIdentity` → `lightbulb.connector_execution.TrustedWorkflowIdentity`.

Source: `lightbulb/connector_execution.py:242`.

### `lightbulb.PRIMITIVE_EVIDENCE_REF_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PRIMITIVE_EVIDENCE_REF_SCHEMA
~~~


Binding: `lightbulb.primitive_runtime.PRIMITIVE_EVIDENCE_REF_SCHEMA` → `lightbulb.primitive_runtime.PRIMITIVE_EVIDENCE_REF_SCHEMA`.

Source: `lightbulb/primitive_runtime.py:59`.

### `lightbulb.PRIMITIVE_EXECUTION_RESULT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PRIMITIVE_EXECUTION_RESULT_SCHEMA
~~~


Binding: `lightbulb.primitive_runtime.PRIMITIVE_EXECUTION_RESULT_SCHEMA` → `lightbulb.primitive_runtime.PRIMITIVE_EXECUTION_RESULT_SCHEMA`.

Source: `lightbulb/primitive_runtime.py:58`.

### `lightbulb.PRIMITIVE_IMPLEMENTATION_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PRIMITIVE_IMPLEMENTATION_SCHEMA
~~~


Binding: `lightbulb.primitive_runtime.PRIMITIVE_IMPLEMENTATION_SCHEMA` → `lightbulb.primitive_runtime.PRIMITIVE_IMPLEMENTATION_SCHEMA`.

Source: `lightbulb/primitive_runtime.py:57`.

### `lightbulb.PRIMITIVE_OPERATION_RECEIPT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PRIMITIVE_OPERATION_RECEIPT_SCHEMA
~~~


Binding: `lightbulb.primitive_runtime.PRIMITIVE_OPERATION_RECEIPT_SCHEMA` → `lightbulb.primitive_runtime.PRIMITIVE_OPERATION_RECEIPT_SCHEMA`.

Source: `lightbulb/primitive_runtime.py:62`.

### `lightbulb.PRIMITIVE_OPERATION_SPEC_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PRIMITIVE_OPERATION_SPEC_SCHEMA
~~~


Binding: `lightbulb.primitive_runtime.PRIMITIVE_OPERATION_SPEC_SCHEMA` → `lightbulb.primitive_runtime.PRIMITIVE_OPERATION_SPEC_SCHEMA`.

Source: `lightbulb/primitive_runtime.py:60`.

### `lightbulb.PRIMITIVE_RECOVERY_ATTESTATION_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PRIMITIVE_RECOVERY_ATTESTATION_SCHEMA
~~~


Binding: `lightbulb.primitive_runtime.PRIMITIVE_RECOVERY_ATTESTATION_SCHEMA` → `lightbulb.primitive_runtime.PRIMITIVE_RECOVERY_ATTESTATION_SCHEMA`.

Source: `lightbulb/primitive_runtime.py:63`.

### `lightbulb.PRIMITIVE_RECOVERY_PLAN_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PRIMITIVE_RECOVERY_PLAN_SCHEMA
~~~


Binding: `lightbulb.primitive_runtime.PRIMITIVE_RECOVERY_PLAN_SCHEMA` → `lightbulb.primitive_runtime.PRIMITIVE_RECOVERY_PLAN_SCHEMA`.

Source: `lightbulb/primitive_runtime.py:61`.

### `lightbulb.BusinessProcessPrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import BusinessProcessPrimitive
~~~


Binding: `lightbulb.primitive_runtime.BusinessProcessPrimitive` → `lightbulb.primitive_runtime.BusinessProcessPrimitive`.

Source: `lightbulb/primitive_runtime.py:783`.

### `lightbulb.ExecutablePrimitiveRuntime`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ExecutablePrimitiveRuntime
~~~


Binding: `lightbulb.primitive_runtime.ExecutablePrimitiveRuntime` → `lightbulb.primitive_runtime.ExecutablePrimitiveRuntime`.

Source: `lightbulb/primitive_runtime.py:1329`.

### `lightbulb.FunctionBusinessProcessPrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import FunctionBusinessProcessPrimitive
~~~


Binding: `lightbulb.primitive_runtime.FunctionBusinessProcessPrimitive` → `lightbulb.primitive_runtime.FunctionBusinessProcessPrimitive`.

Source: `lightbulb/primitive_runtime.py:963`.

### `lightbulb.PrimitiveCall`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PrimitiveCall
~~~


Binding: `lightbulb.primitive_runtime.PrimitiveCall` → `lightbulb.primitive_runtime.PrimitiveCall`.

Source: `lightbulb/primitive_runtime.py:1094`.

### `lightbulb.PrimitiveBlocker`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PrimitiveBlocker
~~~


Binding: `lightbulb.primitive_runtime.PrimitiveBlocker` → `lightbulb.primitive_runtime.PrimitiveBlocker`.

Source: `lightbulb/primitive_runtime.py:224`.

### `lightbulb.PrimitiveCorrelation`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PrimitiveCorrelation
~~~


Binding: `lightbulb.primitive_runtime.PrimitiveCorrelation` → `lightbulb.primitive_runtime.PrimitiveCorrelation`.

Source: `lightbulb/primitive_runtime.py:1104`.

### `lightbulb.PrimitiveEvent`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PrimitiveEvent
~~~


Binding: `lightbulb.primitive_runtime.PrimitiveEvent` → `lightbulb.primitive_runtime.PrimitiveEvent`.

Source: `lightbulb/primitive_runtime.py:167`.

### `lightbulb.PrimitiveEvidence`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PrimitiveEvidence
~~~


Binding: `lightbulb.primitive_runtime.PrimitiveEvidence` → `lightbulb.primitive_runtime.PrimitiveEvidence`.

Source: `lightbulb/primitive_runtime.py:174`.

### `lightbulb.PrimitiveEvidenceClassification`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PrimitiveEvidenceClassification
~~~


Binding: `lightbulb.primitive_runtime.PrimitiveEvidenceClassification` → `lightbulb.primitive_runtime.PrimitiveEvidenceClassification`.

Source: `lightbulb/primitive_runtime.py:89`.

### `lightbulb.PrimitiveEvidenceRef`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PrimitiveEvidenceRef
~~~


Binding: `lightbulb.primitive_runtime.PrimitiveEvidenceRef` → `lightbulb.primitive_runtime.PrimitiveEvidenceRef`.

Source: `lightbulb/primitive_runtime.py:183`.

### `lightbulb.PrimitiveEvidenceVerificationGrade`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PrimitiveEvidenceVerificationGrade
~~~


Binding: `lightbulb.primitive_runtime.PrimitiveEvidenceVerificationGrade` → `lightbulb.primitive_runtime.PrimitiveEvidenceVerificationGrade`.

Source: `lightbulb/primitive_runtime.py:82`.

### `lightbulb.PrimitiveExecutionContext`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PrimitiveExecutionContext
~~~


Binding: `lightbulb.primitive_runtime.PrimitiveExecutionContext` → `lightbulb.primitive_runtime.PrimitiveExecutionContext`.

Source: `lightbulb/primitive_runtime.py:635`.

### `lightbulb.PrimitiveExecutionResult`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PrimitiveExecutionResult
~~~


Binding: `lightbulb.primitive_runtime.PrimitiveExecutionResult` → `lightbulb.primitive_runtime.PrimitiveExecutionResult`.

Source: `lightbulb/primitive_runtime.py:565`.

### `lightbulb.PrimitiveExecutionStatus`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PrimitiveExecutionStatus
~~~


Binding: `lightbulb.primitive_runtime.PrimitiveExecutionStatus` → `lightbulb.primitive_runtime.PrimitiveExecutionStatus`.

Source: `lightbulb/primitive_runtime.py:68`.

### `lightbulb.PrimitiveOperationFreshnessClass`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PrimitiveOperationFreshnessClass
~~~


Binding: `lightbulb.primitive_runtime.PrimitiveOperationFreshnessClass` → `lightbulb.primitive_runtime.PrimitiveOperationFreshnessClass`.

Source: `lightbulb/primitive_runtime.py:102`.

### `lightbulb.PrimitiveOperationReceipt`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PrimitiveOperationReceipt
~~~


Binding: `lightbulb.primitive_runtime.PrimitiveOperationReceipt` → `lightbulb.primitive_runtime.PrimitiveOperationReceipt`.

Source: `lightbulb/primitive_runtime.py:426`.

### `lightbulb.PrimitiveOperationRecoveryPolicy`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PrimitiveOperationRecoveryPolicy
~~~


Binding: `lightbulb.primitive_runtime.PrimitiveOperationRecoveryPolicy` → `lightbulb.primitive_runtime.PrimitiveOperationRecoveryPolicy`.

Source: `lightbulb/primitive_runtime.py:108`.

### `lightbulb.PrimitiveOperationReplayClass`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PrimitiveOperationReplayClass
~~~


Binding: `lightbulb.primitive_runtime.PrimitiveOperationReplayClass` → `lightbulb.primitive_runtime.PrimitiveOperationReplayClass`.

Source: `lightbulb/primitive_runtime.py:96`.

### `lightbulb.PrimitiveOperationSpec`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PrimitiveOperationSpec
~~~


Binding: `lightbulb.primitive_runtime.PrimitiveOperationSpec` → `lightbulb.primitive_runtime.PrimitiveOperationSpec`.

Source: `lightbulb/primitive_runtime.py:297`.

### `lightbulb.PrimitiveOperationStatus`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PrimitiveOperationStatus
~~~


Binding: `lightbulb.primitive_runtime.PrimitiveOperationStatus` → `lightbulb.primitive_runtime.PrimitiveOperationStatus`.

Source: `lightbulb/primitive_runtime.py:116`.

### `lightbulb.PrimitiveRecoveryAttestation`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PrimitiveRecoveryAttestation
~~~


Binding: `lightbulb.primitive_runtime.PrimitiveRecoveryAttestation` → `lightbulb.primitive_runtime.PrimitiveRecoveryAttestation`.

Source: `lightbulb/primitive_runtime.py:233`.

### `lightbulb.PrimitiveRecoveryDisposition`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PrimitiveRecoveryDisposition
~~~


Binding: `lightbulb.primitive_runtime.PrimitiveRecoveryDisposition` → `lightbulb.primitive_runtime.PrimitiveRecoveryDisposition`.

Source: `lightbulb/primitive_runtime.py:127`.

### `lightbulb.PrimitiveRecoveryOutcome`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PrimitiveRecoveryOutcome
~~~


Binding: `lightbulb.primitive_runtime.PrimitiveRecoveryOutcome` → `lightbulb.primitive_runtime.PrimitiveRecoveryOutcome`.

Source: `lightbulb/primitive_runtime.py:136`.

### `lightbulb.PrimitiveRecoveryPlan`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PrimitiveRecoveryPlan
~~~


Binding: `lightbulb.primitive_runtime.PrimitiveRecoveryPlan` → `lightbulb.primitive_runtime.PrimitiveRecoveryPlan`.

Source: `lightbulb/primitive_runtime.py:351`.

### `lightbulb.PrimitiveRunMode`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PrimitiveRunMode
~~~


Binding: `lightbulb.primitive_runtime.PrimitiveRunMode` → `lightbulb.primitive_runtime.PrimitiveRunMode`.

Source: `lightbulb/primitive_runtime.py:77`.

### `lightbulb.PrimitiveRunSession`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PrimitiveRunSession
~~~


Binding: `lightbulb.primitive_runtime.PrimitiveRunSession` → `lightbulb.primitive_runtime.PrimitiveRunSession`.

Source: `lightbulb/primitive_runtime.py:1192`.

### `lightbulb.PrimitiveRegistry`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PrimitiveRegistry
~~~


Binding: `lightbulb.primitive_runtime.PrimitiveRegistry` → `lightbulb.primitive_runtime.PrimitiveRegistry`.

Source: `lightbulb/primitive_runtime.py:1042`.

### `lightbulb.ProjectPrimitiveRun`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProjectPrimitiveRun
~~~


Binding: `lightbulb.primitive_runtime.ProjectPrimitiveRun` → `lightbulb.primitive_runtime.ProjectPrimitiveRun`.

Source: `lightbulb/primitive_runtime.py:1125`.

### `lightbulb.StandalonePrimitiveRun`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import StandalonePrimitiveRun
~~~


Binding: `lightbulb.primitive_runtime.StandalonePrimitiveRun` → `lightbulb.primitive_runtime.StandalonePrimitiveRun`.

Source: `lightbulb/primitive_runtime.py:1112`.

### `lightbulb.PrimitivePreview`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PrimitivePreview
~~~


Binding: `lightbulb.primitive_preview.PrimitivePreview` → `lightbulb.primitive_preview.PrimitivePreview`.

Source: `lightbulb/primitive_preview.py:32`.

### `lightbulb.preview_executable_primitive`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import preview_executable_primitive
~~~


Binding: `lightbulb.primitive_preview.preview_executable_primitive` → `lightbulb.primitive_preview.preview_executable_primitive`.

Source: `lightbulb/primitive_preview.py:37`.

### `lightbulb.business_process_primitive`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import business_process_primitive
~~~


Binding: `lightbulb.primitive_runtime.business_process_primitive` → `lightbulb.primitive_runtime.business_process_primitive`.

Source: `lightbulb/primitive_runtime.py:1011`.

### `lightbulb.detach_model_boundary_value`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import detach_model_boundary_value
~~~


Binding: `lightbulb.primitive_runtime.detach_model_boundary_value` → `lightbulb.primitive_runtime.detach_model_boundary_value`.

Source: `lightbulb/primitive_runtime.py:540`.

### `lightbulb.revalidate_model_boundary`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import revalidate_model_boundary
~~~


Binding: `lightbulb.primitive_runtime.revalidate_model_boundary` → `lightbulb.primitive_runtime.revalidate_model_boundary`.

Source: `lightbulb/primitive_runtime.py:556`.

### `lightbulb.BUILTIN_EXECUTABLE_PRIMITIVES`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import BUILTIN_EXECUTABLE_PRIMITIVES
~~~


Binding: `lightbulb.executable_primitives.BUILTIN_EXECUTABLE_PRIMITIVES` → `lightbulb.executable_primitives.BUILTIN_EXECUTABLE_PRIMITIVES`.

Source: `lightbulb/executable_primitives.py:1073`.

### `lightbulb.EXECUTABLE_PRIMITIVE_CATALOG_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import EXECUTABLE_PRIMITIVE_CATALOG_SCHEMA
~~~


Binding: `lightbulb.executable_primitives.EXECUTABLE_PRIMITIVE_CATALOG_SCHEMA` → `lightbulb.executable_primitives.EXECUTABLE_PRIMITIVE_CATALOG_SCHEMA`.

Source: `lightbulb/executable_primitives.py:311`.

### `lightbulb.ClassifyReplyPrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ClassifyReplyPrimitive
~~~


Binding: `lightbulb.executable_primitives.ClassifyReplyPrimitive` → `lightbulb.executable_primitives.ClassifyReplyPrimitive`.

Source: `lightbulb/executable_primitives.py:377`.

### `lightbulb.CollectPaymentInput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CollectPaymentInput
~~~


Binding: `lightbulb.executable_primitives.CollectPaymentInput` → `lightbulb.growth_primitives.CollectPaymentInput`.

Source: `lightbulb/growth_primitives.py:70`.

### `lightbulb.CollectPaymentOutput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CollectPaymentOutput
~~~


Binding: `lightbulb.executable_primitives.CollectPaymentOutput` → `lightbulb.growth_primitives.CollectPaymentOutput`.

Source: `lightbulb/growth_primitives.py:100`.

### `lightbulb.CollectPaymentPrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CollectPaymentPrimitive
~~~


Binding: `lightbulb.executable_primitives.CollectPaymentPrimitive` → `lightbulb.growth_primitives.CollectPaymentPrimitive`.

Source: `lightbulb/growth_primitives.py:113`.

### `lightbulb.ContractRiskFinding`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ContractRiskFinding
~~~


Binding: `lightbulb.executable_primitives.ContractRiskFinding` → `lightbulb.domain_primitives.ContractRiskFinding`.

Source: `lightbulb/domain_primitives.py:431`.

### `lightbulb.CreateInvoiceInput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CreateInvoiceInput
~~~


Binding: `lightbulb.executable_primitives.CreateInvoiceInput` → `lightbulb.executable_primitives.CreateInvoiceInput`.

Source: `lightbulb/executable_primitives.py:735`.

### `lightbulb.CreateInvoiceOutput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CreateInvoiceOutput
~~~


Binding: `lightbulb.executable_primitives.CreateInvoiceOutput` → `lightbulb.executable_primitives.CreateInvoiceOutput`.

Source: `lightbulb/executable_primitives.py:766`.

### `lightbulb.CreateInvoicePrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CreateInvoicePrimitive
~~~


Binding: `lightbulb.executable_primitives.CreateInvoicePrimitive` → `lightbulb.executable_primitives.CreateInvoicePrimitive`.

Source: `lightbulb/executable_primitives.py:781`.

### `lightbulb.CreateWorkPacketInput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CreateWorkPacketInput
~~~


Binding: `lightbulb.executable_primitives.CreateWorkPacketInput` → `lightbulb.growth_primitives.CreateWorkPacketInput`.

Source: `lightbulb/growth_primitives.py:513`.

### `lightbulb.CreateWorkPacketOutput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CreateWorkPacketOutput
~~~


Binding: `lightbulb.executable_primitives.CreateWorkPacketOutput` → `lightbulb.growth_primitives.CreateWorkPacketOutput`.

Source: `lightbulb/growth_primitives.py:535`.

### `lightbulb.CreateWorkPacketPrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CreateWorkPacketPrimitive
~~~


Binding: `lightbulb.executable_primitives.CreateWorkPacketPrimitive` → `lightbulb.growth_primitives.CreateWorkPacketPrimitive`.

Source: `lightbulb/growth_primitives.py:549`.

### `lightbulb.DraftContractInput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import DraftContractInput
~~~


Binding: `lightbulb.executable_primitives.DraftContractInput` → `lightbulb.domain_primitives.DraftContractInput`.

Source: `lightbulb/domain_primitives.py:291`.

### `lightbulb.DraftContractOutput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import DraftContractOutput
~~~


Binding: `lightbulb.executable_primitives.DraftContractOutput` → `lightbulb.domain_primitives.DraftContractOutput`.

Source: `lightbulb/domain_primitives.py:303`.

### `lightbulb.DraftContractPrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import DraftContractPrimitive
~~~


Binding: `lightbulb.executable_primitives.DraftContractPrimitive` → `lightbulb.domain_primitives.DraftContractPrimitive`.

Source: `lightbulb/domain_primitives.py:315`.

### `lightbulb.IngestSupplierInvoicePrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import IngestSupplierInvoicePrimitive
~~~


Binding: `lightbulb.executable_primitives.IngestSupplierInvoicePrimitive` → `lightbulb.domain_primitives.IngestSupplierInvoicePrimitive`.

Source: `lightbulb/domain_primitives.py:136`.

### `lightbulb.GenerateBusinessArtifactInput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GenerateBusinessArtifactInput
~~~


Binding: `lightbulb.executable_primitives.GenerateBusinessArtifactInput` → `lightbulb.growth_primitives.GenerateBusinessArtifactInput`.

Source: `lightbulb/growth_primitives.py:371`.

### `lightbulb.GenerateBusinessArtifactOutput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GenerateBusinessArtifactOutput
~~~


Binding: `lightbulb.executable_primitives.GenerateBusinessArtifactOutput` → `lightbulb.growth_primitives.GenerateBusinessArtifactOutput`.

Source: `lightbulb/growth_primitives.py:389`.

### `lightbulb.GenerateBusinessArtifactPrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GenerateBusinessArtifactPrimitive
~~~


Binding: `lightbulb.executable_primitives.GenerateBusinessArtifactPrimitive` → `lightbulb.growth_primitives.GenerateBusinessArtifactPrimitive`.

Source: `lightbulb/growth_primitives.py:398`.

### `lightbulb.InvoiceLineItem`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import InvoiceLineItem
~~~


Binding: `lightbulb.executable_primitives.InvoiceLineItem` → `lightbulb.executable_primitives.InvoiceLineItem`.

Source: `lightbulb/executable_primitives.py:726`.

### `lightbulb.LeadQualificationRules`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import LeadQualificationRules
~~~


Binding: `lightbulb.executable_primitives.LeadQualificationRules` → `lightbulb.domain_primitives.LeadQualificationRules`.

Source: `lightbulb/domain_primitives.py:577`.

### `lightbulb.LearningDataProfile`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import LearningDataProfile
~~~


Binding: `lightbulb.executable_primitives.LearningDataProfile` → `lightbulb.learning_primitives.LearningDataProfile`.

Source: `lightbulb/learning_primitives.py:88`.

### `lightbulb.LearningEventStreamContract`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import LearningEventStreamContract
~~~


Binding: `lightbulb.executable_primitives.LearningEventStreamContract` → `lightbulb.learning_primitives.LearningEventStreamContract`.

Source: `lightbulb/learning_primitives.py:332`.

### `lightbulb.LearningRunPreparationPlan`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import LearningRunPreparationPlan
~~~


Binding: `lightbulb.executable_primitives.LearningRunPreparationPlan` → `lightbulb.learning_primitives.LearningRunPreparationPlan`.

Source: `lightbulb/learning_primitives.py:245`.

### `lightbulb.OptimizationSweepBudgetLedger`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import OptimizationSweepBudgetLedger
~~~


Binding: `lightbulb.executable_primitives.OptimizationSweepBudgetLedger` → `lightbulb.learning_primitives.OptimizationSweepBudgetLedger`.

Source: `lightbulb/learning_primitives.py:392`.

### `lightbulb.OnboardEmployeeInput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import OnboardEmployeeInput
~~~


Binding: `lightbulb.executable_primitives.OnboardEmployeeInput` → `lightbulb.domain_primitives.OnboardEmployeeInput`.

Source: `lightbulb/domain_primitives.py:781`.

### `lightbulb.OnboardEmployeeOutput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import OnboardEmployeeOutput
~~~


Binding: `lightbulb.executable_primitives.OnboardEmployeeOutput` → `lightbulb.domain_primitives.OnboardEmployeeOutput`.

Source: `lightbulb/domain_primitives.py:817`.

### `lightbulb.OnboardEmployeePrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import OnboardEmployeePrimitive
~~~


Binding: `lightbulb.executable_primitives.OnboardEmployeePrimitive` → `lightbulb.domain_primitives.OnboardEmployeePrimitive`.

Source: `lightbulb/domain_primitives.py:829`.

### `lightbulb.OnboardingTask`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import OnboardingTask
~~~


Binding: `lightbulb.executable_primitives.OnboardingTask` → `lightbulb.domain_primitives.OnboardingTask`.

Source: `lightbulb/domain_primitives.py:771`.

### `lightbulb.OptimizationSweepBudget`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import OptimizationSweepBudget
~~~


Binding: `lightbulb.executable_primitives.OptimizationSweepBudget` → `lightbulb.learning_primitives.OptimizationSweepBudget`.

Source: `lightbulb/learning_primitives.py:100`.

### `lightbulb.OptimizationSweepOutput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import OptimizationSweepOutput
~~~


Binding: `lightbulb.executable_primitives.OptimizationSweepOutput` → `lightbulb.learning_primitives.OptimizationSweepOutput`.

Source: `lightbulb/learning_primitives.py:428`.

### `lightbulb.OptimizationSweepResourceTotals`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import OptimizationSweepResourceTotals
~~~


Binding: `lightbulb.executable_primitives.OptimizationSweepResourceTotals` → `lightbulb.learning_primitives.OptimizationSweepResourceTotals`.

Source: `lightbulb/learning_primitives.py:365`.

### `lightbulb.OptimizationSweepSafety`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import OptimizationSweepSafety
~~~


Binding: `lightbulb.executable_primitives.OptimizationSweepSafety` → `lightbulb.learning_primitives.OptimizationSweepSafety`.

Source: `lightbulb/learning_primitives.py:402`.

### `lightbulb.OptimizationSweepStage`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import OptimizationSweepStage
~~~


Binding: `lightbulb.executable_primitives.OptimizationSweepStage` → `lightbulb.learning_primitives.OptimizationSweepStage`.

Source: `lightbulb/learning_primitives.py:311`.

### `lightbulb.PlanOptimizationSweepInput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PlanOptimizationSweepInput
~~~


Binding: `lightbulb.executable_primitives.PlanOptimizationSweepInput` → `lightbulb.learning_primitives.PlanOptimizationSweepInput`.

Source: `lightbulb/learning_primitives.py:135`.

### `lightbulb.PlanOptimizationSweepPrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PlanOptimizationSweepPrimitive
~~~


Binding: `lightbulb.executable_primitives.PlanOptimizationSweepPrimitive` → `lightbulb.learning_primitives.PlanOptimizationSweepPrimitive`.

Source: `lightbulb/learning_primitives.py:727`.

### `lightbulb.QualifyLeadInput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import QualifyLeadInput
~~~


Binding: `lightbulb.executable_primitives.QualifyLeadInput` → `lightbulb.domain_primitives.QualifyLeadInput`.

Source: `lightbulb/domain_primitives.py:593`.

### `lightbulb.QualifyLeadOutput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import QualifyLeadOutput
~~~


Binding: `lightbulb.executable_primitives.QualifyLeadOutput` → `lightbulb.domain_primitives.QualifyLeadOutput`.

Source: `lightbulb/domain_primitives.py:618`.

### `lightbulb.QualifyLeadPrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import QualifyLeadPrimitive
~~~


Binding: `lightbulb.executable_primitives.QualifyLeadPrimitive` → `lightbulb.domain_primitives.QualifyLeadPrimitive`.

Source: `lightbulb/domain_primitives.py:629`.

### `lightbulb.ReplyClassificationInput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ReplyClassificationInput
~~~


Binding: `lightbulb.executable_primitives.ReplyClassificationInput` → `lightbulb.executable_primitives.ReplyClassificationInput`.

Source: `lightbulb/executable_primitives.py:356`.

### `lightbulb.ReplyClassificationOutput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ReplyClassificationOutput
~~~


Binding: `lightbulb.executable_primitives.ReplyClassificationOutput` → `lightbulb.executable_primitives.ReplyClassificationOutput`.

Source: `lightbulb/executable_primitives.py:366`.

### `lightbulb.RequestDecisionInput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import RequestDecisionInput
~~~


Binding: `lightbulb.executable_primitives.RequestDecisionInput` → `lightbulb.growth_primitives.RequestDecisionInput`.

Source: `lightbulb/growth_primitives.py:223`.

### `lightbulb.RequestDecisionOutput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import RequestDecisionOutput
~~~


Binding: `lightbulb.executable_primitives.RequestDecisionOutput` → `lightbulb.growth_primitives.RequestDecisionOutput`.

Source: `lightbulb/growth_primitives.py:252`.

### `lightbulb.RequestDecisionPrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import RequestDecisionPrimitive
~~~


Binding: `lightbulb.executable_primitives.RequestDecisionPrimitive` → `lightbulb.growth_primitives.RequestDecisionPrimitive`.

Source: `lightbulb/growth_primitives.py:263`.

### `lightbulb.ReviewContractInput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ReviewContractInput
~~~


Binding: `lightbulb.executable_primitives.ReviewContractInput` → `lightbulb.domain_primitives.ReviewContractInput`.

Source: `lightbulb/domain_primitives.py:440`.

### `lightbulb.ReviewContractOutput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ReviewContractOutput
~~~


Binding: `lightbulb.executable_primitives.ReviewContractOutput` → `lightbulb.domain_primitives.ReviewContractOutput`.

Source: `lightbulb/domain_primitives.py:457`.

### `lightbulb.ReviewContractPrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ReviewContractPrimitive
~~~


Binding: `lightbulb.executable_primitives.ReviewContractPrimitive` → `lightbulb.domain_primitives.ReviewContractPrimitive`.

Source: `lightbulb/domain_primitives.py:468`.

### `lightbulb.ScheduleMeetingInput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ScheduleMeetingInput
~~~


Binding: `lightbulb.executable_primitives.ScheduleMeetingInput` → `lightbulb.executable_primitives.ScheduleMeetingInput`.

Source: `lightbulb/executable_primitives.py:909`.

### `lightbulb.ScheduleMeetingOutput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ScheduleMeetingOutput
~~~


Binding: `lightbulb.executable_primitives.ScheduleMeetingOutput` → `lightbulb.executable_primitives.ScheduleMeetingOutput`.

Source: `lightbulb/executable_primitives.py:942`.

### `lightbulb.ScheduleMeetingPrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ScheduleMeetingPrimitive
~~~


Binding: `lightbulb.executable_primitives.ScheduleMeetingPrimitive` → `lightbulb.executable_primitives.ScheduleMeetingPrimitive`.

Source: `lightbulb/executable_primitives.py:956`.

### `lightbulb.SupplierInvoiceInput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SupplierInvoiceInput
~~~


Binding: `lightbulb.executable_primitives.SupplierInvoiceInput` → `lightbulb.domain_primitives.SupplierInvoiceInput`.

Source: `lightbulb/domain_primitives.py:92`.

### `lightbulb.SupplierInvoiceOutput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SupplierInvoiceOutput
~~~


Binding: `lightbulb.executable_primitives.SupplierInvoiceOutput` → `lightbulb.domain_primitives.SupplierInvoiceOutput`.

Source: `lightbulb/domain_primitives.py:110`.

### `lightbulb.WriteEmailInput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import WriteEmailInput
~~~


Binding: `lightbulb.executable_primitives.WriteEmailInput` → `lightbulb.executable_primitives.WriteEmailInput`.

Source: `lightbulb/executable_primitives.py:519`.

### `lightbulb.WriteEmailOutput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import WriteEmailOutput
~~~


Binding: `lightbulb.executable_primitives.WriteEmailOutput` → `lightbulb.executable_primitives.WriteEmailOutput`.

Source: `lightbulb/executable_primitives.py:586`.

### `lightbulb.WriteEmailPrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import WriteEmailPrimitive
~~~


Binding: `lightbulb.executable_primitives.WriteEmailPrimitive` → `lightbulb.executable_primitives.WriteEmailPrimitive`.

Source: `lightbulb/executable_primitives.py:598`.

### `lightbulb.compile_optimization_sweep`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import compile_optimization_sweep
~~~


Binding: `lightbulb.executable_primitives.compile_optimization_sweep` → `lightbulb.learning_primitives.compile_optimization_sweep`.

Source: `lightbulb/learning_primitives.py:566`.

### `lightbulb.default_primitive_registry`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import default_primitive_registry
~~~


Binding: `lightbulb.executable_primitives.default_primitive_registry` → `lightbulb.executable_primitives.default_primitive_registry`.

Source: `lightbulb/executable_primitives.py:1176`.

### `lightbulb.executable_business_primitive_catalog`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import executable_business_primitive_catalog
~~~


Binding: `lightbulb.executable_primitives.executable_business_primitive_catalog` → `lightbulb.executable_primitives.executable_business_primitive_catalog`.

Source: `lightbulb/executable_primitives.py:1185`.

### `lightbulb.OMNICHANNEL_PRODUCT_LAUNCH_PLAN_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import OMNICHANNEL_PRODUCT_LAUNCH_PLAN_SCHEMA
~~~


Binding: `lightbulb.gtm_primitives.OMNICHANNEL_PRODUCT_LAUNCH_PLAN_SCHEMA` → `lightbulb.gtm_primitives.OMNICHANNEL_PRODUCT_LAUNCH_PLAN_SCHEMA`.

Source: `lightbulb/gtm_primitives.py:50`.

### `lightbulb.OMNICHANNEL_PRODUCT_LAUNCH_PRIMITIVE_REF`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import OMNICHANNEL_PRODUCT_LAUNCH_PRIMITIVE_REF
~~~


Binding: `lightbulb.gtm_primitives.OMNICHANNEL_PRODUCT_LAUNCH_PRIMITIVE_REF` → `lightbulb.gtm_primitives.OMNICHANNEL_PRODUCT_LAUNCH_PRIMITIVE_REF`.

Source: `lightbulb/gtm_primitives.py:51`.

### `lightbulb.PRODUCT_LAUNCH_CONNECTOR_ACCOUNT_BINDING_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PRODUCT_LAUNCH_CONNECTOR_ACCOUNT_BINDING_SCHEMA
~~~


Binding: `lightbulb.gtm_primitives.PRODUCT_LAUNCH_CONNECTOR_ACCOUNT_BINDING_SCHEMA` → `lightbulb.gtm_primitives.PRODUCT_LAUNCH_CONNECTOR_ACCOUNT_BINDING_SCHEMA`.

Source: `lightbulb/gtm_primitives.py:55`.

### `lightbulb.PRODUCT_LAUNCH_PORTFOLIO_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PRODUCT_LAUNCH_PORTFOLIO_SCHEMA
~~~


Binding: `lightbulb.gtm_primitives.PRODUCT_LAUNCH_PORTFOLIO_SCHEMA` → `lightbulb.gtm_primitives.PRODUCT_LAUNCH_PORTFOLIO_SCHEMA`.

Source: `lightbulb/gtm_primitives.py:53`.

### `lightbulb.PRODUCT_LAUNCH_ITERATION_EVALUATION_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PRODUCT_LAUNCH_ITERATION_EVALUATION_SCHEMA
~~~


Binding: `lightbulb.gtm_primitives.PRODUCT_LAUNCH_ITERATION_EVALUATION_SCHEMA` → `lightbulb.gtm_primitives.PRODUCT_LAUNCH_ITERATION_EVALUATION_SCHEMA`.

Source: `lightbulb/gtm_primitives.py:58`.

### `lightbulb.PRODUCT_LAUNCH_RECEIPT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PRODUCT_LAUNCH_RECEIPT_SCHEMA
~~~


Binding: `lightbulb.gtm_primitives.PRODUCT_LAUNCH_RECEIPT_SCHEMA` → `lightbulb.gtm_primitives.PRODUCT_LAUNCH_RECEIPT_SCHEMA`.

Source: `lightbulb/gtm_primitives.py:54`.

### `lightbulb.PRODUCT_LAUNCH_SHARD_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PRODUCT_LAUNCH_SHARD_SCHEMA
~~~


Binding: `lightbulb.gtm_primitives.PRODUCT_LAUNCH_SHARD_SCHEMA` → `lightbulb.gtm_primitives.PRODUCT_LAUNCH_SHARD_SCHEMA`.

Source: `lightbulb/gtm_primitives.py:52`.

### `lightbulb.AnalyticsFinding`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import AnalyticsFinding
~~~


Binding: `lightbulb.gtm_primitives.AnalyticsFinding` → `lightbulb.gtm_primitives.AnalyticsFinding`.

Source: `lightbulb/gtm_primitives.py:1087`.

### `lightbulb.AnalyticsSnapshot`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import AnalyticsSnapshot
~~~


Binding: `lightbulb.gtm_primitives.AnalyticsSnapshot` → `lightbulb.gtm_primitives.AnalyticsSnapshot`.

Source: `lightbulb/gtm_primitives.py:523`.

### `lightbulb.CampaignMaterializationDisposition`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CampaignMaterializationDisposition
~~~


Binding: `lightbulb.gtm_primitives.CampaignMaterializationDisposition` → `lightbulb.gtm_primitives.CampaignMaterializationDisposition`.

Source: `lightbulb/gtm_primitives.py:1156`.

### `lightbulb.ChannelPriority`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ChannelPriority
~~~


Binding: `lightbulb.gtm_primitives.ChannelPriority` → `lightbulb.gtm_primitives.ChannelPriority`.

Source: `lightbulb/gtm_primitives.py:1111`.

### `lightbulb.FacebookPublishArguments`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import FacebookPublishArguments
~~~


Binding: `lightbulb.gtm_primitives.FacebookPublishArguments` → `lightbulb.gtm_primitives.FacebookPublishArguments`.

Source: `lightbulb/gtm_primitives.py:826`.

### `lightbulb.HubSpotCampaignContainerArguments`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import HubSpotCampaignContainerArguments
~~~


Binding: `lightbulb.gtm_primitives.HubSpotCampaignContainerArguments` → `lightbulb.gtm_primitives.HubSpotCampaignContainerArguments`.

Source: `lightbulb/gtm_primitives.py:811`.

### `lightbulb.InstagramPublishArguments`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import InstagramPublishArguments
~~~


Binding: `lightbulb.gtm_primitives.InstagramPublishArguments` → `lightbulb.gtm_primitives.InstagramPublishArguments`.

Source: `lightbulb/gtm_primitives.py:833`.

### `lightbulb.LandingReadinessArguments`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import LandingReadinessArguments
~~~


Binding: `lightbulb.gtm_primitives.LandingReadinessArguments` → `lightbulb.gtm_primitives.LandingReadinessArguments`.

Source: `lightbulb/gtm_primitives.py:787`.

### `lightbulb.LaunchMoney`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import LaunchMoney
~~~


Binding: `lightbulb.gtm_primitives.LaunchMoney` → `lightbulb.gtm_primitives.LaunchMoney`.

Source: `lightbulb/gtm_primitives.py:320`.

### `lightbulb.LaunchOptimizationPolicy`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import LaunchOptimizationPolicy
~~~


Binding: `lightbulb.gtm_primitives.LaunchOptimizationPolicy` → `lightbulb.gtm_primitives.LaunchOptimizationPolicy`.

Source: `lightbulb/gtm_primitives.py:649`.

### `lightbulb.LaunchProductBrief`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import LaunchProductBrief
~~~


Binding: `lightbulb.gtm_primitives.LaunchProductBrief` → `lightbulb.gtm_primitives.LaunchProductBrief`.

Source: `lightbulb/gtm_primitives.py:337`.

### `lightbulb.LaunchVariant`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import LaunchVariant
~~~


Binding: `lightbulb.gtm_primitives.LaunchVariant` → `lightbulb.gtm_primitives.LaunchVariant`.

Source: `lightbulb/gtm_primitives.py:330`.

### `lightbulb.LinkedInPublishArguments`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import LinkedInPublishArguments
~~~


Binding: `lightbulb.gtm_primitives.LinkedInPublishArguments` → `lightbulb.gtm_primitives.LinkedInPublishArguments`.

Source: `lightbulb/gtm_primitives.py:840`.

### `lightbulb.NormalizedPerformanceMetrics`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import NormalizedPerformanceMetrics
~~~


Binding: `lightbulb.gtm_primitives.NormalizedPerformanceMetrics` → `lightbulb.gtm_primitives.NormalizedPerformanceMetrics`.

Source: `lightbulb/gtm_primitives.py:472`.

### `lightbulb.OmnichannelProductLaunchPlan`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import OmnichannelProductLaunchPlan
~~~


Binding: `lightbulb.gtm_primitives.OmnichannelProductLaunchPlan` → `lightbulb.gtm_primitives.OmnichannelProductLaunchPlan`.

Source: `lightbulb/gtm_primitives.py:1507`.

### `lightbulb.OmnichannelProductLaunchValidationError`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import OmnichannelProductLaunchValidationError
~~~


Binding: `lightbulb.gtm_primitives.OmnichannelProductLaunchValidationError` → `lightbulb.gtm_primitives.OmnichannelProductLaunchValidationError`.

Source: `lightbulb/gtm_primitives.py:221`.

### `lightbulb.PlanOmnichannelProductLaunchInput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PlanOmnichannelProductLaunchInput
~~~


Binding: `lightbulb.gtm_primitives.PlanOmnichannelProductLaunchInput` → `lightbulb.gtm_primitives.PlanOmnichannelProductLaunchInput`.

Source: `lightbulb/gtm_primitives.py:671`.

### `lightbulb.PlanOmnichannelProductLaunchPrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PlanOmnichannelProductLaunchPrimitive
~~~


Binding: `lightbulb.gtm_primitives.PlanOmnichannelProductLaunchPrimitive` → `lightbulb.gtm_primitives.PlanOmnichannelProductLaunchPrimitive`.

Source: `lightbulb/gtm_primitives.py:3927`.

### `lightbulb.ProductLaunchCapabilityGap`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProductLaunchCapabilityGap
~~~


Binding: `lightbulb.gtm_primitives.ProductLaunchCapabilityGap` → `lightbulb.gtm_primitives.ProductLaunchCapabilityGap`.

Source: `lightbulb/gtm_primitives.py:1144`.

### `lightbulb.ProductLaunchConnectorAccountBinding`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProductLaunchConnectorAccountBinding
~~~


Binding: `lightbulb.gtm_primitives.ProductLaunchConnectorAccountBinding` → `lightbulb.gtm_primitives.ProductLaunchConnectorAccountBinding`.

Source: `lightbulb/gtm_primitives.py:607`.

### `lightbulb.ProductLaunchEffectBoundary`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProductLaunchEffectBoundary
~~~


Binding: `lightbulb.gtm_primitives.ProductLaunchEffectBoundary` → `lightbulb.gtm_primitives.ProductLaunchEffectBoundary`.

Source: `lightbulb/gtm_primitives.py:1498`.

### `lightbulb.ProductLaunchEvidenceScope`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProductLaunchEvidenceScope
~~~


Binding: `lightbulb.gtm_primitives.ProductLaunchEvidenceScope` → `lightbulb.gtm_primitives.ProductLaunchEvidenceScope`.

Source: `lightbulb/gtm_primitives.py:585`.

### `lightbulb.ProductLaunchEvaluationLoop`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProductLaunchEvaluationLoop
~~~


Binding: `lightbulb.gtm_primitives.ProductLaunchEvaluationLoop` → `lightbulb.gtm_primitives.ProductLaunchEvaluationLoop`.

Source: `lightbulb/gtm_primitives.py:1421`.

### `lightbulb.ProductLaunchOperation`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProductLaunchOperation
~~~


Binding: `lightbulb.gtm_primitives.ProductLaunchOperation` → `lightbulb.gtm_primitives.ProductLaunchOperation`.

Source: `lightbulb/gtm_primitives.py:885`.

### `lightbulb.ProductLaunchInputBinding`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProductLaunchInputBinding
~~~


Binding: `lightbulb.gtm_primitives.ProductLaunchInputBinding` → `lightbulb.gtm_primitives.ProductLaunchInputBinding`.

Source: `lightbulb/gtm_primitives.py:879`.

### `lightbulb.ProductLaunchIterationEvaluation`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProductLaunchIterationEvaluation
~~~


Binding: `lightbulb.gtm_primitives.ProductLaunchIterationEvaluation` → `lightbulb.gtm_primitives.ProductLaunchIterationEvaluation`.

Source: `lightbulb/gtm_primitives.py:1326`.

### `lightbulb.ProductLaunchPortfolioPlan`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProductLaunchPortfolioPlan
~~~


Binding: `lightbulb.gtm_primitives.ProductLaunchPortfolioPlan` → `lightbulb.gtm_primitives.ProductLaunchPortfolioPlan`.

Source: `lightbulb/gtm_primitives.py:3700`.

### `lightbulb.ProductLaunchScaleContract`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProductLaunchScaleContract
~~~


Binding: `lightbulb.gtm_primitives.ProductLaunchScaleContract` → `lightbulb.gtm_primitives.ProductLaunchScaleContract`.

Source: `lightbulb/gtm_primitives.py:1474`.

### `lightbulb.ProductLaunchReceipt`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProductLaunchReceipt
~~~


Binding: `lightbulb.gtm_primitives.ProductLaunchReceipt` → `lightbulb.gtm_primitives.ProductLaunchReceipt`.

Source: `lightbulb/gtm_primitives.py:1195`.

### `lightbulb.ProductLaunchShard`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProductLaunchShard
~~~


Binding: `lightbulb.gtm_primitives.ProductLaunchShard` → `lightbulb.gtm_primitives.ProductLaunchShard`.

Source: `lightbulb/gtm_primitives.py:3623`.

### `lightbulb.RequiredLaunchReceipt`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import RequiredLaunchReceipt
~~~


Binding: `lightbulb.gtm_primitives.RequiredLaunchReceipt` → `lightbulb.gtm_primitives.RequiredLaunchReceipt`.

Source: `lightbulb/gtm_primitives.py:1165`.

### `lightbulb.SalesCampaignBrief`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SalesCampaignBrief
~~~


Binding: `lightbulb.gtm_primitives.SalesCampaignBrief` → `lightbulb.gtm_primitives.SalesCampaignBrief`.

Source: `lightbulb/gtm_primitives.py:397`.

### `lightbulb.SalesTouch`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SalesTouch
~~~


Binding: `lightbulb.gtm_primitives.SalesTouch` → `lightbulb.gtm_primitives.SalesTouch`.

Source: `lightbulb/gtm_primitives.py:390`.

### `lightbulb.ScopedProductLaunchJob`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ScopedProductLaunchJob
~~~


Binding: `lightbulb.gtm_primitives.ScopedProductLaunchJob` → `lightbulb.gtm_primitives.ScopedProductLaunchJob`.

Source: `lightbulb/gtm_primitives.py:3599`.

### `lightbulb.ShopifyActivateProductArguments`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ShopifyActivateProductArguments
~~~


Binding: `lightbulb.gtm_primitives.ShopifyActivateProductArguments` → `lightbulb.gtm_primitives.ShopifyActivateProductArguments`.

Source: `lightbulb/gtm_primitives.py:782`.

### `lightbulb.ShopifyDraftProductArguments`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ShopifyDraftProductArguments
~~~


Binding: `lightbulb.gtm_primitives.ShopifyDraftProductArguments` → `lightbulb.gtm_primitives.ShopifyDraftProductArguments`.

Source: `lightbulb/gtm_primitives.py:747`.

### `lightbulb.ShopifyPublishProductArguments`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ShopifyPublishProductArguments
~~~


Binding: `lightbulb.gtm_primitives.ShopifyPublishProductArguments` → `lightbulb.gtm_primitives.ShopifyPublishProductArguments`.

Source: `lightbulb/gtm_primitives.py:769`.

### `lightbulb.SocialPostDraft`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SocialPostDraft
~~~


Binding: `lightbulb.gtm_primitives.SocialPostDraft` → `lightbulb.gtm_primitives.SocialPostDraft`.

Source: `lightbulb/gtm_primitives.py:439`.

### `lightbulb.compile_product_launch_portfolio`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import compile_product_launch_portfolio
~~~


Binding: `lightbulb.gtm_primitives.compile_product_launch_portfolio` → `lightbulb.gtm_primitives.compile_product_launch_portfolio`.

Source: `lightbulb/gtm_primitives.py:3809`.

### `lightbulb.create_product_launch_evaluation_loop`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import create_product_launch_evaluation_loop
~~~


Binding: `lightbulb.gtm_primitives.create_product_launch_evaluation_loop` → `lightbulb.gtm_primitives.create_product_launch_evaluation_loop`.

Source: `lightbulb/gtm_primitives.py:3029`.

### `lightbulb.evaluate_product_launch_iteration`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import evaluate_product_launch_iteration
~~~


Binding: `lightbulb.gtm_primitives.evaluate_product_launch_iteration` → `lightbulb.gtm_primitives.evaluate_product_launch_iteration`.

Source: `lightbulb/gtm_primitives.py:3441`.

### `lightbulb.mint_product_launch_analytics_snapshot`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import mint_product_launch_analytics_snapshot
~~~


Binding: `lightbulb.gtm_primitives.mint_product_launch_analytics_snapshot` → `lightbulb.gtm_primitives.mint_product_launch_analytics_snapshot`.

Source: `lightbulb/gtm_primitives.py:1998`.

### `lightbulb.mint_product_launch_connector_account_binding`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import mint_product_launch_connector_account_binding
~~~


Binding: `lightbulb.gtm_primitives.mint_product_launch_connector_account_binding` → `lightbulb.gtm_primitives.mint_product_launch_connector_account_binding`.

Source: `lightbulb/gtm_primitives.py:1855`.

### `lightbulb.mint_product_launch_receipt`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import mint_product_launch_receipt
~~~


Binding: `lightbulb.gtm_primitives.mint_product_launch_receipt` → `lightbulb.gtm_primitives.mint_product_launch_receipt`.

Source: `lightbulb/gtm_primitives.py:3176`.

### `lightbulb.plan_omnichannel_product_launch`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import plan_omnichannel_product_launch
~~~


Binding: `lightbulb.gtm_primitives.plan_omnichannel_product_launch` → `lightbulb.gtm_primitives.plan_omnichannel_product_launch`.

Source: `lightbulb/gtm_primitives.py:2880`.

### `lightbulb.verify_product_launch_plan`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import verify_product_launch_plan
~~~


Binding: `lightbulb.gtm_primitives.verify_product_launch_plan` → `lightbulb.gtm_primitives.verify_product_launch_plan`.

Source: `lightbulb/gtm_primitives.py:3149`.

### `lightbulb.verify_product_launch_receipts`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import verify_product_launch_receipts
~~~


Binding: `lightbulb.gtm_primitives.verify_product_launch_receipts` → `lightbulb.gtm_primitives.verify_product_launch_receipts`.

Source: `lightbulb/gtm_primitives.py:3275`.

### `lightbulb.PRODUCT_LAUNCH_APPROVAL_GRANT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PRODUCT_LAUNCH_APPROVAL_GRANT_SCHEMA
~~~


Binding: `lightbulb.gtm_materializer.PRODUCT_LAUNCH_APPROVAL_GRANT_SCHEMA` → `lightbulb.gtm_materializer.PRODUCT_LAUNCH_APPROVAL_GRANT_SCHEMA`.

Source: `lightbulb/gtm_materializer.py:55`.

### `lightbulb.PRODUCT_LAUNCH_MATERIALIZATION_RESULT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PRODUCT_LAUNCH_MATERIALIZATION_RESULT_SCHEMA
~~~


Binding: `lightbulb.gtm_materializer.PRODUCT_LAUNCH_MATERIALIZATION_RESULT_SCHEMA` → `lightbulb.gtm_materializer.PRODUCT_LAUNCH_MATERIALIZATION_RESULT_SCHEMA`.

Source: `lightbulb/gtm_materializer.py:56`.

### `lightbulb.MaterializationStatus`

value. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import MaterializationStatus
~~~


Binding: `lightbulb.gtm_materializer.MaterializationStatus` → `lightbulb.gtm_materializer.MaterializationStatus`.

Source: `lightbulb/gtm_materializer.py:65`.

### `lightbulb.ProductLaunchApprovalGrant`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProductLaunchApprovalGrant
~~~


Binding: `lightbulb.gtm_materializer.ProductLaunchApprovalGrant` → `lightbulb.gtm_materializer.ProductLaunchApprovalGrant`.

Source: `lightbulb/gtm_materializer.py:85`.

### `lightbulb.ProductLaunchMaterializationResult`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProductLaunchMaterializationResult
~~~


Binding: `lightbulb.gtm_materializer.ProductLaunchMaterializationResult` → `lightbulb.gtm_materializer.ProductLaunchMaterializationResult`.

Source: `lightbulb/gtm_materializer.py:125`.

### `lightbulb.bind_product_launch_operation_approval`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import bind_product_launch_operation_approval
~~~


Binding: `lightbulb.gtm_materializer.bind_product_launch_operation_approval` → `lightbulb.gtm_materializer.bind_product_launch_operation_approval`.

Source: `lightbulb/gtm_materializer.py:407`.

### `lightbulb.bind_shopify_draft_product_approval`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import bind_shopify_draft_product_approval
~~~


Binding: `lightbulb.gtm_materializer.bind_shopify_draft_product_approval` → `lightbulb.gtm_materializer.bind_shopify_draft_product_approval`.

Source: `lightbulb/gtm_materializer.py:474`.

### `lightbulb.materialize_shopify_draft_product`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import materialize_shopify_draft_product
~~~


Binding: `lightbulb.gtm_materializer.materialize_shopify_draft_product` → `lightbulb.gtm_materializer.materialize_shopify_draft_product`.

Source: `lightbulb/gtm_materializer.py:642`.

### `lightbulb.LANDING_READINESS_OBSERVATION_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import LANDING_READINESS_OBSERVATION_SCHEMA
~~~


Binding: `lightbulb.gtm_shopify_launch.LANDING_READINESS_OBSERVATION_SCHEMA` → `lightbulb.gtm_shopify_launch.LANDING_READINESS_OBSERVATION_SCHEMA`.

Source: `lightbulb/gtm_shopify_launch.py:72`.

### `lightbulb.LANDING_READINESS_REQUEST_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import LANDING_READINESS_REQUEST_SCHEMA
~~~


Binding: `lightbulb.gtm_shopify_launch.LANDING_READINESS_REQUEST_SCHEMA` → `lightbulb.gtm_shopify_launch.LANDING_READINESS_REQUEST_SCHEMA`.

Source: `lightbulb/gtm_shopify_launch.py:71`.

### `lightbulb.SHOPIFY_PRODUCT_READINESS_PAYLOAD_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SHOPIFY_PRODUCT_READINESS_PAYLOAD_SCHEMA
~~~


Binding: `lightbulb.gtm_shopify_launch.SHOPIFY_PRODUCT_READINESS_PAYLOAD_SCHEMA` → `lightbulb.gtm_shopify_launch.SHOPIFY_PRODUCT_READINESS_PAYLOAD_SCHEMA`.

Source: `lightbulb/gtm_shopify_launch.py:73`.

### `lightbulb.SHOPIFY_LAUNCH_OPERATION_RESULT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SHOPIFY_LAUNCH_OPERATION_RESULT_SCHEMA
~~~


Binding: `lightbulb.gtm_shopify_launch.SHOPIFY_LAUNCH_OPERATION_RESULT_SCHEMA` → `lightbulb.gtm_shopify_launch.SHOPIFY_LAUNCH_OPERATION_RESULT_SCHEMA`.

Source: `lightbulb/gtm_shopify_launch.py:74`.

### `lightbulb.SHOPIFY_LAUNCH_RUN_RESULT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SHOPIFY_LAUNCH_RUN_RESULT_SCHEMA
~~~


Binding: `lightbulb.gtm_shopify_launch.SHOPIFY_LAUNCH_RUN_RESULT_SCHEMA` → `lightbulb.gtm_shopify_launch.SHOPIFY_LAUNCH_RUN_RESULT_SCHEMA`.

Source: `lightbulb/gtm_shopify_launch.py:75`.

### `lightbulb.ConnectorLandingReadinessVerifier`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ConnectorLandingReadinessVerifier
~~~


Binding: `lightbulb.gtm_shopify_launch.ConnectorLandingReadinessVerifier` → `lightbulb.gtm_shopify_launch.ConnectorLandingReadinessVerifier`.

Source: `lightbulb/gtm_shopify_launch.py:383`.

### `lightbulb.LandingReadinessObservation`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import LandingReadinessObservation
~~~


Binding: `lightbulb.gtm_shopify_launch.LandingReadinessObservation` → `lightbulb.gtm_shopify_launch.LandingReadinessObservation`.

Source: `lightbulb/gtm_shopify_launch.py:224`.

### `lightbulb.LandingReadinessRequest`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import LandingReadinessRequest
~~~


Binding: `lightbulb.gtm_shopify_launch.LandingReadinessRequest` → `lightbulb.gtm_shopify_launch.LandingReadinessRequest`.

Source: `lightbulb/gtm_shopify_launch.py:141`.

### `lightbulb.LandingReadinessVerifier`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import LandingReadinessVerifier
~~~


Binding: `lightbulb.gtm_shopify_launch.LandingReadinessVerifier` → `lightbulb.gtm_shopify_launch.LandingReadinessVerifier`.

Source: `lightbulb/gtm_shopify_launch.py:374`.

### `lightbulb.ShopifyLaunchOperationResult`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ShopifyLaunchOperationResult
~~~


Binding: `lightbulb.gtm_shopify_launch.ShopifyLaunchOperationResult` → `lightbulb.gtm_shopify_launch.ShopifyLaunchOperationResult`.

Source: `lightbulb/gtm_shopify_launch.py:526`.

### `lightbulb.ShopifyLaunchOperationStatus`

value. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ShopifyLaunchOperationStatus
~~~


Binding: `lightbulb.gtm_shopify_launch.ShopifyLaunchOperationStatus` → `lightbulb.gtm_shopify_launch.ShopifyLaunchOperationStatus`.

Source: `lightbulb/gtm_shopify_launch.py:98`.

### `lightbulb.ShopifyLaunchRunResult`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ShopifyLaunchRunResult
~~~


Binding: `lightbulb.gtm_shopify_launch.ShopifyLaunchRunResult` → `lightbulb.gtm_shopify_launch.ShopifyLaunchRunResult`.

Source: `lightbulb/gtm_shopify_launch.py:599`.

### `lightbulb.ShopifyLaunchStatus`

value. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ShopifyLaunchStatus
~~~


Binding: `lightbulb.gtm_shopify_launch.ShopifyLaunchStatus` → `lightbulb.gtm_shopify_launch.ShopifyLaunchStatus`.

Source: `lightbulb/gtm_shopify_launch.py:91`.

### `lightbulb.ShopifyProductReadinessPayload`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ShopifyProductReadinessPayload
~~~


Binding: `lightbulb.gtm_shopify_launch.ShopifyProductReadinessPayload` → `lightbulb.gtm_shopify_launch.ShopifyProductReadinessPayload`.

Source: `lightbulb/gtm_shopify_launch.py:285`.

### `lightbulb.run_shopify_product_launch`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import run_shopify_product_launch
~~~


Binding: `lightbulb.gtm_shopify_launch.run_shopify_product_launch` → `lightbulb.gtm_shopify_launch.run_shopify_product_launch`.

Source: `lightbulb/gtm_shopify_launch.py:1481`.

### `lightbulb.SOFTWARE_FACTORY_PROFIT_LOOP_RESULT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SOFTWARE_FACTORY_PROFIT_LOOP_RESULT_SCHEMA
~~~


Binding: `lightbulb.software_factory_runtime.SOFTWARE_FACTORY_PROFIT_LOOP_RESULT_SCHEMA` → `lightbulb.software_factory_runtime.SOFTWARE_FACTORY_PROFIT_LOOP_RESULT_SCHEMA`.

Source: `lightbulb/software_factory_runtime.py:65`.

### `lightbulb.SOFTWARE_FACTORY_RECOVERY_LOOP_RESULT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SOFTWARE_FACTORY_RECOVERY_LOOP_RESULT_SCHEMA
~~~


Binding: `lightbulb.software_factory_runtime.SOFTWARE_FACTORY_RECOVERY_LOOP_RESULT_SCHEMA` → `lightbulb.software_factory_runtime.SOFTWARE_FACTORY_RECOVERY_LOOP_RESULT_SCHEMA`.

Source: `lightbulb/software_factory_runtime.py:62`.

### `lightbulb.SOFTWARE_FACTORY_STOREFRONT_LOOP_RESULT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SOFTWARE_FACTORY_STOREFRONT_LOOP_RESULT_SCHEMA
~~~


Binding: `lightbulb.software_factory_runtime.SOFTWARE_FACTORY_STOREFRONT_LOOP_RESULT_SCHEMA` → `lightbulb.software_factory_runtime.SOFTWARE_FACTORY_STOREFRONT_LOOP_RESULT_SCHEMA`.

Source: `lightbulb/software_factory_runtime.py:59`.

### `lightbulb.LightbulbSoftwareFactoryRuntime`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import LightbulbSoftwareFactoryRuntime
~~~


Binding: `lightbulb.software_factory_runtime.LightbulbSoftwareFactoryRuntime` → `lightbulb.software_factory_runtime.LightbulbSoftwareFactoryRuntime`.

Source: `lightbulb/software_factory_runtime.py:324`.

### `lightbulb.ProfitLoopStatus`

value. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProfitLoopStatus
~~~


Binding: `lightbulb.software_factory_runtime.ProfitLoopStatus` → `lightbulb.software_factory_runtime.ProfitLoopStatus`.

Source: `lightbulb/software_factory_runtime.py:79`.

### `lightbulb.ProfitObservationRoute`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProfitObservationRoute
~~~


Binding: `lightbulb.software_factory_runtime.ProfitObservationRoute` → `lightbulb.software_factory_runtime.ProfitObservationRoute`.

Source: `lightbulb/software_factory_runtime.py:116`.

### `lightbulb.ProfitWorkflowLoopResult`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProfitWorkflowLoopResult
~~~


Binding: `lightbulb.software_factory_runtime.ProfitWorkflowLoopResult` → `lightbulb.software_factory_runtime.ProfitWorkflowLoopResult`.

Source: `lightbulb/software_factory_runtime.py:271`.

### `lightbulb.RecoveryLoopResult`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import RecoveryLoopResult
~~~


Binding: `lightbulb.software_factory_runtime.RecoveryLoopResult` → `lightbulb.software_factory_runtime.RecoveryLoopResult`.

Source: `lightbulb/software_factory_runtime.py:218`.

### `lightbulb.RecoveryLoopStatus`

value. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import RecoveryLoopStatus
~~~


Binding: `lightbulb.software_factory_runtime.RecoveryLoopStatus` → `lightbulb.software_factory_runtime.RecoveryLoopStatus`.

Source: `lightbulb/software_factory_runtime.py:74`.

### `lightbulb.StorefrontLaunchLoopResult`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import StorefrontLaunchLoopResult
~~~


Binding: `lightbulb.software_factory_runtime.StorefrontLaunchLoopResult` → `lightbulb.software_factory_runtime.StorefrontLaunchLoopResult`.

Source: `lightbulb/software_factory_runtime.py:166`.

### `lightbulb.StorefrontLoopStatus`

value. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import StorefrontLoopStatus
~~~


Binding: `lightbulb.software_factory_runtime.StorefrontLoopStatus` → `lightbulb.software_factory_runtime.StorefrontLoopStatus`.

Source: `lightbulb/software_factory_runtime.py:69`.

### `lightbulb.StorefrontObservationRoute`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import StorefrontObservationRoute
~~~


Binding: `lightbulb.software_factory_runtime.StorefrontObservationRoute` → `lightbulb.software_factory_runtime.StorefrontObservationRoute`.

Source: `lightbulb/software_factory_runtime.py:97`.

### `lightbulb.PROFIT_EXECUTABLE_PRIMITIVES`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROFIT_EXECUTABLE_PRIMITIVES
~~~


Binding: `lightbulb.profit_primitives.PROFIT_EXECUTABLE_PRIMITIVES` → `lightbulb.profit_primitives.PROFIT_EXECUTABLE_PRIMITIVES`.

Source: `lightbulb/profit_primitives.py:270`.

### `lightbulb.PROFIT_ACTION_EXECUTION_RECEIPT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROFIT_ACTION_EXECUTION_RECEIPT_SCHEMA
~~~


Binding: `lightbulb.profit_workflow_blueprints.PROFIT_ACTION_EXECUTION_RECEIPT_SCHEMA` → `lightbulb.profit_workflow_blueprints.PROFIT_ACTION_EXECUTION_RECEIPT_SCHEMA`.

Source: `lightbulb/profit_workflow_blueprints.py:31`.

### `lightbulb.PROFIT_FLYWHEEL_PLAN_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROFIT_FLYWHEEL_PLAN_SCHEMA
~~~


Binding: `lightbulb.profit_workflow_blueprints.PROFIT_FLYWHEEL_PLAN_SCHEMA` → `lightbulb.profit_workflow_blueprints.PROFIT_FLYWHEEL_PLAN_SCHEMA`.

Source: `lightbulb/profit_workflow_blueprints.py:30`.

### `lightbulb.PROFIT_OUTCOME_EVIDENCE_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROFIT_OUTCOME_EVIDENCE_SCHEMA
~~~


Binding: `lightbulb.profit_workflow_blueprints.PROFIT_OUTCOME_EVIDENCE_SCHEMA` → `lightbulb.profit_workflow_blueprints.PROFIT_OUTCOME_EVIDENCE_SCHEMA`.

Source: `lightbulb/profit_workflow_blueprints.py:32`.

### `lightbulb.PROFIT_WORKFLOW_DEFINITIONS`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROFIT_WORKFLOW_DEFINITIONS
~~~


Binding: `lightbulb.profit_workflow_blueprints.PROFIT_WORKFLOW_DEFINITIONS` → `lightbulb.profit_workflow_blueprints.PROFIT_WORKFLOW_DEFINITIONS`.

Source: `lightbulb/profit_workflow_blueprints.py:378`.

### `lightbulb.PROFIT_WORKFLOW_EVALUATION_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROFIT_WORKFLOW_EVALUATION_SCHEMA
~~~


Binding: `lightbulb.profit_workflow_blueprints.PROFIT_WORKFLOW_EVALUATION_SCHEMA` → `lightbulb.profit_workflow_blueprints.PROFIT_WORKFLOW_EVALUATION_SCHEMA`.

Source: `lightbulb/profit_workflow_blueprints.py:33`.

### `lightbulb.PROFIT_WORKFLOW_PLAN_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROFIT_WORKFLOW_PLAN_SCHEMA
~~~


Binding: `lightbulb.profit_workflow_blueprints.PROFIT_WORKFLOW_PLAN_SCHEMA` → `lightbulb.profit_workflow_blueprints.PROFIT_WORKFLOW_PLAN_SCHEMA`.

Source: `lightbulb/profit_workflow_blueprints.py:29`.

### `lightbulb.CapabilityAvailability`

value. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CapabilityAvailability
~~~


Binding: `lightbulb.profit_workflow_blueprints.CapabilityAvailability` → `lightbulb.profit_workflow_blueprints.CapabilityAvailability`.

Source: `lightbulb/profit_workflow_blueprints.py:230`.

### `lightbulb.CapabilityRef`

value. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CapabilityRef
~~~


Binding: `lightbulb.profit_workflow_blueprints.CapabilityRef` → `lightbulb.profit_workflow_blueprints.CapabilityRef`.

Source: `lightbulb/profit_workflow_blueprints.py:165`.

### `lightbulb.CurrencyCode`

value. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CurrencyCode
~~~


Binding: `lightbulb.profit_workflow_blueprints.CurrencyCode` → `lightbulb.profit_workflow_blueprints.CurrencyCode`.

Source: `lightbulb/profit_workflow_blueprints.py:167`.

### `lightbulb.ExecutionKind`

value. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ExecutionKind
~~~


Binding: `lightbulb.profit_workflow_blueprints.ExecutionKind` → `lightbulb.profit_workflow_blueprints.ExecutionKind`.

Source: `lightbulb/profit_workflow_blueprints.py:224`.

### `lightbulb.GovernedProfitAction`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GovernedProfitAction
~~~


Binding: `lightbulb.profit_workflow_runtime.GovernedProfitAction` → `lightbulb.profit_workflow_runtime.GovernedProfitAction`.

Source: `lightbulb/profit_workflow_runtime.py:901`.

### `lightbulb.MetricUnit`

value. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import MetricUnit
~~~


Binding: `lightbulb.profit_workflow_blueprints.MetricUnit` → `lightbulb.profit_workflow_blueprints.MetricUnit`.

Source: `lightbulb/profit_workflow_blueprints.py:209`.

### `lightbulb.PlanProfitWorkflowInput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PlanProfitWorkflowInput
~~~


Binding: `lightbulb.profit_workflow_runtime.PlanProfitWorkflowInput` → `lightbulb.profit_workflow_runtime.PlanProfitWorkflowInput`.

Source: `lightbulb/profit_workflow_runtime.py:670`.

### `lightbulb.ProfitActionExecutionReceipt`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProfitActionExecutionReceipt
~~~


Binding: `lightbulb.profit_workflow_runtime.ProfitActionExecutionReceipt` → `lightbulb.profit_workflow_runtime.ProfitActionExecutionReceipt`.

Source: `lightbulb/profit_workflow_runtime.py:2129`.

### `lightbulb.ProfitActionParameter`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProfitActionParameter
~~~


Binding: `lightbulb.profit_workflow_runtime.ProfitActionParameter` → `lightbulb.profit_workflow_runtime.ProfitActionParameter`.

Source: `lightbulb/profit_workflow_runtime.py:546`.

### `lightbulb.ProfitBaselineSummary`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProfitBaselineSummary
~~~


Binding: `lightbulb.profit_workflow_runtime.ProfitBaselineSummary` → `lightbulb.profit_workflow_runtime.ProfitBaselineSummary`.

Source: `lightbulb/profit_workflow_runtime.py:827`.

### `lightbulb.ProfitCandidateDecision`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProfitCandidateDecision
~~~


Binding: `lightbulb.profit_workflow_runtime.ProfitCandidateDecision` → `lightbulb.profit_workflow_runtime.ProfitCandidateDecision`.

Source: `lightbulb/profit_workflow_runtime.py:864`.

### `lightbulb.ProfitCapabilityContract`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProfitCapabilityContract
~~~


Binding: `lightbulb.profit_workflow_blueprints.ProfitCapabilityContract` → `lightbulb.profit_workflow_blueprints.ProfitCapabilityContract`.

Source: `lightbulb/profit_workflow_blueprints.py:301`.

### `lightbulb.ProfitCapabilityGap`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProfitCapabilityGap
~~~


Binding: `lightbulb.profit_workflow_runtime.ProfitCapabilityGap` → `lightbulb.profit_workflow_runtime.ProfitCapabilityGap`.

Source: `lightbulb/profit_workflow_runtime.py:964`.

### `lightbulb.ProfitConnectorAccountBinding`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProfitConnectorAccountBinding
~~~


Binding: `lightbulb.profit_workflow_runtime.ProfitConnectorAccountBinding` → `lightbulb.profit_workflow_runtime.ProfitConnectorAccountBinding`.

Source: `lightbulb/profit_workflow_runtime.py:332`.

### `lightbulb.ProfitContributionLedger`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProfitContributionLedger
~~~


Binding: `lightbulb.profit_workflow_runtime.ProfitContributionLedger` → `lightbulb.profit_workflow_runtime.ProfitContributionLedger`.

Source: `lightbulb/profit_workflow_runtime.py:365`.

### `lightbulb.ProfitEffect`

value. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProfitEffect
~~~


Binding: `lightbulb.profit_workflow_blueprints.ProfitEffect` → `lightbulb.profit_workflow_blueprints.ProfitEffect`.

Source: `lightbulb/profit_workflow_blueprints.py:238`.

### `lightbulb.ProfitEffectBoundary`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProfitEffectBoundary
~~~


Binding: `lightbulb.profit_workflow_runtime.ProfitEffectBoundary` → `lightbulb.profit_workflow_runtime.ProfitEffectBoundary`.

Source: `lightbulb/profit_workflow_runtime.py:1018`.

### `lightbulb.ProfitEvaluationLoop`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProfitEvaluationLoop
~~~


Binding: `lightbulb.profit_workflow_runtime.ProfitEvaluationLoop` → `lightbulb.profit_workflow_runtime.ProfitEvaluationLoop`.

Source: `lightbulb/profit_workflow_runtime.py:971`.

### `lightbulb.ProfitEvidenceScope`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProfitEvidenceScope
~~~


Binding: `lightbulb.profit_workflow_runtime.ProfitEvidenceScope` → `lightbulb.profit_workflow_runtime.ProfitEvidenceScope`.

Source: `lightbulb/profit_workflow_runtime.py:766`.

### `lightbulb.ProfitFlywheelEdge`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProfitFlywheelEdge
~~~


Binding: `lightbulb.profit_workflow_runtime.ProfitFlywheelEdge` → `lightbulb.profit_workflow_runtime.ProfitFlywheelEdge`.

Source: `lightbulb/profit_workflow_runtime.py:2868`.

### `lightbulb.ProfitFlywheelNode`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProfitFlywheelNode
~~~


Binding: `lightbulb.profit_workflow_runtime.ProfitFlywheelNode` → `lightbulb.profit_workflow_runtime.ProfitFlywheelNode`.

Source: `lightbulb/profit_workflow_runtime.py:2875`.

### `lightbulb.ProfitFlywheelPlan`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProfitFlywheelPlan
~~~


Binding: `lightbulb.profit_workflow_runtime.ProfitFlywheelPlan` → `lightbulb.profit_workflow_runtime.ProfitFlywheelPlan`.

Source: `lightbulb/profit_workflow_runtime.py:2981`.

### `lightbulb.ProfitLeverCandidate`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProfitLeverCandidate
~~~


Binding: `lightbulb.profit_workflow_runtime.ProfitLeverCandidate` → `lightbulb.profit_workflow_runtime.ProfitLeverCandidate`.

Source: `lightbulb/profit_workflow_runtime.py:571`.

### `lightbulb.ProfitMetric`

value. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProfitMetric
~~~


Binding: `lightbulb.profit_workflow_blueprints.ProfitMetric` → `lightbulb.profit_workflow_blueprints.ProfitMetric`.

Source: `lightbulb/profit_workflow_blueprints.py:181`.

### `lightbulb.ProfitMetricEvidence`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProfitMetricEvidence
~~~


Binding: `lightbulb.profit_workflow_runtime.ProfitMetricEvidence` → `lightbulb.profit_workflow_runtime.ProfitMetricEvidence`.

Source: `lightbulb/profit_workflow_runtime.py:411`.

### `lightbulb.ProfitMetricFinding`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProfitMetricFinding
~~~


Binding: `lightbulb.profit_workflow_runtime.ProfitMetricFinding` → `lightbulb.profit_workflow_runtime.ProfitMetricFinding`.

Source: `lightbulb/profit_workflow_runtime.py:797`.

### `lightbulb.ProfitOptimizationPolicy`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProfitOptimizationPolicy
~~~


Binding: `lightbulb.profit_workflow_runtime.ProfitOptimizationPolicy` → `lightbulb.profit_workflow_runtime.ProfitOptimizationPolicy`.

Source: `lightbulb/profit_workflow_runtime.py:635`.

### `lightbulb.ProfitOutcomeEvidence`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProfitOutcomeEvidence
~~~


Binding: `lightbulb.profit_workflow_runtime.ProfitOutcomeEvidence` → `lightbulb.profit_workflow_runtime.ProfitOutcomeEvidence`.

Source: `lightbulb/profit_workflow_runtime.py:2191`.

### `lightbulb.ProfitScopeKeyRing`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProfitScopeKeyRing
~~~


Binding: `lightbulb.profit_workflow_blueprints.ProfitScopeKeyRing` → `lightbulb.profit_workflow_blueprints.ProfitScopeKeyRing`.

Source: `lightbulb/profit_workflow_blueprints.py:286`.

### `lightbulb.ProfitWorkflowDefinition`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProfitWorkflowDefinition
~~~


Binding: `lightbulb.profit_workflow_blueprints.ProfitWorkflowDefinition` → `lightbulb.profit_workflow_blueprints.ProfitWorkflowDefinition`.

Source: `lightbulb/profit_workflow_blueprints.py:310`.

### `lightbulb.ProfitWorkflowEvaluation`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProfitWorkflowEvaluation
~~~


Binding: `lightbulb.profit_workflow_runtime.ProfitWorkflowEvaluation` → `lightbulb.profit_workflow_runtime.ProfitWorkflowEvaluation`.

Source: `lightbulb/profit_workflow_runtime.py:2271`.

### `lightbulb.ProfitWorkflowId`

value. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProfitWorkflowId
~~~


Binding: `lightbulb.profit_workflow_blueprints.ProfitWorkflowId` → `lightbulb.profit_workflow_blueprints.ProfitWorkflowId`.

Source: `lightbulb/profit_workflow_blueprints.py:169`.

### `lightbulb.ProfitWorkflowPlan`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProfitWorkflowPlan
~~~


Binding: `lightbulb.profit_workflow_runtime.ProfitWorkflowPlan` → `lightbulb.profit_workflow_runtime.ProfitWorkflowPlan`.

Source: `lightbulb/profit_workflow_runtime.py:1034`.

### `lightbulb.ProfitWorkflowPrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProfitWorkflowPrimitive
~~~


Binding: `lightbulb.profit_primitives.ProfitWorkflowPrimitive` → `lightbulb.profit_primitives.ProfitWorkflowPrimitive`.

Source: `lightbulb/profit_primitives.py:191`.

### `lightbulb.ProfitWorkflowValidationError`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProfitWorkflowValidationError
~~~


Binding: `lightbulb.profit_workflow_blueprints.ProfitWorkflowValidationError` → `lightbulb.profit_workflow_blueprints.ProfitWorkflowValidationError`.

Source: `lightbulb/profit_workflow_blueprints.py:282`.

### `lightbulb.Provider`

value. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import Provider
~~~


Binding: `lightbulb.profit_workflow_blueprints.Provider` → `lightbulb.profit_workflow_blueprints.Provider`.

Source: `lightbulb/profit_workflow_blueprints.py:211`.

### `lightbulb.TargetDirection`

value. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import TargetDirection
~~~


Binding: `lightbulb.profit_workflow_blueprints.TargetDirection` → `lightbulb.profit_workflow_blueprints.TargetDirection`.

Source: `lightbulb/profit_workflow_blueprints.py:210`.

### `lightbulb.compile_profit_flywheel`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import compile_profit_flywheel
~~~


Binding: `lightbulb.profit_workflow_runtime.compile_profit_flywheel` → `lightbulb.profit_workflow_runtime.compile_profit_flywheel`.

Source: `lightbulb/profit_workflow_runtime.py:3076`.

### `lightbulb.evaluate_profit_workflow_iteration`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import evaluate_profit_workflow_iteration
~~~


Binding: `lightbulb.profit_workflow_runtime.evaluate_profit_workflow_iteration` → `lightbulb.profit_workflow_runtime.evaluate_profit_workflow_iteration`.

Source: `lightbulb/profit_workflow_runtime.py:2748`.

### `lightbulb.get_profit_workflow_definition`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import get_profit_workflow_definition
~~~


Binding: `lightbulb.profit_workflow_runtime.get_profit_workflow_definition` → `lightbulb.profit_workflow_runtime.get_profit_workflow_definition`.

Source: `lightbulb/profit_workflow_runtime.py:323`.

### `lightbulb.mint_profit_action_execution_receipt`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import mint_profit_action_execution_receipt
~~~


Binding: `lightbulb.profit_workflow_runtime.mint_profit_action_execution_receipt` → `lightbulb.profit_workflow_runtime.mint_profit_action_execution_receipt`.

Source: `lightbulb/profit_workflow_runtime.py:2349`.

### `lightbulb.mint_profit_connector_account_binding`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import mint_profit_connector_account_binding
~~~


Binding: `lightbulb.profit_workflow_runtime.mint_profit_connector_account_binding` → `lightbulb.profit_workflow_runtime.mint_profit_connector_account_binding`.

Source: `lightbulb/profit_workflow_runtime.py:1336`.

### `lightbulb.mint_profit_metric_evidence`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import mint_profit_metric_evidence
~~~


Binding: `lightbulb.profit_workflow_runtime.mint_profit_metric_evidence` → `lightbulb.profit_workflow_runtime.mint_profit_metric_evidence`.

Source: `lightbulb/profit_workflow_runtime.py:1408`.

### `lightbulb.mint_profit_outcome_evidence`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import mint_profit_outcome_evidence
~~~


Binding: `lightbulb.profit_workflow_runtime.mint_profit_outcome_evidence` → `lightbulb.profit_workflow_runtime.mint_profit_outcome_evidence`.

Source: `lightbulb/profit_workflow_runtime.py:2480`.

### `lightbulb.plan_profit_workflow`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import plan_profit_workflow
~~~


Binding: `lightbulb.profit_workflow_runtime.plan_profit_workflow` → `lightbulb.profit_workflow_runtime.plan_profit_workflow`.

Source: `lightbulb/profit_workflow_runtime.py:1943`.

### `lightbulb.profit_workflow_example_inputs`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import profit_workflow_example_inputs
~~~


Binding: `lightbulb.profit_primitives.profit_workflow_example_inputs` → `lightbulb.profit_primitives.profit_workflow_example_inputs`.

Source: `lightbulb/profit_primitives.py:275`.

### `lightbulb.verify_profit_workflow_evaluation`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import verify_profit_workflow_evaluation
~~~


Binding: `lightbulb.profit_workflow_runtime.verify_profit_workflow_evaluation` → `lightbulb.profit_workflow_runtime.verify_profit_workflow_evaluation`.

Source: `lightbulb/profit_workflow_runtime.py:2714`.

### `lightbulb.verify_profit_action_execution_receipt`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import verify_profit_action_execution_receipt
~~~


Binding: `lightbulb.profit_workflow_runtime.verify_profit_action_execution_receipt` → `lightbulb.profit_workflow_runtime.verify_profit_action_execution_receipt`.

Source: `lightbulb/profit_workflow_runtime.py:2459`.

### `lightbulb.verify_profit_workflow_plan`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import verify_profit_workflow_plan
~~~


Binding: `lightbulb.profit_workflow_runtime.verify_profit_workflow_plan` → `lightbulb.profit_workflow_runtime.verify_profit_workflow_plan`.

Source: `lightbulb/profit_workflow_runtime.py:2077`.

### `lightbulb.CHECKOUT_RECOVERY_SNAPSHOT_PAYLOAD_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CHECKOUT_RECOVERY_SNAPSHOT_PAYLOAD_SCHEMA
~~~


Binding: `lightbulb.observation_runtime.CHECKOUT_RECOVERY_SNAPSHOT_PAYLOAD_SCHEMA` → `lightbulb.observation_runtime.CHECKOUT_RECOVERY_SNAPSHOT_PAYLOAD_SCHEMA`.

Source: `lightbulb/observation_runtime.py:75`.

### `lightbulb.GOOGLE_ANALYTICS_PAYLOAD_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GOOGLE_ANALYTICS_PAYLOAD_SCHEMA
~~~


Binding: `lightbulb.observation_runtime.GOOGLE_ANALYTICS_PAYLOAD_SCHEMA` → `lightbulb.observation_runtime.GOOGLE_ANALYTICS_PAYLOAD_SCHEMA`.

Source: `lightbulb/observation_runtime.py:74`.

### `lightbulb.HOST_OBSERVATION_PROVENANCE_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import HOST_OBSERVATION_PROVENANCE_SCHEMA
~~~


Binding: `lightbulb.observation_runtime.HOST_OBSERVATION_PROVENANCE_SCHEMA` → `lightbulb.observation_runtime.HOST_OBSERVATION_PROVENANCE_SCHEMA`.

Source: `lightbulb/observation_runtime.py:77`.

### `lightbulb.HOST_OBSERVATION_READ_REQUEST_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import HOST_OBSERVATION_READ_REQUEST_SCHEMA
~~~


Binding: `lightbulb.observation_runtime.HOST_OBSERVATION_READ_REQUEST_SCHEMA` → `lightbulb.observation_runtime.HOST_OBSERVATION_READ_REQUEST_SCHEMA`.

Source: `lightbulb/observation_runtime.py:76`.

### `lightbulb.OBSERVATION_JOB_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import OBSERVATION_JOB_SCHEMA
~~~


Binding: `lightbulb.observation_runtime.OBSERVATION_JOB_SCHEMA` → `lightbulb.observation_runtime.OBSERVATION_JOB_SCHEMA`.

Source: `lightbulb/observation_runtime.py:69`.

### `lightbulb.OBSERVATION_READ_RECEIPT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import OBSERVATION_READ_RECEIPT_SCHEMA
~~~


Binding: `lightbulb.observation_runtime.OBSERVATION_READ_RECEIPT_SCHEMA` → `lightbulb.observation_runtime.OBSERVATION_READ_RECEIPT_SCHEMA`.

Source: `lightbulb/observation_runtime.py:70`.

### `lightbulb.OBSERVATION_RESULT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import OBSERVATION_RESULT_SCHEMA
~~~


Binding: `lightbulb.observation_runtime.OBSERVATION_RESULT_SCHEMA` → `lightbulb.observation_runtime.OBSERVATION_RESULT_SCHEMA`.

Source: `lightbulb/observation_runtime.py:71`.

### `lightbulb.OBSERVATION_RUNTIME_VERSION`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import OBSERVATION_RUNTIME_VERSION
~~~


Binding: `lightbulb.observation_runtime.OBSERVATION_RUNTIME_VERSION` → `lightbulb.observation_runtime.OBSERVATION_RUNTIME_VERSION`.

Source: `lightbulb/observation_runtime.py:78`.

### `lightbulb.SHOPIFY_ANALYTICS_PAYLOAD_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SHOPIFY_ANALYTICS_PAYLOAD_SCHEMA
~~~


Binding: `lightbulb.observation_runtime.SHOPIFY_ANALYTICS_PAYLOAD_SCHEMA` → `lightbulb.observation_runtime.SHOPIFY_ANALYTICS_PAYLOAD_SCHEMA`.

Source: `lightbulb/observation_runtime.py:73`.

### `lightbulb.STOREFRONT_PHASE_EVALUATION_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import STOREFRONT_PHASE_EVALUATION_SCHEMA
~~~


Binding: `lightbulb.observation_runtime.STOREFRONT_PHASE_EVALUATION_SCHEMA` → `lightbulb.observation_runtime.STOREFRONT_PHASE_EVALUATION_SCHEMA`.

Source: `lightbulb/observation_runtime.py:72`.

### `lightbulb.CheckoutRecoverySnapshotNormalizer`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CheckoutRecoverySnapshotNormalizer
~~~


Binding: `lightbulb.observation_runtime.CheckoutRecoverySnapshotNormalizer` → `lightbulb.observation_runtime.CheckoutRecoverySnapshotNormalizer`.

Source: `lightbulb/observation_runtime.py:994`.

### `lightbulb.CheckoutRecoverySnapshotPayload`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CheckoutRecoverySnapshotPayload
~~~


Binding: `lightbulb.observation_runtime.CheckoutRecoverySnapshotPayload` → `lightbulb.observation_runtime.CheckoutRecoverySnapshotPayload`.

Source: `lightbulb/observation_runtime.py:542`.

### `lightbulb.GoogleAnalyticsNormalizer`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GoogleAnalyticsNormalizer
~~~


Binding: `lightbulb.observation_runtime.GoogleAnalyticsNormalizer` → `lightbulb.observation_runtime.GoogleAnalyticsNormalizer`.

Source: `lightbulb/observation_runtime.py:932`.

### `lightbulb.GoogleAnalyticsPayload`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GoogleAnalyticsPayload
~~~


Binding: `lightbulb.observation_runtime.GoogleAnalyticsPayload` → `lightbulb.observation_runtime.GoogleAnalyticsPayload`.

Source: `lightbulb/observation_runtime.py:519`.

### `lightbulb.GtmObservationContext`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GtmObservationContext
~~~


Binding: `lightbulb.observation_runtime.GtmObservationContext` → `lightbulb.observation_runtime.GtmObservationContext`.

Source: `lightbulb/observation_runtime.py:1134`.

### `lightbulb.HostObservationReadProvenance`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import HostObservationReadProvenance
~~~


Binding: `lightbulb.observation_runtime.HostObservationReadProvenance` → `lightbulb.observation_runtime.HostObservationReadProvenance`.

Source: `lightbulb/observation_runtime.py:690`.

### `lightbulb.HostObservationReadRequest`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import HostObservationReadRequest
~~~


Binding: `lightbulb.observation_runtime.HostObservationReadRequest` → `lightbulb.observation_runtime.HostObservationReadRequest`.

Source: `lightbulb/observation_runtime.py:629`.

### `lightbulb.HostObservationReadResult`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import HostObservationReadResult
~~~


Binding: `lightbulb.observation_runtime.HostObservationReadResult` → `lightbulb.observation_runtime.HostObservationReadResult`.

Source: `lightbulb/observation_runtime.py:749`.

### `lightbulb.HostObservationReader`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import HostObservationReader
~~~


Binding: `lightbulb.observation_runtime.HostObservationReader` → `lightbulb.observation_runtime.HostObservationReader`.

Source: `lightbulb/observation_runtime.py:772`.

### `lightbulb.InMemoryObservationArtifactRepository`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import InMemoryObservationArtifactRepository
~~~


Binding: `lightbulb.observation_runtime.InMemoryObservationArtifactRepository` → `lightbulb.observation_runtime.InMemoryObservationArtifactRepository`.

Source: `lightbulb/observation_runtime.py:1296`.

### `lightbulb.JsonFileObservationArtifactRepository`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import JsonFileObservationArtifactRepository
~~~


Binding: `lightbulb.observation_runtime.JsonFileObservationArtifactRepository` → `lightbulb.observation_runtime.JsonFileObservationArtifactRepository`.

Source: `lightbulb/observation_runtime.py:1369`.

### `lightbulb.NormalizedObservation`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import NormalizedObservation
~~~


Binding: `lightbulb.observation_runtime.NormalizedObservation` → `lightbulb.observation_runtime.NormalizedObservation`.

Source: `lightbulb/observation_runtime.py:380`.

### `lightbulb.ObservationArtifactRepository`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ObservationArtifactRepository
~~~


Binding: `lightbulb.observation_runtime.ObservationArtifactRepository` → `lightbulb.observation_runtime.ObservationArtifactRepository`.

Source: `lightbulb/observation_runtime.py:1286`.

### `lightbulb.ObservationJobSpec`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ObservationJobSpec
~~~


Binding: `lightbulb.observation_runtime.ObservationJobSpec` → `lightbulb.observation_runtime.ObservationJobSpec`.

Source: `lightbulb/observation_runtime.py:275`.

### `lightbulb.ObservationNormalizer`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ObservationNormalizer
~~~


Binding: `lightbulb.observation_runtime.ObservationNormalizer` → `lightbulb.observation_runtime.ObservationNormalizer`.

Source: `lightbulb/observation_runtime.py:608`.

### `lightbulb.ObservationReadReceipt`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ObservationReadReceipt
~~~


Binding: `lightbulb.observation_runtime.ObservationReadReceipt` → `lightbulb.observation_runtime.ObservationReadReceipt`.

Source: `lightbulb/observation_runtime.py:407`.

### `lightbulb.ObservationRunResult`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ObservationRunResult
~~~


Binding: `lightbulb.observation_runtime.ObservationRunResult` → `lightbulb.observation_runtime.ObservationRunResult`.

Source: `lightbulb/observation_runtime.py:1219`.

### `lightbulb.ObservationRuntime`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ObservationRuntime
~~~


Binding: `lightbulb.observation_runtime.ObservationRuntime` → `lightbulb.observation_runtime.ObservationRuntime`.

Source: `lightbulb/observation_runtime.py:1607`.

### `lightbulb.ObservationScopeKeyRing`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ObservationScopeKeyRing
~~~


Binding: `lightbulb.observation_runtime.ObservationScopeKeyRing` → `lightbulb.observation_runtime.ObservationScopeKeyRing`.

Source: `lightbulb/observation_runtime.py:619`.

### `lightbulb.ObservationWorker`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ObservationWorker
~~~


Binding: `lightbulb.observation_runtime.ObservationWorker` → `lightbulb.observation_runtime.ObservationWorker`.

Source: `lightbulb/observation_runtime.py:2987`.

### `lightbulb.ProfitObservationContext`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProfitObservationContext
~~~


Binding: `lightbulb.observation_runtime.ProfitObservationContext` → `lightbulb.observation_runtime.ProfitObservationContext`.

Source: `lightbulb/observation_runtime.py:1188`.

### `lightbulb.ShopifyAnalyticsNormalizer`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ShopifyAnalyticsNormalizer
~~~


Binding: `lightbulb.observation_runtime.ShopifyAnalyticsNormalizer` → `lightbulb.observation_runtime.ShopifyAnalyticsNormalizer`.

Source: `lightbulb/observation_runtime.py:849`.

### `lightbulb.ShopifyAnalyticsPayload`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ShopifyAnalyticsPayload
~~~


Binding: `lightbulb.observation_runtime.ShopifyAnalyticsPayload` → `lightbulb.observation_runtime.ShopifyAnalyticsPayload`.

Source: `lightbulb/observation_runtime.py:488`.

### `lightbulb.StorefrontPhaseEvaluation`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import StorefrontPhaseEvaluation
~~~


Binding: `lightbulb.observation_runtime.StorefrontPhaseEvaluation` → `lightbulb.observation_runtime.StorefrontPhaseEvaluation`.

Source: `lightbulb/observation_runtime.py:1041`.

### `lightbulb.StorefrontPhaseObservationContext`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import StorefrontPhaseObservationContext
~~~


Binding: `lightbulb.observation_runtime.StorefrontPhaseObservationContext` → `lightbulb.observation_runtime.StorefrontPhaseObservationContext`.

Source: `lightbulb/observation_runtime.py:1160`.

### `lightbulb.mint_host_observation_read_result`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import mint_host_observation_read_result
~~~


Binding: `lightbulb.observation_runtime.mint_host_observation_read_result` → `lightbulb.observation_runtime.mint_host_observation_read_result`.

Source: `lightbulb/observation_runtime.py:780`.

### `lightbulb.ABANDONED_RECOVERY_CASE_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ABANDONED_RECOVERY_CASE_SCHEMA
~~~


Binding: `lightbulb.abandoned_recovery.ABANDONED_RECOVERY_CASE_SCHEMA` → `lightbulb.abandoned_recovery.ABANDONED_RECOVERY_CASE_SCHEMA`.

Source: `lightbulb/abandoned_recovery.py:77`.

### `lightbulb.ABANDONED_RECOVERY_DISPATCH_ATTESTATION_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ABANDONED_RECOVERY_DISPATCH_ATTESTATION_SCHEMA
~~~


Binding: `lightbulb.abandoned_recovery.ABANDONED_RECOVERY_DISPATCH_ATTESTATION_SCHEMA` → `lightbulb.abandoned_recovery.ABANDONED_RECOVERY_DISPATCH_ATTESTATION_SCHEMA`.

Source: `lightbulb/abandoned_recovery.py:78`.

### `lightbulb.ABANDONED_RECOVERY_PLAN_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ABANDONED_RECOVERY_PLAN_SCHEMA
~~~


Binding: `lightbulb.abandoned_recovery.ABANDONED_RECOVERY_PLAN_SCHEMA` → `lightbulb.abandoned_recovery.ABANDONED_RECOVERY_PLAN_SCHEMA`.

Source: `lightbulb/abandoned_recovery.py:88`.

### `lightbulb.ABANDONED_RECOVERY_RUN_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ABANDONED_RECOVERY_RUN_SCHEMA
~~~


Binding: `lightbulb.abandoned_recovery.ABANDONED_RECOVERY_RUN_SCHEMA` → `lightbulb.abandoned_recovery.ABANDONED_RECOVERY_RUN_SCHEMA`.

Source: `lightbulb/abandoned_recovery.py:89`.

### `lightbulb.RECOVERY_CONTACT_RESERVATION_CONSUMPTION_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import RECOVERY_CONTACT_RESERVATION_CONSUMPTION_SCHEMA
~~~


Binding: `lightbulb.abandoned_recovery.RECOVERY_CONTACT_RESERVATION_CONSUMPTION_SCHEMA` → `lightbulb.abandoned_recovery.RECOVERY_CONTACT_RESERVATION_CONSUMPTION_SCHEMA`.

Source: `lightbulb/abandoned_recovery.py:85`.

### `lightbulb.RECOVERY_CONTACT_RESERVATION_REQUEST_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import RECOVERY_CONTACT_RESERVATION_REQUEST_SCHEMA
~~~


Binding: `lightbulb.abandoned_recovery.RECOVERY_CONTACT_RESERVATION_REQUEST_SCHEMA` → `lightbulb.abandoned_recovery.RECOVERY_CONTACT_RESERVATION_REQUEST_SCHEMA`.

Source: `lightbulb/abandoned_recovery.py:81`.

### `lightbulb.RECOVERY_CONTACT_RESERVATION_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import RECOVERY_CONTACT_RESERVATION_SCHEMA
~~~


Binding: `lightbulb.abandoned_recovery.RECOVERY_CONTACT_RESERVATION_SCHEMA` → `lightbulb.abandoned_recovery.RECOVERY_CONTACT_RESERVATION_SCHEMA`.

Source: `lightbulb/abandoned_recovery.py:84`.

### `lightbulb.AbandonedRecoveryCase`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import AbandonedRecoveryCase
~~~


Binding: `lightbulb.abandoned_recovery.AbandonedRecoveryCase` → `lightbulb.abandoned_recovery.AbandonedRecoveryCase`.

Source: `lightbulb/abandoned_recovery.py:388`.

### `lightbulb.AbandonedRecoveryCaseInput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import AbandonedRecoveryCaseInput
~~~


Binding: `lightbulb.abandoned_recovery.AbandonedRecoveryCaseInput` → `lightbulb.abandoned_recovery.AbandonedRecoveryCaseInput`.

Source: `lightbulb/abandoned_recovery.py:230`.

### `lightbulb.AbandonedRecoveryPlan`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import AbandonedRecoveryPlan
~~~


Binding: `lightbulb.abandoned_recovery.AbandonedRecoveryPlan` → `lightbulb.abandoned_recovery.AbandonedRecoveryPlan`.

Source: `lightbulb/abandoned_recovery.py:690`.

### `lightbulb.AbandonedRecoveryRun`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import AbandonedRecoveryRun
~~~


Binding: `lightbulb.abandoned_recovery.AbandonedRecoveryRun` → `lightbulb.abandoned_recovery.AbandonedRecoveryRun`.

Source: `lightbulb/abandoned_recovery.py:736`.

### `lightbulb.ConsentStatus`

value. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ConsentStatus
~~~


Binding: `lightbulb.abandoned_recovery.ConsentStatus` → `lightbulb.abandoned_recovery.ConsentStatus`.

Source: `lightbulb/abandoned_recovery.py:102`.

### `lightbulb.InMemoryRecoveryContactReservationAuthority`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import InMemoryRecoveryContactReservationAuthority
~~~


Binding: `lightbulb.abandoned_recovery.InMemoryRecoveryContactReservationAuthority` → `lightbulb.abandoned_recovery.InMemoryRecoveryContactReservationAuthority`.

Source: `lightbulb/abandoned_recovery.py:1076`.

### `lightbulb.RecoveryActionBrief`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import RecoveryActionBrief
~~~


Binding: `lightbulb.abandoned_recovery.RecoveryActionBrief` → `lightbulb.abandoned_recovery.RecoveryActionBrief`.

Source: `lightbulb/abandoned_recovery.py:677`.

### `lightbulb.RecoveryCohort`

value. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import RecoveryCohort
~~~


Binding: `lightbulb.abandoned_recovery.RecoveryCohort` → `lightbulb.abandoned_recovery.RecoveryCohort`.

Source: `lightbulb/abandoned_recovery.py:103`.

### `lightbulb.RecoveryContactReservation`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import RecoveryContactReservation
~~~


Binding: `lightbulb.abandoned_recovery.RecoveryContactReservation` → `lightbulb.abandoned_recovery.RecoveryContactReservation`.

Source: `lightbulb/abandoned_recovery.py:571`.

### `lightbulb.RecoveryContactReservationAuthority`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import RecoveryContactReservationAuthority
~~~


Binding: `lightbulb.abandoned_recovery.RecoveryContactReservationAuthority` → `lightbulb.abandoned_recovery.RecoveryContactReservationAuthority`.

Source: `lightbulb/abandoned_recovery.py:638`.

### `lightbulb.RecoveryContactReservationConflict`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import RecoveryContactReservationConflict
~~~


Binding: `lightbulb.abandoned_recovery.RecoveryContactReservationConflict` → `lightbulb.abandoned_recovery.RecoveryContactReservationConflict`.

Source: `lightbulb/abandoned_recovery.py:633`.

### `lightbulb.RecoveryContactReservationConsumption`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import RecoveryContactReservationConsumption
~~~


Binding: `lightbulb.abandoned_recovery.RecoveryContactReservationConsumption` → `lightbulb.abandoned_recovery.RecoveryContactReservationConsumption`.

Source: `lightbulb/abandoned_recovery.py:608`.

### `lightbulb.RecoveryContactReservationRequest`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import RecoveryContactReservationRequest
~~~


Binding: `lightbulb.abandoned_recovery.RecoveryContactReservationRequest` → `lightbulb.abandoned_recovery.RecoveryContactReservationRequest`.

Source: `lightbulb/abandoned_recovery.py:517`.

### `lightbulb.RecoveryDispatchAttestation`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import RecoveryDispatchAttestation
~~~


Binding: `lightbulb.abandoned_recovery.RecoveryDispatchAttestation` → `lightbulb.abandoned_recovery.RecoveryDispatchAttestation`.

Source: `lightbulb/abandoned_recovery.py:477`.

### `lightbulb.RecoveryPlanningStatus`

value. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import RecoveryPlanningStatus
~~~


Binding: `lightbulb.abandoned_recovery.RecoveryPlanningStatus` → `lightbulb.abandoned_recovery.RecoveryPlanningStatus`.

Source: `lightbulb/abandoned_recovery.py:104`.

### `lightbulb.RecoveryResolvedSecrets`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import RecoveryResolvedSecrets
~~~


Binding: `lightbulb.abandoned_recovery.RecoveryResolvedSecrets` → `lightbulb.abandoned_recovery.RecoveryResolvedSecrets`.

Source: `lightbulb/abandoned_recovery.py:658`.

### `lightbulb.RecoveryRunStatus`

value. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import RecoveryRunStatus
~~~


Binding: `lightbulb.abandoned_recovery.RecoveryRunStatus` → `lightbulb.abandoned_recovery.RecoveryRunStatus`.

Source: `lightbulb/abandoned_recovery.py:112`.

### `lightbulb.RecoverySuppressionCode`

value. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import RecoverySuppressionCode
~~~


Binding: `lightbulb.abandoned_recovery.RecoverySuppressionCode` → `lightbulb.abandoned_recovery.RecoverySuppressionCode`.

Source: `lightbulb/abandoned_recovery.py:105`.

### `lightbulb.build_recovery_contact_reservation_request`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import build_recovery_contact_reservation_request
~~~


Binding: `lightbulb.abandoned_recovery.build_recovery_contact_reservation_request` → `lightbulb.abandoned_recovery.build_recovery_contact_reservation_request`.

Source: `lightbulb/abandoned_recovery.py:884`.

### `lightbulb.mint_abandoned_recovery_case`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import mint_abandoned_recovery_case
~~~


Binding: `lightbulb.abandoned_recovery.mint_abandoned_recovery_case` → `lightbulb.abandoned_recovery.mint_abandoned_recovery_case`.

Source: `lightbulb/abandoned_recovery.py:786`.

### `lightbulb.mint_recovery_dispatch_attestation`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import mint_recovery_dispatch_attestation
~~~


Binding: `lightbulb.abandoned_recovery.mint_recovery_dispatch_attestation` → `lightbulb.abandoned_recovery.mint_recovery_dispatch_attestation`.

Source: `lightbulb/abandoned_recovery.py:1167`.

### `lightbulb.mint_recovery_contact_reservation`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import mint_recovery_contact_reservation
~~~


Binding: `lightbulb.abandoned_recovery.mint_recovery_contact_reservation` → `lightbulb.abandoned_recovery.mint_recovery_contact_reservation`.

Source: `lightbulb/abandoned_recovery.py:922`.

### `lightbulb.mint_recovery_contact_reservation_consumption`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import mint_recovery_contact_reservation_consumption
~~~


Binding: `lightbulb.abandoned_recovery.mint_recovery_contact_reservation_consumption` → `lightbulb.abandoned_recovery.mint_recovery_contact_reservation_consumption`.

Source: `lightbulb/abandoned_recovery.py:1001`.

### `lightbulb.plan_abandoned_revenue_recovery`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import plan_abandoned_revenue_recovery
~~~


Binding: `lightbulb.abandoned_recovery.plan_abandoned_revenue_recovery` → `lightbulb.abandoned_recovery.plan_abandoned_revenue_recovery`.

Source: `lightbulb/abandoned_recovery.py:1399`.

### `lightbulb.recovery_discount_code_digest`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import recovery_discount_code_digest
~~~


Binding: `lightbulb.abandoned_recovery.recovery_discount_code_digest` → `lightbulb.abandoned_recovery.recovery_discount_code_digest`.

Source: `lightbulb/abandoned_recovery.py:221`.

### `lightbulb.recovery_recipient_digest`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import recovery_recipient_digest
~~~


Binding: `lightbulb.abandoned_recovery.recovery_recipient_digest` → `lightbulb.abandoned_recovery.recovery_recipient_digest`.

Source: `lightbulb/abandoned_recovery.py:203`.

### `lightbulb.recovery_url_digest`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import recovery_url_digest
~~~


Binding: `lightbulb.abandoned_recovery.recovery_url_digest` → `lightbulb.abandoned_recovery.recovery_url_digest`.

Source: `lightbulb/abandoned_recovery.py:212`.

### `lightbulb.run_abandoned_revenue_recovery`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import run_abandoned_revenue_recovery
~~~


Binding: `lightbulb.abandoned_recovery.run_abandoned_revenue_recovery` → `lightbulb.abandoned_recovery.run_abandoned_revenue_recovery`.

Source: `lightbulb/abandoned_recovery.py:1629`.

### `lightbulb.schedule_abandoned_recovery_observation`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import schedule_abandoned_recovery_observation
~~~


Binding: `lightbulb.abandoned_recovery.schedule_abandoned_recovery_observation` → `lightbulb.abandoned_recovery.schedule_abandoned_recovery_observation`.

Source: `lightbulb/abandoned_recovery.py:1870`.

### `lightbulb.verify_abandoned_recovery_case`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import verify_abandoned_recovery_case
~~~


Binding: `lightbulb.abandoned_recovery.verify_abandoned_recovery_case` → `lightbulb.abandoned_recovery.verify_abandoned_recovery_case`.

Source: `lightbulb/abandoned_recovery.py:845`.

### `lightbulb.verify_recovery_contact_reservation`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import verify_recovery_contact_reservation
~~~


Binding: `lightbulb.abandoned_recovery.verify_recovery_contact_reservation` → `lightbulb.abandoned_recovery.verify_recovery_contact_reservation`.

Source: `lightbulb/abandoned_recovery.py:964`.

### `lightbulb.verify_recovery_contact_reservation_consumption`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import verify_recovery_contact_reservation_consumption
~~~


Binding: `lightbulb.abandoned_recovery.verify_recovery_contact_reservation_consumption` → `lightbulb.abandoned_recovery.verify_recovery_contact_reservation_consumption`.

Source: `lightbulb/abandoned_recovery.py:1040`.

### `lightbulb.verify_recovery_dispatch_attestation`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import verify_recovery_dispatch_attestation
~~~


Binding: `lightbulb.abandoned_recovery.verify_recovery_dispatch_attestation` → `lightbulb.abandoned_recovery.verify_recovery_dispatch_attestation`.

Source: `lightbulb/abandoned_recovery.py:1242`.

### `lightbulb.RECOVERY_ENRICHMENT_ATTESTATION_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import RECOVERY_ENRICHMENT_ATTESTATION_SCHEMA
~~~


Binding: `lightbulb.recovery_ingestion.RECOVERY_ENRICHMENT_ATTESTATION_SCHEMA` → `lightbulb.recovery_ingestion.RECOVERY_ENRICHMENT_ATTESTATION_SCHEMA`.

Source: `lightbulb/recovery_ingestion.py:75`.

### `lightbulb.RECOVERY_ENRICHMENT_REQUEST_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import RECOVERY_ENRICHMENT_REQUEST_SCHEMA
~~~


Binding: `lightbulb.recovery_ingestion.RECOVERY_ENRICHMENT_REQUEST_SCHEMA` → `lightbulb.recovery_ingestion.RECOVERY_ENRICHMENT_REQUEST_SCHEMA`.

Source: `lightbulb/recovery_ingestion.py:76`.

### `lightbulb.RECOVERY_INGESTION_CHECKPOINT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import RECOVERY_INGESTION_CHECKPOINT_SCHEMA
~~~


Binding: `lightbulb.recovery_ingestion.RECOVERY_INGESTION_CHECKPOINT_SCHEMA` → `lightbulb.recovery_ingestion.RECOVERY_INGESTION_CHECKPOINT_SCHEMA`.

Source: `lightbulb/recovery_ingestion.py:77`.

### `lightbulb.RECOVERY_INGESTION_RUN_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import RECOVERY_INGESTION_RUN_SCHEMA
~~~


Binding: `lightbulb.recovery_ingestion.RECOVERY_INGESTION_RUN_SCHEMA` → `lightbulb.recovery_ingestion.RECOVERY_INGESTION_RUN_SCHEMA`.

Source: `lightbulb/recovery_ingestion.py:78`.

### `lightbulb.SHOPIFY_ABANDONED_CHECKOUT_OUTPUT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SHOPIFY_ABANDONED_CHECKOUT_OUTPUT_SCHEMA
~~~


Binding: `lightbulb.recovery_ingestion.SHOPIFY_ABANDONED_CHECKOUT_OUTPUT_SCHEMA` → `lightbulb.recovery_ingestion.SHOPIFY_ABANDONED_CHECKOUT_OUTPUT_SCHEMA`.

Source: `lightbulb/recovery_ingestion.py:79`.

### `lightbulb.InMemoryRecoveryIngestionRepository`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import InMemoryRecoveryIngestionRepository
~~~


Binding: `lightbulb.recovery_ingestion.InMemoryRecoveryIngestionRepository` → `lightbulb.recovery_ingestion.InMemoryRecoveryIngestionRepository`.

Source: `lightbulb/recovery_ingestion.py:982`.

### `lightbulb.JsonFileRecoveryIngestionRepository`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import JsonFileRecoveryIngestionRepository
~~~


Binding: `lightbulb.recovery_ingestion.JsonFileRecoveryIngestionRepository` → `lightbulb.recovery_ingestion.JsonFileRecoveryIngestionRepository`.

Source: `lightbulb/recovery_ingestion.py:1021`.

### `lightbulb.RecoveryEnrichmentAuthority`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import RecoveryEnrichmentAuthority
~~~


Binding: `lightbulb.recovery_ingestion.RecoveryEnrichmentAuthority` → `lightbulb.recovery_ingestion.RecoveryEnrichmentAuthority`.

Source: `lightbulb/recovery_ingestion.py:558`.

### `lightbulb.RecoveryEnrichmentFacts`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import RecoveryEnrichmentFacts
~~~


Binding: `lightbulb.recovery_ingestion.RecoveryEnrichmentFacts` → `lightbulb.recovery_ingestion.RecoveryEnrichmentFacts`.

Source: `lightbulb/recovery_ingestion.py:381`.

### `lightbulb.RecoveryEnrichmentRequest`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import RecoveryEnrichmentRequest
~~~


Binding: `lightbulb.recovery_ingestion.RecoveryEnrichmentRequest` → `lightbulb.recovery_ingestion.RecoveryEnrichmentRequest`.

Source: `lightbulb/recovery_ingestion.py:458`.

### `lightbulb.RecoveryIngestionCheckpoint`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import RecoveryIngestionCheckpoint
~~~


Binding: `lightbulb.recovery_ingestion.RecoveryIngestionCheckpoint` → `lightbulb.recovery_ingestion.RecoveryIngestionCheckpoint`.

Source: `lightbulb/recovery_ingestion.py:847`.

### `lightbulb.RecoveryIngestionEnrichment`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import RecoveryIngestionEnrichment
~~~


Binding: `lightbulb.recovery_ingestion.RecoveryIngestionEnrichment` → `lightbulb.recovery_ingestion.RecoveryIngestionEnrichment`.

Source: `lightbulb/recovery_ingestion.py:503`.

### `lightbulb.RecoveryIngestionError`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import RecoveryIngestionError
~~~


Binding: `lightbulb.recovery_ingestion.RecoveryIngestionError` → `lightbulb.recovery_ingestion.RecoveryIngestionError`.

Source: `lightbulb/recovery_ingestion.py:1140`.

### `lightbulb.RecoveryIngestionFailure`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import RecoveryIngestionFailure
~~~


Binding: `lightbulb.recovery_ingestion.RecoveryIngestionFailure` → `lightbulb.recovery_ingestion.RecoveryIngestionFailure`.

Source: `lightbulb/recovery_ingestion.py:913`.

### `lightbulb.RecoveryIngestionRepository`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import RecoveryIngestionRepository
~~~


Binding: `lightbulb.recovery_ingestion.RecoveryIngestionRepository` → `lightbulb.recovery_ingestion.RecoveryIngestionRepository`.

Source: `lightbulb/recovery_ingestion.py:974`.

### `lightbulb.RecoveryIngestionRunResult`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import RecoveryIngestionRunResult
~~~


Binding: `lightbulb.recovery_ingestion.RecoveryIngestionRunResult` → `lightbulb.recovery_ingestion.RecoveryIngestionRunResult`.

Source: `lightbulb/recovery_ingestion.py:930`.

### `lightbulb.RecoveryIngestionWorker`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import RecoveryIngestionWorker
~~~


Binding: `lightbulb.recovery_ingestion.RecoveryIngestionWorker` → `lightbulb.recovery_ingestion.RecoveryIngestionWorker`.

Source: `lightbulb/recovery_ingestion.py:1144`.

### `lightbulb.RecoverySecretResolver`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import RecoverySecretResolver
~~~


Binding: `lightbulb.recovery_ingestion.RecoverySecretResolver` → `lightbulb.recovery_ingestion.RecoverySecretResolver`.

Source: `lightbulb/recovery_ingestion.py:567`.

### `lightbulb.ShopifyAbandonedCheckout`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ShopifyAbandonedCheckout
~~~


Binding: `lightbulb.recovery_ingestion.ShopifyAbandonedCheckout` → `lightbulb.recovery_ingestion.ShopifyAbandonedCheckout`.

Source: `lightbulb/recovery_ingestion.py:277`.

### `lightbulb.ShopifyAbandonedCheckoutOutput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ShopifyAbandonedCheckoutOutput
~~~


Binding: `lightbulb.recovery_ingestion.ShopifyAbandonedCheckoutOutput` → `lightbulb.recovery_ingestion.ShopifyAbandonedCheckoutOutput`.

Source: `lightbulb/recovery_ingestion.py:341`.

### `lightbulb.ShopifyRecoveryCustomer`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ShopifyRecoveryCustomer
~~~


Binding: `lightbulb.recovery_ingestion.ShopifyRecoveryCustomer` → `lightbulb.recovery_ingestion.ShopifyRecoveryCustomer`.

Source: `lightbulb/recovery_ingestion.py:231`.

### `lightbulb.ShopifyRecoveryLineItem`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ShopifyRecoveryLineItem
~~~


Binding: `lightbulb.recovery_ingestion.ShopifyRecoveryLineItem` → `lightbulb.recovery_ingestion.ShopifyRecoveryLineItem`.

Source: `lightbulb/recovery_ingestion.py:258`.

### `lightbulb.ShopifyRecoveryLineItemEdge`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ShopifyRecoveryLineItemEdge
~~~


Binding: `lightbulb.recovery_ingestion.ShopifyRecoveryLineItemEdge` → `lightbulb.recovery_ingestion.ShopifyRecoveryLineItemEdge`.

Source: `lightbulb/recovery_ingestion.py:264`.

### `lightbulb.ShopifyRecoveryLineItems`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ShopifyRecoveryLineItems
~~~


Binding: `lightbulb.recovery_ingestion.ShopifyRecoveryLineItems` → `lightbulb.recovery_ingestion.ShopifyRecoveryLineItems`.

Source: `lightbulb/recovery_ingestion.py:268`.

### `lightbulb.ShopifyRecoveryMoney`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ShopifyRecoveryMoney
~~~


Binding: `lightbulb.recovery_ingestion.ShopifyRecoveryMoney` → `lightbulb.recovery_ingestion.ShopifyRecoveryMoney`.

Source: `lightbulb/recovery_ingestion.py:217`.

### `lightbulb.ShopifyRecoveryMoneySet`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ShopifyRecoveryMoneySet
~~~


Binding: `lightbulb.recovery_ingestion.ShopifyRecoveryMoneySet` → `lightbulb.recovery_ingestion.ShopifyRecoveryMoneySet`.

Source: `lightbulb/recovery_ingestion.py:227`.

### `lightbulb.ShopifyRecoveryVariant`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ShopifyRecoveryVariant
~~~


Binding: `lightbulb.recovery_ingestion.ShopifyRecoveryVariant` → `lightbulb.recovery_ingestion.ShopifyRecoveryVariant`.

Source: `lightbulb/recovery_ingestion.py:249`.

### `lightbulb.mint_recovery_ingestion_enrichment`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import mint_recovery_ingestion_enrichment
~~~


Binding: `lightbulb.recovery_ingestion.mint_recovery_ingestion_enrichment` → `lightbulb.recovery_ingestion.mint_recovery_ingestion_enrichment`.

Source: `lightbulb/recovery_ingestion.py:602`.

### `lightbulb.recovery_ingestion_key`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import recovery_ingestion_key
~~~


Binding: `lightbulb.recovery_ingestion.recovery_ingestion_key` → `lightbulb.recovery_ingestion.recovery_ingestion_key`.

Source: `lightbulb/recovery_ingestion.py:578`.

### `lightbulb.recovery_ingestion_scope_fingerprint`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import recovery_ingestion_scope_fingerprint
~~~


Binding: `lightbulb.recovery_ingestion.recovery_ingestion_scope_fingerprint` → `lightbulb.recovery_ingestion.recovery_ingestion_scope_fingerprint`.

Source: `lightbulb/recovery_ingestion.py:196`.

### `lightbulb.verify_recovery_ingestion_enrichment`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import verify_recovery_ingestion_enrichment
~~~


Binding: `lightbulb.recovery_ingestion.verify_recovery_ingestion_enrichment` → `lightbulb.recovery_ingestion.verify_recovery_ingestion_enrichment`.

Source: `lightbulb/recovery_ingestion.py:748`.

### `lightbulb.MaterializableCandidateEconomics`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import MaterializableCandidateEconomics
~~~


Binding: `lightbulb.profit_action_builders.MaterializableCandidateEconomics` → `lightbulb.profit_action_builders.MaterializableCandidateEconomics`.

Source: `lightbulb/profit_action_builders.py:42`.

### `lightbulb.MaterializableCapability`

value. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import MaterializableCapability
~~~


Binding: `lightbulb.profit_action_builders.MaterializableCapability` → `lightbulb.profit_action_builders.MaterializableCapability`.

Source: `lightbulb/profit_action_builders.py:32`.

### `lightbulb.build_creative_publish_candidate`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import build_creative_publish_candidate
~~~


Binding: `lightbulb.profit_action_builders.build_creative_publish_candidate` → `lightbulb.profit_action_builders.build_creative_publish_candidate`.

Source: `lightbulb/profit_action_builders.py:143`.

### `lightbulb.build_lifecycle_email_candidate`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import build_lifecycle_email_candidate
~~~


Binding: `lightbulb.profit_action_builders.build_lifecycle_email_candidate` → `lightbulb.profit_action_builders.build_lifecycle_email_candidate`.

Source: `lightbulb/profit_action_builders.py:179`.

### `lightbulb.build_materializable_connector_candidate`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import build_materializable_connector_candidate
~~~


Binding: `lightbulb.profit_action_builders.build_materializable_connector_candidate` → `lightbulb.profit_action_builders.build_materializable_connector_candidate`.

Source: `lightbulb/profit_action_builders.py:70`.

### `lightbulb.build_offer_product_update_candidate`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import build_offer_product_update_candidate
~~~


Binding: `lightbulb.profit_action_builders.build_offer_product_update_candidate` → `lightbulb.profit_action_builders.build_offer_product_update_candidate`.

Source: `lightbulb/profit_action_builders.py:117`.

### `lightbulb.PROFIT_ACTION_APPROVAL_GRANT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROFIT_ACTION_APPROVAL_GRANT_SCHEMA
~~~


Binding: `lightbulb.profit_materializer.PROFIT_ACTION_APPROVAL_GRANT_SCHEMA` → `lightbulb.profit_materializer.PROFIT_ACTION_APPROVAL_GRANT_SCHEMA`.

Source: `lightbulb/profit_materializer.py:57`.

### `lightbulb.PROFIT_ACTION_MATERIALIZATION_RESULT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROFIT_ACTION_MATERIALIZATION_RESULT_SCHEMA
~~~


Binding: `lightbulb.profit_materializer.PROFIT_ACTION_MATERIALIZATION_RESULT_SCHEMA` → `lightbulb.profit_materializer.PROFIT_ACTION_MATERIALIZATION_RESULT_SCHEMA`.

Source: `lightbulb/profit_materializer.py:58`.

### `lightbulb.EcommerceCreateDiscountArguments`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import EcommerceCreateDiscountArguments
~~~


Binding: `lightbulb.profit_materializer.EcommerceCreateDiscountArguments` → `lightbulb.profit_materializer.EcommerceCreateDiscountArguments`.

Source: `lightbulb/profit_materializer.py:167`.

### `lightbulb.EcommerceUpdateProductArguments`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import EcommerceUpdateProductArguments
~~~


Binding: `lightbulb.profit_materializer.EcommerceUpdateProductArguments` → `lightbulb.profit_materializer.EcommerceUpdateProductArguments`.

Source: `lightbulb/profit_materializer.py:208`.

### `lightbulb.FacebookPublishPostArguments`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import FacebookPublishPostArguments
~~~


Binding: `lightbulb.profit_materializer.FacebookPublishPostArguments` → `lightbulb.profit_materializer.FacebookPublishPostArguments`.

Source: `lightbulb/profit_materializer.py:270`.

### `lightbulb.GmailSendEmailArguments`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GmailSendEmailArguments
~~~


Binding: `lightbulb.profit_materializer.GmailSendEmailArguments` → `lightbulb.profit_materializer.GmailSendEmailArguments`.

Source: `lightbulb/profit_materializer.py:136`.

### `lightbulb.InstagramPublishPostArguments`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import InstagramPublishPostArguments
~~~


Binding: `lightbulb.profit_materializer.InstagramPublishPostArguments` → `lightbulb.profit_materializer.InstagramPublishPostArguments`.

Source: `lightbulb/profit_materializer.py:293`.

### `lightbulb.LinkedInPublishPostArguments`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import LinkedInPublishPostArguments
~~~


Binding: `lightbulb.profit_materializer.LinkedInPublishPostArguments` → `lightbulb.profit_materializer.LinkedInPublishPostArguments`.

Source: `lightbulb/profit_materializer.py:316`.

### `lightbulb.ProfitActionApprovalGrant`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProfitActionApprovalGrant
~~~


Binding: `lightbulb.profit_materializer.ProfitActionApprovalGrant` → `lightbulb.profit_materializer.ProfitActionApprovalGrant`.

Source: `lightbulb/profit_materializer.py:388`.

### `lightbulb.ProfitActionMaterializationResult`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProfitActionMaterializationResult
~~~


Binding: `lightbulb.profit_materializer.ProfitActionMaterializationResult` → `lightbulb.profit_materializer.ProfitActionMaterializationResult`.

Source: `lightbulb/profit_materializer.py:428`.

### `lightbulb.ProfitMaterializationStatus`

value. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProfitMaterializationStatus
~~~


Binding: `lightbulb.profit_materializer.ProfitMaterializationStatus` → `lightbulb.profit_materializer.ProfitMaterializationStatus`.

Source: `lightbulb/profit_materializer.py:73`.

### `lightbulb.bind_profit_action_approval`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import bind_profit_action_approval
~~~


Binding: `lightbulb.profit_materializer.bind_profit_action_approval` → `lightbulb.profit_materializer.bind_profit_action_approval`.

Source: `lightbulb/profit_materializer.py:610`.

### `lightbulb.canonical_profit_connector_arguments`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import canonical_profit_connector_arguments
~~~


Binding: `lightbulb.profit_materializer.canonical_profit_connector_arguments` → `lightbulb.profit_materializer.canonical_profit_connector_arguments`.

Source: `lightbulb/profit_materializer.py:350`.

### `lightbulb.materialize_profit_action`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import materialize_profit_action
~~~


Binding: `lightbulb.profit_materializer.materialize_profit_action` → `lightbulb.profit_materializer.materialize_profit_action`.

Source: `lightbulb/profit_materializer.py:1555`.

### `lightbulb.profit_connector_arguments_digest`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import profit_connector_arguments_digest
~~~


Binding: `lightbulb.profit_materializer.profit_connector_arguments_digest` → `lightbulb.profit_materializer.profit_connector_arguments_digest`.

Source: `lightbulb/profit_materializer.py:374`.

### `lightbulb.PROFIT_WORKFLOW_EXECUTION_RUN_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROFIT_WORKFLOW_EXECUTION_RUN_SCHEMA
~~~


Binding: `lightbulb.profit_workflow_execution.PROFIT_WORKFLOW_EXECUTION_RUN_SCHEMA` → `lightbulb.profit_workflow_execution.PROFIT_WORKFLOW_EXECUTION_RUN_SCHEMA`.

Source: `lightbulb/profit_workflow_execution.py:34`.

### `lightbulb.ProfitWorkflowExecutionRun`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProfitWorkflowExecutionRun
~~~


Binding: `lightbulb.profit_workflow_execution.ProfitWorkflowExecutionRun` → `lightbulb.profit_workflow_execution.ProfitWorkflowExecutionRun`.

Source: `lightbulb/profit_workflow_execution.py:56`.

### `lightbulb.ProfitWorkflowExecutionStatus`

value. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProfitWorkflowExecutionStatus
~~~


Binding: `lightbulb.profit_workflow_execution.ProfitWorkflowExecutionStatus` → `lightbulb.profit_workflow_execution.ProfitWorkflowExecutionStatus`.

Source: `lightbulb/profit_workflow_execution.py:36`.

### `lightbulb.run_profit_workflow_actions`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import run_profit_workflow_actions
~~~


Binding: `lightbulb.profit_workflow_execution.run_profit_workflow_actions` → `lightbulb.profit_workflow_execution.run_profit_workflow_actions`.

Source: `lightbulb/profit_workflow_execution.py:161`.

### `lightbulb.SHOPIFY_BLOCKED_GO_LIVE_TOOLS`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SHOPIFY_BLOCKED_GO_LIVE_TOOLS
~~~


Binding: `lightbulb.shopify_primitives.SHOPIFY_BLOCKED_GO_LIVE_TOOLS` → `lightbulb.shopify_primitives.SHOPIFY_BLOCKED_GO_LIVE_TOOLS`.

Source: `lightbulb/shopify_primitives.py:46`.

### `lightbulb.SHOPIFY_PROPOSAL_TOOLS`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SHOPIFY_PROPOSAL_TOOLS
~~~


Binding: `lightbulb.shopify_primitives.SHOPIFY_PROPOSAL_TOOLS` → `lightbulb.shopify_primitives.SHOPIFY_PROPOSAL_TOOLS`.

Source: `lightbulb/shopify_primitives.py:39`.

### `lightbulb.SHOPIFY_STOREFRONT_PLAN_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SHOPIFY_STOREFRONT_PLAN_SCHEMA
~~~


Binding: `lightbulb.shopify_primitives.SHOPIFY_STOREFRONT_PLAN_SCHEMA` → `lightbulb.shopify_primitives.SHOPIFY_STOREFRONT_PLAN_SCHEMA`.

Source: `lightbulb/shopify_primitives.py:36`.

### `lightbulb.SHOPIFY_STOREFRONT_PRIMITIVE_REF`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SHOPIFY_STOREFRONT_PRIMITIVE_REF
~~~


Binding: `lightbulb.shopify_primitives.SHOPIFY_STOREFRONT_PRIMITIVE_REF` → `lightbulb.shopify_primitives.SHOPIFY_STOREFRONT_PRIMITIVE_REF`.

Source: `lightbulb/shopify_primitives.py:37`.

### `lightbulb.ExistingShopifyThemeBrief`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ExistingShopifyThemeBrief
~~~


Binding: `lightbulb.shopify_primitives.ExistingShopifyThemeBrief` → `lightbulb.shopify_primitives.ExistingShopifyThemeBrief`.

Source: `lightbulb/shopify_primitives.py:248`.

### `lightbulb.PlanShopifyStorefrontInput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PlanShopifyStorefrontInput
~~~


Binding: `lightbulb.shopify_primitives.PlanShopifyStorefrontInput` → `lightbulb.shopify_primitives.PlanShopifyStorefrontInput`.

Source: `lightbulb/shopify_primitives.py:263`.

### `lightbulb.PlanShopifyStorefrontPrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PlanShopifyStorefrontPrimitive
~~~


Binding: `lightbulb.shopify_primitives.PlanShopifyStorefrontPrimitive` → `lightbulb.shopify_primitives.PlanShopifyStorefrontPrimitive`.

Source: `lightbulb/shopify_primitives.py:823`.

### `lightbulb.ShopifyBlockedAction`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ShopifyBlockedAction
~~~


Binding: `lightbulb.shopify_primitives.ShopifyBlockedAction` → `lightbulb.shopify_primitives.ShopifyBlockedAction`.

Source: `lightbulb/shopify_primitives.py:402`.

### `lightbulb.ShopifyCapabilityGap`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ShopifyCapabilityGap
~~~


Binding: `lightbulb.shopify_primitives.ShopifyCapabilityGap` → `lightbulb.shopify_primitives.ShopifyCapabilityGap`.

Source: `lightbulb/shopify_primitives.py:394`.

### `lightbulb.ShopifyCollectionBrief`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ShopifyCollectionBrief
~~~


Binding: `lightbulb.shopify_primitives.ShopifyCollectionBrief` → `lightbulb.shopify_primitives.ShopifyCollectionBrief`.

Source: `lightbulb/shopify_primitives.py:233`.

### `lightbulb.ShopifyEffectBoundary`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ShopifyEffectBoundary
~~~


Binding: `lightbulb.shopify_primitives.ShopifyEffectBoundary` → `lightbulb.shopify_primitives.ShopifyEffectBoundary`.

Source: `lightbulb/shopify_primitives.py:437`.

### `lightbulb.ShopifyMoney`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ShopifyMoney
~~~


Binding: `lightbulb.shopify_primitives.ShopifyMoney` → `lightbulb.shopify_primitives.ShopifyMoney`.

Source: `lightbulb/shopify_primitives.py:149`.

### `lightbulb.ShopifyPageBrief`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ShopifyPageBrief
~~~


Binding: `lightbulb.shopify_primitives.ShopifyPageBrief` → `lightbulb.shopify_primitives.ShopifyPageBrief`.

Source: `lightbulb/shopify_primitives.py:226`.

### `lightbulb.ShopifyProductBrief`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ShopifyProductBrief
~~~


Binding: `lightbulb.shopify_primitives.ShopifyProductBrief` → `lightbulb.shopify_primitives.ShopifyProductBrief`.

Source: `lightbulb/shopify_primitives.py:195`.

### `lightbulb.ShopifyProductVariantBrief`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ShopifyProductVariantBrief
~~~


Binding: `lightbulb.shopify_primitives.ShopifyProductVariantBrief` → `lightbulb.shopify_primitives.ShopifyProductVariantBrief`.

Source: `lightbulb/shopify_primitives.py:173`.

### `lightbulb.ShopifyProposedOperation`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ShopifyProposedOperation
~~~


Binding: `lightbulb.shopify_primitives.ShopifyProposedOperation` → `lightbulb.shopify_primitives.ShopifyProposedOperation`.

Source: `lightbulb/shopify_primitives.py:357`.

### `lightbulb.ShopifyStorefrontBrief`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ShopifyStorefrontBrief
~~~


Binding: `lightbulb.shopify_primitives.ShopifyStorefrontBrief` → `lightbulb.shopify_primitives.ShopifyStorefrontBrief`.

Source: `lightbulb/shopify_primitives.py:254`.

### `lightbulb.ShopifyStorefrontPlanOutput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ShopifyStorefrontPlanOutput
~~~


Binding: `lightbulb.shopify_primitives.ShopifyStorefrontPlanOutput` → `lightbulb.shopify_primitives.ShopifyStorefrontPlanOutput`.

Source: `lightbulb/shopify_primitives.py:445`.

### `lightbulb.ShopifyStorefrontPlanValidationError`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ShopifyStorefrontPlanValidationError
~~~


Binding: `lightbulb.shopify_primitives.ShopifyStorefrontPlanValidationError` → `lightbulb.shopify_primitives.ShopifyStorefrontPlanValidationError`.

Source: `lightbulb/shopify_primitives.py:145`.

### `lightbulb.ShopifyVariantOption`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ShopifyVariantOption
~~~


Binding: `lightbulb.shopify_primitives.ShopifyVariantOption` → `lightbulb.shopify_primitives.ShopifyVariantOption`.

Source: `lightbulb/shopify_primitives.py:168`.

### `lightbulb.plan_shopify_storefront`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import plan_shopify_storefront
~~~


Binding: `lightbulb.shopify_primitives.plan_shopify_storefront` → `lightbulb.shopify_primitives.plan_shopify_storefront`.

Source: `lightbulb/shopify_primitives.py:749`.

### `lightbulb.PROJECT_SPEC_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROJECT_SPEC_SCHEMA
~~~


Binding: `lightbulb.project_runtime.PROJECT_SPEC_SCHEMA` → `lightbulb.project_runtime.PROJECT_SPEC_SCHEMA`.

Source: `lightbulb/project_runtime.py:39`.

### `lightbulb.PROJECT_VALIDATION_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROJECT_VALIDATION_SCHEMA
~~~


Binding: `lightbulb.project_runtime.PROJECT_VALIDATION_SCHEMA` → `lightbulb.project_runtime.PROJECT_VALIDATION_SCHEMA`.

Source: `lightbulb/project_runtime.py:40`.

### `lightbulb.PROJECT_WORKFLOW_RUN_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROJECT_WORKFLOW_RUN_SCHEMA
~~~


Binding: `lightbulb.project_runtime.PROJECT_WORKFLOW_RUN_SCHEMA` → `lightbulb.project_runtime.PROJECT_WORKFLOW_RUN_SCHEMA`.

Source: `lightbulb/project_runtime.py:41`.

### `lightbulb.BindingResolutionError`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import BindingResolutionError
~~~


Binding: `lightbulb.project_runtime.BindingResolutionError` → `lightbulb.project_runtime.BindingResolutionError`.

Source: `lightbulb/project_runtime.py:369`.

### `lightbulb.LightbulbProject`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import LightbulbProject
~~~


Binding: `lightbulb.project_runtime.LightbulbProject` → `lightbulb.project_runtime.LightbulbProject`.

Source: `lightbulb/project_runtime.py:170`.

### `lightbulb.ProjectPolicy`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProjectPolicy
~~~


Binding: `lightbulb.project_runtime.ProjectPolicy` → `lightbulb.project_runtime.ProjectPolicy`.

Source: `lightbulb/project_runtime.py:75`.

### `lightbulb.RetryPolicy`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import RetryPolicy
~~~


Binding: `lightbulb.project_runtime.RetryPolicy` → `lightbulb.project_runtime.RetryPolicy`.

Source: `lightbulb/project_runtime.py:47`.

### `lightbulb.ProjectRuntime`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProjectRuntime
~~~


Binding: `lightbulb.project_runtime.ProjectRuntime` → `lightbulb.project_runtime.ProjectRuntime`.

Source: `lightbulb/project_runtime.py:481`.

### `lightbulb.ProjectValidationIssue`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProjectValidationIssue
~~~


Binding: `lightbulb.project_runtime.ProjectValidationIssue` → `lightbulb.project_runtime.ProjectValidationIssue`.

Source: `lightbulb/project_runtime.py:234`.

### `lightbulb.ProjectValidationResult`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProjectValidationResult
~~~


Binding: `lightbulb.project_runtime.ProjectValidationResult` → `lightbulb.project_runtime.ProjectValidationResult`.

Source: `lightbulb/project_runtime.py:243`.

### `lightbulb.ProjectValidationSeverity`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProjectValidationSeverity
~~~


Binding: `lightbulb.project_runtime.ProjectValidationSeverity` → `lightbulb.project_runtime.ProjectValidationSeverity`.

Source: `lightbulb/project_runtime.py:229`.

### `lightbulb.ProjectWorkflow`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProjectWorkflow
~~~


Binding: `lightbulb.project_runtime.ProjectWorkflow` → `lightbulb.project_runtime.ProjectWorkflow`.

Source: `lightbulb/project_runtime.py:128`.

### `lightbulb.ProjectWorkflowRun`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProjectWorkflowRun
~~~


Binding: `lightbulb.project_runtime.ProjectWorkflowRun` → `lightbulb.project_runtime.ProjectWorkflowRun`.

Source: `lightbulb/project_runtime.py:328`.

### `lightbulb.ProjectWorkflowRunStatus`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProjectWorkflowRunStatus
~~~


Binding: `lightbulb.project_runtime.ProjectWorkflowRunStatus` → `lightbulb.project_runtime.ProjectWorkflowRunStatus`.

Source: `lightbulb/project_runtime.py:267`.

### `lightbulb.ProjectWorkflowStep`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProjectWorkflowStep
~~~


Binding: `lightbulb.project_runtime.ProjectWorkflowStep` → `lightbulb.project_runtime.ProjectWorkflowStep`.

Source: `lightbulb/project_runtime.py:85`.

### `lightbulb.PROJECT_AUTORESEARCH_ARTIFACT_TYPE`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROJECT_AUTORESEARCH_ARTIFACT_TYPE
~~~


Binding: `lightbulb.project_autoresearch.PROJECT_AUTORESEARCH_ARTIFACT_TYPE` → `lightbulb.project_autoresearch.PROJECT_AUTORESEARCH_ARTIFACT_TYPE`.

Source: `lightbulb/project_autoresearch.py:38`.

### `lightbulb.PROJECT_AUTORESEARCH_BASE_PATH`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROJECT_AUTORESEARCH_BASE_PATH
~~~


Binding: `lightbulb.project_autoresearch.PROJECT_AUTORESEARCH_BASE_PATH` → `lightbulb.project_autoresearch.PROJECT_AUTORESEARCH_BASE_PATH`.

Source: `lightbulb/project_autoresearch.py:39`.

### `lightbulb.PROJECT_AUTORESEARCH_RUN_RECEIPT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROJECT_AUTORESEARCH_RUN_RECEIPT_SCHEMA
~~~


Binding: `lightbulb.project_autoresearch.PROJECT_AUTORESEARCH_RUN_RECEIPT_SCHEMA` → `lightbulb.project_autoresearch.PROJECT_AUTORESEARCH_RUN_RECEIPT_SCHEMA`.

Source: `lightbulb/project_autoresearch.py:35`.

### `lightbulb.PROJECT_AUTORESEARCH_USAGE_ACCOUNTING`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROJECT_AUTORESEARCH_USAGE_ACCOUNTING
~~~


Binding: `lightbulb.project_autoresearch.PROJECT_AUTORESEARCH_USAGE_ACCOUNTING` → `lightbulb.project_autoresearch.PROJECT_AUTORESEARCH_USAGE_ACCOUNTING`.

Source: `lightbulb/project_autoresearch.py:40`.

### `lightbulb.ProjectAutoResearchCancelReceipt`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProjectAutoResearchCancelReceipt
~~~


Binding: `lightbulb.project_autoresearch.ProjectAutoResearchCancelReceipt` → `lightbulb.project_autoresearch.ProjectAutoResearchCancelReceipt`.

Source: `lightbulb/project_autoresearch.py:277`.

### `lightbulb.ProjectAutoResearchCancelRequest`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProjectAutoResearchCancelRequest
~~~


Binding: `lightbulb.project_autoresearch.ProjectAutoResearchCancelRequest` → `lightbulb.project_autoresearch.ProjectAutoResearchCancelRequest`.

Source: `lightbulb/project_autoresearch.py:145`.

### `lightbulb.ProjectAutoResearchClient`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProjectAutoResearchClient
~~~


Binding: `lightbulb.project_autoresearch.ProjectAutoResearchClient` → `lightbulb.project_autoresearch.ProjectAutoResearchClient`.

Source: `lightbulb/project_autoresearch.py:325`.

### `lightbulb.ProjectAutoResearchContractError`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProjectAutoResearchContractError
~~~


Binding: `lightbulb.project_autoresearch.ProjectAutoResearchContractError` → `lightbulb.project_autoresearch.ProjectAutoResearchContractError`.

Source: `lightbulb/project_autoresearch.py:62`.

### `lightbulb.ProjectAutoResearchObservationState`

value. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProjectAutoResearchObservationState
~~~


Binding: `lightbulb.project_autoresearch.ProjectAutoResearchObservationState` → `lightbulb.project_autoresearch.ProjectAutoResearchObservationState`.

Source: `lightbulb/project_autoresearch.py:50`.

### `lightbulb.ProjectAutoResearchRunState`

value. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProjectAutoResearchRunState
~~~


Binding: `lightbulb.project_autoresearch.ProjectAutoResearchRunState` → `lightbulb.project_autoresearch.ProjectAutoResearchRunState`.

Source: `lightbulb/project_autoresearch.py:42`.

### `lightbulb.ProjectAutoResearchStartReceipt`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProjectAutoResearchStartReceipt
~~~


Binding: `lightbulb.project_autoresearch.ProjectAutoResearchStartReceipt` → `lightbulb.project_autoresearch.ProjectAutoResearchStartReceipt`.

Source: `lightbulb/project_autoresearch.py:264`.

### `lightbulb.ProjectAutoResearchStartRequest`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProjectAutoResearchStartRequest
~~~


Binding: `lightbulb.project_autoresearch.ProjectAutoResearchStartRequest` → `lightbulb.project_autoresearch.ProjectAutoResearchStartRequest`.

Source: `lightbulb/project_autoresearch.py:116`.

### `lightbulb.ProjectAutoResearchStatusReceipt`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProjectAutoResearchStatusReceipt
~~~


Binding: `lightbulb.project_autoresearch.ProjectAutoResearchStatusReceipt` → `lightbulb.project_autoresearch.ProjectAutoResearchStatusReceipt`.

Source: `lightbulb/project_autoresearch.py:271`.

### `lightbulb.ActorBindingAssurance`

value. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ActorBindingAssurance
~~~


Binding: `lightbulb.project_learning_client.ActorBindingAssurance` → `lightbulb.project_learning_client.ActorBindingAssurance`.

Source: `lightbulb/project_learning_client.py:87`.

### `lightbulb.CapacityRuntime`

value. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CapacityRuntime
~~~


Binding: `lightbulb.project_learning_client.CapacityRuntime` → `lightbulb.project_learning_client.CapacityRuntime`.

Source: `lightbulb/project_learning_client.py:69`.

### `lightbulb.LearningCapacityAdmission`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import LearningCapacityAdmission
~~~


Binding: `lightbulb.project_learning_client.LearningCapacityAdmission` → `lightbulb.project_learning_client.LearningCapacityAdmission`.

Source: `lightbulb/project_learning_client.py:267`.

### `lightbulb.LearningRuntime`

value. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import LearningRuntime
~~~


Binding: `lightbulb.project_learning_client.LearningRuntime` → `lightbulb.project_learning_client.LearningRuntime`.

Source: `lightbulb/project_learning_client.py:62`.

### `lightbulb.LedgerStatus`

value. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import LedgerStatus
~~~


Binding: `lightbulb.project_learning_client.LedgerStatus` → `lightbulb.project_learning_client.LedgerStatus`.

Source: `lightbulb/project_learning_client.py:81`.

### `lightbulb.MemoryRunStatus`

value. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import MemoryRunStatus
~~~


Binding: `lightbulb.project_learning_client.MemoryRunStatus` → `lightbulb.project_learning_client.MemoryRunStatus`.

Source: `lightbulb/project_learning_client.py:70`.

### `lightbulb.ProjectLearningClient`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProjectLearningClient
~~~


Binding: `lightbulb.project_learning_client.ProjectLearningClient` → `lightbulb.project_learning_client.ProjectLearningClient`.

Source: `lightbulb/project_learning_client.py:671`.

### `lightbulb.ProjectLearningContractError`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProjectLearningContractError
~~~


Binding: `lightbulb.project_learning_client.ProjectLearningContractError` → `lightbulb.project_learning_client.ProjectLearningContractError`.

Source: `lightbulb/project_learning_client.py:173`.

### `lightbulb.ProjectLearningRunAdmissionInput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProjectLearningRunAdmissionInput
~~~


Binding: `lightbulb.project_learning_client.ProjectLearningRunAdmissionInput` → `lightbulb.project_learning_client.ProjectLearningRunAdmissionInput`.

Source: `lightbulb/project_learning_client.py:289`.

### `lightbulb.ProjectLearningRunAdmittedReceipt`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProjectLearningRunAdmittedReceipt
~~~


Binding: `lightbulb.project_learning_client.ProjectLearningRunAdmittedReceipt` → `lightbulb.project_learning_client.ProjectLearningRunAdmittedReceipt`.

Source: `lightbulb/project_learning_client.py:346`.

### `lightbulb.ProjectLearningRunInspection`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProjectLearningRunInspection
~~~


Binding: `lightbulb.project_learning_client.ProjectLearningRunInspection` → `lightbulb.project_learning_client.ProjectLearningRunInspection`.

Source: `lightbulb/project_learning_client.py:374`.

### `lightbulb.ProjectLearningRunLedger`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProjectLearningRunLedger
~~~


Binding: `lightbulb.project_learning_client.ProjectLearningRunLedger` → `lightbulb.project_learning_client.ProjectLearningRunLedger`.

Source: `lightbulb/project_learning_client.py:393`.

### `lightbulb.ProjectLearningRunPrepareInput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProjectLearningRunPrepareInput
~~~


Binding: `lightbulb.project_learning_client.ProjectLearningRunPrepareInput` → `lightbulb.project_learning_client.ProjectLearningRunPrepareInput`.

Source: `lightbulb/project_learning_client.py:188`.

### `lightbulb.ProjectLearningRunPreparedReceipt`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProjectLearningRunPreparedReceipt
~~~


Binding: `lightbulb.project_learning_client.ProjectLearningRunPreparedReceipt` → `lightbulb.project_learning_client.ProjectLearningRunPreparedReceipt`.

Source: `lightbulb/project_learning_client.py:317`.

### `lightbulb.PROJECT_LEARNING_EVENT_SOURCE`

constant alias. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROJECT_LEARNING_EVENT_SOURCE
~~~


Binding: `lightbulb.project_learning_events.PROJECT_LEARNING_EVENT_SOURCE` → `lightbulb.project_learning_events.PROJECT_LEARNING_RAW_RECEIPT_EVENT_SOURCE`.

Source: `lightbulb/project_learning_events.py:40`.

### `lightbulb.PROJECT_LEARNING_EVENT_TYPE_BY_RECEIPT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROJECT_LEARNING_EVENT_TYPE_BY_RECEIPT_SCHEMA
~~~


Binding: `lightbulb.project_learning_events.PROJECT_LEARNING_EVENT_TYPE_BY_RECEIPT_SCHEMA` → `lightbulb.project_learning_events.PROJECT_LEARNING_EVENT_TYPE_BY_RECEIPT_SCHEMA`.

Source: `lightbulb/project_learning_events.py:43`.

### `lightbulb.PROJECT_LEARNING_RAW_RECEIPT_EVENT_SOURCE`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROJECT_LEARNING_RAW_RECEIPT_EVENT_SOURCE
~~~


Binding: `lightbulb.project_learning_events.PROJECT_LEARNING_RAW_RECEIPT_EVENT_SOURCE` → `lightbulb.project_learning_events.PROJECT_LEARNING_RAW_RECEIPT_EVENT_SOURCE`.

Source: `lightbulb/project_learning_events.py:40`.

### `lightbulb.ProjectLearningReceiptValidationError`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProjectLearningReceiptValidationError
~~~


Binding: `lightbulb.project_learning_events.ProjectLearningReceiptValidationError` → `lightbulb.project_learning_events.ProjectLearningReceiptValidationError`.

Source: `lightbulb/project_learning_events.py:133`.

### `lightbulb.ProjectLearningWorkflowEventPayload`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProjectLearningWorkflowEventPayload
~~~


Binding: `lightbulb.project_learning_events.ProjectLearningWorkflowEventPayload` → `lightbulb.project_learning_events.ProjectLearningWorkflowEventPayload`.

Source: `lightbulb/project_learning_events.py:246`.

### `lightbulb.project_learning_receipt_to_workflow_event`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import project_learning_receipt_to_workflow_event
~~~


Binding: `lightbulb.project_learning_events.project_learning_receipt_to_workflow_event` → `lightbulb.project_learning_events.project_learning_receipt_to_workflow_event`.

Source: `lightbulb/project_learning_events.py:346`.

### `lightbulb.RUNTIME_OUTCOME_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import RUNTIME_OUTCOME_SCHEMA
~~~


Binding: `lightbulb.runtime_outcomes.RUNTIME_OUTCOME_SCHEMA` → `lightbulb.runtime_outcomes.RUNTIME_OUTCOME_SCHEMA`.

Source: `lightbulb/runtime_outcomes.py:26`.

### `lightbulb.CompositeOutcomeRecorder`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CompositeOutcomeRecorder
~~~


Binding: `lightbulb.runtime_outcomes.CompositeOutcomeRecorder` → `lightbulb.runtime_outcomes.CompositeOutcomeRecorder`.

Source: `lightbulb/runtime_outcomes.py:272`.

### `lightbulb.InMemoryOutcomeRecorder`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import InMemoryOutcomeRecorder
~~~


Binding: `lightbulb.runtime_outcomes.InMemoryOutcomeRecorder` → `lightbulb.runtime_outcomes.InMemoryOutcomeRecorder`.

Source: `lightbulb/runtime_outcomes.py:77`.

### `lightbulb.JsonlOutcomeRecorder`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import JsonlOutcomeRecorder
~~~


Binding: `lightbulb.runtime_outcomes.JsonlOutcomeRecorder` → `lightbulb.runtime_outcomes.JsonlOutcomeRecorder`.

Source: `lightbulb/runtime_outcomes.py:161`.

### `lightbulb.RuntimeOutcome`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import RuntimeOutcome
~~~


Binding: `lightbulb.runtime_outcomes.RuntimeOutcome` → `lightbulb.runtime_outcomes.RuntimeOutcome`.

Source: `lightbulb/runtime_outcomes.py:30`.

### `lightbulb.RuntimeOutcomeRecorder`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import RuntimeOutcomeRecorder
~~~


Binding: `lightbulb.runtime_outcomes.RuntimeOutcomeRecorder` → `lightbulb.runtime_outcomes.RuntimeOutcomeRecorder`.

Source: `lightbulb/runtime_outcomes.py:69`.

### `lightbulb.improvement_outcomes`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import improvement_outcomes
~~~


Binding: `lightbulb.runtime_outcomes.improvement_outcomes` → `lightbulb.runtime_outcomes.improvement_outcomes`.

Source: `lightbulb/runtime_outcomes.py:299`.

### `lightbulb.outcome_recorder_from_env`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import outcome_recorder_from_env
~~~


Binding: `lightbulb.runtime_outcomes.outcome_recorder_from_env` → `lightbulb.runtime_outcomes.outcome_recorder_from_env`.

Source: `lightbulb/runtime_outcomes.py:305`.

### `lightbulb.DURABLE_CHECKPOINT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import DURABLE_CHECKPOINT_SCHEMA
~~~


Binding: `lightbulb.durable_runtime.DURABLE_CHECKPOINT_SCHEMA` → `lightbulb.durable_runtime.DURABLE_CHECKPOINT_SCHEMA`.

Source: `lightbulb/durable_runtime.py:49`.

### `lightbulb.LEGACY_DURABLE_CHECKPOINT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import LEGACY_DURABLE_CHECKPOINT_SCHEMA
~~~


Binding: `lightbulb.durable_runtime.LEGACY_DURABLE_CHECKPOINT_SCHEMA` → `lightbulb.durable_runtime.LEGACY_DURABLE_CHECKPOINT_SCHEMA`.

Source: `lightbulb/durable_runtime.py:47`.

### `lightbulb.PREVIOUS_DURABLE_CHECKPOINT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PREVIOUS_DURABLE_CHECKPOINT_SCHEMA
~~~


Binding: `lightbulb.durable_runtime.PREVIOUS_DURABLE_CHECKPOINT_SCHEMA` → `lightbulb.durable_runtime.PREVIOUS_DURABLE_CHECKPOINT_SCHEMA`.

Source: `lightbulb/durable_runtime.py:48`.

### `lightbulb.WORKFLOW_EVENT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import WORKFLOW_EVENT_SCHEMA
~~~


Binding: `lightbulb.durable_runtime.WORKFLOW_EVENT_SCHEMA` → `lightbulb.durable_runtime.WORKFLOW_EVENT_SCHEMA`.

Source: `lightbulb/durable_runtime.py:50`.

### `lightbulb.CheckpointCompatibilityError`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CheckpointCompatibilityError
~~~


Binding: `lightbulb.durable_runtime.CheckpointCompatibilityError` → `lightbulb.durable_runtime.CheckpointCompatibilityError`.

Source: `lightbulb/durable_runtime.py:180`.

### `lightbulb.CheckpointConflictError`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CheckpointConflictError
~~~


Binding: `lightbulb.durable_runtime.CheckpointConflictError` → `lightbulb.durable_runtime.CheckpointConflictError`.

Source: `lightbulb/durable_runtime.py:168`.

### `lightbulb.CheckpointStatus`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CheckpointStatus
~~~


Binding: `lightbulb.durable_runtime.CheckpointStatus` → `lightbulb.durable_runtime.CheckpointStatus`.

Source: `lightbulb/durable_runtime.py:184`.

### `lightbulb.DurableProjectRuntime`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import DurableProjectRuntime
~~~


Binding: `lightbulb.durable_runtime.DurableProjectRuntime` → `lightbulb.durable_runtime.DurableProjectRuntime`.

Source: `lightbulb/durable_runtime.py:1157`.

### `lightbulb.HostedCheckpointStore`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import HostedCheckpointStore
~~~


Binding: `lightbulb.durable_runtime.HostedCheckpointStore` → `lightbulb.durable_runtime.HostedCheckpointStore`.

Source: `lightbulb/durable_runtime.py:973`.

### `lightbulb.InMemoryCheckpointStore`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import InMemoryCheckpointStore
~~~


Binding: `lightbulb.durable_runtime.InMemoryCheckpointStore` → `lightbulb.durable_runtime.InMemoryCheckpointStore`.

Source: `lightbulb/durable_runtime.py:548`.

### `lightbulb.JsonFileCheckpointStore`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import JsonFileCheckpointStore
~~~


Binding: `lightbulb.durable_runtime.JsonFileCheckpointStore` → `lightbulb.durable_runtime.JsonFileCheckpointStore`.

Source: `lightbulb/durable_runtime.py:773`.

### `lightbulb.WorkflowCheckpoint`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import WorkflowCheckpoint
~~~


Binding: `lightbulb.durable_runtime.WorkflowCheckpoint` → `lightbulb.durable_runtime.WorkflowCheckpoint`.

Source: `lightbulb/durable_runtime.py:227`.

### `lightbulb.WorkflowCheckpointStore`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import WorkflowCheckpointStore
~~~


Binding: `lightbulb.durable_runtime.WorkflowCheckpointStore` → `lightbulb.durable_runtime.WorkflowCheckpointStore`.

Source: `lightbulb/durable_runtime.py:496`.

### `lightbulb.WorkflowEventEnvelope`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import WorkflowEventEnvelope
~~~


Binding: `lightbulb.durable_runtime.WorkflowEventEnvelope` → `lightbulb.durable_runtime.WorkflowEventEnvelope`.

Source: `lightbulb/durable_runtime.py:197`.

### `lightbulb.default_checkpoint_dir`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import default_checkpoint_dir
~~~


Binding: `lightbulb.durable_runtime.default_checkpoint_dir` → `lightbulb.durable_runtime.default_checkpoint_dir`.

Source: `lightbulb/durable_runtime.py:136`.

### `lightbulb.DYNAMIC_WORKFLOW_HANDOFF_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import DYNAMIC_WORKFLOW_HANDOFF_SCHEMA
~~~


Binding: `lightbulb.dynamic_workflows.DYNAMIC_WORKFLOW_HANDOFF_SCHEMA` → `lightbulb.dynamic_workflows.DYNAMIC_WORKFLOW_HANDOFF_SCHEMA`.

Source: `lightbulb/dynamic_workflows.py:28`.

### `lightbulb.DYNAMIC_WORKFLOW_STATE_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import DYNAMIC_WORKFLOW_STATE_SCHEMA
~~~


Binding: `lightbulb.dynamic_workflows.DYNAMIC_WORKFLOW_STATE_SCHEMA` → `lightbulb.dynamic_workflows.DYNAMIC_WORKFLOW_STATE_SCHEMA`.

Source: `lightbulb/dynamic_workflows.py:27`.

### `lightbulb.AcceptanceCriterion`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import AcceptanceCriterion
~~~


Binding: `lightbulb.dynamic_workflows.AcceptanceCriterion` → `lightbulb.dynamic_workflows.AcceptanceCriterion`.

Source: `lightbulb/dynamic_workflows.py:240`.

### `lightbulb.BuilderAssignment`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import BuilderAssignment
~~~


Binding: `lightbulb.dynamic_workflows.BuilderAssignment` → `lightbulb.dynamic_workflows.BuilderAssignment`.

Source: `lightbulb/dynamic_workflows.py:317`.

### `lightbulb.BuilderOutcome`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import BuilderOutcome
~~~


Binding: `lightbulb.dynamic_workflows.BuilderOutcome` → `lightbulb.dynamic_workflows.BuilderOutcome`.

Source: `lightbulb/dynamic_workflows.py:114`.

### `lightbulb.BuilderResult`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import BuilderResult
~~~


Binding: `lightbulb.dynamic_workflows.BuilderResult` → `lightbulb.dynamic_workflows.BuilderResult`.

Source: `lightbulb/dynamic_workflows.py:358`.

### `lightbulb.CriterionEvaluation`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CriterionEvaluation
~~~


Binding: `lightbulb.dynamic_workflows.CriterionEvaluation` → `lightbulb.dynamic_workflows.CriterionEvaluation`.

Source: `lightbulb/dynamic_workflows.py:261`.

### `lightbulb.DynamicWorkflowError`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import DynamicWorkflowError
~~~


Binding: `lightbulb.dynamic_workflows.DynamicWorkflowError` → `lightbulb.dynamic_workflows.DynamicWorkflowError`.

Source: `lightbulb/dynamic_workflows.py:73`.

### `lightbulb.DynamicWorkflowHandoff`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import DynamicWorkflowHandoff
~~~


Binding: `lightbulb.dynamic_workflows.DynamicWorkflowHandoff` → `lightbulb.dynamic_workflows.DynamicWorkflowHandoff`.

Source: `lightbulb/dynamic_workflows.py:447`.

### `lightbulb.DynamicWorkflowRole`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import DynamicWorkflowRole
~~~


Binding: `lightbulb.dynamic_workflows.DynamicWorkflowRole` → `lightbulb.dynamic_workflows.DynamicWorkflowRole`.

Source: `lightbulb/dynamic_workflows.py:120`.

### `lightbulb.DynamicWorkflowScope`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import DynamicWorkflowScope
~~~


Binding: `lightbulb.dynamic_workflows.DynamicWorkflowScope` → `lightbulb.dynamic_workflows.DynamicWorkflowScope`.

Source: `lightbulb/dynamic_workflows.py:149`.

### `lightbulb.DynamicWorkflowState`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import DynamicWorkflowState
~~~


Binding: `lightbulb.dynamic_workflows.DynamicWorkflowState` → `lightbulb.dynamic_workflows.DynamicWorkflowState`.

Source: `lightbulb/dynamic_workflows.py:495`.

### `lightbulb.EvaluatorDecision`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import EvaluatorDecision
~~~


Binding: `lightbulb.dynamic_workflows.EvaluatorDecision` → `lightbulb.dynamic_workflows.EvaluatorDecision`.

Source: `lightbulb/dynamic_workflows.py:106`.

### `lightbulb.EvaluatorVerdict`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import EvaluatorVerdict
~~~


Binding: `lightbulb.dynamic_workflows.EvaluatorVerdict` → `lightbulb.dynamic_workflows.EvaluatorVerdict`.

Source: `lightbulb/dynamic_workflows.py:397`.

### `lightbulb.EvidenceRef`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import EvidenceRef
~~~


Binding: `lightbulb.dynamic_workflows.EvidenceRef` → `lightbulb.dynamic_workflows.EvidenceRef`.

Source: `lightbulb/dynamic_workflows.py:218`.

### `lightbulb.InvalidTransitionError`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import InvalidTransitionError
~~~


Binding: `lightbulb.dynamic_workflows.InvalidTransitionError` → `lightbulb.dynamic_workflows.InvalidTransitionError`.

Source: `lightbulb/dynamic_workflows.py:81`.

### `lightbulb.PlannerPlan`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PlannerPlan
~~~


Binding: `lightbulb.dynamic_workflows.PlannerPlan` → `lightbulb.dynamic_workflows.PlannerPlan`.

Source: `lightbulb/dynamic_workflows.py:276`.

### `lightbulb.ScopeMismatchError`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ScopeMismatchError
~~~


Binding: `lightbulb.dynamic_workflows.ScopeMismatchError` → `lightbulb.dynamic_workflows.ScopeMismatchError`.

Source: `lightbulb/dynamic_workflows.py:77`.

### `lightbulb.UsageDelta`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import UsageDelta
~~~


Binding: `lightbulb.dynamic_workflows.UsageDelta` → `lightbulb.dynamic_workflows.UsageDelta`.

Source: `lightbulb/dynamic_workflows.py:188`.

### `lightbulb.UsageTotals`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import UsageTotals
~~~


Binding: `lightbulb.dynamic_workflows.UsageTotals` → `lightbulb.dynamic_workflows.UsageTotals`.

Source: `lightbulb/dynamic_workflows.py:199`.

### `lightbulb.WorkflowLimits`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import WorkflowLimits
~~~


Binding: `lightbulb.dynamic_workflows.WorkflowLimits` → `lightbulb.dynamic_workflows.WorkflowLimits`.

Source: `lightbulb/dynamic_workflows.py:170`.

### `lightbulb.WorkflowRunStatus`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import WorkflowRunStatus
~~~


Binding: `lightbulb.dynamic_workflows.WorkflowRunStatus` → `lightbulb.dynamic_workflows.WorkflowRunStatus`.

Source: `lightbulb/dynamic_workflows.py:85`.

### `lightbulb.BUILTIN_DYNAMIC_WORKFLOW_HOST_ADAPTERS`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import BUILTIN_DYNAMIC_WORKFLOW_HOST_ADAPTERS
~~~


Binding: `lightbulb.dynamic_workflow_hosts.BUILTIN_DYNAMIC_WORKFLOW_HOST_ADAPTERS` → `lightbulb.dynamic_workflow_hosts.BUILTIN_DYNAMIC_WORKFLOW_HOST_ADAPTERS`.

Source: `lightbulb/dynamic_workflow_hosts.py:563`.

### `lightbulb.BUILTIN_DYNAMIC_WORKFLOW_HOST_IDS`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import BUILTIN_DYNAMIC_WORKFLOW_HOST_IDS
~~~


Binding: `lightbulb.dynamic_workflow_hosts.BUILTIN_DYNAMIC_WORKFLOW_HOST_IDS` → `lightbulb.dynamic_workflow_hosts.BUILTIN_DYNAMIC_WORKFLOW_HOST_IDS`.

Source: `lightbulb/dynamic_workflow_hosts.py:26`.

### `lightbulb.DYNAMIC_WORKFLOW_HOST_SESSION_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import DYNAMIC_WORKFLOW_HOST_SESSION_SCHEMA
~~~


Binding: `lightbulb.dynamic_workflow_hosts.DYNAMIC_WORKFLOW_HOST_SESSION_SCHEMA` → `lightbulb.dynamic_workflow_hosts.DYNAMIC_WORKFLOW_HOST_SESSION_SCHEMA`.

Source: `lightbulb/dynamic_workflow_hosts.py:24`.

### `lightbulb.DynamicWorkflowHostCapabilities`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import DynamicWorkflowHostCapabilities
~~~


Binding: `lightbulb.dynamic_workflow_hosts.DynamicWorkflowHostCapabilities` → `lightbulb.dynamic_workflow_hosts.DynamicWorkflowHostCapabilities`.

Source: `lightbulb/dynamic_workflow_hosts.py:188`.

### `lightbulb.DynamicWorkflowHostCapability`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import DynamicWorkflowHostCapability
~~~


Binding: `lightbulb.dynamic_workflow_hosts.DynamicWorkflowHostCapability` → `lightbulb.dynamic_workflow_hosts.DynamicWorkflowHostCapability`.

Source: `lightbulb/dynamic_workflow_hosts.py:175`.

### `lightbulb.DynamicWorkflowHostRegistry`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import DynamicWorkflowHostRegistry
~~~


Binding: `lightbulb.dynamic_workflow_hosts.DynamicWorkflowHostRegistry` → `lightbulb.dynamic_workflow_hosts.DynamicWorkflowHostRegistry`.

Source: `lightbulb/dynamic_workflow_hosts.py:474`.

### `lightbulb.DynamicWorkflowHostSessionIdentity`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import DynamicWorkflowHostSessionIdentity
~~~


Binding: `lightbulb.dynamic_workflow_hosts.DynamicWorkflowHostSessionIdentity` → `lightbulb.dynamic_workflow_hosts.DynamicWorkflowHostSessionIdentity`.

Source: `lightbulb/dynamic_workflow_hosts.py:214`.

### `lightbulb.default_dynamic_workflow_host_registry`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import default_dynamic_workflow_host_registry
~~~


Binding: `lightbulb.dynamic_workflow_hosts.default_dynamic_workflow_host_registry` → `lightbulb.dynamic_workflow_hosts.default_dynamic_workflow_host_registry`.

Source: `lightbulb/dynamic_workflow_hosts.py:617`.

### `lightbulb.DynamicWorkflowScopeDiscoveryClient`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import DynamicWorkflowScopeDiscoveryClient
~~~


Binding: `lightbulb.dynamic_workflow_scope_resolution.DynamicWorkflowScopeDiscoveryClient` → `lightbulb.dynamic_workflow_scope_resolution.DynamicWorkflowScopeDiscoveryClient`.

Source: `lightbulb/dynamic_workflow_scope_resolution.py:42`.

### `lightbulb.DynamicWorkflowScopeResolution`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import DynamicWorkflowScopeResolution
~~~


Binding: `lightbulb.dynamic_workflow_scope_resolution.DynamicWorkflowScopeResolution` → `lightbulb.dynamic_workflow_scope_resolution.DynamicWorkflowScopeResolution`.

Source: `lightbulb/dynamic_workflow_scope_resolution.py:220`.

### `lightbulb.DynamicWorkflowScopeResolutionError`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import DynamicWorkflowScopeResolutionError
~~~


Binding: `lightbulb.dynamic_workflow_scope_resolution.DynamicWorkflowScopeResolutionError` → `lightbulb.dynamic_workflow_scope_resolution.DynamicWorkflowScopeResolutionError`.

Source: `lightbulb/dynamic_workflow_scope_resolution.py:38`.

### `lightbulb.DynamicWorkflowScopeResolver`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import DynamicWorkflowScopeResolver
~~~


Binding: `lightbulb.dynamic_workflow_scope_resolution.DynamicWorkflowScopeResolver` → `lightbulb.dynamic_workflow_scope_resolution.DynamicWorkflowScopeResolver`.

Source: `lightbulb/dynamic_workflow_scope_resolution.py:334`.

### `lightbulb.ResolvedDynamicWorkflowScope`

class alias. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ResolvedDynamicWorkflowScope
~~~


Binding: `lightbulb.dynamic_workflow_scope_resolution.ResolvedDynamicWorkflowScope` → `lightbulb.dynamic_workflow_scope_resolution.DynamicWorkflowScopeResolution`.

Source: `lightbulb/dynamic_workflow_scope_resolution.py:220`.

### `lightbulb.resolve_dynamic_workflow_scope`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import resolve_dynamic_workflow_scope
~~~


Binding: `lightbulb.dynamic_workflow_scope_resolution.resolve_dynamic_workflow_scope` → `lightbulb.dynamic_workflow_scope_resolution.resolve_dynamic_workflow_scope`.

Source: `lightbulb/dynamic_workflow_scope_resolution.py:570`.

### `lightbulb.DYNAMIC_WORKFLOW_MCP_MANIFEST_SCHEMA`

constant alias. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import DYNAMIC_WORKFLOW_MCP_MANIFEST_SCHEMA
~~~


Binding: `lightbulb.dynamic_workflow_mcp.MANIFEST_SCHEMA` → `lightbulb.dynamic_workflow_mcp.MANIFEST_SCHEMA`.

Source: `lightbulb/dynamic_workflow_mcp.py:31`.

### `lightbulb.DYNAMIC_WORKFLOW_MCP_OPERATIONS`

constant alias. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import DYNAMIC_WORKFLOW_MCP_OPERATIONS
~~~


Binding: `lightbulb.dynamic_workflow_mcp.OPERATIONS` → `lightbulb.dynamic_workflow_mcp.OPERATIONS`.

Source: `lightbulb/dynamic_workflow_mcp.py:1421`.

### `lightbulb.render_dynamic_workflow_mcp_manifest`

function alias. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import render_dynamic_workflow_mcp_manifest
~~~


Binding: `lightbulb.dynamic_workflow_mcp.render_manifest` → `lightbulb.dynamic_workflow_mcp.render_manifest`.

Source: `lightbulb/dynamic_workflow_mcp.py:1878`.

### `lightbulb.render_dynamic_workflow_mcp_manifest_json`

function alias. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import render_dynamic_workflow_mcp_manifest_json
~~~


Binding: `lightbulb.dynamic_workflow_mcp.render_manifest_json` → `lightbulb.dynamic_workflow_mcp.render_manifest_json`.

Source: `lightbulb/dynamic_workflow_mcp.py:1916`.

### `lightbulb.render_dynamic_workflow_mcp_tool`

function alias. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import render_dynamic_workflow_mcp_tool
~~~


Binding: `lightbulb.dynamic_workflow_mcp.render_mcp_tool` → `lightbulb.dynamic_workflow_mcp.render_mcp_tool`.

Source: `lightbulb/dynamic_workflow_mcp.py:1836`.

### `lightbulb.CONNECTOR_BINDINGS`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CONNECTOR_BINDINGS
~~~


Binding: `lightbulb.connector_bindings.CONNECTOR_BINDINGS` → `lightbulb.connector_bindings.CONNECTOR_BINDINGS`.

Source: `lightbulb/connector_bindings.py:335`.

### `lightbulb.CONNECTOR_BINDING_REGISTRY_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CONNECTOR_BINDING_REGISTRY_SCHEMA
~~~


Binding: `lightbulb.connector_bindings.CONNECTOR_BINDING_REGISTRY_SCHEMA` → `lightbulb.connector_bindings.CONNECTOR_BINDING_REGISTRY_SCHEMA`.

Source: `lightbulb/connector_bindings.py:39`.

### `lightbulb.CONNECTOR_CONFORMANCE_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CONNECTOR_CONFORMANCE_SCHEMA
~~~


Binding: `lightbulb.connector_conformance.CONNECTOR_CONFORMANCE_SCHEMA` → `lightbulb.connector_conformance.CONNECTOR_CONFORMANCE_SCHEMA`.

Source: `lightbulb/connector_conformance.py:21`.

### `lightbulb.CONNECTOR_TOOL_CONTRACTS`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CONNECTOR_TOOL_CONTRACTS
~~~


Binding: `lightbulb.connector_conformance.CONNECTOR_TOOL_CONTRACTS` → `lightbulb.connector_conformance.CONNECTOR_TOOL_CONTRACTS`.

Source: `lightbulb/connector_conformance.py:167`.

### `lightbulb.ConnectorBinding`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ConnectorBinding
~~~


Binding: `lightbulb.connector_bindings.ConnectorBinding` → `lightbulb.connector_bindings.ConnectorBinding`.

Source: `lightbulb/connector_bindings.py:78`.

### `lightbulb.ConnectorBindingError`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ConnectorBindingError
~~~


Binding: `lightbulb.connector_bindings.ConnectorBindingError` → `lightbulb.connector_bindings.ConnectorBindingError`.

Source: `lightbulb/connector_bindings.py:51`.

### `lightbulb.ConnectorBindingRegistry`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ConnectorBindingRegistry
~~~


Binding: `lightbulb.connector_bindings.ConnectorBindingRegistry` → `lightbulb.connector_bindings.ConnectorBindingRegistry`.

Source: `lightbulb/connector_bindings.py:149`.

### `lightbulb.ConnectorCapability`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ConnectorCapability
~~~


Binding: `lightbulb.connector_bindings.ConnectorCapability` → `lightbulb.connector_bindings.ConnectorCapability`.

Source: `lightbulb/connector_bindings.py:94`.

### `lightbulb.ConnectorConformanceReport`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ConnectorConformanceReport
~~~


Binding: `lightbulb.connector_conformance.ConnectorConformanceReport` → `lightbulb.connector_conformance.ConnectorConformanceReport`.

Source: `lightbulb/connector_conformance.py:55`.

### `lightbulb.ConnectorConformanceResult`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ConnectorConformanceResult
~~~


Binding: `lightbulb.connector_conformance.ConnectorConformanceResult` → `lightbulb.connector_conformance.ConnectorConformanceResult`.

Source: `lightbulb/connector_conformance.py:44`.

### `lightbulb.ConnectorToolContract`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ConnectorToolContract
~~~


Binding: `lightbulb.connector_conformance.ConnectorToolContract` → `lightbulb.connector_conformance.ConnectorToolContract`.

Source: `lightbulb/connector_conformance.py:24`.

### `lightbulb.resolve_connector_tool`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import resolve_connector_tool
~~~


Binding: `lightbulb.connector_bindings.resolve_connector_tool` → `lightbulb.connector_bindings.resolve_connector_tool`.

Source: `lightbulb/connector_bindings.py:341`.

### `lightbulb.run_connector_conformance`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import run_connector_conformance
~~~


Binding: `lightbulb.connector_conformance.run_connector_conformance` → `lightbulb.connector_conformance.run_connector_conformance`.

Source: `lightbulb/connector_conformance.py:436`.

### `lightbulb.BOUNDED_WORKFLOW_LOOP_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import BOUNDED_WORKFLOW_LOOP_SCHEMA
~~~


Binding: `lightbulb.business_primitives.BOUNDED_WORKFLOW_LOOP_SCHEMA` → `lightbulb.business_primitives.BOUNDED_WORKFLOW_LOOP_SCHEMA`.

Source: `lightbulb/business_primitives.py:30`.

### `lightbulb.BusinessPrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import BusinessPrimitive
~~~


Binding: `lightbulb.business_primitives.BusinessPrimitive` → `lightbulb.business_primitives.BusinessPrimitive`.

Source: `lightbulb/business_primitives.py:199`.

### `lightbulb.PRIMITIVE_CAPABILITY_PROJECTION_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PRIMITIVE_CAPABILITY_PROJECTION_SCHEMA
~~~


Binding: `lightbulb.business_primitives.PRIMITIVE_CAPABILITY_PROJECTION_SCHEMA` → `lightbulb.business_primitives.PRIMITIVE_CAPABILITY_PROJECTION_SCHEMA`.

Source: `lightbulb/business_primitives.py:25`.

### `lightbulb.PRIMITIVE_RUNTIME_CONTRACT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PRIMITIVE_RUNTIME_CONTRACT_SCHEMA
~~~


Binding: `lightbulb.business_primitives.PRIMITIVE_RUNTIME_CONTRACT_SCHEMA` → `lightbulb.business_primitives.PRIMITIVE_RUNTIME_CONTRACT_SCHEMA`.

Source: `lightbulb/business_primitives.py:24`.

### `lightbulb.PrimitiveField`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PrimitiveField
~~~


Binding: `lightbulb.business_primitives.PrimitiveField` → `lightbulb.business_primitives.PrimitiveField`.

Source: `lightbulb/business_primitives.py:183`.

### `lightbulb.WORKFLOW_COMPILER_CONTRACT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import WORKFLOW_COMPILER_CONTRACT_SCHEMA
~~~


Binding: `lightbulb.business_primitives.WORKFLOW_COMPILER_CONTRACT_SCHEMA` → `lightbulb.business_primitives.WORKFLOW_COMPILER_CONTRACT_SCHEMA`.

Source: `lightbulb/business_primitives.py:26`.

### `lightbulb.WORKFLOW_DEFINITION_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import WORKFLOW_DEFINITION_SCHEMA
~~~


Binding: `lightbulb.business_primitives.WORKFLOW_DEFINITION_SCHEMA` → `lightbulb.business_primitives.WORKFLOW_DEFINITION_SCHEMA`.

Source: `lightbulb/business_primitives.py:27`.

### `lightbulb.WORKFLOW_SIMULATION_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import WORKFLOW_SIMULATION_SCHEMA
~~~


Binding: `lightbulb.business_primitives.WORKFLOW_SIMULATION_SCHEMA` → `lightbulb.business_primitives.WORKFLOW_SIMULATION_SCHEMA`.

Source: `lightbulb/business_primitives.py:29`.

### `lightbulb.WORKFLOW_VALIDATION_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import WORKFLOW_VALIDATION_SCHEMA
~~~


Binding: `lightbulb.business_primitives.WORKFLOW_VALIDATION_SCHEMA` → `lightbulb.business_primitives.WORKFLOW_VALIDATION_SCHEMA`.

Source: `lightbulb/business_primitives.py:28`.

### `lightbulb.business_primitive_capability_projection`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import business_primitive_capability_projection
~~~


Binding: `lightbulb.business_primitives.business_primitive_capability_projection` → `lightbulb.business_primitives.business_primitive_capability_projection`.

Source: `lightbulb/business_primitives.py:4339`.

### `lightbulb.business_primitive_capability_projections`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import business_primitive_capability_projections
~~~


Binding: `lightbulb.business_primitives.business_primitive_capability_projections` → `lightbulb.business_primitives.business_primitive_capability_projections`.

Source: `lightbulb/business_primitives.py:4350`.

### `lightbulb.business_primitive_catalog`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import business_primitive_catalog
~~~


Binding: `lightbulb.business_primitives.business_primitive_catalog` → `lightbulb.business_primitives.business_primitive_catalog`.

Source: `lightbulb/business_primitives.py:4105`.

### `lightbulb.business_workflow_builder_context`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import business_workflow_builder_context
~~~


Binding: `lightbulb.business_primitives.business_workflow_builder_context` → `lightbulb.business_primitives.business_workflow_builder_context`.

Source: `lightbulb/business_primitives.py:4589`.

### `lightbulb.business_workflow_builder_prompt`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import business_workflow_builder_prompt
~~~


Binding: `lightbulb.business_primitives.business_workflow_builder_prompt` → `lightbulb.business_primitives.business_workflow_builder_prompt`.

Source: `lightbulb/business_primitives.py:6286`.

### `lightbulb.compile_business_workflow_definition`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import compile_business_workflow_definition
~~~


Binding: `lightbulb.business_primitives.compile_business_workflow_definition` → `lightbulb.business_primitives.compile_business_workflow_definition`.

Source: `lightbulb/business_primitives.py:4816`.

### `lightbulb.compose_business_workflow`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import compose_business_workflow
~~~


Binding: `lightbulb.business_primitives.compose_business_workflow` → `lightbulb.business_primitives.compose_business_workflow`.

Source: `lightbulb/business_primitives.py:6304`.

### `lightbulb.execute_business_primitive`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import execute_business_primitive
~~~


Binding: `lightbulb.business_primitives.execute_business_primitive` → `lightbulb.business_primitives.execute_business_primitive`.

Source: `lightbulb/business_primitives.py:4564`.

### `lightbulb.get_business_primitive`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import get_business_primitive
~~~


Binding: `lightbulb.business_primitives.get_business_primitive` → `lightbulb.business_primitives.get_business_primitive`.

Source: `lightbulb/business_primitives.py:4051`.

### `lightbulb.list_business_primitives`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import list_business_primitives
~~~


Binding: `lightbulb.business_primitives.list_business_primitives` → `lightbulb.business_primitives.list_business_primitives`.

Source: `lightbulb/business_primitives.py:4059`.

### `lightbulb.primitive_runtime_contract`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import primitive_runtime_contract
~~~


Binding: `lightbulb.business_primitives.primitive_runtime_contract` → `lightbulb.business_primitives.primitive_runtime_contract`.

Source: `lightbulb/business_primitives.py:272`.

### `lightbulb.recommend_business_primitives`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import recommend_business_primitives
~~~


Binding: `lightbulb.business_primitives.recommend_business_primitives` → `lightbulb.business_primitives.recommend_business_primitives`.

Source: `lightbulb/business_primitives.py:4747`.

### `lightbulb.sdk_only_business_primitive_capability_projections`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import sdk_only_business_primitive_capability_projections
~~~


Binding: `lightbulb.business_primitives.sdk_only_business_primitive_capability_projections` → `lightbulb.business_primitives.sdk_only_business_primitive_capability_projections`.

Source: `lightbulb/business_primitives.py:4455`.

### `lightbulb.simulate_business_workflow`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import simulate_business_workflow
~~~


Binding: `lightbulb.business_primitives.simulate_business_workflow` → `lightbulb.business_primitives.simulate_business_workflow`.

Source: `lightbulb/business_primitives.py:5943`.

### `lightbulb.validate_business_workflow_definition`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import validate_business_workflow_definition
~~~


Binding: `lightbulb.business_primitives.validate_business_workflow_definition` → `lightbulb.business_primitives.validate_business_workflow_definition`.

Source: `lightbulb/business_primitives.py:5232`.

### `lightbulb.workflow_compiler_contract`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import workflow_compiler_contract
~~~


Binding: `lightbulb.business_primitives.workflow_compiler_contract` → `lightbulb.business_primitives.workflow_compiler_contract`.

Source: `lightbulb/business_primitives.py:4644`.

### `lightbulb.AGENT_MARKETPLACE_CATALOG_SCHEMA`

constant alias. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import AGENT_MARKETPLACE_CATALOG_SCHEMA
~~~


Binding: `lightbulb.marketplace.CATALOG_SCHEMA` → `lightbulb.marketplace.CATALOG_SCHEMA`.

Source: `lightbulb/marketplace.py:13`.

### `lightbulb.AGENT_MARKETPLACE_LISTING_SCHEMA`

constant alias. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import AGENT_MARKETPLACE_LISTING_SCHEMA
~~~


Binding: `lightbulb.marketplace.LISTING_SCHEMA` → `lightbulb.marketplace.LISTING_SCHEMA`.

Source: `lightbulb/marketplace.py:14`.

### `lightbulb.agent_marketplace_catalog`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import agent_marketplace_catalog
~~~


Binding: `lightbulb.marketplace.agent_marketplace_catalog` → `lightbulb.marketplace.agent_marketplace_catalog`.

Source: `lightbulb/marketplace.py:319`.

### `lightbulb.AGENT_EPISODE_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import AGENT_EPISODE_SCHEMA
~~~


Binding: `lightbulb.project_creation.AGENT_EPISODE_SCHEMA` → `lightbulb.project_creation.AGENT_EPISODE_SCHEMA`.

Source: `lightbulb/project_creation.py:36`.

### `lightbulb.PROJECT_CREATION_DRAFT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROJECT_CREATION_DRAFT_SCHEMA
~~~


Binding: `lightbulb.project_creation.PROJECT_CREATION_DRAFT_SCHEMA` → `lightbulb.project_creation.PROJECT_CREATION_DRAFT_SCHEMA`.

Source: `lightbulb/project_creation.py:31`.

### `lightbulb.PROJECT_CREATION_PREFLIGHT_RECEIPT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROJECT_CREATION_PREFLIGHT_RECEIPT_SCHEMA
~~~


Binding: `lightbulb.project_creation.PROJECT_CREATION_PREFLIGHT_RECEIPT_SCHEMA` → `lightbulb.project_creation.PROJECT_CREATION_PREFLIGHT_RECEIPT_SCHEMA`.

Source: `lightbulb/project_creation.py:30`.

### `lightbulb.PROJECT_CREATION_PREFLIGHT_REFINEMENT_REQUEST_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROJECT_CREATION_PREFLIGHT_REFINEMENT_REQUEST_SCHEMA
~~~


Binding: `lightbulb.project_creation.PROJECT_CREATION_PREFLIGHT_REFINEMENT_REQUEST_SCHEMA` → `lightbulb.project_creation.PROJECT_CREATION_PREFLIGHT_REFINEMENT_REQUEST_SCHEMA`.

Source: `lightbulb/project_creation.py:33`.

### `lightbulb.PROJECT_CREATION_PREFLIGHT_REQUEST_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROJECT_CREATION_PREFLIGHT_REQUEST_SCHEMA
~~~


Binding: `lightbulb.project_creation.PROJECT_CREATION_PREFLIGHT_REQUEST_SCHEMA` → `lightbulb.project_creation.PROJECT_CREATION_PREFLIGHT_REQUEST_SCHEMA`.

Source: `lightbulb/project_creation.py:32`.

### `lightbulb.PROJECT_CREATION_PREFLIGHT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROJECT_CREATION_PREFLIGHT_SCHEMA
~~~


Binding: `lightbulb.project_creation.PROJECT_CREATION_PREFLIGHT_SCHEMA` → `lightbulb.project_creation.PROJECT_CREATION_PREFLIGHT_SCHEMA`.

Source: `lightbulb/project_creation.py:29`.

### `lightbulb.PROJECT_GAME_START_FIRST_MISSION_PROMPT`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROJECT_GAME_START_FIRST_MISSION_PROMPT
~~~


Binding: `lightbulb.project_creation.PROJECT_GAME_START_FIRST_MISSION_PROMPT` → `lightbulb.project_creation.PROJECT_GAME_START_FIRST_MISSION_PROMPT`.

Source: `lightbulb/project_creation.py:39`.

### `lightbulb.PROJECT_GAME_START_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROJECT_GAME_START_SCHEMA
~~~


Binding: `lightbulb.project_creation.PROJECT_GAME_START_SCHEMA` → `lightbulb.project_creation.PROJECT_GAME_START_SCHEMA`.

Source: `lightbulb/project_creation.py:38`.

### `lightbulb.PROJECT_PLAY_STYLE_DEFAULT`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROJECT_PLAY_STYLE_DEFAULT
~~~


Binding: `lightbulb.project_creation.PROJECT_PLAY_STYLE_DEFAULT` → `lightbulb.project_game.PROJECT_PLAY_STYLE_DEFAULT`.

Source: `lightbulb/project_game.py:70`.

### `lightbulb.PROJECT_PLAY_STYLE_IDS`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROJECT_PLAY_STYLE_IDS
~~~


Binding: `lightbulb.project_creation.PROJECT_PLAY_STYLE_IDS` → `lightbulb.project_game.PROJECT_PLAY_STYLE_IDS`.

Source: `lightbulb/project_game.py:71`.

### `lightbulb.PROJECT_GAME_CAMPAIGN_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROJECT_GAME_CAMPAIGN_SCHEMA
~~~


Binding: `lightbulb.project_creation.PROJECT_GAME_CAMPAIGN_SCHEMA` → `lightbulb.project_game.PROJECT_GAME_CAMPAIGN_SCHEMA`.

Source: `lightbulb/project_game.py:19`.

### `lightbulb.PROJECT_GAME_CHECKPOINT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROJECT_GAME_CHECKPOINT_SCHEMA
~~~


Binding: `lightbulb.project_creation.PROJECT_GAME_CHECKPOINT_SCHEMA` → `lightbulb.project_game.PROJECT_GAME_CHECKPOINT_SCHEMA`.

Source: `lightbulb/project_game.py:20`.

### `lightbulb.PROJECT_LEARNING_LAB_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROJECT_LEARNING_LAB_SCHEMA
~~~


Binding: `lightbulb.project_creation.PROJECT_LEARNING_LAB_SCHEMA` → `lightbulb.project_game.PROJECT_LEARNING_LAB_SCHEMA`.

Source: `lightbulb/project_game.py:34`.

### `lightbulb.PROJECT_LEARNING_REVIEW_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROJECT_LEARNING_REVIEW_SCHEMA
~~~


Binding: `lightbulb.project_creation.PROJECT_LEARNING_REVIEW_SCHEMA` → `lightbulb.project_game.PROJECT_LEARNING_REVIEW_SCHEMA`.

Source: `lightbulb/project_game.py:27`.

### `lightbulb.PROJECT_MISSION_DEBRIEF_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROJECT_MISSION_DEBRIEF_SCHEMA
~~~


Binding: `lightbulb.project_creation.PROJECT_MISSION_DEBRIEF_SCHEMA` → `lightbulb.project_game.PROJECT_MISSION_DEBRIEF_SCHEMA`.

Source: `lightbulb/project_game.py:21`.

### `lightbulb.PROJECT_MISSION_BRIEFING_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROJECT_MISSION_BRIEFING_SCHEMA
~~~


Binding: `lightbulb.project_creation.PROJECT_MISSION_BRIEFING_SCHEMA` → `lightbulb.project_game.PROJECT_MISSION_BRIEFING_SCHEMA`.

Source: `lightbulb/project_game.py:22`.

### `lightbulb.PROJECT_SCIENCE_LAB_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROJECT_SCIENCE_LAB_SCHEMA
~~~


Binding: `lightbulb.project_creation.PROJECT_SCIENCE_LAB_SCHEMA` → `lightbulb.project_game.PROJECT_SCIENCE_LAB_SCHEMA`.

Source: `lightbulb/project_game.py:58`.

### `lightbulb.PROJECT_PREFLIGHT_ANSWER_MAX_CHARS`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROJECT_PREFLIGHT_ANSWER_MAX_CHARS
~~~


Binding: `lightbulb.project_creation.PROJECT_PREFLIGHT_ANSWER_MAX_CHARS` → `lightbulb.project_creation.PROJECT_PREFLIGHT_ANSWER_MAX_CHARS`.

Source: `lightbulb/project_creation.py:76`.

### `lightbulb.PROJECT_PREFLIGHT_MAX_REFINEMENT_DEPTH`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROJECT_PREFLIGHT_MAX_REFINEMENT_DEPTH
~~~


Binding: `lightbulb.project_creation.PROJECT_PREFLIGHT_MAX_REFINEMENT_DEPTH` → `lightbulb.project_creation.PROJECT_PREFLIGHT_MAX_REFINEMENT_DEPTH`.

Source: `lightbulb/project_creation.py:78`.

### `lightbulb.PROJECT_START_READINESS_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROJECT_START_READINESS_SCHEMA
~~~


Binding: `lightbulb.project_creation.PROJECT_START_READINESS_SCHEMA` → `lightbulb.project_creation.PROJECT_START_READINESS_SCHEMA`.

Source: `lightbulb/project_creation.py:37`.

### `lightbulb.SKILL_TOURNAMENT_APPLICATION_TRACE_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SKILL_TOURNAMENT_APPLICATION_TRACE_SCHEMA
~~~


Binding: `lightbulb.project_creation.SKILL_TOURNAMENT_APPLICATION_TRACE_SCHEMA` → `lightbulb.project_game.SKILL_TOURNAMENT_APPLICATION_TRACE_SCHEMA`.

Source: `lightbulb/project_game.py:66`.

### `lightbulb.SKILL_TOURNAMENT_CAPTURE_BUNDLE_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SKILL_TOURNAMENT_CAPTURE_BUNDLE_SCHEMA
~~~


Binding: `lightbulb.project_creation.SKILL_TOURNAMENT_CAPTURE_BUNDLE_SCHEMA` → `lightbulb.project_game.SKILL_TOURNAMENT_CAPTURE_BUNDLE_SCHEMA`.

Source: `lightbulb/project_game.py:63`.

### `lightbulb.SKILL_TOURNAMENT_CAPTURE_REQUEST_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SKILL_TOURNAMENT_CAPTURE_REQUEST_SCHEMA
~~~


Binding: `lightbulb.project_creation.SKILL_TOURNAMENT_CAPTURE_REQUEST_SCHEMA` → `lightbulb.project_game.SKILL_TOURNAMENT_CAPTURE_REQUEST_SCHEMA`.

Source: `lightbulb/project_game.py:62`.

### `lightbulb.SKILL_TOURNAMENT_CAPTURE_VERIFICATION_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SKILL_TOURNAMENT_CAPTURE_VERIFICATION_SCHEMA
~~~


Binding: `lightbulb.project_creation.SKILL_TOURNAMENT_CAPTURE_VERIFICATION_SCHEMA` → `lightbulb.project_game.SKILL_TOURNAMENT_CAPTURE_VERIFICATION_SCHEMA`.

Source: `lightbulb/project_game.py:65`.

### `lightbulb.SKILL_TOURNAMENT_EVALUATION_RECEIPT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SKILL_TOURNAMENT_EVALUATION_RECEIPT_SCHEMA
~~~


Binding: `lightbulb.project_creation.SKILL_TOURNAMENT_EVALUATION_RECEIPT_SCHEMA` → `lightbulb.project_game.SKILL_TOURNAMENT_EVALUATION_RECEIPT_SCHEMA`.

Source: `lightbulb/project_game.py:61`.

### `lightbulb.SKILL_TOURNAMENT_EVALUATION_REQUEST_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SKILL_TOURNAMENT_EVALUATION_REQUEST_SCHEMA
~~~


Binding: `lightbulb.project_creation.SKILL_TOURNAMENT_EVALUATION_REQUEST_SCHEMA` → `lightbulb.project_game.SKILL_TOURNAMENT_EVALUATION_REQUEST_SCHEMA`.

Source: `lightbulb/project_game.py:60`.

### `lightbulb.SKILL_TOURNAMENT_EPISODE_RECEIPT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SKILL_TOURNAMENT_EPISODE_RECEIPT_SCHEMA
~~~


Binding: `lightbulb.project_creation.SKILL_TOURNAMENT_EPISODE_RECEIPT_SCHEMA` → `lightbulb.project_game.SKILL_TOURNAMENT_EPISODE_RECEIPT_SCHEMA`.

Source: `lightbulb/project_game.py:64`.

### `lightbulb.SKILL_TOURNAMENT_ORCHESTRATION_RECEIPT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SKILL_TOURNAMENT_ORCHESTRATION_RECEIPT_SCHEMA
~~~


Binding: `lightbulb.project_creation.SKILL_TOURNAMENT_ORCHESTRATION_RECEIPT_SCHEMA` → `lightbulb.project_game.SKILL_TOURNAMENT_ORCHESTRATION_RECEIPT_SCHEMA`.

Source: `lightbulb/project_game.py:68`.

### `lightbulb.SKILL_TOURNAMENT_RUNTIME_CONTRACT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SKILL_TOURNAMENT_RUNTIME_CONTRACT_SCHEMA
~~~


Binding: `lightbulb.project_creation.SKILL_TOURNAMENT_RUNTIME_CONTRACT_SCHEMA` → `lightbulb.project_game.SKILL_TOURNAMENT_RUNTIME_CONTRACT_SCHEMA`.

Source: `lightbulb/project_game.py:67`.

### `lightbulb.SKILL_TOURNAMENT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SKILL_TOURNAMENT_SCHEMA
~~~


Binding: `lightbulb.project_creation.SKILL_TOURNAMENT_SCHEMA` → `lightbulb.project_game.SKILL_TOURNAMENT_SCHEMA`.

Source: `lightbulb/project_game.py:59`.

### `lightbulb.ProjectCreationDraft`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProjectCreationDraft
~~~


Binding: `lightbulb.project_creation.ProjectCreationDraft` → `lightbulb.project_creation.ProjectCreationDraft`.

Source: `lightbulb/project_creation.py:302`.

### `lightbulb.ProjectCreationEpisodeScope`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProjectCreationEpisodeScope
~~~


Binding: `lightbulb.project_creation.ProjectCreationEpisodeScope` → `lightbulb.project_creation.ProjectCreationEpisodeScope`.

Source: `lightbulb/project_creation.py:977`.

### `lightbulb.ProjectCreationPreflight`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProjectCreationPreflight
~~~


Binding: `lightbulb.project_creation.ProjectCreationPreflight` → `lightbulb.project_creation.ProjectCreationPreflight`.

Source: `lightbulb/project_creation.py:784`.

### `lightbulb.PreflightCriticalityFinding`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PreflightCriticalityFinding
~~~


Binding: `lightbulb.project_creation.PreflightCriticalityFinding` → `lightbulb.project_creation.PreflightCriticalityFinding`.

Source: `lightbulb/project_creation.py:590`.

### `lightbulb.ProjectCreationPreflightError`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProjectCreationPreflightError
~~~


Binding: `lightbulb.project_creation.ProjectCreationPreflightError` → `lightbulb.project_creation.ProjectCreationPreflightError`.

Source: `lightbulb/project_creation.py:271`.

### `lightbulb.ProjectCreationPreflightRefinement`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProjectCreationPreflightRefinement
~~~


Binding: `lightbulb.project_creation.ProjectCreationPreflightRefinement` → `lightbulb.project_creation.ProjectCreationPreflightRefinement`.

Source: `lightbulb/project_creation.py:993`.

### `lightbulb.ProjectCreationPreflightReceipt`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProjectCreationPreflightReceipt
~~~


Binding: `lightbulb.project_creation.ProjectCreationPreflightReceipt` → `lightbulb.project_creation.ProjectCreationPreflightReceipt`.

Source: `lightbulb/project_creation.py:1057`.

### `lightbulb.inspect_project_game_campaign`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import inspect_project_game_campaign
~~~


Binding: `lightbulb.project_creation.inspect_project_game_campaign` → `lightbulb.project_game.inspect_project_game_campaign`.

Source: `lightbulb/project_game.py:5643`.

### `lightbulb.inspect_project_creation_world_ready`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import inspect_project_creation_world_ready
~~~


Binding: `lightbulb.project_creation.inspect_project_creation_world_ready` → `lightbulb.project_creation.inspect_project_creation_world_ready`.

Source: `lightbulb/project_creation.py:441`.

### `lightbulb.normalize_project_play_style`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import normalize_project_play_style
~~~


Binding: `lightbulb.project_creation.normalize_project_play_style` → `lightbulb.project_game.normalize_project_play_style`.

Source: `lightbulb/project_game.py:109`.

### `lightbulb.PROJECT_GAME_SNAPSHOT_LOCKED_AUTHORITY`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROJECT_GAME_SNAPSHOT_LOCKED_AUTHORITY
~~~


Binding: `lightbulb.project_game_snapshot.PROJECT_GAME_SNAPSHOT_LOCKED_AUTHORITY` → `lightbulb.project_game_snapshot.PROJECT_GAME_SNAPSHOT_LOCKED_AUTHORITY`.

Source: `lightbulb/project_game_snapshot.py:160`.

### `lightbulb.PROJECT_GAME_SNAPSHOT_MAX_JSON_BYTES`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROJECT_GAME_SNAPSHOT_MAX_JSON_BYTES
~~~


Binding: `lightbulb.project_game_snapshot.PROJECT_GAME_SNAPSHOT_MAX_JSON_BYTES` → `lightbulb.project_game_snapshot.PROJECT_GAME_SNAPSHOT_MAX_JSON_BYTES`.

Source: `lightbulb/project_game_snapshot.py:22`.

### `lightbulb.PROJECT_GAME_SNAPSHOT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROJECT_GAME_SNAPSHOT_SCHEMA
~~~


Binding: `lightbulb.project_game_snapshot.PROJECT_GAME_SNAPSHOT_SCHEMA` → `lightbulb.project_game_snapshot.PROJECT_GAME_SNAPSHOT_SCHEMA`.

Source: `lightbulb/project_game_snapshot.py:21`.

### `lightbulb.normalize_project_game_snapshot_uuid`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import normalize_project_game_snapshot_uuid
~~~


Binding: `lightbulb.project_game_snapshot.normalize_project_game_snapshot_uuid` → `lightbulb.project_game_snapshot.normalize_project_game_snapshot_uuid`.

Source: `lightbulb/project_game_snapshot.py:183`.

### `lightbulb.validate_project_game_snapshot`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import validate_project_game_snapshot
~~~


Binding: `lightbulb.project_game_snapshot.validate_project_game_snapshot` → `lightbulb.project_game_snapshot.validate_project_game_snapshot`.

Source: `lightbulb/project_game_snapshot.py:313`.

### `lightbulb.PROJECT_BUSINESS_OUTCOME_LEDGER_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROJECT_BUSINESS_OUTCOME_LEDGER_SCHEMA
~~~


Binding: `lightbulb.project_outcomes.PROJECT_BUSINESS_OUTCOME_LEDGER_SCHEMA` → `lightbulb.project_outcomes.PROJECT_BUSINESS_OUTCOME_LEDGER_SCHEMA`.

Source: `lightbulb/project_outcomes.py:16`.

### `lightbulb.PROJECT_BUSINESS_OUTCOME_OBSERVATION_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROJECT_BUSINESS_OUTCOME_OBSERVATION_SCHEMA
~~~


Binding: `lightbulb.project_outcomes.PROJECT_BUSINESS_OUTCOME_OBSERVATION_SCHEMA` → `lightbulb.project_outcomes.PROJECT_BUSINESS_OUTCOME_OBSERVATION_SCHEMA`.

Source: `lightbulb/project_outcomes.py:12`.

### `lightbulb.PROJECT_BUSINESS_OUTCOME_RECEIPT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROJECT_BUSINESS_OUTCOME_RECEIPT_SCHEMA
~~~


Binding: `lightbulb.project_outcomes.PROJECT_BUSINESS_OUTCOME_RECEIPT_SCHEMA` → `lightbulb.project_outcomes.PROJECT_BUSINESS_OUTCOME_RECEIPT_SCHEMA`.

Source: `lightbulb/project_outcomes.py:15`.

### `lightbulb.build_project_business_outcome_observation`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import build_project_business_outcome_observation
~~~


Binding: `lightbulb.project_outcomes.build_project_business_outcome_observation` → `lightbulb.project_outcomes.build_project_business_outcome_observation`.

Source: `lightbulb/project_outcomes.py:110`.

### `lightbulb.PROJECT_MISSION_ACTION_BINDING_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROJECT_MISSION_ACTION_BINDING_SCHEMA
~~~


Binding: `lightbulb.project_missions.PROJECT_MISSION_ACTION_BINDING_SCHEMA` → `lightbulb.project_missions.PROJECT_MISSION_ACTION_BINDING_SCHEMA`.

Source: `lightbulb/project_missions.py:13`.

### `lightbulb.PROJECT_MISSION_ACTION_RECEIPT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROJECT_MISSION_ACTION_RECEIPT_SCHEMA
~~~


Binding: `lightbulb.project_missions.PROJECT_MISSION_ACTION_RECEIPT_SCHEMA` → `lightbulb.project_missions.PROJECT_MISSION_ACTION_RECEIPT_SCHEMA`.

Source: `lightbulb/project_missions.py:14`.

### `lightbulb.PROJECT_MISSION_RUN_LEDGER_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROJECT_MISSION_RUN_LEDGER_SCHEMA
~~~


Binding: `lightbulb.project_missions.PROJECT_MISSION_RUN_LEDGER_SCHEMA` → `lightbulb.project_missions.PROJECT_MISSION_RUN_LEDGER_SCHEMA`.

Source: `lightbulb/project_missions.py:15`.

### `lightbulb.PROJECT_MISSION_RUN_RECEIPT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROJECT_MISSION_RUN_RECEIPT_SCHEMA
~~~


Binding: `lightbulb.project_missions.PROJECT_MISSION_RUN_RECEIPT_SCHEMA` → `lightbulb.project_missions.PROJECT_MISSION_RUN_RECEIPT_SCHEMA`.

Source: `lightbulb/project_missions.py:12`.

### `lightbulb.PROJECT_MISSION_RUN_START_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROJECT_MISSION_RUN_START_SCHEMA
~~~


Binding: `lightbulb.project_missions.PROJECT_MISSION_RUN_START_SCHEMA` → `lightbulb.project_missions.PROJECT_MISSION_RUN_START_SCHEMA`.

Source: `lightbulb/project_missions.py:11`.

### `lightbulb.build_project_mission_action_binding`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import build_project_mission_action_binding
~~~


Binding: `lightbulb.project_missions.build_project_mission_action_binding` → `lightbulb.project_missions.build_project_mission_action_binding`.

Source: `lightbulb/project_missions.py:161`.

### `lightbulb.build_project_mission_run_start`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import build_project_mission_run_start
~~~


Binding: `lightbulb.project_missions.build_project_mission_run_start` → `lightbulb.project_missions.build_project_mission_run_start`.

Source: `lightbulb/project_missions.py:74`.

### `lightbulb.PROJECT_LEARNING_REVIEW_LEDGER_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROJECT_LEARNING_REVIEW_LEDGER_SCHEMA
~~~


Binding: `lightbulb.project_learning_reviews.PROJECT_LEARNING_REVIEW_LEDGER_SCHEMA` → `lightbulb.project_learning_reviews.PROJECT_LEARNING_REVIEW_LEDGER_SCHEMA`.

Source: `lightbulb/project_learning_reviews.py:13`.

### `lightbulb.PROJECT_LEARNING_REVIEW_RECEIPT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROJECT_LEARNING_REVIEW_RECEIPT_SCHEMA
~~~


Binding: `lightbulb.project_learning_reviews.PROJECT_LEARNING_REVIEW_RECEIPT_SCHEMA` → `lightbulb.project_learning_reviews.PROJECT_LEARNING_REVIEW_RECEIPT_SCHEMA`.

Source: `lightbulb/project_learning_reviews.py:12`.

### `lightbulb.PROJECT_LEARNING_REVIEW_REQUEST_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROJECT_LEARNING_REVIEW_REQUEST_SCHEMA
~~~


Binding: `lightbulb.project_learning_reviews.PROJECT_LEARNING_REVIEW_REQUEST_SCHEMA` → `lightbulb.project_learning_reviews.PROJECT_LEARNING_REVIEW_REQUEST_SCHEMA`.

Source: `lightbulb/project_learning_reviews.py:11`.

### `lightbulb.build_project_learning_review_request`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import build_project_learning_review_request
~~~


Binding: `lightbulb.project_learning_reviews.build_project_learning_review_request` → `lightbulb.project_learning_reviews.build_project_learning_review_request`.

Source: `lightbulb/project_learning_reviews.py:63`.

### `lightbulb.PROJECT_SKILL_MATCH_LEDGER_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROJECT_SKILL_MATCH_LEDGER_SCHEMA
~~~


Binding: `lightbulb.project_skill_matches.PROJECT_SKILL_MATCH_LEDGER_SCHEMA` → `lightbulb.project_skill_matches.PROJECT_SKILL_MATCH_LEDGER_SCHEMA`.

Source: `lightbulb/project_skill_matches.py:13`.

### `lightbulb.PROJECT_SKILL_MATCH_RECEIPT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROJECT_SKILL_MATCH_RECEIPT_SCHEMA
~~~


Binding: `lightbulb.project_skill_matches.PROJECT_SKILL_MATCH_RECEIPT_SCHEMA` → `lightbulb.project_skill_matches.PROJECT_SKILL_MATCH_RECEIPT_SCHEMA`.

Source: `lightbulb/project_skill_matches.py:12`.

### `lightbulb.PROJECT_SKILL_MATCH_REQUEST_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROJECT_SKILL_MATCH_REQUEST_SCHEMA
~~~


Binding: `lightbulb.project_skill_matches.PROJECT_SKILL_MATCH_REQUEST_SCHEMA` → `lightbulb.project_skill_matches.PROJECT_SKILL_MATCH_REQUEST_SCHEMA`.

Source: `lightbulb/project_skill_matches.py:9`.

### `lightbulb.PROJECT_LEARNING_RUN_ADMISSION_PLAN_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROJECT_LEARNING_RUN_ADMISSION_PLAN_SCHEMA
~~~


Binding: `lightbulb.project_training_packs.PROJECT_LEARNING_RUN_ADMISSION_PLAN_SCHEMA` → `lightbulb.project_training_packs.PROJECT_LEARNING_RUN_ADMISSION_PLAN_SCHEMA`.

Source: `lightbulb/project_training_packs.py:14`.

### `lightbulb.PROJECT_TRAINING_PACK_LEDGER_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROJECT_TRAINING_PACK_LEDGER_SCHEMA
~~~


Binding: `lightbulb.project_training_packs.PROJECT_TRAINING_PACK_LEDGER_SCHEMA` → `lightbulb.project_training_packs.PROJECT_TRAINING_PACK_LEDGER_SCHEMA`.

Source: `lightbulb/project_training_packs.py:17`.

### `lightbulb.PROJECT_TRAINING_PACK_RECEIPT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROJECT_TRAINING_PACK_RECEIPT_SCHEMA
~~~


Binding: `lightbulb.project_training_packs.PROJECT_TRAINING_PACK_RECEIPT_SCHEMA` → `lightbulb.project_training_packs.PROJECT_TRAINING_PACK_RECEIPT_SCHEMA`.

Source: `lightbulb/project_training_packs.py:12`.

### `lightbulb.PROJECT_TRAINING_PACK_REQUEST_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROJECT_TRAINING_PACK_REQUEST_SCHEMA
~~~


Binding: `lightbulb.project_training_packs.PROJECT_TRAINING_PACK_REQUEST_SCHEMA` → `lightbulb.project_training_packs.PROJECT_TRAINING_PACK_REQUEST_SCHEMA`.

Source: `lightbulb/project_training_packs.py:9`.

### `lightbulb.PROJECT_TRAINING_PACK_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROJECT_TRAINING_PACK_SCHEMA
~~~


Binding: `lightbulb.project_training_packs.PROJECT_TRAINING_PACK_SCHEMA` → `lightbulb.project_training_packs.PROJECT_TRAINING_PACK_SCHEMA`.

Source: `lightbulb/project_training_packs.py:13`.

### `lightbulb.PROJECT_BILLABLE_LEARNING_RUNTIMES`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROJECT_BILLABLE_LEARNING_RUNTIMES
~~~


Binding: `lightbulb.project_learning_runs.PROJECT_BILLABLE_LEARNING_RUNTIMES` → `lightbulb.project_learning_runs.PROJECT_BILLABLE_LEARNING_RUNTIMES`.

Source: `lightbulb/project_learning_runs.py:47`.

### `lightbulb.PROJECT_CAPACITY_RUNTIMES`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROJECT_CAPACITY_RUNTIMES
~~~


Binding: `lightbulb.project_learning_runs.PROJECT_CAPACITY_RUNTIMES` → `lightbulb.project_learning_runs.PROJECT_CAPACITY_RUNTIMES`.

Source: `lightbulb/project_learning_runs.py:50`.

### `lightbulb.PROJECT_LEARNING_QUEST_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROJECT_LEARNING_QUEST_SCHEMA
~~~


Binding: `lightbulb.project_learning_runs.PROJECT_LEARNING_QUEST_SCHEMA` → `lightbulb.project_learning_runs.PROJECT_LEARNING_QUEST_SCHEMA`.

Source: `lightbulb/project_learning_runs.py:35`.

### `lightbulb.PROJECT_LEARNING_RUN_ADMISSION_CONFIRMATION`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROJECT_LEARNING_RUN_ADMISSION_CONFIRMATION
~~~


Binding: `lightbulb.project_learning_runs.PROJECT_LEARNING_RUN_ADMISSION_CONFIRMATION` → `lightbulb.project_learning_runs.PROJECT_LEARNING_RUN_ADMISSION_CONFIRMATION`.

Source: `lightbulb/project_learning_runs.py:40`.

### `lightbulb.PROJECT_LEARNING_RUN_ADMISSION_RECEIPT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROJECT_LEARNING_RUN_ADMISSION_RECEIPT_SCHEMA
~~~


Binding: `lightbulb.project_learning_runs.PROJECT_LEARNING_RUN_ADMISSION_RECEIPT_SCHEMA` → `lightbulb.project_learning_runs.PROJECT_LEARNING_RUN_ADMISSION_RECEIPT_SCHEMA`.

Source: `lightbulb/project_learning_runs.py:24`.

### `lightbulb.PROJECT_LEARNING_RUN_ADMISSION_REQUEST_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROJECT_LEARNING_RUN_ADMISSION_REQUEST_SCHEMA
~~~


Binding: `lightbulb.project_learning_runs.PROJECT_LEARNING_RUN_ADMISSION_REQUEST_SCHEMA` → `lightbulb.project_learning_runs.PROJECT_LEARNING_RUN_ADMISSION_REQUEST_SCHEMA`.

Source: `lightbulb/project_learning_runs.py:20`.

### `lightbulb.PROJECT_LEARNING_RUN_EXECUTION_RECEIPT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROJECT_LEARNING_RUN_EXECUTION_RECEIPT_SCHEMA
~~~


Binding: `lightbulb.project_learning_runs.PROJECT_LEARNING_RUN_EXECUTION_RECEIPT_SCHEMA` → `lightbulb.project_learning_runs.PROJECT_LEARNING_RUN_EXECUTION_RECEIPT_SCHEMA`.

Source: `lightbulb/project_learning_runs.py:27`.

### `lightbulb.PROJECT_LEARNING_RUN_EXECUTION_SNAPSHOT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROJECT_LEARNING_RUN_EXECUTION_SNAPSHOT_SCHEMA
~~~


Binding: `lightbulb.project_learning_runs.PROJECT_LEARNING_RUN_EXECUTION_SNAPSHOT_SCHEMA` → `lightbulb.project_learning_runs.PROJECT_LEARNING_RUN_EXECUTION_SNAPSHOT_SCHEMA`.

Source: `lightbulb/project_learning_runs.py:30`.

### `lightbulb.PROJECT_LEARNING_RUN_LEDGER_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROJECT_LEARNING_RUN_LEDGER_SCHEMA
~~~


Binding: `lightbulb.project_learning_runs.PROJECT_LEARNING_RUN_LEDGER_SCHEMA` → `lightbulb.project_learning_runs.PROJECT_LEARNING_RUN_LEDGER_SCHEMA`.

Source: `lightbulb/project_learning_runs.py:33`.

### `lightbulb.PROJECT_LEARNING_RUN_PREPARE_CONFIRMATION`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROJECT_LEARNING_RUN_PREPARE_CONFIRMATION
~~~


Binding: `lightbulb.project_learning_runs.PROJECT_LEARNING_RUN_PREPARE_CONFIRMATION` → `lightbulb.project_learning_runs.PROJECT_LEARNING_RUN_PREPARE_CONFIRMATION`.

Source: `lightbulb/project_learning_runs.py:37`.

### `lightbulb.PROJECT_LEARNING_RUN_PREPARE_REQUEST_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROJECT_LEARNING_RUN_PREPARE_REQUEST_SCHEMA
~~~


Binding: `lightbulb.project_learning_runs.PROJECT_LEARNING_RUN_PREPARE_REQUEST_SCHEMA` → `lightbulb.project_learning_runs.PROJECT_LEARNING_RUN_PREPARE_REQUEST_SCHEMA`.

Source: `lightbulb/project_learning_runs.py:17`.

### `lightbulb.PROJECT_LEARNING_RUN_RECEIPT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROJECT_LEARNING_RUN_RECEIPT_SCHEMA
~~~


Binding: `lightbulb.project_learning_runs.PROJECT_LEARNING_RUN_RECEIPT_SCHEMA` → `lightbulb.project_learning_runs.PROJECT_LEARNING_RUN_RECEIPT_SCHEMA`.

Source: `lightbulb/project_learning_runs.py:23`.

### `lightbulb.PROJECT_LEARNING_RUNTIMES`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROJECT_LEARNING_RUNTIMES
~~~


Binding: `lightbulb.project_learning_runs.PROJECT_LEARNING_RUNTIMES` → `lightbulb.project_learning_runs.PROJECT_LEARNING_RUNTIMES`.

Source: `lightbulb/project_learning_runs.py:44`.

### `lightbulb.PROJECT_TRAINING_DATASET_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROJECT_TRAINING_DATASET_SCHEMA
~~~


Binding: `lightbulb.project_learning_runs.PROJECT_TRAINING_DATASET_SCHEMA` → `lightbulb.project_learning_runs.PROJECT_TRAINING_DATASET_SCHEMA`.

Source: `lightbulb/project_learning_runs.py:34`.

### `lightbulb.build_project_learning_run_admission_request`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import build_project_learning_run_admission_request
~~~


Binding: `lightbulb.project_learning_runs.build_project_learning_run_admission_request` → `lightbulb.project_learning_runs.build_project_learning_run_admission_request`.

Source: `lightbulb/project_learning_runs.py:214`.

### `lightbulb.build_project_learning_run_prepare_request`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import build_project_learning_run_prepare_request
~~~


Binding: `lightbulb.project_learning_runs.build_project_learning_run_prepare_request` → `lightbulb.project_learning_runs.build_project_learning_run_prepare_request`.

Source: `lightbulb/project_learning_runs.py:120`.

### `lightbulb.PROJECT_LEARNING_RESULT_ADMISSION_CONFIRMATION`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROJECT_LEARNING_RESULT_ADMISSION_CONFIRMATION
~~~


Binding: `lightbulb.project_learning_result_evaluations.PROJECT_LEARNING_RESULT_ADMISSION_CONFIRMATION` → `lightbulb.project_learning_result_evaluations.PROJECT_LEARNING_RESULT_ADMISSION_CONFIRMATION`.

Source: `lightbulb/project_learning_result_evaluations.py:26`.

### `lightbulb.PROJECT_LEARNING_RESULT_ADMISSION_DECISIONS`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROJECT_LEARNING_RESULT_ADMISSION_DECISIONS
~~~


Binding: `lightbulb.project_learning_result_evaluations.PROJECT_LEARNING_RESULT_ADMISSION_DECISIONS` → `lightbulb.project_learning_result_evaluations.PROJECT_LEARNING_RESULT_ADMISSION_DECISIONS`.

Source: `lightbulb/project_learning_result_evaluations.py:29`.

### `lightbulb.PROJECT_LEARNING_RESULT_ADMISSION_RECEIPT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROJECT_LEARNING_RESULT_ADMISSION_RECEIPT_SCHEMA
~~~


Binding: `lightbulb.project_learning_result_evaluations.PROJECT_LEARNING_RESULT_ADMISSION_RECEIPT_SCHEMA` → `lightbulb.project_learning_result_evaluations.PROJECT_LEARNING_RESULT_ADMISSION_RECEIPT_SCHEMA`.

Source: `lightbulb/project_learning_result_evaluations.py:23`.

### `lightbulb.PROJECT_LEARNING_RESULT_ADMISSION_REQUEST_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROJECT_LEARNING_RESULT_ADMISSION_REQUEST_SCHEMA
~~~


Binding: `lightbulb.project_learning_result_evaluations.PROJECT_LEARNING_RESULT_ADMISSION_REQUEST_SCHEMA` → `lightbulb.project_learning_result_evaluations.PROJECT_LEARNING_RESULT_ADMISSION_REQUEST_SCHEMA`.

Source: `lightbulb/project_learning_result_evaluations.py:20`.

### `lightbulb.PROJECT_LEARNING_RESULT_EVALUATION_LEDGER_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROJECT_LEARNING_RESULT_EVALUATION_LEDGER_SCHEMA
~~~


Binding: `lightbulb.project_learning_result_evaluations.PROJECT_LEARNING_RESULT_EVALUATION_LEDGER_SCHEMA` → `lightbulb.project_learning_result_evaluations.PROJECT_LEARNING_RESULT_EVALUATION_LEDGER_SCHEMA`.

Source: `lightbulb/project_learning_result_evaluations.py:17`.

### `lightbulb.PROJECT_LEARNING_RESULT_EVALUATION_RECEIPT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROJECT_LEARNING_RESULT_EVALUATION_RECEIPT_SCHEMA
~~~


Binding: `lightbulb.project_learning_result_evaluations.PROJECT_LEARNING_RESULT_EVALUATION_RECEIPT_SCHEMA` → `lightbulb.project_learning_result_evaluations.PROJECT_LEARNING_RESULT_EVALUATION_RECEIPT_SCHEMA`.

Source: `lightbulb/project_learning_result_evaluations.py:14`.

### `lightbulb.build_project_learning_result_admission_request`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import build_project_learning_result_admission_request
~~~


Binding: `lightbulb.project_learning_result_evaluations.build_project_learning_result_admission_request` → `lightbulb.project_learning_result_evaluations.build_project_learning_result_admission_request`.

Source: `lightbulb/project_learning_result_evaluations.py:47`.

### `lightbulb.PROJECT_SHADOW_LEARNER_ALLOWED_MUTATION_PATHS`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROJECT_SHADOW_LEARNER_ALLOWED_MUTATION_PATHS
~~~


Binding: `lightbulb.project_shadow_learner_updates.PROJECT_SHADOW_LEARNER_ALLOWED_MUTATION_PATHS` → `lightbulb.project_shadow_learner_updates.PROJECT_SHADOW_LEARNER_ALLOWED_MUTATION_PATHS`.

Source: `lightbulb/project_shadow_learner_updates.py:38`.

### `lightbulb.PROJECT_SHADOW_LEARNER_ROLLBACK_CONFIRMATION`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROJECT_SHADOW_LEARNER_ROLLBACK_CONFIRMATION
~~~


Binding: `lightbulb.project_shadow_learner_updates.PROJECT_SHADOW_LEARNER_ROLLBACK_CONFIRMATION` → `lightbulb.project_shadow_learner_updates.PROJECT_SHADOW_LEARNER_ROLLBACK_CONFIRMATION`.

Source: `lightbulb/project_shadow_learner_updates.py:35`.

### `lightbulb.PROJECT_SHADOW_LEARNER_ROLLBACK_RECEIPT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROJECT_SHADOW_LEARNER_ROLLBACK_RECEIPT_SCHEMA
~~~


Binding: `lightbulb.project_shadow_learner_updates.PROJECT_SHADOW_LEARNER_ROLLBACK_RECEIPT_SCHEMA` → `lightbulb.project_shadow_learner_updates.PROJECT_SHADOW_LEARNER_ROLLBACK_RECEIPT_SCHEMA`.

Source: `lightbulb/project_shadow_learner_updates.py:26`.

### `lightbulb.PROJECT_SHADOW_LEARNER_ROLLBACK_REQUEST_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROJECT_SHADOW_LEARNER_ROLLBACK_REQUEST_SCHEMA
~~~


Binding: `lightbulb.project_shadow_learner_updates.PROJECT_SHADOW_LEARNER_ROLLBACK_REQUEST_SCHEMA` → `lightbulb.project_shadow_learner_updates.PROJECT_SHADOW_LEARNER_ROLLBACK_REQUEST_SCHEMA`.

Source: `lightbulb/project_shadow_learner_updates.py:23`.

### `lightbulb.PROJECT_SHADOW_LEARNER_UPDATE_CONFIRMATION`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROJECT_SHADOW_LEARNER_UPDATE_CONFIRMATION
~~~


Binding: `lightbulb.project_shadow_learner_updates.PROJECT_SHADOW_LEARNER_UPDATE_CONFIRMATION` → `lightbulb.project_shadow_learner_updates.PROJECT_SHADOW_LEARNER_UPDATE_CONFIRMATION`.

Source: `lightbulb/project_shadow_learner_updates.py:32`.

### `lightbulb.PROJECT_SHADOW_LEARNER_UPDATE_LEDGER_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROJECT_SHADOW_LEARNER_UPDATE_LEDGER_SCHEMA
~~~


Binding: `lightbulb.project_shadow_learner_updates.PROJECT_SHADOW_LEARNER_UPDATE_LEDGER_SCHEMA` → `lightbulb.project_shadow_learner_updates.PROJECT_SHADOW_LEARNER_UPDATE_LEDGER_SCHEMA`.

Source: `lightbulb/project_shadow_learner_updates.py:29`.

### `lightbulb.PROJECT_SHADOW_LEARNER_UPDATE_RECEIPT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROJECT_SHADOW_LEARNER_UPDATE_RECEIPT_SCHEMA
~~~


Binding: `lightbulb.project_shadow_learner_updates.PROJECT_SHADOW_LEARNER_UPDATE_RECEIPT_SCHEMA` → `lightbulb.project_shadow_learner_updates.PROJECT_SHADOW_LEARNER_UPDATE_RECEIPT_SCHEMA`.

Source: `lightbulb/project_shadow_learner_updates.py:20`.

### `lightbulb.PROJECT_SHADOW_LEARNER_UPDATE_REQUEST_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROJECT_SHADOW_LEARNER_UPDATE_REQUEST_SCHEMA
~~~


Binding: `lightbulb.project_shadow_learner_updates.PROJECT_SHADOW_LEARNER_UPDATE_REQUEST_SCHEMA` → `lightbulb.project_shadow_learner_updates.PROJECT_SHADOW_LEARNER_UPDATE_REQUEST_SCHEMA`.

Source: `lightbulb/project_shadow_learner_updates.py:17`.

### `lightbulb.build_project_shadow_learner_rollback_request`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import build_project_shadow_learner_rollback_request
~~~


Binding: `lightbulb.project_shadow_learner_updates.build_project_shadow_learner_rollback_request` → `lightbulb.project_shadow_learner_updates.build_project_shadow_learner_rollback_request`.

Source: `lightbulb/project_shadow_learner_updates.py:181`.

### `lightbulb.build_project_shadow_learner_target`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import build_project_shadow_learner_target
~~~


Binding: `lightbulb.project_shadow_learner_updates.build_project_shadow_learner_target` → `lightbulb.project_shadow_learner_updates.build_project_shadow_learner_target`.

Source: `lightbulb/project_shadow_learner_updates.py:84`.

### `lightbulb.build_project_shadow_learner_update_request`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import build_project_shadow_learner_update_request
~~~


Binding: `lightbulb.project_shadow_learner_updates.build_project_shadow_learner_update_request` → `lightbulb.project_shadow_learner_updates.build_project_shadow_learner_update_request`.

Source: `lightbulb/project_shadow_learner_updates.py:157`.

### `lightbulb.normalize_project_shadow_learner_target`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import normalize_project_shadow_learner_target
~~~


Binding: `lightbulb.project_shadow_learner_updates.normalize_project_shadow_learner_target` → `lightbulb.project_shadow_learner_updates.normalize_project_shadow_learner_target`.

Source: `lightbulb/project_shadow_learner_updates.py:126`.

### `lightbulb.PROJECT_POLICY_ASSIGNMENT_LEDGER_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROJECT_POLICY_ASSIGNMENT_LEDGER_SCHEMA
~~~


Binding: `lightbulb.project_policy.PROJECT_POLICY_ASSIGNMENT_LEDGER_SCHEMA` → `lightbulb.project_policy.PROJECT_POLICY_ASSIGNMENT_LEDGER_SCHEMA`.

Source: `lightbulb/project_policy.py:15`.

### `lightbulb.PROJECT_POLICY_ASSIGNMENT_OBSERVATION_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROJECT_POLICY_ASSIGNMENT_OBSERVATION_SCHEMA
~~~


Binding: `lightbulb.project_policy.PROJECT_POLICY_ASSIGNMENT_OBSERVATION_SCHEMA` → `lightbulb.project_policy.PROJECT_POLICY_ASSIGNMENT_OBSERVATION_SCHEMA`.

Source: `lightbulb/project_policy.py:11`.

### `lightbulb.PROJECT_POLICY_ASSIGNMENT_RECEIPT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROJECT_POLICY_ASSIGNMENT_RECEIPT_SCHEMA
~~~


Binding: `lightbulb.project_policy.PROJECT_POLICY_ASSIGNMENT_RECEIPT_SCHEMA` → `lightbulb.project_policy.PROJECT_POLICY_ASSIGNMENT_RECEIPT_SCHEMA`.

Source: `lightbulb/project_policy.py:14`.

### `lightbulb.PROJECT_POLICY_OFFLINE_EVALUATION_LEDGER_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROJECT_POLICY_OFFLINE_EVALUATION_LEDGER_SCHEMA
~~~


Binding: `lightbulb.project_policy.PROJECT_POLICY_OFFLINE_EVALUATION_LEDGER_SCHEMA` → `lightbulb.project_policy.PROJECT_POLICY_OFFLINE_EVALUATION_LEDGER_SCHEMA`.

Source: `lightbulb/project_policy.py:22`.

### `lightbulb.PROJECT_POLICY_OFFLINE_EVALUATION_PAIR_REQUEST_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROJECT_POLICY_OFFLINE_EVALUATION_PAIR_REQUEST_SCHEMA
~~~


Binding: `lightbulb.project_policy.PROJECT_POLICY_OFFLINE_EVALUATION_PAIR_REQUEST_SCHEMA` → `lightbulb.project_policy.PROJECT_POLICY_OFFLINE_EVALUATION_PAIR_REQUEST_SCHEMA`.

Source: `lightbulb/project_policy.py:16`.

### `lightbulb.PROJECT_POLICY_OFFLINE_EVALUATION_RECEIPT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROJECT_POLICY_OFFLINE_EVALUATION_RECEIPT_SCHEMA
~~~


Binding: `lightbulb.project_policy.PROJECT_POLICY_OFFLINE_EVALUATION_RECEIPT_SCHEMA` → `lightbulb.project_policy.PROJECT_POLICY_OFFLINE_EVALUATION_RECEIPT_SCHEMA`.

Source: `lightbulb/project_policy.py:19`.

### `lightbulb.PROJECT_STRATEGY_LAB_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROJECT_STRATEGY_LAB_SCHEMA
~~~


Binding: `lightbulb.project_policy.PROJECT_STRATEGY_LAB_SCHEMA` → `lightbulb.project_policy.PROJECT_STRATEGY_LAB_SCHEMA`.

Source: `lightbulb/project_policy.py:25`.

### `lightbulb.build_project_policy_assignment`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import build_project_policy_assignment
~~~


Binding: `lightbulb.project_policy.build_project_policy_assignment` → `lightbulb.project_policy.build_project_policy_assignment`.

Source: `lightbulb/project_policy.py:159`.

### `lightbulb.build_project_policy_evaluation_request`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import build_project_policy_evaluation_request
~~~


Binding: `lightbulb.project_policy.build_project_policy_evaluation_request` → `lightbulb.project_policy.build_project_policy_evaluation_request`.

Source: `lightbulb/project_policy.py:236`.

### `lightbulb.PROJECT_SCIENCE_EVIDENCE_OBSERVATION_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROJECT_SCIENCE_EVIDENCE_OBSERVATION_SCHEMA
~~~


Binding: `lightbulb.project_science.PROJECT_SCIENCE_EVIDENCE_OBSERVATION_SCHEMA` → `lightbulb.project_science.PROJECT_SCIENCE_EVIDENCE_OBSERVATION_SCHEMA`.

Source: `lightbulb/project_science.py:16`.

### `lightbulb.PROJECT_SCIENCE_EVIDENCE_RECEIPT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROJECT_SCIENCE_EVIDENCE_RECEIPT_SCHEMA
~~~


Binding: `lightbulb.project_science.PROJECT_SCIENCE_EVIDENCE_RECEIPT_SCHEMA` → `lightbulb.project_science.PROJECT_SCIENCE_EVIDENCE_RECEIPT_SCHEMA`.

Source: `lightbulb/project_science.py:19`.

### `lightbulb.PROJECT_SCIENCE_LEDGER_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROJECT_SCIENCE_LEDGER_SCHEMA
~~~


Binding: `lightbulb.project_science.PROJECT_SCIENCE_LEDGER_SCHEMA` → `lightbulb.project_science.PROJECT_SCIENCE_LEDGER_SCHEMA`.

Source: `lightbulb/project_science.py:20`.

### `lightbulb.PROJECT_SCIENCE_STAGES`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROJECT_SCIENCE_STAGES
~~~


Binding: `lightbulb.project_science.PROJECT_SCIENCE_STAGES` → `lightbulb.project_science.PROJECT_SCIENCE_STAGES`.

Source: `lightbulb/project_science.py:22`.

### `lightbulb.build_project_science_evidence_observation`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import build_project_science_evidence_observation
~~~


Binding: `lightbulb.project_science.build_project_science_evidence_observation` → `lightbulb.project_science.build_project_science_evidence_observation`.

Source: `lightbulb/project_science.py:123`.

### `lightbulb.PROJECT_PREFLIGHT_FEEDBACK_RECEIPT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PROJECT_PREFLIGHT_FEEDBACK_RECEIPT_SCHEMA
~~~


Binding: `lightbulb.project_feedback.PROJECT_PREFLIGHT_FEEDBACK_RECEIPT_SCHEMA` → `lightbulb.project_feedback.PROJECT_PREFLIGHT_FEEDBACK_RECEIPT_SCHEMA`.

Source: `lightbulb/project_feedback.py:29`.

### `lightbulb.ProjectPreflightFeedbackDimensions`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProjectPreflightFeedbackDimensions
~~~


Binding: `lightbulb.project_feedback.ProjectPreflightFeedbackDimensions` → `lightbulb.project_feedback.ProjectPreflightFeedbackDimensions`.

Source: `lightbulb/project_feedback.py:57`.

### `lightbulb.ProjectPreflightSemanticFeedbackReceipt`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProjectPreflightSemanticFeedbackReceipt
~~~


Binding: `lightbulb.project_feedback.ProjectPreflightSemanticFeedbackReceipt` → `lightbulb.project_feedback.ProjectPreflightSemanticFeedbackReceipt`.

Source: `lightbulb/project_feedback.py:108`.

### `lightbulb.SemanticFeedbackValue`

value. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SemanticFeedbackValue
~~~


Binding: `lightbulb.project_feedback.SemanticFeedbackValue` → `lightbulb.project_feedback.SemanticFeedbackValue`.

Source: `lightbulb/project_feedback.py:32`.

### `lightbulb.AgentOpsProtocolError`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import AgentOpsProtocolError
~~~


Binding: `lightbulb.agent_ops.AgentOpsProtocolError` → `lightbulb.agent_ops.AgentOpsProtocolError`.

Source: `lightbulb/agent_ops.py:134`.

### `lightbulb.TRAINING_PAIR_ADMISSION_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import TRAINING_PAIR_ADMISSION_SCHEMA
~~~


Binding: `lightbulb.agent_ops.TRAINING_PAIR_ADMISSION_SCHEMA` → `lightbulb.agent_ops.TRAINING_PAIR_ADMISSION_SCHEMA`.

Source: `lightbulb/agent_ops.py:25`.

### `lightbulb.TRAINING_PAIR_ADMISSION_UNAVAILABLE`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import TRAINING_PAIR_ADMISSION_UNAVAILABLE
~~~


Binding: `lightbulb.agent_ops.TRAINING_PAIR_ADMISSION_UNAVAILABLE` → `lightbulb.agent_ops.TRAINING_PAIR_ADMISSION_UNAVAILABLE`.

Source: `lightbulb/agent_ops.py:27`.

### `lightbulb.TRAINING_PAIR_AUTHORITY_BLOCKERS`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import TRAINING_PAIR_AUTHORITY_BLOCKERS
~~~


Binding: `lightbulb.agent_ops.TRAINING_PAIR_AUTHORITY_BLOCKERS` → `lightbulb.agent_ops.TRAINING_PAIR_AUTHORITY_BLOCKERS`.

Source: `lightbulb/agent_ops.py:33`.

### `lightbulb.TRAINING_PAIR_INPUT_CUSTODY_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import TRAINING_PAIR_INPUT_CUSTODY_SCHEMA
~~~


Binding: `lightbulb.agent_ops.TRAINING_PAIR_INPUT_CUSTODY_SCHEMA` → `lightbulb.agent_ops.TRAINING_PAIR_INPUT_CUSTODY_SCHEMA`.

Source: `lightbulb/agent_ops.py:24`.

### `lightbulb.TRAINING_PAIR_PREFLIGHT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import TRAINING_PAIR_PREFLIGHT_SCHEMA
~~~


Binding: `lightbulb.agent_ops.TRAINING_PAIR_PREFLIGHT_SCHEMA` → `lightbulb.agent_ops.TRAINING_PAIR_PREFLIGHT_SCHEMA`.

Source: `lightbulb/agent_ops.py:22`.

### `lightbulb.TRAINING_PAIR_STATUS_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import TRAINING_PAIR_STATUS_SCHEMA
~~~


Binding: `lightbulb.agent_ops.TRAINING_PAIR_STATUS_SCHEMA` → `lightbulb.agent_ops.TRAINING_PAIR_STATUS_SCHEMA`.

Source: `lightbulb/agent_ops.py:26`.

### `lightbulb.IMPROVEMENT_PACKET_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import IMPROVEMENT_PACKET_SCHEMA
~~~


Binding: `lightbulb.workflow_improvement.IMPROVEMENT_PACKET_SCHEMA` → `lightbulb.workflow_improvement.IMPROVEMENT_PACKET_SCHEMA`.

Source: `lightbulb/workflow_improvement.py:52`.

### `lightbulb.IMPROVEMENT_QUEUE_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import IMPROVEMENT_QUEUE_SCHEMA
~~~


Binding: `lightbulb.workflow_improvement.IMPROVEMENT_QUEUE_SCHEMA` → `lightbulb.workflow_improvement.IMPROVEMENT_QUEUE_SCHEMA`.

Source: `lightbulb/workflow_improvement.py:51`.

### `lightbulb.IMPROVEMENT_REPORT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import IMPROVEMENT_REPORT_SCHEMA
~~~


Binding: `lightbulb.workflow_improvement.IMPROVEMENT_REPORT_SCHEMA` → `lightbulb.workflow_improvement.IMPROVEMENT_REPORT_SCHEMA`.

Source: `lightbulb/workflow_improvement.py:49`.

### `lightbulb.IMPROVEMENT_STATE_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import IMPROVEMENT_STATE_SCHEMA
~~~


Binding: `lightbulb.workflow_improvement.IMPROVEMENT_STATE_SCHEMA` → `lightbulb.workflow_improvement.IMPROVEMENT_STATE_SCHEMA`.

Source: `lightbulb/workflow_improvement.py:50`.

### `lightbulb.IMPROVEMENT_HISTORY_COMPACTION_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import IMPROVEMENT_HISTORY_COMPACTION_SCHEMA
~~~


Binding: `lightbulb.workflow_improvement.IMPROVEMENT_HISTORY_COMPACTION_SCHEMA` → `lightbulb.workflow_improvement.IMPROVEMENT_HISTORY_COMPACTION_SCHEMA`.

Source: `lightbulb/workflow_improvement.py:55`.

### `lightbulb.IMPROVEMENT_SUPERVISOR_BUDGET_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import IMPROVEMENT_SUPERVISOR_BUDGET_SCHEMA
~~~


Binding: `lightbulb.workflow_improvement.IMPROVEMENT_SUPERVISOR_BUDGET_SCHEMA` → `lightbulb.workflow_improvement.IMPROVEMENT_SUPERVISOR_BUDGET_SCHEMA`.

Source: `lightbulb/workflow_improvement.py:58`.

### `lightbulb.IMPROVEMENT_SUPERVISOR_STOP_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import IMPROVEMENT_SUPERVISOR_STOP_SCHEMA
~~~


Binding: `lightbulb.workflow_improvement.IMPROVEMENT_SUPERVISOR_STOP_SCHEMA` → `lightbulb.workflow_improvement.IMPROVEMENT_SUPERVISOR_STOP_SCHEMA`.

Source: `lightbulb/workflow_improvement.py:61`.

### `lightbulb.ImprovementLoopAlreadyRunning`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ImprovementLoopAlreadyRunning
~~~


Binding: `lightbulb.workflow_improvement.ImprovementLoopAlreadyRunning` → `lightbulb.workflow_improvement.ImprovementLoopAlreadyRunning`.

Source: `lightbulb/workflow_improvement.py:148`.

### `lightbulb.WorkflowImprovementBudgetExceeded`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import WorkflowImprovementBudgetExceeded
~~~


Binding: `lightbulb.workflow_improvement.WorkflowImprovementBudgetExceeded` → `lightbulb.workflow_improvement.WorkflowImprovementBudgetExceeded`.

Source: `lightbulb/workflow_improvement.py:152`.

### `lightbulb.WorkflowImprovementStateError`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import WorkflowImprovementStateError
~~~


Binding: `lightbulb.workflow_improvement.WorkflowImprovementStateError` → `lightbulb.workflow_improvement.WorkflowImprovementStateError`.

Source: `lightbulb/workflow_improvement.py:156`.

### `lightbulb.WorkflowImprovementSupervisorBudget`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import WorkflowImprovementSupervisorBudget
~~~


Binding: `lightbulb.workflow_improvement.WorkflowImprovementSupervisorBudget` → `lightbulb.workflow_improvement.WorkflowImprovementSupervisorBudget`.

Source: `lightbulb/workflow_improvement.py:161`.

### `lightbulb.default_workflow_improvement_dir`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import default_workflow_improvement_dir
~~~


Binding: `lightbulb.workflow_improvement.default_workflow_improvement_dir` → `lightbulb.workflow_improvement.default_workflow_improvement_dir`.

Source: `lightbulb/workflow_improvement.py:255`.

### `lightbulb.evaluate_workflow_improvement`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import evaluate_workflow_improvement
~~~


Binding: `lightbulb.workflow_improvement.evaluate_workflow_improvement` → `lightbulb.workflow_improvement.evaluate_workflow_improvement`.

Source: `lightbulb/workflow_improvement.py:1225`.

### `lightbulb.list_workflow_improvement_packets`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import list_workflow_improvement_packets
~~~


Binding: `lightbulb.workflow_improvement.list_workflow_improvement_packets` → `lightbulb.workflow_improvement.list_workflow_improvement_packets`.

Source: `lightbulb/workflow_improvement.py:2034`.

### `lightbulb.load_workflow_improvement_status`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import load_workflow_improvement_status
~~~


Binding: `lightbulb.workflow_improvement.load_workflow_improvement_status` → `lightbulb.workflow_improvement.load_workflow_improvement_status`.

Source: `lightbulb/workflow_improvement.py:2077`.

### `lightbulb.run_continuous_workflow_improvement`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import run_continuous_workflow_improvement
~~~


Binding: `lightbulb.workflow_improvement.run_continuous_workflow_improvement` → `lightbulb.workflow_improvement.run_continuous_workflow_improvement`.

Source: `lightbulb/workflow_improvement.py:1826`.

### `lightbulb.run_workflow_improvement_cycle`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import run_workflow_improvement_cycle
~~~


Binding: `lightbulb.workflow_improvement.run_workflow_improvement_cycle` → `lightbulb.workflow_improvement.run_workflow_improvement_cycle`.

Source: `lightbulb/workflow_improvement.py:1794`.

### `lightbulb.synthetic_inputs_for_primitive`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import synthetic_inputs_for_primitive
~~~


Binding: `lightbulb.workflow_improvement.synthetic_inputs_for_primitive` → `lightbulb.workflow_improvement.synthetic_inputs_for_primitive`.

Source: `lightbulb/workflow_improvement.py:574`.

### `lightbulb.WORKFLOW_LEARNING_ATTESTED_EPISODE_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import WORKFLOW_LEARNING_ATTESTED_EPISODE_SCHEMA
~~~


Binding: `lightbulb.workflow_learning.WORKFLOW_LEARNING_ATTESTED_EPISODE_SCHEMA` → `lightbulb.workflow_learning.WORKFLOW_LEARNING_ATTESTED_EPISODE_SCHEMA`.

Source: `lightbulb/workflow_learning.py:44`.

### `lightbulb.WORKFLOW_LEARNING_ATTESTED_HANDOFF_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import WORKFLOW_LEARNING_ATTESTED_HANDOFF_SCHEMA
~~~


Binding: `lightbulb.workflow_learning.WORKFLOW_LEARNING_ATTESTED_HANDOFF_SCHEMA` → `lightbulb.workflow_learning.WORKFLOW_LEARNING_ATTESTED_HANDOFF_SCHEMA`.

Source: `lightbulb/workflow_learning.py:28`.

### `lightbulb.WORKFLOW_LEARNING_CANDIDATE_ATTESTED_HANDOFF_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import WORKFLOW_LEARNING_CANDIDATE_ATTESTED_HANDOFF_SCHEMA
~~~


Binding: `lightbulb.workflow_learning.WORKFLOW_LEARNING_CANDIDATE_ATTESTED_HANDOFF_SCHEMA` → `lightbulb.workflow_learning.WORKFLOW_LEARNING_CANDIDATE_ATTESTED_HANDOFF_SCHEMA`.

Source: `lightbulb/workflow_learning.py:31`.

### `lightbulb.WORKFLOW_LEARNING_CANDIDATE_ATTESTATION_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import WORKFLOW_LEARNING_CANDIDATE_ATTESTATION_SCHEMA
~~~


Binding: `lightbulb.workflow_learning.WORKFLOW_LEARNING_CANDIDATE_ATTESTATION_SCHEMA` → `lightbulb.workflow_learning.WORKFLOW_LEARNING_CANDIDATE_ATTESTATION_SCHEMA`.

Source: `lightbulb/workflow_learning.py:37`.

### `lightbulb.WORKFLOW_LEARNING_CANDIDATE_ATTESTATION_SCOPE_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import WORKFLOW_LEARNING_CANDIDATE_ATTESTATION_SCOPE_SCHEMA
~~~


Binding: `lightbulb.workflow_learning.WORKFLOW_LEARNING_CANDIDATE_ATTESTATION_SCOPE_SCHEMA` → `lightbulb.workflow_learning.WORKFLOW_LEARNING_CANDIDATE_ATTESTATION_SCOPE_SCHEMA`.

Source: `lightbulb/workflow_learning.py:40`.

### `lightbulb.WORKFLOW_LEARNING_CANDIDATE_KINDS`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import WORKFLOW_LEARNING_CANDIDATE_KINDS
~~~


Binding: `lightbulb.workflow_learning.WORKFLOW_LEARNING_CANDIDATE_KINDS` → `lightbulb.workflow_learning.WORKFLOW_LEARNING_CANDIDATE_KINDS`.

Source: `lightbulb/workflow_learning.py:48`.

### `lightbulb.WORKFLOW_LEARNING_CANDIDATE_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import WORKFLOW_LEARNING_CANDIDATE_SCHEMA
~~~


Binding: `lightbulb.workflow_learning.WORKFLOW_LEARNING_CANDIDATE_SCHEMA` → `lightbulb.workflow_learning.WORKFLOW_LEARNING_CANDIDATE_SCHEMA`.

Source: `lightbulb/workflow_learning.py:34`.

### `lightbulb.WORKFLOW_LEARNING_EPISODE_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import WORKFLOW_LEARNING_EPISODE_SCHEMA
~~~


Binding: `lightbulb.workflow_learning.WORKFLOW_LEARNING_EPISODE_SCHEMA` → `lightbulb.workflow_learning.WORKFLOW_LEARNING_EPISODE_SCHEMA`.

Source: `lightbulb/workflow_learning.py:43`.

### `lightbulb.WORKFLOW_LEARNING_HANDOFF_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import WORKFLOW_LEARNING_HANDOFF_SCHEMA
~~~


Binding: `lightbulb.workflow_learning.WORKFLOW_LEARNING_HANDOFF_SCHEMA` → `lightbulb.workflow_learning.WORKFLOW_LEARNING_HANDOFF_SCHEMA`.

Source: `lightbulb/workflow_learning.py:27`.

### `lightbulb.WORKFLOW_LEARNING_LANES`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import WORKFLOW_LEARNING_LANES
~~~


Binding: `lightbulb.workflow_learning.WORKFLOW_LEARNING_LANES` → `lightbulb.workflow_learning.WORKFLOW_LEARNING_LANES`.

Source: `lightbulb/workflow_learning.py:57`.

### `lightbulb.WorkflowLearningHandoffError`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import WorkflowLearningHandoffError
~~~


Binding: `lightbulb.workflow_learning.WorkflowLearningHandoffError` → `lightbulb.workflow_learning.WorkflowLearningHandoffError`.

Source: `lightbulb/workflow_learning.py:96`.

### `lightbulb.build_attested_workflow_learning_episode_manifest`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import build_attested_workflow_learning_episode_manifest
~~~


Binding: `lightbulb.workflow_learning.build_attested_workflow_learning_episode_manifest` → `lightbulb.workflow_learning.build_attested_workflow_learning_episode_manifest`.

Source: `lightbulb/workflow_learning.py:477`.

### `lightbulb.compile_workflow_learning_handoff`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import compile_workflow_learning_handoff
~~~


Binding: `lightbulb.workflow_learning.compile_workflow_learning_handoff` → `lightbulb.workflow_learning.compile_workflow_learning_handoff`.

Source: `lightbulb/workflow_learning.py:812`.

### `lightbulb.workflow_learning_candidate_attestation_scope_sha256`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import workflow_learning_candidate_attestation_scope_sha256
~~~


Binding: `lightbulb.workflow_learning.workflow_learning_candidate_attestation_scope_sha256` → `lightbulb.workflow_learning.workflow_learning_candidate_attestation_scope_sha256`.

Source: `lightbulb/workflow_learning.py:132`.

### `lightbulb.workflow_learning_candidate_manifest_sha256`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import workflow_learning_candidate_manifest_sha256
~~~


Binding: `lightbulb.workflow_learning.workflow_learning_candidate_manifest_sha256` → `lightbulb.workflow_learning.workflow_learning_candidate_manifest_sha256`.

Source: `lightbulb/workflow_learning.py:126`.

### `lightbulb.GOVERNED_SKILL_BINDING_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GOVERNED_SKILL_BINDING_SCHEMA
~~~


Binding: `lightbulb.governed_skill_search.GOVERNED_SKILL_BINDING_SCHEMA` → `lightbulb.governed_skill_search.GOVERNED_SKILL_BINDING_SCHEMA`.

Source: `lightbulb/governed_skill_search.py:29`.

### `lightbulb.GOVERNED_SKILL_SEARCH_RECEIPT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GOVERNED_SKILL_SEARCH_RECEIPT_SCHEMA
~~~


Binding: `lightbulb.governed_skill_search.GOVERNED_SKILL_SEARCH_RECEIPT_SCHEMA` → `lightbulb.governed_skill_search.GOVERNED_SKILL_SEARCH_RECEIPT_SCHEMA`.

Source: `lightbulb/governed_skill_search.py:30`.

### `lightbulb.GOVERNED_SKILL_SEARCH_REQUEST_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GOVERNED_SKILL_SEARCH_REQUEST_SCHEMA
~~~


Binding: `lightbulb.governed_skill_search.GOVERNED_SKILL_SEARCH_REQUEST_SCHEMA` → `lightbulb.governed_skill_search.GOVERNED_SKILL_SEARCH_REQUEST_SCHEMA`.

Source: `lightbulb/governed_skill_search.py:28`.

### `lightbulb.WORKFLOW_EXECUTION_LEARNING_RECORD_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import WORKFLOW_EXECUTION_LEARNING_RECORD_SCHEMA
~~~


Binding: `lightbulb.governed_skill_search.WORKFLOW_EXECUTION_LEARNING_RECORD_SCHEMA` → `lightbulb.governed_skill_search.WORKFLOW_EXECUTION_LEARNING_RECORD_SCHEMA`.

Source: `lightbulb/governed_skill_search.py:31`.

### `lightbulb.WORKFLOW_LEARNING_DISPOSITION_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import WORKFLOW_LEARNING_DISPOSITION_SCHEMA
~~~


Binding: `lightbulb.governed_skill_search.WORKFLOW_LEARNING_DISPOSITION_SCHEMA` → `lightbulb.governed_skill_search.WORKFLOW_LEARNING_DISPOSITION_SCHEMA`.

Source: `lightbulb/governed_skill_search.py:34`.

### `lightbulb.ExactAgentSkillScope`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ExactAgentSkillScope
~~~


Binding: `lightbulb.governed_skill_search.ExactAgentSkillScope` → `lightbulb.governed_skill_search.ExactAgentSkillScope`.

Source: `lightbulb/governed_skill_search.py:128`.

### `lightbulb.GovernedSkillBinding`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GovernedSkillBinding
~~~


Binding: `lightbulb.governed_skill_search.GovernedSkillBinding` → `lightbulb.governed_skill_search.GovernedSkillBinding`.

Source: `lightbulb/governed_skill_search.py:216`.

### `lightbulb.GovernedSkillSearchProvider`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GovernedSkillSearchProvider
~~~


Binding: `lightbulb.governed_skill_search.GovernedSkillSearchProvider` → `lightbulb.governed_skill_search.GovernedSkillSearchProvider`.

Source: `lightbulb/governed_skill_search.py:256`.

### `lightbulb.GovernedSkillSearchReceipt`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GovernedSkillSearchReceipt
~~~


Binding: `lightbulb.governed_skill_search.GovernedSkillSearchReceipt` → `lightbulb.governed_skill_search.GovernedSkillSearchReceipt`.

Source: `lightbulb/governed_skill_search.py:240`.

### `lightbulb.GovernedSkillSearchRequest`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GovernedSkillSearchRequest
~~~


Binding: `lightbulb.governed_skill_search.GovernedSkillSearchRequest` → `lightbulb.governed_skill_search.GovernedSkillSearchRequest`.

Source: `lightbulb/governed_skill_search.py:160`.

### `lightbulb.LearningEvidenceSummary`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import LearningEvidenceSummary
~~~


Binding: `lightbulb.governed_skill_search.LearningEvidenceSummary` → `lightbulb.governed_skill_search.LearningEvidenceSummary`.

Source: `lightbulb/governed_skill_search.py:664`.

### `lightbulb.MemorySkillSearchClient`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import MemorySkillSearchClient
~~~


Binding: `lightbulb.governed_skill_search.MemorySkillSearchClient` → `lightbulb.governed_skill_search.MemorySkillSearchClient`.

Source: `lightbulb/governed_skill_search.py:576`.

### `lightbulb.PrimitiveVersionBinding`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PrimitiveVersionBinding
~~~


Binding: `lightbulb.governed_skill_search.PrimitiveVersionBinding` → `lightbulb.governed_skill_search.PrimitiveVersionBinding`.

Source: `lightbulb/governed_skill_search.py:722`.

### `lightbulb.ServerLearningPolicy`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ServerLearningPolicy
~~~


Binding: `lightbulb.governed_skill_search.ServerLearningPolicy` → `lightbulb.governed_skill_search.ServerLearningPolicy`.

Source: `lightbulb/governed_skill_search.py:697`.

### `lightbulb.SkillSearchMode`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SkillSearchMode
~~~


Binding: `lightbulb.governed_skill_search.SkillSearchMode` → `lightbulb.governed_skill_search.SkillSearchMode`.

Source: `lightbulb/governed_skill_search.py:123`.

### `lightbulb.TypedDataReference`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import TypedDataReference
~~~


Binding: `lightbulb.governed_skill_search.TypedDataReference` → `lightbulb.governed_skill_search.TypedDataReference`.

Source: `lightbulb/governed_skill_search.py:641`.

### `lightbulb.WorkflowExecutionLearningRecord`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import WorkflowExecutionLearningRecord
~~~


Binding: `lightbulb.governed_skill_search.WorkflowExecutionLearningRecord` → `lightbulb.governed_skill_search.WorkflowExecutionLearningRecord`.

Source: `lightbulb/governed_skill_search.py:731`.

### `lightbulb.WorkflowLearningDisposition`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import WorkflowLearningDisposition
~~~


Binding: `lightbulb.governed_skill_search.WorkflowLearningDisposition` → `lightbulb.governed_skill_search.WorkflowLearningDisposition`.

Source: `lightbulb/governed_skill_search.py:708`.

### `lightbulb.compile_memory_skill_search_receipt`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import compile_memory_skill_search_receipt
~~~


Binding: `lightbulb.governed_skill_search.compile_memory_skill_search_receipt` → `lightbulb.governed_skill_search.compile_memory_skill_search_receipt`.

Source: `lightbulb/governed_skill_search.py:489`.

### `lightbulb.compile_workflow_execution_learning_record`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import compile_workflow_execution_learning_record
~~~


Binding: `lightbulb.governed_skill_search.compile_workflow_execution_learning_record` → `lightbulb.governed_skill_search.compile_workflow_execution_learning_record`.

Source: `lightbulb/governed_skill_search.py:822`.

### `lightbulb.CRM_TOUCHPOINT_RECEIPT_V1_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CRM_TOUCHPOINT_RECEIPT_V1_SCHEMA
~~~


Binding: `lightbulb.communication_contracts.CRM_TOUCHPOINT_RECEIPT_V1_SCHEMA` → `lightbulb.communication_contracts.CRM_TOUCHPOINT_RECEIPT_V1_SCHEMA`.

Source: `lightbulb/communication_contracts.py:69`.

### `lightbulb.CRM_TOUCHPOINT_RECEIPT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CRM_TOUCHPOINT_RECEIPT_SCHEMA
~~~


Binding: `lightbulb.communication_contracts.CRM_TOUCHPOINT_RECEIPT_SCHEMA` → `lightbulb.communication_contracts.CRM_TOUCHPOINT_RECEIPT_SCHEMA`.

Source: `lightbulb/communication_contracts.py:70`.

### `lightbulb.COMMUNICATION_CHANNEL_OBSERVATION_RESULT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import COMMUNICATION_CHANNEL_OBSERVATION_RESULT_SCHEMA
~~~


Binding: `lightbulb.communication_channel_observation.COMMUNICATION_CHANNEL_OBSERVATION_RESULT_SCHEMA` → `lightbulb.communication_channel_observation.COMMUNICATION_CHANNEL_OBSERVATION_RESULT_SCHEMA`.

Source: `lightbulb/communication_channel_observation.py:48`.

### `lightbulb.COMMUNICATION_CHANNEL_DISPATCH_RECOVERY_STAGE_REQUEST_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import COMMUNICATION_CHANNEL_DISPATCH_RECOVERY_STAGE_REQUEST_SCHEMA
~~~


Binding: `lightbulb.communication_dispatch_recovery.COMMUNICATION_CHANNEL_DISPATCH_RECOVERY_STAGE_REQUEST_SCHEMA` → `lightbulb.communication_dispatch_recovery.COMMUNICATION_CHANNEL_DISPATCH_RECOVERY_STAGE_REQUEST_SCHEMA`.

Source: `lightbulb/communication_dispatch_recovery.py:110`.

### `lightbulb.COMMUNICATION_CHANNEL_DISPATCH_RECOVERY_STAGE_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import COMMUNICATION_CHANNEL_DISPATCH_RECOVERY_STAGE_SCHEMA
~~~


Binding: `lightbulb.communication_dispatch_recovery.COMMUNICATION_CHANNEL_DISPATCH_RECOVERY_STAGE_SCHEMA` → `lightbulb.communication_dispatch_recovery.COMMUNICATION_CHANNEL_DISPATCH_RECOVERY_STAGE_SCHEMA`.

Source: `lightbulb/communication_dispatch_recovery.py:113`.

### `lightbulb.COMMUNICATION_CHANNEL_POLL_ARTIFACTS_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import COMMUNICATION_CHANNEL_POLL_ARTIFACTS_SCHEMA
~~~


Binding: `lightbulb.communication_dispatch_recovery.COMMUNICATION_CHANNEL_POLL_ARTIFACTS_SCHEMA` → `lightbulb.communication_dispatch_recovery.COMMUNICATION_CHANNEL_POLL_ARTIFACTS_SCHEMA`.

Source: `lightbulb/communication_dispatch_recovery.py:119`.

### `lightbulb.COMMUNICATION_CHANNEL_POLL_TEMPLATE_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import COMMUNICATION_CHANNEL_POLL_TEMPLATE_SCHEMA
~~~


Binding: `lightbulb.communication_dispatch_recovery.COMMUNICATION_CHANNEL_POLL_TEMPLATE_SCHEMA` → `lightbulb.communication_dispatch_recovery.COMMUNICATION_CHANNEL_POLL_TEMPLATE_SCHEMA`.

Source: `lightbulb/communication_dispatch_recovery.py:116`.

### `lightbulb.COMMUNICATION_CHANNEL_PRIVATE_RESULT_COMMITMENTS_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import COMMUNICATION_CHANNEL_PRIVATE_RESULT_COMMITMENTS_SCHEMA
~~~


Binding: `lightbulb.communication_channels.COMMUNICATION_CHANNEL_PRIVATE_RESULT_COMMITMENTS_SCHEMA` → `lightbulb.communication_channels.COMMUNICATION_CHANNEL_PRIVATE_RESULT_COMMITMENTS_SCHEMA`.

Source: `lightbulb/communication_channels.py:56`.

### `lightbulb.COMMUNICATION_CHANNEL_READ_ROUTE_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import COMMUNICATION_CHANNEL_READ_ROUTE_SCHEMA
~~~


Binding: `lightbulb.communication_channels.COMMUNICATION_CHANNEL_READ_ROUTE_SCHEMA` → `lightbulb.communication_channels.COMMUNICATION_CHANNEL_READ_ROUTE_SCHEMA`.

Source: `lightbulb/communication_channels.py:44`.

### `lightbulb.COMMUNICATION_CHANNEL_TURN_BINDING_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import COMMUNICATION_CHANNEL_TURN_BINDING_SCHEMA
~~~


Binding: `lightbulb.communication_channels.COMMUNICATION_CHANNEL_TURN_BINDING_SCHEMA` → `lightbulb.communication_channels.COMMUNICATION_CHANNEL_TURN_BINDING_SCHEMA`.

Source: `lightbulb/communication_channels.py:38`.

### `lightbulb.COMMUNICATION_CHANNEL_WRITE_ROUTE_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import COMMUNICATION_CHANNEL_WRITE_ROUTE_SCHEMA
~~~


Binding: `lightbulb.communication_channels.COMMUNICATION_CHANNEL_WRITE_ROUTE_SCHEMA` → `lightbulb.communication_channels.COMMUNICATION_CHANNEL_WRITE_ROUTE_SCHEMA`.

Source: `lightbulb/communication_channels.py:41`.

### `lightbulb.COMMUNICATION_APPROVAL_GRANT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import COMMUNICATION_APPROVAL_GRANT_SCHEMA
~~~


Binding: `lightbulb.communication_contracts.COMMUNICATION_APPROVAL_GRANT_SCHEMA` → `lightbulb.communication_contracts.COMMUNICATION_APPROVAL_GRANT_SCHEMA`.

Source: `lightbulb/communication_contracts.py:62`.

### `lightbulb.COMMUNICATION_CONTACT_POLICY_DECISION_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import COMMUNICATION_CONTACT_POLICY_DECISION_SCHEMA
~~~


Binding: `lightbulb.communication_contracts.COMMUNICATION_CONTACT_POLICY_DECISION_SCHEMA` → `lightbulb.communication_contracts.COMMUNICATION_CONTACT_POLICY_DECISION_SCHEMA`.

Source: `lightbulb/communication_contracts.py:50`.

### `lightbulb.COMMUNICATION_CONTACT_RESERVATION_CONSUMPTION_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import COMMUNICATION_CONTACT_RESERVATION_CONSUMPTION_SCHEMA
~~~


Binding: `lightbulb.communication_contracts.COMMUNICATION_CONTACT_RESERVATION_CONSUMPTION_SCHEMA` → `lightbulb.communication_contracts.COMMUNICATION_CONTACT_RESERVATION_CONSUMPTION_SCHEMA`.

Source: `lightbulb/communication_contracts.py:59`.

### `lightbulb.COMMUNICATION_CONTACT_RESERVATION_REQUEST_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import COMMUNICATION_CONTACT_RESERVATION_REQUEST_SCHEMA
~~~


Binding: `lightbulb.communication_contracts.COMMUNICATION_CONTACT_RESERVATION_REQUEST_SCHEMA` → `lightbulb.communication_contracts.COMMUNICATION_CONTACT_RESERVATION_REQUEST_SCHEMA`.

Source: `lightbulb/communication_contracts.py:53`.

### `lightbulb.COMMUNICATION_CONTACT_RESERVATION_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import COMMUNICATION_CONTACT_RESERVATION_SCHEMA
~~~


Binding: `lightbulb.communication_contracts.COMMUNICATION_CONTACT_RESERVATION_SCHEMA` → `lightbulb.communication_contracts.COMMUNICATION_CONTACT_RESERVATION_SCHEMA`.

Source: `lightbulb/communication_contracts.py:56`.

### `lightbulb.COMMUNICATION_CONTEXT_SNAPSHOT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import COMMUNICATION_CONTEXT_SNAPSHOT_SCHEMA
~~~


Binding: `lightbulb.communication_contracts.COMMUNICATION_CONTEXT_SNAPSHOT_SCHEMA` → `lightbulb.communication_contracts.COMMUNICATION_CONTEXT_SNAPSHOT_SCHEMA`.

Source: `lightbulb/communication_contracts.py:48`.

### `lightbulb.COMMUNICATION_CRM_TRACE_BINDING_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import COMMUNICATION_CRM_TRACE_BINDING_SCHEMA
~~~


Binding: `lightbulb.communication_runtime.COMMUNICATION_CRM_TRACE_BINDING_SCHEMA` → `lightbulb.communication_runtime.COMMUNICATION_CRM_TRACE_BINDING_SCHEMA`.

Source: `lightbulb/communication_runtime.py:74`.

### `lightbulb.COMMUNICATION_CRM_TRACE_BINDING_V1_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import COMMUNICATION_CRM_TRACE_BINDING_V1_SCHEMA
~~~


Binding: `lightbulb.communication_runtime.COMMUNICATION_CRM_TRACE_BINDING_V1_SCHEMA` → `lightbulb.communication_runtime.COMMUNICATION_CRM_TRACE_BINDING_V1_SCHEMA`.

Source: `lightbulb/communication_runtime.py:71`.

### `lightbulb.COMMUNICATION_DISPATCH_RECEIPT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import COMMUNICATION_DISPATCH_RECEIPT_SCHEMA
~~~


Binding: `lightbulb.communication_contracts.COMMUNICATION_DISPATCH_RECEIPT_SCHEMA` → `lightbulb.communication_contracts.COMMUNICATION_DISPATCH_RECEIPT_SCHEMA`.

Source: `lightbulb/communication_contracts.py:63`.

### `lightbulb.COMMUNICATION_ENDPOINT_BINDING_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import COMMUNICATION_ENDPOINT_BINDING_SCHEMA
~~~


Binding: `lightbulb.communication_contracts.COMMUNICATION_ENDPOINT_BINDING_SCHEMA` → `lightbulb.communication_contracts.COMMUNICATION_ENDPOINT_BINDING_SCHEMA`.

Source: `lightbulb/communication_contracts.py:46`.

### `lightbulb.COMMUNICATION_GMAIL_ROUTE_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import COMMUNICATION_GMAIL_ROUTE_SCHEMA
~~~


Binding: `lightbulb.communication_materializer.COMMUNICATION_GMAIL_ROUTE_SCHEMA` → `lightbulb.communication_materializer.COMMUNICATION_GMAIL_ROUTE_SCHEMA`.

Source: `lightbulb/communication_materializer.py:65`.

### `lightbulb.COMMUNICATION_GMAIL_OBSERVATION_RESULT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import COMMUNICATION_GMAIL_OBSERVATION_RESULT_SCHEMA
~~~


Binding: `lightbulb.communication_observation.COMMUNICATION_GMAIL_OBSERVATION_RESULT_SCHEMA` → `lightbulb.communication_observation.COMMUNICATION_GMAIL_OBSERVATION_RESULT_SCHEMA`.

Source: `lightbulb/communication_observation.py:82`.

### `lightbulb.COMMUNICATION_GMAIL_READ_ROUTE_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import COMMUNICATION_GMAIL_READ_ROUTE_SCHEMA
~~~


Binding: `lightbulb.communication_observation.COMMUNICATION_GMAIL_READ_ROUTE_SCHEMA` → `lightbulb.communication_observation.COMMUNICATION_GMAIL_READ_ROUTE_SCHEMA`.

Source: `lightbulb/communication_observation.py:76`.

### `lightbulb.COMMUNICATION_GMAIL_TRACE_RESULT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import COMMUNICATION_GMAIL_TRACE_RESULT_SCHEMA
~~~


Binding: `lightbulb.communication_runtime.COMMUNICATION_GMAIL_TRACE_RESULT_SCHEMA` → `lightbulb.communication_runtime.COMMUNICATION_GMAIL_TRACE_RESULT_SCHEMA`.

Source: `lightbulb/communication_runtime.py:75`.

### `lightbulb.COMMUNICATION_TRACE_RESULT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import COMMUNICATION_TRACE_RESULT_SCHEMA
~~~


Binding: `lightbulb.communication_runtime.COMMUNICATION_TRACE_RESULT_SCHEMA` → `lightbulb.communication_runtime.COMMUNICATION_TRACE_RESULT_SCHEMA`.

Source: `lightbulb/communication_runtime.py:78`.

### `lightbulb.COMMUNICATION_HANDOFF_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import COMMUNICATION_HANDOFF_SCHEMA
~~~


Binding: `lightbulb.communication_contracts.COMMUNICATION_HANDOFF_SCHEMA` → `lightbulb.communication_contracts.COMMUNICATION_HANDOFF_SCHEMA`.

Source: `lightbulb/communication_contracts.py:74`.

### `lightbulb.COMMUNICATION_INBOUND_MESSAGE_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import COMMUNICATION_INBOUND_MESSAGE_SCHEMA
~~~


Binding: `lightbulb.communication_contracts.COMMUNICATION_INBOUND_MESSAGE_SCHEMA` → `lightbulb.communication_contracts.COMMUNICATION_INBOUND_MESSAGE_SCHEMA`.

Source: `lightbulb/communication_contracts.py:65`.

### `lightbulb.COMMUNICATION_DISPATCH_RECOVERY_FINALIZATION_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import COMMUNICATION_DISPATCH_RECOVERY_FINALIZATION_SCHEMA
~~~


Binding: `lightbulb.communication_dispatch_recovery.COMMUNICATION_DISPATCH_RECOVERY_FINALIZATION_SCHEMA` → `lightbulb.communication_dispatch_recovery.COMMUNICATION_DISPATCH_RECOVERY_FINALIZATION_SCHEMA`.

Source: `lightbulb/communication_dispatch_recovery.py:101`.

### `lightbulb.COMMUNICATION_DISPATCH_RECOVERY_STAGE_REQUEST_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import COMMUNICATION_DISPATCH_RECOVERY_STAGE_REQUEST_SCHEMA
~~~


Binding: `lightbulb.communication_dispatch_recovery.COMMUNICATION_DISPATCH_RECOVERY_STAGE_REQUEST_SCHEMA` → `lightbulb.communication_dispatch_recovery.COMMUNICATION_DISPATCH_RECOVERY_STAGE_REQUEST_SCHEMA`.

Source: `lightbulb/communication_dispatch_recovery.py:95`.

### `lightbulb.COMMUNICATION_DISPATCH_RECOVERY_STAGE_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import COMMUNICATION_DISPATCH_RECOVERY_STAGE_SCHEMA
~~~


Binding: `lightbulb.communication_dispatch_recovery.COMMUNICATION_DISPATCH_RECOVERY_STAGE_SCHEMA` → `lightbulb.communication_dispatch_recovery.COMMUNICATION_DISPATCH_RECOVERY_STAGE_SCHEMA`.

Source: `lightbulb/communication_dispatch_recovery.py:98`.

### `lightbulb.COMMUNICATION_GMAIL_POLL_TEMPLATE_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import COMMUNICATION_GMAIL_POLL_TEMPLATE_SCHEMA
~~~


Binding: `lightbulb.communication_dispatch_recovery.COMMUNICATION_GMAIL_POLL_TEMPLATE_SCHEMA` → `lightbulb.communication_dispatch_recovery.COMMUNICATION_GMAIL_POLL_TEMPLATE_SCHEMA`.

Source: `lightbulb/communication_dispatch_recovery.py:104`.

### `lightbulb.COMMUNICATION_MATERIALIZATION_RESULT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import COMMUNICATION_MATERIALIZATION_RESULT_SCHEMA
~~~


Binding: `lightbulb.communication_materializer.COMMUNICATION_MATERIALIZATION_RESULT_SCHEMA` → `lightbulb.communication_materializer.COMMUNICATION_MATERIALIZATION_RESULT_SCHEMA`.

Source: `lightbulb/communication_materializer.py:69`.

### `lightbulb.COMMUNICATION_MESSAGE_DRAFT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import COMMUNICATION_MESSAGE_DRAFT_SCHEMA
~~~


Binding: `lightbulb.communication_contracts.COMMUNICATION_MESSAGE_DRAFT_SCHEMA` → `lightbulb.communication_contracts.COMMUNICATION_MESSAGE_DRAFT_SCHEMA`.

Source: `lightbulb/communication_contracts.py:49`.

### `lightbulb.COMMUNICATION_OUTLOOK_OBSERVATION_RESULT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import COMMUNICATION_OUTLOOK_OBSERVATION_RESULT_SCHEMA
~~~


Binding: `lightbulb.communication_outlook_observation.COMMUNICATION_OUTLOOK_OBSERVATION_RESULT_SCHEMA` → `lightbulb.communication_outlook_observation.COMMUNICATION_OUTLOOK_OBSERVATION_RESULT_SCHEMA`.

Source: `lightbulb/communication_outlook_observation.py:53`.

### `lightbulb.COMMUNICATION_OUTLOOK_POLL_TEMPLATE_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import COMMUNICATION_OUTLOOK_POLL_TEMPLATE_SCHEMA
~~~


Binding: `lightbulb.communication_dispatch_recovery.COMMUNICATION_OUTLOOK_POLL_TEMPLATE_SCHEMA` → `lightbulb.communication_dispatch_recovery.COMMUNICATION_OUTLOOK_POLL_TEMPLATE_SCHEMA`.

Source: `lightbulb/communication_dispatch_recovery.py:107`.

### `lightbulb.COMMUNICATION_OUTLOOK_POLL_ARTIFACTS_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import COMMUNICATION_OUTLOOK_POLL_ARTIFACTS_SCHEMA
~~~


Binding: `lightbulb.communication_outlook_host.COMMUNICATION_OUTLOOK_POLL_ARTIFACTS_SCHEMA` → `lightbulb.communication_outlook_host.COMMUNICATION_OUTLOOK_POLL_ARTIFACTS_SCHEMA`.

Source: `lightbulb/communication_outlook_host.py:41`.

### `lightbulb.COMMUNICATION_OUTLOOK_READ_ROUTE_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import COMMUNICATION_OUTLOOK_READ_ROUTE_SCHEMA
~~~


Binding: `lightbulb.communication_outlook_observation.COMMUNICATION_OUTLOOK_READ_ROUTE_SCHEMA` → `lightbulb.communication_outlook_observation.COMMUNICATION_OUTLOOK_READ_ROUTE_SCHEMA`.

Source: `lightbulb/communication_outlook_observation.py:47`.

### `lightbulb.COMMUNICATION_OUTLOOK_ROUTE_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import COMMUNICATION_OUTLOOK_ROUTE_SCHEMA
~~~


Binding: `lightbulb.communication_outlook.COMMUNICATION_OUTLOOK_ROUTE_SCHEMA` → `lightbulb.communication_outlook.COMMUNICATION_OUTLOOK_ROUTE_SCHEMA`.

Source: `lightbulb/communication_outlook.py:29`.

### `lightbulb.COMMUNICATION_OUTLOOK_TRACE_RESULT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import COMMUNICATION_OUTLOOK_TRACE_RESULT_SCHEMA
~~~


Binding: `lightbulb.communication_outlook_runtime.COMMUNICATION_OUTLOOK_TRACE_RESULT_SCHEMA` → `lightbulb.communication_outlook_runtime.COMMUNICATION_OUTLOOK_TRACE_RESULT_SCHEMA`.

Source: `lightbulb/communication_outlook_runtime.py:21`.

### `lightbulb.COMMUNICATION_OUTCOME_OBSERVATION_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import COMMUNICATION_OUTCOME_OBSERVATION_SCHEMA
~~~


Binding: `lightbulb.communication_contracts.COMMUNICATION_OUTCOME_OBSERVATION_SCHEMA` → `lightbulb.communication_contracts.COMMUNICATION_OUTCOME_OBSERVATION_SCHEMA`.

Source: `lightbulb/communication_contracts.py:71`.

### `lightbulb.COMMUNICATION_PARTY_REF_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import COMMUNICATION_PARTY_REF_SCHEMA
~~~


Binding: `lightbulb.communication_contracts.COMMUNICATION_PARTY_REF_SCHEMA` → `lightbulb.communication_contracts.COMMUNICATION_PARTY_REF_SCHEMA`.

Source: `lightbulb/communication_contracts.py:45`.

### `lightbulb.COMMUNICATION_PRIVATE_CHANNEL_DISPATCH_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import COMMUNICATION_PRIVATE_CHANNEL_DISPATCH_SCHEMA
~~~


Binding: `lightbulb.communication_channels.COMMUNICATION_PRIVATE_CHANNEL_DISPATCH_SCHEMA` → `lightbulb.communication_channels.COMMUNICATION_PRIVATE_CHANNEL_DISPATCH_SCHEMA`.

Source: `lightbulb/communication_channels.py:50`.

### `lightbulb.COMMUNICATION_PRIVATE_CHANNEL_INBOUND_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import COMMUNICATION_PRIVATE_CHANNEL_INBOUND_SCHEMA
~~~


Binding: `lightbulb.communication_channels.COMMUNICATION_PRIVATE_CHANNEL_INBOUND_SCHEMA` → `lightbulb.communication_channels.COMMUNICATION_PRIVATE_CHANNEL_INBOUND_SCHEMA`.

Source: `lightbulb/communication_channels.py:53`.

### `lightbulb.COMMUNICATION_PRIVATE_CHANNEL_TURN_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import COMMUNICATION_PRIVATE_CHANNEL_TURN_SCHEMA
~~~


Binding: `lightbulb.communication_channels.COMMUNICATION_PRIVATE_CHANNEL_TURN_SCHEMA` → `lightbulb.communication_channels.COMMUNICATION_PRIVATE_CHANNEL_TURN_SCHEMA`.

Source: `lightbulb/communication_channels.py:47`.

### `lightbulb.COMMUNICATION_PRIVATE_GMAIL_INBOUND_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import COMMUNICATION_PRIVATE_GMAIL_INBOUND_SCHEMA
~~~


Binding: `lightbulb.communication_runtime.COMMUNICATION_PRIVATE_GMAIL_INBOUND_SCHEMA` → `lightbulb.communication_runtime.COMMUNICATION_PRIVATE_GMAIL_INBOUND_SCHEMA`.

Source: `lightbulb/communication_runtime.py:68`.

### `lightbulb.COMMUNICATION_PRIVATE_GMAIL_DISPATCH_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import COMMUNICATION_PRIVATE_GMAIL_DISPATCH_SCHEMA
~~~


Binding: `lightbulb.communication_observation.COMMUNICATION_PRIVATE_GMAIL_DISPATCH_SCHEMA` → `lightbulb.communication_observation.COMMUNICATION_PRIVATE_GMAIL_DISPATCH_SCHEMA`.

Source: `lightbulb/communication_observation.py:79`.

### `lightbulb.COMMUNICATION_PRIVATE_GMAIL_MESSAGE_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import COMMUNICATION_PRIVATE_GMAIL_MESSAGE_SCHEMA
~~~


Binding: `lightbulb.communication_materializer.COMMUNICATION_PRIVATE_GMAIL_MESSAGE_SCHEMA` → `lightbulb.communication_materializer.COMMUNICATION_PRIVATE_GMAIL_MESSAGE_SCHEMA`.

Source: `lightbulb/communication_materializer.py:66`.

### `lightbulb.COMMUNICATION_PRIVATE_OUTLOOK_DISPATCH_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import COMMUNICATION_PRIVATE_OUTLOOK_DISPATCH_SCHEMA
~~~


Binding: `lightbulb.communication_outlook_observation.COMMUNICATION_PRIVATE_OUTLOOK_DISPATCH_SCHEMA` → `lightbulb.communication_outlook_observation.COMMUNICATION_PRIVATE_OUTLOOK_DISPATCH_SCHEMA`.

Source: `lightbulb/communication_outlook_observation.py:50`.

### `lightbulb.COMMUNICATION_PRIVATE_OUTLOOK_INBOUND_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import COMMUNICATION_PRIVATE_OUTLOOK_INBOUND_SCHEMA
~~~


Binding: `lightbulb.communication_outlook_runtime.COMMUNICATION_PRIVATE_OUTLOOK_INBOUND_SCHEMA` → `lightbulb.communication_outlook_runtime.COMMUNICATION_PRIVATE_OUTLOOK_INBOUND_SCHEMA`.

Source: `lightbulb/communication_outlook_runtime.py:16`.

### `lightbulb.COMMUNICATION_PRIVATE_OUTLOOK_MESSAGE_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import COMMUNICATION_PRIVATE_OUTLOOK_MESSAGE_SCHEMA
~~~


Binding: `lightbulb.communication_outlook.COMMUNICATION_PRIVATE_OUTLOOK_MESSAGE_SCHEMA` → `lightbulb.communication_outlook.COMMUNICATION_PRIVATE_OUTLOOK_MESSAGE_SCHEMA`.

Source: `lightbulb/communication_outlook.py:30`.

### `lightbulb.COMMUNICATION_PROVIDER_EVENT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import COMMUNICATION_PROVIDER_EVENT_SCHEMA
~~~


Binding: `lightbulb.communication_contracts.COMMUNICATION_PROVIDER_EVENT_SCHEMA` → `lightbulb.communication_contracts.COMMUNICATION_PROVIDER_EVENT_SCHEMA`.

Source: `lightbulb/communication_contracts.py:64`.

### `lightbulb.COMMUNICATION_POLL_PLAN_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import COMMUNICATION_POLL_PLAN_SCHEMA
~~~


Binding: `lightbulb.communication_dispatch_recovery.COMMUNICATION_POLL_PLAN_SCHEMA` → `lightbulb.communication_dispatch_recovery.COMMUNICATION_POLL_PLAN_SCHEMA`.

Source: `lightbulb/communication_dispatch_recovery.py:122`.

### `lightbulb.COMMUNICATION_REPLY_INTERPRETATION_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import COMMUNICATION_REPLY_INTERPRETATION_SCHEMA
~~~


Binding: `lightbulb.communication_contracts.COMMUNICATION_REPLY_INTERPRETATION_SCHEMA` → `lightbulb.communication_contracts.COMMUNICATION_REPLY_INTERPRETATION_SCHEMA`.

Source: `lightbulb/communication_contracts.py:66`.

### `lightbulb.COMMUNICATION_THREAD_BINDING_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import COMMUNICATION_THREAD_BINDING_SCHEMA
~~~


Binding: `lightbulb.communication_contracts.COMMUNICATION_THREAD_BINDING_SCHEMA` → `lightbulb.communication_contracts.COMMUNICATION_THREAD_BINDING_SCHEMA`.

Source: `lightbulb/communication_contracts.py:47`.

### `lightbulb.COMMUNICATION_TURN_PLAN_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import COMMUNICATION_TURN_PLAN_SCHEMA
~~~


Binding: `lightbulb.communication_primitives.COMMUNICATION_TURN_PLAN_SCHEMA` → `lightbulb.communication_primitives.COMMUNICATION_TURN_PLAN_SCHEMA`.

Source: `lightbulb/communication_primitives.py:28`.

### `lightbulb.CommunicationApprovalDisposition`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommunicationApprovalDisposition
~~~


Binding: `lightbulb.communication_contracts.CommunicationApprovalDisposition` → `lightbulb.communication_contracts.CommunicationApprovalDisposition`.

Source: `lightbulb/communication_contracts.py:200`.

### `lightbulb.CommunicationApprovalGrant`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommunicationApprovalGrant
~~~


Binding: `lightbulb.communication_contracts.CommunicationApprovalGrant` → `lightbulb.communication_contracts.CommunicationApprovalGrant`.

Source: `lightbulb/communication_contracts.py:897`.

### `lightbulb.CommunicationArtifact`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommunicationArtifact
~~~


Binding: `lightbulb.communication_contracts.CommunicationArtifact` → `lightbulb.communication_contracts.CommunicationArtifact`.

Source: `lightbulb/communication_contracts.py:339`.

### `lightbulb.CommunicationAuthenticityGrade`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommunicationAuthenticityGrade
~~~


Binding: `lightbulb.communication_contracts.CommunicationAuthenticityGrade` → `lightbulb.communication_contracts.CommunicationAuthenticityGrade`.

Source: `lightbulb/communication_contracts.py:149`.

### `lightbulb.CommunicationChannel`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommunicationChannel
~~~


Binding: `lightbulb.communication_contracts.CommunicationChannel` → `lightbulb.communication_contracts.CommunicationChannel`.

Source: `lightbulb/communication_contracts.py:119`.

### `lightbulb.CommunicationChannelObservationResult`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommunicationChannelObservationResult
~~~


Binding: `lightbulb.communication_channel_observation.CommunicationChannelObservationResult` → `lightbulb.communication_channel_observation.CommunicationChannelObservationResult`.

Source: `lightbulb/communication_channel_observation.py:224`.

### `lightbulb.CommunicationChannelObservationStatus`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommunicationChannelObservationStatus
~~~


Binding: `lightbulb.communication_channel_observation.CommunicationChannelObservationStatus` → `lightbulb.communication_channel_observation.CommunicationChannelObservationStatus`.

Source: `lightbulb/communication_channel_observation.py:219`.

### `lightbulb.CommunicationChannelDispatchRecoveryStage`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommunicationChannelDispatchRecoveryStage
~~~


Binding: `lightbulb.communication_dispatch_recovery.CommunicationChannelDispatchRecoveryStage` → `lightbulb.communication_dispatch_recovery.CommunicationChannelDispatchRecoveryStage`.

Source: `lightbulb/communication_dispatch_recovery.py:519`.

### `lightbulb.CommunicationChannelDispatchRecoveryStageRequest`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommunicationChannelDispatchRecoveryStageRequest
~~~


Binding: `lightbulb.communication_dispatch_recovery.CommunicationChannelDispatchRecoveryStageRequest` → `lightbulb.communication_dispatch_recovery.CommunicationChannelDispatchRecoveryStageRequest`.

Source: `lightbulb/communication_dispatch_recovery.py:482`.

### `lightbulb.CommunicationChannelPollArtifacts`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommunicationChannelPollArtifacts
~~~


Binding: `lightbulb.communication_dispatch_recovery.CommunicationChannelPollArtifacts` → `lightbulb.communication_dispatch_recovery.CommunicationChannelPollArtifacts`.

Source: `lightbulb/communication_dispatch_recovery.py:855`.

### `lightbulb.CommunicationChannelPollTemplate`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommunicationChannelPollTemplate
~~~


Binding: `lightbulb.communication_dispatch_recovery.CommunicationChannelPollTemplate` → `lightbulb.communication_dispatch_recovery.CommunicationChannelPollTemplate`.

Source: `lightbulb/communication_dispatch_recovery.py:275`.

### `lightbulb.CommunicationChannelPrivateResultCommitments`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommunicationChannelPrivateResultCommitments
~~~


Binding: `lightbulb.communication_channels.CommunicationChannelPrivateResultCommitments` → `lightbulb.communication_channels.CommunicationChannelPrivateResultCommitments`.

Source: `lightbulb/communication_channels.py:515`.

### `lightbulb.CommunicationChannelReadRoute`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommunicationChannelReadRoute
~~~


Binding: `lightbulb.communication_channels.CommunicationChannelReadRoute` → `lightbulb.communication_channels.CommunicationChannelReadRoute`.

Source: `lightbulb/communication_channels.py:301`.

### `lightbulb.CommunicationChannelTurnBinding`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommunicationChannelTurnBinding
~~~


Binding: `lightbulb.communication_channels.CommunicationChannelTurnBinding` → `lightbulb.communication_channels.CommunicationChannelTurnBinding`.

Source: `lightbulb/communication_channels.py:330`.

### `lightbulb.CommunicationChannelWriteRoute`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommunicationChannelWriteRoute
~~~


Binding: `lightbulb.communication_channels.CommunicationChannelWriteRoute` → `lightbulb.communication_channels.CommunicationChannelWriteRoute`.

Source: `lightbulb/communication_channels.py:272`.

### `lightbulb.CommunicationConsentStatus`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommunicationConsentStatus
~~~


Binding: `lightbulb.communication_contracts.CommunicationConsentStatus` → `lightbulb.communication_contracts.CommunicationConsentStatus`.

Source: `lightbulb/communication_contracts.py:175`.

### `lightbulb.CommunicationContactPolicyDecision`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommunicationContactPolicyDecision
~~~


Binding: `lightbulb.communication_contracts.CommunicationContactPolicyDecision` → `lightbulb.communication_contracts.CommunicationContactPolicyDecision`.

Source: `lightbulb/communication_contracts.py:689`.

### `lightbulb.CommunicationContactReservation`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommunicationContactReservation
~~~


Binding: `lightbulb.communication_contracts.CommunicationContactReservation` → `lightbulb.communication_contracts.CommunicationContactReservation`.

Source: `lightbulb/communication_contracts.py:851`.

### `lightbulb.CommunicationContactReservationAuthority`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommunicationContactReservationAuthority
~~~


Binding: `lightbulb.communication_governance.CommunicationContactReservationAuthority` → `lightbulb.communication_governance.CommunicationContactReservationAuthority`.

Source: `lightbulb/communication_governance.py:40`.

### `lightbulb.CommunicationContactReservationConflict`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommunicationContactReservationConflict
~~~


Binding: `lightbulb.communication_governance.CommunicationContactReservationConflict` → `lightbulb.communication_governance.CommunicationContactReservationConflict`.

Source: `lightbulb/communication_governance.py:35`.

### `lightbulb.CommunicationContactReservationConsumption`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommunicationContactReservationConsumption
~~~


Binding: `lightbulb.communication_contracts.CommunicationContactReservationConsumption` → `lightbulb.communication_contracts.CommunicationContactReservationConsumption`.

Source: `lightbulb/communication_contracts.py:878`.

### `lightbulb.CommunicationContactReservationRequest`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommunicationContactReservationRequest
~~~


Binding: `lightbulb.communication_contracts.CommunicationContactReservationRequest` → `lightbulb.communication_contracts.CommunicationContactReservationRequest`.

Source: `lightbulb/communication_contracts.py:773`.

### `lightbulb.CommunicationContextFact`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommunicationContextFact
~~~


Binding: `lightbulb.communication_contracts.CommunicationContextFact` → `lightbulb.communication_contracts.CommunicationContextFact`.

Source: `lightbulb/communication_contracts.py:522`.

### `lightbulb.CommunicationContextSnapshot`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommunicationContextSnapshot
~~~


Binding: `lightbulb.communication_contracts.CommunicationContextSnapshot` → `lightbulb.communication_contracts.CommunicationContextSnapshot`.

Source: `lightbulb/communication_contracts.py:535`.

### `lightbulb.CommunicationCrmTraceBinding`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommunicationCrmTraceBinding
~~~


Binding: `lightbulb.communication_runtime.CommunicationCrmTraceBinding` → `lightbulb.communication_runtime.CommunicationCrmTraceBinding`.

Source: `lightbulb/communication_runtime.py:294`.

### `lightbulb.CommunicationDataClassification`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommunicationDataClassification
~~~


Binding: `lightbulb.communication_contracts.CommunicationDataClassification` → `lightbulb.communication_contracts.CommunicationDataClassification`.

Source: `lightbulb/communication_contracts.py:162`.

### `lightbulb.CommunicationDispatchReceipt`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommunicationDispatchReceipt
~~~


Binding: `lightbulb.communication_contracts.CommunicationDispatchReceipt` → `lightbulb.communication_contracts.CommunicationDispatchReceipt`.

Source: `lightbulb/communication_contracts.py:965`.

### `lightbulb.CommunicationDispatchRecoveryAuthority`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommunicationDispatchRecoveryAuthority
~~~


Binding: `lightbulb.communication_dispatch_recovery.CommunicationDispatchRecoveryAuthority` → `lightbulb.communication_dispatch_recovery.CommunicationDispatchRecoveryAuthority`.

Source: `lightbulb/communication_dispatch_recovery.py:640`.

### `lightbulb.CommunicationDispatchRecoveryFinalization`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommunicationDispatchRecoveryFinalization
~~~


Binding: `lightbulb.communication_dispatch_recovery.CommunicationDispatchRecoveryFinalization` → `lightbulb.communication_dispatch_recovery.CommunicationDispatchRecoveryFinalization`.

Source: `lightbulb/communication_dispatch_recovery.py:889`.

### `lightbulb.CommunicationDispatchRecoveryStage`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommunicationDispatchRecoveryStage
~~~


Binding: `lightbulb.communication_dispatch_recovery.CommunicationDispatchRecoveryStage` → `lightbulb.communication_dispatch_recovery.CommunicationDispatchRecoveryStage`.

Source: `lightbulb/communication_dispatch_recovery.py:432`.

### `lightbulb.CommunicationDispatchRecoveryStageRequest`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommunicationDispatchRecoveryStageRequest
~~~


Binding: `lightbulb.communication_dispatch_recovery.CommunicationDispatchRecoveryStageRequest` → `lightbulb.communication_dispatch_recovery.CommunicationDispatchRecoveryStageRequest`.

Source: `lightbulb/communication_dispatch_recovery.py:397`.

### `lightbulb.CommunicationDispatchState`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommunicationDispatchState
~~~


Binding: `lightbulb.communication_contracts.CommunicationDispatchState` → `lightbulb.communication_contracts.CommunicationDispatchState`.

Source: `lightbulb/communication_contracts.py:205`.

### `lightbulb.CommunicationEndpointBinding`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommunicationEndpointBinding
~~~


Binding: `lightbulb.communication_contracts.CommunicationEndpointBinding` → `lightbulb.communication_contracts.CommunicationEndpointBinding`.

Source: `lightbulb/communication_contracts.py:413`.

### `lightbulb.CommunicationExternalEffectState`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommunicationExternalEffectState
~~~


Binding: `lightbulb.communication_materializer.CommunicationExternalEffectState` → `lightbulb.communication_materializer.CommunicationExternalEffectState`.

Source: `lightbulb/communication_materializer.py:463`.

### `lightbulb.CommunicationFrequencyStatus`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommunicationFrequencyStatus
~~~


Binding: `lightbulb.communication_contracts.CommunicationFrequencyStatus` → `lightbulb.communication_contracts.CommunicationFrequencyStatus`.

Source: `lightbulb/communication_contracts.py:194`.

### `lightbulb.CommunicationGmailRoute`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommunicationGmailRoute
~~~


Binding: `lightbulb.communication_materializer.CommunicationGmailRoute` → `lightbulb.communication_materializer.CommunicationGmailRoute`.

Source: `lightbulb/communication_materializer.py:120`.

### `lightbulb.CommunicationGmailObservationResult`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommunicationGmailObservationResult
~~~


Binding: `lightbulb.communication_observation.CommunicationGmailObservationResult` → `lightbulb.communication_observation.CommunicationGmailObservationResult`.

Source: `lightbulb/communication_observation.py:274`.

### `lightbulb.CommunicationGmailObservationStatus`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommunicationGmailObservationStatus
~~~


Binding: `lightbulb.communication_observation.CommunicationGmailObservationStatus` → `lightbulb.communication_observation.CommunicationGmailObservationStatus`.

Source: `lightbulb/communication_observation.py:269`.

### `lightbulb.CommunicationGmailPollTemplate`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommunicationGmailPollTemplate
~~~


Binding: `lightbulb.communication_dispatch_recovery.CommunicationGmailPollTemplate` → `lightbulb.communication_dispatch_recovery.CommunicationGmailPollTemplate`.

Source: `lightbulb/communication_dispatch_recovery.py:237`.

### `lightbulb.CommunicationGmailReadRoute`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommunicationGmailReadRoute
~~~


Binding: `lightbulb.communication_observation.CommunicationGmailReadRoute` → `lightbulb.communication_observation.CommunicationGmailReadRoute`.

Source: `lightbulb/communication_observation.py:145`.

### `lightbulb.CommunicationGmailTraceResult`

class alias. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommunicationGmailTraceResult
~~~


Binding: `lightbulb.communication_runtime.CommunicationGmailTraceResult` → `lightbulb.communication_runtime.CommunicationTraceResult`.

Source: `lightbulb/communication_runtime.py:418`.

### `lightbulb.CommunicationHandoff`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommunicationHandoff
~~~


Binding: `lightbulb.communication_contracts.CommunicationHandoff` → `lightbulb.communication_contracts.CommunicationHandoff`.

Source: `lightbulb/communication_contracts.py:1298`.

### `lightbulb.CommunicationHandoffEffect`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommunicationHandoffEffect
~~~


Binding: `lightbulb.communication_contracts.CommunicationHandoffEffect` → `lightbulb.communication_contracts.CommunicationHandoffEffect`.

Source: `lightbulb/communication_contracts.py:240`.

### `lightbulb.CommunicationInboundMessage`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommunicationInboundMessage
~~~


Binding: `lightbulb.communication_contracts.CommunicationInboundMessage` → `lightbulb.communication_contracts.CommunicationInboundMessage`.

Source: `lightbulb/communication_contracts.py:1063`.

### `lightbulb.CommunicationIntentScore`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommunicationIntentScore
~~~


Binding: `lightbulb.communication_contracts.CommunicationIntentScore` → `lightbulb.communication_contracts.CommunicationIntentScore`.

Source: `lightbulb/communication_contracts.py:1110`.

### `lightbulb.CommunicationMaterializationResult`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommunicationMaterializationResult
~~~


Binding: `lightbulb.communication_materializer.CommunicationMaterializationResult` → `lightbulb.communication_materializer.CommunicationMaterializationResult`.

Source: `lightbulb/communication_materializer.py:470`.

### `lightbulb.CommunicationMaterializationStatus`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommunicationMaterializationStatus
~~~


Binding: `lightbulb.communication_materializer.CommunicationMaterializationStatus` → `lightbulb.communication_materializer.CommunicationMaterializationStatus`.

Source: `lightbulb/communication_materializer.py:454`.

### `lightbulb.CommunicationMessageDraft`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommunicationMessageDraft
~~~


Binding: `lightbulb.communication_contracts.CommunicationMessageDraft` → `lightbulb.communication_contracts.CommunicationMessageDraft`.

Source: `lightbulb/communication_contracts.py:580`.

### `lightbulb.CommunicationObservedEventRepository`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommunicationObservedEventRepository
~~~


Binding: `lightbulb.communication_observation.CommunicationObservedEventRepository` → `lightbulb.communication_observation.CommunicationObservedEventRepository`.

Source: `lightbulb/communication_observation.py:310`.

### `lightbulb.CommunicationOutlookObservationResult`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommunicationOutlookObservationResult
~~~


Binding: `lightbulb.communication_outlook_observation.CommunicationOutlookObservationResult` → `lightbulb.communication_outlook_observation.CommunicationOutlookObservationResult`.

Source: `lightbulb/communication_outlook_observation.py:267`.

### `lightbulb.CommunicationOutlookObservationStatus`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommunicationOutlookObservationStatus
~~~


Binding: `lightbulb.communication_outlook_observation.CommunicationOutlookObservationStatus` → `lightbulb.communication_outlook_observation.CommunicationOutlookObservationStatus`.

Source: `lightbulb/communication_outlook_observation.py:261`.

### `lightbulb.CommunicationOutlookPollArtifacts`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommunicationOutlookPollArtifacts
~~~


Binding: `lightbulb.communication_outlook_host.CommunicationOutlookPollArtifacts` → `lightbulb.communication_outlook_host.CommunicationOutlookPollArtifacts`.

Source: `lightbulb/communication_outlook_host.py:46`.

### `lightbulb.CommunicationOutlookPollTemplate`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommunicationOutlookPollTemplate
~~~


Binding: `lightbulb.communication_dispatch_recovery.CommunicationOutlookPollTemplate` → `lightbulb.communication_dispatch_recovery.CommunicationOutlookPollTemplate`.

Source: `lightbulb/communication_dispatch_recovery.py:256`.

### `lightbulb.CommunicationOutlookReadRoute`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommunicationOutlookReadRoute
~~~


Binding: `lightbulb.communication_outlook_observation.CommunicationOutlookReadRoute` → `lightbulb.communication_outlook_observation.CommunicationOutlookReadRoute`.

Source: `lightbulb/communication_outlook_observation.py:72`.

### `lightbulb.CommunicationOutlookRoute`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommunicationOutlookRoute
~~~


Binding: `lightbulb.communication_outlook.CommunicationOutlookRoute` → `lightbulb.communication_outlook.CommunicationOutlookRoute`.

Source: `lightbulb/communication_outlook.py:61`.

### `lightbulb.CommunicationOutlookTraceResult`

class alias. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommunicationOutlookTraceResult
~~~


Binding: `lightbulb.communication_outlook_runtime.CommunicationOutlookTraceResult` → `lightbulb.communication_runtime.CommunicationTraceResult`.

Source: `lightbulb/communication_runtime.py:418`.

### `lightbulb.CommunicationOutcomeDimension`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommunicationOutcomeDimension
~~~


Binding: `lightbulb.communication_contracts.CommunicationOutcomeDimension` → `lightbulb.communication_contracts.CommunicationOutcomeDimension`.

Source: `lightbulb/communication_contracts.py:225`.

### `lightbulb.CommunicationOutcomeFact`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommunicationOutcomeFact
~~~


Binding: `lightbulb.communication_contracts.CommunicationOutcomeFact` → `lightbulb.communication_contracts.CommunicationOutcomeFact`.

Source: `lightbulb/communication_contracts.py:1238`.

### `lightbulb.CommunicationOutcomeObservation`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommunicationOutcomeObservation
~~~


Binding: `lightbulb.communication_contracts.CommunicationOutcomeObservation` → `lightbulb.communication_contracts.CommunicationOutcomeObservation`.

Source: `lightbulb/communication_contracts.py:1254`.

### `lightbulb.CommunicationPartyKind`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommunicationPartyKind
~~~


Binding: `lightbulb.communication_contracts.CommunicationPartyKind` → `lightbulb.communication_contracts.CommunicationPartyKind`.

Source: `lightbulb/communication_contracts.py:131`.

### `lightbulb.CommunicationPartyRef`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommunicationPartyRef
~~~


Binding: `lightbulb.communication_contracts.CommunicationPartyRef` → `lightbulb.communication_contracts.CommunicationPartyRef`.

Source: `lightbulb/communication_contracts.py:382`.

### `lightbulb.CommunicationPolicyDisposition`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommunicationPolicyDisposition
~~~


Binding: `lightbulb.communication_contracts.CommunicationPolicyDisposition` → `lightbulb.communication_contracts.CommunicationPolicyDisposition`.

Source: `lightbulb/communication_contracts.py:169`.

### `lightbulb.CommunicationPollPlan`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommunicationPollPlan
~~~


Binding: `lightbulb.communication_dispatch_recovery.CommunicationPollPlan` → `lightbulb.communication_dispatch_recovery.CommunicationPollPlan`.

Source: `lightbulb/communication_dispatch_recovery.py:162`.

### `lightbulb.CommunicationPrivateChannelDispatch`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommunicationPrivateChannelDispatch
~~~


Binding: `lightbulb.communication_channels.CommunicationPrivateChannelDispatch` → `lightbulb.communication_channels.CommunicationPrivateChannelDispatch`.

Source: `lightbulb/communication_channels.py:474`.

### `lightbulb.CommunicationPrivateChannelInbound`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommunicationPrivateChannelInbound
~~~


Binding: `lightbulb.communication_channels.CommunicationPrivateChannelInbound` → `lightbulb.communication_channels.CommunicationPrivateChannelInbound`.

Source: `lightbulb/communication_channels.py:704`.

### `lightbulb.CommunicationPrivateChannelTurn`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommunicationPrivateChannelTurn
~~~


Binding: `lightbulb.communication_channels.CommunicationPrivateChannelTurn` → `lightbulb.communication_channels.CommunicationPrivateChannelTurn`.

Source: `lightbulb/communication_channels.py:429`.

### `lightbulb.CommunicationPrivateDispatchSink`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommunicationPrivateDispatchSink
~~~


Binding: `lightbulb.communication_channels.CommunicationPrivateDispatchSink` → `lightbulb.communication_materializer.CommunicationPrivateDispatchSink`.

Source: `lightbulb/communication_materializer.py:220`.

### `lightbulb.CommunicationPrivateGmailInbound`

class alias. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommunicationPrivateGmailInbound
~~~


Binding: `lightbulb.communication_runtime.CommunicationPrivateGmailInbound` → `lightbulb.communication_runtime.CommunicationPrivateInbound`.

Source: `lightbulb/communication_runtime.py:197`.

### `lightbulb.CommunicationPrivateGmailDispatch`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommunicationPrivateGmailDispatch
~~~


Binding: `lightbulb.communication_observation.CommunicationPrivateGmailDispatch` → `lightbulb.communication_observation.CommunicationPrivateGmailDispatch`.

Source: `lightbulb/communication_observation.py:165`.

### `lightbulb.CommunicationPrivateGmailMessage`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommunicationPrivateGmailMessage
~~~


Binding: `lightbulb.communication_materializer.CommunicationPrivateGmailMessage` → `lightbulb.communication_materializer.CommunicationPrivateGmailMessage`.

Source: `lightbulb/communication_materializer.py:141`.

### `lightbulb.CommunicationPrivateOutlookDispatch`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommunicationPrivateOutlookDispatch
~~~


Binding: `lightbulb.communication_outlook_observation.CommunicationPrivateOutlookDispatch` → `lightbulb.communication_outlook_observation.CommunicationPrivateOutlookDispatch`.

Source: `lightbulb/communication_outlook_observation.py:92`.

### `lightbulb.CommunicationPrivateOutlookInbound`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommunicationPrivateOutlookInbound
~~~


Binding: `lightbulb.communication_outlook_runtime.CommunicationPrivateOutlookInbound` → `lightbulb.communication_outlook_runtime.CommunicationPrivateOutlookInbound`.

Source: `lightbulb/communication_outlook_runtime.py:26`.

### `lightbulb.CommunicationPrivateOutlookMessage`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommunicationPrivateOutlookMessage
~~~


Binding: `lightbulb.communication_outlook.CommunicationPrivateOutlookMessage` → `lightbulb.communication_outlook.CommunicationPrivateOutlookMessage`.

Source: `lightbulb/communication_outlook.py:82`.

### `lightbulb.CommunicationPrivateTwilioSmsDispatch`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommunicationPrivateTwilioSmsDispatch
~~~


Binding: `lightbulb.communication_twilio_sms.CommunicationPrivateTwilioSmsDispatch` → `lightbulb.communication_twilio_sms.CommunicationPrivateTwilioSmsDispatch`.

Source: `lightbulb/communication_twilio_sms.py:324`.

### `lightbulb.CommunicationPrivateTwilioSmsTurn`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommunicationPrivateTwilioSmsTurn
~~~


Binding: `lightbulb.communication_twilio_sms.CommunicationPrivateTwilioSmsTurn` → `lightbulb.communication_twilio_sms.CommunicationPrivateTwilioSmsTurn`.

Source: `lightbulb/communication_twilio_sms.py:206`.

### `lightbulb.CommunicationProviderEvent`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommunicationProviderEvent
~~~


Binding: `lightbulb.communication_contracts.CommunicationProviderEvent` → `lightbulb.communication_contracts.CommunicationProviderEvent`.

Source: `lightbulb/communication_contracts.py:1024`.

### `lightbulb.CommunicationProviderEventType`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommunicationProviderEventType
~~~


Binding: `lightbulb.communication_contracts.CommunicationProviderEventType` → `lightbulb.communication_contracts.CommunicationProviderEventType`.

Source: `lightbulb/communication_contracts.py:211`.

### `lightbulb.CommunicationPurpose`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommunicationPurpose
~~~


Binding: `lightbulb.communication_contracts.CommunicationPurpose` → `lightbulb.communication_contracts.CommunicationPurpose`.

Source: `lightbulb/communication_contracts.py:105`.

### `lightbulb.CommunicationQuietHoursStatus`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommunicationQuietHoursStatus
~~~


Binding: `lightbulb.communication_contracts.CommunicationQuietHoursStatus` → `lightbulb.communication_contracts.CommunicationQuietHoursStatus`.

Source: `lightbulb/communication_contracts.py:188`.

### `lightbulb.CommunicationReplayCapacityExceeded`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommunicationReplayCapacityExceeded
~~~


Binding: `lightbulb.communication_runtime.CommunicationReplayCapacityExceeded` → `lightbulb.communication_runtime.CommunicationReplayCapacityExceeded`.

Source: `lightbulb/communication_runtime.py:518`.

### `lightbulb.CommunicationReplayClaim`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommunicationReplayClaim
~~~


Binding: `lightbulb.communication_runtime.CommunicationReplayClaim` → `lightbulb.communication_runtime.CommunicationReplayClaim`.

Source: `lightbulb/communication_runtime.py:522`.

### `lightbulb.CommunicationReplayConflict`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommunicationReplayConflict
~~~


Binding: `lightbulb.communication_runtime.CommunicationReplayConflict` → `lightbulb.communication_runtime.CommunicationReplayConflict`.

Source: `lightbulb/communication_runtime.py:510`.

### `lightbulb.CommunicationReplayError`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommunicationReplayError
~~~


Binding: `lightbulb.communication_runtime.CommunicationReplayError` → `lightbulb.communication_runtime.CommunicationReplayError`.

Source: `lightbulb/communication_runtime.py:506`.

### `lightbulb.CommunicationReplayInProgress`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommunicationReplayInProgress
~~~


Binding: `lightbulb.communication_runtime.CommunicationReplayInProgress` → `lightbulb.communication_runtime.CommunicationReplayInProgress`.

Source: `lightbulb/communication_runtime.py:514`.

### `lightbulb.CommunicationReplayRepository`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommunicationReplayRepository
~~~


Binding: `lightbulb.communication_runtime.CommunicationReplayRepository` → `lightbulb.communication_runtime.CommunicationReplayRepository`.

Source: `lightbulb/communication_runtime.py:549`.

### `lightbulb.CommunicationRuntime`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommunicationRuntime
~~~


Binding: `lightbulb.communication_runtime.CommunicationRuntime` → `lightbulb.communication_runtime.CommunicationRuntime`.

Source: `lightbulb/communication_runtime.py:932`.

### `lightbulb.CommunicationTraceResult`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommunicationTraceResult
~~~


Binding: `lightbulb.communication_runtime.CommunicationTraceResult` → `lightbulb.communication_runtime.CommunicationTraceResult`.

Source: `lightbulb/communication_runtime.py:418`.

### `lightbulb.CommunicationReplyInterpretation`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommunicationReplyInterpretation
~~~


Binding: `lightbulb.communication_contracts.CommunicationReplyInterpretation` → `lightbulb.communication_contracts.CommunicationReplyInterpretation`.

Source: `lightbulb/communication_contracts.py:1115`.

### `lightbulb.CommunicationScopeKeyRing`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommunicationScopeKeyRing
~~~


Binding: `lightbulb.communication_contracts.CommunicationScopeKeyRing` → `lightbulb.communication_contracts.CommunicationScopeKeyRing`.

Source: `lightbulb/communication_contracts.py:324`.

### `lightbulb.CommunicationSuppressionStatus`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommunicationSuppressionStatus
~~~


Binding: `lightbulb.communication_contracts.CommunicationSuppressionStatus` → `lightbulb.communication_contracts.CommunicationSuppressionStatus`.

Source: `lightbulb/communication_contracts.py:182`.

### `lightbulb.CommunicationThreadBinding`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommunicationThreadBinding
~~~


Binding: `lightbulb.communication_contracts.CommunicationThreadBinding` → `lightbulb.communication_contracts.CommunicationThreadBinding`.

Source: `lightbulb/communication_contracts.py:466`.

### `lightbulb.CommunicationThreadState`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommunicationThreadState
~~~


Binding: `lightbulb.communication_contracts.CommunicationThreadState` → `lightbulb.communication_contracts.CommunicationThreadState`.

Source: `lightbulb/communication_contracts.py:155`.

### `lightbulb.CommunicationTouchpointType`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommunicationTouchpointType
~~~


Binding: `lightbulb.communication_contracts.CommunicationTouchpointType` → `lightbulb.communication_contracts.CommunicationTouchpointType`.

Source: `lightbulb/communication_contracts.py:232`.

### `lightbulb.CommunicationTrustGrade`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommunicationTrustGrade
~~~


Binding: `lightbulb.communication_contracts.CommunicationTrustGrade` → `lightbulb.communication_contracts.CommunicationTrustGrade`.

Source: `lightbulb/communication_contracts.py:140`.

### `lightbulb.CommunicationTurnKind`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommunicationTurnKind
~~~


Binding: `lightbulb.communication_primitives.CommunicationTurnKind` → `lightbulb.communication_primitives.CommunicationTurnKind`.

Source: `lightbulb/communication_primitives.py:32`.

### `lightbulb.CommunicationTurnPhase`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommunicationTurnPhase
~~~


Binding: `lightbulb.communication_primitives.CommunicationTurnPhase` → `lightbulb.communication_primitives.CommunicationTurnPhase`.

Source: `lightbulb/communication_primitives.py:37`.

### `lightbulb.CommunicationTurnPlan`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommunicationTurnPlan
~~~


Binding: `lightbulb.communication_primitives.CommunicationTurnPlan` → `lightbulb.communication_primitives.CommunicationTurnPlan`.

Source: `lightbulb/communication_primitives.py:132`.

### `lightbulb.CommunicationTwilioSmsPrivateResultCommitments`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommunicationTwilioSmsPrivateResultCommitments
~~~


Binding: `lightbulb.communication_twilio_sms.CommunicationTwilioSmsPrivateResultCommitments` → `lightbulb.communication_twilio_sms.CommunicationTwilioSmsPrivateResultCommitments`.

Source: `lightbulb/communication_twilio_sms.py:312`.

### `lightbulb.CommunicationTwilioSmsStatusRoute`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommunicationTwilioSmsStatusRoute
~~~


Binding: `lightbulb.communication_twilio_sms.CommunicationTwilioSmsStatusRoute` → `lightbulb.communication_twilio_sms.CommunicationTwilioSmsStatusRoute`.

Source: `lightbulb/communication_twilio_sms.py:199`.

### `lightbulb.CommunicationTwilioSmsWriteRoute`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommunicationTwilioSmsWriteRoute
~~~


Binding: `lightbulb.communication_twilio_sms.CommunicationTwilioSmsWriteRoute` → `lightbulb.communication_twilio_sms.CommunicationTwilioSmsWriteRoute`.

Source: `lightbulb/communication_twilio_sms.py:192`.

### `lightbulb.CrmTouchpointReceipt`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CrmTouchpointReceipt
~~~


Binding: `lightbulb.communication_contracts.CrmTouchpointReceipt` → `lightbulb.communication_contracts.CrmTouchpointReceipt`.

Source: `lightbulb/communication_contracts.py:1169`.

### `lightbulb.CrmTouchpointSink`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CrmTouchpointSink
~~~


Binding: `lightbulb.communication_runtime.CrmTouchpointSink` → `lightbulb.communication_runtime.CrmTouchpointSink`.

Source: `lightbulb/communication_runtime.py:721`.

### `lightbulb.GmailCommunicationRuntime`

class alias. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GmailCommunicationRuntime
~~~


Binding: `lightbulb.communication_runtime.GmailCommunicationRuntime` → `lightbulb.communication_runtime.CommunicationRuntime`.

Source: `lightbulb/communication_runtime.py:932`.

### `lightbulb.GmailCommunicationObserver`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GmailCommunicationObserver
~~~


Binding: `lightbulb.communication_observation.GmailCommunicationObserver` → `lightbulb.communication_observation.GmailCommunicationObserver`.

Source: `lightbulb/communication_observation.py:1435`.

### `lightbulb.GmailThreadHeaders`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GmailThreadHeaders
~~~


Binding: `lightbulb.communication_observation.GmailThreadHeaders` → `lightbulb.communication_observation.GmailThreadHeaders`.

Source: `lightbulb/communication_observation.py:181`.

### `lightbulb.GmailThreadMessage`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GmailThreadMessage
~~~


Binding: `lightbulb.communication_observation.GmailThreadMessage` → `lightbulb.communication_observation.GmailThreadMessage`.

Source: `lightbulb/communication_observation.py:206`.

### `lightbulb.GmailThreadOutput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GmailThreadOutput
~~~


Binding: `lightbulb.communication_observation.GmailThreadOutput` → `lightbulb.communication_observation.GmailThreadOutput`.

Source: `lightbulb/communication_observation.py:226`.

### `lightbulb.GrowthSourceBinding`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GrowthSourceBinding
~~~


Binding: `lightbulb.communication_contracts.GrowthSourceBinding` → `lightbulb.communication_contracts.GrowthSourceBinding`.

Source: `lightbulb/communication_contracts.py:375`.

### `lightbulb.InMemoryCommunicationContactReservationAuthority`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import InMemoryCommunicationContactReservationAuthority
~~~


Binding: `lightbulb.communication_governance.InMemoryCommunicationContactReservationAuthority` → `lightbulb.communication_governance.InMemoryCommunicationContactReservationAuthority`.

Source: `lightbulb/communication_governance.py:427`.

### `lightbulb.InMemoryCommunicationObservedEventRepository`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import InMemoryCommunicationObservedEventRepository
~~~


Binding: `lightbulb.communication_observation.InMemoryCommunicationObservedEventRepository` → `lightbulb.communication_observation.InMemoryCommunicationObservedEventRepository`.

Source: `lightbulb/communication_observation.py:328`.

### `lightbulb.InMemoryCommunicationReplayRepository`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import InMemoryCommunicationReplayRepository
~~~


Binding: `lightbulb.communication_runtime.InMemoryCommunicationReplayRepository` → `lightbulb.communication_runtime.InMemoryCommunicationReplayRepository`.

Source: `lightbulb/communication_runtime.py:579`.

### `lightbulb.InMemoryCrmTouchpointSink`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import InMemoryCrmTouchpointSink
~~~


Binding: `lightbulb.communication_runtime.InMemoryCrmTouchpointSink` → `lightbulb.communication_runtime.InMemoryCrmTouchpointSink`.

Source: `lightbulb/communication_runtime.py:733`.

### `lightbulb.OutlookCommunicationObserver`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import OutlookCommunicationObserver
~~~


Binding: `lightbulb.communication_outlook_observation.OutlookCommunicationObserver` → `lightbulb.communication_outlook_observation.OutlookCommunicationObserver`.

Source: `lightbulb/communication_outlook_observation.py:659`.

### `lightbulb.OutlookCommunicationRuntime`

class alias. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import OutlookCommunicationRuntime
~~~


Binding: `lightbulb.communication_outlook_runtime.OutlookCommunicationRuntime` → `lightbulb.communication_runtime.CommunicationRuntime`.

Source: `lightbulb/communication_runtime.py:932`.

### `lightbulb.OutlookConversationMessage`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import OutlookConversationMessage
~~~


Binding: `lightbulb.communication_outlook_observation.OutlookConversationMessage` → `lightbulb.communication_outlook_observation.OutlookConversationMessage`.

Source: `lightbulb/communication_outlook_observation.py:126`.

### `lightbulb.OutlookConversationOutput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import OutlookConversationOutput
~~~


Binding: `lightbulb.communication_outlook_observation.OutlookConversationOutput` → `lightbulb.communication_outlook_observation.OutlookConversationOutput`.

Source: `lightbulb/communication_outlook_observation.py:218`.

### `lightbulb.OutlookMessageHeaders`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import OutlookMessageHeaders
~~~


Binding: `lightbulb.communication_outlook_observation.OutlookMessageHeaders` → `lightbulb.communication_outlook_observation.OutlookMessageHeaders`.

Source: `lightbulb/communication_outlook_observation.py:113`.

### `lightbulb.PlanCrmConversationTurnInput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PlanCrmConversationTurnInput
~~~


Binding: `lightbulb.communication_primitives.PlanCrmConversationTurnInput` → `lightbulb.communication_primitives.PlanCrmConversationTurnInput`.

Source: `lightbulb/communication_primitives.py:49`.

### `lightbulb.PlanCrmConversationTurnPrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PlanCrmConversationTurnPrimitive
~~~


Binding: `lightbulb.communication_primitives.PlanCrmConversationTurnPrimitive` → `lightbulb.communication_primitives.PlanCrmConversationTurnPrimitive`.

Source: `lightbulb/communication_primitives.py:234`.

### `lightbulb.SLACK_POST_TURN_TOOL`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SLACK_POST_TURN_TOOL
~~~


Binding: `lightbulb.communication_channels.SLACK_POST_TURN_TOOL` → `lightbulb.communication_channels.SLACK_POST_TURN_TOOL`.

Source: `lightbulb/communication_channels.py:60`.

### `lightbulb.SLACK_READ_THREAD_TOOL`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SLACK_READ_THREAD_TOOL
~~~


Binding: `lightbulb.communication_channels.SLACK_READ_THREAD_TOOL` → `lightbulb.communication_channels.SLACK_READ_THREAD_TOOL`.

Source: `lightbulb/communication_channels.py:61`.

### `lightbulb.SlackCommunicationObserver`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SlackCommunicationObserver
~~~


Binding: `lightbulb.communication_channel_observation.SlackCommunicationObserver` → `lightbulb.communication_channel_observation.SlackCommunicationObserver`.

Source: `lightbulb/communication_channel_observation.py:812`.

### `lightbulb.SlackConversationMessage`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SlackConversationMessage
~~~


Binding: `lightbulb.communication_channel_observation.SlackConversationMessage` → `lightbulb.communication_channel_observation.SlackConversationMessage`.

Source: `lightbulb/communication_channel_observation.py:93`.

### `lightbulb.SlackConversationThreadOutput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SlackConversationThreadOutput
~~~


Binding: `lightbulb.communication_channel_observation.SlackConversationThreadOutput` → `lightbulb.communication_channel_observation.SlackConversationThreadOutput`.

Source: `lightbulb/communication_channel_observation.py:103`.

### `lightbulb.TEAMS_POST_TURN_TOOL`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import TEAMS_POST_TURN_TOOL
~~~


Binding: `lightbulb.communication_channels.TEAMS_POST_TURN_TOOL` → `lightbulb.communication_channels.TEAMS_POST_TURN_TOOL`.

Source: `lightbulb/communication_channels.py:62`.

### `lightbulb.TEAMS_READ_THREAD_TOOL`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import TEAMS_READ_THREAD_TOOL
~~~


Binding: `lightbulb.communication_channels.TEAMS_READ_THREAD_TOOL` → `lightbulb.communication_channels.TEAMS_READ_THREAD_TOOL`.

Source: `lightbulb/communication_channels.py:63`.

### `lightbulb.TWILIO_LOOKUP_MESSAGE_STATUS_TOOL`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import TWILIO_LOOKUP_MESSAGE_STATUS_TOOL
~~~


Binding: `lightbulb.communication_twilio_sms.TWILIO_LOOKUP_MESSAGE_STATUS_TOOL` → `lightbulb.communication_twilio_sms.TWILIO_LOOKUP_MESSAGE_STATUS_TOOL`.

Source: `lightbulb/communication_twilio_sms.py:28`.

### `lightbulb.TWILIO_SEND_SMS_TOOL`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import TWILIO_SEND_SMS_TOOL
~~~


Binding: `lightbulb.communication_twilio_sms.TWILIO_SEND_SMS_TOOL` → `lightbulb.communication_twilio_sms.TWILIO_SEND_SMS_TOOL`.

Source: `lightbulb/communication_twilio_sms.py:27`.

### `lightbulb.TWILIO_SMS_ACCEPTANCE_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import TWILIO_SMS_ACCEPTANCE_SCHEMA
~~~


Binding: `lightbulb.communication_twilio_sms.TWILIO_SMS_ACCEPTANCE_SCHEMA` → `lightbulb.communication_twilio_sms.TWILIO_SMS_ACCEPTANCE_SCHEMA`.

Source: `lightbulb/communication_twilio_sms.py:45`.

### `lightbulb.TWILIO_SMS_PRIVATE_IDENTIFIER_DOMAIN`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import TWILIO_SMS_PRIVATE_IDENTIFIER_DOMAIN
~~~


Binding: `lightbulb.communication_twilio_sms.TWILIO_SMS_PRIVATE_IDENTIFIER_DOMAIN` → `lightbulb.communication_twilio_sms.TWILIO_SMS_PRIVATE_IDENTIFIER_DOMAIN`.

Source: `lightbulb/communication_twilio_sms.py:48`.

### `lightbulb.TWILIO_SMS_STATUS_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import TWILIO_SMS_STATUS_SCHEMA
~~~


Binding: `lightbulb.communication_twilio_sms.TWILIO_SMS_STATUS_SCHEMA` → `lightbulb.communication_twilio_sms.TWILIO_SMS_STATUS_SCHEMA`.

Source: `lightbulb/communication_twilio_sms.py:46`.

### `lightbulb.TeamsChannelMessage`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import TeamsChannelMessage
~~~


Binding: `lightbulb.communication_channel_observation.TeamsChannelMessage` → `lightbulb.communication_channel_observation.TeamsChannelMessage`.

Source: `lightbulb/communication_channel_observation.py:132`.

### `lightbulb.TeamsChannelThreadOutput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import TeamsChannelThreadOutput
~~~


Binding: `lightbulb.communication_channel_observation.TeamsChannelThreadOutput` → `lightbulb.communication_channel_observation.TeamsChannelThreadOutput`.

Source: `lightbulb/communication_channel_observation.py:167`.

### `lightbulb.TeamsCommunicationObserver`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import TeamsCommunicationObserver
~~~


Binding: `lightbulb.communication_channel_observation.TeamsCommunicationObserver` → `lightbulb.communication_channel_observation.TeamsCommunicationObserver`.

Source: `lightbulb/communication_channel_observation.py:817`.

### `lightbulb.TwilioSmsAcceptance`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import TwilioSmsAcceptance
~~~


Binding: `lightbulb.communication_twilio_sms.TwilioSmsAcceptance` → `lightbulb.communication_twilio_sms.TwilioSmsAcceptance`.

Source: `lightbulb/communication_twilio_sms.py:243`.

### `lightbulb.TwilioSmsProviderStatus`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import TwilioSmsProviderStatus
~~~


Binding: `lightbulb.communication_twilio_sms.TwilioSmsProviderStatus` → `lightbulb.communication_twilio_sms.TwilioSmsProviderStatus`.

Source: `lightbulb/communication_twilio_sms.py:144`.

### `lightbulb.TwilioSmsStatus`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import TwilioSmsStatus
~~~


Binding: `lightbulb.communication_twilio_sms.TwilioSmsStatus` → `lightbulb.communication_twilio_sms.TwilioSmsStatus`.

Source: `lightbulb/communication_twilio_sms.py:262`.

### `lightbulb.COMMUNICATION_PRIVATE_TWILIO_SMS_DISPATCH_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import COMMUNICATION_PRIVATE_TWILIO_SMS_DISPATCH_SCHEMA
~~~


Binding: `lightbulb.communication_twilio_sms.COMMUNICATION_PRIVATE_TWILIO_SMS_DISPATCH_SCHEMA` → `lightbulb.communication_twilio_sms.COMMUNICATION_PRIVATE_TWILIO_SMS_DISPATCH_SCHEMA`.

Source: `lightbulb/communication_twilio_sms.py:39`.

### `lightbulb.COMMUNICATION_PRIVATE_TWILIO_SMS_TURN_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import COMMUNICATION_PRIVATE_TWILIO_SMS_TURN_SCHEMA
~~~


Binding: `lightbulb.communication_twilio_sms.COMMUNICATION_PRIVATE_TWILIO_SMS_TURN_SCHEMA` → `lightbulb.communication_twilio_sms.COMMUNICATION_PRIVATE_TWILIO_SMS_TURN_SCHEMA`.

Source: `lightbulb/communication_twilio_sms.py:36`.

### `lightbulb.COMMUNICATION_TWILIO_SMS_PRIVATE_RESULT_COMMITMENTS_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import COMMUNICATION_TWILIO_SMS_PRIVATE_RESULT_COMMITMENTS_SCHEMA
~~~


Binding: `lightbulb.communication_twilio_sms.COMMUNICATION_TWILIO_SMS_PRIVATE_RESULT_COMMITMENTS_SCHEMA` → `lightbulb.communication_twilio_sms.COMMUNICATION_TWILIO_SMS_PRIVATE_RESULT_COMMITMENTS_SCHEMA`.

Source: `lightbulb/communication_twilio_sms.py:42`.

### `lightbulb.COMMUNICATION_TWILIO_SMS_STATUS_ROUTE_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import COMMUNICATION_TWILIO_SMS_STATUS_ROUTE_SCHEMA
~~~


Binding: `lightbulb.communication_twilio_sms.COMMUNICATION_TWILIO_SMS_STATUS_ROUTE_SCHEMA` → `lightbulb.communication_twilio_sms.COMMUNICATION_TWILIO_SMS_STATUS_ROUTE_SCHEMA`.

Source: `lightbulb/communication_twilio_sms.py:33`.

### `lightbulb.COMMUNICATION_TWILIO_SMS_WRITE_ROUTE_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import COMMUNICATION_TWILIO_SMS_WRITE_ROUTE_SCHEMA
~~~


Binding: `lightbulb.communication_twilio_sms.COMMUNICATION_TWILIO_SMS_WRITE_ROUTE_SCHEMA` → `lightbulb.communication_twilio_sms.COMMUNICATION_TWILIO_SMS_WRITE_ROUTE_SCHEMA`.

Source: `lightbulb/communication_twilio_sms.py:30`.

### `lightbulb.communication_channel_endpoint_address_commitment`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import communication_channel_endpoint_address_commitment
~~~


Binding: `lightbulb.communication_channels.communication_channel_endpoint_address_commitment` → `lightbulb.communication_channels.communication_channel_endpoint_address_commitment`.

Source: `lightbulb/communication_channels.py:148`.

### `lightbulb.communication_channel_message_digest`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import communication_channel_message_digest
~~~


Binding: `lightbulb.communication_channels.communication_channel_message_digest` → `lightbulb.communication_channels.communication_channel_message_digest`.

Source: `lightbulb/communication_channels.py:263`.

### `lightbulb.communication_channel_private_dispatch_from_effect_output`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import communication_channel_private_dispatch_from_effect_output
~~~


Binding: `lightbulb.communication_channels.communication_channel_private_dispatch_from_effect_output` → `lightbulb.communication_channels.communication_channel_private_dispatch_from_effect_output`.

Source: `lightbulb/communication_channels.py:634`.

### `lightbulb.communication_channel_private_identifier_commitment`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import communication_channel_private_identifier_commitment
~~~


Binding: `lightbulb.communication_channels.communication_channel_private_identifier_commitment` → `lightbulb.communication_channels.communication_channel_private_identifier_commitment`.

Source: `lightbulb/communication_channels.py:118`.

### `lightbulb.communication_channel_private_result_commitments`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import communication_channel_private_result_commitments
~~~


Binding: `lightbulb.communication_channels.communication_channel_private_result_commitments` → `lightbulb.communication_channels.communication_channel_private_result_commitments`.

Source: `lightbulb/communication_channels.py:559`.

### `lightbulb.communication_channel_private_value_commitment`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import communication_channel_private_value_commitment
~~~


Binding: `lightbulb.communication_channels.communication_channel_private_value_commitment` → `lightbulb.communication_channels.communication_channel_private_value_commitment`.

Source: `lightbulb/communication_channels.py:176`.

### `lightbulb.communication_channel_target_digest`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import communication_channel_target_digest
~~~


Binding: `lightbulb.communication_channels.communication_channel_target_digest` → `lightbulb.communication_channels.communication_channel_target_digest`.

Source: `lightbulb/communication_channels.py:245`.

### `lightbulb.build_communication_dispatch_recovery_stage_request`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import build_communication_dispatch_recovery_stage_request
~~~


Binding: `lightbulb.communication_dispatch_recovery.build_communication_dispatch_recovery_stage_request` → `lightbulb.communication_dispatch_recovery.build_communication_dispatch_recovery_stage_request`.

Source: `lightbulb/communication_dispatch_recovery.py:916`.

### `lightbulb.communication_canonical_digest`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import communication_canonical_digest
~~~


Binding: `lightbulb.communication_contracts.communication_canonical_digest` → `lightbulb.communication_contracts.communication_canonical_digest`.

Source: `lightbulb/communication_contracts.py:286`.

### `lightbulb.communication_canonical_json`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import communication_canonical_json
~~~


Binding: `lightbulb.communication_contracts.communication_canonical_json` → `lightbulb.communication_contracts.communication_canonical_json`.

Source: `lightbulb/communication_contracts.py:274`.

### `lightbulb.communication_company_contact_scope_digest`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import communication_company_contact_scope_digest
~~~


Binding: `lightbulb.communication_contracts.communication_company_contact_scope_digest` → `lightbulb.communication_contracts.communication_company_contact_scope_digest`.

Source: `lightbulb/communication_contracts.py:1375`.

### `lightbulb.communication_contact_slot_digest`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import communication_contact_slot_digest
~~~


Binding: `lightbulb.communication_contracts.communication_contact_slot_digest` → `lightbulb.communication_contracts.communication_contact_slot_digest`.

Source: `lightbulb/communication_contracts.py:1445`.

### `lightbulb.communication_endpoint_address_commitment`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import communication_endpoint_address_commitment
~~~


Binding: `lightbulb.communication_materializer.communication_endpoint_address_commitment` → `lightbulb.communication_materializer.communication_endpoint_address_commitment`.

Source: `lightbulb/communication_materializer.py:531`.

### `lightbulb.communication_private_value_digest`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import communication_private_value_digest
~~~


Binding: `lightbulb.communication_contracts.communication_private_value_digest` → `lightbulb.communication_contracts.communication_private_value_digest`.

Source: `lightbulb/communication_contracts.py:292`.

### `lightbulb.communication_recipient_address_commitment`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import communication_recipient_address_commitment
~~~


Binding: `lightbulb.communication_contracts.communication_recipient_address_commitment` → `lightbulb.communication_contracts.communication_recipient_address_commitment`.

Source: `lightbulb/communication_contracts.py:1415`.

### `lightbulb.communication_recipient_contact_commitment`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import communication_recipient_contact_commitment
~~~


Binding: `lightbulb.communication_contracts.communication_recipient_contact_commitment` → `lightbulb.communication_contracts.communication_recipient_contact_commitment`.

Source: `lightbulb/communication_contracts.py:1395`.

### `lightbulb.communication_twilio_sms_private_identifier_commitment`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import communication_twilio_sms_private_identifier_commitment
~~~


Binding: `lightbulb.communication_twilio_sms.communication_twilio_sms_private_identifier_commitment` → `lightbulb.communication_twilio_sms.communication_twilio_sms_private_identifier_commitment`.

Source: `lightbulb/communication_twilio_sms.py:110`.

### `lightbulb.canonical_twilio_e164`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import canonical_twilio_e164
~~~


Binding: `lightbulb.communication_twilio_sms.canonical_twilio_e164` → `lightbulb.communication_twilio_sms.canonical_twilio_e164`.

Source: `lightbulb/communication_twilio_sms.py:70`.

### `lightbulb.canonical_twilio_message_sid`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import canonical_twilio_message_sid
~~~


Binding: `lightbulb.communication_twilio_sms.canonical_twilio_message_sid` → `lightbulb.communication_twilio_sms.canonical_twilio_message_sid`.

Source: `lightbulb/communication_twilio_sms.py:82`.

### `lightbulb.materialize_gmail_communication_turn`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import materialize_gmail_communication_turn
~~~


Binding: `lightbulb.communication_materializer.materialize_gmail_communication_turn` → `lightbulb.communication_materializer.materialize_gmail_communication_turn`.

Source: `lightbulb/communication_materializer.py:666`.

### `lightbulb.materialize_outlook_communication_turn`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import materialize_outlook_communication_turn
~~~


Binding: `lightbulb.communication_outlook.materialize_outlook_communication_turn` → `lightbulb.communication_outlook.materialize_outlook_communication_turn`.

Source: `lightbulb/communication_outlook.py:300`.

### `lightbulb.materialize_slack_communication_turn`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import materialize_slack_communication_turn
~~~


Binding: `lightbulb.communication_channels.materialize_slack_communication_turn` → `lightbulb.communication_channels.materialize_slack_communication_turn`.

Source: `lightbulb/communication_channels.py:1121`.

### `lightbulb.materialize_teams_communication_turn`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import materialize_teams_communication_turn
~~~


Binding: `lightbulb.communication_channels.materialize_teams_communication_turn` → `lightbulb.communication_channels.materialize_teams_communication_turn`.

Source: `lightbulb/communication_channels.py:1128`.

### `lightbulb.finalize_recovered_communication_dispatch`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import finalize_recovered_communication_dispatch
~~~


Binding: `lightbulb.communication_dispatch_recovery.finalize_recovered_communication_dispatch` → `lightbulb.communication_dispatch_recovery.finalize_recovered_communication_dispatch`.

Source: `lightbulb/communication_dispatch_recovery.py:967`.

### `lightbulb.mint_communication_artifact`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import mint_communication_artifact
~~~


Binding: `lightbulb.communication_contracts.mint_communication_artifact` → `lightbulb.communication_contracts.mint_communication_artifact`.

Source: `lightbulb/communication_contracts.py:1482`.

### `lightbulb.mint_communication_contact_reservation_request`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import mint_communication_contact_reservation_request
~~~


Binding: `lightbulb.communication_governance.mint_communication_contact_reservation_request` → `lightbulb.communication_governance.mint_communication_contact_reservation_request`.

Source: `lightbulb/communication_governance.py:77`.

### `lightbulb.mint_communication_dispatch_recovery_stage`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import mint_communication_dispatch_recovery_stage
~~~


Binding: `lightbulb.communication_dispatch_recovery.mint_communication_dispatch_recovery_stage` → `lightbulb.communication_dispatch_recovery.mint_communication_dispatch_recovery_stage`.

Source: `lightbulb/communication_dispatch_recovery.py:755`.

### `lightbulb.mint_communication_poll_plan`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import mint_communication_poll_plan
~~~


Binding: `lightbulb.communication_dispatch_recovery.mint_communication_poll_plan` → `lightbulb.communication_dispatch_recovery.mint_communication_poll_plan`.

Source: `lightbulb/communication_dispatch_recovery.py:209`.

### `lightbulb.plan_crm_conversation_turn`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import plan_crm_conversation_turn
~~~


Binding: `lightbulb.communication_primitives.plan_crm_conversation_turn` → `lightbulb.communication_primitives.plan_crm_conversation_turn`.

Source: `lightbulb/communication_primitives.py:202`.

### `lightbulb.parse_outlook_poll_artifacts`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import parse_outlook_poll_artifacts
~~~


Binding: `lightbulb.communication_outlook_host.parse_outlook_poll_artifacts` → `lightbulb.communication_outlook_host.parse_outlook_poll_artifacts`.

Source: `lightbulb/communication_outlook_host.py:187`.

### `lightbulb.verify_communication_approval_grant`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import verify_communication_approval_grant
~~~


Binding: `lightbulb.communication_governance.verify_communication_approval_grant` → `lightbulb.communication_governance.verify_communication_approval_grant`.

Source: `lightbulb/communication_governance.py:172`.

### `lightbulb.verify_communication_artifact`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import verify_communication_artifact
~~~


Binding: `lightbulb.communication_contracts.verify_communication_artifact` → `lightbulb.communication_contracts.verify_communication_artifact`.

Source: `lightbulb/communication_contracts.py:1539`.

### `lightbulb.verify_communication_contact_policy_decision`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import verify_communication_contact_policy_decision
~~~


Binding: `lightbulb.communication_governance.verify_communication_contact_policy_decision` → `lightbulb.communication_governance.verify_communication_contact_policy_decision`.

Source: `lightbulb/communication_governance.py:130`.

### `lightbulb.verify_communication_contact_reservation`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import verify_communication_contact_reservation
~~~


Binding: `lightbulb.communication_governance.verify_communication_contact_reservation` → `lightbulb.communication_governance.verify_communication_contact_reservation`.

Source: `lightbulb/communication_governance.py:235`.

### `lightbulb.verify_communication_contact_reservation_consumption`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import verify_communication_contact_reservation_consumption
~~~


Binding: `lightbulb.communication_governance.verify_communication_contact_reservation_consumption` → `lightbulb.communication_governance.verify_communication_contact_reservation_consumption`.

Source: `lightbulb/communication_governance.py:271`.

### `lightbulb.verify_communication_dispatch_authority`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import verify_communication_dispatch_authority
~~~


Binding: `lightbulb.communication_governance.verify_communication_dispatch_authority` → `lightbulb.communication_governance.verify_communication_dispatch_authority`.

Source: `lightbulb/communication_governance.py:330`.

### `lightbulb.DEFAULT_FUNNEL_REFERENCE_RATES`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import DEFAULT_FUNNEL_REFERENCE_RATES
~~~


Binding: `lightbulb.growth_funnel.DEFAULT_FUNNEL_REFERENCE_RATES` → `lightbulb.growth_funnel.DEFAULT_FUNNEL_REFERENCE_RATES`.

Source: `lightbulb/growth_funnel.py:741`.

### `lightbulb.GROWTH_FUNNEL_EVIDENCE_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GROWTH_FUNNEL_EVIDENCE_SCHEMA
~~~


Binding: `lightbulb.growth_funnel.GROWTH_FUNNEL_EVIDENCE_SCHEMA` → `lightbulb.growth_funnel.GROWTH_FUNNEL_EVIDENCE_SCHEMA`.

Source: `lightbulb/growth_funnel.py:61`.

### `lightbulb.GROWTH_FUNNEL_SNAPSHOT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GROWTH_FUNNEL_SNAPSHOT_SCHEMA
~~~


Binding: `lightbulb.growth_funnel.GROWTH_FUNNEL_SNAPSHOT_SCHEMA` → `lightbulb.growth_funnel.GROWTH_FUNNEL_SNAPSHOT_SCHEMA`.

Source: `lightbulb/growth_funnel.py:62`.

### `lightbulb.AdmittedFunnelEvidence`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import AdmittedFunnelEvidence
~~~


Binding: `lightbulb.growth_funnel.AdmittedFunnelEvidence` → `lightbulb.growth_funnel.AdmittedFunnelEvidence`.

Source: `lightbulb/growth_funnel.py:950`.

### `lightbulb.BuildGrowthFunnelSnapshotInput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import BuildGrowthFunnelSnapshotInput
~~~


Binding: `lightbulb.growth_funnel.BuildGrowthFunnelSnapshotInput` → `lightbulb.growth_funnel.BuildGrowthFunnelSnapshotInput`.

Source: `lightbulb/growth_funnel.py:784`.

### `lightbulb.DerivedFunnelValue`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import DerivedFunnelValue
~~~


Binding: `lightbulb.growth_funnel.DerivedFunnelValue` → `lightbulb.growth_funnel.DerivedFunnelValue`.

Source: `lightbulb/growth_funnel.py:926`.

### `lightbulb.ExcludedFunnelEvidence`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ExcludedFunnelEvidence
~~~


Binding: `lightbulb.growth_funnel.ExcludedFunnelEvidence` → `lightbulb.growth_funnel.ExcludedFunnelEvidence`.

Source: `lightbulb/growth_funnel.py:966`.

### `lightbulb.ExpectedFunnelContribution`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ExpectedFunnelContribution
~~~


Binding: `lightbulb.growth_funnel.ExpectedFunnelContribution` → `lightbulb.growth_funnel.ExpectedFunnelContribution`.

Source: `lightbulb/growth_funnel.py:777`.

### `lightbulb.FunnelBottleneck`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import FunnelBottleneck
~~~


Binding: `lightbulb.growth_funnel.FunnelBottleneck` → `lightbulb.growth_funnel.FunnelBottleneck`.

Source: `lightbulb/growth_funnel.py:938`.

### `lightbulb.FunnelRate`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import FunnelRate
~~~


Binding: `lightbulb.growth_funnel.FunnelRate` → `lightbulb.growth_funnel.FunnelRate`.

Source: `lightbulb/growth_funnel.py:902`.

### `lightbulb.FunnelRateSide`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import FunnelRateSide
~~~


Binding: `lightbulb.growth_funnel.FunnelRateSide` → `lightbulb.growth_funnel.FunnelRateSide`.

Source: `lightbulb/growth_funnel.py:890`.

### `lightbulb.FunnelReferenceRate`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import FunnelReferenceRate
~~~


Binding: `lightbulb.growth_funnel.FunnelReferenceRate` → `lightbulb.growth_funnel.FunnelReferenceRate`.

Source: `lightbulb/growth_funnel.py:719`.

### `lightbulb.FunnelStalenessPolicy`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import FunnelStalenessPolicy
~~~


Binding: `lightbulb.growth_funnel.FunnelStalenessPolicy` → `lightbulb.growth_funnel.FunnelStalenessPolicy`.

Source: `lightbulb/growth_funnel.py:770`.

### `lightbulb.GrowthFunnelEvidence`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GrowthFunnelEvidence
~~~


Binding: `lightbulb.growth_funnel.GrowthFunnelEvidence` → `lightbulb.growth_funnel.GrowthFunnelEvidence`.

Source: `lightbulb/growth_funnel.py:446`.

### `lightbulb.GrowthFunnelSnapshot`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GrowthFunnelSnapshot
~~~


Binding: `lightbulb.growth_funnel.GrowthFunnelSnapshot` → `lightbulb.growth_funnel.GrowthFunnelSnapshot`.

Source: `lightbulb/growth_funnel.py:972`.

### `lightbulb.GrowthFunnelValidationError`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GrowthFunnelValidationError
~~~


Binding: `lightbulb.growth_funnel.GrowthFunnelValidationError` → `lightbulb.growth_funnel.GrowthFunnelValidationError`.

Source: `lightbulb/growth_funnel.py:263`.

### `lightbulb.GrowthMetrics`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GrowthMetrics
~~~


Binding: `lightbulb.growth_funnel.GrowthMetrics` → `lightbulb.growth_funnel.GrowthMetrics`.

Source: `lightbulb/growth_funnel.py:380`.

### `lightbulb.StageAggregate`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import StageAggregate
~~~


Binding: `lightbulb.growth_funnel.StageAggregate` → `lightbulb.growth_funnel.StageAggregate`.

Source: `lightbulb/growth_funnel.py:862`.

### `lightbulb.StageMetricTotal`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import StageMetricTotal
~~~


Binding: `lightbulb.growth_funnel.StageMetricTotal` → `lightbulb.growth_funnel.StageMetricTotal`.

Source: `lightbulb/growth_funnel.py:838`.

### `lightbulb.build_growth_funnel_snapshot`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import build_growth_funnel_snapshot
~~~


Binding: `lightbulb.growth_funnel.build_growth_funnel_snapshot` → `lightbulb.growth_funnel.build_growth_funnel_snapshot`.

Source: `lightbulb/growth_funnel.py:1206`.

### `lightbulb.mint_growth_funnel_evidence`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import mint_growth_funnel_evidence
~~~


Binding: `lightbulb.growth_funnel.mint_growth_funnel_evidence` → `lightbulb.growth_funnel.mint_growth_funnel_evidence`.

Source: `lightbulb/growth_funnel.py:561`.

### `lightbulb.verify_growth_funnel_evidence`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import verify_growth_funnel_evidence
~~~


Binding: `lightbulb.growth_funnel.verify_growth_funnel_evidence` → `lightbulb.growth_funnel.verify_growth_funnel_evidence`.

Source: `lightbulb/growth_funnel.py:688`.

### `lightbulb.verify_growth_funnel_snapshot`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import verify_growth_funnel_snapshot
~~~


Binding: `lightbulb.growth_funnel.verify_growth_funnel_snapshot` → `lightbulb.growth_funnel.verify_growth_funnel_snapshot`.

Source: `lightbulb/growth_funnel.py:1521`.

### `lightbulb.GROWTH_EXPERIMENT_ARM_EVIDENCE_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GROWTH_EXPERIMENT_ARM_EVIDENCE_SCHEMA
~~~


Binding: `lightbulb.growth_experiments.GROWTH_EXPERIMENT_ARM_EVIDENCE_SCHEMA` → `lightbulb.growth_experiments.GROWTH_EXPERIMENT_ARM_EVIDENCE_SCHEMA`.

Source: `lightbulb/growth_experiments.py:55`.

### `lightbulb.GROWTH_EXPERIMENT_ASSIGNMENT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GROWTH_EXPERIMENT_ASSIGNMENT_SCHEMA
~~~


Binding: `lightbulb.growth_experiments.GROWTH_EXPERIMENT_ASSIGNMENT_SCHEMA` → `lightbulb.growth_experiments.GROWTH_EXPERIMENT_ASSIGNMENT_SCHEMA`.

Source: `lightbulb/growth_experiments.py:57`.

### `lightbulb.GROWTH_EXPERIMENT_DESIGN_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GROWTH_EXPERIMENT_DESIGN_SCHEMA
~~~


Binding: `lightbulb.growth_experiments.GROWTH_EXPERIMENT_DESIGN_SCHEMA` → `lightbulb.growth_experiments.GROWTH_EXPERIMENT_DESIGN_SCHEMA`.

Source: `lightbulb/growth_experiments.py:54`.

### `lightbulb.GROWTH_EXPERIMENT_READOUT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GROWTH_EXPERIMENT_READOUT_SCHEMA
~~~


Binding: `lightbulb.growth_experiments.GROWTH_EXPERIMENT_READOUT_SCHEMA` → `lightbulb.growth_experiments.GROWTH_EXPERIMENT_READOUT_SCHEMA`.

Source: `lightbulb/growth_experiments.py:56`.

### `lightbulb.DesignGrowthExperimentInput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import DesignGrowthExperimentInput
~~~


Binding: `lightbulb.growth_experiments.DesignGrowthExperimentInput` → `lightbulb.growth_experiments.DesignGrowthExperimentInput`.

Source: `lightbulb/growth_experiments.py:859`.

### `lightbulb.ExperimentArmEvidence`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ExperimentArmEvidence
~~~


Binding: `lightbulb.growth_experiments.ExperimentArmEvidence` → `lightbulb.growth_experiments.ExperimentArmEvidence`.

Source: `lightbulb/growth_experiments.py:1178`.

### `lightbulb.ExperimentAssignment`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ExperimentAssignment
~~~


Binding: `lightbulb.growth_experiments.ExperimentAssignment` → `lightbulb.growth_experiments.ExperimentAssignment`.

Source: `lightbulb/growth_experiments.py:1042`.

### `lightbulb.ExperimentGuardrail`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ExperimentGuardrail
~~~


Binding: `lightbulb.growth_experiments.ExperimentGuardrail` → `lightbulb.growth_experiments.ExperimentGuardrail`.

Source: `lightbulb/growth_experiments.py:647`.

### `lightbulb.ExperimentHypothesis`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ExperimentHypothesis
~~~


Binding: `lightbulb.growth_experiments.ExperimentHypothesis` → `lightbulb.growth_experiments.ExperimentHypothesis`.

Source: `lightbulb/growth_experiments.py:625`.

### `lightbulb.ExperimentVariant`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ExperimentVariant
~~~


Binding: `lightbulb.growth_experiments.ExperimentVariant` → `lightbulb.growth_experiments.ExperimentVariant`.

Source: `lightbulb/growth_experiments.py:635`.

### `lightbulb.GrowthExperimentDesign`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GrowthExperimentDesign
~~~


Binding: `lightbulb.growth_experiments.GrowthExperimentDesign` → `lightbulb.growth_experiments.GrowthExperimentDesign`.

Source: `lightbulb/growth_experiments.py:664`.

### `lightbulb.GrowthExperimentReadout`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GrowthExperimentReadout
~~~


Binding: `lightbulb.growth_experiments.GrowthExperimentReadout` → `lightbulb.growth_experiments.GrowthExperimentReadout`.

Source: `lightbulb/growth_experiments.py:1414`.

### `lightbulb.GrowthExperimentValidationError`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GrowthExperimentValidationError
~~~


Binding: `lightbulb.growth_experiments.GrowthExperimentValidationError` → `lightbulb.growth_experiments.GrowthExperimentValidationError`.

Source: `lightbulb/growth_experiments.py:129`.

### `lightbulb.GuardrailBreach`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GuardrailBreach
~~~


Binding: `lightbulb.growth_experiments.GuardrailBreach` → `lightbulb.growth_experiments.GuardrailBreach`.

Source: `lightbulb/growth_experiments.py:1397`.

### `lightbulb.ReadoutArm`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ReadoutArm
~~~


Binding: `lightbulb.growth_experiments.ReadoutArm` → `lightbulb.growth_experiments.ReadoutArm`.

Source: `lightbulb/growth_experiments.py:1366`.

### `lightbulb.SampleRatioCheck`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SampleRatioCheck
~~~


Binding: `lightbulb.growth_experiments.SampleRatioCheck` → `lightbulb.growth_experiments.SampleRatioCheck`.

Source: `lightbulb/growth_experiments.py:1384`.

### `lightbulb.assign_experiment_unit`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import assign_experiment_unit
~~~


Binding: `lightbulb.growth_experiments.assign_experiment_unit` → `lightbulb.growth_experiments.assign_experiment_unit`.

Source: `lightbulb/growth_experiments.py:1073`.

### `lightbulb.design_growth_experiment`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import design_growth_experiment
~~~


Binding: `lightbulb.growth_experiments.design_growth_experiment` → `lightbulb.growth_experiments.design_growth_experiment`.

Source: `lightbulb/growth_experiments.py:919`.

### `lightbulb.mint_experiment_arm_evidence`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import mint_experiment_arm_evidence
~~~


Binding: `lightbulb.growth_experiments.mint_experiment_arm_evidence` → `lightbulb.growth_experiments.mint_experiment_arm_evidence`.

Source: `lightbulb/growth_experiments.py:1280`.

### `lightbulb.read_out_growth_experiment`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import read_out_growth_experiment
~~~


Binding: `lightbulb.growth_experiments.read_out_growth_experiment` → `lightbulb.growth_experiments.read_out_growth_experiment`.

Source: `lightbulb/growth_experiments.py:1537`.

### `lightbulb.required_sample_per_arm_continuous`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import required_sample_per_arm_continuous
~~~


Binding: `lightbulb.growth_experiments.required_sample_per_arm_continuous` → `lightbulb.growth_experiments.required_sample_per_arm_continuous`.

Source: `lightbulb/growth_experiments.py:424`.

### `lightbulb.required_sample_per_arm_proportion`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import required_sample_per_arm_proportion
~~~


Binding: `lightbulb.growth_experiments.required_sample_per_arm_proportion` → `lightbulb.growth_experiments.required_sample_per_arm_proportion`.

Source: `lightbulb/growth_experiments.py:394`.

### `lightbulb.student_t_two_sided_quantile`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import student_t_two_sided_quantile
~~~


Binding: `lightbulb.growth_experiments.student_t_two_sided_quantile` → `lightbulb.growth_experiments.student_t_two_sided_quantile`.

Source: `lightbulb/growth_experiments.py:306`.

### `lightbulb.verify_experiment_arm_evidence`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import verify_experiment_arm_evidence
~~~


Binding: `lightbulb.growth_experiments.verify_experiment_arm_evidence` → `lightbulb.growth_experiments.verify_experiment_arm_evidence`.

Source: `lightbulb/growth_experiments.py:1319`.

### `lightbulb.verify_experiment_assignment`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import verify_experiment_assignment
~~~


Binding: `lightbulb.growth_experiments.verify_experiment_assignment` → `lightbulb.growth_experiments.verify_experiment_assignment`.

Source: `lightbulb/growth_experiments.py:1137`.

### `lightbulb.verify_growth_experiment_design`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import verify_growth_experiment_design
~~~


Binding: `lightbulb.growth_experiments.verify_growth_experiment_design` → `lightbulb.growth_experiments.verify_growth_experiment_design`.

Source: `lightbulb/growth_experiments.py:995`.

### `lightbulb.verify_growth_experiment_readout`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import verify_growth_experiment_readout
~~~


Binding: `lightbulb.growth_experiments.verify_growth_experiment_readout` → `lightbulb.growth_experiments.verify_growth_experiment_readout`.

Source: `lightbulb/growth_experiments.py:1873`.

### `lightbulb.GROWTH_LEARNING_ENTRY_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GROWTH_LEARNING_ENTRY_SCHEMA
~~~


Binding: `lightbulb.growth_learnings.GROWTH_LEARNING_ENTRY_SCHEMA` → `lightbulb.growth_learnings.GROWTH_LEARNING_ENTRY_SCHEMA`.

Source: `lightbulb/growth_learnings.py:68`.

### `lightbulb.GROWTH_LEARNINGS_LEDGER_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GROWTH_LEARNINGS_LEDGER_SCHEMA
~~~


Binding: `lightbulb.growth_learnings.GROWTH_LEARNINGS_LEDGER_SCHEMA` → `lightbulb.growth_learnings.GROWTH_LEARNINGS_LEDGER_SCHEMA`.

Source: `lightbulb/growth_learnings.py:69`.

### `lightbulb.GrowthLearningEntry`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GrowthLearningEntry
~~~


Binding: `lightbulb.growth_learnings.GrowthLearningEntry` → `lightbulb.growth_learnings.GrowthLearningEntry`.

Source: `lightbulb/growth_learnings.py:278`.

### `lightbulb.GrowthLearningsConflictError`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GrowthLearningsConflictError
~~~


Binding: `lightbulb.growth_learnings.GrowthLearningsConflictError` → `lightbulb.growth_learnings.GrowthLearningsConflictError`.

Source: `lightbulb/growth_learnings.py:123`.

### `lightbulb.GrowthLearningsLedger`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GrowthLearningsLedger
~~~


Binding: `lightbulb.growth_learnings.GrowthLearningsLedger` → `lightbulb.growth_learnings.GrowthLearningsLedger`.

Source: `lightbulb/growth_learnings.py:748`.

### `lightbulb.GrowthLearningsPersistenceError`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GrowthLearningsPersistenceError
~~~


Binding: `lightbulb.growth_learnings.GrowthLearningsPersistenceError` → `lightbulb.growth_learnings.GrowthLearningsPersistenceError`.

Source: `lightbulb/growth_learnings.py:127`.

### `lightbulb.GrowthLearningsValidationError`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GrowthLearningsValidationError
~~~


Binding: `lightbulb.growth_learnings.GrowthLearningsValidationError` → `lightbulb.growth_learnings.GrowthLearningsValidationError`.

Source: `lightbulb/growth_learnings.py:119`.

### `lightbulb.InMemoryLedgerStore`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import InMemoryLedgerStore
~~~


Binding: `lightbulb.growth_learnings.InMemoryLedgerStore` → `lightbulb.growth_learnings.InMemoryLedgerStore`.

Source: `lightbulb/growth_learnings.py:550`.

### `lightbulb.JsonFileLedgerStore`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import JsonFileLedgerStore
~~~


Binding: `lightbulb.growth_learnings.JsonFileLedgerStore` → `lightbulb.growth_learnings.JsonFileLedgerStore`.

Source: `lightbulb/growth_learnings.py:674`.

### `lightbulb.mint_growth_learning_entry`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import mint_growth_learning_entry
~~~


Binding: `lightbulb.growth_learnings.mint_growth_learning_entry` → `lightbulb.growth_learnings.mint_growth_learning_entry`.

Source: `lightbulb/growth_learnings.py:441`.

### `lightbulb.verify_growth_learning_entry`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import verify_growth_learning_entry
~~~


Binding: `lightbulb.growth_learnings.verify_growth_learning_entry` → `lightbulb.growth_learnings.verify_growth_learning_entry`.

Source: `lightbulb/growth_learnings.py:490`.

### `lightbulb.AUDIENCE_GROWTH_PLAN_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import AUDIENCE_GROWTH_PLAN_SCHEMA
~~~


Binding: `lightbulb.demand_gen_primitives.AUDIENCE_GROWTH_PLAN_SCHEMA` → `lightbulb.demand_gen_primitives.AUDIENCE_GROWTH_PLAN_SCHEMA`.

Source: `lightbulb/demand_gen_primitives.py:55`.

### `lightbulb.CONTENT_CALENDAR_PLAN_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CONTENT_CALENDAR_PLAN_SCHEMA
~~~


Binding: `lightbulb.demand_gen_primitives.CONTENT_CALENDAR_PLAN_SCHEMA` → `lightbulb.demand_gen_primitives.CONTENT_CALENDAR_PLAN_SCHEMA`.

Source: `lightbulb/demand_gen_primitives.py:54`.

### `lightbulb.AudienceGrowthBrief`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import AudienceGrowthBrief
~~~


Binding: `lightbulb.demand_gen_primitives.AudienceGrowthBrief` → `lightbulb.demand_gen_primitives.AudienceGrowthBrief`.

Source: `lightbulb/demand_gen_primitives.py:716`.

### `lightbulb.AudienceGrowthPlan`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import AudienceGrowthPlan
~~~


Binding: `lightbulb.demand_gen_primitives.AudienceGrowthPlan` → `lightbulb.demand_gen_primitives.AudienceGrowthPlan`.

Source: `lightbulb/demand_gen_primitives.py:770`.

### `lightbulb.ContentBriefItem`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ContentBriefItem
~~~


Binding: `lightbulb.demand_gen_primitives.ContentBriefItem` → `lightbulb.demand_gen_primitives.ContentBriefItem`.

Source: `lightbulb/demand_gen_primitives.py:314`.

### `lightbulb.ContentCalendarBrief`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ContentCalendarBrief
~~~


Binding: `lightbulb.demand_gen_primitives.ContentCalendarBrief` → `lightbulb.demand_gen_primitives.ContentCalendarBrief`.

Source: `lightbulb/demand_gen_primitives.py:257`.

### `lightbulb.ContentCalendarPlan`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ContentCalendarPlan
~~~


Binding: `lightbulb.demand_gen_primitives.ContentCalendarPlan` → `lightbulb.demand_gen_primitives.ContentCalendarPlan`.

Source: `lightbulb/demand_gen_primitives.py:385`.

### `lightbulb.DemandGenChannelAccount`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import DemandGenChannelAccount
~~~


Binding: `lightbulb.demand_gen_primitives.DemandGenChannelAccount` → `lightbulb.demand_gen_primitives.DemandGenChannelAccount`.

Source: `lightbulb/demand_gen_primitives.py:233`.

### `lightbulb.DemandGenValidationError`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import DemandGenValidationError
~~~


Binding: `lightbulb.demand_gen_primitives.DemandGenValidationError` → `lightbulb.demand_gen_primitives.DemandGenValidationError`.

Source: `lightbulb/demand_gen_primitives.py:104`.

### `lightbulb.plan_audience_growth`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import plan_audience_growth
~~~


Binding: `lightbulb.demand_gen_primitives.plan_audience_growth` → `lightbulb.demand_gen_primitives.plan_audience_growth`.

Source: `lightbulb/demand_gen_primitives.py:889`.

### `lightbulb.plan_content_calendar`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import plan_content_calendar
~~~


Binding: `lightbulb.demand_gen_primitives.plan_content_calendar` → `lightbulb.demand_gen_primitives.plan_content_calendar`.

Source: `lightbulb/demand_gen_primitives.py:554`.

### `lightbulb.verify_audience_growth_plan`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import verify_audience_growth_plan
~~~


Binding: `lightbulb.demand_gen_primitives.verify_audience_growth_plan` → `lightbulb.demand_gen_primitives.verify_audience_growth_plan`.

Source: `lightbulb/demand_gen_primitives.py:1009`.

### `lightbulb.verify_content_calendar_plan`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import verify_content_calendar_plan
~~~


Binding: `lightbulb.demand_gen_primitives.verify_content_calendar_plan` → `lightbulb.demand_gen_primitives.verify_content_calendar_plan`.

Source: `lightbulb/demand_gen_primitives.py:675`.

### `lightbulb.GROWTH_PORTFOLIO_DIAGNOSIS_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GROWTH_PORTFOLIO_DIAGNOSIS_SCHEMA
~~~


Binding: `lightbulb.growth_portfolio.GROWTH_PORTFOLIO_DIAGNOSIS_SCHEMA` → `lightbulb.growth_portfolio.GROWTH_PORTFOLIO_DIAGNOSIS_SCHEMA`.

Source: `lightbulb/growth_portfolio.py:68`.

### `lightbulb.GROWTH_PORTFOLIO_ROLLUP_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GROWTH_PORTFOLIO_ROLLUP_SCHEMA
~~~


Binding: `lightbulb.growth_portfolio.GROWTH_PORTFOLIO_ROLLUP_SCHEMA` → `lightbulb.growth_portfolio.GROWTH_PORTFOLIO_ROLLUP_SCHEMA`.

Source: `lightbulb/growth_portfolio.py:67`.

### `lightbulb.BottleneckCluster`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import BottleneckCluster
~~~


Binding: `lightbulb.growth_portfolio.BottleneckCluster` → `lightbulb.growth_portfolio.BottleneckCluster`.

Source: `lightbulb/growth_portfolio.py:838`.

### `lightbulb.GrowthPortfolioValidationError`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GrowthPortfolioValidationError
~~~


Binding: `lightbulb.growth_portfolio.GrowthPortfolioValidationError` → `lightbulb.growth_portfolio.GrowthPortfolioValidationError`.

Source: `lightbulb/growth_portfolio.py:137`.

### `lightbulb.PortfolioDiagnosis`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PortfolioDiagnosis
~~~


Binding: `lightbulb.growth_portfolio.PortfolioDiagnosis` → `lightbulb.growth_portfolio.PortfolioDiagnosis`.

Source: `lightbulb/growth_portfolio.py:883`.

### `lightbulb.PortfolioFunnelRollup`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PortfolioFunnelRollup
~~~


Binding: `lightbulb.growth_portfolio.PortfolioFunnelRollup` → `lightbulb.growth_portfolio.PortfolioFunnelRollup`.

Source: `lightbulb/growth_portfolio.py:368`.

### `lightbulb.PortfolioMemberInput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PortfolioMemberInput
~~~


Binding: `lightbulb.growth_portfolio.PortfolioMemberInput` → `lightbulb.growth_portfolio.PortfolioMemberInput`.

Source: `lightbulb/growth_portfolio.py:298`.

### `lightbulb.PortfolioMove`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PortfolioMove
~~~


Binding: `lightbulb.growth_portfolio.PortfolioMove` → `lightbulb.growth_portfolio.PortfolioMove`.

Source: `lightbulb/growth_portfolio.py:857`.

### `lightbulb.PortfolioRateDistribution`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PortfolioRateDistribution
~~~


Binding: `lightbulb.growth_portfolio.PortfolioRateDistribution` → `lightbulb.growth_portfolio.PortfolioRateDistribution`.

Source: `lightbulb/growth_portfolio.py:316`.

### `lightbulb.build_portfolio_funnel_rollup`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import build_portfolio_funnel_rollup
~~~


Binding: `lightbulb.growth_portfolio.build_portfolio_funnel_rollup` → `lightbulb.growth_portfolio.build_portfolio_funnel_rollup`.

Source: `lightbulb/growth_portfolio.py:460`.

### `lightbulb.derive_sibling_reference_rates`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import derive_sibling_reference_rates
~~~


Binding: `lightbulb.growth_portfolio.derive_sibling_reference_rates` → `lightbulb.growth_portfolio.derive_sibling_reference_rates`.

Source: `lightbulb/growth_portfolio.py:725`.

### `lightbulb.diagnose_portfolio`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import diagnose_portfolio
~~~


Binding: `lightbulb.growth_portfolio.diagnose_portfolio` → `lightbulb.growth_portfolio.diagnose_portfolio`.

Source: `lightbulb/growth_portfolio.py:952`.

### `lightbulb.transfer_learning`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import transfer_learning
~~~


Binding: `lightbulb.growth_portfolio.transfer_learning` → `lightbulb.growth_portfolio.transfer_learning`.

Source: `lightbulb/growth_portfolio.py:773`.

### `lightbulb.verify_portfolio_funnel_rollup`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import verify_portfolio_funnel_rollup
~~~


Binding: `lightbulb.growth_portfolio.verify_portfolio_funnel_rollup` → `lightbulb.growth_portfolio.verify_portfolio_funnel_rollup`.

Source: `lightbulb/growth_portfolio.py:678`.

### `lightbulb.GROWTH_PRICE_ELASTICITY_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GROWTH_PRICE_ELASTICITY_SCHEMA
~~~


Binding: `lightbulb.growth_profit.GROWTH_PRICE_ELASTICITY_SCHEMA` → `lightbulb.growth_profit.GROWTH_PRICE_ELASTICITY_SCHEMA`.

Source: `lightbulb/growth_profit.py:91`.

### `lightbulb.GROWTH_PRICE_PLAN_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GROWTH_PRICE_PLAN_SCHEMA
~~~


Binding: `lightbulb.growth_profit.GROWTH_PRICE_PLAN_SCHEMA` → `lightbulb.growth_profit.GROWTH_PRICE_PLAN_SCHEMA`.

Source: `lightbulb/growth_profit.py:89`.

### `lightbulb.GROWTH_PROFIT_EVIDENCE_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GROWTH_PROFIT_EVIDENCE_SCHEMA
~~~


Binding: `lightbulb.growth_profit.GROWTH_PROFIT_EVIDENCE_SCHEMA` → `lightbulb.growth_profit.GROWTH_PROFIT_EVIDENCE_SCHEMA`.

Source: `lightbulb/growth_profit.py:87`.

### `lightbulb.GROWTH_PROFIT_REVIEW_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GROWTH_PROFIT_REVIEW_SCHEMA
~~~


Binding: `lightbulb.growth_profit.GROWTH_PROFIT_REVIEW_SCHEMA` → `lightbulb.growth_profit.GROWTH_PROFIT_REVIEW_SCHEMA`.

Source: `lightbulb/growth_profit.py:90`.

### `lightbulb.GROWTH_UNIT_ECONOMICS_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GROWTH_UNIT_ECONOMICS_SCHEMA
~~~


Binding: `lightbulb.growth_profit.GROWTH_UNIT_ECONOMICS_SCHEMA` → `lightbulb.growth_profit.GROWTH_UNIT_ECONOMICS_SCHEMA`.

Source: `lightbulb/growth_profit.py:88`.

### `lightbulb.BuildUnitEconomicsInput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import BuildUnitEconomicsInput
~~~


Binding: `lightbulb.growth_profit.BuildUnitEconomicsInput` → `lightbulb.growth_profit.BuildUnitEconomicsInput`.

Source: `lightbulb/growth_profit.py:627`.

### `lightbulb.BuildUnitEconomicsPrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import BuildUnitEconomicsPrimitive
~~~


Binding: `lightbulb.growth_profit.BuildUnitEconomicsPrimitive` → `lightbulb.growth_profit.BuildUnitEconomicsPrimitive`.

Source: `lightbulb/growth_profit.py:2891`.

### `lightbulb.ContributionMetrics`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ContributionMetrics
~~~


Binding: `lightbulb.growth_profit.ContributionMetrics` → `lightbulb.growth_profit.ContributionMetrics`.

Source: `lightbulb/growth_profit.py:401`.

### `lightbulb.EconomicsComponent`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import EconomicsComponent
~~~


Binding: `lightbulb.growth_profit.EconomicsComponent` → `lightbulb.growth_profit.EconomicsComponent`.

Source: `lightbulb/growth_profit.py:689`.

### `lightbulb.GrowthProfitValidationError`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GrowthProfitValidationError
~~~


Binding: `lightbulb.growth_profit.GrowthProfitValidationError` → `lightbulb.growth_profit.GrowthProfitValidationError`.

Source: `lightbulb/growth_profit.py:240`.

### `lightbulb.MoneyOpportunity`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import MoneyOpportunity
~~~


Binding: `lightbulb.growth_profit.MoneyOpportunity` → `lightbulb.growth_profit.MoneyOpportunity`.

Source: `lightbulb/growth_profit.py:2362`.

### `lightbulb.PlanPriceMovePrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PlanPriceMovePrimitive
~~~


Binding: `lightbulb.growth_profit.PlanPriceMovePrimitive` → `lightbulb.growth_profit.PlanPriceMovePrimitive`.

Source: `lightbulb/growth_profit.py:3031`.

### `lightbulb.PriceElasticityEstimate`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PriceElasticityEstimate
~~~


Binding: `lightbulb.growth_profit.PriceElasticityEstimate` → `lightbulb.growth_profit.PriceElasticityEstimate`.

Source: `lightbulb/growth_profit.py:1322`.

### `lightbulb.PriceExperimentSettings`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PriceExperimentSettings
~~~


Binding: `lightbulb.growth_profit.PriceExperimentSettings` → `lightbulb.growth_profit.PriceExperimentSettings`.

Source: `lightbulb/growth_profit.py:1568`.

### `lightbulb.PriceGuardrailPolicy`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PriceGuardrailPolicy
~~~


Binding: `lightbulb.growth_profit.PriceGuardrailPolicy` → `lightbulb.growth_profit.PriceGuardrailPolicy`.

Source: `lightbulb/growth_profit.py:1531`.

### `lightbulb.PriceMoveOperation`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PriceMoveOperation
~~~


Binding: `lightbulb.growth_profit.PriceMoveOperation` → `lightbulb.growth_profit.PriceMoveOperation`.

Source: `lightbulb/growth_profit.py:1667`.

### `lightbulb.PricePlan`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PricePlan
~~~


Binding: `lightbulb.growth_profit.PricePlan` → `lightbulb.growth_profit.PricePlan`.

Source: `lightbulb/growth_profit.py:1762`.

### `lightbulb.PricePlanBrief`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PricePlanBrief
~~~


Binding: `lightbulb.growth_profit.PricePlanBrief` → `lightbulb.growth_profit.PricePlanBrief`.

Source: `lightbulb/growth_profit.py:1613`.

### `lightbulb.ProfitContributionEvidence`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProfitContributionEvidence
~~~


Binding: `lightbulb.growth_profit.ProfitContributionEvidence` → `lightbulb.growth_profit.ProfitContributionEvidence`.

Source: `lightbulb/growth_profit.py:445`.

### `lightbulb.ProfitReview`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProfitReview
~~~


Binding: `lightbulb.growth_profit.ProfitReview` → `lightbulb.growth_profit.ProfitReview`.

Source: `lightbulb/growth_profit.py:2425`.

### `lightbulb.ProfitStalenessPolicy`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProfitStalenessPolicy
~~~


Binding: `lightbulb.growth_profit.ProfitStalenessPolicy` → `lightbulb.growth_profit.ProfitStalenessPolicy`.

Source: `lightbulb/growth_profit.py:620`.

### `lightbulb.ReviewProfitInput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ReviewProfitInput
~~~


Binding: `lightbulb.growth_profit.ReviewProfitInput` → `lightbulb.growth_profit.ReviewProfitInput`.

Source: `lightbulb/growth_profit.py:2342`.

### `lightbulb.ReviewProfitPrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ReviewProfitPrimitive
~~~


Binding: `lightbulb.growth_profit.ReviewProfitPrimitive` → `lightbulb.growth_profit.ReviewProfitPrimitive`.

Source: `lightbulb/growth_profit.py:2965`.

### `lightbulb.UnitEconomicsSnapshot`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import UnitEconomicsSnapshot
~~~


Binding: `lightbulb.growth_profit.UnitEconomicsSnapshot` → `lightbulb.growth_profit.UnitEconomicsSnapshot`.

Source: `lightbulb/growth_profit.py:744`.

### `lightbulb.build_unit_economics`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import build_unit_economics
~~~


Binding: `lightbulb.growth_profit.build_unit_economics` → `lightbulb.growth_profit.build_unit_economics`.

Source: `lightbulb/growth_profit.py:1113`.

### `lightbulb.estimate_price_elasticity`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import estimate_price_elasticity
~~~


Binding: `lightbulb.growth_profit.estimate_price_elasticity` → `lightbulb.growth_profit.estimate_price_elasticity`.

Source: `lightbulb/growth_profit.py:1416`.

### `lightbulb.mint_profit_contribution_evidence`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import mint_profit_contribution_evidence
~~~


Binding: `lightbulb.growth_profit.mint_profit_contribution_evidence` → `lightbulb.growth_profit.mint_profit_contribution_evidence`.

Source: `lightbulb/growth_profit.py:517`.

### `lightbulb.plan_price_move`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import plan_price_move
~~~


Binding: `lightbulb.growth_profit.plan_price_move` → `lightbulb.growth_profit.plan_price_move`.

Source: `lightbulb/growth_profit.py:2029`.

### `lightbulb.review_profit`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import review_profit
~~~


Binding: `lightbulb.growth_profit.review_profit` → `lightbulb.growth_profit.review_profit`.

Source: `lightbulb/growth_profit.py:2615`.

### `lightbulb.verify_price_plan`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import verify_price_plan
~~~


Binding: `lightbulb.growth_profit.verify_price_plan` → `lightbulb.growth_profit.verify_price_plan`.

Source: `lightbulb/growth_profit.py:2299`.

### `lightbulb.verify_profit_contribution_evidence`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import verify_profit_contribution_evidence
~~~


Binding: `lightbulb.growth_profit.verify_profit_contribution_evidence` → `lightbulb.growth_profit.verify_profit_contribution_evidence`.

Source: `lightbulb/growth_profit.py:588`.

### `lightbulb.verify_unit_economics_snapshot`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import verify_unit_economics_snapshot
~~~


Binding: `lightbulb.growth_profit.verify_unit_economics_snapshot` → `lightbulb.growth_profit.verify_unit_economics_snapshot`.

Source: `lightbulb/growth_profit.py:1275`.

### `lightbulb.GROWTH_CUSTOMER_COHORT_EVIDENCE_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GROWTH_CUSTOMER_COHORT_EVIDENCE_SCHEMA
~~~


Binding: `lightbulb.growth_customers.GROWTH_CUSTOMER_COHORT_EVIDENCE_SCHEMA` → `lightbulb.growth_customers.GROWTH_CUSTOMER_COHORT_EVIDENCE_SCHEMA`.

Source: `lightbulb/growth_customers.py:84`.

### `lightbulb.GROWTH_CUSTOMER_VALUE_REVIEW_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GROWTH_CUSTOMER_VALUE_REVIEW_SCHEMA
~~~


Binding: `lightbulb.growth_customers.GROWTH_CUSTOMER_VALUE_REVIEW_SCHEMA` → `lightbulb.growth_customers.GROWTH_CUSTOMER_VALUE_REVIEW_SCHEMA`.

Source: `lightbulb/growth_customers.py:88`.

### `lightbulb.GROWTH_CUSTOMER_VALUE_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GROWTH_CUSTOMER_VALUE_SCHEMA
~~~


Binding: `lightbulb.growth_customers.GROWTH_CUSTOMER_VALUE_SCHEMA` → `lightbulb.growth_customers.GROWTH_CUSTOMER_VALUE_SCHEMA`.

Source: `lightbulb/growth_customers.py:87`.

### `lightbulb.VALUE_HORIZONS_DAYS`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import VALUE_HORIZONS_DAYS
~~~


Binding: `lightbulb.growth_customers.VALUE_HORIZONS_DAYS` → `lightbulb.growth_customers.VALUE_HORIZONS_DAYS`.

Source: `lightbulb/growth_customers.py:114`.

### `lightbulb.BuildCustomerValueInput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import BuildCustomerValueInput
~~~


Binding: `lightbulb.growth_customers.BuildCustomerValueInput` → `lightbulb.growth_customers.BuildCustomerValueInput`.

Source: `lightbulb/growth_customers.py:522`.

### `lightbulb.BuildCustomerValuePrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import BuildCustomerValuePrimitive
~~~


Binding: `lightbulb.growth_customers.BuildCustomerValuePrimitive` → `lightbulb.growth_customers.BuildCustomerValuePrimitive`.

Source: `lightbulb/growth_customers.py:1682`.

### `lightbulb.CohortAgeBucket`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CohortAgeBucket
~~~


Binding: `lightbulb.growth_customers.CohortAgeBucket` → `lightbulb.growth_customers.CohortAgeBucket`.

Source: `lightbulb/growth_customers.py:285`.

### `lightbulb.CustomerCohortEvidence`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CustomerCohortEvidence
~~~


Binding: `lightbulb.growth_customers.CustomerCohortEvidence` → `lightbulb.growth_customers.CustomerCohortEvidence`.

Source: `lightbulb/growth_customers.py:314`.

### `lightbulb.CustomerValueOpportunity`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CustomerValueOpportunity
~~~


Binding: `lightbulb.growth_customers.CustomerValueOpportunity` → `lightbulb.growth_customers.CustomerValueOpportunity`.

Source: `lightbulb/growth_customers.py:1188`.

### `lightbulb.CustomerValueReview`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CustomerValueReview
~~~


Binding: `lightbulb.growth_customers.CustomerValueReview` → `lightbulb.growth_customers.CustomerValueReview`.

Source: `lightbulb/growth_customers.py:1250`.

### `lightbulb.CustomerValueSnapshot`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CustomerValueSnapshot
~~~


Binding: `lightbulb.growth_customers.CustomerValueSnapshot` → `lightbulb.growth_customers.CustomerValueSnapshot`.

Source: `lightbulb/growth_customers.py:634`.

### `lightbulb.GrowthCustomersValidationError`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GrowthCustomersValidationError
~~~


Binding: `lightbulb.growth_customers.GrowthCustomersValidationError` → `lightbulb.growth_customers.GrowthCustomersValidationError`.

Source: `lightbulb/growth_customers.py:124`.

### `lightbulb.HorizonComponent`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import HorizonComponent
~~~


Binding: `lightbulb.growth_customers.HorizonComponent` → `lightbulb.growth_customers.HorizonComponent`.

Source: `lightbulb/growth_customers.py:552`.

### `lightbulb.ReorderCurvePoint`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ReorderCurvePoint
~~~


Binding: `lightbulb.growth_customers.ReorderCurvePoint` → `lightbulb.growth_customers.ReorderCurvePoint`.

Source: `lightbulb/growth_customers.py:611`.

### `lightbulb.ReviewCustomerValueInput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ReviewCustomerValueInput
~~~


Binding: `lightbulb.growth_customers.ReviewCustomerValueInput` → `lightbulb.growth_customers.ReviewCustomerValueInput`.

Source: `lightbulb/growth_customers.py:1167`.

### `lightbulb.ReviewCustomerValuePrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ReviewCustomerValuePrimitive
~~~


Binding: `lightbulb.growth_customers.ReviewCustomerValuePrimitive` → `lightbulb.growth_customers.ReviewCustomerValuePrimitive`.

Source: `lightbulb/growth_customers.py:1757`.

### `lightbulb.build_customer_value_snapshot`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import build_customer_value_snapshot
~~~


Binding: `lightbulb.growth_customers.build_customer_value_snapshot` → `lightbulb.growth_customers.build_customer_value_snapshot`.

Source: `lightbulb/growth_customers.py:790`.

### `lightbulb.mint_customer_cohort_evidence`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import mint_customer_cohort_evidence
~~~


Binding: `lightbulb.growth_customers.mint_customer_cohort_evidence` → `lightbulb.growth_customers.mint_customer_cohort_evidence`.

Source: `lightbulb/growth_customers.py:421`.

### `lightbulb.review_customer_value`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import review_customer_value
~~~


Binding: `lightbulb.growth_customers.review_customer_value` → `lightbulb.growth_customers.review_customer_value`.

Source: `lightbulb/growth_customers.py:1311`.

### `lightbulb.verify_customer_cohort_evidence`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import verify_customer_cohort_evidence
~~~


Binding: `lightbulb.growth_customers.verify_customer_cohort_evidence` → `lightbulb.growth_customers.verify_customer_cohort_evidence`.

Source: `lightbulb/growth_customers.py:490`.

### `lightbulb.verify_customer_value_snapshot`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import verify_customer_value_snapshot
~~~


Binding: `lightbulb.growth_customers.verify_customer_value_snapshot` → `lightbulb.growth_customers.verify_customer_value_snapshot`.

Source: `lightbulb/growth_customers.py:1118`.

### `lightbulb.COHORT_INGESTION_RESULT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import COHORT_INGESTION_RESULT_SCHEMA
~~~


Binding: `lightbulb.growth_money_ingestion.COHORT_INGESTION_RESULT_SCHEMA` → `lightbulb.growth_money_ingestion.COHORT_INGESTION_RESULT_SCHEMA`.

Source: `lightbulb/growth_money_ingestion.py:51`.

### `lightbulb.LEDGER_INGESTION_RESULT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import LEDGER_INGESTION_RESULT_SCHEMA
~~~


Binding: `lightbulb.growth_money_ingestion.LEDGER_INGESTION_RESULT_SCHEMA` → `lightbulb.growth_money_ingestion.LEDGER_INGESTION_RESULT_SCHEMA`.

Source: `lightbulb/growth_money_ingestion.py:50`.

### `lightbulb.SUPPORTED_COHORT_CAPABILITIES`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SUPPORTED_COHORT_CAPABILITIES
~~~


Binding: `lightbulb.growth_money_ingestion.SUPPORTED_COHORT_CAPABILITIES` → `lightbulb.growth_money_ingestion.SUPPORTED_COHORT_CAPABILITIES`.

Source: `lightbulb/growth_money_ingestion.py:63`.

### `lightbulb.SUPPORTED_LEDGER_CAPABILITIES`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SUPPORTED_LEDGER_CAPABILITIES
~~~


Binding: `lightbulb.growth_money_ingestion.SUPPORTED_LEDGER_CAPABILITIES` → `lightbulb.growth_money_ingestion.SUPPORTED_LEDGER_CAPABILITIES`.

Source: `lightbulb/growth_money_ingestion.py:57`.

### `lightbulb.CohortIngestionResult`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CohortIngestionResult
~~~


Binding: `lightbulb.growth_money_ingestion.CohortIngestionResult` → `lightbulb.growth_money_ingestion.CohortIngestionResult`.

Source: `lightbulb/growth_money_ingestion.py:140`.

### `lightbulb.GrowthMoneyIngestionError`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GrowthMoneyIngestionError
~~~


Binding: `lightbulb.growth_money_ingestion.GrowthMoneyIngestionError` → `lightbulb.growth_money_ingestion.GrowthMoneyIngestionError`.

Source: `lightbulb/growth_money_ingestion.py:69`.

### `lightbulb.LedgerIngestionResult`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import LedgerIngestionResult
~~~


Binding: `lightbulb.growth_money_ingestion.LedgerIngestionResult` → `lightbulb.growth_money_ingestion.LedgerIngestionResult`.

Source: `lightbulb/growth_money_ingestion.py:128`.

### `lightbulb.money_ingestion_capabilities`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import money_ingestion_capabilities
~~~


Binding: `lightbulb.growth_money_ingestion.money_ingestion_capabilities` → `lightbulb.growth_money_ingestion.money_ingestion_capabilities`.

Source: `lightbulb/growth_money_ingestion.py:538`.

### `lightbulb.normalize_contribution_ledger_response`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import normalize_contribution_ledger_response
~~~


Binding: `lightbulb.growth_money_ingestion.normalize_contribution_ledger_response` → `lightbulb.growth_money_ingestion.normalize_contribution_ledger_response`.

Source: `lightbulb/growth_money_ingestion.py:240`.

### `lightbulb.normalize_customer_cohorts_response`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import normalize_customer_cohorts_response
~~~


Binding: `lightbulb.growth_money_ingestion.normalize_customer_cohorts_response` → `lightbulb.growth_money_ingestion.normalize_customer_cohorts_response`.

Source: `lightbulb/growth_money_ingestion.py:372`.

### `lightbulb.GROWTH_OBJECTIVE_ASSESSMENT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GROWTH_OBJECTIVE_ASSESSMENT_SCHEMA
~~~


Binding: `lightbulb.growth_objectives.GROWTH_OBJECTIVE_ASSESSMENT_SCHEMA` → `lightbulb.growth_objectives.GROWTH_OBJECTIVE_ASSESSMENT_SCHEMA`.

Source: `lightbulb/growth_objectives.py:80`.

### `lightbulb.GROWTH_OBJECTIVE_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GROWTH_OBJECTIVE_SCHEMA
~~~


Binding: `lightbulb.growth_objectives.GROWTH_OBJECTIVE_SCHEMA` → `lightbulb.growth_objectives.GROWTH_OBJECTIVE_SCHEMA`.

Source: `lightbulb/growth_objectives.py:79`.

### `lightbulb.AssessObjectiveInput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import AssessObjectiveInput
~~~


Binding: `lightbulb.growth_objectives.AssessObjectiveInput` → `lightbulb.growth_objectives.AssessObjectiveInput`.

Source: `lightbulb/growth_objectives.py:589`.

### `lightbulb.AssessObjectivePrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import AssessObjectivePrimitive
~~~


Binding: `lightbulb.growth_objectives.AssessObjectivePrimitive` → `lightbulb.growth_objectives.AssessObjectivePrimitive`.

Source: `lightbulb/growth_objectives.py:1097`.

### `lightbulb.CommitGrowthObjectiveInput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CommitGrowthObjectiveInput
~~~


Binding: `lightbulb.growth_objectives.CommitGrowthObjectiveInput` → `lightbulb.growth_objectives.CommitGrowthObjectiveInput`.

Source: `lightbulb/growth_objectives.py:424`.

### `lightbulb.GapFunding`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GapFunding
~~~


Binding: `lightbulb.growth_objectives.GapFunding` → `lightbulb.growth_objectives.GapFunding`.

Source: `lightbulb/growth_objectives.py:603`.

### `lightbulb.GrowthObjective`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GrowthObjective
~~~


Binding: `lightbulb.growth_objectives.GrowthObjective` → `lightbulb.growth_objectives.GrowthObjective`.

Source: `lightbulb/growth_objectives.py:330`.

### `lightbulb.GrowthObjectivesValidationError`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GrowthObjectivesValidationError
~~~


Binding: `lightbulb.growth_objectives.GrowthObjectivesValidationError` → `lightbulb.growth_objectives.GrowthObjectivesValidationError`.

Source: `lightbulb/growth_objectives.py:101`.

### `lightbulb.ObjectiveAssessment`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ObjectiveAssessment
~~~


Binding: `lightbulb.growth_objectives.ObjectiveAssessment` → `lightbulb.growth_objectives.ObjectiveAssessment`.

Source: `lightbulb/growth_objectives.py:648`.

### `lightbulb.ObjectivePolicy`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ObjectivePolicy
~~~


Binding: `lightbulb.growth_objectives.ObjectivePolicy` → `lightbulb.growth_objectives.ObjectivePolicy`.

Source: `lightbulb/growth_objectives.py:573`.

### `lightbulb.assess_objective_progress`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import assess_objective_progress
~~~


Binding: `lightbulb.growth_objectives.assess_objective_progress` → `lightbulb.growth_objectives.assess_objective_progress`.

Source: `lightbulb/growth_objectives.py:832`.

### `lightbulb.commit_growth_objective`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import commit_growth_objective
~~~


Binding: `lightbulb.growth_objectives.commit_growth_objective` → `lightbulb.growth_objectives.commit_growth_objective`.

Source: `lightbulb/growth_objectives.py:445`.

### `lightbulb.verify_growth_objective`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import verify_growth_objective
~~~


Binding: `lightbulb.growth_objectives.verify_growth_objective` → `lightbulb.growth_objectives.verify_growth_objective`.

Source: `lightbulb/growth_objectives.py:524`.

### `lightbulb.GROWTH_BRIEFING_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GROWTH_BRIEFING_SCHEMA
~~~


Binding: `lightbulb.growth_briefing.GROWTH_BRIEFING_SCHEMA` → `lightbulb.growth_briefing.GROWTH_BRIEFING_SCHEMA`.

Source: `lightbulb/growth_briefing.py:68`.

### `lightbulb.CompileBriefingInput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CompileBriefingInput
~~~


Binding: `lightbulb.growth_briefing.CompileBriefingInput` → `lightbulb.growth_briefing.CompileBriefingInput`.

Source: `lightbulb/growth_briefing.py:224`.

### `lightbulb.CompileBriefingPrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CompileBriefingPrimitive
~~~


Binding: `lightbulb.growth_briefing.CompileBriefingPrimitive` → `lightbulb.growth_briefing.CompileBriefingPrimitive`.

Source: `lightbulb/growth_briefing.py:663`.

### `lightbulb.GrowthBriefing`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GrowthBriefing
~~~


Binding: `lightbulb.growth_briefing.GrowthBriefing` → `lightbulb.growth_briefing.GrowthBriefing`.

Source: `lightbulb/growth_briefing.py:162`.

### `lightbulb.GrowthBriefingValidationError`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GrowthBriefingValidationError
~~~


Binding: `lightbulb.growth_briefing.GrowthBriefingValidationError` → `lightbulb.growth_briefing.GrowthBriefingValidationError`.

Source: `lightbulb/growth_briefing.py:93`.

### `lightbulb.compile_growth_briefing`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import compile_growth_briefing
~~~


Binding: `lightbulb.growth_briefing.compile_growth_briefing` → `lightbulb.growth_briefing.compile_growth_briefing`.

Source: `lightbulb/growth_briefing.py:511`.

### `lightbulb.ACTION_AUTHORIZATION_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ACTION_AUTHORIZATION_SCHEMA
~~~


Binding: `lightbulb.growth_mandate.ACTION_AUTHORIZATION_SCHEMA` → `lightbulb.growth_mandate.ACTION_AUTHORIZATION_SCHEMA`.

Source: `lightbulb/growth_mandate.py:83`.

### `lightbulb.GROWTH_MANDATE_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GROWTH_MANDATE_SCHEMA
~~~


Binding: `lightbulb.growth_mandate.GROWTH_MANDATE_SCHEMA` → `lightbulb.growth_mandate.GROWTH_MANDATE_SCHEMA`.

Source: `lightbulb/growth_mandate.py:82`.

### `lightbulb.MANDATE_CHECK_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import MANDATE_CHECK_SCHEMA
~~~


Binding: `lightbulb.growth_mandate.MANDATE_CHECK_SCHEMA` → `lightbulb.growth_mandate.MANDATE_CHECK_SCHEMA`.

Source: `lightbulb/growth_mandate.py:84`.

### `lightbulb.ActionAuthorization`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ActionAuthorization
~~~


Binding: `lightbulb.growth_mandate.ActionAuthorization` → `lightbulb.growth_mandate.ActionAuthorization`.

Source: `lightbulb/growth_mandate.py:636`.

### `lightbulb.AuthorizeActionInput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import AuthorizeActionInput
~~~


Binding: `lightbulb.growth_mandate.AuthorizeActionInput` → `lightbulb.growth_mandate.AuthorizeActionInput`.

Source: `lightbulb/growth_mandate.py:1085`.

### `lightbulb.EconomicsGuardrail`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import EconomicsGuardrail
~~~


Binding: `lightbulb.growth_mandate.EconomicsGuardrail` → `lightbulb.growth_mandate.EconomicsGuardrail`.

Source: `lightbulb/growth_mandate.py:299`.

### `lightbulb.GrantGrowthMandateInput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GrantGrowthMandateInput
~~~


Binding: `lightbulb.growth_mandate.GrantGrowthMandateInput` → `lightbulb.growth_mandate.GrantGrowthMandateInput`.

Source: `lightbulb/growth_mandate.py:481`.

### `lightbulb.GrowthMandate`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GrowthMandate
~~~


Binding: `lightbulb.growth_mandate.GrowthMandate` → `lightbulb.growth_mandate.GrowthMandate`.

Source: `lightbulb/growth_mandate.py:387`.

### `lightbulb.GrowthMandateValidationError`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GrowthMandateValidationError
~~~


Binding: `lightbulb.growth_mandate.GrowthMandateValidationError` → `lightbulb.growth_mandate.GrowthMandateValidationError`.

Source: `lightbulb/growth_mandate.py:134`.

### `lightbulb.GuardrailCheck`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GuardrailCheck
~~~


Binding: `lightbulb.growth_mandate.GuardrailCheck` → `lightbulb.growth_mandate.GuardrailCheck`.

Source: `lightbulb/growth_mandate.py:625`.

### `lightbulb.MandateCheck`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import MandateCheck
~~~


Binding: `lightbulb.growth_mandate.MandateCheck` → `lightbulb.growth_mandate.MandateCheck`.

Source: `lightbulb/growth_mandate.py:1348`.

### `lightbulb.MandateGrant`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import MandateGrant
~~~


Binding: `lightbulb.growth_mandate.MandateGrant` → `lightbulb.growth_mandate.MandateGrant`.

Source: `lightbulb/growth_mandate.py:357`.

### `lightbulb.ObjectiveVerdictGuardrail`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ObjectiveVerdictGuardrail
~~~


Binding: `lightbulb.growth_mandate.ObjectiveVerdictGuardrail` → `lightbulb.growth_mandate.ObjectiveVerdictGuardrail`.

Source: `lightbulb/growth_mandate.py:320`.

### `lightbulb.PreflightActionInput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PreflightActionInput
~~~


Binding: `lightbulb.growth_mandate.PreflightActionInput` → `lightbulb.growth_mandate.PreflightActionInput`.

Source: `lightbulb/growth_mandate.py:1410`.

### `lightbulb.PreflightActionPrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PreflightActionPrimitive
~~~


Binding: `lightbulb.growth_mandate.PreflightActionPrimitive` → `lightbulb.growth_mandate.PreflightActionPrimitive`.

Source: `lightbulb/growth_mandate.py:1560`.

### `lightbulb.ProposedAction`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProposedAction
~~~


Binding: `lightbulb.growth_mandate.ProposedAction` → `lightbulb.growth_mandate.ProposedAction`.

Source: `lightbulb/growth_mandate.py:609`.

### `lightbulb.authorize_growth_action`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import authorize_growth_action
~~~


Binding: `lightbulb.growth_mandate.authorize_growth_action` → `lightbulb.growth_mandate.authorize_growth_action`.

Source: `lightbulb/growth_mandate.py:1135`.

### `lightbulb.grant_growth_mandate`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import grant_growth_mandate
~~~


Binding: `lightbulb.growth_mandate.grant_growth_mandate` → `lightbulb.growth_mandate.grant_growth_mandate`.

Source: `lightbulb/growth_mandate.py:503`.

### `lightbulb.preflight_growth_action`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import preflight_growth_action
~~~


Binding: `lightbulb.growth_mandate.preflight_growth_action` → `lightbulb.growth_mandate.preflight_growth_action`.

Source: `lightbulb/growth_mandate.py:1446`.

### `lightbulb.verify_action_authorization`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import verify_action_authorization
~~~


Binding: `lightbulb.growth_mandate.verify_action_authorization` → `lightbulb.growth_mandate.verify_action_authorization`.

Source: `lightbulb/growth_mandate.py:766`.

### `lightbulb.verify_growth_mandate`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import verify_growth_mandate
~~~


Binding: `lightbulb.growth_mandate.verify_growth_mandate` → `lightbulb.growth_mandate.verify_growth_mandate`.

Source: `lightbulb/growth_mandate.py:566`.

### `lightbulb.BURN_MULTIPLE_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import BURN_MULTIPLE_SCHEMA
~~~


Binding: `lightbulb.fundraise_readiness.BURN_MULTIPLE_SCHEMA` → `lightbulb.fundraise_readiness.BURN_MULTIPLE_SCHEMA`.

Source: `lightbulb/fundraise_readiness.py:49`.

### `lightbulb.DEFAULT_ALIVE_ASSESSMENT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import DEFAULT_ALIVE_ASSESSMENT_SCHEMA
~~~


Binding: `lightbulb.fundraise_readiness.DEFAULT_ALIVE_ASSESSMENT_SCHEMA` → `lightbulb.fundraise_readiness.DEFAULT_ALIVE_ASSESSMENT_SCHEMA`.

Source: `lightbulb/fundraise_readiness.py:48`.

### `lightbulb.AssessDefaultAlivePrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import AssessDefaultAlivePrimitive
~~~


Binding: `lightbulb.fundraise_readiness.AssessDefaultAlivePrimitive` → `lightbulb.fundraise_readiness.AssessDefaultAlivePrimitive`.

Source: `lightbulb/fundraise_readiness.py:472`.

### `lightbulb.BurnMultiple`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import BurnMultiple
~~~


Binding: `lightbulb.fundraise_readiness.BurnMultiple` → `lightbulb.fundraise_readiness.BurnMultiple`.

Source: `lightbulb/fundraise_readiness.py:383`.

### `lightbulb.BurnMultipleInput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import BurnMultipleInput
~~~


Binding: `lightbulb.fundraise_readiness.BurnMultipleInput` → `lightbulb.fundraise_readiness.BurnMultipleInput`.

Source: `lightbulb/fundraise_readiness.py:365`.

### `lightbulb.ComputeBurnMultiplePrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ComputeBurnMultiplePrimitive
~~~


Binding: `lightbulb.fundraise_readiness.ComputeBurnMultiplePrimitive` → `lightbulb.fundraise_readiness.ComputeBurnMultiplePrimitive`.

Source: `lightbulb/fundraise_readiness.py:555`.

### `lightbulb.DefaultAliveAssessment`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import DefaultAliveAssessment
~~~


Binding: `lightbulb.fundraise_readiness.DefaultAliveAssessment` → `lightbulb.fundraise_readiness.DefaultAliveAssessment`.

Source: `lightbulb/fundraise_readiness.py:194`.

### `lightbulb.DefaultAliveInput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import DefaultAliveInput
~~~


Binding: `lightbulb.fundraise_readiness.DefaultAliveInput` → `lightbulb.fundraise_readiness.DefaultAliveInput`.

Source: `lightbulb/fundraise_readiness.py:167`.

### `lightbulb.FundraiseReadinessError`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import FundraiseReadinessError
~~~


Binding: `lightbulb.fundraise_readiness.FundraiseReadinessError` → `lightbulb.fundraise_readiness.FundraiseReadinessError`.

Source: `lightbulb/fundraise_readiness.py:72`.

### `lightbulb.assess_default_alive`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import assess_default_alive
~~~


Binding: `lightbulb.fundraise_readiness.assess_default_alive` → `lightbulb.fundraise_readiness.assess_default_alive`.

Source: `lightbulb/fundraise_readiness.py:242`.

### `lightbulb.compute_burn_multiple`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import compute_burn_multiple
~~~


Binding: `lightbulb.fundraise_readiness.compute_burn_multiple` → `lightbulb.fundraise_readiness.compute_burn_multiple`.

Source: `lightbulb/fundraise_readiness.py:422`.

### `lightbulb.TAX_PROVISION_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import TAX_PROVISION_SCHEMA
~~~


Binding: `lightbulb.tax_provision.TAX_PROVISION_SCHEMA` → `lightbulb.tax_provision.TAX_PROVISION_SCHEMA`.

Source: `lightbulb/tax_provision.py:60`.

### `lightbulb.EstimateTaxSetAsideInput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import EstimateTaxSetAsideInput
~~~


Binding: `lightbulb.tax_provision.EstimateTaxSetAsideInput` → `lightbulb.tax_provision.EstimateTaxSetAsideInput`.

Source: `lightbulb/tax_provision.py:294`.

### `lightbulb.EstimateTaxSetAsidePrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import EstimateTaxSetAsidePrimitive
~~~


Binding: `lightbulb.tax_provision.EstimateTaxSetAsidePrimitive` → `lightbulb.tax_provision.EstimateTaxSetAsidePrimitive`.

Source: `lightbulb/tax_provision.py:458`.

### `lightbulb.ResolvedRate`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ResolvedRate
~~~


Binding: `lightbulb.tax_provision.ResolvedRate` → `lightbulb.tax_provision.ResolvedRate`.

Source: `lightbulb/tax_provision.py:208`.

### `lightbulb.SkippedBasis`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SkippedBasis
~~~


Binding: `lightbulb.tax_provision.SkippedBasis` → `lightbulb.tax_provision.SkippedBasis`.

Source: `lightbulb/tax_provision.py:251`.

### `lightbulb.TaxBasisInput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import TaxBasisInput
~~~


Binding: `lightbulb.tax_provision.TaxBasisInput` → `lightbulb.tax_provision.TaxBasisInput`.

Source: `lightbulb/tax_provision.py:220`.

### `lightbulb.TaxObligation`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import TaxObligation
~~~


Binding: `lightbulb.tax_provision.TaxObligation` → `lightbulb.tax_provision.TaxObligation`.

Source: `lightbulb/tax_provision.py:239`.

### `lightbulb.TaxProvision`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import TaxProvision
~~~


Binding: `lightbulb.tax_provision.TaxProvision` → `lightbulb.tax_provision.TaxProvision`.

Source: `lightbulb/tax_provision.py:256`.

### `lightbulb.TaxProvisionError`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import TaxProvisionError
~~~


Binding: `lightbulb.tax_provision.TaxProvisionError` → `lightbulb.tax_provision.TaxProvisionError`.

Source: `lightbulb/tax_provision.py:81`.

### `lightbulb.estimate_tax_set_aside`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import estimate_tax_set_aside
~~~


Binding: `lightbulb.tax_provision.estimate_tax_set_aside` → `lightbulb.tax_provision.estimate_tax_set_aside`.

Source: `lightbulb/tax_provision.py:332`.

### `lightbulb.tax_rate_reference`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import tax_rate_reference
~~~


Binding: `lightbulb.tax_provision.tax_rate_reference` → `lightbulb.tax_provision.tax_rate_reference`.

Source: `lightbulb/tax_provision.py:421`.

### `lightbulb.ACCOUNTANT_AGENDA_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ACCOUNTANT_AGENDA_SCHEMA
~~~


Binding: `lightbulb.accountant_loop.ACCOUNTANT_AGENDA_SCHEMA` → `lightbulb.accountant_loop.ACCOUNTANT_AGENDA_SCHEMA`.

Source: `lightbulb/accountant_loop.py:69`.

### `lightbulb.AccountantAction`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import AccountantAction
~~~


Binding: `lightbulb.accountant_loop.AccountantAction` → `lightbulb.accountant_loop.AccountantAction`.

Source: `lightbulb/accountant_loop.py:160`.

### `lightbulb.AccountantAgenda`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import AccountantAgenda
~~~


Binding: `lightbulb.accountant_loop.AccountantAgenda` → `lightbulb.accountant_loop.AccountantAgenda`.

Source: `lightbulb/accountant_loop.py:170`.

### `lightbulb.AccountantCycleInput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import AccountantCycleInput
~~~


Binding: `lightbulb.accountant_loop.AccountantCycleInput` → `lightbulb.accountant_loop.AccountantCycleInput`.

Source: `lightbulb/accountant_loop.py:239`.

### `lightbulb.AccountantLoopValidationError`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import AccountantLoopValidationError
~~~


Binding: `lightbulb.accountant_loop.AccountantLoopValidationError` → `lightbulb.accountant_loop.AccountantLoopValidationError`.

Source: `lightbulb/accountant_loop.py:92`.

### `lightbulb.RunAccountantCyclePrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import RunAccountantCyclePrimitive
~~~


Binding: `lightbulb.accountant_loop.RunAccountantCyclePrimitive` → `lightbulb.accountant_loop.RunAccountantCyclePrimitive`.

Source: `lightbulb/accountant_loop.py:1000`.

### `lightbulb.run_accountant_cycle`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import run_accountant_cycle
~~~


Binding: `lightbulb.accountant_loop.run_accountant_cycle` → `lightbulb.accountant_loop.run_accountant_cycle`.

Source: `lightbulb/accountant_loop.py:292`.

### `lightbulb.GRANT_MATCH_RESULT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GRANT_MATCH_RESULT_SCHEMA
~~~


Binding: `lightbulb.grant_discovery.GRANT_MATCH_RESULT_SCHEMA` → `lightbulb.grant_discovery.GRANT_MATCH_RESULT_SCHEMA`.

Source: `lightbulb/grant_discovery.py:64`.

### `lightbulb.GRANT_SEARCH_FINDINGS_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GRANT_SEARCH_FINDINGS_SCHEMA
~~~


Binding: `lightbulb.grant_discovery.GRANT_SEARCH_FINDINGS_SCHEMA` → `lightbulb.grant_discovery.GRANT_SEARCH_FINDINGS_SCHEMA`.

Source: `lightbulb/grant_discovery.py:66`.

### `lightbulb.GRANT_SEARCH_PLAN_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GRANT_SEARCH_PLAN_SCHEMA
~~~


Binding: `lightbulb.grant_discovery.GRANT_SEARCH_PLAN_SCHEMA` → `lightbulb.grant_discovery.GRANT_SEARCH_PLAN_SCHEMA`.

Source: `lightbulb/grant_discovery.py:76`.

### `lightbulb.GRANT_SEARCH_REQUEST_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GRANT_SEARCH_REQUEST_SCHEMA
~~~


Binding: `lightbulb.grant_discovery.GRANT_SEARCH_REQUEST_SCHEMA` → `lightbulb.grant_discovery.GRANT_SEARCH_REQUEST_SCHEMA`.

Source: `lightbulb/grant_discovery.py:65`.

### `lightbulb.GRANT_REGISTRY`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GRANT_REGISTRY
~~~


Binding: `lightbulb.grant_discovery.GRANT_REGISTRY` → `lightbulb.grant_discovery.GRANT_REGISTRY`.

Source: `lightbulb/grant_discovery.py:382`.

### `lightbulb.CompanyGrantProfile`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CompanyGrantProfile
~~~


Binding: `lightbulb.grant_discovery.CompanyGrantProfile` → `lightbulb.grant_discovery.CompanyGrantProfile`.

Source: `lightbulb/grant_discovery.py:390`.

### `lightbulb.EligibilitySignals`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import EligibilitySignals
~~~


Binding: `lightbulb.grant_discovery.EligibilitySignals` → `lightbulb.grant_discovery.EligibilitySignals`.

Source: `lightbulb/grant_discovery.py:170`.

### `lightbulb.GrantDiscoveryError`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GrantDiscoveryError
~~~


Binding: `lightbulb.grant_discovery.GrantDiscoveryError` → `lightbulb.grant_discovery.GrantDiscoveryError`.

Source: `lightbulb/grant_discovery.py:98`.

### `lightbulb.GrantMatchResult`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GrantMatchResult
~~~


Binding: `lightbulb.grant_discovery.GrantMatchResult` → `lightbulb.grant_discovery.GrantMatchResult`.

Source: `lightbulb/grant_discovery.py:446`.

### `lightbulb.GrantProgram`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GrantProgram
~~~


Binding: `lightbulb.grant_discovery.GrantProgram` → `lightbulb.grant_discovery.GrantProgram`.

Source: `lightbulb/grant_discovery.py:193`.

### `lightbulb.GrantSearchFindings`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GrantSearchFindings
~~~


Binding: `lightbulb.grant_discovery.GrantSearchFindings` → `lightbulb.grant_discovery.GrantSearchFindings`.

Source: `lightbulb/grant_discovery.py:792`.

### `lightbulb.GrantSearchPlan`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GrantSearchPlan
~~~


Binding: `lightbulb.grant_discovery.GrantSearchPlan` → `lightbulb.grant_discovery.GrantSearchPlan`.

Source: `lightbulb/grant_discovery.py:576`.

### `lightbulb.GrantSearchRequest`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GrantSearchRequest
~~~


Binding: `lightbulb.grant_discovery.GrantSearchRequest` → `lightbulb.grant_discovery.GrantSearchRequest`.

Source: `lightbulb/grant_discovery.py:765`.

### `lightbulb.MatchGrantsPrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import MatchGrantsPrimitive
~~~


Binding: `lightbulb.grant_discovery.MatchGrantsPrimitive` → `lightbulb.grant_discovery.MatchGrantsPrimitive`.

Source: `lightbulb/grant_discovery.py:691`.

### `lightbulb.MatchedGrant`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import MatchedGrant
~~~


Binding: `lightbulb.grant_discovery.MatchedGrant` → `lightbulb.grant_discovery.MatchedGrant`.

Source: `lightbulb/grant_discovery.py:419`.

### `lightbulb.SearchGrantsPrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SearchGrantsPrimitive
~~~


Binding: `lightbulb.grant_discovery.SearchGrantsPrimitive` → `lightbulb.grant_discovery.SearchGrantsPrimitive`.

Source: `lightbulb/grant_discovery.py:920`.

### `lightbulb.UnmatchedGrant`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import UnmatchedGrant
~~~


Binding: `lightbulb.grant_discovery.UnmatchedGrant` → `lightbulb.grant_discovery.UnmatchedGrant`.

Source: `lightbulb/grant_discovery.py:440`.

### `lightbulb.compose_grant_search_plan`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import compose_grant_search_plan
~~~


Binding: `lightbulb.grant_discovery.compose_grant_search_plan` → `lightbulb.grant_discovery.compose_grant_search_plan`.

Source: `lightbulb/grant_discovery.py:602`.

### `lightbulb.grant_registry`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import grant_registry
~~~


Binding: `lightbulb.grant_discovery.grant_registry` → `lightbulb.grant_discovery.grant_registry`.

Source: `lightbulb/grant_discovery.py:656`.

### `lightbulb.match_grant_programs`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import match_grant_programs
~~~


Binding: `lightbulb.grant_discovery.match_grant_programs` → `lightbulb.grant_discovery.match_grant_programs`.

Source: `lightbulb/grant_discovery.py:502`.

### `lightbulb.normalize_grant_findings`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import normalize_grant_findings
~~~


Binding: `lightbulb.grant_discovery.normalize_grant_findings` → `lightbulb.grant_discovery.normalize_grant_findings`.

Source: `lightbulb/grant_discovery.py:884`.

### `lightbulb.OBJECTIVE_FUNDING_GATE_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import OBJECTIVE_FUNDING_GATE_SCHEMA
~~~


Binding: `lightbulb.business_allocation.OBJECTIVE_FUNDING_GATE_SCHEMA` → `lightbulb.business_allocation.OBJECTIVE_FUNDING_GATE_SCHEMA`.

Source: `lightbulb/business_allocation.py:67`.

### `lightbulb.BusinessAllocationValidationError`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import BusinessAllocationValidationError
~~~


Binding: `lightbulb.business_allocation.BusinessAllocationValidationError` → `lightbulb.business_allocation.BusinessAllocationValidationError`.

Source: `lightbulb/business_allocation.py:85`.

### `lightbulb.FundingGatePolicy`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import FundingGatePolicy
~~~


Binding: `lightbulb.business_allocation.FundingGatePolicy` → `lightbulb.business_allocation.FundingGatePolicy`.

Source: `lightbulb/business_allocation.py:178`.

### `lightbulb.GateObjectiveFundingInput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GateObjectiveFundingInput
~~~


Binding: `lightbulb.business_allocation.GateObjectiveFundingInput` → `lightbulb.business_allocation.GateObjectiveFundingInput`.

Source: `lightbulb/business_allocation.py:263`.

### `lightbulb.GateObjectiveFundingPrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GateObjectiveFundingPrimitive
~~~


Binding: `lightbulb.business_allocation.GateObjectiveFundingPrimitive` → `lightbulb.business_allocation.GateObjectiveFundingPrimitive`.

Source: `lightbulb/business_allocation.py:504`.

### `lightbulb.ObjectiveFundingGate`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ObjectiveFundingGate
~~~


Binding: `lightbulb.business_allocation.ObjectiveFundingGate` → `lightbulb.business_allocation.ObjectiveFundingGate`.

Source: `lightbulb/business_allocation.py:196`.

### `lightbulb.gate_objective_funding`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import gate_objective_funding
~~~


Binding: `lightbulb.business_allocation.gate_objective_funding` → `lightbulb.business_allocation.gate_objective_funding`.

Source: `lightbulb/business_allocation.py:276`.

### `lightbulb.CASH_FLOW_FORECAST_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CASH_FLOW_FORECAST_SCHEMA
~~~


Binding: `lightbulb.cash_forecast.CASH_FLOW_FORECAST_SCHEMA` → `lightbulb.cash_forecast.CASH_FLOW_FORECAST_SCHEMA`.

Source: `lightbulb/cash_forecast.py:52`.

### `lightbulb.BuildCashFlowForecastPrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import BuildCashFlowForecastPrimitive
~~~


Binding: `lightbulb.cash_forecast.BuildCashFlowForecastPrimitive` → `lightbulb.cash_forecast.BuildCashFlowForecastPrimitive`.

Source: `lightbulb/cash_forecast.py:437`.

### `lightbulb.CashEventDirection`

value. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CashEventDirection
~~~


Binding: `lightbulb.cash_forecast.CashEventDirection` → `lightbulb.cash_forecast.CashEventDirection`.

Source: `lightbulb/cash_forecast.py:59`.

### `lightbulb.CashFlowForecast`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CashFlowForecast
~~~


Binding: `lightbulb.cash_forecast.CashFlowForecast` → `lightbulb.cash_forecast.CashFlowForecast`.

Source: `lightbulb/cash_forecast.py:249`.

### `lightbulb.CashFlowForecastInput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CashFlowForecastInput
~~~


Binding: `lightbulb.cash_forecast.CashFlowForecastInput` → `lightbulb.cash_forecast.CashFlowForecastInput`.

Source: `lightbulb/cash_forecast.py:184`.

### `lightbulb.CashForecastError`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CashForecastError
~~~


Binding: `lightbulb.cash_forecast.CashForecastError` → `lightbulb.cash_forecast.CashForecastError`.

Source: `lightbulb/cash_forecast.py:66`.

### `lightbulb.ForecastCoverage`

value. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ForecastCoverage
~~~


Binding: `lightbulb.cash_forecast.ForecastCoverage` → `lightbulb.cash_forecast.ForecastCoverage`.

Source: `lightbulb/cash_forecast.py:60`.

### `lightbulb.ForecastReliability`

value. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ForecastReliability
~~~


Binding: `lightbulb.cash_forecast.ForecastReliability` → `lightbulb.cash_forecast.ForecastReliability`.

Source: `lightbulb/cash_forecast.py:63`.

### `lightbulb.ScheduledCashEvent`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ScheduledCashEvent
~~~


Binding: `lightbulb.cash_forecast.ScheduledCashEvent` → `lightbulb.cash_forecast.ScheduledCashEvent`.

Source: `lightbulb/cash_forecast.py:169`.

### `lightbulb.WeekProjection`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import WeekProjection
~~~


Binding: `lightbulb.cash_forecast.WeekProjection` → `lightbulb.cash_forecast.WeekProjection`.

Source: `lightbulb/cash_forecast.py:230`.

### `lightbulb.build_cash_flow_forecast`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import build_cash_flow_forecast
~~~


Binding: `lightbulb.cash_forecast.build_cash_flow_forecast` → `lightbulb.cash_forecast.build_cash_flow_forecast`.

Source: `lightbulb/cash_forecast.py:305`.

### `lightbulb.CASH_INGESTION_RESULT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CASH_INGESTION_RESULT_SCHEMA
~~~


Binding: `lightbulb.cash_ingestion.CASH_INGESTION_RESULT_SCHEMA` → `lightbulb.cash_ingestion.CASH_INGESTION_RESULT_SCHEMA`.

Source: `lightbulb/cash_ingestion.py:45`.

### `lightbulb.CashCoverage`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CashCoverage
~~~


Binding: `lightbulb.cash_ingestion.CashCoverage` → `lightbulb.cash_ingestion.CashCoverage`.

Source: `lightbulb/cash_ingestion.py:121`.

### `lightbulb.CashIngestionError`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CashIngestionError
~~~


Binding: `lightbulb.cash_ingestion.CashIngestionError` → `lightbulb.cash_ingestion.CashIngestionError`.

Source: `lightbulb/cash_ingestion.py:76`.

### `lightbulb.CashIngestionResult`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CashIngestionResult
~~~


Binding: `lightbulb.cash_ingestion.CashIngestionResult` → `lightbulb.cash_ingestion.CashIngestionResult`.

Source: `lightbulb/cash_ingestion.py:131`.

### `lightbulb.cash_ingestion_capabilities`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import cash_ingestion_capabilities
~~~


Binding: `lightbulb.cash_ingestion.cash_ingestion_capabilities` → `lightbulb.cash_ingestion.cash_ingestion_capabilities`.

Source: `lightbulb/cash_ingestion.py:252`.

### `lightbulb.normalize_cash_response`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import normalize_cash_response
~~~


Binding: `lightbulb.cash_ingestion.normalize_cash_response` → `lightbulb.cash_ingestion.normalize_cash_response`.

Source: `lightbulb/cash_ingestion.py:166`.

### `lightbulb.RECEIVABLES_ASSESSMENT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import RECEIVABLES_ASSESSMENT_SCHEMA
~~~


Binding: `lightbulb.cash_receivables.RECEIVABLES_ASSESSMENT_SCHEMA` → `lightbulb.cash_receivables.RECEIVABLES_ASSESSMENT_SCHEMA`.

Source: `lightbulb/cash_receivables.py:50`.

### `lightbulb.AgingBuckets`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import AgingBuckets
~~~


Binding: `lightbulb.cash_receivables.AgingBuckets` → `lightbulb.cash_receivables.AgingBuckets`.

Source: `lightbulb/cash_receivables.py:227`.

### `lightbulb.AssessReceivablesInput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import AssessReceivablesInput
~~~


Binding: `lightbulb.cash_receivables.AssessReceivablesInput` → `lightbulb.cash_receivables.AssessReceivablesInput`.

Source: `lightbulb/cash_receivables.py:193`.

### `lightbulb.AssessReceivablesPrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import AssessReceivablesPrimitive
~~~


Binding: `lightbulb.cash_receivables.AssessReceivablesPrimitive` → `lightbulb.cash_receivables.AssessReceivablesPrimitive`.

Source: `lightbulb/cash_receivables.py:485`.

### `lightbulb.ExpectedCollection`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ExpectedCollection
~~~


Binding: `lightbulb.cash_receivables.ExpectedCollection` → `lightbulb.cash_receivables.ExpectedCollection`.

Source: `lightbulb/cash_receivables.py:243`.

### `lightbulb.OutstandingInvoice`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import OutstandingInvoice
~~~


Binding: `lightbulb.cash_receivables.OutstandingInvoice` → `lightbulb.cash_receivables.OutstandingInvoice`.

Source: `lightbulb/cash_receivables.py:163`.

### `lightbulb.ReceivablesAssessment`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ReceivablesAssessment
~~~


Binding: `lightbulb.cash_receivables.ReceivablesAssessment` → `lightbulb.cash_receivables.ReceivablesAssessment`.

Source: `lightbulb/cash_receivables.py:257`.

### `lightbulb.ReceivablesError`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ReceivablesError
~~~


Binding: `lightbulb.cash_receivables.ReceivablesError` → `lightbulb.cash_receivables.ReceivablesError`.

Source: `lightbulb/cash_receivables.py:64`.

### `lightbulb.build_receivables_assessment`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import build_receivables_assessment
~~~


Binding: `lightbulb.cash_receivables.build_receivables_assessment` → `lightbulb.cash_receivables.build_receivables_assessment`.

Source: `lightbulb/cash_receivables.py:323`.

### `lightbulb.PAYABLES_ASSESSMENT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PAYABLES_ASSESSMENT_SCHEMA
~~~


Binding: `lightbulb.cash_payables.PAYABLES_ASSESSMENT_SCHEMA` → `lightbulb.cash_payables.PAYABLES_ASSESSMENT_SCHEMA`.

Source: `lightbulb/cash_payables.py:69`.

### `lightbulb.AssessPayablesInput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import AssessPayablesInput
~~~


Binding: `lightbulb.cash_payables.AssessPayablesInput` → `lightbulb.cash_payables.AssessPayablesInput`.

Source: `lightbulb/cash_payables.py:263`.

### `lightbulb.AssessPayablesPrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import AssessPayablesPrimitive
~~~


Binding: `lightbulb.cash_payables.AssessPayablesPrimitive` → `lightbulb.cash_payables.AssessPayablesPrimitive`.

Source: `lightbulb/cash_payables.py:809`.

### `lightbulb.DiscountOpportunity`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import DiscountOpportunity
~~~


Binding: `lightbulb.cash_payables.DiscountOpportunity` → `lightbulb.cash_payables.DiscountOpportunity`.

Source: `lightbulb/cash_payables.py:351`.

### `lightbulb.EarlyPaymentDiscount`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import EarlyPaymentDiscount
~~~


Binding: `lightbulb.cash_payables.EarlyPaymentDiscount` → `lightbulb.cash_payables.EarlyPaymentDiscount`.

Source: `lightbulb/cash_payables.py:191`.

### `lightbulb.ExpectedPayment`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ExpectedPayment
~~~


Binding: `lightbulb.cash_payables.ExpectedPayment` → `lightbulb.cash_payables.ExpectedPayment`.

Source: `lightbulb/cash_payables.py:333`.

### `lightbulb.OutstandingBill`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import OutstandingBill
~~~


Binding: `lightbulb.cash_payables.OutstandingBill` → `lightbulb.cash_payables.OutstandingBill`.

Source: `lightbulb/cash_payables.py:214`.

### `lightbulb.PayablesAssessment`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PayablesAssessment
~~~


Binding: `lightbulb.cash_payables.PayablesAssessment` → `lightbulb.cash_payables.PayablesAssessment`.

Source: `lightbulb/cash_payables.py:389`.

### `lightbulb.PayablesError`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PayablesError
~~~


Binding: `lightbulb.cash_payables.PayablesError` → `lightbulb.cash_payables.PayablesError`.

Source: `lightbulb/cash_payables.py:92`.

### `lightbulb.build_payables_assessment`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import build_payables_assessment
~~~


Binding: `lightbulb.cash_payables.build_payables_assessment` → `lightbulb.cash_payables.build_payables_assessment`.

Source: `lightbulb/cash_payables.py:489`.

### `lightbulb.CASH_BUDGET_ENVELOPE_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CASH_BUDGET_ENVELOPE_SCHEMA
~~~


Binding: `lightbulb.cash_runway.CASH_BUDGET_ENVELOPE_SCHEMA` → `lightbulb.cash_runway.CASH_BUDGET_ENVELOPE_SCHEMA`.

Source: `lightbulb/cash_runway.py:80`.

### `lightbulb.CASH_LEDGER_EVIDENCE_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CASH_LEDGER_EVIDENCE_SCHEMA
~~~


Binding: `lightbulb.cash_runway.CASH_LEDGER_EVIDENCE_SCHEMA` → `lightbulb.cash_runway.CASH_LEDGER_EVIDENCE_SCHEMA`.

Source: `lightbulb/cash_runway.py:78`.

### `lightbulb.CASH_RUNWAY_ASSESSMENT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CASH_RUNWAY_ASSESSMENT_SCHEMA
~~~


Binding: `lightbulb.cash_runway.CASH_RUNWAY_ASSESSMENT_SCHEMA` → `lightbulb.cash_runway.CASH_RUNWAY_ASSESSMENT_SCHEMA`.

Source: `lightbulb/cash_runway.py:81`.

### `lightbulb.CASH_RUNWAY_SNAPSHOT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CASH_RUNWAY_SNAPSHOT_SCHEMA
~~~


Binding: `lightbulb.cash_runway.CASH_RUNWAY_SNAPSHOT_SCHEMA` → `lightbulb.cash_runway.CASH_RUNWAY_SNAPSHOT_SCHEMA`.

Source: `lightbulb/cash_runway.py:79`.

### `lightbulb.AssessRunwayInput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import AssessRunwayInput
~~~


Binding: `lightbulb.cash_runway.AssessRunwayInput` → `lightbulb.cash_runway.AssessRunwayInput`.

Source: `lightbulb/cash_runway.py:1569`.

### `lightbulb.AssessRunwayPrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import AssessRunwayPrimitive
~~~


Binding: `lightbulb.cash_runway.AssessRunwayPrimitive` → `lightbulb.cash_runway.AssessRunwayPrimitive`.

Source: `lightbulb/cash_runway.py:1920`.

### `lightbulb.BuildRunwayInput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import BuildRunwayInput
~~~


Binding: `lightbulb.cash_runway.BuildRunwayInput` → `lightbulb.cash_runway.BuildRunwayInput`.

Source: `lightbulb/cash_runway.py:749`.

### `lightbulb.BuildRunwaySnapshotPrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import BuildRunwaySnapshotPrimitive
~~~


Binding: `lightbulb.cash_runway.BuildRunwaySnapshotPrimitive` → `lightbulb.cash_runway.BuildRunwaySnapshotPrimitive`.

Source: `lightbulb/cash_runway.py:1779`.

### `lightbulb.BurnBand`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import BurnBand
~~~


Binding: `lightbulb.cash_runway.BurnBand` → `lightbulb.cash_runway.BurnBand`.

Source: `lightbulb/cash_runway.py:598`.

### `lightbulb.CashBudgetEnvelope`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CashBudgetEnvelope
~~~


Binding: `lightbulb.cash_runway.CashBudgetEnvelope` → `lightbulb.cash_runway.CashBudgetEnvelope`.

Source: `lightbulb/cash_runway.py:1283`.

### `lightbulb.CashFlowMetrics`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CashFlowMetrics
~~~


Binding: `lightbulb.cash_runway.CashFlowMetrics` → `lightbulb.cash_runway.CashFlowMetrics`.

Source: `lightbulb/cash_runway.py:354`.

### `lightbulb.CashLedgerEvidence`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CashLedgerEvidence
~~~


Binding: `lightbulb.cash_runway.CashLedgerEvidence` → `lightbulb.cash_runway.CashLedgerEvidence`.

Source: `lightbulb/cash_runway.py:385`.

### `lightbulb.CashRunwaySnapshot`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CashRunwaySnapshot
~~~


Binding: `lightbulb.cash_runway.CashRunwaySnapshot` → `lightbulb.cash_runway.CashRunwaySnapshot`.

Source: `lightbulb/cash_runway.py:656`.

### `lightbulb.CashRunwayValidationError`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CashRunwayValidationError
~~~


Binding: `lightbulb.cash_runway.CashRunwayValidationError` → `lightbulb.cash_runway.CashRunwayValidationError`.

Source: `lightbulb/cash_runway.py:193`.

### `lightbulb.CashStalenessPolicy`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CashStalenessPolicy
~~~


Binding: `lightbulb.cash_runway.CashStalenessPolicy` → `lightbulb.cash_runway.CashStalenessPolicy`.

Source: `lightbulb/cash_runway.py:554`.

### `lightbulb.DeriveBudgetEnvelopeInput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import DeriveBudgetEnvelopeInput
~~~


Binding: `lightbulb.cash_runway.DeriveBudgetEnvelopeInput` → `lightbulb.cash_runway.DeriveBudgetEnvelopeInput`.

Source: `lightbulb/cash_runway.py:1365`.

### `lightbulb.DeriveBudgetEnvelopePrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import DeriveBudgetEnvelopePrimitive
~~~


Binding: `lightbulb.cash_runway.DeriveBudgetEnvelopePrimitive` → `lightbulb.cash_runway.DeriveBudgetEnvelopePrimitive`.

Source: `lightbulb/cash_runway.py:1847`.

### `lightbulb.RunwayAssessment`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import RunwayAssessment
~~~


Binding: `lightbulb.cash_runway.RunwayAssessment` → `lightbulb.cash_runway.RunwayAssessment`.

Source: `lightbulb/cash_runway.py:1527`.

### `lightbulb.RunwayComponent`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import RunwayComponent
~~~


Binding: `lightbulb.cash_runway.RunwayComponent` → `lightbulb.cash_runway.RunwayComponent`.

Source: `lightbulb/cash_runway.py:561`.

### `lightbulb.RunwayOpportunity`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import RunwayOpportunity
~~~


Binding: `lightbulb.cash_runway.RunwayOpportunity` → `lightbulb.cash_runway.RunwayOpportunity`.

Source: `lightbulb/cash_runway.py:1519`.

### `lightbulb.assess_runway`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import assess_runway
~~~


Binding: `lightbulb.cash_runway.assess_runway` → `lightbulb.cash_runway.assess_runway`.

Source: `lightbulb/cash_runway.py:1597`.

### `lightbulb.build_runway_snapshot`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import build_runway_snapshot
~~~


Binding: `lightbulb.cash_runway.build_runway_snapshot` → `lightbulb.cash_runway.build_runway_snapshot`.

Source: `lightbulb/cash_runway.py:855`.

### `lightbulb.derive_budget_envelope`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import derive_budget_envelope
~~~


Binding: `lightbulb.cash_runway.derive_budget_envelope` → `lightbulb.cash_runway.derive_budget_envelope`.

Source: `lightbulb/cash_runway.py:1382`.

### `lightbulb.mint_cash_ledger_evidence`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import mint_cash_ledger_evidence
~~~


Binding: `lightbulb.cash_runway.mint_cash_ledger_evidence` → `lightbulb.cash_runway.mint_cash_ledger_evidence`.

Source: `lightbulb/cash_runway.py:453`.

### `lightbulb.verify_cash_ledger_evidence`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import verify_cash_ledger_evidence
~~~


Binding: `lightbulb.cash_runway.verify_cash_ledger_evidence` → `lightbulb.cash_runway.verify_cash_ledger_evidence`.

Source: `lightbulb/cash_runway.py:524`.

### `lightbulb.verify_cash_runway_snapshot`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import verify_cash_runway_snapshot
~~~


Binding: `lightbulb.cash_runway.verify_cash_runway_snapshot` → `lightbulb.cash_runway.verify_cash_runway_snapshot`.

Source: `lightbulb/cash_runway.py:1240`.

### `lightbulb.AGENDA_CONSUMED_WORKSPACE_KINDS`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import AGENDA_CONSUMED_WORKSPACE_KINDS
~~~


Binding: `lightbulb.growth_operating.AGENDA_CONSUMED_WORKSPACE_KINDS` → `lightbulb.growth_operating.AGENDA_CONSUMED_WORKSPACE_KINDS`.

Source: `lightbulb/growth_operating.py:154`.

### `lightbulb.AGENDA_EXEMPT_WORKSPACE_KINDS`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import AGENDA_EXEMPT_WORKSPACE_KINDS
~~~


Binding: `lightbulb.growth_operating.AGENDA_EXEMPT_WORKSPACE_KINDS` → `lightbulb.growth_operating.AGENDA_EXEMPT_WORKSPACE_KINDS`.

Source: `lightbulb/growth_operating.py:174`.

### `lightbulb.AGENDA_PRECEDENCE`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import AGENDA_PRECEDENCE
~~~


Binding: `lightbulb.growth_operating.AGENDA_PRECEDENCE` → `lightbulb.growth_operating.AGENDA_PRECEDENCE`.

Source: `lightbulb/growth_operating.py:134`.

### `lightbulb.GROWTH_AGENDA_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GROWTH_AGENDA_SCHEMA
~~~


Binding: `lightbulb.growth_operating.GROWTH_AGENDA_SCHEMA` → `lightbulb.growth_operating.GROWTH_AGENDA_SCHEMA`.

Source: `lightbulb/growth_operating.py:89`.

### `lightbulb.GROWTH_FUNNEL_DELTA_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GROWTH_FUNNEL_DELTA_SCHEMA
~~~


Binding: `lightbulb.growth_operating.GROWTH_FUNNEL_DELTA_SCHEMA` → `lightbulb.growth_operating.GROWTH_FUNNEL_DELTA_SCHEMA`.

Source: `lightbulb/growth_operating.py:90`.

### `lightbulb.AgendaItem`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import AgendaItem
~~~


Binding: `lightbulb.growth_operating.AgendaItem` → `lightbulb.growth_operating.AgendaItem`.

Source: `lightbulb/growth_operating.py:282`.

### `lightbulb.CompareFunnelSnapshotsInput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CompareFunnelSnapshotsInput
~~~


Binding: `lightbulb.growth_operating.CompareFunnelSnapshotsInput` → `lightbulb.growth_operating.CompareFunnelSnapshotsInput`.

Source: `lightbulb/growth_operating.py:1761`.

### `lightbulb.CompareFunnelSnapshotsPrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CompareFunnelSnapshotsPrimitive
~~~


Binding: `lightbulb.growth_operating.CompareFunnelSnapshotsPrimitive` → `lightbulb.growth_operating.CompareFunnelSnapshotsPrimitive`.

Source: `lightbulb/growth_operating.py:2133`.

### `lightbulb.CompileGrowthAgendaPrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CompileGrowthAgendaPrimitive
~~~


Binding: `lightbulb.growth_operating.CompileGrowthAgendaPrimitive` → `lightbulb.growth_operating.CompileGrowthAgendaPrimitive`.

Source: `lightbulb/growth_operating.py:2061`.

### `lightbulb.FunnelDelta`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import FunnelDelta
~~~


Binding: `lightbulb.growth_operating.FunnelDelta` → `lightbulb.growth_operating.FunnelDelta`.

Source: `lightbulb/growth_operating.py:1678`.

### `lightbulb.GrowthAgenda`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GrowthAgenda
~~~


Binding: `lightbulb.growth_operating.GrowthAgenda` → `lightbulb.growth_operating.GrowthAgenda`.

Source: `lightbulb/growth_operating.py:318`.

### `lightbulb.GrowthAgendaInput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GrowthAgendaInput
~~~


Binding: `lightbulb.growth_operating.GrowthAgendaInput` → `lightbulb.growth_operating.GrowthAgendaInput`.

Source: `lightbulb/growth_operating.py:387`.

### `lightbulb.GrowthCadencePolicy`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GrowthCadencePolicy
~~~


Binding: `lightbulb.growth_operating.GrowthCadencePolicy` → `lightbulb.growth_operating.GrowthCadencePolicy`.

Source: `lightbulb/growth_operating.py:258`.

### `lightbulb.GrowthOperatingValidationError`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GrowthOperatingValidationError
~~~


Binding: `lightbulb.growth_operating.GrowthOperatingValidationError` → `lightbulb.growth_operating.GrowthOperatingValidationError`.

Source: `lightbulb/growth_operating.py:187`.

### `lightbulb.MetricTotalDelta`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import MetricTotalDelta
~~~


Binding: `lightbulb.growth_operating.MetricTotalDelta` → `lightbulb.growth_operating.MetricTotalDelta`.

Source: `lightbulb/growth_operating.py:1635`.

### `lightbulb.RateDelta`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import RateDelta
~~~


Binding: `lightbulb.growth_operating.RateDelta` → `lightbulb.growth_operating.RateDelta`.

Source: `lightbulb/growth_operating.py:1592`.

### `lightbulb.compare_funnel_snapshots`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import compare_funnel_snapshots
~~~


Binding: `lightbulb.growth_operating.compare_funnel_snapshots` → `lightbulb.growth_operating.compare_funnel_snapshots`.

Source: `lightbulb/growth_operating.py:1781`.

### `lightbulb.compile_growth_agenda`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import compile_growth_agenda
~~~


Binding: `lightbulb.growth_operating.compile_growth_agenda` → `lightbulb.growth_operating.compile_growth_agenda`.

Source: `lightbulb/growth_operating.py:1495`.

### `lightbulb.GROWTH_INGESTION_RESULT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GROWTH_INGESTION_RESULT_SCHEMA
~~~


Binding: `lightbulb.growth_ingestion.GROWTH_INGESTION_RESULT_SCHEMA` → `lightbulb.growth_ingestion.GROWTH_INGESTION_RESULT_SCHEMA`.

Source: `lightbulb/growth_ingestion.py:57`.

### `lightbulb.SUPPORTED_INGESTION_CAPABILITIES`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import SUPPORTED_INGESTION_CAPABILITIES
~~~


Binding: `lightbulb.growth_ingestion.SUPPORTED_INGESTION_CAPABILITIES` → `lightbulb.growth_ingestion.SUPPORTED_INGESTION_CAPABILITIES`.

Source: `lightbulb/growth_ingestion.py:74`.

### `lightbulb.GrowthIngestionError`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GrowthIngestionError
~~~


Binding: `lightbulb.growth_ingestion.GrowthIngestionError` → `lightbulb.growth_ingestion.GrowthIngestionError`.

Source: `lightbulb/growth_ingestion.py:108`.

### `lightbulb.IngestionResult`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import IngestionResult
~~~


Binding: `lightbulb.growth_ingestion.IngestionResult` → `lightbulb.growth_ingestion.IngestionResult`.

Source: `lightbulb/growth_ingestion.py:158`.

### `lightbulb.MetricCoverage`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import MetricCoverage
~~~


Binding: `lightbulb.growth_ingestion.MetricCoverage` → `lightbulb.growth_ingestion.MetricCoverage`.

Source: `lightbulb/growth_ingestion.py:136`.

### `lightbulb.ingestion_capabilities`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ingestion_capabilities
~~~


Binding: `lightbulb.growth_ingestion.ingestion_capabilities` → `lightbulb.growth_ingestion.ingestion_capabilities`.

Source: `lightbulb/growth_ingestion.py:787`.

### `lightbulb.normalize_connector_response`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import normalize_connector_response
~~~


Binding: `lightbulb.growth_ingestion.normalize_connector_response` → `lightbulb.growth_ingestion.normalize_connector_response`.

Source: `lightbulb/growth_ingestion.py:688`.

### `lightbulb.GROWTH_RAIL_DISPATCH_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GROWTH_RAIL_DISPATCH_SCHEMA
~~~


Binding: `lightbulb.growth_rail_bridge.GROWTH_RAIL_DISPATCH_SCHEMA` → `lightbulb.growth_rail_bridge.GROWTH_RAIL_DISPATCH_SCHEMA`.

Source: `lightbulb/growth_rail_bridge.py:75`.

### `lightbulb.GROWTH_RAIL_RECONCILIATION_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GROWTH_RAIL_RECONCILIATION_SCHEMA
~~~


Binding: `lightbulb.growth_rail_bridge.GROWTH_RAIL_RECONCILIATION_SCHEMA` → `lightbulb.growth_rail_bridge.GROWTH_RAIL_RECONCILIATION_SCHEMA`.

Source: `lightbulb/growth_rail_bridge.py:76`.

### `lightbulb.RAIL_EXECUTION_RECEIPT_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import RAIL_EXECUTION_RECEIPT_SCHEMA
~~~


Binding: `lightbulb.growth_rail_bridge.RAIL_EXECUTION_RECEIPT_SCHEMA` → `lightbulb.growth_rail_bridge.RAIL_EXECUTION_RECEIPT_SCHEMA`.

Source: `lightbulb/growth_rail_bridge.py:80`.

### `lightbulb.AuthoredSocialPost`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import AuthoredSocialPost
~~~


Binding: `lightbulb.growth_rail_bridge.AuthoredSocialPost` → `lightbulb.growth_rail_bridge.AuthoredSocialPost`.

Source: `lightbulb/growth_rail_bridge.py:389`.

### `lightbulb.DispatchReconciliation`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import DispatchReconciliation
~~~


Binding: `lightbulb.growth_rail_bridge.DispatchReconciliation` → `lightbulb.growth_rail_bridge.DispatchReconciliation`.

Source: `lightbulb/growth_rail_bridge.py:1101`.

### `lightbulb.GrowthRailBridgeValidationError`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GrowthRailBridgeValidationError
~~~


Binding: `lightbulb.growth_rail_bridge.GrowthRailBridgeValidationError` → `lightbulb.growth_rail_bridge.GrowthRailBridgeValidationError`.

Source: `lightbulb/growth_rail_bridge.py:102`.

### `lightbulb.RailDispatchPackage`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import RailDispatchPackage
~~~


Binding: `lightbulb.growth_rail_bridge.RailDispatchPackage` → `lightbulb.growth_rail_bridge.RailDispatchPackage`.

Source: `lightbulb/growth_rail_bridge.py:590`.

### `lightbulb.RailDispatcher`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import RailDispatcher
~~~


Binding: `lightbulb.growth_rail_bridge.RailDispatcher` → `lightbulb.growth_rail_bridge.RailDispatcher`.

Source: `lightbulb/growth_rail_bridge.py:1251`.

### `lightbulb.RailExecutionReceipt`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import RailExecutionReceipt
~~~


Binding: `lightbulb.growth_rail_bridge.RailExecutionReceipt` → `lightbulb.growth_rail_bridge.RailExecutionReceipt`.

Source: `lightbulb/growth_rail_bridge.py:927`.

### `lightbulb.RailSocialOperation`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import RailSocialOperation
~~~


Binding: `lightbulb.growth_rail_bridge.RailSocialOperation` → `lightbulb.growth_rail_bridge.RailSocialOperation`.

Source: `lightbulb/growth_rail_bridge.py:503`.

### `lightbulb.author_calendar_item`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import author_calendar_item
~~~


Binding: `lightbulb.growth_rail_bridge.author_calendar_item` → `lightbulb.growth_rail_bridge.author_calendar_item`.

Source: `lightbulb/growth_rail_bridge.py:450`.

### `lightbulb.compile_audience_growth_dispatch`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import compile_audience_growth_dispatch
~~~


Binding: `lightbulb.growth_rail_bridge.compile_audience_growth_dispatch` → `lightbulb.growth_rail_bridge.compile_audience_growth_dispatch`.

Source: `lightbulb/growth_rail_bridge.py:699`.

### `lightbulb.compile_content_calendar_dispatch`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import compile_content_calendar_dispatch
~~~


Binding: `lightbulb.growth_rail_bridge.compile_content_calendar_dispatch` → `lightbulb.growth_rail_bridge.compile_content_calendar_dispatch`.

Source: `lightbulb/growth_rail_bridge.py:664`.

### `lightbulb.reconcile_dispatch_receipts`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import reconcile_dispatch_receipts
~~~


Binding: `lightbulb.growth_rail_bridge.reconcile_dispatch_receipts` → `lightbulb.growth_rail_bridge.reconcile_dispatch_receipts`.

Source: `lightbulb/growth_rail_bridge.py:1155`.

### `lightbulb.verify_rail_dispatch_package`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import verify_rail_dispatch_package
~~~


Binding: `lightbulb.growth_rail_bridge.verify_rail_dispatch_package` → `lightbulb.growth_rail_bridge.verify_rail_dispatch_package`.

Source: `lightbulb/growth_rail_bridge.py:881`.

### `lightbulb.verify_rail_execution_receipt`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import verify_rail_execution_receipt
~~~


Binding: `lightbulb.growth_rail_bridge.verify_rail_execution_receipt` → `lightbulb.growth_rail_bridge.verify_rail_execution_receipt`.

Source: `lightbulb/growth_rail_bridge.py:1049`.

### `lightbulb.GROWTH_WORKSPACE_INDEX_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GROWTH_WORKSPACE_INDEX_SCHEMA
~~~


Binding: `lightbulb.growth_workspace.GROWTH_WORKSPACE_INDEX_SCHEMA` → `lightbulb.growth_workspace.GROWTH_WORKSPACE_INDEX_SCHEMA`.

Source: `lightbulb/growth_workspace.py:138`.

### `lightbulb.ExperimentStatusRecord`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ExperimentStatusRecord
~~~


Binding: `lightbulb.growth_workspace.ExperimentStatusRecord` → `lightbulb.growth_workspace.ExperimentStatusRecord`.

Source: `lightbulb/growth_workspace.py:247`.

### `lightbulb.GrowthWorkspace`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GrowthWorkspace
~~~


Binding: `lightbulb.growth_workspace.GrowthWorkspace` → `lightbulb.growth_workspace.GrowthWorkspace`.

Source: `lightbulb/growth_workspace.py:399`.

### `lightbulb.GrowthWorkspacePersistenceError`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GrowthWorkspacePersistenceError
~~~


Binding: `lightbulb.growth_workspace.GrowthWorkspacePersistenceError` → `lightbulb.growth_workspace.GrowthWorkspacePersistenceError`.

Source: `lightbulb/growth_workspace.py:178`.

### `lightbulb.GrowthWorkspaceValidationError`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GrowthWorkspaceValidationError
~~~


Binding: `lightbulb.growth_workspace.GrowthWorkspaceValidationError` → `lightbulb.growth_workspace.GrowthWorkspaceValidationError`.

Source: `lightbulb/growth_workspace.py:174`.

### `lightbulb.WorkspaceRecord`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import WorkspaceRecord
~~~


Binding: `lightbulb.growth_workspace.WorkspaceRecord` → `lightbulb.growth_workspace.WorkspaceRecord`.

Source: `lightbulb/growth_workspace.py:234`.

### `lightbulb.WorkspaceStatus`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import WorkspaceStatus
~~~


Binding: `lightbulb.growth_workspace.WorkspaceStatus` → `lightbulb.growth_workspace.WorkspaceStatus`.

Source: `lightbulb/growth_workspace.py:262`.

### `lightbulb.GROWTH_DIAGNOSIS_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GROWTH_DIAGNOSIS_SCHEMA
~~~


Binding: `lightbulb.growth_cockpit.GROWTH_DIAGNOSIS_SCHEMA` → `lightbulb.growth_cockpit.GROWTH_DIAGNOSIS_SCHEMA`.

Source: `lightbulb/growth_cockpit.py:68`.

### `lightbulb.ApplicableLearning`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ApplicableLearning
~~~


Binding: `lightbulb.growth_cockpit.ApplicableLearning` → `lightbulb.growth_cockpit.ApplicableLearning`.

Source: `lightbulb/growth_cockpit.py:207`.

### `lightbulb.BuildGrowthFunnelSnapshotPrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import BuildGrowthFunnelSnapshotPrimitive
~~~


Binding: `lightbulb.growth_cockpit.BuildGrowthFunnelSnapshotPrimitive` → `lightbulb.growth_cockpit.BuildGrowthFunnelSnapshotPrimitive`.

Source: `lightbulb/growth_cockpit.py:543`.

### `lightbulb.DiagnoseGrowthInput`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import DiagnoseGrowthInput
~~~


Binding: `lightbulb.growth_cockpit.DiagnoseGrowthInput` → `lightbulb.growth_cockpit.DiagnoseGrowthInput`.

Source: `lightbulb/growth_cockpit.py:171`.

### `lightbulb.DiagnoseGrowthPrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import DiagnoseGrowthPrimitive
~~~


Binding: `lightbulb.growth_cockpit.DiagnoseGrowthPrimitive` → `lightbulb.growth_cockpit.DiagnoseGrowthPrimitive`.

Source: `lightbulb/growth_cockpit.py:613`.

### `lightbulb.GrowthCockpitValidationError`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GrowthCockpitValidationError
~~~


Binding: `lightbulb.growth_cockpit.GrowthCockpitValidationError` → `lightbulb.growth_cockpit.GrowthCockpitValidationError`.

Source: `lightbulb/growth_cockpit.py:109`.

### `lightbulb.GrowthDiagnosis`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GrowthDiagnosis
~~~


Binding: `lightbulb.growth_cockpit.GrowthDiagnosis` → `lightbulb.growth_cockpit.GrowthDiagnosis`.

Source: `lightbulb/growth_cockpit.py:234`.

### `lightbulb.GrowthOpportunity`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GrowthOpportunity
~~~


Binding: `lightbulb.growth_cockpit.GrowthOpportunity` → `lightbulb.growth_cockpit.GrowthOpportunity`.

Source: `lightbulb/growth_cockpit.py:189`.

### `lightbulb.PlanAudienceGrowthPrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PlanAudienceGrowthPrimitive
~~~


Binding: `lightbulb.growth_cockpit.PlanAudienceGrowthPrimitive` → `lightbulb.growth_cockpit.PlanAudienceGrowthPrimitive`.

Source: `lightbulb/growth_cockpit.py:760`.

### `lightbulb.PlanContentCalendarPrimitive`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import PlanContentCalendarPrimitive
~~~


Binding: `lightbulb.growth_cockpit.PlanContentCalendarPrimitive` → `lightbulb.growth_cockpit.PlanContentCalendarPrimitive`.

Source: `lightbulb/growth_cockpit.py:679`.

### `lightbulb.diagnose_growth`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import diagnose_growth
~~~


Binding: `lightbulb.growth_cockpit.diagnose_growth` → `lightbulb.growth_cockpit.diagnose_growth`.

Source: `lightbulb/growth_cockpit.py:306`.

### `lightbulb.validate_communication_dispatch_recovery_stage_request`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import validate_communication_dispatch_recovery_stage_request
~~~


Binding: `lightbulb.communication_dispatch_recovery.validate_communication_dispatch_recovery_stage_request` → `lightbulb.communication_dispatch_recovery.validate_communication_dispatch_recovery_stage_request`.

Source: `lightbulb/communication_dispatch_recovery.py:692`.

### `lightbulb.verify_communication_dispatch_recovery_stage`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import verify_communication_dispatch_recovery_stage
~~~


Binding: `lightbulb.communication_dispatch_recovery.verify_communication_dispatch_recovery_stage` → `lightbulb.communication_dispatch_recovery.verify_communication_dispatch_recovery_stage`.

Source: `lightbulb/communication_dispatch_recovery.py:786`.

### `lightbulb.LEGACY_RELEASED_AUTHORITY_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import LEGACY_RELEASED_AUTHORITY_SCHEMA
~~~


Binding: `lightbulb.released_authority.LEGACY_RELEASED_AUTHORITY_SCHEMA` → `lightbulb.released_authority.LEGACY_RELEASED_AUTHORITY_SCHEMA`.

Source: `lightbulb/released_authority.py:21`.

### `lightbulb.LEGACY_RELEASED_AUTHORITY_VERSION`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import LEGACY_RELEASED_AUTHORITY_VERSION
~~~


Binding: `lightbulb.released_authority.LEGACY_RELEASED_AUTHORITY_VERSION` → `lightbulb.released_authority.LEGACY_RELEASED_AUTHORITY_VERSION`.

Source: `lightbulb/released_authority.py:22`.

### `lightbulb.RELEASED_AUTHORITY_SCHEMA`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import RELEASED_AUTHORITY_SCHEMA
~~~


Binding: `lightbulb.released_authority.RELEASED_AUTHORITY_SCHEMA` → `lightbulb.released_authority.RELEASED_AUTHORITY_SCHEMA`.

Source: `lightbulb/released_authority.py:23`.

### `lightbulb.RELEASED_AUTHORITY_VERSION`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import RELEASED_AUTHORITY_VERSION
~~~


Binding: `lightbulb.released_authority.RELEASED_AUTHORITY_VERSION` → `lightbulb.released_authority.RELEASED_AUTHORITY_VERSION`.

Source: `lightbulb/released_authority.py:24`.

### `lightbulb.ApprovalPolicyClass`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ApprovalPolicyClass
~~~


Binding: `lightbulb.released_authority.ApprovalPolicyClass` → `lightbulb.released_authority.ApprovalPolicyClass`.

Source: `lightbulb/released_authority.py:96`.

### `lightbulb.AuthorityDocumentationContract`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import AuthorityDocumentationContract
~~~


Binding: `lightbulb.released_authority.AuthorityDocumentationContract` → `lightbulb.released_authority.AuthorityDocumentationContract`.

Source: `lightbulb/released_authority.py:440`.

### `lightbulb.AuthorityEffect`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import AuthorityEffect
~~~


Binding: `lightbulb.released_authority.AuthorityEffect` → `lightbulb.released_authority.AuthorityEffect`.

Source: `lightbulb/released_authority.py:75`.

### `lightbulb.CatalogToolAuthority`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CatalogToolAuthority
~~~


Binding: `lightbulb.released_authority.CatalogToolAuthority` → `lightbulb.released_authority.CatalogToolAuthority`.

Source: `lightbulb/released_authority.py:190`.

### `lightbulb.ConnectorCertificationState`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ConnectorCertificationState
~~~


Binding: `lightbulb.released_authority.ConnectorCertificationState` → `lightbulb.released_authority.ConnectorCertificationState`.

Source: `lightbulb/released_authority.py:109`.

### `lightbulb.ConnectorPairAuthority`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ConnectorPairAuthority
~~~


Binding: `lightbulb.released_authority.ConnectorPairAuthority` → `lightbulb.released_authority.ConnectorPairAuthority`.

Source: `lightbulb/released_authority.py:352`.

### `lightbulb.CredentialMechanism`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import CredentialMechanism
~~~


Binding: `lightbulb.released_authority.CredentialMechanism` → `lightbulb.released_authority.CredentialMechanism`.

Source: `lightbulb/released_authority.py:90`.

### `lightbulb.EndpointAuthorityClass`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import EndpointAuthorityClass
~~~


Binding: `lightbulb.released_authority.EndpointAuthorityClass` → `lightbulb.released_authority.EndpointAuthorityClass`.

Source: `lightbulb/released_authority.py:85`.

### `lightbulb.EndpointAvailability`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import EndpointAvailability
~~~


Binding: `lightbulb.released_authority.EndpointAvailability` → `lightbulb.released_authority.EndpointAvailability`.

Source: `lightbulb/released_authority.py:80`.

### `lightbulb.FeatureGateAuthority`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import FeatureGateAuthority
~~~


Binding: `lightbulb.released_authority.FeatureGateAuthority` → `lightbulb.released_authority.FeatureGateAuthority`.

Source: `lightbulb/released_authority.py:164`.

### `lightbulb.FinancialApprovalLifecycleAuthority`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import FinancialApprovalLifecycleAuthority
~~~


Binding: `lightbulb.released_authority.FinancialApprovalLifecycleAuthority` → `lightbulb.released_authority.FinancialApprovalLifecycleAuthority`.

Source: `lightbulb/released_authority.py:475`.

### `lightbulb.GovernedEndpointAuthority`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import GovernedEndpointAuthority
~~~


Binding: `lightbulb.released_authority.GovernedEndpointAuthority` → `lightbulb.released_authority.GovernedEndpointAuthority`.

Source: `lightbulb/released_authority.py:120`.

### `lightbulb.ProductionEnablementState`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ProductionEnablementState
~~~


Binding: `lightbulb.released_authority.ProductionEnablementState` → `lightbulb.released_authority.ProductionEnablementState`.

Source: `lightbulb/released_authority.py:114`.

### `lightbulb.RecoverySupport`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import RecoverySupport
~~~


Binding: `lightbulb.released_authority.RecoverySupport` → `lightbulb.released_authority.RecoverySupport`.

Source: `lightbulb/released_authority.py:102`.

### `lightbulb.ReleasedAuthorityLookupError`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ReleasedAuthorityLookupError
~~~


Binding: `lightbulb.released_authority.ReleasedAuthorityLookupError` → `lightbulb.released_authority.ReleasedAuthorityLookupError`.

Source: `lightbulb/released_authority.py:717`.

### `lightbulb.ReleasedAuthorityManifest`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ReleasedAuthorityManifest
~~~


Binding: `lightbulb.released_authority.ReleasedAuthorityManifest` → `lightbulb.released_authority.ReleasedAuthorityManifest`.

Source: `lightbulb/released_authority.py:721`.

### `lightbulb.ReleasedAuthorityManifestV2`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ReleasedAuthorityManifestV2
~~~


Binding: `lightbulb.released_authority.ReleasedAuthorityManifestV2` → `lightbulb.released_authority.ReleasedAuthorityManifestV2`.

Source: `lightbulb/released_authority.py:999`.

### `lightbulb.ReleasedFinancialApprovalAuthority`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ReleasedFinancialApprovalAuthority
~~~


Binding: `lightbulb.released_authority.ReleasedFinancialApprovalAuthority` → `lightbulb.released_authority.ReleasedFinancialApprovalAuthority`.

Source: `lightbulb/released_authority.py:492`.

### `lightbulb.ReleasedToolAuthority`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ReleasedToolAuthority
~~~


Binding: `lightbulb.released_authority.ReleasedToolAuthority` → `lightbulb.released_authority.ReleasedToolAuthority`.

Source: `lightbulb/released_authority.py:262`.

### `lightbulb.RequiredMigrationAuthority`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import RequiredMigrationAuthority
~~~


Binding: `lightbulb.released_authority.RequiredMigrationAuthority` → `lightbulb.released_authority.RequiredMigrationAuthority`.

Source: `lightbulb/released_authority.py:407`.

### `lightbulb.ReviewedCatalogAuthority`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import ReviewedCatalogAuthority
~~~


Binding: `lightbulb.released_authority.ReviewedCatalogAuthority` → `lightbulb.released_authority.ReviewedCatalogAuthority`.

Source: `lightbulb/released_authority.py:203`.

### `lightbulb.WorkflowPublicationAuthority`

class. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import WorkflowPublicationAuthority
~~~


Binding: `lightbulb.released_authority.WorkflowPublicationAuthority` → `lightbulb.released_authority.WorkflowPublicationAuthority`.

Source: `lightbulb/released_authority.py:621`.

### `lightbulb.load_released_authority_manifest`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import load_released_authority_manifest
~~~


Binding: `lightbulb.released_authority.load_released_authority_manifest` → `lightbulb.released_authority.load_released_authority_manifest`.

Source: `lightbulb/released_authority.py:1010`.

### `lightbulb.released_authority_digest`

function. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import released_authority_digest
~~~


Binding: `lightbulb.released_authority.released_authority_digest` → `lightbulb.released_authority.released_authority_digest`.

Source: `lightbulb/released_authority.py:35`.

### `lightbulb.__version__`

constant. Declared by `lightbulb.__all__`.



~~~python
from lightbulb import __version__
~~~


Binding: `lightbulb._version.__version__` → `lightbulb._version.__version__`.

Source: `lightbulb/_version.py:3`.

## Export declaration `lightbulb.sdk.__all__`

Source: `lightbulb/sdk/__init__.py`. Declared exports: 11.

### `lightbulb.sdk.Lightbulb`

class. Declared by `lightbulb.sdk.__all__`.



~~~python
from lightbulb.sdk import Lightbulb
~~~


Binding: `lightbulb.sdk.client.Lightbulb` → `lightbulb.sdk.client.Lightbulb`.

Source: `lightbulb/sdk/client.py:26`.

### `lightbulb.sdk.AsyncLightbulb`

class. Declared by `lightbulb.sdk.__all__`.



~~~python
from lightbulb.sdk import AsyncLightbulb
~~~


Binding: `lightbulb.sdk.client.AsyncLightbulb` → `lightbulb.sdk.client.AsyncLightbulb`.

Source: `lightbulb/sdk/client.py:97`.

### `lightbulb.sdk.Client`

class alias. Declared by `lightbulb.sdk.__all__`.



~~~python
from lightbulb.sdk import Client
~~~


Binding: `lightbulb.sdk.client.Client` → `lightbulb.sdk.client.Lightbulb`.

Source: `lightbulb/sdk/client.py:26`.

### `lightbulb.sdk.AsyncClient`

class alias. Declared by `lightbulb.sdk.__all__`.



~~~python
from lightbulb.sdk import AsyncClient
~~~


Binding: `lightbulb.sdk.client.AsyncClient` → `lightbulb.sdk.client.AsyncLightbulb`.

Source: `lightbulb/sdk/client.py:97`.

### `lightbulb.sdk.Company`

class. Declared by `lightbulb.sdk.__all__`.



~~~python
from lightbulb.sdk import Company
~~~


Binding: `lightbulb.sdk.models.Company` → `lightbulb.sdk.models.Company`.

Source: `lightbulb/sdk/models.py:71`.

### `lightbulb.sdk.Project`

class. Declared by `lightbulb.sdk.__all__`.



~~~python
from lightbulb.sdk import Project
~~~


Binding: `lightbulb.sdk.models.Project` → `lightbulb.sdk.models.Project`.

Source: `lightbulb/sdk/models.py:99`.

### `lightbulb.sdk.WorkflowInstance`

class. Declared by `lightbulb.sdk.__all__`.



~~~python
from lightbulb.sdk import WorkflowInstance
~~~


Binding: `lightbulb.sdk.models.WorkflowInstance` → `lightbulb.sdk.models.WorkflowInstance`.

Source: `lightbulb/sdk/models.py:140`.

### `lightbulb.sdk.Approval`

class. Declared by `lightbulb.sdk.__all__`.



~~~python
from lightbulb.sdk import Approval
~~~


Binding: `lightbulb.sdk.models.Approval` → `lightbulb.sdk.models.Approval`.

Source: `lightbulb/sdk/models.py:267`.

### `lightbulb.sdk.Artifact`

class. Declared by `lightbulb.sdk.__all__`.



~~~python
from lightbulb.sdk import Artifact
~~~


Binding: `lightbulb.sdk.models.Artifact` → `lightbulb.sdk.models.Artifact`.

Source: `lightbulb/sdk/models.py:310`.

### `lightbulb.sdk.Page`

class. Declared by `lightbulb.sdk.__all__`.



~~~python
from lightbulb.sdk import Page
~~~


Binding: `lightbulb.sdk.models.Page` → `lightbulb.sdk.models.Page`.

Source: `lightbulb/sdk/models.py:346`.

### `lightbulb.sdk.OperationReceipt`

class. Declared by `lightbulb.sdk.__all__`.



~~~python
from lightbulb.sdk import OperationReceipt
~~~


Binding: `lightbulb.sdk.models.OperationReceipt` → `lightbulb.sdk.models.OperationReceipt`.

Source: `lightbulb/sdk/models.py:361`.

## MCP tools

### `airwallex_create_payment`

Namespace: `airwallex`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
airwallex_create_payment(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Airwallex connector operation `create_payment` (platform tool `airwallex.create_payment`).

Source: `lightbulb/mcp_generated_tools.py:13476`.

### `airwallex_list_balances`

Namespace: `airwallex`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
airwallex_list_balances(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Airwallex connector operation `list_balances` (platform tool `airwallex.list_balances`).

Source: `lightbulb/mcp_generated_tools.py:13521`.

### `airwallex_list_payouts`

Namespace: `airwallex`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
airwallex_list_payouts(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Airwallex connector operation `list_payouts` (platform tool `airwallex.list_payouts`).

Source: `lightbulb/mcp_generated_tools.py:13566`.

### `airwallex_list_transactions`

Namespace: `airwallex`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
airwallex_list_transactions(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Airwallex connector operation `list_transactions` (platform tool `airwallex.list_transactions`).

Source: `lightbulb/mcp_generated_tools.py:13611`.

### `bamboohr_add_employee`

Namespace: `bamboohr`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
bamboohr_add_employee(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Bamboohr connector operation `add_employee` (platform tool `bamboohr.add_employee`).

Source: `lightbulb/mcp_generated_tools.py:13656`.

### `billcom_approve_bill`

Namespace: `billcom`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
billcom_approve_bill(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Billcom connector operation `approve_bill` (platform tool `billcom.approve_bill`).

Source: `lightbulb/mcp_generated_tools.py:13701`.

### `billcom_create_bill`

Namespace: `billcom`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
billcom_create_bill(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Billcom connector operation `create_bill` (platform tool `billcom.create_bill`).

Source: `lightbulb/mcp_generated_tools.py:13746`.

### `billcom_list_bills`

Namespace: `billcom`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
billcom_list_bills(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Billcom connector operation `list_bills` (platform tool `billcom.list_bills`).

Source: `lightbulb/mcp_generated_tools.py:13791`.

### `billcom_list_payments`

Namespace: `billcom`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
billcom_list_payments(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Billcom connector operation `list_payments` (platform tool `billcom.list_payments`).

Source: `lightbulb/mcp_generated_tools.py:13836`.

### `billcom_list_vendors`

Namespace: `billcom`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
billcom_list_vendors(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Billcom connector operation `list_vendors` (platform tool `billcom.list_vendors`).

Source: `lightbulb/mcp_generated_tools.py:13881`.

### `brain_ask`

Namespace: `brain`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
brain_ask(message: str='', inputs: str='{}') -> str
~~~


Run the brain domain agent action `ask`.

Source: `lightbulb/mcp_generated_tools.py:176`.

### `brain_chat`

Namespace: `brain`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
brain_chat(message: str='', inputs: str='{}') -> str
~~~


Run the brain domain agent action `chat`.

Source: `lightbulb/mcp_generated_tools.py:198`.

### `brain_describe_anatomy`

Namespace: `brain`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
brain_describe_anatomy(message: str='', inputs: str='{}') -> str
~~~


Run the brain domain agent action `describe_anatomy`.

Source: `lightbulb/mcp_generated_tools.py:220`.

### `brain_plan_domain_intelligence`

Namespace: `brain`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
brain_plan_domain_intelligence(message: str='', inputs: str='{}') -> str
~~~


Run the brain domain agent action `plan_domain_intelligence`.

Source: `lightbulb/mcp_generated_tools.py:286`.

### `brain_what_can_you_do`

Namespace: `brain`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
brain_what_can_you_do(message: str='', inputs: str='{}') -> str
~~~


Run the brain domain agent action `what_can_you_do`.

Source: `lightbulb/mcp_generated_tools.py:264`.

### `brain_where_is`

Namespace: `brain`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
brain_where_is(message: str='', inputs: str='{}') -> str
~~~


Run the brain domain agent action `where_is`.

Source: `lightbulb/mcp_generated_tools.py:242`.

### `clio_action_plan_create`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_action_plan_create(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Clio connector operation `action_plan_create` (platform tool `clio.action_plan_create`).

Source: `lightbulb/mcp_generated_tools.py:13926`.

### `clio_action_plan_submit`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_action_plan_submit(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Clio connector operation `action_plan_submit` (platform tool `clio.action_plan_submit`).

Source: `lightbulb/mcp_generated_tools.py:13971`.

### `clio_api_request`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_api_request(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Clio connector operation `api_request` (platform tool `clio.api_request`).

Source: `lightbulb/mcp_generated_tools.py:14016`.

### `clio_create_bill`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_create_bill(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Clio connector operation `create_bill` (platform tool `clio.create_bill`).

Source: `lightbulb/mcp_generated_tools.py:14061`.

### `clio_create_contact`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_create_contact(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Clio connector operation `create_contact` (platform tool `clio.create_contact`).

Source: `lightbulb/mcp_generated_tools.py:14106`.

### `clio_create_custom_action`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_create_custom_action(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Clio connector operation `create_custom_action` (platform tool `clio.create_custom_action`).

Source: `lightbulb/mcp_generated_tools.py:14151`.

### `clio_create_damage`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_create_damage(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Clio connector operation `create_damage` (platform tool `clio.create_damage`).

Source: `lightbulb/mcp_generated_tools.py:14196`.

### `clio_create_folder`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_create_folder(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Clio connector operation `create_folder` (platform tool `clio.create_folder`).

Source: `lightbulb/mcp_generated_tools.py:14241`.

### `clio_create_grant`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_create_grant(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Clio connector operation `create_grant` (platform tool `clio.create_grant`).

Source: `lightbulb/mcp_generated_tools.py:14286`.

### `clio_create_matter`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_create_matter(display_number: Optional[str]=None, description: Optional[str]=None, client_id: Optional[str]=None, practice_area_id: Optional[str]=None, *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Create a new Clio matter.

Source: `lightbulb/mcp_generated_tools.py:14331`.

### `clio_create_medical_records_detail`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_create_medical_records_detail(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Clio connector operation `create_medical_records_detail` (platform tool `clio.create_medical_records_detail`).

Source: `lightbulb/mcp_generated_tools.py:14371`.

### `clio_create_payment_link`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_create_payment_link(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Clio connector operation `create_payment_link` (platform tool `clio.create_payment_link`).

Source: `lightbulb/mcp_generated_tools.py:14416`.

### `clio_create_task`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_create_task(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Clio connector operation `create_task` (platform tool `clio.create_task`).

Source: `lightbulb/mcp_generated_tools.py:14461`.

### `clio_create_time_entry`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_create_time_entry(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Clio connector operation `create_time_entry` (platform tool `clio.create_time_entry`).

Source: `lightbulb/mcp_generated_tools.py:14506`.

### `clio_create_webhook`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_create_webhook(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Clio connector operation `create_webhook` (platform tool `clio.create_webhook`).

Source: `lightbulb/mcp_generated_tools.py:14551`.

### `clio_delete_custom_action`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_delete_custom_action(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Clio connector operation `delete_custom_action` (platform tool `clio.delete_custom_action`).

Source: `lightbulb/mcp_generated_tools.py:14596`.

### `clio_delete_damage`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_delete_damage(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Clio connector operation `delete_damage` (platform tool `clio.delete_damage`).

Source: `lightbulb/mcp_generated_tools.py:14641`.

### `clio_delete_grant`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_delete_grant(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Clio connector operation `delete_grant` (platform tool `clio.delete_grant`).

Source: `lightbulb/mcp_generated_tools.py:14686`.

### `clio_delete_medical_records_detail`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_delete_medical_records_detail(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Clio connector operation `delete_medical_records_detail` (platform tool `clio.delete_medical_records_detail`).

Source: `lightbulb/mcp_generated_tools.py:14731`.

### `clio_delete_webhook`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_delete_webhook(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Clio connector operation `delete_webhook` (platform tool `clio.delete_webhook`).

Source: `lightbulb/mcp_generated_tools.py:14776`.

### `clio_get_contact`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_get_contact(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Clio connector operation `get_contact` (platform tool `clio.get_contact`).

Source: `lightbulb/mcp_generated_tools.py:14821`.

### `clio_get_custom_action`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_get_custom_action(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Clio connector operation `get_custom_action` (platform tool `clio.get_custom_action`).

Source: `lightbulb/mcp_generated_tools.py:14866`.

### `clio_get_damage`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_get_damage(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Clio connector operation `get_damage` (platform tool `clio.get_damage`).

Source: `lightbulb/mcp_generated_tools.py:14911`.

### `clio_get_document`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_get_document(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Clio connector operation `get_document` (platform tool `clio.get_document`).

Source: `lightbulb/mcp_generated_tools.py:14956`.

### `clio_get_grant`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_get_grant(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Clio connector operation `get_grant` (platform tool `clio.get_grant`).

Source: `lightbulb/mcp_generated_tools.py:15001`.

### `clio_get_matter`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_get_matter(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Clio connector operation `get_matter` (platform tool `clio.get_matter`).

Source: `lightbulb/mcp_generated_tools.py:15046`.

### `clio_get_medical_records_detail`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_get_medical_records_detail(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Clio connector operation `get_medical_records_detail` (platform tool `clio.get_medical_records_detail`).

Source: `lightbulb/mcp_generated_tools.py:15091`.

### `clio_get_user`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_get_user(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Clio connector operation `get_user` (platform tool `clio.get_user`).

Source: `lightbulb/mcp_generated_tools.py:15136`.

### `clio_get_webhook`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_get_webhook(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Clio connector operation `get_webhook` (platform tool `clio.get_webhook`).

Source: `lightbulb/mcp_generated_tools.py:15181`.

### `clio_list_activities`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_list_activities(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Clio connector operation `list_activities` (platform tool `clio.list_activities`).

Source: `lightbulb/mcp_generated_tools.py:15226`.

### `clio_list_bills`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_list_bills(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Clio connector operation `list_bills` (platform tool `clio.list_bills`).

Source: `lightbulb/mcp_generated_tools.py:15271`.

### `clio_list_calendars`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_list_calendars(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Clio connector operation `list_calendars` (platform tool `clio.list_calendars`).

Source: `lightbulb/mcp_generated_tools.py:15316`.

### `clio_list_communications`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_list_communications(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Clio connector operation `list_communications` (platform tool `clio.list_communications`).

Source: `lightbulb/mcp_generated_tools.py:15361`.

### `clio_list_contacts`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_list_contacts(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Clio connector operation `list_contacts` (platform tool `clio.list_contacts`).

Source: `lightbulb/mcp_generated_tools.py:15406`.

### `clio_list_custom_actions`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_list_custom_actions(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Clio connector operation `list_custom_actions` (platform tool `clio.list_custom_actions`).

Source: `lightbulb/mcp_generated_tools.py:15451`.

### `clio_list_custom_fields`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_list_custom_fields(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Clio connector operation `list_custom_fields` (platform tool `clio.list_custom_fields`).

Source: `lightbulb/mcp_generated_tools.py:15496`.

### `clio_list_damages`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_list_damages(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Clio connector operation `list_damages` (platform tool `clio.list_damages`).

Source: `lightbulb/mcp_generated_tools.py:15541`.

### `clio_list_documents`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_list_documents(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Clio connector operation `list_documents` (platform tool `clio.list_documents`).

Source: `lightbulb/mcp_generated_tools.py:15586`.

### `clio_list_folders`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_list_folders(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Clio connector operation `list_folders` (platform tool `clio.list_folders`).

Source: `lightbulb/mcp_generated_tools.py:15631`.

### `clio_list_grants`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_list_grants(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Clio connector operation `list_grants` (platform tool `clio.list_grants`).

Source: `lightbulb/mcp_generated_tools.py:15676`.

### `clio_list_matters`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_list_matters(status: Optional[str]=None, client_id: Optional[str]=None, *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


List Clio matters for the connected firm.

Source: `lightbulb/mcp_generated_tools.py:15721`.

### `clio_list_medical_records_details`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_list_medical_records_details(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Clio connector operation `list_medical_records_details` (platform tool `clio.list_medical_records_details`).

Source: `lightbulb/mcp_generated_tools.py:15755`.

### `clio_list_notes`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_list_notes(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Clio connector operation `list_notes` (platform tool `clio.list_notes`).

Source: `lightbulb/mcp_generated_tools.py:15800`.

### `clio_list_payment_links`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_list_payment_links(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Clio connector operation `list_payment_links` (platform tool `clio.list_payment_links`).

Source: `lightbulb/mcp_generated_tools.py:15845`.

### `clio_list_payments`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_list_payments(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Clio connector operation `list_payments` (platform tool `clio.list_payments`).

Source: `lightbulb/mcp_generated_tools.py:15890`.

### `clio_list_practice_areas`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_list_practice_areas(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Clio connector operation `list_practice_areas` (platform tool `clio.list_practice_areas`).

Source: `lightbulb/mcp_generated_tools.py:15935`.

### `clio_list_tasks`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_list_tasks(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Clio connector operation `list_tasks` (platform tool `clio.list_tasks`).

Source: `lightbulb/mcp_generated_tools.py:15980`.

### `clio_list_time_entries`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_list_time_entries(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Clio connector operation `list_time_entries` (platform tool `clio.list_time_entries`).

Source: `lightbulb/mcp_generated_tools.py:16025`.

### `clio_list_users`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_list_users(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Clio connector operation `list_users` (platform tool `clio.list_users`).

Source: `lightbulb/mcp_generated_tools.py:16070`.

### `clio_list_webhooks`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_list_webhooks(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Clio connector operation `list_webhooks` (platform tool `clio.list_webhooks`).

Source: `lightbulb/mcp_generated_tools.py:16115`.

### `clio_request`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_request(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Clio connector operation `request` (platform tool `clio.request`).

Source: `lightbulb/mcp_generated_tools.py:16160`.

### `clio_review_only`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_review_only(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Clio connector operation `review_only` (platform tool `clio.review_only`).

Source: `lightbulb/mcp_generated_tools.py:16205`.

### `clio_search`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_search(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Clio connector operation `search` (platform tool `clio.search`).

Source: `lightbulb/mcp_generated_tools.py:16250`.

### `clio_update_custom_action`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_update_custom_action(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Clio connector operation `update_custom_action` (platform tool `clio.update_custom_action`).

Source: `lightbulb/mcp_generated_tools.py:16295`.

### `clio_update_damage`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_update_damage(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Clio connector operation `update_damage` (platform tool `clio.update_damage`).

Source: `lightbulb/mcp_generated_tools.py:16340`.

### `clio_update_grant`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_update_grant(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Clio connector operation `update_grant` (platform tool `clio.update_grant`).

Source: `lightbulb/mcp_generated_tools.py:16385`.

### `clio_update_matter`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_update_matter(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Clio connector operation `update_matter` (platform tool `clio.update_matter`).

Source: `lightbulb/mcp_generated_tools.py:16430`.

### `clio_update_medical_bill`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_update_medical_bill(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Clio connector operation `update_medical_bill` (platform tool `clio.update_medical_bill`).

Source: `lightbulb/mcp_generated_tools.py:16475`.

### `clio_update_medical_record`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_update_medical_record(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Clio connector operation `update_medical_record` (platform tool `clio.update_medical_record`).

Source: `lightbulb/mcp_generated_tools.py:16520`.

### `clio_update_medical_records_detail`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_update_medical_records_detail(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Clio connector operation `update_medical_records_detail` (platform tool `clio.update_medical_records_detail`).

Source: `lightbulb/mcp_generated_tools.py:16565`.

### `clio_update_webhook`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_update_webhook(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Clio connector operation `update_webhook` (platform tool `clio.update_webhook`).

Source: `lightbulb/mcp_generated_tools.py:16610`.

### `clio_upload_document`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_upload_document(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Clio connector operation `upload_document` (platform tool `clio.upload_document`).

Source: `lightbulb/mcp_generated_tools.py:16655`.

### `clio_who_am_i`

Namespace: `clio`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
clio_who_am_i(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Clio connector operation `who_am_i` (platform tool `clio.who_am_i`).

Source: `lightbulb/mcp_generated_tools.py:16700`.

### `coding_app_growth_loop_build`

Namespace: `coding`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
coding_app_growth_loop_build(message: str='', inputs: str='{}') -> str
~~~


Run the coding domain agent action `app_growth_loop_build`.

Source: `lightbulb/mcp_generated_tools.py:768`.

### `coding_build_codegraph`

Namespace: `coding`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
coding_build_codegraph(message: str='', inputs: str='{}') -> str
~~~


Run the coding domain agent action `build_codegraph`.

Source: `lightbulb/mcp_generated_tools.py:441`.

### `coding_build_page`

Namespace: `coding`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
coding_build_page(message: str='', inputs: str='{}') -> str
~~~


Run the coding domain agent action `build_page`.

Source: `lightbulb/mcp_generated_tools.py:702`.

### `coding_chat`

Namespace: `coding`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
coding_chat(message: str='', inputs: str='{}') -> str
~~~


Run the coding domain agent action `chat`.

Source: `lightbulb/mcp_generated_tools.py:308`.

### `coding_explain_code`

Namespace: `coding`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
coding_explain_code(message: str='', path: Optional[str]=None, audience: str='engineer') -> str
~~~


Explain how a piece of code works, why it's structured this way, and what its inputs/outputs are. Tunes depth to the requested audience.     Args:         message: Free-text objective for the action.         path (required): File path or symbol to explain.         audience: One of: engineer, junior, product, executive.

Source: `lightbulb/mcp_generated_tools.py:485`.

### `coding_format_code`

Namespace: `coding`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
coding_format_code(message: str='', inputs: str='{}') -> str
~~~


Run the coding domain agent action `format_code`.

Source: `lightbulb/mcp_generated_tools.py:548`.

### `coding_generate_tickets`

Namespace: `coding`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
coding_generate_tickets(message: str='', inputs: str='{}') -> str
~~~


Run the coding domain agent action `generate_tickets`.

Source: `lightbulb/mcp_generated_tools.py:570`.

### `coding_get_context`

Namespace: `coding`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
coding_get_context(message: str='', inputs: str='{}') -> str
~~~


Run the coding domain agent action `get_context`.

Source: `lightbulb/mcp_generated_tools.py:463`.

### `coding_git_status`

Namespace: `coding`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
coding_git_status(message: str='', inputs: str='{}') -> str
~~~


Run the coding domain agent action `git_status`.

Source: `lightbulb/mcp_generated_tools.py:526`.

### `coding_growth_loop_web_development`

Namespace: `coding`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
coding_growth_loop_web_development(message: str='', inputs: str='{}') -> str
~~~


Run the coding domain agent action `growth_loop_web_development`.

Source: `lightbulb/mcp_generated_tools.py:790`.

### `coding_page_builder_web_development`

Namespace: `coding`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
coding_page_builder_web_development(message: str='', inputs: str='{}') -> str
~~~


Run the coding domain agent action `page_builder_web_development`.

Source: `lightbulb/mcp_generated_tools.py:724`.

### `coding_plan_domain_intelligence`

Namespace: `coding`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
coding_plan_domain_intelligence(message: str='', inputs: str='{}') -> str
~~~


Run the coding domain agent action `plan_domain_intelligence`.

Source: `lightbulb/mcp_generated_tools.py:812`.

### `coding_prioritize_backlog`

Namespace: `coding`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
coding_prioritize_backlog(message: str='', inputs: str='{}') -> str
~~~


Run the coding domain agent action `prioritize_backlog`.

Source: `lightbulb/mcp_generated_tools.py:592`.

### `coding_process_single_ticket`

Namespace: `coding`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
coding_process_single_ticket(message: str='', inputs: str='{}') -> str
~~~


Run the coding domain agent action `process_single_ticket`.

Source: `lightbulb/mcp_generated_tools.py:636`.

### `coding_process_ticket_with_branch`

Namespace: `coding`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
coding_process_ticket_with_branch(message: str='', inputs: str='{}') -> str
~~~


Run the coding domain agent action `process_ticket_with_branch`.

Source: `lightbulb/mcp_generated_tools.py:658`.

### `coding_propose_changes`

Namespace: `coding`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
coding_propose_changes(message: str='', inputs: str='{}') -> str
~~~


Run the coding domain agent action `propose_changes`.

Source: `lightbulb/mcp_generated_tools.py:504`.

### `coding_read_code`

Namespace: `coding`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
coding_read_code(message: str='', inputs: str='{}') -> str
~~~


Run the coding domain agent action `read_code`.

Source: `lightbulb/mcp_generated_tools.py:330`.

### `coding_run_command`

Namespace: `coding`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
coding_run_command(message: str='', inputs: str='{}') -> str
~~~


Run the coding domain agent action `run_command`.

Source: `lightbulb/mcp_generated_tools.py:397`.

### `coding_run_pipeline`

Namespace: `coding`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
coding_run_pipeline(message: str='', inputs: str='{}') -> str
~~~


Run the coding domain agent action `run_pipeline`.

Source: `lightbulb/mcp_generated_tools.py:614`.

### `coding_run_tests`

Namespace: `coding`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
coding_run_tests(message: str='', inputs: str='{}') -> str
~~~


Run the coding domain agent action `run_tests`.

Source: `lightbulb/mcp_generated_tools.py:419`.

### `coding_search`

Namespace: `coding`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
coding_search(message: str='', inputs: str='{}') -> str
~~~


Run the coding domain agent action `search`.

Source: `lightbulb/mcp_generated_tools.py:375`.

### `coding_watch_slack`

Namespace: `coding`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
coding_watch_slack(message: str='', inputs: str='{}') -> str
~~~


Run the coding domain agent action `watch_slack`.

Source: `lightbulb/mcp_generated_tools.py:680`.

### `coding_website_growth_loop_build`

Namespace: `coding`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
coding_website_growth_loop_build(message: str='', inputs: str='{}') -> str
~~~


Run the coding domain agent action `website_growth_loop_build`.

Source: `lightbulb/mcp_generated_tools.py:746`.

### `coding_write_code`

Namespace: `coding`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
coding_write_code(message: str='', brief: Optional[str]=None, repo_path: Optional[str]=None, run_tests: bool=True) -> str
~~~


Plan and implement a code change end-to-end. Reads the relevant files, designs the change, writes the code, and runs tests. Returns a diff summary and test results.     Args:         message: Free-text objective for the action.         brief (required): Plain-English description of the desired change.         repo_path: Workspace-relative path to scope the change.         run_tests: Run the test suite after the change.

Source: `lightbulb/mcp_generated_tools.py:352`.

### `commerce_ab_test`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_ab_test(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `ab_test`.

Source: `lightbulb/mcp_generated_tools.py:1406`.

### `commerce_assortment_gap_analysis`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_assortment_gap_analysis(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `assortment_gap_analysis`.

Source: `lightbulb/mcp_generated_tools.py:1120`.

### `commerce_campaign_brief`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_campaign_brief(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `campaign_brief`.

Source: `lightbulb/mcp_generated_tools.py:1340`.

### `commerce_cash_position`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_cash_position(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `cash_position`.

Source: `lightbulb/mcp_generated_tools.py:1604`.

### `commerce_catalog_sync`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_catalog_sync(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `catalog_sync`.

Source: `lightbulb/mcp_generated_tools.py:1164`.

### `commerce_category_landscape`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_category_landscape(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `category_landscape`.

Source: `lightbulb/mcp_generated_tools.py:1032`.

### `commerce_chat`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_chat(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `chat`.

Source: `lightbulb/mcp_generated_tools.py:834`.

### `commerce_competitor_watchlist`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_competitor_watchlist(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `competitor_watchlist`.

Source: `lightbulb/mcp_generated_tools.py:1076`.

### `commerce_connector_health_summary`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_connector_health_summary(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `connector_health_summary`.

Source: `lightbulb/mcp_generated_tools.py:2022`.

### `commerce_contract_to_pay`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_contract_to_pay(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `contract_to_pay`.

Source: `lightbulb/mcp_generated_tools.py:1890`.

### `commerce_converse`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_converse(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `converse`.

Source: `lightbulb/mcp_generated_tools.py:856`.

### `commerce_cross_agent_insight`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_cross_agent_insight(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `cross_agent_insight`.

Source: `lightbulb/mcp_generated_tools.py:1384`.

### `commerce_customer_360`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_customer_360(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `customer_360`.

Source: `lightbulb/mcp_generated_tools.py:1450`.

### `commerce_customer_profile`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_customer_profile(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `customer_profile`.

Source: `lightbulb/mcp_generated_tools.py:1274`.

### `commerce_customer_segment`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_customer_segment(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `customer_segment`.

Source: `lightbulb/mcp_generated_tools.py:1252`.

### `commerce_customer_value_summary`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_customer_value_summary(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `customer_value_summary`.

Source: `lightbulb/mcp_generated_tools.py:1648`.

### `commerce_dashboard_summary`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_dashboard_summary(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `dashboard_summary`.

Source: `lightbulb/mcp_generated_tools.py:1560`.

### `commerce_demand_forecast`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_demand_forecast(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `demand_forecast`.

Source: `lightbulb/mcp_generated_tools.py:1956`.

### `commerce_economic_context`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_economic_context(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `economic_context`.

Source: `lightbulb/mcp_generated_tools.py:1670`.

### `commerce_external_market_research`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_external_market_research(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `external_market_research`.

Source: `lightbulb/mcp_generated_tools.py:1010`.

### `commerce_inventory_check`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_inventory_check(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `inventory_check`.

Source: `lightbulb/mcp_generated_tools.py:1186`.

### `commerce_inventory_valuation`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_inventory_valuation(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `inventory_valuation`.

Source: `lightbulb/mcp_generated_tools.py:1516`.

### `commerce_knowledge_build`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_knowledge_build(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `knowledge_build`.

Source: `lightbulb/mcp_generated_tools.py:878`.

### `commerce_margin_analysis`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_margin_analysis(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `margin_analysis`.

Source: `lightbulb/mcp_generated_tools.py:1494`.

### `commerce_market_observation_ingest`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_market_observation_ingest(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `market_observation_ingest`.

Source: `lightbulb/mcp_generated_tools.py:966`.

### `commerce_market_observation_query`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_market_observation_query(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `market_observation_query`.

Source: `lightbulb/mcp_generated_tools.py:988`.

### `commerce_order_to_invoice`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_order_to_invoice(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `order_to_invoice`.

Source: `lightbulb/mcp_generated_tools.py:1428`.

### `commerce_personalize_campaign`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_personalize_campaign(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `personalize_campaign`.

Source: `lightbulb/mcp_generated_tools.py:1318`.

### `commerce_plan_domain_intelligence`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_plan_domain_intelligence(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `plan_domain_intelligence`.

Source: `lightbulb/mcp_generated_tools.py:2132`.

### `commerce_po_approval_workflow`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_po_approval_workflow(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `po_approval_workflow`.

Source: `lightbulb/mcp_generated_tools.py:1846`.

### `commerce_predict`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_predict(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `predict`.

Source: `lightbulb/mcp_generated_tools.py:1296`.

### `commerce_price_optimization_run`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_price_optimization_run(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `price_optimization_run`.

Source: `lightbulb/mcp_generated_tools.py:2000`.

### `commerce_pricing_intelligence`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_pricing_intelligence(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `pricing_intelligence`.

Source: `lightbulb/mcp_generated_tools.py:1230`.

### `commerce_pricing_landscape`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_pricing_landscape(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `pricing_landscape`.

Source: `lightbulb/mcp_generated_tools.py:1054`.

### `commerce_procurement_brief`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_procurement_brief(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `procurement_brief`.

Source: `lightbulb/mcp_generated_tools.py:1692`.

### `commerce_product_analysis`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_product_analysis(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `product_analysis`.

Source: `lightbulb/mcp_generated_tools.py:1208`.

### `commerce_product_graph_query`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_product_graph_query(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `product_graph_query`.

Source: `lightbulb/mcp_generated_tools.py:1362`.

### `commerce_reconcile_refunds`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_reconcile_refunds(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `reconcile_refunds`.

Source: `lightbulb/mcp_generated_tools.py:1538`.

### `commerce_resume_sync`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_resume_sync(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `resume_sync`.

Source: `lightbulb/mcp_generated_tools.py:944`.

### `commerce_revenue_by_channel`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_revenue_by_channel(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `revenue_by_channel`.

Source: `lightbulb/mcp_generated_tools.py:1582`.

### `commerce_revenue_by_product`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_revenue_by_product(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `revenue_by_product`.

Source: `lightbulb/mcp_generated_tools.py:1472`.

### `commerce_service_catalog`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_service_catalog(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `service_catalog`.

Source: `lightbulb/mcp_generated_tools.py:1142`.

### `commerce_sourcing_brief`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_sourcing_brief(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `sourcing_brief`.

Source: `lightbulb/mcp_generated_tools.py:1802`.

### `commerce_spend_analysis`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_spend_analysis(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `spend_analysis`.

Source: `lightbulb/mcp_generated_tools.py:1912`.

### `commerce_storefront_products_sync`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_storefront_products_sync(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `storefront_products_sync`.

Source: `lightbulb/mcp_generated_tools.py:2066`.

### `commerce_storefront_publish`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_storefront_publish(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `storefront_publish`.

Source: `lightbulb/mcp_generated_tools.py:2088`.

### `commerce_storefront_setup`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_storefront_setup(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `storefront_setup`.

Source: `lightbulb/mcp_generated_tools.py:2044`.

### `commerce_storefront_status`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_storefront_status(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `storefront_status`.

Source: `lightbulb/mcp_generated_tools.py:2110`.

### `commerce_supplier_evaluation`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_supplier_evaluation(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `supplier_evaluation`.

Source: `lightbulb/mcp_generated_tools.py:1868`.

### `commerce_supplier_search`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_supplier_search(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `supplier_search`.

Source: `lightbulb/mcp_generated_tools.py:1714`.

### `commerce_supply_chain_analysis`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_supply_chain_analysis(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `supply_chain_analysis`.

Source: `lightbulb/mcp_generated_tools.py:1780`.

### `commerce_sync_history`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_sync_history(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `sync_history`.

Source: `lightbulb/mcp_generated_tools.py:922`.

### `commerce_sync_status`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_sync_status(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `sync_status`.

Source: `lightbulb/mcp_generated_tools.py:900`.

### `commerce_tariff_lookup`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_tariff_lookup(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `tariff_lookup`.

Source: `lightbulb/mcp_generated_tools.py:1758`.

### `commerce_top_products_by_margin`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_top_products_by_margin(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `top_products_by_margin`.

Source: `lightbulb/mcp_generated_tools.py:1626`.

### `commerce_trade_flow_lookup`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_trade_flow_lookup(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `trade_flow_lookup`.

Source: `lightbulb/mcp_generated_tools.py:1736`.

### `commerce_transaction_anomaly_scan`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_transaction_anomaly_scan(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `transaction_anomaly_scan`.

Source: `lightbulb/mcp_generated_tools.py:1978`.

### `commerce_trend_synthesis`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_trend_synthesis(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `trend_synthesis`.

Source: `lightbulb/mcp_generated_tools.py:1098`.

### `commerce_vendor_onboarding`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_vendor_onboarding(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `vendor_onboarding`.

Source: `lightbulb/mcp_generated_tools.py:1824`.

### `commerce_vendor_risk_assessment`

Namespace: `commerce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
commerce_vendor_risk_assessment(message: str='', inputs: str='{}') -> str
~~~


Run the commerce domain agent action `vendor_risk_assessment`.

Source: `lightbulb/mcp_generated_tools.py:1934`.

### `content_analyze_results`

Namespace: `content`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
content_analyze_results(message: str='', inputs: str='{}') -> str
~~~


Run the content domain agent action `analyze_results`.

Source: `lightbulb/mcp_generated_tools.py:2462`.

### `content_anonymity_guard`

Namespace: `content`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
content_anonymity_guard(message: str='', inputs: str='{}') -> str
~~~


Run the content domain agent action `anonymity_guard`.

Source: `lightbulb/mcp_generated_tools.py:2528`.

### `content_chat`

Namespace: `content`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
content_chat(message: str='', inputs: str='{}') -> str
~~~


Run the content domain agent action `chat`.

Source: `lightbulb/mcp_generated_tools.py:2154`.

### `content_competitor_analysis`

Namespace: `content`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
content_competitor_analysis(message: str='', inputs: str='{}') -> str
~~~


Run the content domain agent action `competitor_analysis`.

Source: `lightbulb/mcp_generated_tools.py:2308`.

### `content_dispatch`

Namespace: `content`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
content_dispatch(message: str='', inputs: str='{}') -> str
~~~


Run the content domain agent action `dispatch`.

Source: `lightbulb/mcp_generated_tools.py:2418`.

### `content_evolve_strategy`

Namespace: `content`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
content_evolve_strategy(message: str='', inputs: str='{}') -> str
~~~


Run the content domain agent action `evolve_strategy`.

Source: `lightbulb/mcp_generated_tools.py:2352`.

### `content_full_campaign`

Namespace: `content`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
content_full_campaign(message: str='', inputs: str='{}') -> str
~~~


Run the content domain agent action `full_campaign`.

Source: `lightbulb/mcp_generated_tools.py:2484`.

### `content_generate_content`

Namespace: `content`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
content_generate_content(message: str='', inputs: str='{}') -> str
~~~


Run the content domain agent action `generate_content`.

Source: `lightbulb/mcp_generated_tools.py:2198`.

### `content_generate_plan`

Namespace: `content`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
content_generate_plan(message: str='', inputs: str='{}') -> str
~~~


Run the content domain agent action `generate_plan`.

Source: `lightbulb/mcp_generated_tools.py:2176`.

### `content_generate_variants`

Namespace: `content`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
content_generate_variants(message: str='', inputs: str='{}') -> str
~~~


Run the content domain agent action `generate_variants`.

Source: `lightbulb/mcp_generated_tools.py:2440`.

### `content_plan_domain_intelligence`

Namespace: `content`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
content_plan_domain_intelligence(message: str='', inputs: str='{}') -> str
~~~


Run the content domain agent action `plan_domain_intelligence`.

Source: `lightbulb/mcp_generated_tools.py:2550`.

### `content_prepare_publish`

Namespace: `content`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
content_prepare_publish(message: str='', inputs: str='{}') -> str
~~~


Run the content domain agent action `prepare_publish`.

Source: `lightbulb/mcp_generated_tools.py:2242`.

### `content_refine`

Namespace: `content`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
content_refine(message: str='', inputs: str='{}') -> str
~~~


Run the content domain agent action `refine`.

Source: `lightbulb/mcp_generated_tools.py:2220`.

### `content_repurpose`

Namespace: `content`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
content_repurpose(message: str='', inputs: str='{}') -> str
~~~


Run the content domain agent action `repurpose`.

Source: `lightbulb/mcp_generated_tools.py:2374`.

### `content_schedule`

Namespace: `content`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
content_schedule(message: str='', inputs: str='{}') -> str
~~~


Run the content domain agent action `schedule`.

Source: `lightbulb/mcp_generated_tools.py:2396`.

### `content_seo_optimize`

Namespace: `content`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
content_seo_optimize(message: str='', inputs: str='{}') -> str
~~~


Run the content domain agent action `seo_optimize`.

Source: `lightbulb/mcp_generated_tools.py:2286`.

### `content_seo_research`

Namespace: `content`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
content_seo_research(message: str='', inputs: str='{}') -> str
~~~


Run the content domain agent action `seo_research`.

Source: `lightbulb/mcp_generated_tools.py:2264`.

### `content_social_content_pipeline`

Namespace: `content`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
content_social_content_pipeline(message: str='', inputs: str='{}') -> str
~~~


Run the content domain agent action `social_content_pipeline`.

Source: `lightbulb/mcp_generated_tools.py:2506`.

### `content_sync_analytics`

Namespace: `content`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
content_sync_analytics(message: str='', inputs: str='{}') -> str
~~~


Run the content domain agent action `sync_analytics`.

Source: `lightbulb/mcp_generated_tools.py:2330`.

### `activate_agent_marketplace_action`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
activate_agent_marketplace_action(installation_id: str, idempotency_key: str) -> str
~~~


Activate an installation while leaving HITL and entitlement checks intact.

Source: `lightbulb/mcp_server.py:5204`.

### `approve_task`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
approve_task(task_id: str, comments: str='') -> str
~~~


Approve a pending HITL task, allowing the agent workflow to continue.

Source: `lightbulb/mcp_server.py:8507`.

### `approve_voice_action`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
approve_voice_action(execution_id: str, approval_task_id: str, comments: str='') -> str
~~~


Approve a pending in-call voice action.

Source: `lightbulb/mcp_server.py:9853`.

### `archive_agent_marketplace_action`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
archive_agent_marketplace_action(listing_id: str, idempotency_key: str, reason: str='') -> str
~~~


Archive a publisher-owned marketplace listing idempotently.

Source: `lightbulb/mcp_server.py:5115`.

### `ask_document_agent`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
ask_document_agent(message: str, action: str='chat') -> str
~~~


Send a message to the document intelligence agent.

Source: `lightbulb/mcp_server.py:3949`.

### `author_agentic_workflow`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
author_agentic_workflow(prompt: str, name: str='', workflow_type: str='', preferred_domains: str='', publish: bool=False) -> str
~~~


Create an agentic workflow artifact from a prompt.

Source: `lightbulb/mcp_server.py:7787`.

### `author_workflow_trigger`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
author_workflow_trigger(workflow_definition_id: str, trigger_type: str='schedule', schedule: str='', event_type: str='', event_filter: str='{}', name: str='', description: str='', site_project_id: str='', configuration: str='{}', enabled: bool=False) -> str
~~~


Create a governed schedule or event trigger for an authored workflow.

Source: `lightbulb/mcp_server.py:7829`.

### `backbone_execute`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
backbone_execute(objective: str, inputs: str='{}') -> str
~~~


Execute a research, analysis, or code generation task via the backbone agent.

Source: `lightbulb/mcp_server.py:4526`.

### `bind_project_mission_action`

Namespace: `core`. Kind: `curated`. Policy annotations: `_PROJECT_GAME_APPEND_ONLY_ANNOTATIONS`.



~~~python
bind_project_mission_action(project_id: str, mission_run_receipt_id: str, action_event_id: str, binding_id: str='', note: str='', confirm_bind: bool=False) -> str
~~~


Bind one later same-project action event to a locked mission briefing.

Source: `lightbulb/mcp_server.py:2967`.

### `business_classify_reply`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
business_classify_reply(reply_text: str, thread_context: str='{}', taxonomy: str='[]', confidence_threshold: float=0.75, channel: str='email') -> str
~~~


Classify an inbound reply and propose a governed next workflow event.

Source: `lightbulb/mcp_server.py:7047`.

### `business_create_invoice`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
business_create_invoice(provider: str='', customer_name: str='', customer_id: str='', line_items: str='[]', amount: float=0.0, currency: str='USD', due_date: str='', reference: str='', memo: str='', preview_only: bool=True) -> str
~~~


Create or stage a customer invoice as a Lightbulb business primitive.

Source: `lightbulb/mcp_server.py:6966`.

### `business_draft_contract`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
business_draft_contract(document_type: str, brief: str, counterparty: str='', jurisdiction: str='', playbook: str='', context: str='{}', preview_only: bool=True) -> str
~~~


Draft a contract or legal document packet as a business primitive.

Source: `lightbulb/mcp_server.py:7091`.

### `business_review_contract`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
business_review_contract(contract_url: str, playbook: str='', counterparty_name: str='', focus: str='', context: str='{}') -> str
~~~


Review a contract against a playbook as a business primitive.

Source: `lightbulb/mcp_server.py:7127`.

### `business_schedule_meeting`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
business_schedule_meeting(attendees: str='[]', title: str='', time_window: str='', duration_minutes: int=30, agenda: str='', preview_only: bool=True) -> str
~~~


Propose or schedule a meeting with calendar response tracking guidance.

Source: `lightbulb/mcp_server.py:7161`.

### `business_write_email`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
business_write_email(to: str='', subject: str='', body: str='', intent: str='', tone: str='', send: bool=False, context: str='{}', preview_only: bool=True) -> str
~~~


Draft or send an email with reply capture and thread context guidance.

Source: `lightbulb/mcp_server.py:7008`.

### `cancel_codex_account_link`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
cancel_codex_account_link(session_id: str) -> str
~~~


Cancel a Codex account-link device-auth session.

Source: `lightbulb/mcp_server.py:6956`.

### `cancel_recursive_agent_execution`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
cancel_recursive_agent_execution(execution_id: str) -> str
~~~


Fence one exact user-owned recursive tree from further work.

Source: `lightbulb/mcp_server.py:4643`.

### `cancel_workflow_run`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
cancel_workflow_run(workflow_run_ref: str) -> str
~~~


Stop a scoped running or approval-waiting workflow to bound cost and work.

Source: `lightbulb/mcp_server.py:7778`.

### `code_workspace_add_collaborator`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
code_workspace_add_collaborator(workspace_id: str, email: str='', user_id: str='', role: str='viewer') -> str
~~~


Add a collaborator to a workspace (role: viewer | editor | admin).

Source: `lightbulb/mcp_server.py:10010`.

### `code_workspace_add_note`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
code_workspace_add_note(workspace_id: str, content: str) -> str
~~~


Append a note to a workspace (visible to collaborators).

Source: `lightbulb/mcp_server.py:10108`.

### `code_workspace_approve_access_request`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
code_workspace_approve_access_request(workspace_id: str, request_id: str) -> str
~~~


Approve a pending access request.

Source: `lightbulb/mcp_server.py:10084`.

### `code_workspace_cancel_run`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
code_workspace_cancel_run(workspace_id: str, run_id: str) -> str
~~~


Cancel an in-flight coding run.

Source: `lightbulb/mcp_server.py:10228`.

### `code_workspace_chat`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
code_workspace_chat(workspace_id: str, message: str, action: str='chat', conversation_id: str='', active_file: str='', history: str='[]', attachments: str='[]', context: str='{}', policy: str='{}', preview_mode: bool=False, auto_push: bool=False, max_tool_loops: int=8, max_cost_usd: float | None=None, max_total_tokens: int | None=None, idempotency_key: str='', agent_model_selection_id: str='', agent_provider_connection_id: str='', agent_model_id: str='', agent_model_profile_id: str='', coding_harness: str='') -> str
~~~


Send a message to a code workspace — ask it to write code, run commands, analyze files.

Source: `lightbulb/mcp_server.py:7433`.

### `code_workspace_claude_session_action`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
code_workspace_claude_session_action(workspace_id: str, session_id: str, action: str, body: str='{}') -> str
~~~


Perform a Claude SDK session action.

Source: `lightbulb/mcp_server.py:10260`.

### `code_workspace_claude_sessions`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
code_workspace_claude_sessions(workspace_id: str) -> str
~~~


List Claude SDK sessions associated with a workspace.

Source: `lightbulb/mcp_server.py:10241`.

### `code_workspace_codex_thread_action`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
code_workspace_codex_thread_action(workspace_id: str, thread_id: str, action: str, body: str='{}') -> str
~~~


Perform a thread-level Codex action.

Source: `lightbulb/mcp_server.py:10309`.

### `code_workspace_codex_threads`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
code_workspace_codex_threads(workspace_id: str, archived: str='') -> str
~~~


List Codex runtime threads for a workspace.

Source: `lightbulb/mcp_server.py:10287`.

### `code_workspace_codex_turn_action`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
code_workspace_codex_turn_action(workspace_id: str, thread_id: str, turn_id: str, action: str, body: str='{}') -> str
~~~


Steer or interrupt a specific Codex turn.

Source: `lightbulb/mcp_server.py:10332`.

### `code_workspace_collaboration`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
code_workspace_collaboration(workspace_id: str) -> str
~~~


Get collaboration info (members, share-links, pending requests).

Source: `lightbulb/mcp_server.py:10000`.

### `code_workspace_create_share_link`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
code_workspace_create_share_link(workspace_id: str, role: str='viewer', expires_in_seconds: int=0) -> str
~~~


Create a share-link token granting access to the workspace.

Source: `lightbulb/mcp_server.py:10057`.

### `code_workspace_deny_access_request`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
code_workspace_deny_access_request(workspace_id: str, request_id: str) -> str
~~~


Deny a pending access request.

Source: `lightbulb/mcp_server.py:10096`.

### `code_workspace_get_active_run`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
code_workspace_get_active_run(workspace_id: str) -> str
~~~


Get the active coding run for a workspace, if one exists.

Source: `lightbulb/mcp_server.py:7585`.

### `code_workspace_get_run`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
code_workspace_get_run(workspace_id: str, run_id: str) -> str
~~~


Get the details for a specific coding run.

Source: `lightbulb/mcp_server.py:7598`.

### `code_workspace_proposal_apply`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
code_workspace_proposal_apply(workspace_id: str, proposal_id: str) -> str
~~~


Apply a code-change proposal to workspace files.

Source: `lightbulb/mcp_server.py:10193`.

### `code_workspace_proposal_reject`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
code_workspace_proposal_reject(workspace_id: str, proposal_id: str, reason: str='') -> str
~~~


Reject a code-change proposal.

Source: `lightbulb/mcp_server.py:10203`.

### `code_workspace_proposals`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
code_workspace_proposals(workspace_id: str) -> str
~~~


List code-change proposals for a workspace.

Source: `lightbulb/mcp_server.py:10174`.

### `code_workspace_pull_request`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
code_workspace_pull_request(workspace_id: str, body: str='{}') -> str
~~~


Open a GitHub pull request from the workspace branch.

Source: `lightbulb/mcp_server.py:10217`.

### `code_workspace_remove_collaborator`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
code_workspace_remove_collaborator(workspace_id: str, collaborator_id: str) -> str
~~~


Revoke a collaborator's access.

Source: `lightbulb/mcp_server.py:10046`.

### `code_workspace_revoke_share_link`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
code_workspace_revoke_share_link(workspace_id: str, link_id: str) -> str
~~~


Revoke a share link.

Source: `lightbulb/mcp_server.py:10073`.

### `code_workspace_run_review`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
code_workspace_run_review(workspace_id: str, run_id: str, verdict: str, feedback: str='') -> str
~~~


Submit a human review verdict for a run (accept | reject | request_changes).

Source: `lightbulb/mcp_server.py:10150`.

### `code_workspace_run_review_apply`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
code_workspace_run_review_apply(workspace_id: str, run_id: str) -> str
~~~


Apply review-suggested changes to the workspace.

Source: `lightbulb/mcp_server.py:10164`.

### `code_workspace_runs`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
code_workspace_runs(workspace_id: str, limit: int=20) -> str
~~~


List historical coding runs for a workspace.

Source: `lightbulb/mcp_server.py:10121`.

### `code_workspace_runs_insights`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
code_workspace_runs_insights(workspace_id: str) -> str
~~~


Aggregate run-quality insights for a workspace.

Source: `lightbulb/mcp_server.py:10140`.

### `code_workspace_update_collaborator`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
code_workspace_update_collaborator(workspace_id: str, collaborator_id: str, role: str) -> str
~~~


Change a collaborator's role.

Source: `lightbulb/mcp_server.py:10032`.

### `code_workspace_wait_for_run`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
code_workspace_wait_for_run(workspace_id: str, run_id: str='', timeout_seconds: int=60, poll_interval_seconds: int=2) -> str
~~~


Wait for a coding run to finish and return its latest status.

Source: `lightbulb/mcp_server.py:7609`.

### `compile_business_workflow`

Namespace: `core`. Kind: `curated`. Policy annotations: `ToolAnnotations(readOnlyHint=True, destructiveHint=False, idempotentHint=True, openWorldHint=False)`.



~~~python
compile_business_workflow(objective: str, primitive_ids: str='', workflow_name: str='', workflow_type: str='', trigger_event: str='', owner_role: str='workflow_owner', loop: bool=False, max_iterations: int | None=None, inputs: str='{}') -> str
~~~


Compile a portable workflow draft from Lightbulb business primitives.

Source: `lightbulb/mcp_server.py:6238`.

### `compose_business_workflow`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
compose_business_workflow(objective: str, primitive_ids: str='', workflow_name: str='', workflow_type: str='', trigger_event: str='', owner_role: str='workflow_owner', loop: bool=False, max_iterations: int | None=None, publish: bool=False, inputs: str='{}') -> str
~~~


Draft an Agent Builder workflow from business primitives.

Source: `lightbulb/mcp_server.py:6720`.

### `configure_backbone_agent_surface`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
configure_backbone_agent_surface(backbone_surface: str, model_provider: str='', model_id: str='', provider_connection_id: str='', scope: str='USER', request_overrides: str='{}') -> str
~~~


Configure the preferred Backbone host surface, such as ChatGPT MCP.

Source: `lightbulb/mcp_server.py:6889`.

### `configure_coding_agent_runtime`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
configure_coding_agent_runtime(runtime_backend: str, model_provider: str='', model_id: str='', provider_connection_id: str='', use_codex_account: bool=False, scope: str='USER', request_overrides: str='{}') -> str
~~~


Configure Codex or Claude Code as the Lightbulb coding agent runtime.

Source: `lightbulb/mcp_server.py:6841`.

### `context_checkpoint`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
context_checkpoint(space_ref: str, session_ref: str, base_revision: int, idempotency_key: str, events_json: str='[]', state_json: str='{}', company_ref: str='', project_ref: str='') -> str
~~~


Checkpoint host deltas and structured task state durably.

Source: `lightbulb/mcp_server.py:9133`.

### `context_open`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
context_open(host: str, host_session_ref: str='', model: str='', space_ref: str='', token_budget: int=2400, query: str='', repository_json: str='{}', company_ref: str='', project_ref: str='') -> str
~~~


Open or resume durable private working context for this host session.

Source: `lightbulb/mcp_server.py:8975`.

### `context_pack`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
context_pack(space_ref: str, session_ref: str='', query: str='', token_budget: int=2400, max_items: int=12, company_ref: str='', project_ref: str='') -> str
~~~


Load a ranked working pack from a Lightbulb Context Space.

Source: `lightbulb/mcp_server.py:9032`.

### `context_read`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
context_read(space_ref: str, refs_json: str, token_budget: int=2400, company_ref: str='', project_ref: str='') -> str
~~~


Read exact context items by opaque refs returned from pack or search.

Source: `lightbulb/mcp_server.py:9104`.

### `context_search`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
context_search(space_ref: str, query: str, token_budget: int=2400, max_items: int=10, kinds_json: str='', company_ref: str='', project_ref: str='') -> str
~~~


Search durable context when the current pack lacks specific evidence.

Source: `lightbulb/mcp_server.py:9067`.

### `context_status`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
context_status(space_ref: str, session_ref: str='', company_ref: str='', project_ref: str='') -> str
~~~


Inspect Context Space size, revision, scope, and host binding status.

Source: `lightbulb/mcp_server.py:9178`.

### `create_account_shell_customization_draft`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
create_account_shell_customization_draft(document: str, base_revision_id: str='') -> str
~~~


Create a governed account-shell draft from an exact base revision.

Source: `lightbulb/mcp_server.py:4768`.

### `create_approval_auto_accept`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
create_approval_auto_accept(task_id: str, body: str='{}') -> str
~~~


Create an auto-accept rule from an existing approval task's shape.

Source: `lightbulb/mcp_server.py:10800`.

### `create_crm_task`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
create_crm_task(body: str, tenant_id: str='') -> str
~~~


Create a CRM task. Body is JSON (title, status, assigneeId, dueDate, contactId, dealId, ...).

Source: `lightbulb/mcp_server.py:10743`.

### `create_document`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
create_document(title: str, body: str, format: str='docx', target_suite: str='internal_library') -> str
~~~


Create a new document (report, memo, brief, etc.).

Source: `lightbulb/mcp_server.py:3886`.

### `create_project_from_preflight`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
create_project_from_preflight(receipt_json: str, coding_harness: str, confirm_create: bool=False, confirm_open_questions: bool=False, workspace_id: str='', repo_connection_id: str='', idempotency_key: str='', play_style: str='') -> str
~~~


Create the exact project draft in a preflight receipt after confirmation.

Source: `lightbulb/mcp_server.py:3625`.

### `create_slide_deck`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
create_slide_deck(title: str, body: str='', target_suite: str='internal_library') -> str
~~~


Create a new presentation / slide deck.

Source: `lightbulb/mcp_server.py:3929`.

### `create_spreadsheet`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
create_spreadsheet(title: str, body: str='', target_suite: str='internal_library') -> str
~~~


Create a new spreadsheet.

Source: `lightbulb/mcp_server.py:3909`.

### `decide_workflow_improvement_packet`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
decide_workflow_improvement_packet(packet_id: str, approval_scope: str, decision: str, rationale: str='', evidence: str='{}') -> str
~~~


Record one immutable human decision for implementation, publish, or deploy.

Source: `lightbulb/mcp_server.py:6567`.

### `delete_approval_preference`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
delete_approval_preference(preference_id: str) -> str
~~~


Remove an auto-accept rule.

Source: `lightbulb/mcp_server.py:10811`.

### `delete_crm_task`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
delete_crm_task(task_id: str, tenant_id: str='') -> str
~~~


Delete a CRM task.

Source: `lightbulb/mcp_server.py:10767`.

### `describe_anatomy`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
describe_anatomy(kind: str='', id: str='') -> str
~~~


Introspect the Company Brain's own anatomy (services, data-stores, domains, actions).

Source: `lightbulb/mcp_server.py:3969`.

### `dispatch_domain_agent`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
dispatch_domain_agent(domain: str, message: str, action: str='chat', inputs: str='{}') -> str
~~~


Dispatch a message to any domain agent on the platform.

Source: `lightbulb/mcp_server.py:4039`.

### `doc_builder_add_collaborator`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
doc_builder_add_collaborator(session_id: str, email: str='', user_id: str='', role: str='viewer') -> str
~~~


Add a collaborator to a document builder session.

Source: `lightbulb/mcp_server.py:11035`.

### `doc_builder_collaboration`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
doc_builder_collaboration(session_id: str) -> str
~~~


Collaboration info for a document builder session.

Source: `lightbulb/mcp_server.py:11025`.

### `doc_builder_create_share_link`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
doc_builder_create_share_link(session_id: str, role: str='viewer', expires_in_seconds: int=0) -> str
~~~


Create a share-link token for a document builder session.

Source: `lightbulb/mcp_server.py:11057`.

### `doc_builder_get_messages`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
doc_builder_get_messages(session_id: str, limit: int=50) -> str
~~~


Get message history for a document builder session.

Source: `lightbulb/mcp_server.py:11073`.

### `doc_builder_save`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
doc_builder_save(session_id: str, body: str='{}') -> str
~~~


Save the current state of a document builder session.

Source: `lightbulb/mcp_server.py:11083`.

### `dynamic_workflow_attach`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
dynamic_workflow_attach(company_ref: str, project_ref: str, run_ref: str, host: str, host_session_ref: str, host_role: str, expected_revision: int, idempotency_key: str) -> str
~~~


Attach fresh planner, builder, or evaluator host custody to a run.

Source: `lightbulb/mcp_server.py:5758`.

### `dynamic_workflow_cancel`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
dynamic_workflow_cancel(company_ref: str, project_ref: str, run_ref: str, host_binding_ref: str, session_receipt: str, host_role: str, expected_revision: int, idempotency_key: str, reason: str) -> str
~~~


Cancel a non-terminal workflow with exact optimistic concurrency.

Source: `lightbulb/mcp_server.py:5958`.

### `dynamic_workflow_next_assignment`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
dynamic_workflow_next_assignment(company_ref: str, project_ref: str, run_ref: str, host_binding_ref: str, session_receipt: str, host_role: str, expected_revision: int, idempotency_key: str) -> str
~~~


Lease the next assignment for the caller's exact role binding.

Source: `lightbulb/mcp_server.py:5808`.

### `dynamic_workflow_start`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
dynamic_workflow_start(company_ref: str, project_ref: str, objective: str, acceptance_criteria: list[_DynamicWorkflowAcceptanceCriterion], host: str, expected_revision: int, idempotency_key: str, host_session_ref: str='', acceptance_policy: str='distinct_binding', workflow_spec: dict[str, Any] | None=None, inputs: dict[str, Any] | None=None) -> str
~~~


Start a scoped authoritative planner/builder/evaluator workflow.

Source: `lightbulb/mcp_server.py:5725`.

### `dynamic_workflow_status`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
dynamic_workflow_status(company_ref: str, project_ref: str, run_ref: str, host_binding_ref: str, session_receipt: str, host_role: str) -> str
~~~


Read bounded run status with a role-bound continuation receipt.

Source: `lightbulb/mcp_server.py:5785`.

### `dynamic_workflow_submit_builder_result`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
dynamic_workflow_submit_builder_result(company_ref: str, project_ref: str, run_ref: str, host_binding_ref: str, session_receipt: str, host_role: str, assignment_ref: str, assignment_receipt: str, expected_revision: int, idempotency_key: str, outcome: str, summary: str, plan_digest: str, iteration: int, evidence_refs: list[_DynamicWorkflowBuilderEvidence], progress_digest: str) -> str
~~~


Commit a builder result and content-addressed evidence under lease.

Source: `lightbulb/mcp_server.py:5870`.

### `dynamic_workflow_submit_evaluator_verdict`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
dynamic_workflow_submit_evaluator_verdict(company_ref: str, project_ref: str, run_ref: str, host_binding_ref: str, session_receipt: str, host_role: str, assignment_ref: str, assignment_receipt: str, expected_revision: int, idempotency_key: str, decision: str, accepted: bool, summary: str, plan_digest: str, builder_result_digest: str, required_criterion_ids: list[str], criterion_results: list[_DynamicWorkflowCriterionResult]) -> str
~~~


Commit a default-fail evaluator verdict under fresh evaluator custody.

Source: `lightbulb/mcp_server.py:5913`.

### `dynamic_workflow_submit_plan`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
dynamic_workflow_submit_plan(company_ref: str, project_ref: str, run_ref: str, host_binding_ref: str, session_receipt: str, host_role: str, assignment_ref: str, assignment_receipt: str, expected_revision: int, idempotency_key: str, required_criterion_ids: list[str], plan: _DynamicWorkflowPlan) -> str
~~~


Commit a canonical planner plan under its exclusive assignment lease.

Source: `lightbulb/mcp_server.py:5835`.

### `evaluate_project_offline_policy`

Namespace: `core`. Kind: `curated`. Policy annotations: `_PROJECT_GAME_APPEND_ONLY_ANNOTATIONS`.



~~~python
evaluate_project_offline_policy(project_id: str, behavior_policy_id: str, candidate_policy_id: str, metric_id: str, pairs_json: str, evaluation_id: str='', note: str='', confirm_evaluate: bool=False) -> str
~~~


Estimate a candidate from exact assignment/outcome receipt pairs.

Source: `lightbulb/mcp_server.py:3501`.

### `flush_sdk_runtime_outcomes`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
flush_sdk_runtime_outcomes(idempotency_key: str='') -> str
~~~


Persist queued outcomes in the authenticated tenant/company ledger.

Source: `lightbulb/mcp_server.py:6205`.

### `get_account_shell_customization`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
get_account_shell_customization() -> str
~~~


Read the effective governed account-shell customization.

Source: `lightbulb/mcp_server.py:4758`.

### `get_agent_marketplace_action_publication`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
get_agent_marketplace_action_publication(publication_id: str) -> str
~~~


Inspect one governed publication attempt by its server-issued UUID.

Source: `lightbulb/mcp_server.py:5101`.

### `get_agent_marketplace_installation`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
get_agent_marketplace_installation(installation_id: str) -> str
~~~


Get one marketplace installation for the selected company.

Source: `lightbulb/mcp_server.py:5156`.

### `get_agent_marketplace_invocation_receipt`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
get_agent_marketplace_invocation_receipt(invocation_id: str) -> str
~~~


Get the bounded audit receipt for a marketplace invocation.

Source: `lightbulb/mcp_server.py:5315`.

### `get_agent_marketplace_invocation_status`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
get_agent_marketplace_invocation_status(invocation_id: str) -> str
~~~


Get current state for a marketplace invocation in the selected company.

Source: `lightbulb/mcp_server.py:5306`.

### `get_agent_marketplace_listing`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
get_agent_marketplace_listing(listing_id: str, revision_id: str='', include_inputs: bool=True) -> str
~~~


Get one persisted UUID listing and, optionally, one immutable UUID revision.

Source: `lightbulb/mcp_server.py:4995`.

### `get_agent_runtime_config`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
get_agent_runtime_config(agent_type: str='coding') -> str
~~~


Get the effective runtime config for coding or Backbone.

Source: `lightbulb/mcp_server.py:6831`.

### `get_agent_training_pair_status`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
get_agent_training_pair_status(pair_handle: str, project_id: str='') -> str
~~~


Read one exact-owner, privacy-minimized governed training-pair status.

Source: `lightbulb/mcp_server.py:5475`.

### `get_aoc_decision`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
get_aoc_decision(decision_id: str) -> str
~~~


Get a specific AutoCompany decision.

Source: `lightbulb/mcp_server.py:10486`.

### `get_aoc_run`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
get_aoc_run(run_id: str) -> str
~~~


Get an AutoCompany run detail.

Source: `lightbulb/mcp_server.py:10381`.

### `get_aoc_task`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
get_aoc_task(task_id: str) -> str
~~~


Get an AutoCompany task detail.

Source: `lightbulb/mcp_server.py:10433`.

### `get_aoc_tick`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
get_aoc_tick(tick_id: str) -> str
~~~


Get a single AutoCompany tick.

Source: `lightbulb/mcp_server.py:10512`.

### `get_approval_details`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
get_approval_details(task_id: str) -> str
~~~


Get full details of a pending approval task before deciding.

Source: `lightbulb/mcp_server.py:8489`.

### `get_artifact`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
get_artifact(artifact_id: str) -> str
~~~


Get the full content of a specific artifact.

Source: `lightbulb/mcp_server.py:7679`.

### `get_codex_account_link_status`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
get_codex_account_link_status(session_id: str) -> str
~~~


Poll a Codex account-link device-auth session.

Source: `lightbulb/mcp_server.py:6946`.

### `get_crm_task`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
get_crm_task(task_id: str, tenant_id: str='') -> str
~~~


Get a CRM task detail.

Source: `lightbulb/mcp_server.py:10733`.

### `get_project_connector_route_descriptor`

Namespace: `core`. Kind: `curated`. Policy annotations: `ToolAnnotations(readOnlyHint=True, destructiveHint=False, idempotentHint=True, openWorldHint=False)`.



~~~python
get_project_connector_route_descriptor(project_id: str, connector_account_ref: str, tool_name: str) -> str
~~~


Resolve sanitized governed route coordinates for one account and Tool.

Source: `lightbulb/mcp_server.py:8143`.

### `get_project_game_snapshot`

Namespace: `core`. Kind: `curated`. Policy annotations: `_PROJECT_GAME_READ_ONLY_ANNOTATIONS`.



~~~python
get_project_game_snapshot(project_id: str) -> str
~~~


Fetch the canonical, exact-scoped campaign state for one project.

Source: `lightbulb/mcp_server.py:2743`.

### `get_recursive_agent_execution_status`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
get_recursive_agent_execution_status(execution_id: str) -> str
~~~


Inspect one exact user-owned recursive execution without secret capabilities.

Source: `lightbulb/mcp_server.py:4652`.

### `get_server_workflow_improvement_packet`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
get_server_workflow_improvement_packet(packet_id: str) -> str
~~~


Read one exact authenticated tenant/company workflow-improvement packet.

Source: `lightbulb/mcp_server.py:6557`.

### `get_server_workflow_improvement_status`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
get_server_workflow_improvement_status() -> str
~~~


Read durable tenant/company-scoped improvement status from Lightbulb.

Source: `lightbulb/mcp_server.py:6537`.

### `get_voice_execution`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
get_voice_execution(execution_id: str) -> str
~~~


Get a voice execution detail (transcript, status, agent decisions).

Source: `lightbulb/mcp_server.py:9823`.

### `get_workflow_improvement_audit`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
get_workflow_improvement_audit(packet_id: str) -> str
~~~


Read the immutable, hash-chained audit trail for one scoped packet.

Source: `lightbulb/mcp_server.py:6600`.

### `get_workflow_improvement_delivery`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
get_workflow_improvement_delivery(delivery_id: str) -> str
~~~


Read the current scoped branch/PR/CI/staging/canary delivery state.

Source: `lightbulb/mcp_server.py:6664`.

### `get_workflow_improvement_status`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
get_workflow_improvement_status(output_dir: str='') -> str
~~~


Read local workflow-improvement score, trend, queue, and safety state.

Source: `lightbulb/mcp_server.py:6489`.

### `get_workflow_run`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
get_workflow_run(workflow_run_ref: str) -> str
~~~


Inspect a scoped workflow run without returning its inputs or outputs.

Source: `lightbulb/mcp_server.py:7769`.

### `get_workflow_trigger_catalog`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
get_workflow_trigger_catalog() -> str
~~~


List schedule literals and event types accepted by workflow authoring.

Source: `lightbulb/mcp_server.py:7822`.

### `grep_documents`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
grep_documents(pattern: str, regex: bool=True, case_sensitive: bool=False, folder_path: str='', top_k: int=20) -> str
~~~


Grep across document content using pattern matching (like ripgrep).

Source: `lightbulb/mcp_server.py:3797`.

### `hr_live_advance_application`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
hr_live_advance_application(application_id: str, body: str='{}') -> str
~~~


Advance a Greenhouse candidate to the next stage (HITL-gated).

Source: `lightbulb/mcp_server.py:9965`.

### `hr_live_cases`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
hr_live_cases() -> str
~~~


HR case-board items from Monday.com.

Source: `lightbulb/mcp_server.py:9927`.

### `hr_live_health`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
hr_live_health() -> str
~~~


Health check for HR connector tokens (BambooHR / Greenhouse / Monday).

Source: `lightbulb/mcp_server.py:9987`.

### `hr_live_leave_balance`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
hr_live_leave_balance(bamboo_employee_id: str) -> str
~~~


BambooHR leave balance for an employee.

Source: `lightbulb/mcp_server.py:9907`.

### `hr_live_monday_board`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
hr_live_monday_board(checklist_id: str) -> str
~~~


Monday.com board for an HR onboarding checklist.

Source: `lightbulb/mcp_server.py:9917`.

### `hr_live_recruiting_applications`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
hr_live_recruiting_applications(job_id: str='', status: str='') -> str
~~~


List Greenhouse applications.

Source: `lightbulb/mcp_server.py:9950`.

### `hr_live_recruiting_jobs`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
hr_live_recruiting_jobs(status: str='') -> str
~~~


List Greenhouse jobs.

Source: `lightbulb/mcp_server.py:9937`.

### `hr_live_reject_application`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
hr_live_reject_application(application_id: str, body: str='{}') -> str
~~~


Reject a Greenhouse application (HITL-gated).

Source: `lightbulb/mcp_server.py:9976`.

### `hr_live_whos_out`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
hr_live_whos_out() -> str
~~~


BambooHR who's-out roster (current and upcoming time-off).

Source: `lightbulb/mcp_server.py:9897`.

### `inspect_agent_learning_readiness`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
inspect_agent_learning_readiness(installation_id: str, revision_id: str, project_id: str='') -> str
~~~


Inspect critical learning readiness for one exact installed ACTION revision.

Source: `lightbulb/mcp_server.py:5324`.

### `inspect_agent_training_input_custody`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
inspect_agent_training_input_custody(installation_id: str, revision_id: str, project_id: str='') -> str
~~~


Inspect exact-owner custody for one installed ACTION revision.

Source: `lightbulb/mcp_server.py:5349`.

### `inspect_project_creation_world_ready`

Namespace: `core`. Kind: `curated`. Policy annotations: `_PROJECT_GAME_READ_ONLY_ANNOTATIONS`.



~~~python
inspect_project_creation_world_ready(name: str, instructions: str='', play_style: str='guided_human_in_the_loop') -> str
~~~


Inspect blockers without invoking project or preflight endpoints.

Source: `lightbulb/mcp_server.py:2714`.

### `inspect_project_game_campaign`

Namespace: `core`. Kind: `curated`. Policy annotations: `_PROJECT_GAME_READ_ONLY_ANNOTATIONS`.



~~~python
inspect_project_game_campaign(project_id: str) -> str
~~~


Compatibility alias for ``get_project_game_snapshot(project_id)``.

Source: `lightbulb/mcp_server.py:2765`.

### `install_agent_marketplace_action`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
install_agent_marketplace_action(listing_id: str, revision_id: str, idempotency_key: str, deployment_targets: str='[]') -> str
~~~


Install persisted UUIDs returned by list_agent_marketplace_listings.

Source: `lightbulb/mcp_server.py:5165`.

### `invoke_agent_marketplace_action`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
invoke_agent_marketplace_action(installation_id: str, idempotency_key: str, inputs: str='{}', message: str='', objective: str='', dry_run: bool=True, preview_invocation_id: str='', confirm_live: bool=False) -> str
~~~


Preview first, then explicitly confirm the exact preview for a live invocation.

Source: `lightbulb/mcp_server.py:5254`.

### `invoke_tool`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
invoke_tool(tool_name: str, arguments: str='{}', project_id: str='', project_ref: str='', connector_account_ref: str='', idempotency_key: str='', effect: str='', approval_ref: str='') -> str
~~~


Invoke a platform tool through exact governed project/account custody.

Source: `lightbulb/mcp_server.py:8267`.

### `it_ops_live_github`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
it_ops_live_github() -> str
~~~


Live GitHub data passthrough for the IT-Ops workspace.

Source: `lightbulb/mcp_server.py:10947`.

### `it_ops_live_jira`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
it_ops_live_jira() -> str
~~~


Live Jira data passthrough for the IT-Ops workspace.

Source: `lightbulb/mcp_server.py:10927`.

### `it_ops_live_notion`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
it_ops_live_notion() -> str
~~~


Live Notion data passthrough for the IT-Ops workspace.

Source: `lightbulb/mcp_server.py:10957`.

### `it_ops_live_slack`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
it_ops_live_slack() -> str
~~~


Live Slack data passthrough for the IT-Ops workspace.

Source: `lightbulb/mcp_server.py:10937`.

### `it_ops_mcp_manifest`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
it_ops_mcp_manifest() -> str
~~~


Get the IT-Ops workspace MCP manifest.

Source: `lightbulb/mcp_server.py:10967`.

### `lightbulb_describe_capability`

Namespace: `core`. Kind: `curated`. Policy annotations: `ToolAnnotations(readOnlyHint=True, destructiveHint=False, idempotentHint=True, openWorldHint=False)`.



~~~python
lightbulb_describe_capability(name: str) -> str
~~~


Load the schema and safety metadata for one discovered capability.

Source: `lightbulb/mcp_server.py:11333`.

### `lightbulb_find_capabilities`

Namespace: `core`. Kind: `curated`. Policy annotations: `ToolAnnotations(readOnlyHint=True, destructiveHint=False, idempotentHint=True, openWorldHint=False)`.



~~~python
lightbulb_find_capabilities(query: str='', limit: int=10) -> str
~~~


Find task-relevant Lightbulb capabilities without loading every tool schema.

Source: `lightbulb/mcp_server.py:11231`.

### `lightbulb_use_action_capability`

Namespace: `core`. Kind: `curated`. Policy annotations: `ToolAnnotations(readOnlyHint=False, destructiveHint=True, idempotentHint=False, openWorldHint=True)`.



~~~python
lightbulb_use_action_capability(name: str, arguments_json: str='{}') -> str
~~~


Invoke a discovered action under conservative host-visible risk hints.

Source: `lightbulb/mcp_server.py:11466`.

### `lightbulb_use_read_capability`

Namespace: `core`. Kind: `curated`. Policy annotations: `ToolAnnotations(readOnlyHint=True, destructiveHint=False, idempotentHint=False, openWorldHint=True)`.



~~~python
lightbulb_use_read_capability(name: str, arguments_json: str='{}') -> str
~~~


Invoke a discovered capability explicitly annotated as read-only.

Source: `lightbulb/mcp_server.py:11441`.

### `list_agent_marketplace_installations`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
list_agent_marketplace_installations(status: str='', cursor: str='', limit: int=50) -> str
~~~


List marketplace installations for the selected company.

Source: `lightbulb/mcp_server.py:5139`.

### `list_agent_marketplace_listings`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
list_agent_marketplace_listings(query: str='', kind: str='', domain: str='', cursor: str='', limit: int=50, include_inputs: bool=True) -> str
~~~


List authoritative persisted listings and lifecycle UUIDs.

Source: `lightbulb/mcp_server.py:4968`.

### `list_agent_runtime_options`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
list_agent_runtime_options(agent_type: str='') -> str
~~~


List configurable Lightbulb agent runtimes.

Source: `lightbulb/mcp_server.py:6817`.

### `list_aoc_decisions`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
list_aoc_decisions(status: str='', limit: int=20) -> str
~~~


List AutoCompany decisions (pending or resolved).

Source: `lightbulb/mcp_server.py:10464`.

### `list_aoc_runs`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
list_aoc_runs(status: str='', limit: int=20) -> str
~~~


List AutoCompany cognitive-loop runs.

Source: `lightbulb/mcp_server.py:10359`.

### `list_aoc_task_events`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
list_aoc_task_events(task_id: str) -> str
~~~


List events recorded against an AutoCompany task.

Source: `lightbulb/mcp_server.py:10443`.

### `list_aoc_tasks`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
list_aoc_tasks(run_id: str='', limit: int=20) -> str
~~~


List AutoCompany tasks (optionally scoped to a run).

Source: `lightbulb/mcp_server.py:10411`.

### `list_aoc_ticks`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
list_aoc_ticks(run_id: str='', limit: int=20) -> str
~~~


List AutoCompany cognitive-loop ticks.

Source: `lightbulb/mcp_server.py:10496`.

### `list_approval_preferences`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
list_approval_preferences() -> str
~~~


List the user's HITL auto-accept rules.

Source: `lightbulb/mcp_server.py:10781`.

### `list_artifacts`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
list_artifacts(artifact_type: str='') -> str
~~~


List artifacts — charts, reports, analyses, code, and other outputs from agent runs.

Source: `lightbulb/mcp_server.py:7654`.

### `list_business_primitives`

Namespace: `core`. Kind: `curated`. Policy annotations: `ToolAnnotations(readOnlyHint=True, destructiveHint=False, idempotentHint=True, openWorldHint=False)`.



~~~python
list_business_primitives(category: str='', query: str='', include_inputs: bool=True, offset: int=0, limit: int=20, summary_only: bool=False) -> str
~~~


List Lightbulb business primitives for real operating tasks.

Source: `lightbulb/mcp_server.py:4673`.

### `list_code_workspaces`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
list_code_workspaces() -> str
~~~


List all code workspaces available to you.

Source: `lightbulb/mcp_server.py:7400`.

### `list_companies`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
list_companies() -> str
~~~


List companies in the user's tenant.

Source: `lightbulb/mcp_server.py:9266`.

### `list_connected_integrations`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
list_connected_integrations() -> str
~~~


List connected integrations for the current company context.

Source: `lightbulb/mcp_server.py:9373`.

### `list_connectors`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
list_connectors() -> str
~~~


List all available connectors and their connection status.

Source: `lightbulb/mcp_server.py:7964`.

### `list_crm_contacts`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
list_crm_contacts(search: str='', limit: int=20) -> str
~~~


List CRM contacts, optionally filtered by search query.

Source: `lightbulb/mcp_server.py:8364`.

### `list_crm_deals`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
list_crm_deals(search: str='', limit: int=20) -> str
~~~


List CRM deals/opportunities.

Source: `lightbulb/mcp_server.py:8400`.

### `list_crm_tasks`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
list_crm_tasks(tenant_id: str='', limit: int=20) -> str
~~~


List CRM tasks (defaults to authed tenant).

Source: `lightbulb/mcp_server.py:10714`.

### `list_domain_actions`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
list_domain_actions(domain: str) -> str
~~~


List available actions for a specific domain agent.

Source: `lightbulb/mcp_server.py:9445`.

### `list_domains`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
list_domains() -> str
~~~


List all available domain agents and their capabilities.

Source: `lightbulb/mcp_server.py:9412`.

### `list_executable_business_primitives`

Namespace: `core`. Kind: `curated`. Policy annotations: `ToolAnnotations(readOnlyHint=True, destructiveHint=False, idempotentHint=True, openWorldHint=False)`.



~~~python
list_executable_business_primitives(query: str='', offset: int=0, limit: int=20, include_schemas: bool=True) -> str
~~~


List a bounded page of SDK primitives; query one ref for full schemas.

Source: `lightbulb/mcp_server.py:5572`.

### `list_folder`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
list_folder(folder_path: str='/', source_system: str='', max_items: int=100) -> str
~~~


List documents in a folder or the entire document library.

Source: `lightbulb/mcp_server.py:3831`.

### `list_notifications`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
list_notifications(limit: int=20) -> str
~~~


List recent notifications — HITL decisions, workflow alerts, system messages.

Source: `lightbulb/mcp_server.py:8432`.

### `list_pending_approvals`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
list_pending_approvals() -> str
~~~


List all pending approval tasks waiting for your decision.

Source: `lightbulb/mcp_server.py:8457`.

### `list_project_business_outcomes`

Namespace: `core`. Kind: `curated`. Policy annotations: `_PROJECT_GAME_READ_ONLY_ANNOTATIONS`.



~~~python
list_project_business_outcomes(project_id: str, limit: int=25) -> str
~~~


Read the real-score receipt ledger for one accessible project.

Source: `lightbulb/mcp_server.py:3316`.

### `list_project_connector_accounts`

Namespace: `core`. Kind: `curated`. Policy annotations: `ToolAnnotations(readOnlyHint=True, destructiveHint=False, idempotentHint=True, openWorldHint=False)`.



~~~python
list_project_connector_accounts(project_id: str, provider: str='', offset: int=0, limit: int=40) -> str
~~~


List sanitized connector account aliases bound to one accessible project.

Source: `lightbulb/mcp_server.py:7992`.

### `list_project_learning_result_evaluations`

Namespace: `core`. Kind: `curated`. Policy annotations: `_PROJECT_GAME_READ_ONLY_ANNOTATIONS`.



~~~python
list_project_learning_result_evaluations(project_id: str, limit: int=25) -> str
~~~


Read independent technical replays and separate human decisions.

Source: `lightbulb/mcp_server.py:3170`.

### `list_project_learning_reviews`

Namespace: `core`. Kind: `curated`. Policy annotations: `_PROJECT_GAME_READ_ONLY_ANNOTATIONS`.



~~~python
list_project_learning_reviews(project_id: str, limit: int=25) -> str
~~~


Read human-reviewed mission lessons and shadow-training admissions.

Source: `lightbulb/mcp_server.py:3002`.

### `list_project_learning_runs`

Namespace: `core`. Kind: `curated`. Policy annotations: `_PROJECT_GAME_READ_ONLY_ANNOTATIONS`.



~~~python
list_project_learning_runs(project_id: str, limit: int=25) -> str
~~~


Read the Project Training Quest and its durable-run receipts.

Source: `lightbulb/mcp_server.py:3056`.

### `list_project_mission_runs`

Namespace: `core`. Kind: `curated`. Policy annotations: `_PROJECT_GAME_READ_ONLY_ANNOTATIONS`.



~~~python
list_project_mission_runs(project_id: str, limit: int=25) -> str
~~~


Read durable mission briefing locks and later action-event bindings.

Source: `lightbulb/mcp_server.py:2885`.

### `list_project_policy_assignments`

Namespace: `core`. Kind: `curated`. Policy annotations: `_PROJECT_GAME_READ_ONLY_ANNOTATIONS`.



~~~python
list_project_policy_assignments(project_id: str, limit: int=25) -> str
~~~


Read decision-time policy probability receipts for one project.

Source: `lightbulb/mcp_server.py:3397`.

### `list_project_policy_evaluations`

Namespace: `core`. Kind: `curated`. Policy annotations: `_PROJECT_GAME_READ_ONLY_ANNOTATIONS`.



~~~python
list_project_policy_evaluations(project_id: str, limit: int=25) -> str
~~~


Read offline-policy receipts and their identification/authority limits.

Source: `lightbulb/mcp_server.py:3489`.

### `list_project_science_evidence`

Namespace: `core`. Kind: `curated`. Policy annotations: `_PROJECT_GAME_READ_ONLY_ANNOTATIONS`.



~~~python
list_project_science_evidence(project_id: str, limit: int=50) -> str
~~~


Read the project's durable hypothesis-to-policy scientific context.

Source: `lightbulb/mcp_server.py:2783`.

### `list_project_shadow_learner_updates`

Namespace: `core`. Kind: `curated`. Policy annotations: `_PROJECT_GAME_READ_ONLY_ANNOTATIONS`.



~~~python
list_project_shadow_learner_updates(project_id: str, limit: int=25) -> str
~~~


Read bounded shadow update and rollback receipts.

Source: `lightbulb/mcp_server.py:3193`.

### `list_project_skill_matches`

Namespace: `core`. Kind: `curated`. Policy annotations: `_PROJECT_GAME_READ_ONLY_ANNOTATIONS`.



~~~python
list_project_skill_matches(project_id: str, limit: int=25) -> str
~~~


Read the project's worker-verified shadow Training Arena ledger.

Source: `lightbulb/mcp_server.py:3018`.

### `list_project_training_packs`

Namespace: `core`. Kind: `curated`. Policy annotations: `_PROJECT_GAME_READ_ONLY_ANNOTATIONS`.



~~~python
list_project_training_packs(project_id: str, limit: int=25) -> str
~~~


Read the project's Learning Lab candidate-pack ledger.

Source: `lightbulb/mcp_server.py:3037`.

### `list_projects_for_harness`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
list_projects_for_harness(company_ref: str='') -> str
~~~


List accessible Lightbulb projects using public harness-safe handles.

Source: `lightbulb/mcp_server.py:8635`.

### `list_sdk_runtime_outcomes`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
list_sdk_runtime_outcomes() -> str
~~~


List sanitized primitive outcomes queued by this MCP process.

Source: `lightbulb/mcp_server.py:6197`.

### `list_server_workflow_improvement_packets`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
list_server_workflow_improvement_packets(status: str='', limit: int=50) -> str
~~~


List durable improvement packets visible to the authenticated company.

Source: `lightbulb/mcp_server.py:6545`.

### `list_voice_executions`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
list_voice_executions(status: str='', limit: int=20) -> str
~~~


List voice agent executions (live and historical phone calls).

Source: `lightbulb/mcp_server.py:9788`.

### `list_voice_pending_approvals`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
list_voice_pending_approvals() -> str
~~~


List in-call HITL approvals waiting for caller-side decision.

Source: `lightbulb/mcp_server.py:9834`.

### `list_workflow_improvement_packets`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
list_workflow_improvement_packets(output_dir: str='', status: str='') -> str
~~~


List proposed or human-approved SDK-first workflow improvement packets.

Source: `lightbulb/mcp_server.py:6502`.

### `list_workflows`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
list_workflows() -> str
~~~


List company-scoped workflows using public refs, never internal IDs.

Source: `lightbulb/mcp_server.py:7697`.

### `manage_sdk_project_runtime`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
manage_sdk_project_runtime(operation: str, project_spec: str, workflow_key: str='', run_ref: str='', inputs: str='{}', approval_refs: str='{}', connector_account_refs: str='{}', resume_at: str='', event: str='{}', worker_ref: str='lightbulb-mcp-worker', preview_only: bool=True) -> str
~~~


Start, pause/resume, schedule, dispatch, or inspect a durable SDK workflow.

Source: `lightbulb/mcp_server.py:6059`.

### `mark_all_notifications_read`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
mark_all_notifications_read() -> str
~~~


Mark all notifications as read.

Source: `lightbulb/mcp_server.py:10846`.

### `mark_notification_read`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
mark_notification_read(notification_id: str) -> str
~~~


Mark a notification as read.

Source: `lightbulb/mcp_server.py:10836`.

### `memory_graph`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
memory_graph(focus: str='', depth: int=0) -> str
~~~


Read the memory graph (or a filtered subgraph).

Source: `lightbulb/mcp_server.py:10656`.

### `memory_graph_node`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
memory_graph_node(node_id: str) -> str
~~~


Get a single node from the memory graph.

Source: `lightbulb/mcp_server.py:10671`.

### `memory_list_entries`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
memory_list_entries(limit: int=50) -> str
~~~


List structured memory entries.

Source: `lightbulb/mcp_server.py:10525`.

### `memory_list_events`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
memory_list_events(limit: int=50) -> str
~~~


List memory events (timeline of state changes).

Source: `lightbulb/mcp_server.py:10691`.

### `memory_list_identity`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
memory_list_identity() -> str
~~~


List identity records in the memory graph.

Source: `lightbulb/mcp_server.py:10681`.

### `memory_list_skills`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
memory_list_skills() -> str
~~~


List skills/capabilities recorded in memory.

Source: `lightbulb/mcp_server.py:10701`.

### `memory_projection_memory`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
memory_projection_memory() -> str
~~~


Memory-structure projection of the agent.

Source: `lightbulb/mcp_server.py:10646`.

### `memory_projection_soul`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
memory_projection_soul() -> str
~~~


Identity / personality projection of the agent.

Source: `lightbulb/mcp_server.py:10636`.

### `memory_query`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
memory_query(body: str) -> str
~~~


Run a structured memory query (filters, time-windows, semantic). Body is JSON.

Source: `lightbulb/mcp_server.py:10535`.

### `memory_recall`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
memory_recall(key: str, namespace: str='default') -> str
~~~


Recall a value from agent memory.

Source: `lightbulb/mcp_server.py:9218`.

### `memory_regulation_preview`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
memory_regulation_preview(budget: int=500, project_id: str='', categories_json: str='', empirical_success_floor_ppm: int=0, empirical_success_min_samples: int=20, empirical_success_lookback_days: int=90, optimize_for_least_active_memory: bool=False, held_out_task_evaluation_json: str='') -> str
~~~


Preview bounded, success-evidence-aware compaction without mutation.

Source: `lightbulb/mcp_server.py:10546`.

### `memory_regulation_storage_status`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
memory_regulation_storage_status() -> str
~~~


Inspect bounded hierarchical compaction-receipt capacity without mutating memory.

Source: `lightbulb/mcp_server.py:10626`.

### `memory_search`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
memory_search(query: str, namespace: str='default', top_k: int=5) -> str
~~~


Search agent memory semantically.

Source: `lightbulb/mcp_server.py:9239`.

### `memory_store`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
memory_store(key: str, value: str, namespace: str='default') -> str
~~~


Store a value in the platform's agent memory.

Source: `lightbulb/mcp_server.py:9199`.

### `modify_voice_action`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
modify_voice_action(execution_id: str, approval_task_id: str, modifications: str) -> str
~~~


Approve a voice action with modifications. modifications is a JSON object.

Source: `lightbulb/mcp_server.py:9881`.

### `new_recursive_execution_id`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
new_recursive_execution_id() -> str
~~~


Create a public UUID for a recursive run before starting it.

Source: `lightbulb/mcp_server.py:4630`.

### `open_project_in_harness`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
open_project_in_harness(company_ref: str, project_ref: str, harness: str, host_session_ref: str='', model: str='', query: str='', claim_handoff: bool=False, open_lightbulb: bool=True) -> str
~~~


Attach this coding harness to a Lightbulb project and load its handoff.

Source: `lightbulb/mcp_server.py:8803`.

### `page_builder_capabilities`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
page_builder_capabilities(session_id: str) -> str
~~~


List page capabilities (forms, search, auth, etc.).

Source: `lightbulb/mcp_server.py:10991`.

### `page_builder_chat`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
page_builder_chat(session_id: str, message: str) -> str
~~~


Send a message to a page builder session to design or modify pages.

Source: `lightbulb/mcp_server.py:4458`.

### `page_builder_create`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
page_builder_create(brand_name: str='', initial_prompt: str='', force_page_builder: bool=False, coding_harness: str='') -> str
~~~


Create a new page builder session to build a website or landing page.

Source: `lightbulb/mcp_server.py:4383`.

### `page_builder_deploy`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
page_builder_deploy(session_id: str, page_key: str='') -> str
~~~


Deploy a page builder session to make the site live.

Source: `lightbulb/mcp_server.py:4486`.

### `page_builder_install_artifact`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
page_builder_install_artifact(session_id: str, body: str) -> str
~~~


Install a component artifact into the page session. Body is JSON.

Source: `lightbulb/mcp_server.py:11001`.

### `page_builder_list_sessions`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
page_builder_list_sessions() -> str
~~~


List existing page builder sessions.

Source: `lightbulb/mcp_server.py:4439`.

### `page_builder_preview`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
page_builder_preview(session_id: str) -> str
~~~


Get the preview URL for a page builder session.

Source: `lightbulb/mcp_server.py:4505`.

### `page_builder_unpublish`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
page_builder_unpublish(session_id: str) -> str
~~~


Unpublish a deployed page builder session.

Source: `lightbulb/mcp_server.py:11012`.

### `page_builder_workspace_automation`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
page_builder_workspace_automation(session_id: str, body: str='{}') -> str
~~~


Run the page-builder workspace automation (auto-wire pages → agents → backend).

Source: `lightbulb/mcp_server.py:10980`.

### `pin_agent_marketplace_action`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
pin_agent_marketplace_action(installation_id: str, revision_id: str, idempotency_key: str, expected_revision_id: str='') -> str
~~~


Pin an installation to an immutable revision with optional compare-and-set.

Source: `lightbulb/mcp_server.py:5235`.

### `post_aoc_task_event`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
post_aoc_task_event(task_id: str, body: str) -> str
~~~


Post a new event onto an AutoCompany task. Body is JSON.

Source: `lightbulb/mcp_server.py:10453`.

### `preflight_agent_training_pair`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
preflight_agent_training_pair(installation_id: str, revision_id: str, project_id: str='') -> str
~~~


Read governed-training readiness for one exact installed action revision.

Source: `lightbulb/mcp_server.py:5376`.

### `preflight_project_creation`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
preflight_project_creation(name: str, instructions: str='') -> str
~~~


Review a project draft in shadow/read-only mode; this never creates it.

Source: `lightbulb/mcp_server.py:3543`.

### `prepare_workflow_learning_handoff`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
prepare_workflow_learning_handoff(packet_id: str, delivery_id: str, installation_id: str, revision_id: str, candidate_manifest: str, episode_manifest: str='', project_id: str='') -> str
~~~


Prepare a fail-closed Puffer/Prime candidate handoff after staging.

Source: `lightbulb/mcp_server.py:6674`.

### `preview_account_shell_customization`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
preview_account_shell_customization(draft_revision_id: str) -> str
~~~


Compile one draft into a non-publishing preview receipt.

Source: `lightbulb/mcp_server.py:4806`.

### `preview_agent_marketplace_action_publication`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
preview_agent_marketplace_action_publication(slug: str, name: str, version: str, domain: str, action: str, visibility: str='PRIVATE', pricing_model: str='INCLUDED', changelog: str='') -> str
~~~


Preview a governed action contract before any marketplace publication.

Source: `lightbulb/mcp_server.py:5012`.

### `publish_agent_marketplace_action`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
publish_agent_marketplace_action(slug: str, name: str, version: str, domain: str, action: str, expected_contract_digest: str, idempotency_key: str, visibility: str='PRIVATE', pricing_model: str='INCLUDED', changelog: str='') -> str
~~~


Publish exactly the action contract returned by the preview tool.

Source: `lightbulb/mcp_server.py:5053`.

### `rag_query`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
rag_query(question: str, top_k: int=5) -> str
~~~


Query the RAG knowledge base directly with a question.

Source: `lightbulb/mcp_server.py:7888`.

### `rag_upload`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
rag_upload(filename: str, content: str) -> str
~~~


Upload a document to the RAG knowledge base for indexing.

Source: `lightbulb/mcp_server.py:7917`.

### `record_project_business_outcome`

Namespace: `core`. Kind: `curated`. Policy annotations: `_PROJECT_GAME_APPEND_ONLY_ANNOTATIONS`.



~~~python
record_project_business_outcome(project_id: str, metric_id: str, metric_label: str, direction: str, baseline_value: float, observed_value: float, unit: str='', observed_at: str='', observation_id: str='', source_event_id: str='', evidence_refs_json: str='[]', links_json: str='{}', note: str='', confirm_record: bool=False) -> str
~~~


Append a real business metric observation after explicit confirmation.

Source: `lightbulb/mcp_server.py:3332`.

### `record_project_learning_review`

Namespace: `core`. Kind: `curated`. Policy annotations: `_PROJECT_GAME_APPEND_ONLY_ANNOTATIONS`.



~~~python
record_project_learning_review(project_id: str, mission_run_receipt_id: str, mission_action_receipt_id: str, outcome_receipt_id: str, decision: str, skill_trial_arm: str, selected_skill_ids_json: str, label: str, reason: str, evidence_refs_json: str='[]', review_id: str='', confirm_record: bool=False) -> str
~~~


Human-account Level-Up Review for one exact mission receipt chain.

Source: `lightbulb/mcp_server.py:3252`.

### `record_project_policy_assignment`

Namespace: `core`. Kind: `curated`. Policy annotations: `_PROJECT_GAME_APPEND_ONLY_ANNOTATIONS`.



~~~python
record_project_policy_assignment(project_id: str, metric_id: str, direction: str, chosen_action_id: str, actions_json: str, behavior_policy_json: str, candidate_policies_json: str, unit: str='', decided_at: str='', assignment_id: str='', source_event_id: str='', evidence_refs_json: str='[]', links_json: str='{}', note: str='', confirm_record: bool=False) -> str
~~~


Log exact policy propensities before an outcome exists.

Source: `lightbulb/mcp_server.py:3413`.

### `record_project_science_evidence`

Namespace: `core`. Kind: `curated`. Policy annotations: `_PROJECT_GAME_APPEND_ONLY_ANNOTATIONS`.



~~~python
record_project_science_evidence(project_id: str, stage: str, summary: str, business_metric_id: str, expected_direction: str, artifact_kind: str, artifact_system: str, artifact_reference: str, artifact_digest_sha256: str, producer_role: str, tool_names_json: str='[]', skill_ids_json: str='[]', parent_receipt_ids_json: str='[]', artifact_schema: str='', observed_at: str='', evidence_id: str='', source_event_id: str='', evidence_refs_json: str='[]', confirm_record: bool=False) -> str
~~~


Append one bounded scientific-lineage receipt after explicit review.

Source: `lightbulb/mcp_server.py:2798`.

### `record_workflow_improvement_delivery_event`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
record_workflow_improvement_delivery_event(delivery_id: str, event_type: str, rationale: str='', evidence: str='{}') -> str
~~~


Advance approved branch, draft PR, CI, staging, canary, or rollback evidence.

Source: `lightbulb/mcp_server.py:6634`.

### `recursive_agent_execute`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
recursive_agent_execute(objective: str, inputs: str='{}', max_depth: int=2, max_total_nodes: int=8, max_children: int=3, max_tokens: int=120000, max_cost_usd: float=25.0, max_runtime_seconds: int=300, max_repl_steps: int=12, max_delegation_context_bytes: int=4096, max_total_delegation_context_bytes: int=32768, root_budget_fraction: float=0.5, child_budget_fraction: float=0.3, allowed_agent_ids: str='', execution_id: str='') -> str
~~~


Run a true recursive Lightbulb agent with bounded subagents and REPL work.

Source: `lightbulb/mcp_server.py:4558`.

### `refine_project_creation_preflight`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
refine_project_creation_preflight(receipt_json: str, answer: str, confirm_user_answer: bool=False) -> str
~~~


Submit one explicit user's answer to the receipt's exact next question.

Source: `lightbulb/mcp_server.py:3564`.

### `register_external_artifact`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
register_external_artifact(type: str, title: str, uri: str='', content: str='', source_agent: str='', project_id: str='', metadata: str='', attach_workspace: bool=False) -> str
~~~


Register an external artifact created outside Lightbulb so agents can discover it.

Source: `lightbulb/mcp_server.py:7195`.

### `reject_task`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
reject_task(task_id: str, comments: str='') -> str
~~~


Reject a pending HITL task, stopping the agent workflow.

Source: `lightbulb/mcp_server.py:8532`.

### `reject_voice_action`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
reject_voice_action(execution_id: str, approval_task_id: str, comments: str='') -> str
~~~


Reject a pending in-call voice action.

Source: `lightbulb/mcp_server.py:9867`.

### `report_project_coding_result`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
report_project_coding_result(company_ref: str, project_ref: str, harness: str, handoff_payload_id: str, status: str, summary: str, host_session_ref: str='', report_id: str='', changed_files_json: str='[]', test_commands_and_results_json: str='[]', unresolved_requirements_or_acceptance_gaps: str='', pull_request_url: str='', commit_sha: str='') -> str
~~~


Return bounded implementation evidence to the Lightbulb Project Agent.

Source: `lightbulb/mcp_server.py:8908`.

### `request_agent_training_pair_admission`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
request_agent_training_pair_admission(installation_id: str, revision_id: str, idempotency_key: str, confirm_admission_request: bool=False, project_id: str='', confirmation_receipt: str='') -> str
~~~


Explicitly request governed-training admission for an installed action.

Source: `lightbulb/mcp_server.py:5403`.

### `run_business_primitive`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
run_business_primitive(primitive_id: str, inputs: str='{}', mode: str='', preview_only: bool=True, request: str='') -> str
~~~


Run a Lightbulb business primitive through Backbone orchestration.

Source: `lightbulb/mcp_server.py:5531`.

### `run_connector_conformance`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
run_connector_conformance(check_live_schemas: bool=True) -> str
~~~


Check every primitive provider and detect hosted Tool schema drift.

Source: `lightbulb/mcp_server.py:6217`.

### `run_sdk_business_primitive`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
run_sdk_business_primitive(primitive_id: str, project_ref: str, project_id: str='', inputs: str='{}', preview_only: bool=True, approval_refs: str='{}', connector_account_refs: str='{}', run_ref: str='') -> str
~~~


Run SDK implementation code for discovery, validation, and safe preview.

Source: `lightbulb/mcp_server.py:5639`.

### `run_sdk_project_workflow`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
run_sdk_project_workflow(project_spec: str, workflow_key: str, inputs: str='{}', preview_only: bool=True, approval_refs: str='{}', connector_account_refs: str='{}', run_ref: str='') -> str
~~~


Run an SDK project workflow locally; hosted connector writes fail closed.

Source: `lightbulb/mcp_server.py:6003`.

### `run_workflow`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
run_workflow(workflow_ref: str, objective: str, inputs: str='{}') -> str
~~~


Run one published workflow from ``list_workflows`` in the active company scope.

Source: `lightbulb/mcp_server.py:7748`.

### `run_workflow_improvement_cycle`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
run_workflow_improvement_cycle(output_dir: str='', observed_outcomes: str='') -> str
~~~


Run one local, proposal-only workflow self-improvement cycle.

Source: `lightbulb/mcp_server.py:6427`.

### `search_agent_marketplace`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
search_agent_marketplace(query: str='', kind: str='', domain: str='', limit: int=50, include_inputs: bool=True) -> str
~~~


Discover governed Lightbulb actions and workers as synthetic catalog rows.

Source: `lightbulb/mcp_server.py:4716`.

### `search_documents`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
search_documents(query: str, folder_path: str='', top_k: int=10) -> str
~~~


Search across all documents using semantic search.

Source: `lightbulb/mcp_server.py:3775`.

### `search_folder`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
search_folder(query: str, folder_path: str='/', search_mode: str='semantic') -> str
~~~


Search within a specific folder using semantic or keyword matching.

Source: `lightbulb/mcp_server.py:3855`.

### `select_company`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
select_company(company_id: str) -> str
~~~


Select a company context for subsequent operations.

Source: `lightbulb/mcp_server.py:9294`.

### `set_approval_preference_state`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
set_approval_preference_state(preference_id: str, enabled: bool=True) -> str
~~~


Enable or disable an auto-accept rule.

Source: `lightbulb/mcp_server.py:10821`.

### `simulate_business_workflow`

Namespace: `core`. Kind: `curated`. Policy annotations: `ToolAnnotations(readOnlyHint=True, destructiveHint=False, idempotentHint=True, openWorldHint=False)`.



~~~python
simulate_business_workflow(workflow_definition: str, events: str='[]', approvals: str='{}', loop_iterations: int=1) -> str
~~~


Dry-run a compiled workflow within its bound using synthetic events.

Source: `lightbulb/mcp_server.py:6357`.

### `software_delivery_context`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
software_delivery_context(repository: str='', workspace_id: str='', project_key: str='', include_live: bool=True, include_memory: bool=True) -> str
~~~


Get the Lightbulb software-delivery context packet before editing code.

Source: `lightbulb/mcp_server.py:4081`.

### `software_delivery_loop`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
software_delivery_loop(request: str, workspace_id: str='', repository: str='', github_owner: str='', github_repo: str='', project_key: str='', environment: str='staging', mode: str='feedback_to_code', execute_coding: bool=True, open_pr: bool=False, auto_push: bool=False, trigger_deploy: bool=False, extra_inputs: str='{}', coding_harness: str='') -> str
~~~


Run the governed software loop from MCP: feedback/SDLC -> coding -> PR -> deploy.

Source: `lightbulb/mcp_server.py:4171`.

### `software_spot_weld_fix`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
software_spot_weld_fix(request: str, workspace_id: str, repository: str='', github_owner: str='', github_repo: str='', project_key: str='', environment: str='staging', scope: str='code', severity: str='high', preview_mode: bool=True, open_pr: bool=True, auto_push: bool=False, trigger_deploy: bool=False, extra_inputs: str='{}', coding_harness: str='') -> str
~~~


Request a bounded urgent production/cloud fix through the Lightbulb loop.

Source: `lightbulb/mcp_server.py:4269`.

### `start_codex_account_link`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
start_codex_account_link() -> str
~~~


Start Codex device authentication for the current Lightbulb account.

Source: `lightbulb/mcp_server.py:6933`.

### `start_consulting_project_workflow`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
start_consulting_project_workflow(objective: str, coding_harness: str, project_context: str='{}', project_id: str='', source: str='mcp') -> str
~~~


Start or continue the Lightbulb consulting project workflow through Backbone.

Source: `lightbulb/mcp_server.py:7256`.

### `start_project_mission_run`

Namespace: `core`. Kind: `curated`. Policy annotations: `_PROJECT_GAME_APPEND_ONLY_ANNOTATIONS`.



~~~python
start_project_mission_run(project_id: str, mission_briefing_json: str, play_style_id: str='', skill_trial_arm: str='', selected_skill_ids_json: str='', context_source_refs_json: str='', note: str='', run_id: str='', confirm_start: bool=False) -> str
~~~


Lock the exact current mission briefing before any separate action.

Source: `lightbulb/mcp_server.py:2901`.

### `start_workflow_improvement_delivery`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
start_workflow_improvement_delivery(packet_id: str, environment: str, repository_ref: str='', base_branch: str='main') -> str
~~~


Admit an implementation-approved packet to isolated draft-PR delivery.

Source: `lightbulb/mcp_server.py:6610`.

### `stop_aoc_run`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
stop_aoc_run(run_id: str) -> str
~~~


Stop an in-flight AutoCompany cognitive-loop run.

Source: `lightbulb/mcp_server.py:10391`.

### `stripe_account_health`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
stripe_account_health() -> str
~~~


Composite health score per connected Stripe account, plus the at-risk subset (score < 60) for direct triage.

Source: `lightbulb/mcp_server.py:9604`.

### `stripe_approve`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
stripe_approve(approval_id: str) -> str
~~~


Approve a pending Stripe orchestrator decision so it can execute.

Source: `lightbulb/mcp_server.py:9563`.

### `stripe_dispatch`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
stripe_dispatch(resource: str, verb: str, op_inputs: str='{}', stripe_account_id: str='') -> str
~~~


Run any Stripe-orchestrator (resource, verb) op.

Source: `lightbulb/mcp_server.py:9476`.

### `stripe_execute_approved`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
stripe_execute_approved(approval_id: str) -> str
~~~


Execute a previously-approved Stripe decision (idempotent replay safe).

Source: `lightbulb/mcp_server.py:9583`.

### `stripe_forecast_snapshot`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
stripe_forecast_snapshot() -> str
~~~


Predictive forecast for the merchant: MRR, failed-payment rate, dispute risk band, payout cashflow band. Server-computed; no Stripe RTT.

Source: `lightbulb/mcp_server.py:9593`.

### `stripe_list_pending_approvals`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
stripe_list_pending_approvals() -> str
~~~


List Stripe-orchestrator approvals waiting for human action.

Source: `lightbulb/mcp_server.py:9553`.

### `stripe_raw_api_request`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
stripe_raw_api_request(api_path: str, method: str='GET', params: str='{}', stripe_account_id: str='', base_address: str='') -> str
~~~


Governed long-tail Stripe API request for /v1 or /v2 endpoints.

Source: `lightbulb/mcp_server.py:9504`.

### `stripe_reject`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
stripe_reject(approval_id: str, reason: str='') -> str
~~~


Reject a pending Stripe orchestrator decision.

Source: `lightbulb/mcp_server.py:9573`.

### `stripe_run_workflow`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
stripe_run_workflow(workflow: str) -> str
~~~


Run a high-level composite workflow.

Source: `lightbulb/mcp_server.py:9615`.

### `stripe_twin_list`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
stripe_twin_list(resource_kind: str, limit: int=50) -> str
~~~


Fast Postgres-backed read of the Stripe Digital Twin (no Stripe RTT).

Source: `lightbulb/mcp_server.py:9538`.

### `submit_project_creation_preflight_feedback`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
submit_project_creation_preflight_feedback(receipt_json: str, helpfulness: str, calibrated_criticality: str, factual_grounding: str, idempotency_key: str, confirm_user_feedback: bool=False) -> str
~~~


Record one explicit user's judgments for the receipt's neutral episode.

Source: `lightbulb/mcp_server.py:3696`.

### `sync_workflow_improvement_report`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
sync_workflow_improvement_report(output_dir: str='') -> str
~~~


Sync the latest local evaluator report to the authenticated scoped ledger.

Source: `lightbulb/mcp_server.py:6519`.

### `test_agent_runtime_config`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
test_agent_runtime_config(agent_type: str='coding', message: str='') -> str
~~~


Dry-run resolve the configured agent runtime without code or connector writes.

Source: `lightbulb/mcp_server.py:6921`.

### `trigger_workflow`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
trigger_workflow(workflow_type: str, objective: str, inputs: str='{}') -> str
~~~


Trigger a workflow execution.

Source: `lightbulb/mcp_server.py:7723`.

### `uninstall_agent_marketplace_action`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
uninstall_agent_marketplace_action(installation_id: str, idempotency_key: str, reason: str='') -> str
~~~


Uninstall an action from the selected company.

Source: `lightbulb/mcp_server.py:5218`.

### `update_crm_task`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
update_crm_task(task_id: str, body: str, tenant_id: str='') -> str
~~~


Update a CRM task. Body is JSON of fields to change.

Source: `lightbulb/mcp_server.py:10754`.

### `validate_aoc_run_config`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
validate_aoc_run_config(run_id: str) -> str
~~~


Validate an AutoCompany run's configuration.

Source: `lightbulb/mcp_server.py:10401`.

### `validate_business_workflow`

Namespace: `core`. Kind: `curated`. Policy annotations: `ToolAnnotations(readOnlyHint=True, destructiveHint=False, idempotentHint=True, openWorldHint=False)`.



~~~python
validate_business_workflow(workflow_definition: str) -> str
~~~


Validate a compiled business workflow before publish or execution.

Source: `lightbulb/mcp_server.py:6316`.

### `validate_sdk_project`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
validate_sdk_project(project_spec: str) -> str
~~~


Validate a custom Lightbulb project against executable SDK primitives.

Source: `lightbulb/mcp_server.py:5987`.

### `what_can_you_do`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
what_can_you_do(domain: str='') -> str
~~~


Ask the Company Brain what it can do — capabilities & worker actions and their inputs.

Source: `lightbulb/mcp_server.py:4015`.

### `where_is`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
where_is(target: str) -> str
~~~


Ask the Company Brain where a data or document type lives (data stores / doc scopes).

Source: `lightbulb/mcp_server.py:3993`.

### `whoami`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
whoami() -> str
~~~


Show your identity, role, tenant, company, and what you can access.

Source: `lightbulb/mcp_server.py:9326`.

### `workspace_bundle`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
workspace_bundle(domain: str) -> str
~~~


Get a domain workspace data bundle (state, surfaces, recent runs).

Source: `lightbulb/mcp_server.py:10859`.

### `workspace_surface`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
workspace_surface(domain: str, surface: str) -> str
~~~


Read a domain workspace surface (e.g. internal_suite).

Source: `lightbulb/mcp_server.py:10879`.

### `workspace_trace`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
workspace_trace(domain: str, trace_id: str) -> str
~~~


Get a workspace trace (full agent execution log).

Source: `lightbulb/mcp_server.py:10869`.

### `xero_agent_approve_proposal`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_agent_approve_proposal(proposal_id: str, body: str='{}') -> str
~~~


Approve a Xero proposal so it can execute.

Source: `lightbulb/mcp_server.py:9682`.

### `xero_agent_create_proposal`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_agent_create_proposal(body: str) -> str
~~~


Create a Xero proposal (queues an HITL approval). Body is JSON.

Source: `lightbulb/mcp_server.py:9671`.

### `xero_agent_org_profile`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_agent_org_profile(xero_tenant_id: str) -> str
~~~


Get the Xero org profile (chart of accounts, tax rates, branding).

Source: `lightbulb/mcp_server.py:9731`.

### `xero_agent_proposals`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_agent_proposals(body: str='{}') -> str
~~~


Generate Xero proposals (reconciliation, AP, payroll, etc.).

Source: `lightbulb/mcp_server.py:9656`.

### `xero_agent_reject_proposal`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_agent_reject_proposal(proposal_id: str, reason: str='') -> str
~~~


Reject a Xero proposal.

Source: `lightbulb/mcp_server.py:9693`.

### `xero_agent_run_playbook`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_agent_run_playbook(playbook_id: str, body: str='{}') -> str
~~~


Run a Xero playbook.

Source: `lightbulb/mcp_server.py:9714`.

### `xero_agent_run_sync`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_agent_run_sync(body: str='{}') -> str
~~~


Trigger a Xero data sync (orgs, AR/AP, payroll, ledger).

Source: `lightbulb/mcp_server.py:9703`.

### `xero_agent_snapshot`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_agent_snapshot(body: str='{}') -> str
~~~


Multi-org Xero financial snapshot (cash, AR, AP, payroll, taxes).

Source: `lightbulb/mcp_server.py:9641`.

### `xero_intake_bill`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_intake_bill(body: str) -> str
~~~


Propose an AP bill into Xero (HITL-gated). Body is JSON.

Source: `lightbulb/mcp_server.py:9752`.

### `xero_intake_invoice`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_intake_invoice(body: str) -> str
~~~


Propose an AR invoice into Xero (HITL-gated). Body is JSON.

Source: `lightbulb/mcp_server.py:9741`.

### `xero_intake_journal`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_intake_journal(body: str) -> str
~~~


Propose a manual journal into Xero (HITL-gated). Body is JSON.

Source: `lightbulb/mcp_server.py:9763`.

### `xero_intake_payroll_trueup`

Namespace: `core`. Kind: `curated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_intake_payroll_trueup(body: str) -> str
~~~


Propose a payroll true-up into Xero (HITL-gated). Body is JSON.

Source: `lightbulb/mcp_server.py:9774`.

### `crm_agentic_plan`

Namespace: `crm`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
crm_agentic_plan(message: str='', inputs: str='{}') -> str
~~~


Run the crm domain agent action `agentic_plan`.

Source: `lightbulb/mcp_generated_tools.py:3011`.

### `crm_assess_pipeline`

Namespace: `crm`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
crm_assess_pipeline(message: str='', owner_email: Optional[str]=None, min_amount_usd: Optional[float]=None) -> str
~~~


Audit your active sales pipeline. Flags stalled deals, missing next-steps, optimistic close dates, and stage-fit mismatches; returns a prioritised action list for the rep and manager.     Args:         message: Free-text objective for the action.         owner_email: Pipeline owner; empty = whole team.         min_amount_usd: Filter to deals above this amount.

Source: `lightbulb/mcp_generated_tools.py:2793`.

### `crm_autonomous_source`

Namespace: `crm`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
crm_autonomous_source(message: str='', inputs: str='{}') -> str
~~~


Run the crm domain agent action `autonomous_source`.

Source: `lightbulb/mcp_generated_tools.py:2813`.

### `crm_book_meeting`

Namespace: `crm`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
crm_book_meeting(message: str='', inputs: str='{}') -> str
~~~


Run the crm domain agent action `book_meeting`.

Source: `lightbulb/mcp_generated_tools.py:2989`.

### `crm_chat`

Namespace: `crm`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
crm_chat(message: str='', inputs: str='{}') -> str
~~~


Run the crm domain agent action `chat`.

Source: `lightbulb/mcp_generated_tools.py:2572`.

### `crm_classify_reply`

Namespace: `crm`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
crm_classify_reply(message: str='', inputs: str='{}') -> str
~~~


Run the crm domain agent action `classify_reply`.

Source: `lightbulb/mcp_generated_tools.py:2879`.

### `crm_competitive_positioning`

Namespace: `crm`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
crm_competitive_positioning(message: str='', inputs: str='{}') -> str
~~~


Run the crm domain agent action `competitive_positioning`.

Source: `lightbulb/mcp_generated_tools.py:2732`.

### `crm_customer_health_risk`

Namespace: `crm`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
crm_customer_health_risk(message: str='', account_id: Optional[str]=None, lookback_days: int=90) -> str
~~~


Score post-sale customer health and surface churn risks. Combines product usage, support tickets, billing, and CRM activity into a 0-100 score with the top 3 risk drivers and recommended actions.     Args:         message: Free-text objective for the action.         account_id (required): CRM account ID.         lookback_days: Activity window for the score.

Source: `lightbulb/mcp_generated_tools.py:2754`.

### `crm_enrich_contact`

Namespace: `crm`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
crm_enrich_contact(message: str='', inputs: str='{}') -> str
~~~


Run the crm domain agent action `enrich_contact`.

Source: `lightbulb/mcp_generated_tools.py:2923`.

### `crm_enrich_leads`

Namespace: `crm`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
crm_enrich_leads(message: str='', inputs: str='{}') -> str
~~~


Run the crm domain agent action `enrich_leads`.

Source: `lightbulb/mcp_generated_tools.py:2945`.

### `crm_expansion_upsell`

Namespace: `crm`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
crm_expansion_upsell(message: str='', account_id: Optional[str]=None, min_arr_usd: Optional[float]=None) -> str
~~~


Identify expansion and upsell opportunities for an account based on current product usage, peer benchmarks, and unmet jobs-to-be-done.     Args:         message: Free-text objective for the action.         account_id (required): CRM account ID.         min_arr_usd: Skip accounts below this ARR threshold.

Source: `lightbulb/mcp_generated_tools.py:2774`.

### `crm_icp_intelligence`

Namespace: `crm`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
crm_icp_intelligence(message: str='', inputs: str='{}') -> str
~~~


Run the crm domain agent action `icp_intelligence`.

Source: `lightbulb/mcp_generated_tools.py:2710`.

### `crm_lead_narrative_advance`

Namespace: `crm`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
crm_lead_narrative_advance(message: str='', inputs: str='{}') -> str
~~~


Run the crm domain agent action `lead_narrative_advance`.

Source: `lightbulb/mcp_generated_tools.py:3055`.

### `crm_lead_narrative_load`

Namespace: `crm`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
crm_lead_narrative_load(message: str='', inputs: str='{}') -> str
~~~


Run the crm domain agent action `lead_narrative_load`.

Source: `lightbulb/mcp_generated_tools.py:3033`.

### `crm_lead_qualification`

Namespace: `crm`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
crm_lead_qualification(message: str='', lead_id: Optional[str]=None, lead_email: Optional[str]=None, company_domain: Optional[str]=None) -> str
~~~


Qualify a lead against your ICP and grade it (A/B/C/D). Pulls firmographic data, intent signals, and prior interactions; returns a fit score, the reasoning, and a suggested next-best-action.     Args:         message: Free-text objective for the action.         lead_id: CRM lead/contact ID.         lead_email: Lead email (alternative to lead_id).         company_domain: Company domain to enrich from.

Source: `lightbulb/mcp_generated_tools.py:2616`.

### `crm_objection_handling`

Namespace: `crm`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
crm_objection_handling(message: str='', inputs: str='{}') -> str
~~~


Run the crm domain agent action `objection_handling`.

Source: `lightbulb/mcp_generated_tools.py:2688`.

### `crm_outbound_messaging`

Namespace: `crm`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
crm_outbound_messaging(message: str='', contact_id: Optional[str]=None, channel: str='email', intent: Optional[str]=None, tone: Optional[str]=None) -> str
~~~


Draft a personalised outbound message to a prospect (cold email, LinkedIn, follow-up, etc) tailored to your ICP, value props, and the prospect's role and recent activity.     Args:         message: Free-text objective for the action.         contact_id: CRM contact ID.         channel: One of: email, linkedin, sms.         intent: Goal of the message: intro, demo_book, follow_up, reactivation, expansion.         tone: Tone hint: warm, direct, technical, executive.

Source: `lightbulb/mcp_generated_tools.py:2639`.

### `crm_plan_domain_intelligence`

Namespace: `crm`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
crm_plan_domain_intelligence(message: str='', inputs: str='{}') -> str
~~~


Run the crm domain agent action `plan_domain_intelligence`.

Source: `lightbulb/mcp_generated_tools.py:3077`.

### `crm_plan_sequence`

Namespace: `crm`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
crm_plan_sequence(message: str='', inputs: str='{}') -> str
~~~


Run the crm domain agent action `plan_sequence`.

Source: `lightbulb/mcp_generated_tools.py:2857`.

### `crm_propose_meeting_slots`

Namespace: `crm`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
crm_propose_meeting_slots(message: str='', inputs: str='{}') -> str
~~~


Run the crm domain agent action `propose_meeting_slots`.

Source: `lightbulb/mcp_generated_tools.py:2967`.

### `crm_query_data`

Namespace: `crm`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
crm_query_data(message: str='', inputs: str='{}') -> str
~~~


Run the crm domain agent action `query_data`.

Source: `lightbulb/mcp_generated_tools.py:2594`.

### `crm_sales_call_intelligence`

Namespace: `crm`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
crm_sales_call_intelligence(message: str='', call_id: Optional[str]=None, transcript_url: Optional[str]=None, framework: str='MEDDPICC') -> str
~~~


Analyse a sales call recording or transcript. Identifies stakeholders, objections, commitments, MEDDPICC signals, and produces a recap email draft plus next-step proposals.     Args:         message: Free-text objective for the action.         call_id: Call ID from your dialer / recording platform.         transcript_url: URL to the call transcript (alternative to call_id).         framework: Sales framework: MEDDPICC, BANT, SPICED.

Source: `lightbulb/mcp_generated_tools.py:2665`.

### `crm_strategize_lead`

Namespace: `crm`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
crm_strategize_lead(message: str='', inputs: str='{}') -> str
~~~


Run the crm domain agent action `strategize_lead`.

Source: `lightbulb/mcp_generated_tools.py:2835`.

### `crm_verify_lead`

Namespace: `crm`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
crm_verify_lead(message: str='', inputs: str='{}') -> str
~~~


Run the crm domain agent action `verify_lead`.

Source: `lightbulb/mcp_generated_tools.py:2901`.

### `customer_success_billing_inquiry_status`

Namespace: `customer_success`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
customer_success_billing_inquiry_status(message: str='', inputs: str='{}') -> str
~~~


Run the customer_success domain agent action `billing_inquiry_status`.

Source: `lightbulb/mcp_generated_tools.py:3297`.

### `customer_success_billing_triage`

Namespace: `customer_success`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
customer_success_billing_triage(message: str='', inputs: str='{}') -> str
~~~


Run the customer_success domain agent action `billing_triage`.

Source: `lightbulb/mcp_generated_tools.py:3275`.

### `customer_success_chat`

Namespace: `customer_success`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
customer_success_chat(message: str='', inputs: str='{}') -> str
~~~


Run the customer_success domain agent action `chat`.

Source: `lightbulb/mcp_generated_tools.py:3099`.

### `customer_success_churn_risk_scan`

Namespace: `customer_success`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
customer_success_churn_risk_scan(message: str='', inputs: str='{}') -> str
~~~


Run the customer_success domain agent action `churn_risk_scan`.

Source: `lightbulb/mcp_generated_tools.py:3121`.

### `customer_success_cs_agentic_plan`

Namespace: `customer_success`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
customer_success_cs_agentic_plan(message: str='', inputs: str='{}') -> str
~~~


Run the customer_success domain agent action `cs_agentic_plan`.

Source: `lightbulb/mcp_generated_tools.py:3253`.

### `customer_success_expansion_playbook`

Namespace: `customer_success`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
customer_success_expansion_playbook(message: str='', inputs: str='{}') -> str
~~~


Run the customer_success domain agent action `expansion_playbook`.

Source: `lightbulb/mcp_generated_tools.py:3209`.

### `customer_success_finance_subscription_renewal_status`

Namespace: `customer_success`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
customer_success_finance_subscription_renewal_status(message: str='', inputs: str='{}') -> str
~~~


Run the customer_success domain agent action `finance_subscription_renewal_status`.

Source: `lightbulb/mcp_generated_tools.py:3341`.

### `customer_success_finance_subscription_renewal_sweep`

Namespace: `customer_success`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
customer_success_finance_subscription_renewal_sweep(message: str='', inputs: str='{}') -> str
~~~


Run the customer_success domain agent action `finance_subscription_renewal_sweep`.

Source: `lightbulb/mcp_generated_tools.py:3319`.

### `customer_success_health_score_report`

Namespace: `customer_success`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
customer_success_health_score_report(message: str='', inputs: str='{}') -> str
~~~


Run the customer_success domain agent action `health_score_report`.

Source: `lightbulb/mcp_generated_tools.py:3231`.

### `customer_success_nps_action_loop`

Namespace: `customer_success`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
customer_success_nps_action_loop(message: str='', inputs: str='{}') -> str
~~~


Run the customer_success domain agent action `nps_action_loop`.

Source: `lightbulb/mcp_generated_tools.py:3165`.

### `customer_success_onboarding_health`

Namespace: `customer_success`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
customer_success_onboarding_health(message: str='', inputs: str='{}') -> str
~~~


Run the customer_success domain agent action `onboarding_health`.

Source: `lightbulb/mcp_generated_tools.py:3187`.

### `customer_success_plan_domain_intelligence`

Namespace: `customer_success`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
customer_success_plan_domain_intelligence(message: str='', inputs: str='{}') -> str
~~~


Run the customer_success domain agent action `plan_domain_intelligence`.

Source: `lightbulb/mcp_generated_tools.py:3363`.

### `customer_success_renewal_pipeline`

Namespace: `customer_success`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
customer_success_renewal_pipeline(message: str='', inputs: str='{}') -> str
~~~


Run the customer_success domain agent action `renewal_pipeline`.

Source: `lightbulb/mcp_generated_tools.py:3143`.

### `data_analyze_dataset`

Namespace: `data`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
data_analyze_dataset(message: str='', inputs: str='{}') -> str
~~~


Run the data domain agent action `analyze_dataset`.

Source: `lightbulb/mcp_generated_tools.py:3517`.

### `data_author_pipeline`

Namespace: `data`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
data_author_pipeline(message: str='', inputs: str='{}') -> str
~~~


Run the data domain agent action `author_pipeline`.

Source: `lightbulb/mcp_generated_tools.py:3429`.

### `data_describe_source`

Namespace: `data`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
data_describe_source(message: str='', inputs: str='{}') -> str
~~~


Run the data domain agent action `describe_source`.

Source: `lightbulb/mcp_generated_tools.py:3407`.

### `data_discover_data`

Namespace: `data`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
data_discover_data(message: str='', inputs: str='{}') -> str
~~~


Run the data domain agent action `discover_data`.

Source: `lightbulb/mcp_generated_tools.py:3385`.

### `data_pipeline_status`

Namespace: `data`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
data_pipeline_status(message: str='', inputs: str='{}') -> str
~~~


Run the data domain agent action `pipeline_status`.

Source: `lightbulb/mcp_generated_tools.py:3473`.

### `data_plan_domain_intelligence`

Namespace: `data`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
data_plan_domain_intelligence(message: str='', inputs: str='{}') -> str
~~~


Run the data domain agent action `plan_domain_intelligence`.

Source: `lightbulb/mcp_generated_tools.py:3583`.

### `data_profile_dataset`

Namespace: `data`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
data_profile_dataset(message: str='', inputs: str='{}') -> str
~~~


Run the data domain agent action `profile_dataset`.

Source: `lightbulb/mcp_generated_tools.py:3539`.

### `data_run_pipeline`

Namespace: `data`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
data_run_pipeline(message: str='', inputs: str='{}') -> str
~~~


Run the data domain agent action `run_pipeline`.

Source: `lightbulb/mcp_generated_tools.py:3451`.

### `data_search_knowledge`

Namespace: `data`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
data_search_knowledge(message: str='', inputs: str='{}') -> str
~~~


Run the data domain agent action `search_knowledge`.

Source: `lightbulb/mcp_generated_tools.py:3561`.

### `data_submit_job`

Namespace: `data`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
data_submit_job(message: str='', inputs: str='{}') -> str
~~~


Run the data domain agent action `submit_job`.

Source: `lightbulb/mcp_generated_tools.py:3495`.

### `deep_research_chat`

Namespace: `deep_research`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
deep_research_chat(message: str='', inputs: str='{}') -> str
~~~


Run the deep_research domain agent action `chat`.

Source: `lightbulb/mcp_generated_tools.py:3605`.

### `deep_research_plan_domain_intelligence`

Namespace: `deep_research`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
deep_research_plan_domain_intelligence(message: str='', inputs: str='{}') -> str
~~~


Run the deep_research domain agent action `plan_domain_intelligence`.

Source: `lightbulb/mcp_generated_tools.py:3671`.

### `deep_research_research_query`

Namespace: `deep_research`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
deep_research_research_query(message: str='', inputs: str='{}') -> str
~~~


Run the deep_research domain agent action `research_query`.

Source: `lightbulb/mcp_generated_tools.py:3649`.

### `deep_research_synthesize`

Namespace: `deep_research`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
deep_research_synthesize(message: str='', inputs: str='{}') -> str
~~~


Run the deep_research domain agent action `synthesize`.

Source: `lightbulb/mcp_generated_tools.py:3627`.

### `document_intelligence_chat`

Namespace: `document_intelligence`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
document_intelligence_chat(message: str='', inputs: str='{}') -> str
~~~


Run the document_intelligence domain agent action `chat`.

Source: `lightbulb/mcp_generated_tools.py:3693`.

### `document_intelligence_create_marketing_collateral`

Namespace: `document_intelligence`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
document_intelligence_create_marketing_collateral(message: str='', inputs: str='{}') -> str
~~~


Run the document_intelligence domain agent action `create_marketing_collateral`.

Source: `lightbulb/mcp_generated_tools.py:3869`.

### `document_intelligence_create_marketing_document`

Namespace: `document_intelligence`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
document_intelligence_create_marketing_document(message: str='', inputs: str='{}') -> str
~~~


Run the document_intelligence domain agent action `create_marketing_document`.

Source: `lightbulb/mcp_generated_tools.py:3847`.

### `document_intelligence_create_report`

Namespace: `document_intelligence`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
document_intelligence_create_report(message: str='', inputs: str='{}') -> str
~~~


Run the document_intelligence domain agent action `create_report`.

Source: `lightbulb/mcp_generated_tools.py:3825`.

### `document_intelligence_create_sales_collateral`

Namespace: `document_intelligence`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
document_intelligence_create_sales_collateral(message: str='', inputs: str='{}') -> str
~~~


Run the document_intelligence domain agent action `create_sales_collateral`.

Source: `lightbulb/mcp_generated_tools.py:3891`.

### `document_intelligence_create_slide_deck`

Namespace: `document_intelligence`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
document_intelligence_create_slide_deck(message: str='', inputs: str='{}') -> str
~~~


Run the document_intelligence domain agent action `create_slide_deck`.

Source: `lightbulb/mcp_generated_tools.py:3935`.

### `document_intelligence_create_spreadsheet`

Namespace: `document_intelligence`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
document_intelligence_create_spreadsheet(message: str='', inputs: str='{}') -> str
~~~


Run the document_intelligence domain agent action `create_spreadsheet`.

Source: `lightbulb/mcp_generated_tools.py:3913`.

### `document_intelligence_grep_content`

Namespace: `document_intelligence`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
document_intelligence_grep_content(message: str='', inputs: str='{}') -> str
~~~


Run the document_intelligence domain agent action `grep_content`.

Source: `lightbulb/mcp_generated_tools.py:3737`.

### `document_intelligence_list_folder`

Namespace: `document_intelligence`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
document_intelligence_list_folder(message: str='', inputs: str='{}') -> str
~~~


Run the document_intelligence domain agent action `list_folder`.

Source: `lightbulb/mcp_generated_tools.py:3759`.

### `document_intelligence_plan_domain_intelligence`

Namespace: `document_intelligence`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
document_intelligence_plan_domain_intelligence(message: str='', inputs: str='{}') -> str
~~~


Run the document_intelligence domain agent action `plan_domain_intelligence`.

Source: `lightbulb/mcp_generated_tools.py:4001`.

### `document_intelligence_publish_document`

Namespace: `document_intelligence`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
document_intelligence_publish_document(message: str='', inputs: str='{}') -> str
~~~


Run the document_intelligence domain agent action `publish_document`.

Source: `lightbulb/mcp_generated_tools.py:3979`.

### `document_intelligence_search_documents`

Namespace: `document_intelligence`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
document_intelligence_search_documents(message: str='', inputs: str='{}') -> str
~~~


Run the document_intelligence domain agent action `search_documents`.

Source: `lightbulb/mcp_generated_tools.py:3715`.

### `document_intelligence_search_folder`

Namespace: `document_intelligence`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
document_intelligence_search_folder(message: str='', inputs: str='{}') -> str
~~~


Run the document_intelligence domain agent action `search_folder`.

Source: `lightbulb/mcp_generated_tools.py:3781`.

### `document_intelligence_update_document`

Namespace: `document_intelligence`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
document_intelligence_update_document(message: str='', inputs: str='{}') -> str
~~~


Run the document_intelligence domain agent action `update_document`.

Source: `lightbulb/mcp_generated_tools.py:3957`.

### `document_intelligence_write_document`

Namespace: `document_intelligence`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
document_intelligence_write_document(message: str='', inputs: str='{}') -> str
~~~


Run the document_intelligence domain agent action `write_document`.

Source: `lightbulb/mcp_generated_tools.py:3803`.

### `engineering_chat`

Namespace: `engineering`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
engineering_chat(message: str='', inputs: str='{}') -> str
~~~


Run the engineering domain agent action `chat`.

Source: `lightbulb/mcp_generated_tools.py:4023`.

### `engineering_compare_model_versions`

Namespace: `engineering`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
engineering_compare_model_versions(message: str='', inputs: str='{}') -> str
~~~


Run the engineering domain agent action `compare_model_versions`.

Source: `lightbulb/mcp_generated_tools.py:4133`.

### `engineering_create_spec`

Namespace: `engineering`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
engineering_create_spec(message: str='', inputs: str='{}') -> str
~~~


Run the engineering domain agent action `create_spec`.

Source: `lightbulb/mcp_generated_tools.py:4045`.

### `engineering_design_loop`

Namespace: `engineering`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
engineering_design_loop(message: str='', inputs: str='{}') -> str
~~~


Run the engineering domain agent action `engineering_design_loop`.

Source: `lightbulb/mcp_generated_tools.py:4067`.

### `engineering_plan_domain_intelligence`

Namespace: `engineering`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
engineering_plan_domain_intelligence(message: str='', inputs: str='{}') -> str
~~~


Run the engineering domain agent action `plan_domain_intelligence`.

Source: `lightbulb/mcp_generated_tools.py:4199`.

### `engineering_query_analytics`

Namespace: `engineering`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
engineering_query_analytics(message: str='', inputs: str='{}') -> str
~~~


Run the engineering domain agent action `query_analytics`.

Source: `lightbulb/mcp_generated_tools.py:4177`.

### `engineering_run_clash_analysis`

Namespace: `engineering`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
engineering_run_clash_analysis(message: str='', inputs: str='{}') -> str
~~~


Run the engineering domain agent action `run_clash_analysis`.

Source: `lightbulb/mcp_generated_tools.py:4089`.

### `engineering_search_project_drawings`

Namespace: `engineering`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
engineering_search_project_drawings(message: str='', inputs: str='{}') -> str
~~~


Run the engineering domain agent action `search_project_drawings`.

Source: `lightbulb/mcp_generated_tools.py:4155`.

### `engineering_sensor_anomaly_detection`

Namespace: `engineering`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
engineering_sensor_anomaly_detection(message: str='', inputs: str='{}') -> str
~~~


Run the engineering domain agent action `sensor_anomaly_detection`.

Source: `lightbulb/mcp_generated_tools.py:4111`.

### `excel_add_worksheet`

Namespace: `excel`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
excel_add_worksheet(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Excel connector operation `add_worksheet` (platform tool `excel.add_worksheet`).

Source: `lightbulb/mcp_generated_tools.py:16745`.

### `excel_get_range`

Namespace: `excel`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
excel_get_range(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Excel connector operation `get_range` (platform tool `excel.get_range`).

Source: `lightbulb/mcp_generated_tools.py:16790`.

### `excel_list_worksheets`

Namespace: `excel`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
excel_list_worksheets(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Excel connector operation `list_worksheets` (platform tool `excel.list_worksheets`).

Source: `lightbulb/mcp_generated_tools.py:16835`.

### `excel_update_range`

Namespace: `excel`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
excel_update_range(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Excel connector operation `update_range` (platform tool `excel.update_range`).

Source: `lightbulb/mcp_generated_tools.py:16880`.

### `expensify_list_expenses`

Namespace: `expensify`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
expensify_list_expenses(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Expensify connector operation `list_expenses` (platform tool `expensify.list_expenses`).

Source: `lightbulb/mcp_generated_tools.py:16925`.

### `expensify_list_policies`

Namespace: `expensify`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
expensify_list_policies(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Expensify connector operation `list_policies` (platform tool `expensify.list_policies`).

Source: `lightbulb/mcp_generated_tools.py:16970`.

### `expensify_list_reports`

Namespace: `expensify`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
expensify_list_reports(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Expensify connector operation `list_reports` (platform tool `expensify.list_reports`).

Source: `lightbulb/mcp_generated_tools.py:17015`.

### `facebook_publish_post`

Namespace: `facebook`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
facebook_publish_post(page_id: Optional[str]=None, message: Optional[str]=None, image_url: Optional[str]=None, *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Publish one approved post to the exact Facebook Page bound to the authenticated project connector route.

Source: `lightbulb/mcp_generated_tools.py:17060`.

### `finance_aging`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_aging(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_aging`.

Source: `lightbulb/mcp_generated_tools.py:4422`.

### `finance_anomaly_fraud_case_file`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_anomaly_fraud_case_file(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_anomaly_fraud_case_file`.

Source: `lightbulb/mcp_generated_tools.py:4642`.

### `finance_anomaly_investigation`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_anomaly_investigation(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_anomaly_investigation`.

Source: `lightbulb/mcp_generated_tools.py:5613`.

### `finance_ap_invoice_intake`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_ap_invoice_intake(message: str='', invoice_url: Optional[str]=None, invoice_text: Optional[str]=None, expected_vendor: Optional[str]=None) -> str
~~~


Ingest an accounts-payable invoice (PDF, image, or email body) and extract a structured payable: vendor, line items, totals, GL coding, due date, payment terms, and any anomalies (duplicate, off-contract, amount drift).     Args:         message: Free-text objective for the action.         invoice_url: Signed URL or platform artifact URI for the invoice file.         invoice_text: Raw invoice text (alternative to invoice_url).         expected_vendor: Optional vendor name to validate against.

Source: `lightbulb/mcp_generated_tools.py:5500`.

### `finance_autocompany_finance_loop`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_autocompany_finance_loop(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `autocompany_finance_loop`.

Source: `lightbulb/mcp_generated_tools.py:5922`.

### `finance_automl_forecast`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_automl_forecast(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_automl_forecast`.

Source: `lightbulb/mcp_generated_tools.py:4444`.

### `finance_autonomous_finance_loop`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_autonomous_finance_loop(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `autonomous_finance_loop`.

Source: `lightbulb/mcp_generated_tools.py:5900`.

### `finance_board_dashboard_page`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_board_dashboard_page(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `board_dashboard_page`.

Source: `lightbulb/mcp_generated_tools.py:4708`.

### `finance_board_meeting_packet_generation`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_board_meeting_packet_generation(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `board_meeting_packet_generation`.

Source: `lightbulb/mcp_generated_tools.py:4730`.

### `finance_board_pack`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_board_pack(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_board_pack`.

Source: `lightbulb/mcp_generated_tools.py:4686`.

### `finance_board_pack_operating_loop`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_board_pack_operating_loop(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_board_pack_operating_loop`.

Source: `lightbulb/mcp_generated_tools.py:6762`.

### `finance_capital_allocation_analysis`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_capital_allocation_analysis(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `capital_allocation_analysis`.

Source: `lightbulb/mcp_generated_tools.py:5812`.

### `finance_capital_allocation_loop`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_capital_allocation_loop(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `capital_allocation_loop`.

Source: `lightbulb/mcp_generated_tools.py:5834`.

### `finance_capital_structure_cost_of_capital`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_capital_structure_cost_of_capital(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_capital_structure_cost_of_capital`.

Source: `lightbulb/mcp_generated_tools.py:4994`.

### `finance_chat`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_chat(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `chat`.

Source: `lightbulb/mcp_generated_tools.py:4221`.

### `finance_close_governance_loop`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_close_governance_loop(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_close_governance_loop`.

Source: `lightbulb/mcp_generated_tools.py:6740`.

### `finance_collections_priority`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_collections_priority(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `collections_priority`.

Source: `lightbulb/mcp_generated_tools.py:4400`.

### `finance_collections_to_crm_tasks`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_collections_to_crm_tasks(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_collections_to_crm_tasks`.

Source: `lightbulb/mcp_generated_tools.py:4796`.

### `finance_corporate_issuers_review`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_corporate_issuers_review(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_corporate_issuers_review`.

Source: `lightbulb/mcp_generated_tools.py:5724`.

### `finance_credit_risk_to_crm_health`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_credit_risk_to_crm_health(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_credit_risk_to_crm_health`.

Source: `lightbulb/mcp_generated_tools.py:4862`.

### `finance_data_room_collation_packet`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_data_room_collation_packet(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `data_room_collation_packet`.

Source: `lightbulb/mcp_generated_tools.py:5988`.

### `finance_dcf_lbo_spreadsheet`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_dcf_lbo_spreadsheet(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_dcf_lbo_spreadsheet`.

Source: `lightbulb/mcp_generated_tools.py:4598`.

### `finance_deep_research_due_diligence`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_deep_research_due_diligence(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_deep_research_due_diligence`.

Source: `lightbulb/mcp_generated_tools.py:4466`.

### `finance_domain_artifact_handoff`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_domain_artifact_handoff(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `domain_artifact_handoff`.

Source: `lightbulb/mcp_generated_tools.py:4774`.

### `finance_due_diligence`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_due_diligence(message: str='', target_company: Optional[str]=None, data_room_url: Optional[str]=None, focus_areas: Optional[list[str]]=None) -> str
~~~


Run a finance due-diligence pass across a target's financials, uncovering quality-of-earnings adjustments, working-capital trends, customer concentration, and red flags. Produces a banker-grade memo.     Args:         message: Free-text objective for the action.         target_company (required): Target company name.         data_room_url: VDR root URL (Datasite, Intralinks, Drive, etc).         focus_areas: Optional list of areas to emphasise.

Source: `lightbulb/mcp_generated_tools.py:5657`.

### `finance_due_diligence_packet`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_due_diligence_packet(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_due_diligence_packet`.

Source: `lightbulb/mcp_generated_tools.py:4576`.

### `finance_dunning_outreach`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_dunning_outreach(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_dunning_outreach`.

Source: `lightbulb/mcp_generated_tools.py:4818`.

### `finance_equity_research_macro_synthesis`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_equity_research_macro_synthesis(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `equity_research_macro_synthesis`.

Source: `lightbulb/mcp_generated_tools.py:4488`.

### `finance_financial_advice_foreign_exchange_au`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_financial_advice_foreign_exchange_au(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `financial_advice_foreign_exchange_au`.

Source: `lightbulb/mcp_generated_tools.py:6652`.

### `finance_financial_advice_foreign_exchange_ca`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_financial_advice_foreign_exchange_ca(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `financial_advice_foreign_exchange_ca`.

Source: `lightbulb/mcp_generated_tools.py:6674`.

### `finance_financial_advice_life_insurance_au`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_financial_advice_life_insurance_au(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `financial_advice_life_insurance_au`.

Source: `lightbulb/mcp_generated_tools.py:6520`.

### `finance_financial_advice_life_insurance_ca`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_financial_advice_life_insurance_ca(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `financial_advice_life_insurance_ca`.

Source: `lightbulb/mcp_generated_tools.py:6542`.

### `finance_financial_advice_mortgage_finance_au`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_financial_advice_mortgage_finance_au(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `financial_advice_mortgage_finance_au`.

Source: `lightbulb/mcp_generated_tools.py:6564`.

### `finance_financial_advice_mortgage_finance_ca`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_financial_advice_mortgage_finance_ca(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `financial_advice_mortgage_finance_ca`.

Source: `lightbulb/mcp_generated_tools.py:6586`.

### `finance_financial_advice_personal_investments_au`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_financial_advice_personal_investments_au(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `financial_advice_personal_investments_au`.

Source: `lightbulb/mcp_generated_tools.py:6608`.

### `finance_financial_advice_personal_investments_ca`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_financial_advice_personal_investments_ca(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `financial_advice_personal_investments_ca`.

Source: `lightbulb/mcp_generated_tools.py:6630`.

### `finance_finops_attribution`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_finops_attribution(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_finops_attribution`.

Source: `lightbulb/mcp_generated_tools.py:4532`.

### `finance_forecast_interpretation`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_forecast_interpretation(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_forecast_interpretation`.

Source: `lightbulb/mcp_generated_tools.py:5569`.

### `finance_forecast_sensitivity`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_forecast_sensitivity(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_forecast_sensitivity`.

Source: `lightbulb/mcp_generated_tools.py:5016`.

### `finance_forecasting`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_forecasting(message: str='', horizon_months: int=12, scenario: Optional[str]=None, driver_overrides: Optional[dict]=None) -> str
~~~


Build a rolling cash and P&L forecast from your ledger data and company drivers. Returns a month-by-month projection, scenario comparisons, and a written interpretation of inflection points.     Args:         message: Free-text objective for the action.         horizon_months: Forecast horizon (default 12 months).         scenario: Scenario name: base, bull, bear, or a custom label.         driver_overrides: Override drivers as JSON dict (e.g. {"revenue_growth": 0.15}).

Source: `lightbulb/mcp_generated_tools.py:5546`.

### `finance_fraud_investigation`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_fraud_investigation(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_fraud_investigation`.

Source: `lightbulb/mcp_generated_tools.py:5635`.

### `finance_fsa_review`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_fsa_review(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_fsa_review`.

Source: `lightbulb/mcp_generated_tools.py:5702`.

### `finance_fund_metrics`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_fund_metrics(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_fund_metrics`.

Source: `lightbulb/mcp_generated_tools.py:6388`.

### `finance_funding_program_intake`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_funding_program_intake(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `funding_program_intake`.

Source: `lightbulb/mcp_generated_tools.py:6010`.

### `finance_funding_readiness_assessment`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_funding_readiness_assessment(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `funding_readiness_assessment`.

Source: `lightbulb/mcp_generated_tools.py:5944`.

### `finance_funding_readiness_loop`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_funding_readiness_loop(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `funding_readiness_loop`.

Source: `lightbulb/mcp_generated_tools.py:5966`.

### `finance_goal_execute_wave`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_goal_execute_wave(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `goal_execute_wave`.

Source: `lightbulb/mcp_generated_tools.py:6186`.

### `finance_goal_full_lifecycle_loop`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_goal_full_lifecycle_loop(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `goal_full_lifecycle_loop`.

Source: `lightbulb/mcp_generated_tools.py:6252`.

### `finance_goal_plan`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_goal_plan(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `goal_plan`.

Source: `lightbulb/mcp_generated_tools.py:6164`.

### `finance_goal_record_task_result`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_goal_record_task_result(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `goal_record_task_result`.

Source: `lightbulb/mcp_generated_tools.py:6208`.

### `finance_goal_replan`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_goal_replan(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `goal_replan`.

Source: `lightbulb/mcp_generated_tools.py:6230`.

### `finance_goal_understand`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_goal_understand(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `goal_understand`.

Source: `lightbulb/mcp_generated_tools.py:6142`.

### `finance_grant_application_compile`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_grant_application_compile(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `grant_application_compile`.

Source: `lightbulb/mcp_generated_tools.py:6076`.

### `finance_grant_application_completion`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_grant_application_completion(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `grant_application_completion`.

Source: `lightbulb/mcp_generated_tools.py:6098`.

### `finance_grant_application_extraction`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_grant_application_extraction(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `grant_application_extraction`.

Source: `lightbulb/mcp_generated_tools.py:6054`.

### `finance_grant_full_lifecycle_loop`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_grant_full_lifecycle_loop(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `grant_full_lifecycle_loop`.

Source: `lightbulb/mcp_generated_tools.py:6120`.

### `finance_grant_program_discovery`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_grant_program_discovery(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `grant_program_discovery`.

Source: `lightbulb/mcp_generated_tools.py:6032`.

### `finance_growth_equity_valuation`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_growth_equity_valuation(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_growth_equity_valuation`.

Source: `lightbulb/mcp_generated_tools.py:6340`.

### `finance_human_capital_cloud_margin`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_human_capital_cloud_margin(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_human_capital_cloud_margin`.

Source: `lightbulb/mcp_generated_tools.py:6806`.

### `finance_ic_memo_doc`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_ic_memo_doc(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_ic_memo_doc`.

Source: `lightbulb/mcp_generated_tools.py:4554`.

### `finance_investment_agent_capital_portfolio`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_investment_agent_capital_portfolio(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `investment_agent_capital_portfolio`.

Source: `lightbulb/mcp_generated_tools.py:5214`.

### `finance_investment_alpha_discovery`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_investment_alpha_discovery(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `investment_alpha_discovery`.

Source: `lightbulb/mcp_generated_tools.py:5170`.

### `finance_investment_alpha_training_pipeline`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_investment_alpha_training_pipeline(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `investment_alpha_training_pipeline`.

Source: `lightbulb/mcp_generated_tools.py:5192`.

### `finance_investment_broker_account_snapshot`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_investment_broker_account_snapshot(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `investment_broker_account_snapshot`.

Source: `lightbulb/mcp_generated_tools.py:5412`.

### `finance_investment_broker_readiness_check`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_investment_broker_readiness_check(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `investment_broker_readiness_check`.

Source: `lightbulb/mcp_generated_tools.py:5456`.

### `finance_investment_capital_compute_rebalance`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_investment_capital_compute_rebalance(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `investment_capital_compute_rebalance`.

Source: `lightbulb/mcp_generated_tools.py:5236`.

### `finance_investment_cash_movement_request`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_investment_cash_movement_request(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `investment_cash_movement_request`.

Source: `lightbulb/mcp_generated_tools.py:5478`.

### `finance_investment_committee_memo`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_investment_committee_memo(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_investment_committee_memo`.

Source: `lightbulb/mcp_generated_tools.py:6410`.

### `finance_investment_feature_engineering`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_investment_feature_engineering(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `investment_feature_engineering`.

Source: `lightbulb/mcp_generated_tools.py:5148`.

### `finance_investment_financial_intelligence_team`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_investment_financial_intelligence_team(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `investment_financial_intelligence_team`.

Source: `lightbulb/mcp_generated_tools.py:5258`.

### `finance_investment_market_data_snapshot`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_investment_market_data_snapshot(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `investment_market_data_snapshot`.

Source: `lightbulb/mcp_generated_tools.py:5434`.

### `finance_investment_paper_observation_program`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_investment_paper_observation_program(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `investment_paper_observation_program`.

Source: `lightbulb/mcp_generated_tools.py:5368`.

### `finance_investment_paper_trade_runbook`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_investment_paper_trade_runbook(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `investment_paper_trade_runbook`.

Source: `lightbulb/mcp_generated_tools.py:5346`.

### `finance_investment_portfolio_backtest`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_investment_portfolio_backtest(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `investment_portfolio_backtest`.

Source: `lightbulb/mcp_generated_tools.py:5126`.

### `finance_investment_trade_execution_gate`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_investment_trade_execution_gate(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `investment_trade_execution_gate`.

Source: `lightbulb/mcp_generated_tools.py:5302`.

### `finance_investment_trade_execution_reconciliation`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_investment_trade_execution_reconciliation(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `investment_trade_execution_reconciliation`.

Source: `lightbulb/mcp_generated_tools.py:5324`.

### `finance_investment_trader_orchestration_loop`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_investment_trader_orchestration_loop(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `investment_trader_orchestration_loop`.

Source: `lightbulb/mcp_generated_tools.py:5280`.

### `finance_investment_trading_agent`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_investment_trading_agent(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `investment_trading_agent`.

Source: `lightbulb/mcp_generated_tools.py:5060`.

### `finance_investment_trading_model_lifecycle`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_investment_trading_model_lifecycle(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `investment_trading_model_lifecycle`.

Source: `lightbulb/mcp_generated_tools.py:5104`.

### `finance_investment_trading_signal`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_investment_trading_signal(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `investment_trading_signal`.

Source: `lightbulb/mcp_generated_tools.py:5082`.

### `finance_investment_trading_system_canary`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_investment_trading_system_canary(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `investment_trading_system_canary`.

Source: `lightbulb/mcp_generated_tools.py:5390`.

### `finance_lbo_model`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_lbo_model(message: str='', target_company: Optional[str]=None, entry_multiple: Optional[float]=None, leverage_ratio: Optional[float]=None, hold_period_years: int=5) -> str
~~~


Build a leveraged buyout model for a target company. Outputs sources & uses, debt schedule, returns waterfall (IRR, MOIC), sensitivity tables, and an investment-committee-ready summary memo.     Args:         message: Free-text objective for the action.         target_company (required): Target company name or ticker.         entry_multiple: Entry EV/EBITDA multiple.         leverage_ratio: Net debt / EBITDA at close.         hold_period_years: Investment hold period (default 5 years).

Source: `lightbulb/mcp_generated_tools.py:6362`.

### `finance_ledger_event_consumer`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_ledger_event_consumer(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_ledger_event_consumer`.

Source: `lightbulb/mcp_generated_tools.py:4510`.

### `finance_list_cross_domain_scenarios`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_list_cross_domain_scenarios(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `list_cross_domain_scenarios`.

Source: `lightbulb/mcp_generated_tools.py:6296`.

### `finance_ma_integration_forensic`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_ma_integration_forensic(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_ma_integration_forensic`.

Source: `lightbulb/mcp_generated_tools.py:6784`.

### `finance_mna_pro_forma`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_mna_pro_forma(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_mna_pro_forma`.

Source: `lightbulb/mcp_generated_tools.py:5746`.

### `finance_payroll`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_payroll(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_payroll`.

Source: `lightbulb/mcp_generated_tools.py:6498`.

### `finance_peer_valuation_multiples`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_peer_valuation_multiples(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_peer_valuation_multiples`.

Source: `lightbulb/mcp_generated_tools.py:5038`.

### `finance_plan_domain_intelligence`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_plan_domain_intelligence(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `plan_domain_intelligence`.

Source: `lightbulb/mcp_generated_tools.py:7157`.

### `finance_portfolio_monitoring`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_portfolio_monitoring(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_portfolio_monitoring`.

Source: `lightbulb/mcp_generated_tools.py:6432`.

### `finance_pricing_decomposition`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_pricing_decomposition(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_pricing_decomposition`.

Source: `lightbulb/mcp_generated_tools.py:4928`.

### `finance_private_company_valuation`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_private_company_valuation(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_private_company_valuation`.

Source: `lightbulb/mcp_generated_tools.py:5768`.

### `finance_product_finance_analysis`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_product_finance_analysis(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `product_finance_analysis`.

Source: `lightbulb/mcp_generated_tools.py:5878`.

### `finance_project_finance_analysis`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_project_finance_analysis(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `project_finance_analysis`.

Source: `lightbulb/mcp_generated_tools.py:5856`.

### `finance_project_valuation`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_project_valuation(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_project_valuation`.

Source: `lightbulb/mcp_generated_tools.py:5790`.

### `finance_qoe_workbook`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_qoe_workbook(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_qoe_workbook`.

Source: `lightbulb/mcp_generated_tools.py:4620`.

### `finance_qoe_working_capital`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_qoe_working_capital(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_qoe_working_capital`.

Source: `lightbulb/mcp_generated_tools.py:6318`.

### `finance_quarterly_ir_pack`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_quarterly_ir_pack(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_quarterly_ir_pack`.

Source: `lightbulb/mcp_generated_tools.py:4664`.

### `finance_query_data`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_query_data(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `query_data`.

Source: `lightbulb/mcp_generated_tools.py:4243`.

### `finance_ratio_dupont_analysis`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_ratio_dupont_analysis(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_ratio_dupont_analysis`.

Source: `lightbulb/mcp_generated_tools.py:4950`.

### `finance_reconciliation_exceptions`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_reconciliation_exceptions(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_reconciliation_exceptions`.

Source: `lightbulb/mcp_generated_tools.py:7135`.

### `finance_reconciliation_sweep`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_reconciliation_sweep(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_reconciliation_sweep`.

Source: `lightbulb/mcp_generated_tools.py:7113`.

### `finance_revenue_leakage`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_revenue_leakage(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_revenue_leakage`.

Source: `lightbulb/mcp_generated_tools.py:6454`.

### `finance_risk_monitoring`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_risk_monitoring(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_risk_monitoring`.

Source: `lightbulb/mcp_generated_tools.py:5591`.

### `finance_run_cross_domain_scenario`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_run_cross_domain_scenario(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `run_cross_domain_scenario`.

Source: `lightbulb/mcp_generated_tools.py:6274`.

### `finance_saas_board_pack`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_saas_board_pack(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_saas_board_pack`.

Source: `lightbulb/mcp_generated_tools.py:7047`.

### `finance_saas_metrics`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_saas_metrics(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_saas_metrics`.

Source: `lightbulb/mcp_generated_tools.py:7025`.

### `finance_spreadsheet_tie_out`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_spreadsheet_tie_out(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_spreadsheet_tie_out`.

Source: `lightbulb/mcp_generated_tools.py:5524`.

### `finance_statement_ingest`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_statement_ingest(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_statement_ingest`.

Source: `lightbulb/mcp_generated_tools.py:5680`.

### `finance_story_discovery`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_story_discovery(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_story_discovery`.

Source: `lightbulb/mcp_generated_tools.py:4906`.

### `finance_stripe_dunning_recovery`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_stripe_dunning_recovery(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_stripe_dunning_recovery`.

Source: `lightbulb/mcp_generated_tools.py:4356`.

### `finance_stripe_failed_payment_recovery`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_stripe_failed_payment_recovery(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_stripe_failed_payment_recovery`.

Source: `lightbulb/mcp_generated_tools.py:4334`.

### `finance_stripe_ledger_reconciliation`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_stripe_ledger_reconciliation(message: str='', month: Optional[str]=None, statement_url: Optional[str]=None, materiality_threshold_usd: Optional[float]=None) -> str
~~~


Reconcile Stripe payment activity against your accounting ledger.

Source: `lightbulb/mcp_generated_tools.py:4265`.

### `finance_stripe_orchestrator`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_stripe_orchestrator(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_stripe_orchestrator`.

Source: `lightbulb/mcp_generated_tools.py:4290`.

### `finance_stripe_revenue_audit`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_stripe_revenue_audit(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_stripe_revenue_audit`.

Source: `lightbulb/mcp_generated_tools.py:4312`.

### `finance_stripe_subscription_health`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_stripe_subscription_health(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_stripe_subscription_health`.

Source: `lightbulb/mcp_generated_tools.py:4378`.

### `finance_stripe_xero_writeback_fanout`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_stripe_xero_writeback_fanout(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `stripe_xero_writeback_fanout`.

Source: `lightbulb/mcp_generated_tools.py:4840`.

### `finance_subscription_health_to_expansion`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_subscription_health_to_expansion(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_subscription_health_to_expansion`.

Source: `lightbulb/mcp_generated_tools.py:4884`.

### `finance_subscription_renewal_status`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_subscription_renewal_status(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_subscription_renewal_status`.

Source: `lightbulb/mcp_generated_tools.py:7091`.

### `finance_subscription_renewal_sweep`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_subscription_renewal_sweep(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_subscription_renewal_sweep`.

Source: `lightbulb/mcp_generated_tools.py:7069`.

### `finance_tax_workflow`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_tax_workflow(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_tax_workflow`.

Source: `lightbulb/mcp_generated_tools.py:6696`.

### `finance_treasury_risk_loop`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_treasury_risk_loop(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_treasury_risk_loop`.

Source: `lightbulb/mcp_generated_tools.py:6718`.

### `finance_treasury_runway_dashboard`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_treasury_runway_dashboard(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `treasury_runway_dashboard`.

Source: `lightbulb/mcp_generated_tools.py:4752`.

### `finance_treasury_support`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_treasury_support(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_treasury_support`.

Source: `lightbulb/mcp_generated_tools.py:6476`.

### `finance_working_capital_efficiency`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_working_capital_efficiency(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `finance_working_capital_efficiency`.

Source: `lightbulb/mcp_generated_tools.py:4972`.

### `finance_xero_ap_intake_to_pay`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_xero_ap_intake_to_pay(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `xero_ap_intake_to_pay`.

Source: `lightbulb/mcp_generated_tools.py:6893`.

### `finance_xero_ar_followup`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_xero_ar_followup(message: str='', aging_bucket: Optional[str]=None, min_amount_usd: Optional[float]=None, send: bool=False) -> str
~~~


Triage Xero accounts receivable and draft customer-facing follow-up messages for overdue invoices. Tone, urgency, and channel are tuned to the customer's payment history.     Args:         message: Free-text objective for the action.         aging_bucket: One of: '1-30', '31-60', '61-90', '90+'. Empty = all overdue.         min_amount_usd: Only follow up on invoices above this amount.         send: If true, send messages directly; otherwise return drafts for review.

Source: `lightbulb/mcp_generated_tools.py:6870`.

### `finance_xero_bank_reconciliation`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_xero_bank_reconciliation(message: str='', account_id: Optional[str]=None, from_date: Optional[str]=None, to_date: Optional[str]=None) -> str
~~~


Reconcile Xero bank-feed transactions against the ledger. Auto-matches where confidence is high; surfaces ambiguous matches for review.     Args:         message: Free-text objective for the action.         account_id: Xero bank account ID; empty = all bank accounts.         from_date: Start date (YYYY-MM-DD).         to_date: End date (YYYY-MM-DD).

Source: `lightbulb/mcp_generated_tools.py:6915`.

### `finance_xero_close_books`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_xero_close_books(message: str='', period: Optional[str]=None, auto_post_threshold_usd: Optional[float]=None) -> str
~~~


Run a month-end close on the connected Xero org. Reviews unreconciled transactions, accruals, prepayments, and intercompany eliminations, then proposes adjusting journals for human approval.     Args:         message: Free-text objective for the action.         period: Period to close (YYYY-MM); defaults to last month.         auto_post_threshold_usd: Auto-post journals smaller than this; queue larger ones for approval.

Source: `lightbulb/mcp_generated_tools.py:6850`.

### `finance_xero_consolidation`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_xero_consolidation(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `xero_consolidation`.

Source: `lightbulb/mcp_generated_tools.py:6981`.

### `finance_xero_org_overview`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_xero_org_overview(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `xero_org_overview`.

Source: `lightbulb/mcp_generated_tools.py:6828`.

### `finance_xero_payroll_trueup`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_xero_payroll_trueup(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `xero_payroll_trueup`.

Source: `lightbulb/mcp_generated_tools.py:6937`.

### `finance_xero_reconciliation_review`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_xero_reconciliation_review(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `xero_reconciliation_review`.

Source: `lightbulb/mcp_generated_tools.py:7003`.

### `finance_xero_reporting_pack`

Namespace: `finance`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
finance_xero_reporting_pack(message: str='', inputs: str='{}') -> str
~~~


Run the finance domain agent action `xero_reporting_pack`.

Source: `lightbulb/mcp_generated_tools.py:6959`.

### `freshbooks_list_clients`

Namespace: `freshbooks`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
freshbooks_list_clients(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Freshbooks connector operation `list_clients` (platform tool `freshbooks.list_clients`).

Source: `lightbulb/mcp_generated_tools.py:17097`.

### `freshbooks_list_expenses`

Namespace: `freshbooks`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
freshbooks_list_expenses(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Freshbooks connector operation `list_expenses` (platform tool `freshbooks.list_expenses`).

Source: `lightbulb/mcp_generated_tools.py:17142`.

### `freshbooks_list_invoices`

Namespace: `freshbooks`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
freshbooks_list_invoices(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Freshbooks connector operation `list_invoices` (platform tool `freshbooks.list_invoices`).

Source: `lightbulb/mcp_generated_tools.py:17187`.

### `freshbooks_list_payments`

Namespace: `freshbooks`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
freshbooks_list_payments(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Freshbooks connector operation `list_payments` (platform tool `freshbooks.list_payments`).

Source: `lightbulb/mcp_generated_tools.py:17232`.

### `github_add_labels_to_issue`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_add_labels_to_issue(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Github connector operation `add_labels_to_issue` (platform tool `github.add_labels_to_issue`).

Source: `lightbulb/mcp_generated_tools.py:17277`.

### `github_auto_link_pr_to_jira`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_auto_link_pr_to_jira(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Github connector operation `auto_link_pr_to_jira` (platform tool `github.auto_link_pr_to_jira`).

Source: `lightbulb/mcp_generated_tools.py:17322`.

### `github_branch_prefix`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_branch_prefix(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Github connector operation `branch_prefix` (platform tool `github.branch_prefix`).

Source: `lightbulb/mcp_generated_tools.py:17367`.

### `github_cancel_workflow_run`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_cancel_workflow_run(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Github connector operation `cancel_workflow_run` (platform tool `github.cancel_workflow_run`).

Source: `lightbulb/mcp_generated_tools.py:17412`.

### `github_compare_commits`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_compare_commits(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Github connector operation `compare_commits` (platform tool `github.compare_commits`).

Source: `lightbulb/mcp_generated_tools.py:17457`.

### `github_create_branch_ref`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_create_branch_ref(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Github connector operation `create_branch_ref` (platform tool `github.create_branch_ref`).

Source: `lightbulb/mcp_generated_tools.py:17502`.

### `github_create_check_run`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_create_check_run(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Github connector operation `create_check_run` (platform tool `github.create_check_run`).

Source: `lightbulb/mcp_generated_tools.py:17547`.

### `github_create_deployment_status`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_create_deployment_status(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Github connector operation `create_deployment_status` (platform tool `github.create_deployment_status`).

Source: `lightbulb/mcp_generated_tools.py:17592`.

### `github_create_environment`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_create_environment(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Github connector operation `create_environment` (platform tool `github.create_environment`).

Source: `lightbulb/mcp_generated_tools.py:17637`.

### `github_create_issue`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_create_issue(repo: Optional[str]=None, title: Optional[str]=None, body: Optional[str]=None, labels: Optional[list[str]]=None, assignees: Optional[list[str]]=None, *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Create an issue in a repo.

Source: `lightbulb/mcp_generated_tools.py:17682`.

### `github_create_issue_comment`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_create_issue_comment(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Github connector operation `create_issue_comment` (platform tool `github.create_issue_comment`).

Source: `lightbulb/mcp_generated_tools.py:17725`.

### `github_create_pull_request`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_create_pull_request(repo: Optional[str]=None, title: Optional[str]=None, head: Optional[str]=None, base: str='main', body: Optional[str]=None, *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Create a pull request from a head branch into a base branch.

Source: `lightbulb/mcp_generated_tools.py:17770`.

### `github_create_release`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_create_release(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Github connector operation `create_release` (platform tool `github.create_release`).

Source: `lightbulb/mcp_generated_tools.py:17813`.

### `github_create_repository`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_create_repository(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Github connector operation `create_repository` (platform tool `github.create_repository`).

Source: `lightbulb/mcp_generated_tools.py:17858`.

### `github_create_ruleset`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_create_ruleset(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Github connector operation `create_ruleset` (platform tool `github.create_ruleset`).

Source: `lightbulb/mcp_generated_tools.py:17903`.

### `github_default_org`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_default_org(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Github connector operation `default_org` (platform tool `github.default_org`).

Source: `lightbulb/mcp_generated_tools.py:17948`.

### `github_default_pr_base_branch`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_default_pr_base_branch(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Github connector operation `default_pr_base_branch` (platform tool `github.default_pr_base_branch`).

Source: `lightbulb/mcp_generated_tools.py:17993`.

### `github_default_repo`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_default_repo(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Github connector operation `default_repo` (platform tool `github.default_repo`).

Source: `lightbulb/mcp_generated_tools.py:18038`.

### `github_default_review_required_teams`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_default_review_required_teams(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Github connector operation `default_review_required_teams` (platform tool `github.default_review_required_teams`).

Source: `lightbulb/mcp_generated_tools.py:18083`.

### `github_delete_branch_ref`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_delete_branch_ref(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Github connector operation `delete_branch_ref` (platform tool `github.delete_branch_ref`).

Source: `lightbulb/mcp_generated_tools.py:18128`.

### `github_dismiss_review`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_dismiss_review(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Github connector operation `dismiss_review` (platform tool `github.dismiss_review`).

Source: `lightbulb/mcp_generated_tools.py:18173`.

### `github_dispatch_workflow`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_dispatch_workflow(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Github connector operation `dispatch_workflow` (platform tool `github.dispatch_workflow`).

Source: `lightbulb/mcp_generated_tools.py:18218`.

### `github_get_branch`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_get_branch(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Github connector operation `get_branch` (platform tool `github.get_branch`).

Source: `lightbulb/mcp_generated_tools.py:18263`.

### `github_get_branch_protection`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_get_branch_protection(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Github connector operation `get_branch_protection` (platform tool `github.get_branch_protection`).

Source: `lightbulb/mcp_generated_tools.py:18308`.

### `github_get_issue`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_get_issue(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Github connector operation `get_issue` (platform tool `github.get_issue`).

Source: `lightbulb/mcp_generated_tools.py:18353`.

### `github_get_pull_request`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_get_pull_request(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Github connector operation `get_pull_request` (platform tool `github.get_pull_request`).

Source: `lightbulb/mcp_generated_tools.py:18398`.

### `github_get_workflow_run`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_get_workflow_run(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Github connector operation `get_workflow_run` (platform tool `github.get_workflow_run`).

Source: `lightbulb/mcp_generated_tools.py:18443`.

### `github_get_workflow_run_logs`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_get_workflow_run_logs(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Github connector operation `get_workflow_run_logs` (platform tool `github.get_workflow_run_logs`).

Source: `lightbulb/mcp_generated_tools.py:18488`.

### `github_list_branches`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_list_branches(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Github connector operation `list_branches` (platform tool `github.list_branches`).

Source: `lightbulb/mcp_generated_tools.py:18533`.

### `github_list_check_runs`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_list_check_runs(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Github connector operation `list_check_runs` (platform tool `github.list_check_runs`).

Source: `lightbulb/mcp_generated_tools.py:18578`.

### `github_list_check_suites`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_list_check_suites(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Github connector operation `list_check_suites` (platform tool `github.list_check_suites`).

Source: `lightbulb/mcp_generated_tools.py:18623`.

### `github_list_code_scanning_alerts`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_list_code_scanning_alerts(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Github connector operation `list_code_scanning_alerts` (platform tool `github.list_code_scanning_alerts`).

Source: `lightbulb/mcp_generated_tools.py:18668`.

### `github_list_commits`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_list_commits(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Github connector operation `list_commits` (platform tool `github.list_commits`).

Source: `lightbulb/mcp_generated_tools.py:18713`.

### `github_list_dependabot_alerts`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_list_dependabot_alerts(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Github connector operation `list_dependabot_alerts` (platform tool `github.list_dependabot_alerts`).

Source: `lightbulb/mcp_generated_tools.py:18758`.

### `github_list_deployments`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_list_deployments(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Github connector operation `list_deployments` (platform tool `github.list_deployments`).

Source: `lightbulb/mcp_generated_tools.py:18803`.

### `github_list_environments`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_list_environments(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Github connector operation `list_environments` (platform tool `github.list_environments`).

Source: `lightbulb/mcp_generated_tools.py:18848`.

### `github_list_issues`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_list_issues(repo: Optional[str]=None, state: str='open', labels: Optional[list[str]]=None, *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


List issues for a repo.

Source: `lightbulb/mcp_generated_tools.py:18893`.

### `github_list_pull_request_files`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_list_pull_request_files(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Github connector operation `list_pull_request_files` (platform tool `github.list_pull_request_files`).

Source: `lightbulb/mcp_generated_tools.py:18930`.

### `github_list_pull_request_review_comments`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_list_pull_request_review_comments(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Github connector operation `list_pull_request_review_comments` (platform tool `github.list_pull_request_review_comments`).

Source: `lightbulb/mcp_generated_tools.py:18975`.

### `github_list_pull_requests`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_list_pull_requests(repo: Optional[str]=None, state: str='open', author: Optional[str]=None, *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


List pull requests for a repo.

Source: `lightbulb/mcp_generated_tools.py:19020`.

### `github_list_releases`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_list_releases(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Github connector operation `list_releases` (platform tool `github.list_releases`).

Source: `lightbulb/mcp_generated_tools.py:19057`.

### `github_list_reviews`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_list_reviews(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Github connector operation `list_reviews` (platform tool `github.list_reviews`).

Source: `lightbulb/mcp_generated_tools.py:19102`.

### `github_list_rulesets`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_list_rulesets(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Github connector operation `list_rulesets` (platform tool `github.list_rulesets`).

Source: `lightbulb/mcp_generated_tools.py:19147`.

### `github_list_secret_scanning_alerts`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_list_secret_scanning_alerts(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Github connector operation `list_secret_scanning_alerts` (platform tool `github.list_secret_scanning_alerts`).

Source: `lightbulb/mcp_generated_tools.py:19192`.

### `github_list_workflow_jobs`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_list_workflow_jobs(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Github connector operation `list_workflow_jobs` (platform tool `github.list_workflow_jobs`).

Source: `lightbulb/mcp_generated_tools.py:19237`.

### `github_list_workflow_runs`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_list_workflow_runs(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Github connector operation `list_workflow_runs` (platform tool `github.list_workflow_runs`).

Source: `lightbulb/mcp_generated_tools.py:19282`.

### `github_merge_pull_request`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_merge_pull_request(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Github connector operation `merge_pull_request` (platform tool `github.merge_pull_request`).

Source: `lightbulb/mcp_generated_tools.py:19327`.

### `github_remove_label_from_issue`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_remove_label_from_issue(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Github connector operation `remove_label_from_issue` (platform tool `github.remove_label_from_issue`).

Source: `lightbulb/mcp_generated_tools.py:19372`.

### `github_remove_requested_reviewers`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_remove_requested_reviewers(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Github connector operation `remove_requested_reviewers` (platform tool `github.remove_requested_reviewers`).

Source: `lightbulb/mcp_generated_tools.py:19417`.

### `github_request_reviewers`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_request_reviewers(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Github connector operation `request_reviewers` (platform tool `github.request_reviewers`).

Source: `lightbulb/mcp_generated_tools.py:19462`.

### `github_rerun_workflow_run`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_rerun_workflow_run(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Github connector operation `rerun_workflow_run` (platform tool `github.rerun_workflow_run`).

Source: `lightbulb/mcp_generated_tools.py:19507`.

### `github_submit_review`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_submit_review(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Github connector operation `submit_review` (platform tool `github.submit_review`).

Source: `lightbulb/mcp_generated_tools.py:19552`.

### `github_trigger_workflow`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_trigger_workflow(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Github connector operation `trigger_workflow` (platform tool `github.trigger_workflow`).

Source: `lightbulb/mcp_generated_tools.py:19597`.

### `github_update_branch_protection`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_update_branch_protection(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Github connector operation `update_branch_protection` (platform tool `github.update_branch_protection`).

Source: `lightbulb/mcp_generated_tools.py:19642`.

### `github_update_check_run`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_update_check_run(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Github connector operation `update_check_run` (platform tool `github.update_check_run`).

Source: `lightbulb/mcp_generated_tools.py:19687`.

### `github_update_issue`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_update_issue(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Github connector operation `update_issue` (platform tool `github.update_issue`).

Source: `lightbulb/mcp_generated_tools.py:19732`.

### `github_update_pull_request`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_update_pull_request(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Github connector operation `update_pull_request` (platform tool `github.update_pull_request`).

Source: `lightbulb/mcp_generated_tools.py:19777`.

### `github_update_release`

Namespace: `github`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
github_update_release(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Github connector operation `update_release` (platform tool `github.update_release`).

Source: `lightbulb/mcp_generated_tools.py:19822`.

### `gmail_get_email`

Namespace: `gmail`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
gmail_get_email(message_id: Optional[str]=None, format: str='full', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Fetch a single Gmail message by ID, including headers and body.

Source: `lightbulb/mcp_generated_tools.py:19867`.

### `gmail_get_thread`

Namespace: `gmail`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
gmail_get_thread(thread_id: Optional[str]=None, max_messages: int=10, *, project_id: str, project_ref: str, connector_account_ref: str, effect: Literal['read'], approval_ref: Optional[str]=None) -> str
~~~


Read up to ten messages from one exact Gmail thread. Private content is returned only on the fresh response and is not replayable.

Source: `lightbulb/mcp_generated_tools.py:19901`.

### `gmail_list_emails`

Namespace: `gmail`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
gmail_list_emails(query: Optional[str]=None, max_results: int=20, label_ids: Optional[list[str]]=None, *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


List / search Gmail messages in the connected mailbox.

Source: `lightbulb/mcp_generated_tools.py:19936`.

### `gmail_modify`

Namespace: `gmail`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
gmail_modify(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Gmail connector operation `modify` (platform tool `gmail.modify`).

Source: `lightbulb/mcp_generated_tools.py:19973`.

### `gmail_send_email`

Namespace: `gmail`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
gmail_send_email(to: Optional[str]=None, subject: Optional[str]=None, body: Optional[str]=None, html: bool=False, thread_id: Optional[str]=None, parent_message_id: Optional[str]=None, *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Send an email from the connected Gmail account.

Source: `lightbulb/mcp_generated_tools.py:20018`.

### `grc_audit_trail_export`

Namespace: `grc`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
grc_audit_trail_export(message: str='', inputs: str='{}') -> str
~~~


Run the grc domain agent action `audit_trail_export`.

Source: `lightbulb/mcp_generated_tools.py:7333`.

### `grc_chat`

Namespace: `grc`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
grc_chat(message: str='', inputs: str='{}') -> str
~~~


Run the grc domain agent action `chat`.

Source: `lightbulb/mcp_generated_tools.py:7179`.

### `grc_compliance_audit`

Namespace: `grc`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
grc_compliance_audit(message: str='', inputs: str='{}') -> str
~~~


Run the grc domain agent action `compliance_audit`.

Source: `lightbulb/mcp_generated_tools.py:7223`.

### `grc_control_testing`

Namespace: `grc`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
grc_control_testing(message: str='', inputs: str='{}') -> str
~~~


Run the grc domain agent action `control_testing`.

Source: `lightbulb/mcp_generated_tools.py:7289`.

### `grc_pci_audit_package`

Namespace: `grc`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
grc_pci_audit_package(message: str='', inputs: str='{}') -> str
~~~


Run the grc domain agent action `pci_audit_package`.

Source: `lightbulb/mcp_generated_tools.py:7377`.

### `grc_plan_domain_intelligence`

Namespace: `grc`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
grc_plan_domain_intelligence(message: str='', inputs: str='{}') -> str
~~~


Run the grc domain agent action `plan_domain_intelligence`.

Source: `lightbulb/mcp_generated_tools.py:7465`.

### `grc_policy_gap_analysis`

Namespace: `grc`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
grc_policy_gap_analysis(message: str='', inputs: str='{}') -> str
~~~


Run the grc domain agent action `policy_gap_analysis`.

Source: `lightbulb/mcp_generated_tools.py:7245`.

### `grc_regulatory_monitoring`

Namespace: `grc`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
grc_regulatory_monitoring(message: str='', inputs: str='{}') -> str
~~~


Run the grc domain agent action `regulatory_monitoring`.

Source: `lightbulb/mcp_generated_tools.py:7267`.

### `grc_risk_register_scan`

Namespace: `grc`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
grc_risk_register_scan(message: str='', inputs: str='{}') -> str
~~~


Run the grc domain agent action `risk_register_scan`.

Source: `lightbulb/mcp_generated_tools.py:7201`.

### `grc_risk_score_report`

Namespace: `grc`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
grc_risk_score_report(message: str='', inputs: str='{}') -> str
~~~


Run the grc domain agent action `risk_score_report`.

Source: `lightbulb/mcp_generated_tools.py:7311`.

### `grc_sox_audit_package`

Namespace: `grc`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
grc_sox_audit_package(message: str='', inputs: str='{}') -> str
~~~


Run the grc domain agent action `sox_audit_package`.

Source: `lightbulb/mcp_generated_tools.py:7355`.

### `grc_tax_compliance_report`

Namespace: `grc`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
grc_tax_compliance_report(message: str='', inputs: str='{}') -> str
~~~


Run the grc domain agent action `tax_compliance_report`.

Source: `lightbulb/mcp_generated_tools.py:7421`.

### `grc_tax_deadline_alerts`

Namespace: `grc`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
grc_tax_deadline_alerts(message: str='', inputs: str='{}') -> str
~~~


Run the grc domain agent action `tax_deadline_alerts`.

Source: `lightbulb/mcp_generated_tools.py:7443`.

### `grc_tax_obligation_scan`

Namespace: `grc`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
grc_tax_obligation_scan(message: str='', inputs: str='{}') -> str
~~~


Run the grc domain agent action `tax_obligation_scan`.

Source: `lightbulb/mcp_generated_tools.py:7399`.

### `greenhouse_advance_application`

Namespace: `greenhouse`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
greenhouse_advance_application(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Greenhouse connector operation `advance_application` (platform tool `greenhouse.advance_application`).

Source: `lightbulb/mcp_generated_tools.py:20064`.

### `greenhouse_default_department_id`

Namespace: `greenhouse`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
greenhouse_default_department_id(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Greenhouse connector operation `default_department_id` (platform tool `greenhouse.default_department_id`).

Source: `lightbulb/mcp_generated_tools.py:20109`.

### `greenhouse_default_office_id`

Namespace: `greenhouse`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
greenhouse_default_office_id(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Greenhouse connector operation `default_office_id` (platform tool `greenhouse.default_office_id`).

Source: `lightbulb/mcp_generated_tools.py:20154`.

### `greenhouse_reject_application`

Namespace: `greenhouse`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
greenhouse_reject_application(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Greenhouse connector operation `reject_application` (platform tool `greenhouse.reject_application`).

Source: `lightbulb/mcp_generated_tools.py:20199`.

### `gtm_chat`

Namespace: `gtm`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
gtm_chat(message: str='', inputs: str='{}') -> str
~~~


Run the gtm domain agent action `chat`.

Source: `lightbulb/mcp_generated_tools.py:7487`.

### `gtm_competitive_launch_response`

Namespace: `gtm`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
gtm_competitive_launch_response(message: str='', inputs: str='{}') -> str
~~~


Run the gtm domain agent action `competitive_launch_response`.

Source: `lightbulb/mcp_generated_tools.py:7619`.

### `gtm_enablement_kit`

Namespace: `gtm`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
gtm_enablement_kit(message: str='', inputs: str='{}') -> str
~~~


Run the gtm domain agent action `enablement_kit`.

Source: `lightbulb/mcp_generated_tools.py:7575`.

### `gtm_go_to_market_plan`

Namespace: `gtm`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
gtm_go_to_market_plan(message: str='', inputs: str='{}') -> str
~~~


Run the gtm domain agent action `go_to_market_plan`.

Source: `lightbulb/mcp_generated_tools.py:7531`.

### `gtm_intelligence_share`

Namespace: `gtm`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
gtm_intelligence_share(message: str='', inputs: str='{}') -> str
~~~


Run the gtm domain agent action `gtm_intelligence_share`.

Source: `lightbulb/mcp_generated_tools.py:7641`.

### `gtm_launch_coordination`

Namespace: `gtm`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
gtm_launch_coordination(message: str='', inputs: str='{}') -> str
~~~


Run the gtm domain agent action `launch_coordination`.

Source: `lightbulb/mcp_generated_tools.py:7509`.

### `gtm_launch_readiness`

Namespace: `gtm`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
gtm_launch_readiness(message: str='', inputs: str='{}') -> str
~~~


Run the gtm domain agent action `launch_readiness`.

Source: `lightbulb/mcp_generated_tools.py:7553`.

### `gtm_market_entry_analysis`

Namespace: `gtm`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
gtm_market_entry_analysis(message: str='', inputs: str='{}') -> str
~~~


Run the gtm domain agent action `market_entry_analysis`.

Source: `lightbulb/mcp_generated_tools.py:7597`.

### `gtm_plan_domain_intelligence`

Namespace: `gtm`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
gtm_plan_domain_intelligence(message: str='', inputs: str='{}') -> str
~~~


Run the gtm domain agent action `plan_domain_intelligence`.

Source: `lightbulb/mcp_generated_tools.py:7663`.

### `hr_cases_pulse_loop`

Namespace: `hr`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
hr_cases_pulse_loop(message: str='', inputs: str='{}') -> str
~~~


Run the hr domain agent action `hr_cases_pulse_loop`.

Source: `lightbulb/mcp_generated_tools.py:7993`.

### `hr_chat`

Namespace: `hr`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
hr_chat(message: str='', inputs: str='{}') -> str
~~~


Run the hr domain agent action `chat`.

Source: `lightbulb/mcp_generated_tools.py:7685`.

### `hr_compliance_check`

Namespace: `hr`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
hr_compliance_check(message: str='', inputs: str='{}') -> str
~~~


Run the hr domain agent action `compliance_check`.

Source: `lightbulb/mcp_generated_tools.py:7817`.

### `hr_employee_hire_onboarding_loop`

Namespace: `hr`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
hr_employee_hire_onboarding_loop(message: str='', inputs: str='{}') -> str
~~~


Run the hr domain agent action `employee_hire_onboarding_loop`.

Source: `lightbulb/mcp_generated_tools.py:7927`.

### `hr_employee_offboarding_loop`

Namespace: `hr`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
hr_employee_offboarding_loop(message: str='', inputs: str='{}') -> str
~~~


Run the hr domain agent action `employee_offboarding_loop`.

Source: `lightbulb/mcp_generated_tools.py:7949`.

### `hr_headcount`

Namespace: `hr`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
hr_headcount(message: str='', as_of_date: Optional[str]=None, group_by: str='team') -> str
~~~


Produce a current-headcount report: active employees by team, role, and location; flags pending starts and recent departures.     Args:         message: Free-text objective for the action.         as_of_date: Snapshot date (YYYY-MM-DD); defaults to today.         group_by: One of: team, role, location, manager.

Source: `lightbulb/mcp_generated_tools.py:7798`.

### `hr_identity_verify`

Namespace: `hr`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
hr_identity_verify(message: str='', inputs: str='{}') -> str
~~~


Run the hr domain agent action `identity_verify`.

Source: `lightbulb/mcp_generated_tools.py:7883`.

### `hr_kyc_intake`

Namespace: `hr`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
hr_kyc_intake(message: str='', inputs: str='{}') -> str
~~~


Run the hr domain agent action `kyc_intake`.

Source: `lightbulb/mcp_generated_tools.py:7861`.

### `hr_leave_planning_loop`

Namespace: `hr`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
hr_leave_planning_loop(message: str='', inputs: str='{}') -> str
~~~


Run the hr domain agent action `leave_planning_loop`.

Source: `lightbulb/mcp_generated_tools.py:8015`.

### `hr_leave_request`

Namespace: `hr`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
hr_leave_request(message: str='', inputs: str='{}') -> str
~~~


Run the hr domain agent action `leave_request`.

Source: `lightbulb/mcp_generated_tools.py:7729`.

### `hr_lookup`

Namespace: `hr`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
hr_lookup(message: str='', inputs: str='{}') -> str
~~~


Run the hr domain agent action `lookup`.

Source: `lightbulb/mcp_generated_tools.py:7707`.

### `hr_offboard`

Namespace: `hr`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
hr_offboard(message: str='', employee_id: Optional[str]=None, last_day: Optional[str]=None, voluntary: bool=True) -> str
~~~


Run employee offboarding: revoke access, transfer ownership, schedule exit interviews, calculate final pay, archive records.     Args:         message: Free-text objective for the action.         employee_id (required): Employee ID.         last_day (required): Final day of employment (YYYY-MM-DD).         voluntary: Voluntary departure (vs termination).

Source: `lightbulb/mcp_generated_tools.py:7776`.

### `hr_onboard`

Namespace: `hr`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
hr_onboard(message: str='', employee_name: Optional[str]=None, role_title: Optional[str]=None, start_date: Optional[str]=None, manager_email: Optional[str]=None) -> str
~~~


Run new-hire onboarding end-to-end: provision accounts, assign equipment, schedule day-1 meetings, send welcome packet, file employment paperwork.     Args:         message: Free-text objective for the action.         employee_name (required): New hire full name.         role_title (required): Role title.         start_date (required): Start date (YYYY-MM-DD).         manager_email: Reporting manager email.

Source: `lightbulb/mcp_generated_tools.py:7751`.

### `hr_onboarding_assist`

Namespace: `hr`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
hr_onboarding_assist(message: str='', inputs: str='{}') -> str
~~~


Run the hr domain agent action `onboarding_assist`.

Source: `lightbulb/mcp_generated_tools.py:7905`.

### `hr_plan_domain_intelligence`

Namespace: `hr`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
hr_plan_domain_intelligence(message: str='', inputs: str='{}') -> str
~~~


Run the hr domain agent action `plan_domain_intelligence`.

Source: `lightbulb/mcp_generated_tools.py:8037`.

### `hr_pulse`

Namespace: `hr`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
hr_pulse(message: str='', inputs: str='{}') -> str
~~~


Run the hr domain agent action `hr_pulse`.

Source: `lightbulb/mcp_generated_tools.py:7839`.

### `hr_recruiting_pipeline_loop`

Namespace: `hr`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
hr_recruiting_pipeline_loop(message: str='', inputs: str='{}') -> str
~~~


Run the hr domain agent action `recruiting_pipeline_loop`.

Source: `lightbulb/mcp_generated_tools.py:7971`.

### `hubspot_chat`

Namespace: `hubspot`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
hubspot_chat(message: str='', inputs: str='{}') -> str
~~~


Run the hubspot domain agent action `chat`.

Source: `lightbulb/mcp_generated_tools.py:8059`.

### `hubspot_create_campaign`

Namespace: `hubspot`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
hubspot_create_campaign(message: str='', inputs: str='{}') -> str
~~~


Run the hubspot domain agent action `create_campaign`.

Source: `lightbulb/mcp_generated_tools.py:8081`.

### `hubspot_create_contact`

Namespace: `hubspot`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
hubspot_create_contact(message: str='', inputs: str='{}') -> str
~~~


Run the hubspot domain agent action `create_contact`.

Source: `lightbulb/mcp_generated_tools.py:8103`.

### `hubspot_create_deal`

Namespace: `hubspot`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
hubspot_create_deal(message: str='', inputs: str='{}') -> str
~~~


Run the hubspot domain agent action `create_deal`.

Source: `lightbulb/mcp_generated_tools.py:8125`.

### `hubspot_create_form`

Namespace: `hubspot`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
hubspot_create_form(message: str='', inputs: str='{}') -> str
~~~


Run the hubspot domain agent action `create_form`.

Source: `lightbulb/mcp_generated_tools.py:8147`.

### `hubspot_create_import`

Namespace: `hubspot`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
hubspot_create_import(message: str='', inputs: str='{}') -> str
~~~


Run the hubspot domain agent action `create_import`.

Source: `lightbulb/mcp_generated_tools.py:8169`.

### `hubspot_create_timeline_event`

Namespace: `hubspot`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
hubspot_create_timeline_event(message: str='', inputs: str='{}') -> str
~~~


Run the hubspot domain agent action `create_timeline_event`.

Source: `lightbulb/mcp_generated_tools.py:8191`.

### `hubspot_create_workflow`

Namespace: `hubspot`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
hubspot_create_workflow(message: str='', inputs: str='{}') -> str
~~~


Run the hubspot domain agent action `create_workflow`.

Source: `lightbulb/mcp_generated_tools.py:8213`.

### `hubspot_emit_behavioral_event`

Namespace: `hubspot`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
hubspot_emit_behavioral_event(message: str='', inputs: str='{}') -> str
~~~


Run the hubspot domain agent action `emit_behavioral_event`.

Source: `lightbulb/mcp_generated_tools.py:8235`.

### `hubspot_get_deal`

Namespace: `hubspot`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
hubspot_get_deal(message: str='', inputs: str='{}') -> str
~~~


Run the hubspot domain agent action `get_deal`.

Source: `lightbulb/mcp_generated_tools.py:8257`.

### `hubspot_get_workflow`

Namespace: `hubspot`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
hubspot_get_workflow(message: str='', inputs: str='{}') -> str
~~~


Run the hubspot domain agent action `get_workflow`.

Source: `lightbulb/mcp_generated_tools.py:8279`.

### `hubspot_graphql_query`

Namespace: `hubspot`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
hubspot_graphql_query(message: str='', inputs: str='{}') -> str
~~~


Run the hubspot domain agent action `graphql_query`.

Source: `lightbulb/mcp_generated_tools.py:8301`.

### `hubspot_list_campaigns`

Namespace: `hubspot`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
hubspot_list_campaigns(message: str='', inputs: str='{}') -> str
~~~


Run the hubspot domain agent action `list_campaigns`.

Source: `lightbulb/mcp_generated_tools.py:8323`.

### `hubspot_list_forms`

Namespace: `hubspot`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
hubspot_list_forms(message: str='', inputs: str='{}') -> str
~~~


Run the hubspot domain agent action `list_forms`.

Source: `lightbulb/mcp_generated_tools.py:8345`.

### `hubspot_list_imports`

Namespace: `hubspot`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
hubspot_list_imports(message: str='', inputs: str='{}') -> str
~~~


Run the hubspot domain agent action `list_imports`.

Source: `lightbulb/mcp_generated_tools.py:8367`.

### `hubspot_list_lists`

Namespace: `hubspot`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
hubspot_list_lists(message: str='', inputs: str='{}') -> str
~~~


Run the hubspot domain agent action `list_lists`.

Source: `lightbulb/mcp_generated_tools.py:8389`.

### `hubspot_list_marketing_emails`

Namespace: `hubspot`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
hubspot_list_marketing_emails(message: str='', inputs: str='{}') -> str
~~~


Run the hubspot domain agent action `list_marketing_emails`.

Source: `lightbulb/mcp_generated_tools.py:8411`.

### `hubspot_list_marketing_events`

Namespace: `hubspot`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
hubspot_list_marketing_events(message: str='', inputs: str='{}') -> str
~~~


Run the hubspot domain agent action `list_marketing_events`.

Source: `lightbulb/mcp_generated_tools.py:8433`.

### `hubspot_list_owners`

Namespace: `hubspot`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
hubspot_list_owners(message: str='', inputs: str='{}') -> str
~~~


Run the hubspot domain agent action `list_owners`.

Source: `lightbulb/mcp_generated_tools.py:8455`.

### `hubspot_list_pipelines`

Namespace: `hubspot`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
hubspot_list_pipelines(message: str='', inputs: str='{}') -> str
~~~


Run the hubspot domain agent action `list_pipelines`.

Source: `lightbulb/mcp_generated_tools.py:8477`.

### `hubspot_list_subscriptions`

Namespace: `hubspot`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
hubspot_list_subscriptions(message: str='', inputs: str='{}') -> str
~~~


Run the hubspot domain agent action `list_subscriptions`.

Source: `lightbulb/mcp_generated_tools.py:8499`.

### `hubspot_list_teams`

Namespace: `hubspot`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
hubspot_list_teams(message: str='', inputs: str='{}') -> str
~~~


Run the hubspot domain agent action `list_teams`.

Source: `lightbulb/mcp_generated_tools.py:8521`.

### `hubspot_list_users`

Namespace: `hubspot`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
hubspot_list_users(message: str='', inputs: str='{}') -> str
~~~


Run the hubspot domain agent action `list_users`.

Source: `lightbulb/mcp_generated_tools.py:8543`.

### `hubspot_list_workflows`

Namespace: `hubspot`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
hubspot_list_workflows(message: str='', inputs: str='{}') -> str
~~~


Run the hubspot domain agent action `list_workflows`.

Source: `lightbulb/mcp_generated_tools.py:8565`.

### `hubspot_passthrough`

Namespace: `hubspot`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
hubspot_passthrough(message: str='', inputs: str='{}') -> str
~~~


Run the hubspot domain agent action `passthrough`.

Source: `lightbulb/mcp_generated_tools.py:8587`.

### `hubspot_plan_domain_intelligence`

Namespace: `hubspot`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
hubspot_plan_domain_intelligence(message: str='', inputs: str='{}') -> str
~~~


Run the hubspot domain agent action `plan_domain_intelligence`.

Source: `lightbulb/mcp_generated_tools.py:8763`.

### `hubspot_search_contacts`

Namespace: `hubspot`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
hubspot_search_contacts(message: str='', inputs: str='{}') -> str
~~~


Run the hubspot domain agent action `search_contacts`.

Source: `lightbulb/mcp_generated_tools.py:8609`.

### `hubspot_search_deals`

Namespace: `hubspot`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
hubspot_search_deals(message: str='', inputs: str='{}') -> str
~~~


Run the hubspot domain agent action `search_deals`.

Source: `lightbulb/mcp_generated_tools.py:8631`.

### `hubspot_search_tickets`

Namespace: `hubspot`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
hubspot_search_tickets(message: str='', inputs: str='{}') -> str
~~~


Run the hubspot domain agent action `search_tickets`.

Source: `lightbulb/mcp_generated_tools.py:8653`.

### `hubspot_send_transactional_email`

Namespace: `hubspot`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
hubspot_send_transactional_email(message: str='', inputs: str='{}') -> str
~~~


Run the hubspot domain agent action `send_transactional_email`.

Source: `lightbulb/mcp_generated_tools.py:8675`.

### `hubspot_status_report`

Namespace: `hubspot`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
hubspot_status_report(message: str='', inputs: str='{}') -> str
~~~


Run the hubspot domain agent action `status_report`.

Source: `lightbulb/mcp_generated_tools.py:8697`.

### `hubspot_update_deal`

Namespace: `hubspot`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
hubspot_update_deal(message: str='', inputs: str='{}') -> str
~~~


Run the hubspot domain agent action `update_deal`.

Source: `lightbulb/mcp_generated_tools.py:8719`.

### `hubspot_update_workflow`

Namespace: `hubspot`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
hubspot_update_workflow(message: str='', inputs: str='{}') -> str
~~~


Run the hubspot domain agent action `update_workflow`.

Source: `lightbulb/mcp_generated_tools.py:8741`.

### `instagram_publish_post`

Namespace: `instagram`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
instagram_publish_post(instagram_business_account_id: Optional[str]=None, caption: Optional[str]=None, image_url: Optional[str]=None, *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Publish one approved image post to the exact Instagram Business account bound to the authenticated project connector route.

Source: `lightbulb/mcp_generated_tools.py:20244`.

### `intuit_cash_application_plan`

Namespace: `intuit`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
intuit_cash_application_plan(message: str='', inputs: str='{}') -> str
~~~


Run the intuit domain agent action `cash_application_plan`.

Source: `lightbulb/mcp_generated_tools.py:8851`.

### `intuit_close_packet`

Namespace: `intuit`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
intuit_close_packet(message: str='', inputs: str='{}') -> str
~~~


Run the intuit domain agent action `close_packet`.

Source: `lightbulb/mcp_generated_tools.py:8873`.

### `intuit_controller_action`

Namespace: `intuit`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
intuit_controller_action(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Intuit connector operation `controller_action` (platform tool `intuit.controller_action`).

Source: `lightbulb/mcp_generated_tools.py:20281`.

### `intuit_controller_review`

Namespace: `intuit`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
intuit_controller_review(message: str='', inputs: str='{}') -> str
~~~


Run the intuit domain agent action `controller_review`.

Source: `lightbulb/mcp_generated_tools.py:8807`.

### `intuit_controller_snapshot`

Namespace: `intuit`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
intuit_controller_snapshot(message: str='', inputs: str='{}') -> str
~~~


Run the intuit domain agent action `controller_snapshot`.

Source: `lightbulb/mcp_generated_tools.py:8785`.

### `intuit_execute_approved_action`

Namespace: `intuit`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
intuit_execute_approved_action(message: str='', inputs: str='{}') -> str
~~~


Run the intuit domain agent action `execute_approved_action`.

Source: `lightbulb/mcp_generated_tools.py:8917`.

### `intuit_health_check`

Namespace: `intuit`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
intuit_health_check(message: str='', inputs: str='{}') -> str
~~~


Run the intuit domain agent action `health_check`.

Source: `lightbulb/mcp_generated_tools.py:8939`.

### `intuit_plan_domain_intelligence`

Namespace: `intuit`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
intuit_plan_domain_intelligence(message: str='', inputs: str='{}') -> str
~~~


Run the intuit domain agent action `plan_domain_intelligence`.

Source: `lightbulb/mcp_generated_tools.py:8961`.

### `intuit_reconcile_payments`

Namespace: `intuit`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
intuit_reconcile_payments(message: str='', inputs: str='{}') -> str
~~~


Run the intuit domain agent action `reconcile_payments`.

Source: `lightbulb/mcp_generated_tools.py:8829`.

### `intuit_writeback_plan`

Namespace: `intuit`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
intuit_writeback_plan(message: str='', inputs: str='{}') -> str
~~~


Run the intuit domain agent action `writeback_plan`.

Source: `lightbulb/mcp_generated_tools.py:8895`.

### `it_ops_analysis_review`

Namespace: `it_ops`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
it_ops_analysis_review(message: str='', inputs: str='{}') -> str
~~~


Run the it_ops domain agent action `analysis_review`.

Source: `lightbulb/mcp_generated_tools.py:9775`.

### `it_ops_analyze_cost`

Namespace: `it_ops`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
it_ops_analyze_cost(message: str='', inputs: str='{}') -> str
~~~


Run the it_ops domain agent action `analyze_cost`.

Source: `lightbulb/mcp_generated_tools.py:9203`.

### `it_ops_autocompany_software_engineering_loop`

Namespace: `it_ops`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
it_ops_autocompany_software_engineering_loop(message: str='', inputs: str='{}') -> str
~~~


Run the it_ops domain agent action `autocompany_software_engineering_loop`.

Source: `lightbulb/mcp_generated_tools.py:9489`.

### `it_ops_autonomous_delivery_loop`

Namespace: `it_ops`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
it_ops_autonomous_delivery_loop(message: str='', inputs: str='{}') -> str
~~~


Run the it_ops domain agent action `autonomous_delivery_loop`.

Source: `lightbulb/mcp_generated_tools.py:9423`.

### `it_ops_autonomous_it_consultancy`

Namespace: `it_ops`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
it_ops_autonomous_it_consultancy(message: str='', inputs: str='{}') -> str
~~~


Run the it_ops domain agent action `autonomous_it_consultancy`.

Source: `lightbulb/mcp_generated_tools.py:9445`.

### `it_ops_aws_account_control`

Namespace: `it_ops`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
it_ops_aws_account_control(message: str='', inputs: str='{}') -> str
~~~


Run the it_ops domain agent action `aws_account_control`.

Source: `lightbulb/mcp_generated_tools.py:9137`.

### `it_ops_aws_cli`

Namespace: `it_ops`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
it_ops_aws_cli(message: str='', inputs: str='{}') -> str
~~~


Run the it_ops domain agent action `aws_cli`.

Source: `lightbulb/mcp_generated_tools.py:9115`.

### `it_ops_aws_cli_execute`

Namespace: `it_ops`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
it_ops_aws_cli_execute(message: str='', inputs: str='{}') -> str
~~~


Run the it_ops domain agent action `aws_cli_execute`.

Source: `lightbulb/mcp_generated_tools.py:9159`.

### `it_ops_chat`

Namespace: `it_ops`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
it_ops_chat(message: str='', inputs: str='{}') -> str
~~~


Run the it_ops domain agent action `chat`.

Source: `lightbulb/mcp_generated_tools.py:8983`.

### `it_ops_cloud_delivery_setup`

Namespace: `it_ops`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
it_ops_cloud_delivery_setup(message: str='', inputs: str='{}') -> str
~~~


Run the it_ops domain agent action `cloud_delivery_setup`.

Source: `lightbulb/mcp_generated_tools.py:9533`.

### `it_ops_cloud_ops`

Namespace: `it_ops`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
it_ops_cloud_ops(message: str='', inputs: str='{}') -> str
~~~


Run the it_ops domain agent action `cloud_ops`.

Source: `lightbulb/mcp_generated_tools.py:9093`.

### `it_ops_deployment`

Namespace: `it_ops`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
it_ops_deployment(message: str='', inputs: str='{}') -> str
~~~


Run the it_ops domain agent action `deployment`.

Source: `lightbulb/mcp_generated_tools.py:9379`.

### `it_ops_design_review`

Namespace: `it_ops`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
it_ops_design_review(message: str='', inputs: str='{}') -> str
~~~


Run the it_ops domain agent action `design_review`.

Source: `lightbulb/mcp_generated_tools.py:9797`.

### `it_ops_detect_waste`

Namespace: `it_ops`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
it_ops_detect_waste(message: str='', inputs: str='{}') -> str
~~~


Run the it_ops domain agent action `detect_waste`.

Source: `lightbulb/mcp_generated_tools.py:9225`.

### `it_ops_development_kickoff`

Namespace: `it_ops`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
it_ops_development_kickoff(message: str='', inputs: str='{}') -> str
~~~


Run the it_ops domain agent action `development_kickoff`.

Source: `lightbulb/mcp_generated_tools.py:9819`.

### `it_ops_domain_artifact_handoff`

Namespace: `it_ops`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
it_ops_domain_artifact_handoff(message: str='', inputs: str='{}') -> str
~~~


Run the it_ops domain agent action `domain_artifact_handoff`.

Source: `lightbulb/mcp_generated_tools.py:9511`.

### `it_ops_feedback_to_code_loop`

Namespace: `it_ops`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
it_ops_feedback_to_code_loop(message: str='', inputs: str='{}') -> str
~~~


Run the it_ops domain agent action `feedback_to_code_loop`.

Source: `lightbulb/mcp_generated_tools.py:9621`.

### `it_ops_feedback_to_sdlc`

Namespace: `it_ops`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
it_ops_feedback_to_sdlc(message: str='', inputs: str='{}') -> str
~~~


Run the it_ops domain agent action `feedback_to_sdlc`.

Source: `lightbulb/mcp_generated_tools.py:9599`.

### `it_ops_generate_iac`

Namespace: `it_ops`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
it_ops_generate_iac(message: str='', inputs: str='{}') -> str
~~~


Run the it_ops domain agent action `generate_iac`.

Source: `lightbulb/mcp_generated_tools.py:9313`.

### `it_ops_github_repository_search`

Namespace: `it_ops`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
it_ops_github_repository_search(message: str='', inputs: str='{}') -> str
~~~


Run the it_ops domain agent action `github_repository_search`.

Source: `lightbulb/mcp_generated_tools.py:9005`.

### `it_ops_incident_response`

Namespace: `it_ops`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
it_ops_incident_response(message: str='', inputs: str='{}') -> str
~~~


Run the it_ops domain agent action `incident_response`.

Source: `lightbulb/mcp_generated_tools.py:9049`.

### `it_ops_inventory_cloud`

Namespace: `it_ops`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
it_ops_inventory_cloud(message: str='', inputs: str='{}') -> str
~~~


Run the it_ops domain agent action `inventory_cloud`.

Source: `lightbulb/mcp_generated_tools.py:9181`.

### `it_ops_maintenance_cycle`

Namespace: `it_ops`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
it_ops_maintenance_cycle(message: str='', inputs: str='{}') -> str
~~~


Run the it_ops domain agent action `maintenance_cycle`.

Source: `lightbulb/mcp_generated_tools.py:9863`.

### `it_ops_monitoring_check`

Namespace: `it_ops`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
it_ops_monitoring_check(message: str='', inputs: str='{}') -> str
~~~


Run the it_ops domain agent action `monitoring_check`.

Source: `lightbulb/mcp_generated_tools.py:9885`.

### `it_ops_open_iac_pr`

Namespace: `it_ops`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
it_ops_open_iac_pr(message: str='', inputs: str='{}') -> str
~~~


Run the it_ops domain agent action `open_iac_pr`.

Source: `lightbulb/mcp_generated_tools.py:9357`.

### `it_ops_plan_domain_intelligence`

Namespace: `it_ops`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
it_ops_plan_domain_intelligence(message: str='', inputs: str='{}') -> str
~~~


Run the it_ops domain agent action `plan_domain_intelligence`.

Source: `lightbulb/mcp_generated_tools.py:9951`.

### `it_ops_plan_iac`

Namespace: `it_ops`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
it_ops_plan_iac(message: str='', inputs: str='{}') -> str
~~~


Run the it_ops domain agent action `plan_iac`.

Source: `lightbulb/mcp_generated_tools.py:9335`.

### `it_ops_plan_iteration`

Namespace: `it_ops`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
it_ops_plan_iteration(message: str='', inputs: str='{}') -> str
~~~


Run the it_ops domain agent action `plan_iteration`.

Source: `lightbulb/mcp_generated_tools.py:9753`.

### `it_ops_platform_scaling_review`

Namespace: `it_ops`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
it_ops_platform_scaling_review(message: str='', inputs: str='{}') -> str
~~~


Run the it_ops domain agent action `platform_scaling_review`.

Source: `lightbulb/mcp_generated_tools.py:9929`.

### `it_ops_product_requirements_intake`

Namespace: `it_ops`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
it_ops_product_requirements_intake(message: str='', inputs: str='{}') -> str
~~~


Run the it_ops domain agent action `product_requirements_intake`.

Source: `lightbulb/mcp_generated_tools.py:9555`.

### `it_ops_project_ops`

Namespace: `it_ops`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
it_ops_project_ops(message: str='', inputs: str='{}') -> str
~~~


Run the it_ops domain agent action `project_ops`.

Source: `lightbulb/mcp_generated_tools.py:9027`.

### `it_ops_qa`

Namespace: `it_ops`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
it_ops_qa(message: str='', inputs: str='{}') -> str
~~~


Run the it_ops domain agent action `qa`.

Source: `lightbulb/mcp_generated_tools.py:9401`.

### `it_ops_recommend_architecture`

Namespace: `it_ops`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
it_ops_recommend_architecture(message: str='', inputs: str='{}') -> str
~~~


Run the it_ops domain agent action `recommend_architecture`.

Source: `lightbulb/mcp_generated_tools.py:9291`.

### `it_ops_requirements_capture`

Namespace: `it_ops`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
it_ops_requirements_capture(message: str='', inputs: str='{}') -> str
~~~


Run the it_ops domain agent action `requirements_capture`.

Source: `lightbulb/mcp_generated_tools.py:9731`.

### `it_ops_rightsizing_recommendations`

Namespace: `it_ops`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
it_ops_rightsizing_recommendations(message: str='', inputs: str='{}') -> str
~~~


Run the it_ops domain agent action `rightsizing_recommendations`.

Source: `lightbulb/mcp_generated_tools.py:9247`.

### `it_ops_sdlc_engagement_status`

Namespace: `it_ops`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
it_ops_sdlc_engagement_status(message: str='', inputs: str='{}') -> str
~~~


Run the it_ops domain agent action `sdlc_engagement_status`.

Source: `lightbulb/mcp_generated_tools.py:9907`.

### `it_ops_service_desk`

Namespace: `it_ops`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
it_ops_service_desk(message: str='', inputs: str='{}') -> str
~~~


Run the it_ops domain agent action `service_desk`.

Source: `lightbulb/mcp_generated_tools.py:9071`.

### `it_ops_software_engineering_loop`

Namespace: `it_ops`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
it_ops_software_engineering_loop(message: str='', inputs: str='{}') -> str
~~~


Run the it_ops domain agent action `software_engineering_loop`.

Source: `lightbulb/mcp_generated_tools.py:9467`.

### `it_ops_software_feedback_intake`

Namespace: `it_ops`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
it_ops_software_feedback_intake(message: str='', inputs: str='{}') -> str
~~~


Run the it_ops domain agent action `software_feedback_intake`.

Source: `lightbulb/mcp_generated_tools.py:9577`.

### `it_ops_testing_review`

Namespace: `it_ops`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
it_ops_testing_review(message: str='', inputs: str='{}') -> str
~~~


Run the it_ops domain agent action `testing_review`.

Source: `lightbulb/mcp_generated_tools.py:9841`.

### `it_ops_triage_growth_loop_to_sdlc`

Namespace: `it_ops`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
it_ops_triage_growth_loop_to_sdlc(message: str='', inputs: str='{}') -> str
~~~


Run the it_ops domain agent action `triage_growth_loop_to_sdlc`.

Source: `lightbulb/mcp_generated_tools.py:9709`.

### `it_ops_triage_sdlc_intake`

Namespace: `it_ops`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
it_ops_triage_sdlc_intake(message: str='', inputs: str='{}') -> str
~~~


Run the it_ops domain agent action `triage_sdlc_intake`.

Source: `lightbulb/mcp_generated_tools.py:9665`.

### `it_ops_unit_economics`

Namespace: `it_ops`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
it_ops_unit_economics(message: str='', inputs: str='{}') -> str
~~~


Run the it_ops domain agent action `unit_economics`.

Source: `lightbulb/mcp_generated_tools.py:9269`.

### `it_ops_website_growth_loop_to_sdlc`

Namespace: `it_ops`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
it_ops_website_growth_loop_to_sdlc(message: str='', inputs: str='{}') -> str
~~~


Run the it_ops domain agent action `website_growth_loop_to_sdlc`.

Source: `lightbulb/mcp_generated_tools.py:9687`.

### `it_ops_website_sdlc_intake`

Namespace: `it_ops`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
it_ops_website_sdlc_intake(message: str='', inputs: str='{}') -> str
~~~


Run the it_ops domain agent action `website_sdlc_intake`.

Source: `lightbulb/mcp_generated_tools.py:9643`.

### `jira_add_attachment`

Namespace: `jira`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
jira_add_attachment(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Jira connector operation `add_attachment` (platform tool `jira.add_attachment`).

Source: `lightbulb/mcp_generated_tools.py:20326`.

### `jira_add_comment`

Namespace: `jira`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
jira_add_comment(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Jira connector operation `add_comment` (platform tool `jira.add_comment`).

Source: `lightbulb/mcp_generated_tools.py:20371`.

### `jira_add_to_sprint`

Namespace: `jira`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
jira_add_to_sprint(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Jira connector operation `add_to_sprint` (platform tool `jira.add_to_sprint`).

Source: `lightbulb/mcp_generated_tools.py:20416`.

### `jira_assign_issue`

Namespace: `jira`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
jira_assign_issue(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Jira connector operation `assign_issue` (platform tool `jira.assign_issue`).

Source: `lightbulb/mcp_generated_tools.py:20461`.

### `jira_bulk_transition`

Namespace: `jira`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
jira_bulk_transition(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Jira connector operation `bulk_transition` (platform tool `jira.bulk_transition`).

Source: `lightbulb/mcp_generated_tools.py:20506`.

### `jira_close_sprint`

Namespace: `jira`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
jira_close_sprint(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Jira connector operation `close_sprint` (platform tool `jira.close_sprint`).

Source: `lightbulb/mcp_generated_tools.py:20551`.

### `jira_create_automation_rule`

Namespace: `jira`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
jira_create_automation_rule(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Jira connector operation `create_automation_rule` (platform tool `jira.create_automation_rule`).

Source: `lightbulb/mcp_generated_tools.py:20596`.

### `jira_create_issue`

Namespace: `jira`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
jira_create_issue(project_key: Optional[str]=None, summary: Optional[str]=None, issue_type: str='Task', description: Optional[str]=None, assignee: Optional[str]=None, *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Create a Jira issue in a project.

Source: `lightbulb/mcp_generated_tools.py:20641`.

### `jira_create_sprint`

Namespace: `jira`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
jira_create_sprint(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Jira connector operation `create_sprint` (platform tool `jira.create_sprint`).

Source: `lightbulb/mcp_generated_tools.py:20684`.

### `jira_create_subtask`

Namespace: `jira`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
jira_create_subtask(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Jira connector operation `create_subtask` (platform tool `jira.create_subtask`).

Source: `lightbulb/mcp_generated_tools.py:20729`.

### `jira_default_board_id`

Namespace: `jira`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
jira_default_board_id(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Jira connector operation `default_board_id` (platform tool `jira.default_board_id`).

Source: `lightbulb/mcp_generated_tools.py:20774`.

### `jira_default_project_key`

Namespace: `jira`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
jira_default_project_key(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Jira connector operation `default_project_key` (platform tool `jira.default_project_key`).

Source: `lightbulb/mcp_generated_tools.py:20819`.

### `jira_delete_automation_rule`

Namespace: `jira`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
jira_delete_automation_rule(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Jira connector operation `delete_automation_rule` (platform tool `jira.delete_automation_rule`).

Source: `lightbulb/mcp_generated_tools.py:20864`.

### `jira_delete_issue`

Namespace: `jira`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
jira_delete_issue(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Jira connector operation `delete_issue` (platform tool `jira.delete_issue`).

Source: `lightbulb/mcp_generated_tools.py:20909`.

### `jira_delete_webhook`

Namespace: `jira`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
jira_delete_webhook(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Jira connector operation `delete_webhook` (platform tool `jira.delete_webhook`).

Source: `lightbulb/mcp_generated_tools.py:20954`.

### `jira_get_board_sprints`

Namespace: `jira`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
jira_get_board_sprints(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Jira connector operation `get_board_sprints` (platform tool `jira.get_board_sprints`).

Source: `lightbulb/mcp_generated_tools.py:20999`.

### `jira_get_issue`

Namespace: `jira`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
jira_get_issue(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Jira connector operation `get_issue` (platform tool `jira.get_issue`).

Source: `lightbulb/mcp_generated_tools.py:21044`.

### `jira_get_project`

Namespace: `jira`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
jira_get_project(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Jira connector operation `get_project` (platform tool `jira.get_project`).

Source: `lightbulb/mcp_generated_tools.py:21089`.

### `jira_get_sprint_issues`

Namespace: `jira`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
jira_get_sprint_issues(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Jira connector operation `get_sprint_issues` (platform tool `jira.get_sprint_issues`).

Source: `lightbulb/mcp_generated_tools.py:21134`.

### `jira_link_issues`

Namespace: `jira`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
jira_link_issues(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Jira connector operation `link_issues` (platform tool `jira.link_issues`).

Source: `lightbulb/mcp_generated_tools.py:21179`.

### `jira_list_automation_rules`

Namespace: `jira`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
jira_list_automation_rules(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Jira connector operation `list_automation_rules` (platform tool `jira.list_automation_rules`).

Source: `lightbulb/mcp_generated_tools.py:21224`.

### `jira_list_issue_types`

Namespace: `jira`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
jira_list_issue_types(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Jira connector operation `list_issue_types` (platform tool `jira.list_issue_types`).

Source: `lightbulb/mcp_generated_tools.py:21269`.

### `jira_list_projects`

Namespace: `jira`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
jira_list_projects(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Jira connector operation `list_projects` (platform tool `jira.list_projects`).

Source: `lightbulb/mcp_generated_tools.py:21314`.

### `jira_list_transitions`

Namespace: `jira`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
jira_list_transitions(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Jira connector operation `list_transitions` (platform tool `jira.list_transitions`).

Source: `lightbulb/mcp_generated_tools.py:21359`.

### `jira_list_users`

Namespace: `jira`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
jira_list_users(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Jira connector operation `list_users` (platform tool `jira.list_users`).

Source: `lightbulb/mcp_generated_tools.py:21404`.

### `jira_list_webhooks`

Namespace: `jira`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
jira_list_webhooks(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Jira connector operation `list_webhooks` (platform tool `jira.list_webhooks`).

Source: `lightbulb/mcp_generated_tools.py:21449`.

### `jira_log_work`

Namespace: `jira`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
jira_log_work(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Jira connector operation `log_work` (platform tool `jira.log_work`).

Source: `lightbulb/mcp_generated_tools.py:21494`.

### `jira_rank_backlog`

Namespace: `jira`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
jira_rank_backlog(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Jira connector operation `rank_backlog` (platform tool `jira.rank_backlog`).

Source: `lightbulb/mcp_generated_tools.py:21539`.

### `jira_search_issues`

Namespace: `jira`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
jira_search_issues(jql: Optional[str]=None, max_results: int=50, *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Search Jira issues with JQL.

Source: `lightbulb/mcp_generated_tools.py:21584`.

### `jira_start_sprint`

Namespace: `jira`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
jira_start_sprint(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Jira connector operation `start_sprint` (platform tool `jira.start_sprint`).

Source: `lightbulb/mcp_generated_tools.py:21618`.

### `jira_subscribe_webhook`

Namespace: `jira`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
jira_subscribe_webhook(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Jira connector operation `subscribe_webhook` (platform tool `jira.subscribe_webhook`).

Source: `lightbulb/mcp_generated_tools.py:21663`.

### `jira_transition_issue`

Namespace: `jira`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
jira_transition_issue(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Jira connector operation `transition_issue` (platform tool `jira.transition_issue`).

Source: `lightbulb/mcp_generated_tools.py:21708`.

### `jira_update_custom_fields`

Namespace: `jira`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
jira_update_custom_fields(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Jira connector operation `update_custom_fields` (platform tool `jira.update_custom_fields`).

Source: `lightbulb/mcp_generated_tools.py:21753`.

### `jira_update_issue`

Namespace: `jira`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
jira_update_issue(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Jira connector operation `update_issue` (platform tool `jira.update_issue`).

Source: `lightbulb/mcp_generated_tools.py:21798`.

### `legal_breach_response`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_breach_response(message: str='', inputs: str='{}') -> str
~~~


Run the legal domain agent action `breach_response`.

Source: `lightbulb/mcp_generated_tools.py:10394`.

### `legal_cert_upload`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_cert_upload(message: str='', inputs: str='{}') -> str
~~~


Run the legal domain agent action `cert_upload`.

Source: `lightbulb/mcp_generated_tools.py:10812`.

### `legal_compliance_monitoring`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_compliance_monitoring(message: str='', jurisdictions: Optional[list[str]]=None, topics: Optional[list[str]]=None, since: Optional[str]=None) -> str
~~~


Monitor regulatory and compliance changes relevant to the firm/client and produce a digest of new obligations, deadlines, and action items.     Args:         message: Free-text objective for the action.         jurisdictions: Jurisdictions to monitor.         topics: Topic filters (e.g. 'privacy', 'AML', 'employment').         since: Lookback start date (YYYY-MM-DD).

Source: `lightbulb/mcp_generated_tools.py:10019`.

### `legal_compliance_scan_loop`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_compliance_scan_loop(message: str='', inputs: str='{}') -> str
~~~


Run the legal domain agent action `compliance_scan_loop`.

Source: `lightbulb/mcp_generated_tools.py:10944`.

### `legal_content_compliance_review_loop`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_content_compliance_review_loop(message: str='', inputs: str='{}') -> str
~~~


Run the legal domain agent action `content_compliance_review_loop`.

Source: `lightbulb/mcp_generated_tools.py:11010`.

### `legal_contract_review`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_contract_review(message: str='', contract_url: Optional[str]=None, playbook: Optional[str]=None, counterparty_name: Optional[str]=None) -> str
~~~


Review a contract and produce a redline-ready memo: deviations from your playbook, missing clauses, risk-flagged terms, and proposed edits with rationale.     Args:         message: Free-text objective for the action.         contract_url (required): URL or platform artifact URI for the contract.         playbook: Playbook label: 'enterprise_sales', 'partnership', 'employment', 'nda'.         counterparty_name: Counterparty name for the memo.

Source: `lightbulb/mcp_generated_tools.py:9996`.

### `legal_cookie_audit`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_cookie_audit(message: str='', inputs: str='{}') -> str
~~~


Run the legal domain agent action `cookie_audit`.

Source: `lightbulb/mcp_generated_tools.py:10438`.

### `legal_document_drafting`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_document_drafting(message: str='', document_type: Optional[str]=None, brief: Optional[str]=None, counterparty: Optional[str]=None) -> str
~~~


Draft a legal document (NDA, MSA, side letter, employment agreement, policy) from a brief plus your firm's templates and house style.     Args:         message: Free-text objective for the action.         document_type (required): Document type label.         brief (required): Plain-English brief of what the document needs to cover.         counterparty: Counterparty name.

Source: `lightbulb/mcp_generated_tools.py:10041`.

### `legal_dpa_review`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_dpa_review(message: str='', inputs: str='{}') -> str
~~~


Run the legal domain agent action `dpa_review`.

Source: `lightbulb/mcp_generated_tools.py:10372`.

### `legal_dpia`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_dpia(message: str='', inputs: str='{}') -> str
~~~


Run the legal domain agent action `dpia`.

Source: `lightbulb/mcp_generated_tools.py:10416`.

### `legal_dsar_fulfill`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_dsar_fulfill(message: str='', inputs: str='{}') -> str
~~~


Run the legal domain agent action `dsar_fulfill`.

Source: `lightbulb/mcp_generated_tools.py:10350`.

### `legal_dsar_intake`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_dsar_intake(message: str='', inputs: str='{}') -> str
~~~


Run the legal domain agent action `dsar_intake`.

Source: `lightbulb/mcp_generated_tools.py:10328`.

### `legal_ediscovery`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_ediscovery(message: str='', inputs: str='{}') -> str
~~~


Run the legal domain agent action `ediscovery`.

Source: `lightbulb/mcp_generated_tools.py:10306`.

### `legal_employment_agreement_packet`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_employment_agreement_packet(message: str='', inputs: str='{}') -> str
~~~


Run the legal domain agent action `employment_agreement_packet`.

Source: `lightbulb/mcp_generated_tools.py:10196`.

### `legal_enterprise_customer_onboarding_loop`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_enterprise_customer_onboarding_loop(message: str='', inputs: str='{}') -> str
~~~


Run the legal domain agent action `enterprise_customer_onboarding_loop`.

Source: `lightbulb/mcp_generated_tools.py:10878`.

### `legal_horizon_digest`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_horizon_digest(message: str='', inputs: str='{}') -> str
~~~


Run the legal domain agent action `horizon_digest`.

Source: `lightbulb/mcp_generated_tools.py:10614`.

### `legal_horizon_scan`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_horizon_scan(message: str='', inputs: str='{}') -> str
~~~


Run the legal domain agent action `horizon_scan`.

Source: `lightbulb/mcp_generated_tools.py:10570`.

### `legal_horizon_subscribe`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_horizon_subscribe(message: str='', inputs: str='{}') -> str
~~~


Run the legal domain agent action `horizon_subscribe`.

Source: `lightbulb/mcp_generated_tools.py:10592`.

### `legal_hr_onboarding_packet`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_hr_onboarding_packet(message: str='', inputs: str='{}') -> str
~~~


Run the legal domain agent action `hr_onboarding_packet`.

Source: `lightbulb/mcp_generated_tools.py:10174`.

### `legal_incorporation_legal_setup_loop`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_incorporation_legal_setup_loop(message: str='', inputs: str='{}') -> str
~~~


Run the legal domain agent action `incorporation_legal_setup_loop`.

Source: `lightbulb/mcp_generated_tools.py:11098`.

### `legal_incorporation_readiness`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_incorporation_readiness(message: str='', inputs: str='{}') -> str
~~~


Run the legal domain agent action `incorporation_readiness`.

Source: `lightbulb/mcp_generated_tools.py:10152`.

### `legal_ip_deadline_check`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_ip_deadline_check(message: str='', inputs: str='{}') -> str
~~~


Run the legal domain agent action `ip_deadline_check`.

Source: `lightbulb/mcp_generated_tools.py:10658`.

### `legal_ip_docket_sync`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_ip_docket_sync(message: str='', inputs: str='{}') -> str
~~~


Run the legal domain agent action `ip_docket_sync`.

Source: `lightbulb/mcp_generated_tools.py:10636`.

### `legal_ip_protection_loop`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_ip_protection_loop(message: str='', inputs: str='{}') -> str
~~~


Run the legal domain agent action `ip_protection_loop`.

Source: `lightbulb/mcp_generated_tools.py:11054`.

### `legal_knowledge_assistant`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_knowledge_assistant(message: str='', inputs: str='{}') -> str
~~~


Run the legal domain agent action `knowledge_assistant`.

Source: `lightbulb/mcp_generated_tools.py:10284`.

### `legal_law_firm_growth_loop`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_law_firm_growth_loop(message: str='', inputs: str='{}') -> str
~~~


Run the legal domain agent action `law_firm_growth_loop`.

Source: `lightbulb/mcp_generated_tools.py:10856`.

### `legal_litigation_hold_issue`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_litigation_hold_issue(message: str='', inputs: str='{}') -> str
~~~


Run the legal domain agent action `litigation_hold_issue`.

Source: `lightbulb/mcp_generated_tools.py:10460`.

### `legal_litigation_hold_loop`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_litigation_hold_loop(message: str='', inputs: str='{}') -> str
~~~


Run the legal domain agent action `litigation_hold_loop`.

Source: `lightbulb/mcp_generated_tools.py:11032`.

### `legal_litigation_hold_refresh`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_litigation_hold_refresh(message: str='', inputs: str='{}') -> str
~~~


Run the legal domain agent action `litigation_hold_refresh`.

Source: `lightbulb/mcp_generated_tools.py:10482`.

### `legal_litigation_hold_release`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_litigation_hold_release(message: str='', inputs: str='{}') -> str
~~~


Run the legal domain agent action `litigation_hold_release`.

Source: `lightbulb/mcp_generated_tools.py:10504`.

### `legal_matter_intake`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_matter_intake(message: str='', client_message: Optional[str]=None, attachments: Optional[list[str]]=None, jurisdiction: Optional[str]=None) -> str
~~~


Run a new-matter intake from a client message or file. Classifies matter type, conflicts-checks, drafts the engagement letter scope, and proposes a fee structure.     Args:         message: Free-text objective for the action.         client_message: Initial client message or summary.         attachments: URLs of supporting documents.         jurisdiction: Governing jurisdiction (e.g. 'NSW' or 'Delaware').

Source: `lightbulb/mcp_generated_tools.py:9973`.

### `legal_nda_packet`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_nda_packet(message: str='', variant: str='mutual', counterparty: Optional[str]=None, term_months: int=24) -> str
~~~


Generate a complete NDA packet (mutual or unilateral): NDA itself, side letter if needed, intake form, and an executive summary for the requesting party.     Args:         message: Free-text objective for the action.         variant: One of: mutual, unilateral, employee_confidentiality.         counterparty (required): Counterparty name.         term_months: Confidentiality term length.

Source: `lightbulb/mcp_generated_tools.py:10129`.

### `legal_partnership_agreement_packet`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_partnership_agreement_packet(message: str='', inputs: str='{}') -> str
~~~


Run the legal domain agent action `partnership_agreement_packet`.

Source: `lightbulb/mcp_generated_tools.py:10085`.

### `legal_partnership_onboarding_loop`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_partnership_onboarding_loop(message: str='', inputs: str='{}') -> str
~~~


Run the legal domain agent action `partnership_onboarding_loop`.

Source: `lightbulb/mcp_generated_tools.py:10922`.

### `legal_plan_domain_intelligence`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_plan_domain_intelligence(message: str='', inputs: str='{}') -> str
~~~


Run the legal domain agent action `plan_domain_intelligence`.

Source: `lightbulb/mcp_generated_tools.py:11186`.

### `legal_privacy_incident_response_loop`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_privacy_incident_response_loop(message: str='', inputs: str='{}') -> str
~~~


Run the legal domain agent action `privacy_incident_response_loop`.

Source: `lightbulb/mcp_generated_tools.py:10966`.

### `legal_privilege_log_generate`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_privilege_log_generate(message: str='', inputs: str='{}') -> str
~~~


Run the legal domain agent action `privilege_log_generate`.

Source: `lightbulb/mcp_generated_tools.py:10548`.

### `legal_regulatory_horizon_to_policy_loop`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_regulatory_horizon_to_policy_loop(message: str='', inputs: str='{}') -> str
~~~


Run the legal domain agent action `regulatory_horizon_to_policy_loop`.

Source: `lightbulb/mcp_generated_tools.py:10988`.

### `legal_risk_contract_protection_loop`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_risk_contract_protection_loop(message: str='', inputs: str='{}') -> str
~~~


Run the legal domain agent action `risk_contract_protection_loop`.

Source: `lightbulb/mcp_generated_tools.py:11076`.

### `legal_sales_agreement_packet`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_sales_agreement_packet(message: str='', inputs: str='{}') -> str
~~~


Run the legal domain agent action `sales_agreement_packet`.

Source: `lightbulb/mcp_generated_tools.py:10063`.

### `legal_service_agreement_packet`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_service_agreement_packet(message: str='', inputs: str='{}') -> str
~~~


Run the legal domain agent action `service_agreement_packet`.

Source: `lightbulb/mcp_generated_tools.py:10107`.

### `legal_smokeball_account_sync`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_smokeball_account_sync(message: str='', inputs: str='{}') -> str
~~~


Run the legal domain agent action `smokeball_account_sync`.

Source: `lightbulb/mcp_generated_tools.py:10240`.

### `legal_smokeball_matter_operations`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_smokeball_matter_operations(message: str='', inputs: str='{}') -> str
~~~


Run the legal domain agent action `smokeball_matter_operations`.

Source: `lightbulb/mcp_generated_tools.py:10262`.

### `legal_smokeball_orchestration`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_smokeball_orchestration(message: str='', inputs: str='{}') -> str
~~~


Run the legal domain agent action `smokeball_orchestration`.

Source: `lightbulb/mcp_generated_tools.py:10218`.

### `legal_subpoena_route`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_subpoena_route(message: str='', inputs: str='{}') -> str
~~~


Run the legal domain agent action `subpoena_route`.

Source: `lightbulb/mcp_generated_tools.py:10526`.

### `legal_tax_compliance_report`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_tax_compliance_report(message: str='', inputs: str='{}') -> str
~~~


Run the legal domain agent action `tax_compliance_report`.

Source: `lightbulb/mcp_generated_tools.py:11142`.

### `legal_tax_deadline_alerts`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_tax_deadline_alerts(message: str='', inputs: str='{}') -> str
~~~


Run the legal domain agent action `tax_deadline_alerts`.

Source: `lightbulb/mcp_generated_tools.py:11164`.

### `legal_tax_obligation_scan`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_tax_obligation_scan(message: str='', inputs: str='{}') -> str
~~~


Run the legal domain agent action `tax_obligation_scan`.

Source: `lightbulb/mcp_generated_tools.py:11120`.

### `legal_tm_clearance_search`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_tm_clearance_search(message: str='', inputs: str='{}') -> str
~~~


Run the legal domain agent action `tm_clearance_search`.

Source: `lightbulb/mcp_generated_tools.py:10680`.

### `legal_tm_opposition_draft`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_tm_opposition_draft(message: str='', inputs: str='{}') -> str
~~~


Run the legal domain agent action `tm_opposition_draft`.

Source: `lightbulb/mcp_generated_tools.py:10702`.

### `legal_trade_secret_register`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_trade_secret_register(message: str='', inputs: str='{}') -> str
~~~


Run the legal domain agent action `trade_secret_register`.

Source: `lightbulb/mcp_generated_tools.py:10724`.

### `legal_vendor_onboard`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_vendor_onboard(message: str='', inputs: str='{}') -> str
~~~


Run the legal domain agent action `vendor_onboard`.

Source: `lightbulb/mcp_generated_tools.py:10746`.

### `legal_vendor_onboarding_legal_loop`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_vendor_onboarding_legal_loop(message: str='', inputs: str='{}') -> str
~~~


Run the legal domain agent action `vendor_onboarding_legal_loop`.

Source: `lightbulb/mcp_generated_tools.py:10900`.

### `legal_vendor_renew`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_vendor_renew(message: str='', inputs: str='{}') -> str
~~~


Run the legal domain agent action `vendor_renew`.

Source: `lightbulb/mcp_generated_tools.py:10790`.

### `legal_vendor_risk_score`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_vendor_risk_score(message: str='', inputs: str='{}') -> str
~~~


Run the legal domain agent action `vendor_risk_score`.

Source: `lightbulb/mcp_generated_tools.py:10834`.

### `legal_vendor_screen`

Namespace: `legal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
legal_vendor_screen(message: str='', inputs: str='{}') -> str
~~~


Run the legal domain agent action `vendor_screen`.

Source: `lightbulb/mcp_generated_tools.py:10768`.

### `linkedin_publish_post`

Namespace: `linkedin`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
linkedin_publish_post(author_urn: Optional[str]=None, text: Optional[str]=None, url: Optional[str]=None, image_url: Optional[str]=None, *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Publish one approved post under the exact LinkedIn member or organization author bound to the authenticated project connector route.

Source: `lightbulb/mcp_generated_tools.py:21843`.

### `microsoft_download_file`

Namespace: `microsoft`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
microsoft_download_file(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Microsoft connector operation `download_file` (platform tool `microsoft.download_file`).

Source: `lightbulb/mcp_generated_tools.py:21883`.

### `microsoft_list_channel_messages`

Namespace: `microsoft`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
microsoft_list_channel_messages(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Microsoft connector operation `list_channel_messages` (platform tool `microsoft.list_channel_messages`).

Source: `lightbulb/mcp_generated_tools.py:21928`.

### `microsoft_list_chat_messages`

Namespace: `microsoft`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
microsoft_list_chat_messages(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Microsoft connector operation `list_chat_messages` (platform tool `microsoft.list_chat_messages`).

Source: `lightbulb/mcp_generated_tools.py:21973`.

### `microsoft_list_chats`

Namespace: `microsoft`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
microsoft_list_chats(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Microsoft connector operation `list_chats` (platform tool `microsoft.list_chats`).

Source: `lightbulb/mcp_generated_tools.py:22018`.

### `microsoft_list_drive_files`

Namespace: `microsoft`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
microsoft_list_drive_files(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Microsoft connector operation `list_drive_files` (platform tool `microsoft.list_drive_files`).

Source: `lightbulb/mcp_generated_tools.py:22063`.

### `microsoft_list_emails`

Namespace: `microsoft`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
microsoft_list_emails(folder: str='Inbox', top: int=25, filter: Optional[str]=None, *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


List Outlook messages in the connected Microsoft 365 mailbox.

Source: `lightbulb/mcp_generated_tools.py:22108`.

### `microsoft_list_events`

Namespace: `microsoft`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
microsoft_list_events(start: Optional[str]=None, end: Optional[str]=None, top: int=50, *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


List Outlook calendar events on the connected Microsoft 365 calendar.

Source: `lightbulb/mcp_generated_tools.py:22145`.

### `microsoft_list_sharepoint_drive_items`

Namespace: `microsoft`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
microsoft_list_sharepoint_drive_items(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Microsoft connector operation `list_sharepoint_drive_items` (platform tool `microsoft.list_sharepoint_drive_items`).

Source: `lightbulb/mcp_generated_tools.py:22182`.

### `microsoft_list_sharepoint_drives`

Namespace: `microsoft`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
microsoft_list_sharepoint_drives(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Microsoft connector operation `list_sharepoint_drives` (platform tool `microsoft.list_sharepoint_drives`).

Source: `lightbulb/mcp_generated_tools.py:22227`.

### `microsoft_list_sharepoint_sites`

Namespace: `microsoft`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
microsoft_list_sharepoint_sites(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Microsoft connector operation `list_sharepoint_sites` (platform tool `microsoft.list_sharepoint_sites`).

Source: `lightbulb/mcp_generated_tools.py:22272`.

### `microsoft_list_team_channels`

Namespace: `microsoft`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
microsoft_list_team_channels(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Microsoft connector operation `list_team_channels` (platform tool `microsoft.list_team_channels`).

Source: `lightbulb/mcp_generated_tools.py:22317`.

### `microsoft_list_teams`

Namespace: `microsoft`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
microsoft_list_teams(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Microsoft connector operation `list_teams` (platform tool `microsoft.list_teams`).

Source: `lightbulb/mcp_generated_tools.py:22362`.

### `microsoft_post_channel_message`

Namespace: `microsoft`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
microsoft_post_channel_message(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Microsoft connector operation `post_channel_message` (platform tool `microsoft.post_channel_message`).

Source: `lightbulb/mcp_generated_tools.py:22407`.

### `microsoft_post_chat_message`

Namespace: `microsoft`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
microsoft_post_chat_message(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Microsoft connector operation `post_chat_message` (platform tool `microsoft.post_chat_message`).

Source: `lightbulb/mcp_generated_tools.py:22452`.

### `microsoft_send_email`

Namespace: `microsoft`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
microsoft_send_email(to: Optional[str]=None, subject: Optional[str]=None, body: Optional[str]=None, cc: Optional[str]=None, *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Send an email from the connected Microsoft 365 mailbox.

Source: `lightbulb/mcp_generated_tools.py:22497`.

### `microsoft_update_file`

Namespace: `microsoft`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
microsoft_update_file(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Microsoft connector operation `update_file` (platform tool `microsoft.update_file`).

Source: `lightbulb/mcp_generated_tools.py:22537`.

### `microsoft_upload_file`

Namespace: `microsoft`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
microsoft_upload_file(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Microsoft connector operation `upload_file` (platform tool `microsoft.upload_file`).

Source: `lightbulb/mcp_generated_tools.py:22582`.

### `monday_archive_board`

Namespace: `monday`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
monday_archive_board(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Monday connector operation `archive_board` (platform tool `monday.archive_board`).

Source: `lightbulb/mcp_generated_tools.py:22627`.

### `monday_archive_item`

Namespace: `monday`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
monday_archive_item(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Monday connector operation `archive_item` (platform tool `monday.archive_item`).

Source: `lightbulb/mcp_generated_tools.py:22672`.

### `monday_change_column_value`

Namespace: `monday`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
monday_change_column_value(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Monday connector operation `change_column_value` (platform tool `monday.change_column_value`).

Source: `lightbulb/mcp_generated_tools.py:22717`.

### `monday_create_board`

Namespace: `monday`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
monday_create_board(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Monday connector operation `create_board` (platform tool `monday.create_board`).

Source: `lightbulb/mcp_generated_tools.py:22762`.

### `monday_create_group`

Namespace: `monday`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
monday_create_group(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Monday connector operation `create_group` (platform tool `monday.create_group`).

Source: `lightbulb/mcp_generated_tools.py:22807`.

### `monday_create_item`

Namespace: `monday`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
monday_create_item(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Monday connector operation `create_item` (platform tool `monday.create_item`).

Source: `lightbulb/mcp_generated_tools.py:22852`.

### `monday_create_subitem`

Namespace: `monday`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
monday_create_subitem(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Monday connector operation `create_subitem` (platform tool `monday.create_subitem`).

Source: `lightbulb/mcp_generated_tools.py:22897`.

### `monday_create_update`

Namespace: `monday`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
monday_create_update(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Monday connector operation `create_update` (platform tool `monday.create_update`).

Source: `lightbulb/mcp_generated_tools.py:22942`.

### `monday_create_webhook`

Namespace: `monday`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
monday_create_webhook(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Monday connector operation `create_webhook` (platform tool `monday.create_webhook`).

Source: `lightbulb/mcp_generated_tools.py:22987`.

### `monday_delete_item`

Namespace: `monday`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
monday_delete_item(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Monday connector operation `delete_item` (platform tool `monday.delete_item`).

Source: `lightbulb/mcp_generated_tools.py:23032`.

### `monday_delete_webhook`

Namespace: `monday`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
monday_delete_webhook(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Monday connector operation `delete_webhook` (platform tool `monday.delete_webhook`).

Source: `lightbulb/mcp_generated_tools.py:23077`.

### `monday_duplicate_board`

Namespace: `monday`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
monday_duplicate_board(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Monday connector operation `duplicate_board` (platform tool `monday.duplicate_board`).

Source: `lightbulb/mcp_generated_tools.py:23122`.

### `monday_get_board`

Namespace: `monday`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
monday_get_board(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Monday connector operation `get_board` (platform tool `monday.get_board`).

Source: `lightbulb/mcp_generated_tools.py:23167`.

### `monday_get_item`

Namespace: `monday`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
monday_get_item(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Monday connector operation `get_item` (platform tool `monday.get_item`).

Source: `lightbulb/mcp_generated_tools.py:23212`.

### `monday_get_me`

Namespace: `monday`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
monday_get_me(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Monday connector operation `get_me` (platform tool `monday.get_me`).

Source: `lightbulb/mcp_generated_tools.py:23257`.

### `monday_hr_cases_board_id`

Namespace: `monday`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
monday_hr_cases_board_id(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Monday connector operation `hr_cases_board_id` (platform tool `monday.hr_cases_board_id`).

Source: `lightbulb/mcp_generated_tools.py:23302`.

### `monday_list_boards`

Namespace: `monday`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
monday_list_boards(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Monday connector operation `list_boards` (platform tool `monday.list_boards`).

Source: `lightbulb/mcp_generated_tools.py:23347`.

### `monday_list_docs`

Namespace: `monday`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
monday_list_docs(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Monday connector operation `list_docs` (platform tool `monday.list_docs`).

Source: `lightbulb/mcp_generated_tools.py:23392`.

### `monday_list_items`

Namespace: `monday`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
monday_list_items(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Monday connector operation `list_items` (platform tool `monday.list_items`).

Source: `lightbulb/mcp_generated_tools.py:23437`.

### `monday_list_subitems`

Namespace: `monday`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
monday_list_subitems(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Monday connector operation `list_subitems` (platform tool `monday.list_subitems`).

Source: `lightbulb/mcp_generated_tools.py:23482`.

### `monday_list_teams`

Namespace: `monday`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
monday_list_teams(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Monday connector operation `list_teams` (platform tool `monday.list_teams`).

Source: `lightbulb/mcp_generated_tools.py:23527`.

### `monday_list_updates`

Namespace: `monday`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
monday_list_updates(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Monday connector operation `list_updates` (platform tool `monday.list_updates`).

Source: `lightbulb/mcp_generated_tools.py:23572`.

### `monday_list_users`

Namespace: `monday`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
monday_list_users(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Monday connector operation `list_users` (platform tool `monday.list_users`).

Source: `lightbulb/mcp_generated_tools.py:23617`.

### `monday_list_workspaces`

Namespace: `monday`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
monday_list_workspaces(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Monday connector operation `list_workspaces` (platform tool `monday.list_workspaces`).

Source: `lightbulb/mcp_generated_tools.py:23662`.

### `monday_move_item_to_group`

Namespace: `monday`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
monday_move_item_to_group(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Monday connector operation `move_item_to_group` (platform tool `monday.move_item_to_group`).

Source: `lightbulb/mcp_generated_tools.py:23707`.

### `monday_offboarding_template_board_id`

Namespace: `monday`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
monday_offboarding_template_board_id(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Monday connector operation `offboarding_template_board_id` (platform tool `monday.offboarding_template_board_id`).

Source: `lightbulb/mcp_generated_tools.py:23752`.

### `monday_onboarding_template_board_id`

Namespace: `monday`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
monday_onboarding_template_board_id(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Monday connector operation `onboarding_template_board_id` (platform tool `monday.onboarding_template_board_id`).

Source: `lightbulb/mcp_generated_tools.py:23797`.

### `monday_query_data`

Namespace: `monday`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
monday_query_data(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Monday connector operation `query_data` (platform tool `monday.query_data`).

Source: `lightbulb/mcp_generated_tools.py:23842`.

### `monday_search_items`

Namespace: `monday`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
monday_search_items(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Monday connector operation `search_items` (platform tool `monday.search_items`).

Source: `lightbulb/mcp_generated_tools.py:23887`.

### `monday_update_item`

Namespace: `monday`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
monday_update_item(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Monday connector operation `update_item` (platform tool `monday.update_item`).

Source: `lightbulb/mcp_generated_tools.py:23932`.

### `monday_workspace_id`

Namespace: `monday`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
monday_workspace_id(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Monday connector operation `workspace_id` (platform tool `monday.workspace_id`).

Source: `lightbulb/mcp_generated_tools.py:23977`.

### `myob_create_bill`

Namespace: `myob`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
myob_create_bill(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Myob connector operation `create_bill` (platform tool `myob.create_bill`).

Source: `lightbulb/mcp_generated_tools.py:24022`.

### `myob_list_accounts`

Namespace: `myob`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
myob_list_accounts(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Myob connector operation `list_accounts` (platform tool `myob.list_accounts`).

Source: `lightbulb/mcp_generated_tools.py:24067`.

### `myob_list_contacts`

Namespace: `myob`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
myob_list_contacts(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Myob connector operation `list_contacts` (platform tool `myob.list_contacts`).

Source: `lightbulb/mcp_generated_tools.py:24112`.

### `myob_list_invoices`

Namespace: `myob`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
myob_list_invoices(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Myob connector operation `list_invoices` (platform tool `myob.list_invoices`).

Source: `lightbulb/mcp_generated_tools.py:24157`.

### `myob_list_payments`

Namespace: `myob`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
myob_list_payments(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Myob connector operation `list_payments` (platform tool `myob.list_payments`).

Source: `lightbulb/mcp_generated_tools.py:24202`.

### `notion_append_block_children`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_append_block_children(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Notion connector operation `append_block_children` (platform tool `notion.append_block_children`).

Source: `lightbulb/mcp_generated_tools.py:24247`.

### `notion_archive_page`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_archive_page(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Notion connector operation `archive_page` (platform tool `notion.archive_page`).

Source: `lightbulb/mcp_generated_tools.py:24292`.

### `notion_bulk_property_update`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_bulk_property_update(message: str='', inputs: str='{}') -> str
~~~


Run the notion domain agent action `bulk_property_update`.

Source: `lightbulb/mcp_generated_tools.py:11560`.

### `notion_bulk_status_update`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_bulk_status_update(message: str='', inputs: str='{}') -> str
~~~


Run the notion domain agent action `bulk_status_update`.

Source: `lightbulb/mcp_generated_tools.py:11538`.

### `notion_bulk_update_pages`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_bulk_update_pages(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Notion connector operation `bulk_update_pages` (platform tool `notion.bulk_update_pages`).

Source: `lightbulb/mcp_generated_tools.py:24337`.

### `notion_chat`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_chat(message: str='', inputs: str='{}') -> str
~~~


Run the notion domain agent action `chat`.

Source: `lightbulb/mcp_generated_tools.py:11208`.

### `notion_comment_orchestrator`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_comment_orchestrator(message: str='', inputs: str='{}') -> str
~~~


Run the notion domain agent action `comment_orchestrator`.

Source: `lightbulb/mcp_generated_tools.py:11494`.

### `notion_complete_file_upload`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_complete_file_upload(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Notion connector operation `complete_file_upload` (platform tool `notion.complete_file_upload`).

Source: `lightbulb/mcp_generated_tools.py:24382`.

### `notion_create_comment`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_create_comment(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Notion connector operation `create_comment` (platform tool `notion.create_comment`).

Source: `lightbulb/mcp_generated_tools.py:24427`.

### `notion_create_dashboard`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_create_dashboard(message: str='', inputs: str='{}') -> str
~~~


Run the notion domain agent action `create_dashboard`.

Source: `lightbulb/mcp_generated_tools.py:11604`.

### `notion_create_data_source`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_create_data_source(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Notion connector operation `create_data_source` (platform tool `notion.create_data_source`).

Source: `lightbulb/mcp_generated_tools.py:24472`.

### `notion_create_database`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_create_database(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Notion connector operation `create_database` (platform tool `notion.create_database`).

Source: `lightbulb/mcp_generated_tools.py:24517`.

### `notion_create_file_upload`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_create_file_upload(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Notion connector operation `create_file_upload` (platform tool `notion.create_file_upload`).

Source: `lightbulb/mcp_generated_tools.py:24562`.

### `notion_create_page`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_create_page(parent_id: Optional[str]=None, title: Optional[str]=None, content_markdown: Optional[str]=None, *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Create a new Notion page in the given parent (database or page).

Source: `lightbulb/mcp_generated_tools.py:24607`.

### `notion_create_view`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_create_view(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Notion connector operation `create_view` (platform tool `notion.create_view`).

Source: `lightbulb/mcp_generated_tools.py:24644`.

### `notion_create_webhook`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_create_webhook(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Notion connector operation `create_webhook` (platform tool `notion.create_webhook`).

Source: `lightbulb/mcp_generated_tools.py:24689`.

### `notion_delete_block`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_delete_block(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Notion connector operation `delete_block` (platform tool `notion.delete_block`).

Source: `lightbulb/mcp_generated_tools.py:24734`.

### `notion_delete_comment`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_delete_comment(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Notion connector operation `delete_comment` (platform tool `notion.delete_comment`).

Source: `lightbulb/mcp_generated_tools.py:24779`.

### `notion_delete_view`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_delete_view(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Notion connector operation `delete_view` (platform tool `notion.delete_view`).

Source: `lightbulb/mcp_generated_tools.py:24824`.

### `notion_delete_webhook`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_delete_webhook(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Notion connector operation `delete_webhook` (platform tool `notion.delete_webhook`).

Source: `lightbulb/mcp_generated_tools.py:24869`.

### `notion_get_block`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_get_block(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Notion connector operation `get_block` (platform tool `notion.get_block`).

Source: `lightbulb/mcp_generated_tools.py:24914`.

### `notion_get_comment`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_get_comment(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Notion connector operation `get_comment` (platform tool `notion.get_comment`).

Source: `lightbulb/mcp_generated_tools.py:24959`.

### `notion_get_file_upload`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_get_file_upload(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Notion connector operation `get_file_upload` (platform tool `notion.get_file_upload`).

Source: `lightbulb/mcp_generated_tools.py:25004`.

### `notion_get_page`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_get_page(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Notion connector operation `get_page` (platform tool `notion.get_page`).

Source: `lightbulb/mcp_generated_tools.py:25049`.

### `notion_get_page_markdown`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_get_page_markdown(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Notion connector operation `get_page_markdown` (platform tool `notion.get_page_markdown`).

Source: `lightbulb/mcp_generated_tools.py:25094`.

### `notion_get_self`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_get_self(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Notion connector operation `get_self` (platform tool `notion.get_self`).

Source: `lightbulb/mcp_generated_tools.py:25139`.

### `notion_get_user`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_get_user(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Notion connector operation `get_user` (platform tool `notion.get_user`).

Source: `lightbulb/mcp_generated_tools.py:25184`.

### `notion_get_view`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_get_view(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Notion connector operation `get_view` (platform tool `notion.get_view`).

Source: `lightbulb/mcp_generated_tools.py:25229`.

### `notion_kb_author`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_kb_author(message: str='', inputs: str='{}') -> str
~~~


Run the notion domain agent action `kb_author`.

Source: `lightbulb/mcp_generated_tools.py:11362`.

### `notion_link_review`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_link_review(message: str='', inputs: str='{}') -> str
~~~


Run the notion domain agent action `link_review`.

Source: `lightbulb/mcp_generated_tools.py:11516`.

### `notion_list_block_children`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_list_block_children(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Notion connector operation `list_block_children` (platform tool `notion.list_block_children`).

Source: `lightbulb/mcp_generated_tools.py:25274`.

### `notion_list_comments`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_list_comments(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Notion connector operation `list_comments` (platform tool `notion.list_comments`).

Source: `lightbulb/mcp_generated_tools.py:25319`.

### `notion_list_data_source_templates`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_list_data_source_templates(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Notion connector operation `list_data_source_templates` (platform tool `notion.list_data_source_templates`).

Source: `lightbulb/mcp_generated_tools.py:25364`.

### `notion_list_data_sources`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_list_data_sources(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Notion connector operation `list_data_sources` (platform tool `notion.list_data_sources`).

Source: `lightbulb/mcp_generated_tools.py:25409`.

### `notion_list_databases`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_list_databases(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Notion connector operation `list_databases` (platform tool `notion.list_databases`).

Source: `lightbulb/mcp_generated_tools.py:25454`.

### `notion_list_file_uploads`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_list_file_uploads(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Notion connector operation `list_file_uploads` (platform tool `notion.list_file_uploads`).

Source: `lightbulb/mcp_generated_tools.py:25499`.

### `notion_list_users`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_list_users(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Notion connector operation `list_users` (platform tool `notion.list_users`).

Source: `lightbulb/mcp_generated_tools.py:25544`.

### `notion_list_views`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_list_views(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Notion connector operation `list_views` (platform tool `notion.list_views`).

Source: `lightbulb/mcp_generated_tools.py:25589`.

### `notion_list_webhooks`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_list_webhooks(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Notion connector operation `list_webhooks` (platform tool `notion.list_webhooks`).

Source: `lightbulb/mcp_generated_tools.py:25634`.

### `notion_meeting_notes_capture`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_meeting_notes_capture(message: str='', inputs: str='{}') -> str
~~~


Run the notion domain agent action `meeting_notes_capture`.

Source: `lightbulb/mcp_generated_tools.py:11340`.

### `notion_move_page`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_move_page(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Notion connector operation `move_page` (platform tool `notion.move_page`).

Source: `lightbulb/mcp_generated_tools.py:25679`.

### `notion_oauth_introspect`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_oauth_introspect(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Notion connector operation `oauth_introspect` (platform tool `notion.oauth_introspect`).

Source: `lightbulb/mcp_generated_tools.py:25724`.

### `notion_oauth_revoke`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_oauth_revoke(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Notion connector operation `oauth_revoke` (platform tool `notion.oauth_revoke`).

Source: `lightbulb/mcp_generated_tools.py:25769`.

### `notion_okr_progress`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_okr_progress(message: str='', inputs: str='{}') -> str
~~~


Run the notion domain agent action `okr_progress`.

Source: `lightbulb/mcp_generated_tools.py:11450`.

### `notion_page_summarize`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_page_summarize(message: str='', inputs: str='{}') -> str
~~~


Run the notion domain agent action `page_summarize`.

Source: `lightbulb/mcp_generated_tools.py:11318`.

### `notion_plan_domain_intelligence`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_plan_domain_intelligence(message: str='', inputs: str='{}') -> str
~~~


Run the notion domain agent action `plan_domain_intelligence`.

Source: `lightbulb/mcp_generated_tools.py:11626`.

### `notion_query_data`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_query_data(message: str='', inputs: str='{}') -> str
~~~


Run the notion domain agent action `query_data`.

Source: `lightbulb/mcp_generated_tools.py:11230`.

### `notion_query_data_source`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_query_data_source(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Notion connector operation `query_data_source` (platform tool `notion.query_data_source`).

Source: `lightbulb/mcp_generated_tools.py:25814`.

### `notion_query_database`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_query_database(database_id: Optional[str]=None, filter_json: Optional[str]=None, sorts_json: Optional[str]=None, page_size: int=100, *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Query rows in a Notion database with filters and sorts.

Source: `lightbulb/mcp_generated_tools.py:25859`.

### `notion_query_view`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_query_view(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Notion connector operation `query_view` (platform tool `notion.query_view`).

Source: `lightbulb/mcp_generated_tools.py:25899`.

### `notion_replace_page_markdown`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_replace_page_markdown(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Notion connector operation `replace_page_markdown` (platform tool `notion.replace_page_markdown`).

Source: `lightbulb/mcp_generated_tools.py:25944`.

### `notion_schema_intelligence`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_schema_intelligence(message: str='', inputs: str='{}') -> str
~~~


Run the notion domain agent action `schema_intelligence`.

Source: `lightbulb/mcp_generated_tools.py:11274`.

### `notion_search`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_search(query: Optional[str]=None, filter_type: Optional[str]=None, *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Search Notion pages and databases the integration has access to.

Source: `lightbulb/mcp_generated_tools.py:25989`.

### `notion_search_by_title`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_search_by_title(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Notion connector operation `search_by_title` (platform tool `notion.search_by_title`).

Source: `lightbulb/mcp_generated_tools.py:26023`.

### `notion_search_intelligent`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_search_intelligent(message: str='', inputs: str='{}') -> str
~~~


Run the notion domain agent action `search_intelligent`.

Source: `lightbulb/mcp_generated_tools.py:11296`.

### `notion_send_file_upload`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_send_file_upload(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Notion connector operation `send_file_upload` (platform tool `notion.send_file_upload`).

Source: `lightbulb/mcp_generated_tools.py:26068`.

### `notion_sprint_plan`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_sprint_plan(message: str='', inputs: str='{}') -> str
~~~


Run the notion domain agent action `sprint_plan`.

Source: `lightbulb/mcp_generated_tools.py:11406`.

### `notion_template_runner`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_template_runner(message: str='', inputs: str='{}') -> str
~~~


Run the notion domain agent action `template_runner`.

Source: `lightbulb/mcp_generated_tools.py:11582`.

### `notion_trash_page`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_trash_page(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Notion connector operation `trash_page` (platform tool `notion.trash_page`).

Source: `lightbulb/mcp_generated_tools.py:26113`.

### `notion_triage_backlog`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_triage_backlog(message: str='', inputs: str='{}') -> str
~~~


Run the notion domain agent action `triage_backlog`.

Source: `lightbulb/mcp_generated_tools.py:11384`.

### `notion_update_block`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_update_block(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Notion connector operation `update_block` (platform tool `notion.update_block`).

Source: `lightbulb/mcp_generated_tools.py:26158`.

### `notion_update_comment`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_update_comment(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Notion connector operation `update_comment` (platform tool `notion.update_comment`).

Source: `lightbulb/mcp_generated_tools.py:26203`.

### `notion_update_data_source_properties`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_update_data_source_properties(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Notion connector operation `update_data_source_properties` (platform tool `notion.update_data_source_properties`).

Source: `lightbulb/mcp_generated_tools.py:26248`.

### `notion_update_database`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_update_database(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Notion connector operation `update_database` (platform tool `notion.update_database`).

Source: `lightbulb/mcp_generated_tools.py:26293`.

### `notion_update_database_properties`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_update_database_properties(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Notion connector operation `update_database_properties` (platform tool `notion.update_database_properties`).

Source: `lightbulb/mcp_generated_tools.py:26338`.

### `notion_update_page`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_update_page(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Notion connector operation `update_page` (platform tool `notion.update_page`).

Source: `lightbulb/mcp_generated_tools.py:26383`.

### `notion_update_page_markdown`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_update_page_markdown(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Notion connector operation `update_page_markdown` (platform tool `notion.update_page_markdown`).

Source: `lightbulb/mcp_generated_tools.py:26428`.

### `notion_update_view`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_update_view(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Notion connector operation `update_view` (platform tool `notion.update_view`).

Source: `lightbulb/mcp_generated_tools.py:26473`.

### `notion_view_designer`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_view_designer(message: str='', inputs: str='{}') -> str
~~~


Run the notion domain agent action `view_designer`.

Source: `lightbulb/mcp_generated_tools.py:11472`.

### `notion_weekly_status_report`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_weekly_status_report(message: str='', inputs: str='{}') -> str
~~~


Run the notion domain agent action `weekly_status_report`.

Source: `lightbulb/mcp_generated_tools.py:11428`.

### `notion_workspace_inventory`

Namespace: `notion`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
notion_workspace_inventory(message: str='', inputs: str='{}') -> str
~~~


Run the notion domain agent action `workspace_inventory`.

Source: `lightbulb/mcp_generated_tools.py:11252`.

### `paypal_list_disputes`

Namespace: `paypal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
paypal_list_disputes(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Paypal connector operation `list_disputes` (platform tool `paypal.list_disputes`).

Source: `lightbulb/mcp_generated_tools.py:26518`.

### `paypal_list_invoices`

Namespace: `paypal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
paypal_list_invoices(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Paypal connector operation `list_invoices` (platform tool `paypal.list_invoices`).

Source: `lightbulb/mcp_generated_tools.py:26563`.

### `paypal_list_payouts`

Namespace: `paypal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
paypal_list_payouts(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Paypal connector operation `list_payouts` (platform tool `paypal.list_payouts`).

Source: `lightbulb/mcp_generated_tools.py:26608`.

### `paypal_list_transactions`

Namespace: `paypal`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
paypal_list_transactions(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Paypal connector operation `list_transactions` (platform tool `paypal.list_transactions`).

Source: `lightbulb/mcp_generated_tools.py:26653`.

### `procurement_chat`

Namespace: `procurement`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
procurement_chat(message: str='', inputs: str='{}') -> str
~~~


Run the procurement domain agent action `chat`.

Source: `lightbulb/mcp_generated_tools.py:11648`.

### `procurement_contract_to_pay`

Namespace: `procurement`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
procurement_contract_to_pay(message: str='', inputs: str='{}') -> str
~~~


Run the procurement domain agent action `contract_to_pay`.

Source: `lightbulb/mcp_generated_tools.py:11736`.

### `procurement_plan_domain_intelligence`

Namespace: `procurement`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
procurement_plan_domain_intelligence(message: str='', inputs: str='{}') -> str
~~~


Run the procurement domain agent action `plan_domain_intelligence`.

Source: `lightbulb/mcp_generated_tools.py:11802`.

### `procurement_po_approval_workflow`

Namespace: `procurement`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
procurement_po_approval_workflow(message: str='', inputs: str='{}') -> str
~~~


Run the procurement domain agent action `po_approval_workflow`.

Source: `lightbulb/mcp_generated_tools.py:11692`.

### `procurement_spend_analysis`

Namespace: `procurement`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
procurement_spend_analysis(message: str='', inputs: str='{}') -> str
~~~


Run the procurement domain agent action `spend_analysis`.

Source: `lightbulb/mcp_generated_tools.py:11758`.

### `procurement_supplier_evaluation`

Namespace: `procurement`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
procurement_supplier_evaluation(message: str='', inputs: str='{}') -> str
~~~


Run the procurement domain agent action `supplier_evaluation`.

Source: `lightbulb/mcp_generated_tools.py:11714`.

### `procurement_vendor_onboarding`

Namespace: `procurement`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
procurement_vendor_onboarding(message: str='', inputs: str='{}') -> str
~~~


Run the procurement domain agent action `vendor_onboarding`.

Source: `lightbulb/mcp_generated_tools.py:11670`.

### `procurement_vendor_risk_assessment`

Namespace: `procurement`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
procurement_vendor_risk_assessment(message: str='', inputs: str='{}') -> str
~~~


Run the procurement domain agent action `vendor_risk_assessment`.

Source: `lightbulb/mcp_generated_tools.py:11780`.

### `product_analysis`

Namespace: `product`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
product_analysis(message: str='', inputs: str='{}') -> str
~~~


Run the product domain agent action `product_analysis`.

Source: `lightbulb/mcp_generated_tools.py:12044`.

### `product_assortment_gap_analysis`

Namespace: `product`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
product_assortment_gap_analysis(message: str='', inputs: str='{}') -> str
~~~


Run the product domain agent action `assortment_gap_analysis`.

Source: `lightbulb/mcp_generated_tools.py:12110`.

### `product_chat`

Namespace: `product`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
product_chat(message: str='', inputs: str='{}') -> str
~~~


Run the product domain agent action `chat`.

Source: `lightbulb/mcp_generated_tools.py:11824`.

### `product_competitor_watchlist`

Namespace: `product`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
product_competitor_watchlist(message: str='', inputs: str='{}') -> str
~~~


Run the product domain agent action `competitor_watchlist`.

Source: `lightbulb/mcp_generated_tools.py:12088`.

### `product_customer_segment`

Namespace: `product`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
product_customer_segment(message: str='', inputs: str='{}') -> str
~~~


Run the product domain agent action `customer_segment`.

Source: `lightbulb/mcp_generated_tools.py:12000`.

### `product_experiment_design`

Namespace: `product`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
product_experiment_design(message: str='', inputs: str='{}') -> str
~~~


Run the product domain agent action `experiment_design`.

Source: `lightbulb/mcp_generated_tools.py:11890`.

### `product_experimentation`

Namespace: `product`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
product_experimentation(message: str='', inputs: str='{}') -> str
~~~


Run the product domain agent action `experimentation`.

Source: `lightbulb/mcp_generated_tools.py:11868`.

### `product_feature_adoption`

Namespace: `product`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
product_feature_adoption(message: str='', inputs: str='{}') -> str
~~~


Run the product domain agent action `feature_adoption`.

Source: `lightbulb/mcp_generated_tools.py:11846`.

### `product_feedback_synthesis`

Namespace: `product`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
product_feedback_synthesis(message: str='', inputs: str='{}') -> str
~~~


Run the product domain agent action `feedback_synthesis`.

Source: `lightbulb/mcp_generated_tools.py:11912`.

### `product_plan_domain_intelligence`

Namespace: `product`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
product_plan_domain_intelligence(message: str='', inputs: str='{}') -> str
~~~


Run the product domain agent action `plan_domain_intelligence`.

Source: `lightbulb/mcp_generated_tools.py:12132`.

### `product_predict`

Namespace: `product`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
product_predict(message: str='', inputs: str='{}') -> str
~~~


Run the product domain agent action `predict`.

Source: `lightbulb/mcp_generated_tools.py:12022`.

### `product_pricing_intelligence`

Namespace: `product`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
product_pricing_intelligence(message: str='', inputs: str='{}') -> str
~~~


Run the product domain agent action `pricing_intelligence`.

Source: `lightbulb/mcp_generated_tools.py:11978`.

### `product_roadmap_plan`

Namespace: `product`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
product_roadmap_plan(message: str='', inputs: str='{}') -> str
~~~


Run the product domain agent action `roadmap_plan`.

Source: `lightbulb/mcp_generated_tools.py:11956`.

### `product_roadmap_prioritize`

Namespace: `product`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
product_roadmap_prioritize(message: str='', inputs: str='{}') -> str
~~~


Run the product domain agent action `roadmap_prioritize`.

Source: `lightbulb/mcp_generated_tools.py:11934`.

### `product_trend_synthesis`

Namespace: `product`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
product_trend_synthesis(message: str='', inputs: str='{}') -> str
~~~


Run the product domain agent action `trend_synthesis`.

Source: `lightbulb/mcp_generated_tools.py:12066`.

### `quickbooks_aged_payable_report`

Namespace: `quickbooks`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
quickbooks_aged_payable_report(as_of_date: Optional[str]=None, start_date: Optional[str]=None, end_date: Optional[str]=None, columns: Optional[list[str]]=None, *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Fetch the QuickBooks aged payables report for AP aging and vendor cash planning.

Source: `lightbulb/mcp_generated_tools.py:26698`.

### `quickbooks_aged_receivable_report`

Namespace: `quickbooks`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
quickbooks_aged_receivable_report(as_of_date: Optional[str]=None, start_date: Optional[str]=None, end_date: Optional[str]=None, columns: Optional[list[str]]=None, *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Fetch the QuickBooks aged receivables report for AR aging and collections analysis.

Source: `lightbulb/mcp_generated_tools.py:26738`.

### `quickbooks_balance_sheet_report`

Namespace: `quickbooks`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
quickbooks_balance_sheet_report(as_of_date: Optional[str]=None, accounting_method: Optional[str]=None, summarize_column_by: Optional[str]=None, columns: Optional[list[str]]=None, *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Fetch the QuickBooks balance sheet report as of a date.

Source: `lightbulb/mcp_generated_tools.py:26778`.

### `quickbooks_cash_flow_report`

Namespace: `quickbooks`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
quickbooks_cash_flow_report(start_date: Optional[str]=None, end_date: Optional[str]=None, accounting_method: Optional[str]=None, summarize_column_by: Optional[str]=None, columns: Optional[list[str]]=None, *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Fetch the QuickBooks statement of cash flows for cash-flow analysis.

Source: `lightbulb/mcp_generated_tools.py:26818`.

### `quickbooks_company_info`

Namespace: `quickbooks`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
quickbooks_company_info(*, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Fetch QuickBooks company information for the active company.

Source: `lightbulb/mcp_generated_tools.py:26861`.

### `quickbooks_controller_snapshot`

Namespace: `quickbooks`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
quickbooks_controller_snapshot(reports: Optional[list[str]]=None, start_date: Optional[str]=None, end_date: Optional[str]=None, as_of_date: Optional[str]=None, *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Build a QuickBooks controller snapshot with company info, preferences, and core financial reports.

Source: `lightbulb/mcp_generated_tools.py:26889`.

### `quickbooks_create_bill`

Namespace: `quickbooks`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
quickbooks_create_bill(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Quickbooks connector operation `create_bill` (platform tool `quickbooks.create_bill`).

Source: `lightbulb/mcp_generated_tools.py:26929`.

### `quickbooks_create_entity`

Namespace: `quickbooks`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
quickbooks_create_entity(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Quickbooks connector operation `create_entity` (platform tool `quickbooks.create_entity`).

Source: `lightbulb/mcp_generated_tools.py:26974`.

### `quickbooks_create_invoice`

Namespace: `quickbooks`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
quickbooks_create_invoice(customer_id: Optional[str]=None, line_items: Optional[list[str]]=None, due_date: Optional[str]=None, *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Create a draft QuickBooks invoice for a customer.

Source: `lightbulb/mcp_generated_tools.py:27019`.

### `quickbooks_create_journal_entry`

Namespace: `quickbooks`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
quickbooks_create_journal_entry(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Quickbooks connector operation `create_journal_entry` (platform tool `quickbooks.create_journal_entry`).

Source: `lightbulb/mcp_generated_tools.py:27056`.

### `quickbooks_deep_sync`

Namespace: `quickbooks`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
quickbooks_deep_sync(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Quickbooks connector operation `deep_sync` (platform tool `quickbooks.deep_sync`).

Source: `lightbulb/mcp_generated_tools.py:27101`.

### `quickbooks_get_company_info`

Namespace: `quickbooks`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
quickbooks_get_company_info(*, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Fetch QuickBooks company information for the active company.

Source: `lightbulb/mcp_generated_tools.py:27146`.

### `quickbooks_get_entity`

Namespace: `quickbooks`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
quickbooks_get_entity(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Quickbooks connector operation `get_entity` (platform tool `quickbooks.get_entity`).

Source: `lightbulb/mcp_generated_tools.py:27174`.

### `quickbooks_get_invoice`

Namespace: `quickbooks`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
quickbooks_get_invoice(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Quickbooks connector operation `get_invoice` (platform tool `quickbooks.get_invoice`).

Source: `lightbulb/mcp_generated_tools.py:27219`.

### `quickbooks_get_journal_entry`

Namespace: `quickbooks`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
quickbooks_get_journal_entry(entity_id: str, *, project_id: str, project_ref: str, connector_account_ref: str, idempotency_key: str, effect: Literal['read'], approval_ref: Optional[str]=None) -> str
~~~


Read one exact QuickBooks JournalEntry through the governed finance readback route.

Source: `lightbulb/mcp_generated_tools.py:27264`.

### `quickbooks_list_accounts`

Namespace: `quickbooks`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
quickbooks_list_accounts(account_type: Optional[str]=None, max_results: int=500, *, project_id: str, project_ref: str, connector_account_ref: str, idempotency_key: str, effect: Literal['read'], approval_ref: Optional[str]=None) -> str
~~~


List the QuickBooks chart of accounts for GL and statement analysis.

Source: `lightbulb/mcp_generated_tools.py:27297`.

### `quickbooks_list_bills`

Namespace: `quickbooks`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
quickbooks_list_bills(status: Optional[str]=None, from_date: Optional[str]=None, to_date: Optional[str]=None, max_results: int=100, *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


List QuickBooks vendor bills for AP analysis.

Source: `lightbulb/mcp_generated_tools.py:27333`.

### `quickbooks_list_classes`

Namespace: `quickbooks`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
quickbooks_list_classes(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Quickbooks connector operation `list_classes` (platform tool `quickbooks.list_classes`).

Source: `lightbulb/mcp_generated_tools.py:27373`.

### `quickbooks_list_credit_memos`

Namespace: `quickbooks`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
quickbooks_list_credit_memos(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Quickbooks connector operation `list_credit_memos` (platform tool `quickbooks.list_credit_memos`).

Source: `lightbulb/mcp_generated_tools.py:27418`.

### `quickbooks_list_customers`

Namespace: `quickbooks`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
quickbooks_list_customers(query: Optional[str]=None, max_results: int=100, *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


List QuickBooks customers for the active company.

Source: `lightbulb/mcp_generated_tools.py:27463`.

### `quickbooks_list_departments`

Namespace: `quickbooks`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
quickbooks_list_departments(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Quickbooks connector operation `list_departments` (platform tool `quickbooks.list_departments`).

Source: `lightbulb/mcp_generated_tools.py:27497`.

### `quickbooks_list_deposits`

Namespace: `quickbooks`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
quickbooks_list_deposits(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Quickbooks connector operation `list_deposits` (platform tool `quickbooks.list_deposits`).

Source: `lightbulb/mcp_generated_tools.py:27542`.

### `quickbooks_list_entities`

Namespace: `quickbooks`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
quickbooks_list_entities(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Quickbooks connector operation `list_entities` (platform tool `quickbooks.list_entities`).

Source: `lightbulb/mcp_generated_tools.py:27587`.

### `quickbooks_list_invoices`

Namespace: `quickbooks`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
quickbooks_list_invoices(status: Optional[str]=None, from_date: Optional[str]=None, to_date: Optional[str]=None, max_results: int=100, *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


List QuickBooks invoices for the active company.

Source: `lightbulb/mcp_generated_tools.py:27632`.

### `quickbooks_list_items`

Namespace: `quickbooks`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
quickbooks_list_items(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Quickbooks connector operation `list_items` (platform tool `quickbooks.list_items`).

Source: `lightbulb/mcp_generated_tools.py:27672`.

### `quickbooks_list_payment_methods`

Namespace: `quickbooks`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
quickbooks_list_payment_methods(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Quickbooks connector operation `list_payment_methods` (platform tool `quickbooks.list_payment_methods`).

Source: `lightbulb/mcp_generated_tools.py:27717`.

### `quickbooks_list_payments`

Namespace: `quickbooks`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
quickbooks_list_payments(from_date: Optional[str]=None, to_date: Optional[str]=None, max_results: int=100, *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


List QuickBooks payments for cash movement and reconciliation analysis.

Source: `lightbulb/mcp_generated_tools.py:27762`.

### `quickbooks_list_purchase_orders`

Namespace: `quickbooks`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
quickbooks_list_purchase_orders(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Quickbooks connector operation `list_purchase_orders` (platform tool `quickbooks.list_purchase_orders`).

Source: `lightbulb/mcp_generated_tools.py:27799`.

### `quickbooks_list_purchases`

Namespace: `quickbooks`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
quickbooks_list_purchases(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Quickbooks connector operation `list_purchases` (platform tool `quickbooks.list_purchases`).

Source: `lightbulb/mcp_generated_tools.py:27844`.

### `quickbooks_list_refund_receipts`

Namespace: `quickbooks`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
quickbooks_list_refund_receipts(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Quickbooks connector operation `list_refund_receipts` (platform tool `quickbooks.list_refund_receipts`).

Source: `lightbulb/mcp_generated_tools.py:27889`.

### `quickbooks_list_sales_receipts`

Namespace: `quickbooks`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
quickbooks_list_sales_receipts(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Quickbooks connector operation `list_sales_receipts` (platform tool `quickbooks.list_sales_receipts`).

Source: `lightbulb/mcp_generated_tools.py:27934`.

### `quickbooks_list_tax_codes`

Namespace: `quickbooks`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
quickbooks_list_tax_codes(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Quickbooks connector operation `list_tax_codes` (platform tool `quickbooks.list_tax_codes`).

Source: `lightbulb/mcp_generated_tools.py:27979`.

### `quickbooks_list_tax_rates`

Namespace: `quickbooks`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
quickbooks_list_tax_rates(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Quickbooks connector operation `list_tax_rates` (platform tool `quickbooks.list_tax_rates`).

Source: `lightbulb/mcp_generated_tools.py:28024`.

### `quickbooks_list_terms`

Namespace: `quickbooks`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
quickbooks_list_terms(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Quickbooks connector operation `list_terms` (platform tool `quickbooks.list_terms`).

Source: `lightbulb/mcp_generated_tools.py:28069`.

### `quickbooks_list_vendor_credits`

Namespace: `quickbooks`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
quickbooks_list_vendor_credits(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Quickbooks connector operation `list_vendor_credits` (platform tool `quickbooks.list_vendor_credits`).

Source: `lightbulb/mcp_generated_tools.py:28114`.

### `quickbooks_list_vendors`

Namespace: `quickbooks`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
quickbooks_list_vendors(query: Optional[str]=None, max_results: int=100, *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


List QuickBooks vendors for the active company.

Source: `lightbulb/mcp_generated_tools.py:28159`.

### `quickbooks_pay_bill`

Namespace: `quickbooks`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
quickbooks_pay_bill(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Quickbooks connector operation `pay_bill` (platform tool `quickbooks.pay_bill`).

Source: `lightbulb/mcp_generated_tools.py:28193`.

### `quickbooks_payroll_company_info`

Namespace: `quickbooks`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
quickbooks_payroll_company_info(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Quickbooks connector operation `payroll_company_info` (platform tool `quickbooks.payroll_company_info`).

Source: `lightbulb/mcp_generated_tools.py:28238`.

### `quickbooks_payroll_employees`

Namespace: `quickbooks`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
quickbooks_payroll_employees(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Quickbooks connector operation `payroll_employees` (platform tool `quickbooks.payroll_employees`).

Source: `lightbulb/mcp_generated_tools.py:28283`.

### `quickbooks_payroll_payslips`

Namespace: `quickbooks`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
quickbooks_payroll_payslips(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Quickbooks connector operation `payroll_payslips` (platform tool `quickbooks.payroll_payslips`).

Source: `lightbulb/mcp_generated_tools.py:28328`.

### `quickbooks_profit_loss_report`

Namespace: `quickbooks`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
quickbooks_profit_loss_report(start_date: Optional[str]=None, end_date: Optional[str]=None, accounting_method: Optional[str]=None, summarize_column_by: Optional[str]=None, columns: Optional[list[str]]=None, *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Fetch the QuickBooks profit and loss report for income statement analysis.

Source: `lightbulb/mcp_generated_tools.py:28373`.

### `quickbooks_query`

Namespace: `quickbooks`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
quickbooks_query(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Quickbooks connector operation `query` (platform tool `quickbooks.query`).

Source: `lightbulb/mcp_generated_tools.py:28416`.

### `quickbooks_report`

Namespace: `quickbooks`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
quickbooks_report(report_name: Optional[str]=None, start_date: Optional[str]=None, end_date: Optional[str]=None, as_of_date: Optional[str]=None, accounting_method: Optional[str]=None, summarize_column_by: Optional[str]=None, columns: Optional[list[str]]=None, *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Fetch a named QuickBooks report such as profit_loss, balance_sheet, cash_flow, trial_balance, ar_aging, or ap_aging.

Source: `lightbulb/mcp_generated_tools.py:28461`.

### `quickbooks_trial_balance_report`

Namespace: `quickbooks`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
quickbooks_trial_balance_report(start_date: Optional[str]=None, end_date: Optional[str]=None, accounting_method: Optional[str]=None, columns: Optional[list[str]]=None, *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Fetch the QuickBooks trial balance report for GL tie-out and close review.

Source: `lightbulb/mcp_generated_tools.py:28510`.

### `quickbooks_update_entity`

Namespace: `quickbooks`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
quickbooks_update_entity(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Quickbooks connector operation `update_entity` (platform tool `quickbooks.update_entity`).

Source: `lightbulb/mcp_generated_tools.py:28550`.

### `ramp_list_receipts`

Namespace: `ramp`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
ramp_list_receipts(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Ramp connector operation `list_receipts` (platform tool `ramp.list_receipts`).

Source: `lightbulb/mcp_generated_tools.py:28595`.

### `ramp_list_reimbursements`

Namespace: `ramp`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
ramp_list_reimbursements(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Ramp connector operation `list_reimbursements` (platform tool `ramp.list_reimbursements`).

Source: `lightbulb/mcp_generated_tools.py:28640`.

### `ramp_list_transactions`

Namespace: `ramp`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
ramp_list_transactions(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Ramp connector operation `list_transactions` (platform tool `ramp.list_transactions`).

Source: `lightbulb/mcp_generated_tools.py:28685`.

### `salesforce_bulk_ingest_close`

Namespace: `salesforce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
salesforce_bulk_ingest_close(message: str='', inputs: str='{}') -> str
~~~


Run the salesforce domain agent action `bulk_ingest_close`.

Source: `lightbulb/mcp_generated_tools.py:12154`.

### `salesforce_bulk_ingest_create`

Namespace: `salesforce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
salesforce_bulk_ingest_create(message: str='', inputs: str='{}') -> str
~~~


Run the salesforce domain agent action `bulk_ingest_create`.

Source: `lightbulb/mcp_generated_tools.py:12176`.

### `salesforce_bulk_ingest_results`

Namespace: `salesforce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
salesforce_bulk_ingest_results(message: str='', inputs: str='{}') -> str
~~~


Run the salesforce domain agent action `bulk_ingest_results`.

Source: `lightbulb/mcp_generated_tools.py:12198`.

### `salesforce_bulk_ingest_status`

Namespace: `salesforce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
salesforce_bulk_ingest_status(message: str='', inputs: str='{}') -> str
~~~


Run the salesforce domain agent action `bulk_ingest_status`.

Source: `lightbulb/mcp_generated_tools.py:12220`.

### `salesforce_bulk_ingest_upload`

Namespace: `salesforce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
salesforce_bulk_ingest_upload(message: str='', inputs: str='{}') -> str
~~~


Run the salesforce domain agent action `bulk_ingest_upload`.

Source: `lightbulb/mcp_generated_tools.py:12242`.

### `salesforce_bulk_query_create`

Namespace: `salesforce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
salesforce_bulk_query_create(message: str='', inputs: str='{}') -> str
~~~


Run the salesforce domain agent action `bulk_query_create`.

Source: `lightbulb/mcp_generated_tools.py:12264`.

### `salesforce_bulk_query_results`

Namespace: `salesforce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
salesforce_bulk_query_results(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Salesforce connector operation `bulk_query_results` (platform tool `salesforce.bulk_query_results`).

Source: `lightbulb/mcp_generated_tools.py:28730`.

### `salesforce_bulk_query_status`

Namespace: `salesforce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
salesforce_bulk_query_status(message: str='', inputs: str='{}') -> str
~~~


Run the salesforce domain agent action `bulk_query_status`.

Source: `lightbulb/mcp_generated_tools.py:12286`.

### `salesforce_chat`

Namespace: `salesforce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
salesforce_chat(message: str='', inputs: str='{}') -> str
~~~


Run the salesforce domain agent action `chat`.

Source: `lightbulb/mcp_generated_tools.py:12308`.

### `salesforce_composite_graph`

Namespace: `salesforce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
salesforce_composite_graph(message: str='', inputs: str='{}') -> str
~~~


Run the salesforce domain agent action `composite_graph`.

Source: `lightbulb/mcp_generated_tools.py:12330`.

### `salesforce_create_contact`

Namespace: `salesforce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
salesforce_create_contact(message: str='', inputs: str='{}') -> str
~~~


Run the salesforce domain agent action `create_contact`.

Source: `lightbulb/mcp_generated_tools.py:12352`.

### `salesforce_create_note`

Namespace: `salesforce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
salesforce_create_note(message: str='', inputs: str='{}') -> str
~~~


Run the salesforce domain agent action `create_note`.

Source: `lightbulb/mcp_generated_tools.py:12374`.

### `salesforce_create_opportunity`

Namespace: `salesforce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
salesforce_create_opportunity(message: str='', inputs: str='{}') -> str
~~~


Run the salesforce domain agent action `create_opportunity`.

Source: `lightbulb/mcp_generated_tools.py:12396`.

### `salesforce_create_task`

Namespace: `salesforce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
salesforce_create_task(message: str='', inputs: str='{}') -> str
~~~


Run the salesforce domain agent action `create_task`.

Source: `lightbulb/mcp_generated_tools.py:12418`.

### `salesforce_deploy_apex_class`

Namespace: `salesforce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
salesforce_deploy_apex_class(message: str='', inputs: str='{}') -> str
~~~


Run the salesforce domain agent action `deploy_apex_class`.

Source: `lightbulb/mcp_generated_tools.py:12440`.

### `salesforce_deploy_flow`

Namespace: `salesforce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
salesforce_deploy_flow(message: str='', inputs: str='{}') -> str
~~~


Run the salesforce domain agent action `deploy_flow`.

Source: `lightbulb/mcp_generated_tools.py:12462`.

### `salesforce_deploy_permission_set`

Namespace: `salesforce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
salesforce_deploy_permission_set(message: str='', inputs: str='{}') -> str
~~~


Run the salesforce domain agent action `deploy_permission_set`.

Source: `lightbulb/mcp_generated_tools.py:12484`.

### `salesforce_deploy_validation_rule`

Namespace: `salesforce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
salesforce_deploy_validation_rule(message: str='', inputs: str='{}') -> str
~~~


Run the salesforce domain agent action `deploy_validation_rule`.

Source: `lightbulb/mcp_generated_tools.py:12506`.

### `salesforce_describe_object`

Namespace: `salesforce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
salesforce_describe_object(message: str='', inputs: str='{}') -> str
~~~


Run the salesforce domain agent action `describe_object`.

Source: `lightbulb/mcp_generated_tools.py:12528`.

### `salesforce_get_account`

Namespace: `salesforce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
salesforce_get_account(message: str='', inputs: str='{}') -> str
~~~


Run the salesforce domain agent action `get_account`.

Source: `lightbulb/mcp_generated_tools.py:12550`.

### `salesforce_get_contact`

Namespace: `salesforce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
salesforce_get_contact(message: str='', inputs: str='{}') -> str
~~~


Run the salesforce domain agent action `get_contact`.

Source: `lightbulb/mcp_generated_tools.py:12572`.

### `salesforce_get_opportunity`

Namespace: `salesforce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
salesforce_get_opportunity(message: str='', inputs: str='{}') -> str
~~~


Run the salesforce domain agent action `get_opportunity`.

Source: `lightbulb/mcp_generated_tools.py:12594`.

### `salesforce_get_pipeline_report`

Namespace: `salesforce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
salesforce_get_pipeline_report(message: str='', inputs: str='{}') -> str
~~~


Run the salesforce domain agent action `get_pipeline_report`.

Source: `lightbulb/mcp_generated_tools.py:12616`.

### `salesforce_invoke_models_api`

Namespace: `salesforce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
salesforce_invoke_models_api(message: str='', inputs: str='{}') -> str
~~~


Run the salesforce domain agent action `invoke_models_api`.

Source: `lightbulb/mcp_generated_tools.py:12638`.

### `salesforce_invoke_prompt_template`

Namespace: `salesforce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
salesforce_invoke_prompt_template(message: str='', inputs: str='{}') -> str
~~~


Run the salesforce domain agent action `invoke_prompt_template`.

Source: `lightbulb/mcp_generated_tools.py:12660`.

### `salesforce_list_accounts`

Namespace: `salesforce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
salesforce_list_accounts(message: str='', inputs: str='{}') -> str
~~~


Run the salesforce domain agent action `list_accounts`.

Source: `lightbulb/mcp_generated_tools.py:12682`.

### `salesforce_list_custom_objects`

Namespace: `salesforce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
salesforce_list_custom_objects(message: str='', inputs: str='{}') -> str
~~~


Run the salesforce domain agent action `list_custom_objects`.

Source: `lightbulb/mcp_generated_tools.py:12704`.

### `salesforce_list_flows`

Namespace: `salesforce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
salesforce_list_flows(message: str='', inputs: str='{}') -> str
~~~


Run the salesforce domain agent action `list_flows`.

Source: `lightbulb/mcp_generated_tools.py:12726`.

### `salesforce_list_opportunities`

Namespace: `salesforce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
salesforce_list_opportunities(message: str='', inputs: str='{}') -> str
~~~


Run the salesforce domain agent action `list_opportunities`.

Source: `lightbulb/mcp_generated_tools.py:12748`.

### `salesforce_log_call`

Namespace: `salesforce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
salesforce_log_call(message: str='', inputs: str='{}') -> str
~~~


Run the salesforce domain agent action `log_call`.

Source: `lightbulb/mcp_generated_tools.py:12770`.

### `salesforce_passthrough`

Namespace: `salesforce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
salesforce_passthrough(message: str='', inputs: str='{}') -> str
~~~


Run the salesforce domain agent action `passthrough`.

Source: `lightbulb/mcp_generated_tools.py:12792`.

### `salesforce_pipeline_report`

Namespace: `salesforce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
salesforce_pipeline_report(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Salesforce connector operation `pipeline_report` (platform tool `salesforce.pipeline_report`).

Source: `lightbulb/mcp_generated_tools.py:28775`.

### `salesforce_plan_domain_intelligence`

Namespace: `salesforce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
salesforce_plan_domain_intelligence(message: str='', inputs: str='{}') -> str
~~~


Run the salesforce domain agent action `plan_domain_intelligence`.

Source: `lightbulb/mcp_generated_tools.py:13012`.

### `salesforce_publish_platform_event`

Namespace: `salesforce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
salesforce_publish_platform_event(message: str='', inputs: str='{}') -> str
~~~


Run the salesforce domain agent action `publish_platform_event`.

Source: `lightbulb/mcp_generated_tools.py:12814`.

### `salesforce_run_report`

Namespace: `salesforce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
salesforce_run_report(message: str='', inputs: str='{}') -> str
~~~


Run the salesforce domain agent action `run_report`.

Source: `lightbulb/mcp_generated_tools.py:12836`.

### `salesforce_search_contacts`

Namespace: `salesforce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
salesforce_search_contacts(message: str='', inputs: str='{}') -> str
~~~


Run the salesforce domain agent action `search_contacts`.

Source: `lightbulb/mcp_generated_tools.py:12858`.

### `salesforce_soql_query`

Namespace: `salesforce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
salesforce_soql_query(message: str='', inputs: str='{}') -> str
~~~


Run the salesforce domain agent action `soql_query`.

Source: `lightbulb/mcp_generated_tools.py:12880`.

### `salesforce_start_agent_session`

Namespace: `salesforce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
salesforce_start_agent_session(message: str='', inputs: str='{}') -> str
~~~


Run the salesforce domain agent action `start_agent_session`.

Source: `lightbulb/mcp_generated_tools.py:12902`.

### `salesforce_status_report`

Namespace: `salesforce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
salesforce_status_report(message: str='', inputs: str='{}') -> str
~~~


Run the salesforce domain agent action `status_report`.

Source: `lightbulb/mcp_generated_tools.py:12924`.

### `salesforce_submit_for_approval`

Namespace: `salesforce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
salesforce_submit_for_approval(message: str='', inputs: str='{}') -> str
~~~


Run the salesforce domain agent action `submit_for_approval`.

Source: `lightbulb/mcp_generated_tools.py:12946`.

### `salesforce_update_contact`

Namespace: `salesforce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
salesforce_update_contact(message: str='', inputs: str='{}') -> str
~~~


Run the salesforce domain agent action `update_contact`.

Source: `lightbulb/mcp_generated_tools.py:12968`.

### `salesforce_update_opportunity_stage`

Namespace: `salesforce`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
salesforce_update_opportunity_stage(message: str='', inputs: str='{}') -> str
~~~


Run the salesforce domain agent action `update_opportunity_stage`.

Source: `lightbulb/mcp_generated_tools.py:12990`.

### `shopify_analytics_query`

Namespace: `shopify`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
shopify_analytics_query(target_metric: Optional[str]=None, window_start: Optional[str]=None, window_end: Optional[str]=None, currency: Optional[str]=None, *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Read one fixed, account-bound Shopify analytics observation. The host constructs server-owned ShopifyQL for the requested metric and exact UTC-day window; callers cannot submit arbitrary ShopifyQL.

Source: `lightbulb/mcp_generated_tools.py:28820`.

### `shopify_attach_product_media`

Namespace: `shopify`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
shopify_attach_product_media(product_id: Optional[str]=None, media: Optional[list[str]]=None, *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Attach media (product shots) to an existing product from public URLs or staged resource urls. Up to 50 entries per call. Shopify processes media asynchronously, so freshly attached images may report status UPLOADED before they render on the storefront.

Source: `lightbulb/mcp_generated_tools.py:28862`.

### `shopify_bulk_operation_create`

Namespace: `shopify`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
shopify_bulk_operation_create(query: Optional[str]=None, *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Submit a Shopify bulk-operation query to the asynchronous job runner. Returns a bulk operation ID; poll via shopify.bulk_operation_status.

Source: `lightbulb/mcp_generated_tools.py:28899`.

### `shopify_bulk_operation_result`

Namespace: `shopify`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
shopify_bulk_operation_result(bulk_operation_id: Optional[str]=None, *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Fetch the JSONL result file of a completed Shopify bulk operation.

Source: `lightbulb/mcp_generated_tools.py:28931`.

### `shopify_bulk_operation_status`

Namespace: `shopify`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
shopify_bulk_operation_status(bulk_operation_id: Optional[str]=None, *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Get the current status of the most recent (or a specific) Shopify bulk operation.

Source: `lightbulb/mcp_generated_tools.py:28962`.

### `shopify_create_file`

Namespace: `shopify`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
shopify_create_file(original_source: Optional[str]=None, content_type: str='IMAGE', alt: Optional[str]=None, filename: Optional[str]=None, files: Optional[list[str]]=None, *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Create shop files (images/media) from public URLs or staged resource urls, so real imagery can be referenced from theme templates and pages. Pass a single file inline, or a files list for up to 50 per call.

Source: `lightbulb/mcp_generated_tools.py:28993`.

### `shopify_create_menu`

Namespace: `shopify`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
shopify_create_menu(title: Optional[str]=None, handle: Optional[str]=None, items: Optional[list[str]]=None, *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Create a storefront navigation menu (e.g. a 'main-menu' replacement or a footer menu) with nested items. Requires the online-store-navigation scopes; a connection without them returns SHOPIFY_NAVIGATION_SCOPE_REQUIRED (offer a Shopify reconnect).

Source: `lightbulb/mcp_generated_tools.py:29038`.

### `shopify_create_price_rule`

Namespace: `shopify`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
shopify_create_price_rule(title: Optional[str]=None, value_type: Optional[str]=None, value: Optional[str]=None, starts_at: Optional[str]=None, ends_at: Optional[str]=None, usage_limit: Optional[int]=None, *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Create a Shopify price rule (the engine behind a discount code). Use to roll out a targeted promotion for a segment after tagging.

Source: `lightbulb/mcp_generated_tools.py:29078`.

### `shopify_create_theme`

Namespace: `shopify`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
shopify_create_theme(name: Optional[str]=None, source: Optional[str]=None, role: Optional[str]=None, *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Create a new UNPUBLISHED theme from a theme zip URL (defaults to Shopify's Horizon reference theme). The new theme never touches the live storefront until shopify.publish_theme is approved.

Source: `lightbulb/mcp_generated_tools.py:29125`.

### `shopify_delete_menu`

Namespace: `shopify`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
shopify_delete_menu(menu_id: Optional[str]=None, *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Permanently delete a storefront navigation menu. Destructive: any theme section bound to the menu handle loses its links. Requires the online-store-navigation scopes; a connection without them returns SHOPIFY_NAVIGATION_SCOPE_REQUIRED (offer a Shopify reconnect).

Source: `lightbulb/mcp_generated_tools.py:29164`.

### `shopify_delete_theme`

Namespace: `shopify`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
shopify_delete_theme(theme_id: Optional[str]=None, *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Permanently delete an UNPUBLISHED (draft) theme and all of its files. The live (MAIN) theme can never be deleted (SHOPIFY_THEME_ROLE_PROTECTED).

Source: `lightbulb/mcp_generated_tools.py:29198`.

### `shopify_delete_theme_files`

Namespace: `shopify`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
shopify_delete_theme_files(theme_id: Optional[str]=None, filenames: Optional[list[str]]=None, *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Delete up to 50 files from an UNPUBLISHED (draft) theme. Deletes targeting the live (MAIN) theme are refused with SHOPIFY_THEME_ROLE_PROTECTED.

Source: `lightbulb/mcp_generated_tools.py:29230`.

### `shopify_duplicate_theme`

Namespace: `shopify`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
shopify_duplicate_theme(theme_id: Optional[str]=None, name: Optional[str]=None, *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Duplicate an existing theme into a new UNPUBLISHED draft (Shopify's themeDuplicate): a server-side copy that keeps the merchant's settings and content. Edit the copy, never the original.

Source: `lightbulb/mcp_generated_tools.py:29265`.

### `shopify_get_menu`

Namespace: `shopify`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
shopify_get_menu(menu_id: Optional[str]=None, *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Fetch a single storefront navigation menu with two levels of items. Read the menu before updating it — menuUpdate replaces the whole item tree. Requires the online-store-navigation scopes; a connection without them returns SHOPIFY_NAVIGATION_SCOPE_REQUIRED.

Source: `lightbulb/mcp_generated_tools.py:29301`.

### `shopify_get_metafields`

Namespace: `shopify`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
shopify_get_metafields(owner_type: Optional[str]=None, owner_id: Optional[str]=None, namespace: Optional[str]=None, limit: int=30, *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Read metafields on a Shopify resource (product, customer, order, variant, collection, or shop).

Source: `lightbulb/mcp_generated_tools.py:29335`.

### `shopify_get_page`

Namespace: `shopify`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
shopify_get_page(page_id: Optional[str]=None, *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Fetch a single Online Store page including its body_html.

Source: `lightbulb/mcp_generated_tools.py:29375`.

### `shopify_get_shop_info`

Namespace: `shopify`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
shopify_get_shop_info(*, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Fetch the connected Shopify shop's basic info (name, domain, currency, plan, timezone).

Source: `lightbulb/mcp_generated_tools.py:29406`.

### `shopify_get_theme`

Namespace: `shopify`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
shopify_get_theme(theme_id: Optional[str]=None, *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Fetch a single Online Store theme (id, name, role, processing state). Includes preview_url (https://{shop}/?preview_theme_id=...) for non-MAIN themes.

Source: `lightbulb/mcp_generated_tools.py:29434`.

### `shopify_get_theme_files`

Namespace: `shopify`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
shopify_get_theme_files(theme_id: Optional[str]=None, filenames: Optional[list[str]]=None, *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Fetch the bodies of up to 50 theme files by exact filename. Read files before editing them so upserts preserve the base theme's structure.

Source: `lightbulb/mcp_generated_tools.py:29466`.

### `shopify_list_abandoned_checkouts`

Namespace: `shopify`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
shopify_list_abandoned_checkouts(limit: int=20, query: Optional[str]=None, cursor: Optional[str]=None, *, project_id: str, project_ref: str, connector_account_ref: str, effect: Literal['read'], approval_ref: Optional[str]=None) -> str
~~~


List the shop's recent abandoned checkouts with cart subtotals and customer context. Use to compute abandoned-revenue at risk and prioritise recovery.

Source: `lightbulb/mcp_generated_tools.py:29501`.

### `shopify_list_collections`

Namespace: `shopify`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
shopify_list_collections(limit: int=50, *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


List Shopify product collections (smart and custom).

Source: `lightbulb/mcp_generated_tools.py:29540`.

### `shopify_list_discounts`

Namespace: `shopify`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
shopify_list_discounts(limit: int=50, *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


List active and historical discount codes / automatic discounts in the shop.

Source: `lightbulb/mcp_generated_tools.py:29571`.

### `shopify_list_draft_orders`

Namespace: `shopify`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
shopify_list_draft_orders(limit: int=50, status: Optional[str]=None, *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


List draft orders from the connected Shopify store.

Source: `lightbulb/mcp_generated_tools.py:29602`.

### `shopify_list_files`

Namespace: `shopify`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
shopify_list_files(limit: int=50, query: Optional[str]=None, after: Optional[str]=None, *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


List shop files ([{id, status, url, alt, width, height, created_at}]). Use it to reuse imagery the store already owns instead of re-uploading.

Source: `lightbulb/mcp_generated_tools.py:29636`.

### `shopify_list_fulfillment_orders`

Namespace: `shopify`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
shopify_list_fulfillment_orders(order_id: Optional[str]=None, *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


List the fulfillment orders associated with a Shopify order, including locations and tracking.

Source: `lightbulb/mcp_generated_tools.py:29674`.

### `shopify_list_locations`

Namespace: `shopify`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
shopify_list_locations(limit: int=20, *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


List the Shopify shop's locations (warehouses, retail locations, fulfillment centres).

Source: `lightbulb/mcp_generated_tools.py:29705`.

### `shopify_list_menus`

Namespace: `shopify`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
shopify_list_menus(limit: int=50, after: Optional[str]=None, *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


List storefront navigation menus with their nested items ([{id, handle, title, is_default, items}]). Requires the online-store-navigation scopes; a connection without them returns SHOPIFY_NAVIGATION_SCOPE_REQUIRED (offer a Shopify reconnect).

Source: `lightbulb/mcp_generated_tools.py:29736`.

### `shopify_list_metafield_definitions`

Namespace: `shopify`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
shopify_list_metafield_definitions(owner_type: Optional[str]=None, limit: int=50, *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


List declared metafield definitions for a given owner type.

Source: `lightbulb/mcp_generated_tools.py:29773`.

### `shopify_list_pages`

Namespace: `shopify`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
shopify_list_pages(limit: int=50, query: Optional[str]=None, *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


List Online Store content pages ([{id, title, handle, published}]).

Source: `lightbulb/mcp_generated_tools.py:29807`.

### `shopify_list_refunds`

Namespace: `shopify`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
shopify_list_refunds(limit: int=50, order_id: Optional[str]=None, *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


List recent order refunds in the shop.

Source: `lightbulb/mcp_generated_tools.py:29841`.

### `shopify_list_theme_files`

Namespace: `shopify`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
shopify_list_theme_files(theme_id: Optional[str]=None, filenames: Optional[list[str]]=None, *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


List the filenames in a theme (templates/, sections/, assets/, config/, ...). Supports wildcard filename filters to scope the listing.

Source: `lightbulb/mcp_generated_tools.py:29875`.

### `shopify_list_transactions`

Namespace: `shopify`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
shopify_list_transactions(order_id: Optional[str]=None, *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


List order transactions (authorisations, captures, voids, sales) for an order.

Source: `lightbulb/mcp_generated_tools.py:29910`.

### `shopify_stage_upload`

Namespace: `shopify`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
shopify_stage_upload(filename: Optional[str]=None, mime_type: Optional[str]=None, resource: str='IMAGE', http_method: str='POST', file_size: Optional[str]=None, *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Reserve a Shopify-hosted upload target for binary you hold locally. Returns url + parameters to POST the bytes to, and a resource_url to hand to shopify.create_file / shopify.attach_product_media. Skip this entirely when the image already has a public URL.

Source: `lightbulb/mcp_generated_tools.py:29941`.

### `shopify_tag_customers_bulk`

Namespace: `shopify`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
shopify_tag_customers_bulk(customer_ids: Optional[list[str]]=None, tags: Optional[list[str]]=None, *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Apply tags to a batch of customers in a single call. Use after RFM/segment analysis to mark a cohort (e.g. 'segment:champion', 'campaign:spring-launch').

Source: `lightbulb/mcp_generated_tools.py:29987`.

### `shopify_update_menu`

Namespace: `shopify`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
shopify_update_menu(menu_id: Optional[str]=None, title: Optional[str]=None, handle: Optional[str]=None, items: Optional[list[str]]=None, *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Replace a storefront navigation menu's title, handle, and full item tree. This is a whole-menu replacement — read the menu first with shopify.get_menu and send back every item you want to keep. Requires the online-store-navigation scopes; a connection without them returns SHOPIFY_NAVIGATION_SCOPE_REQUIRED (offer a Shopify reconnect).

Source: `lightbulb/mcp_generated_tools.py:30022`.

### `shopify_update_metafield`

Namespace: `shopify`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
shopify_update_metafield(owner_type: Optional[str]=None, owner_id: Optional[str]=None, namespace: Optional[str]=None, key: Optional[str]=None, value: Optional[str]=None, type: Optional[str]=None, *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Create or update a metafield on a Shopify resource.

Source: `lightbulb/mcp_generated_tools.py:30066`.

### `shopify_update_theme`

Namespace: `shopify`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
shopify_update_theme(theme_id: Optional[str]=None, name: Optional[str]=None, *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Rename an UNPUBLISHED (draft) theme. Updates targeting the live (MAIN) theme are refused with SHOPIFY_THEME_ROLE_PROTECTED.

Source: `lightbulb/mcp_generated_tools.py:30112`.

### `shopify_upsert_theme_files`

Namespace: `shopify`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
shopify_upsert_theme_files(theme_id: Optional[str]=None, files: Optional[list[str]]=None, *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Create or update up to 50 files on an UNPUBLISHED (draft) theme in one call. Writes targeting the live (MAIN) theme are refused with SHOPIFY_THEME_ROLE_PROTECTED; the live theme only changes via the approval-gated shopify.publish_theme.

Source: `lightbulb/mcp_generated_tools.py:30147`.

### `shopify_verify_product_readiness`

Namespace: `shopify`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
shopify_verify_product_readiness(product_id: Optional[str]=None, publication_ids: Optional[list[str]]=None, expected_title: Optional[str]=None, expected_price: Optional[str]=None, expected_currency: Optional[str]=None, landing_url: Optional[str]=None, publication_completed_at: Optional[str]=None, *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Read exact Shopify Admin and storefront evidence after publication. The governed host verifies the requested product, publications, title, price, currency, public landing page, and checkout surface without returning raw storefront HTML.

Source: `lightbulb/mcp_generated_tools.py:30184`.

### `slack_access_canvas`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_access_canvas(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Slack connector operation `access_canvas` (platform tool `slack.access_canvas`).

Source: `lightbulb/mcp_generated_tools.py:30233`.

### `slack_add_reaction`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_add_reaction(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Slack connector operation `add_reaction` (platform tool `slack.add_reaction`).

Source: `lightbulb/mcp_generated_tools.py:30278`.

### `slack_app_mention`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_app_mention(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Slack connector operation `app_mention` (platform tool `slack.app_mention`).

Source: `lightbulb/mcp_generated_tools.py:30323`.

### `slack_archive_channel`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_archive_channel(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Slack connector operation `archive_channel` (platform tool `slack.archive_channel`).

Source: `lightbulb/mcp_generated_tools.py:30368`.

### `slack_assistant_set_status`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_assistant_set_status(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Slack connector operation `assistant_set_status` (platform tool `slack.assistant_set_status`).

Source: `lightbulb/mcp_generated_tools.py:30413`.

### `slack_assistant_set_suggested_prompts`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_assistant_set_suggested_prompts(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Slack connector operation `assistant_set_suggested_prompts` (platform tool `slack.assistant_set_suggested_prompts`).

Source: `lightbulb/mcp_generated_tools.py:30458`.

### `slack_assistant_set_title`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_assistant_set_title(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Slack connector operation `assistant_set_title` (platform tool `slack.assistant_set_title`).

Source: `lightbulb/mcp_generated_tools.py:30503`.

### `slack_canvas_section_lookup`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_canvas_section_lookup(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Slack connector operation `canvas_section_lookup` (platform tool `slack.canvas_section_lookup`).

Source: `lightbulb/mcp_generated_tools.py:30548`.

### `slack_create_canvas`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_create_canvas(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Slack connector operation `create_canvas` (platform tool `slack.create_canvas`).

Source: `lightbulb/mcp_generated_tools.py:30593`.

### `slack_create_channel`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_create_channel(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Slack connector operation `create_channel` (platform tool `slack.create_channel`).

Source: `lightbulb/mcp_generated_tools.py:30638`.

### `slack_create_conversation_canvas`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_create_conversation_canvas(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Slack connector operation `create_conversation_canvas` (platform tool `slack.create_conversation_canvas`).

Source: `lightbulb/mcp_generated_tools.py:30683`.

### `slack_default_channel`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_default_channel(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Slack connector operation `default_channel` (platform tool `slack.default_channel`).

Source: `lightbulb/mcp_generated_tools.py:30728`.

### `slack_delete_canvas`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_delete_canvas(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Slack connector operation `delete_canvas` (platform tool `slack.delete_canvas`).

Source: `lightbulb/mcp_generated_tools.py:30773`.

### `slack_delete_message`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_delete_message(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Slack connector operation `delete_message` (platform tool `slack.delete_message`).

Source: `lightbulb/mcp_generated_tools.py:30818`.

### `slack_delete_scheduled_message`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_delete_scheduled_message(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Slack connector operation `delete_scheduled_message` (platform tool `slack.delete_scheduled_message`).

Source: `lightbulb/mcp_generated_tools.py:30863`.

### `slack_edit_canvas`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_edit_canvas(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Slack connector operation `edit_canvas` (platform tool `slack.edit_canvas`).

Source: `lightbulb/mcp_generated_tools.py:30908`.

### `slack_files_complete_upload_external`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_files_complete_upload_external(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Slack connector operation `files_complete_upload_external` (platform tool `slack.files_complete_upload_external`).

Source: `lightbulb/mcp_generated_tools.py:30953`.

### `slack_files_delete`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_files_delete(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Slack connector operation `files_delete` (platform tool `slack.files_delete`).

Source: `lightbulb/mcp_generated_tools.py:30998`.

### `slack_files_get_upload_url_external`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_files_get_upload_url_external(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Slack connector operation `files_get_upload_url_external` (platform tool `slack.files_get_upload_url_external`).

Source: `lightbulb/mcp_generated_tools.py:31043`.

### `slack_files_info`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_files_info(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Slack connector operation `files_info` (platform tool `slack.files_info`).

Source: `lightbulb/mcp_generated_tools.py:31088`.

### `slack_get_channel_history`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_get_channel_history(channel: Optional[str]=None, limit: int=50, oldest: Optional[str]=None, *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Fetch recent messages from a Slack channel.

Source: `lightbulb/mcp_generated_tools.py:31133`.

### `slack_get_thread_replies`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_get_thread_replies(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Slack connector operation `get_thread_replies` (platform tool `slack.get_thread_replies`).

Source: `lightbulb/mcp_generated_tools.py:31170`.

### `slack_invite_to_channel`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_invite_to_channel(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Slack connector operation `invite_to_channel` (platform tool `slack.invite_to_channel`).

Source: `lightbulb/mcp_generated_tools.py:31215`.

### `slack_join_channel`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_join_channel(channel: Optional[str]=None, *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Join a public Slack channel the bot can access.

Source: `lightbulb/mcp_generated_tools.py:31260`.

### `slack_kick_from_channel`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_kick_from_channel(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Slack connector operation `kick_from_channel` (platform tool `slack.kick_from_channel`).

Source: `lightbulb/mcp_generated_tools.py:31291`.

### `slack_list_channel_members`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_list_channel_members(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Slack connector operation `list_channel_members` (platform tool `slack.list_channel_members`).

Source: `lightbulb/mcp_generated_tools.py:31336`.

### `slack_list_channels`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_list_channels(types: str='public_channel', exclude_archived: bool=True, *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


List channels the Slack workspace bot can see.

Source: `lightbulb/mcp_generated_tools.py:31381`.

### `slack_list_files`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_list_files(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Slack connector operation `list_files` (platform tool `slack.list_files`).

Source: `lightbulb/mcp_generated_tools.py:31415`.

### `slack_list_reactions`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_list_reactions(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Slack connector operation `list_reactions` (platform tool `slack.list_reactions`).

Source: `lightbulb/mcp_generated_tools.py:31460`.

### `slack_list_scheduled_messages`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_list_scheduled_messages(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Slack connector operation `list_scheduled_messages` (platform tool `slack.list_scheduled_messages`).

Source: `lightbulb/mcp_generated_tools.py:31505`.

### `slack_list_users`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_list_users(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Slack connector operation `list_users` (platform tool `slack.list_users`).

Source: `lightbulb/mcp_generated_tools.py:31550`.

### `slack_lookup_user`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_lookup_user(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Slack connector operation `lookup_user` (platform tool `slack.lookup_user`).

Source: `lightbulb/mcp_generated_tools.py:31595`.

### `slack_me_message`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_me_message(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Slack connector operation `me_message` (platform tool `slack.me_message`).

Source: `lightbulb/mcp_generated_tools.py:31640`.

### `slack_open_dm`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_open_dm(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Slack connector operation `open_dm` (platform tool `slack.open_dm`).

Source: `lightbulb/mcp_generated_tools.py:31685`.

### `slack_open_modal`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_open_modal(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Slack connector operation `open_modal` (platform tool `slack.open_modal`).

Source: `lightbulb/mcp_generated_tools.py:31730`.

### `slack_pins_add`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_pins_add(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Slack connector operation `pins_add` (platform tool `slack.pins_add`).

Source: `lightbulb/mcp_generated_tools.py:31775`.

### `slack_pins_remove`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_pins_remove(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Slack connector operation `pins_remove` (platform tool `slack.pins_remove`).

Source: `lightbulb/mcp_generated_tools.py:31820`.

### `slack_post_ephemeral`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_post_ephemeral(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Slack connector operation `post_ephemeral` (platform tool `slack.post_ephemeral`).

Source: `lightbulb/mcp_generated_tools.py:31865`.

### `slack_post_message`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_post_message(channel: Optional[str]=None, text: Optional[str]=None, thread_ts: Optional[str]=None, *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Post a message to a Slack channel or DM under the bot's identity.

Source: `lightbulb/mcp_generated_tools.py:31910`.

### `slack_remove_reaction`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_remove_reaction(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Slack connector operation `remove_reaction` (platform tool `slack.remove_reaction`).

Source: `lightbulb/mcp_generated_tools.py:31947`.

### `slack_schedule_message`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_schedule_message(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Slack connector operation `schedule_message` (platform tool `slack.schedule_message`).

Source: `lightbulb/mcp_generated_tools.py:31992`.

### `slack_sdlc_canvas_template_id`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_sdlc_canvas_template_id(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Slack connector operation `sdlc_canvas_template_id` (platform tool `slack.sdlc_canvas_template_id`).

Source: `lightbulb/mcp_generated_tools.py:32037`.

### `slack_search_messages`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_search_messages(query: Optional[str]=None, count: int=20, *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Search Slack messages across channels the bot can see.

Source: `lightbulb/mcp_generated_tools.py:32082`.

### `slack_set_channel_purpose`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_set_channel_purpose(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Slack connector operation `set_channel_purpose` (platform tool `slack.set_channel_purpose`).

Source: `lightbulb/mcp_generated_tools.py:32116`.

### `slack_set_channel_topic`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_set_channel_topic(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Slack connector operation `set_channel_topic` (platform tool `slack.set_channel_topic`).

Source: `lightbulb/mcp_generated_tools.py:32161`.

### `slack_team_info`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_team_info(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Slack connector operation `team_info` (platform tool `slack.team_info`).

Source: `lightbulb/mcp_generated_tools.py:32206`.

### `slack_unarchive_channel`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_unarchive_channel(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Slack connector operation `unarchive_channel` (platform tool `slack.unarchive_channel`).

Source: `lightbulb/mcp_generated_tools.py:32251`.

### `slack_unfurl_link`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_unfurl_link(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Slack connector operation `unfurl_link` (platform tool `slack.unfurl_link`).

Source: `lightbulb/mcp_generated_tools.py:32296`.

### `slack_update_message`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_update_message(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Slack connector operation `update_message` (platform tool `slack.update_message`).

Source: `lightbulb/mcp_generated_tools.py:32341`.

### `slack_usergroups_list`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_usergroups_list(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Slack connector operation `usergroups_list` (platform tool `slack.usergroups_list`).

Source: `lightbulb/mcp_generated_tools.py:32386`.

### `slack_usergroups_users_list`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_usergroups_users_list(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Slack connector operation `usergroups_users_list` (platform tool `slack.usergroups_users_list`).

Source: `lightbulb/mcp_generated_tools.py:32431`.

### `slack_users_info`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_users_info(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Slack connector operation `users_info` (platform tool `slack.users_info`).

Source: `lightbulb/mcp_generated_tools.py:32476`.

### `slack_users_set_presence`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_users_set_presence(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Slack connector operation `users_set_presence` (platform tool `slack.users_set_presence`).

Source: `lightbulb/mcp_generated_tools.py:32521`.

### `slack_views_open`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_views_open(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Slack connector operation `views_open` (platform tool `slack.views_open`).

Source: `lightbulb/mcp_generated_tools.py:32566`.

### `slack_views_publish`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_views_publish(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Slack connector operation `views_publish` (platform tool `slack.views_publish`).

Source: `lightbulb/mcp_generated_tools.py:32611`.

### `slack_views_push`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_views_push(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Slack connector operation `views_push` (platform tool `slack.views_push`).

Source: `lightbulb/mcp_generated_tools.py:32656`.

### `slack_views_update`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_views_update(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Slack connector operation `views_update` (platform tool `slack.views_update`).

Source: `lightbulb/mcp_generated_tools.py:32701`.

### `slack_workflows_step_completed`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_workflows_step_completed(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Slack connector operation `workflows_step_completed` (platform tool `slack.workflows_step_completed`).

Source: `lightbulb/mcp_generated_tools.py:32746`.

### `slack_workflows_step_failed`

Namespace: `slack`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
slack_workflows_step_failed(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Slack connector operation `workflows_step_failed` (platform tool `slack.workflows_step_failed`).

Source: `lightbulb/mcp_generated_tools.py:32791`.

### `smarthome_automation_review`

Namespace: `smarthome`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
smarthome_automation_review(message: str='', inputs: str='{}') -> str
~~~


Run the smarthome domain agent action `automation_review`.

Source: `lightbulb/mcp_generated_tools.py:13122`.

### `smarthome_chat`

Namespace: `smarthome`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
smarthome_chat(message: str='', inputs: str='{}') -> str
~~~


Run the smarthome domain agent action `chat`.

Source: `lightbulb/mcp_generated_tools.py:13034`.

### `smarthome_command_plan`

Namespace: `smarthome`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
smarthome_command_plan(message: str='', inputs: str='{}') -> str
~~~


Run the smarthome domain agent action `command_plan`.

Source: `lightbulb/mcp_generated_tools.py:13078`.

### `smarthome_event_review`

Namespace: `smarthome`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
smarthome_event_review(message: str='', inputs: str='{}') -> str
~~~


Run the smarthome domain agent action `event_review`.

Source: `lightbulb/mcp_generated_tools.py:13100`.

### `smarthome_plan_domain_intelligence`

Namespace: `smarthome`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
smarthome_plan_domain_intelligence(message: str='', inputs: str='{}') -> str
~~~


Run the smarthome domain agent action `plan_domain_intelligence`.

Source: `lightbulb/mcp_generated_tools.py:13166`.

### `smarthome_scene_assist`

Namespace: `smarthome`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
smarthome_scene_assist(message: str='', inputs: str='{}') -> str
~~~


Run the smarthome domain agent action `scene_assist`.

Source: `lightbulb/mcp_generated_tools.py:13144`.

### `smarthome_status_report`

Namespace: `smarthome`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
smarthome_status_report(message: str='', inputs: str='{}') -> str
~~~


Run the smarthome domain agent action `status_report`.

Source: `lightbulb/mcp_generated_tools.py:13056`.

### `smokeball_add_layout_contact`

Namespace: `smokeball`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
smokeball_add_layout_contact(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Smokeball connector operation `add_layout_contact` (platform tool `smokeball.add_layout_contact`).

Source: `lightbulb/mcp_generated_tools.py:32836`.

### `smokeball_api_request`

Namespace: `smokeball`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
smokeball_api_request(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Smokeball connector operation `api_request` (platform tool `smokeball.api_request`).

Source: `lightbulb/mcp_generated_tools.py:32881`.

### `smokeball_create_bill`

Namespace: `smokeball`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
smokeball_create_bill(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Smokeball connector operation `create_bill` (platform tool `smokeball.create_bill`).

Source: `lightbulb/mcp_generated_tools.py:32926`.

### `smokeball_create_contact`

Namespace: `smokeball`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
smokeball_create_contact(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Smokeball connector operation `create_contact` (platform tool `smokeball.create_contact`).

Source: `lightbulb/mcp_generated_tools.py:32971`.

### `smokeball_create_file_upload`

Namespace: `smokeball`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
smokeball_create_file_upload(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Smokeball connector operation `create_file_upload` (platform tool `smokeball.create_file_upload`).

Source: `lightbulb/mcp_generated_tools.py:33016`.

### `smokeball_create_folder`

Namespace: `smokeball`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
smokeball_create_folder(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Smokeball connector operation `create_folder` (platform tool `smokeball.create_folder`).

Source: `lightbulb/mcp_generated_tools.py:33061`.

### `smokeball_create_layout`

Namespace: `smokeball`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
smokeball_create_layout(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Smokeball connector operation `create_layout` (platform tool `smokeball.create_layout`).

Source: `lightbulb/mcp_generated_tools.py:33106`.

### `smokeball_create_lead`

Namespace: `smokeball`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
smokeball_create_lead(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Smokeball connector operation `create_lead` (platform tool `smokeball.create_lead`).

Source: `lightbulb/mcp_generated_tools.py:33151`.

### `smokeball_create_matter`

Namespace: `smokeball`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
smokeball_create_matter(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Smokeball connector operation `create_matter` (platform tool `smokeball.create_matter`).

Source: `lightbulb/mcp_generated_tools.py:33196`.

### `smokeball_create_task`

Namespace: `smokeball`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
smokeball_create_task(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Smokeball connector operation `create_task` (platform tool `smokeball.create_task`).

Source: `lightbulb/mcp_generated_tools.py:33241`.

### `smokeball_create_time_entry`

Namespace: `smokeball`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
smokeball_create_time_entry(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Smokeball connector operation `create_time_entry` (platform tool `smokeball.create_time_entry`).

Source: `lightbulb/mcp_generated_tools.py:33286`.

### `smokeball_delete_layout`

Namespace: `smokeball`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
smokeball_delete_layout(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Smokeball connector operation `delete_layout` (platform tool `smokeball.delete_layout`).

Source: `lightbulb/mcp_generated_tools.py:33331`.

### `smokeball_get_contact`

Namespace: `smokeball`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
smokeball_get_contact(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Smokeball connector operation `get_contact` (platform tool `smokeball.get_contact`).

Source: `lightbulb/mcp_generated_tools.py:33376`.

### `smokeball_get_file`

Namespace: `smokeball`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
smokeball_get_file(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Smokeball connector operation `get_file` (platform tool `smokeball.get_file`).

Source: `lightbulb/mcp_generated_tools.py:33421`.

### `smokeball_get_file_download_url`

Namespace: `smokeball`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
smokeball_get_file_download_url(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Smokeball connector operation `get_file_download_url` (platform tool `smokeball.get_file_download_url`).

Source: `lightbulb/mcp_generated_tools.py:33466`.

### `smokeball_get_file_upload_url`

Namespace: `smokeball`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
smokeball_get_file_upload_url(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Smokeball connector operation `get_file_upload_url` (platform tool `smokeball.get_file_upload_url`).

Source: `lightbulb/mcp_generated_tools.py:33511`.

### `smokeball_get_layout`

Namespace: `smokeball`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
smokeball_get_layout(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Smokeball connector operation `get_layout` (platform tool `smokeball.get_layout`).

Source: `lightbulb/mcp_generated_tools.py:33556`.

### `smokeball_get_layout_contacts`

Namespace: `smokeball`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
smokeball_get_layout_contacts(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Smokeball connector operation `get_layout_contacts` (platform tool `smokeball.get_layout_contacts`).

Source: `lightbulb/mcp_generated_tools.py:33601`.

### `smokeball_get_layout_design`

Namespace: `smokeball`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
smokeball_get_layout_design(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Smokeball connector operation `get_layout_design` (platform tool `smokeball.get_layout_design`).

Source: `lightbulb/mcp_generated_tools.py:33646`.

### `smokeball_get_matter`

Namespace: `smokeball`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
smokeball_get_matter(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Smokeball connector operation `get_matter` (platform tool `smokeball.get_matter`).

Source: `lightbulb/mcp_generated_tools.py:33691`.

### `smokeball_get_matter_items`

Namespace: `smokeball`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
smokeball_get_matter_items(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Smokeball connector operation `get_matter_items` (platform tool `smokeball.get_matter_items`).

Source: `lightbulb/mcp_generated_tools.py:33736`.

### `smokeball_get_matter_type`

Namespace: `smokeball`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
smokeball_get_matter_type(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Smokeball connector operation `get_matter_type` (platform tool `smokeball.get_matter_type`).

Source: `lightbulb/mcp_generated_tools.py:33781`.

### `smokeball_integrated_search`

Namespace: `smokeball`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
smokeball_integrated_search(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Smokeball connector operation `integrated_search` (platform tool `smokeball.integrated_search`).

Source: `lightbulb/mcp_generated_tools.py:33826`.

### `smokeball_list_activities`

Namespace: `smokeball`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
smokeball_list_activities(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Smokeball connector operation `list_activities` (platform tool `smokeball.list_activities`).

Source: `lightbulb/mcp_generated_tools.py:33871`.

### `smokeball_list_bills`

Namespace: `smokeball`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
smokeball_list_bills(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Smokeball connector operation `list_bills` (platform tool `smokeball.list_bills`).

Source: `lightbulb/mcp_generated_tools.py:33916`.

### `smokeball_list_contacts`

Namespace: `smokeball`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
smokeball_list_contacts(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Smokeball connector operation `list_contacts` (platform tool `smokeball.list_contacts`).

Source: `lightbulb/mcp_generated_tools.py:33961`.

### `smokeball_list_files`

Namespace: `smokeball`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
smokeball_list_files(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Smokeball connector operation `list_files` (platform tool `smokeball.list_files`).

Source: `lightbulb/mcp_generated_tools.py:34006`.

### `smokeball_list_folders`

Namespace: `smokeball`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
smokeball_list_folders(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Smokeball connector operation `list_folders` (platform tool `smokeball.list_folders`).

Source: `lightbulb/mcp_generated_tools.py:34051`.

### `smokeball_list_layouts`

Namespace: `smokeball`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
smokeball_list_layouts(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Smokeball connector operation `list_layouts` (platform tool `smokeball.list_layouts`).

Source: `lightbulb/mcp_generated_tools.py:34096`.

### `smokeball_list_leads`

Namespace: `smokeball`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
smokeball_list_leads(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Smokeball connector operation `list_leads` (platform tool `smokeball.list_leads`).

Source: `lightbulb/mcp_generated_tools.py:34141`.

### `smokeball_list_matter_types`

Namespace: `smokeball`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
smokeball_list_matter_types(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Smokeball connector operation `list_matter_types` (platform tool `smokeball.list_matter_types`).

Source: `lightbulb/mcp_generated_tools.py:34186`.

### `smokeball_list_matters`

Namespace: `smokeball`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
smokeball_list_matters(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Smokeball connector operation `list_matters` (platform tool `smokeball.list_matters`).

Source: `lightbulb/mcp_generated_tools.py:34231`.

### `smokeball_list_staff`

Namespace: `smokeball`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
smokeball_list_staff(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Smokeball connector operation `list_staff` (platform tool `smokeball.list_staff`).

Source: `lightbulb/mcp_generated_tools.py:34276`.

### `smokeball_list_tasks`

Namespace: `smokeball`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
smokeball_list_tasks(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Smokeball connector operation `list_tasks` (platform tool `smokeball.list_tasks`).

Source: `lightbulb/mcp_generated_tools.py:34321`.

### `smokeball_list_time_entries`

Namespace: `smokeball`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
smokeball_list_time_entries(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Smokeball connector operation `list_time_entries` (platform tool `smokeball.list_time_entries`).

Source: `lightbulb/mcp_generated_tools.py:34366`.

### `smokeball_request`

Namespace: `smokeball`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
smokeball_request(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Smokeball connector operation `request` (platform tool `smokeball.request`).

Source: `lightbulb/mcp_generated_tools.py:34411`.

### `smokeball_search`

Namespace: `smokeball`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
smokeball_search(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Smokeball connector operation `search` (platform tool `smokeball.search`).

Source: `lightbulb/mcp_generated_tools.py:34456`.

### `smokeball_update_layout`

Namespace: `smokeball`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
smokeball_update_layout(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Smokeball connector operation `update_layout` (platform tool `smokeball.update_layout`).

Source: `lightbulb/mcp_generated_tools.py:34501`.

### `smokeball_update_matter`

Namespace: `smokeball`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
smokeball_update_matter(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Smokeball connector operation `update_matter` (platform tool `smokeball.update_matter`).

Source: `lightbulb/mcp_generated_tools.py:34546`.

### `solver_assign_resources`

Namespace: `solver`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
solver_assign_resources(message: str='', inputs: str='{}') -> str
~~~


Run the solver domain agent action `assign_resources`.

Source: `lightbulb/mcp_generated_tools.py:13254`.

### `solver_chat`

Namespace: `solver`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
solver_chat(message: str='', inputs: str='{}') -> str
~~~


Run the solver domain agent action `chat`.

Source: `lightbulb/mcp_generated_tools.py:13188`.

### `solver_constraint_satisfaction`

Namespace: `solver`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
solver_constraint_satisfaction(message: str='', inputs: str='{}') -> str
~~~


Run the solver domain agent action `constraint_satisfaction`.

Source: `lightbulb/mcp_generated_tools.py:13276`.

### `solver_plan_domain_intelligence`

Namespace: `solver`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
solver_plan_domain_intelligence(message: str='', inputs: str='{}') -> str
~~~


Run the solver domain agent action `plan_domain_intelligence`.

Source: `lightbulb/mcp_generated_tools.py:13298`.

### `solver_schedule_optimization`

Namespace: `solver`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
solver_schedule_optimization(message: str='', inputs: str='{}') -> str
~~~


Run the solver domain agent action `schedule_optimization`.

Source: `lightbulb/mcp_generated_tools.py:13232`.

### `solver_solve_optimization`

Namespace: `solver`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
solver_solve_optimization(message: str='', inputs: str='{}') -> str
~~~


Run the solver domain agent action `solve_optimization`.

Source: `lightbulb/mcp_generated_tools.py:13210`.

### `square_create_invoice`

Namespace: `square`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
square_create_invoice(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Square connector operation `create_invoice` (platform tool `square.create_invoice`).

Source: `lightbulb/mcp_generated_tools.py:34591`.

### `square_create_refund`

Namespace: `square`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
square_create_refund(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Square connector operation `create_refund` (platform tool `square.create_refund`).

Source: `lightbulb/mcp_generated_tools.py:34636`.

### `square_get_catalog_item`

Namespace: `square`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
square_get_catalog_item(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Square connector operation `get_catalog_item` (platform tool `square.get_catalog_item`).

Source: `lightbulb/mcp_generated_tools.py:34681`.

### `square_get_inventory`

Namespace: `square`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
square_get_inventory(catalog_object_ids: Optional[list[str]]=None, location_ids: Optional[list[str]]=None, *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Fetch Square inventory counts for one or more catalog items.

Source: `lightbulb/mcp_generated_tools.py:34726`.

### `square_get_order`

Namespace: `square`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
square_get_order(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Square connector operation `get_order` (platform tool `square.get_order`).

Source: `lightbulb/mcp_generated_tools.py:34760`.

### `square_get_payment`

Namespace: `square`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
square_get_payment(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Square connector operation `get_payment` (platform tool `square.get_payment`).

Source: `lightbulb/mcp_generated_tools.py:34805`.

### `square_list_appointments`

Namespace: `square`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
square_list_appointments(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Square connector operation `list_appointments` (platform tool `square.list_appointments`).

Source: `lightbulb/mcp_generated_tools.py:34850`.

### `square_list_customers`

Namespace: `square`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
square_list_customers(limit: int=100, cursor: Optional[str]=None, *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


List customers in the connected Square account.

Source: `lightbulb/mcp_generated_tools.py:34895`.

### `square_list_locations`

Namespace: `square`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
square_list_locations(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Square connector operation `list_locations` (platform tool `square.list_locations`).

Source: `lightbulb/mcp_generated_tools.py:34929`.

### `square_list_payments`

Namespace: `square`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
square_list_payments(from_date: Optional[str]=None, to_date: Optional[str]=None, location_id: Optional[str]=None, *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


List Square payments for the connected merchant account.

Source: `lightbulb/mcp_generated_tools.py:34974`.

### `square_list_payouts`

Namespace: `square`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
square_list_payouts(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Square connector operation `list_payouts` (platform tool `square.list_payouts`).

Source: `lightbulb/mcp_generated_tools.py:35011`.

### `square_list_refunds`

Namespace: `square`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
square_list_refunds(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Square connector operation `list_refunds` (platform tool `square.list_refunds`).

Source: `lightbulb/mcp_generated_tools.py:35056`.

### `square_search_catalog`

Namespace: `square`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
square_search_catalog(object_types: Optional[list[str]]=None, query: Optional[str]=None, limit: int=100, *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Search the Square catalog (items, variations, categories).

Source: `lightbulb/mcp_generated_tools.py:35101`.

### `square_search_orders`

Namespace: `square`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
square_search_orders(location_id: Optional[str]=None, state: Optional[str]=None, start_date: Optional[str]=None, end_date: Optional[str]=None, limit: int=50, *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Search Square orders by location, status, or date range.

Source: `lightbulb/mcp_generated_tools.py:35138`.

### `stripe_create_invoice`

Namespace: `stripe`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
stripe_create_invoice(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Stripe connector operation `create_invoice` (platform tool `stripe.create_invoice`).

Source: `lightbulb/mcp_generated_tools.py:35181`.

### `stripe_create_refund`

Namespace: `stripe`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
stripe_create_refund(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Stripe connector operation `create_refund` (platform tool `stripe.create_refund`).

Source: `lightbulb/mcp_generated_tools.py:35226`.

### `stripe_get_invoice`

Namespace: `stripe`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
stripe_get_invoice(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Stripe connector operation `get_invoice` (platform tool `stripe.get_invoice`).

Source: `lightbulb/mcp_generated_tools.py:35271`.

### `stripe_list_balance_transactions`

Namespace: `stripe`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
stripe_list_balance_transactions(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Stripe connector operation `list_balance_transactions` (platform tool `stripe.list_balance_transactions`).

Source: `lightbulb/mcp_generated_tools.py:35316`.

### `stripe_list_charges`

Namespace: `stripe`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
stripe_list_charges(customer_id: Optional[str]=None, from_date: Optional[str]=None, limit: int=100, *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


List recent Stripe charges.

Source: `lightbulb/mcp_generated_tools.py:35361`.

### `stripe_list_customers`

Namespace: `stripe`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
stripe_list_customers(email: Optional[str]=None, limit: int=100, *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


List Stripe customers.

Source: `lightbulb/mcp_generated_tools.py:35398`.

### `stripe_list_invoices`

Namespace: `stripe`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
stripe_list_invoices(customer_id: Optional[str]=None, status: Optional[str]=None, limit: int=100, *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


List Stripe invoices, optionally scoped to a customer.

Source: `lightbulb/mcp_generated_tools.py:35432`.

### `stripe_list_payouts`

Namespace: `stripe`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
stripe_list_payouts(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Stripe connector operation `list_payouts` (platform tool `stripe.list_payouts`).

Source: `lightbulb/mcp_generated_tools.py:35469`.

### `teams_post_channel_message`

Namespace: `teams`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
teams_post_channel_message(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Teams connector operation `post_channel_message` (platform tool `teams.post_channel_message`).

Source: `lightbulb/mcp_generated_tools.py:35514`.

### `teams_post_chat_message`

Namespace: `teams`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
teams_post_chat_message(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Teams connector operation `post_chat_message` (platform tool `teams.post_chat_message`).

Source: `lightbulb/mcp_generated_tools.py:35559`.

### `wealth_advisory_chat`

Namespace: `wealth_advisory`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
wealth_advisory_chat(message: str='', inputs: str='{}') -> str
~~~


Run the wealth_advisory domain agent action `chat`.

Source: `lightbulb/mcp_generated_tools.py:13320`.

### `wealth_advisory_plan_domain_intelligence`

Namespace: `wealth_advisory`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
wealth_advisory_plan_domain_intelligence(message: str='', inputs: str='{}') -> str
~~~


Run the wealth_advisory domain agent action `plan_domain_intelligence`.

Source: `lightbulb/mcp_generated_tools.py:13452`.

### `wealth_advisory_wealth_kyc_risk_intake`

Namespace: `wealth_advisory`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
wealth_advisory_wealth_kyc_risk_intake(message: str='', inputs: str='{}') -> str
~~~


Run the wealth_advisory domain agent action `wealth_kyc_risk_intake`.

Source: `lightbulb/mcp_generated_tools.py:13342`.

### `wealth_advisory_wealth_monte_carlo_retirement`

Namespace: `wealth_advisory`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
wealth_advisory_wealth_monte_carlo_retirement(message: str='', inputs: str='{}') -> str
~~~


Run the wealth_advisory domain agent action `wealth_monte_carlo_retirement`.

Source: `lightbulb/mcp_generated_tools.py:13430`.

### `wealth_advisory_wealth_portfolio_drift`

Namespace: `wealth_advisory`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
wealth_advisory_wealth_portfolio_drift(message: str='', inputs: str='{}') -> str
~~~


Run the wealth_advisory domain agent action `wealth_portfolio_drift`.

Source: `lightbulb/mcp_generated_tools.py:13364`.

### `wealth_advisory_wealth_retirement_withdrawal`

Namespace: `wealth_advisory`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
wealth_advisory_wealth_retirement_withdrawal(message: str='', inputs: str='{}') -> str
~~~


Run the wealth_advisory domain agent action `wealth_retirement_withdrawal`.

Source: `lightbulb/mcp_generated_tools.py:13408`.

### `wealth_advisory_wealth_tax_loss_harvest`

Namespace: `wealth_advisory`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
wealth_advisory_wealth_tax_loss_harvest(message: str='', inputs: str='{}') -> str
~~~


Run the wealth_advisory domain agent action `wealth_tax_loss_harvest`.

Source: `lightbulb/mcp_generated_tools.py:13386`.

### `xero_aged_payable_report`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_aged_payable_report(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `aged_payable_report` (platform tool `xero.aged_payable_report`).

Source: `lightbulb/mcp_generated_tools.py:35604`.

### `xero_aged_receivable_report`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_aged_receivable_report(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `aged_receivable_report` (platform tool `xero.aged_receivable_report`).

Source: `lightbulb/mcp_generated_tools.py:35649`.

### `xero_api_request`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_api_request(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `api_request` (platform tool `xero.api_request`).

Source: `lightbulb/mcp_generated_tools.py:35694`.

### `xero_approve_payroll_au_timesheet`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_approve_payroll_au_timesheet(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `approve_payroll_au_timesheet` (platform tool `xero.approve_payroll_au_timesheet`).

Source: `lightbulb/mcp_generated_tools.py:35739`.

### `xero_balance_sheet_report`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_balance_sheet_report(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `balance_sheet_report` (platform tool `xero.balance_sheet_report`).

Source: `lightbulb/mcp_generated_tools.py:35784`.

### `xero_bank_summary_report`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_bank_summary_report(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `bank_summary_report` (platform tool `xero.bank_summary_report`).

Source: `lightbulb/mcp_generated_tools.py:35829`.

### `xero_bas_report`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_bas_report(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `bas_report` (platform tool `xero.bas_report`).

Source: `lightbulb/mcp_generated_tools.py:35874`.

### `xero_book_depreciation`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_book_depreciation(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `book_depreciation` (platform tool `xero.book_depreciation`).

Source: `lightbulb/mcp_generated_tools.py:35919`.

### `xero_budget_summary_report`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_budget_summary_report(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `budget_summary_report` (platform tool `xero.budget_summary_report`).

Source: `lightbulb/mcp_generated_tools.py:35964`.

### `xero_cash_flow_report`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_cash_flow_report(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `cash_flow_report` (platform tool `xero.cash_flow_report`).

Source: `lightbulb/mcp_generated_tools.py:36009`.

### `xero_create_asset`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_create_asset(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `create_asset` (platform tool `xero.create_asset`).

Source: `lightbulb/mcp_generated_tools.py:36054`.

### `xero_create_association`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_create_association(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `create_association` (platform tool `xero.create_association`).

Source: `lightbulb/mcp_generated_tools.py:36099`.

### `xero_create_bank_transaction`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_create_bank_transaction(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `create_bank_transaction` (platform tool `xero.create_bank_transaction`).

Source: `lightbulb/mcp_generated_tools.py:36144`.

### `xero_create_bill`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_create_bill(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `create_bill` (platform tool `xero.create_bill`).

Source: `lightbulb/mcp_generated_tools.py:36189`.

### `xero_create_contact`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_create_contact(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `create_contact` (platform tool `xero.create_contact`).

Source: `lightbulb/mcp_generated_tools.py:36234`.

### `xero_create_credit_note`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_create_credit_note(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `create_credit_note` (platform tool `xero.create_credit_note`).

Source: `lightbulb/mcp_generated_tools.py:36279`.

### `xero_create_expense_claim`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_create_expense_claim(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `create_expense_claim` (platform tool `xero.create_expense_claim`).

Source: `lightbulb/mcp_generated_tools.py:36324`.

### `xero_create_feed_connection`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_create_feed_connection(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `create_feed_connection` (platform tool `xero.create_feed_connection`).

Source: `lightbulb/mcp_generated_tools.py:36369`.

### `xero_create_folder`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_create_folder(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `create_folder` (platform tool `xero.create_folder`).

Source: `lightbulb/mcp_generated_tools.py:36414`.

### `xero_create_history_note`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_create_history_note(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `create_history_note` (platform tool `xero.create_history_note`).

Source: `lightbulb/mcp_generated_tools.py:36459`.

### `xero_create_invoice`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_create_invoice(contact_id: Optional[str]=None, line_items: Optional[list[str]]=None, due_date: Optional[str]=None, reference: Optional[str]=None, *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Create a draft invoice in Xero. Use the contact ID from xero.list_contacts; line items reference Xero account codes.

Source: `lightbulb/mcp_generated_tools.py:36504`.

### `xero_create_item`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_create_item(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `create_item` (platform tool `xero.create_item`).

Source: `lightbulb/mcp_generated_tools.py:36544`.

### `xero_create_manual_journal`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_create_manual_journal(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `create_manual_journal` (platform tool `xero.create_manual_journal`).

Source: `lightbulb/mcp_generated_tools.py:36589`.

### `xero_create_payment`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_create_payment(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `create_payment` (platform tool `xero.create_payment`).

Source: `lightbulb/mcp_generated_tools.py:36634`.

### `xero_create_payroll_au_timesheet`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_create_payroll_au_timesheet(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `create_payroll_au_timesheet` (platform tool `xero.create_payroll_au_timesheet`).

Source: `lightbulb/mcp_generated_tools.py:36679`.

### `xero_create_project`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_create_project(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `create_project` (platform tool `xero.create_project`).

Source: `lightbulb/mcp_generated_tools.py:36724`.

### `xero_create_purchase_order`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_create_purchase_order(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `create_purchase_order` (platform tool `xero.create_purchase_order`).

Source: `lightbulb/mcp_generated_tools.py:36769`.

### `xero_create_quote`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_create_quote(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `create_quote` (platform tool `xero.create_quote`).

Source: `lightbulb/mcp_generated_tools.py:36814`.

### `xero_create_receipt`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_create_receipt(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `create_receipt` (platform tool `xero.create_receipt`).

Source: `lightbulb/mcp_generated_tools.py:36859`.

### `xero_create_repeating_invoice`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_create_repeating_invoice(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `create_repeating_invoice` (platform tool `xero.create_repeating_invoice`).

Source: `lightbulb/mcp_generated_tools.py:36904`.

### `xero_create_statement`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_create_statement(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `create_statement` (platform tool `xero.create_statement`).

Source: `lightbulb/mcp_generated_tools.py:36949`.

### `xero_create_task`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_create_task(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `create_task` (platform tool `xero.create_task`).

Source: `lightbulb/mcp_generated_tools.py:36994`.

### `xero_create_time_entry`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_create_time_entry(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `create_time_entry` (platform tool `xero.create_time_entry`).

Source: `lightbulb/mcp_generated_tools.py:37039`.

### `xero_create_tracking_category`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_create_tracking_category(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `create_tracking_category` (platform tool `xero.create_tracking_category`).

Source: `lightbulb/mcp_generated_tools.py:37084`.

### `xero_create_tracking_option`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_create_tracking_option(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `create_tracking_option` (platform tool `xero.create_tracking_option`).

Source: `lightbulb/mcp_generated_tools.py:37129`.

### `xero_delete_feed_connection`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_delete_feed_connection(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `delete_feed_connection` (platform tool `xero.delete_feed_connection`).

Source: `lightbulb/mcp_generated_tools.py:37174`.

### `xero_dispose_asset`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_dispose_asset(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `dispose_asset` (platform tool `xero.dispose_asset`).

Source: `lightbulb/mcp_generated_tools.py:37219`.

### `xero_executive_summary_report`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_executive_summary_report(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `executive_summary_report` (platform tool `xero.executive_summary_report`).

Source: `lightbulb/mcp_generated_tools.py:37264`.

### `xero_get_asset`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_get_asset(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `get_asset` (platform tool `xero.get_asset`).

Source: `lightbulb/mcp_generated_tools.py:37309`.

### `xero_get_attachment`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_get_attachment(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `get_attachment` (platform tool `xero.get_attachment`).

Source: `lightbulb/mcp_generated_tools.py:37354`.

### `xero_get_budget`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_get_budget(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `get_budget` (platform tool `xero.get_budget`).

Source: `lightbulb/mcp_generated_tools.py:37399`.

### `xero_get_file`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_get_file(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `get_file` (platform tool `xero.get_file`).

Source: `lightbulb/mcp_generated_tools.py:37444`.

### `xero_get_invoice`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_get_invoice(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `get_invoice` (platform tool `xero.get_invoice`).

Source: `lightbulb/mcp_generated_tools.py:37489`.

### `xero_get_organisation`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_get_organisation(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `get_organisation` (platform tool `xero.get_organisation`).

Source: `lightbulb/mcp_generated_tools.py:37534`.

### `xero_get_payroll_au_timesheet`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_get_payroll_au_timesheet(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `get_payroll_au_timesheet` (platform tool `xero.get_payroll_au_timesheet`).

Source: `lightbulb/mcp_generated_tools.py:37579`.

### `xero_get_project`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_get_project(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `get_project` (platform tool `xero.get_project`).

Source: `lightbulb/mcp_generated_tools.py:37624`.

### `xero_get_purchase_order`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_get_purchase_order(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `get_purchase_order` (platform tool `xero.get_purchase_order`).

Source: `lightbulb/mcp_generated_tools.py:37669`.

### `xero_gst_report`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_gst_report(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `gst_report` (platform tool `xero.gst_report`).

Source: `lightbulb/mcp_generated_tools.py:37714`.

### `xero_list_accounts`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_list_accounts(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `list_accounts` (platform tool `xero.list_accounts`).

Source: `lightbulb/mcp_generated_tools.py:37759`.

### `xero_list_asset_types`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_list_asset_types(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `list_asset_types` (platform tool `xero.list_asset_types`).

Source: `lightbulb/mcp_generated_tools.py:37804`.

### `xero_list_assets`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_list_assets(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `list_assets` (platform tool `xero.list_assets`).

Source: `lightbulb/mcp_generated_tools.py:37849`.

### `xero_list_associations`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_list_associations(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `list_associations` (platform tool `xero.list_associations`).

Source: `lightbulb/mcp_generated_tools.py:37894`.

### `xero_list_attachments`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_list_attachments(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `list_attachments` (platform tool `xero.list_attachments`).

Source: `lightbulb/mcp_generated_tools.py:37939`.

### `xero_list_bank_transactions`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_list_bank_transactions(bank_account_id: Optional[str]=None, from_date: Optional[str]=None, to_date: Optional[str]=None, *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


List bank-feed transactions on a Xero bank account.

Source: `lightbulb/mcp_generated_tools.py:37984`.

### `xero_list_branding_themes`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_list_branding_themes(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `list_branding_themes` (platform tool `xero.list_branding_themes`).

Source: `lightbulb/mcp_generated_tools.py:38021`.

### `xero_list_budgets`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_list_budgets(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `list_budgets` (platform tool `xero.list_budgets`).

Source: `lightbulb/mcp_generated_tools.py:38066`.

### `xero_list_contact_groups`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_list_contact_groups(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `list_contact_groups` (platform tool `xero.list_contact_groups`).

Source: `lightbulb/mcp_generated_tools.py:38111`.

### `xero_list_contacts`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_list_contacts(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `list_contacts` (platform tool `xero.list_contacts`).

Source: `lightbulb/mcp_generated_tools.py:38156`.

### `xero_list_credit_notes`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_list_credit_notes(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `list_credit_notes` (platform tool `xero.list_credit_notes`).

Source: `lightbulb/mcp_generated_tools.py:38201`.

### `xero_list_currencies`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_list_currencies(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `list_currencies` (platform tool `xero.list_currencies`).

Source: `lightbulb/mcp_generated_tools.py:38246`.

### `xero_list_employees_accounting`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_list_employees_accounting(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `list_employees_accounting` (platform tool `xero.list_employees_accounting`).

Source: `lightbulb/mcp_generated_tools.py:38291`.

### `xero_list_expense_claims`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_list_expense_claims(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `list_expense_claims` (platform tool `xero.list_expense_claims`).

Source: `lightbulb/mcp_generated_tools.py:38336`.

### `xero_list_feed_connections`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_list_feed_connections(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `list_feed_connections` (platform tool `xero.list_feed_connections`).

Source: `lightbulb/mcp_generated_tools.py:38381`.

### `xero_list_files`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_list_files(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `list_files` (platform tool `xero.list_files`).

Source: `lightbulb/mcp_generated_tools.py:38426`.

### `xero_list_folders`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_list_folders(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `list_folders` (platform tool `xero.list_folders`).

Source: `lightbulb/mcp_generated_tools.py:38471`.

### `xero_list_history`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_list_history(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `list_history` (platform tool `xero.list_history`).

Source: `lightbulb/mcp_generated_tools.py:38516`.

### `xero_list_invoices`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_list_invoices(status: Optional[str]=None, contact_id: Optional[str]=None, from_date: Optional[str]=None, to_date: Optional[str]=None, *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


List invoices in the connected Xero organisation. Supports filtering by status, contact, and date range.

Source: `lightbulb/mcp_generated_tools.py:38561`.

### `xero_list_items`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_list_items(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `list_items` (platform tool `xero.list_items`).

Source: `lightbulb/mcp_generated_tools.py:38601`.

### `xero_list_linked_transactions`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_list_linked_transactions(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `list_linked_transactions` (platform tool `xero.list_linked_transactions`).

Source: `lightbulb/mcp_generated_tools.py:38646`.

### `xero_list_manual_journals`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_list_manual_journals(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `list_manual_journals` (platform tool `xero.list_manual_journals`).

Source: `lightbulb/mcp_generated_tools.py:38691`.

### `xero_list_overpayments`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_list_overpayments(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `list_overpayments` (platform tool `xero.list_overpayments`).

Source: `lightbulb/mcp_generated_tools.py:38736`.

### `xero_list_payments`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_list_payments(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `list_payments` (platform tool `xero.list_payments`).

Source: `lightbulb/mcp_generated_tools.py:38781`.

### `xero_list_payroll_au_employee_leave`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_list_payroll_au_employee_leave(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `list_payroll_au_employee_leave` (platform tool `xero.list_payroll_au_employee_leave`).

Source: `lightbulb/mcp_generated_tools.py:38826`.

### `xero_list_payroll_au_employee_leave_balances`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_list_payroll_au_employee_leave_balances(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `list_payroll_au_employee_leave_balances` (platform tool `xero.list_payroll_au_employee_leave_balances`).

Source: `lightbulb/mcp_generated_tools.py:38871`.

### `xero_list_payroll_au_employees`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_list_payroll_au_employees(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `list_payroll_au_employees` (platform tool `xero.list_payroll_au_employees`).

Source: `lightbulb/mcp_generated_tools.py:38916`.

### `xero_list_payroll_au_leave_periods`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_list_payroll_au_leave_periods(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `list_payroll_au_leave_periods` (platform tool `xero.list_payroll_au_leave_periods`).

Source: `lightbulb/mcp_generated_tools.py:38961`.

### `xero_list_payroll_au_leave_types`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_list_payroll_au_leave_types(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `list_payroll_au_leave_types` (platform tool `xero.list_payroll_au_leave_types`).

Source: `lightbulb/mcp_generated_tools.py:39006`.

### `xero_list_payroll_au_payitems`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_list_payroll_au_payitems(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `list_payroll_au_payitems` (platform tool `xero.list_payroll_au_payitems`).

Source: `lightbulb/mcp_generated_tools.py:39051`.

### `xero_list_payroll_au_payruns`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_list_payroll_au_payruns(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `list_payroll_au_payruns` (platform tool `xero.list_payroll_au_payruns`).

Source: `lightbulb/mcp_generated_tools.py:39096`.

### `xero_list_payroll_au_superfunds`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_list_payroll_au_superfunds(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `list_payroll_au_superfunds` (platform tool `xero.list_payroll_au_superfunds`).

Source: `lightbulb/mcp_generated_tools.py:39141`.

### `xero_list_payroll_au_timesheets`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_list_payroll_au_timesheets(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `list_payroll_au_timesheets` (platform tool `xero.list_payroll_au_timesheets`).

Source: `lightbulb/mcp_generated_tools.py:39186`.

### `xero_list_prepayments`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_list_prepayments(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `list_prepayments` (platform tool `xero.list_prepayments`).

Source: `lightbulb/mcp_generated_tools.py:39231`.

### `xero_list_project_users`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_list_project_users(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `list_project_users` (platform tool `xero.list_project_users`).

Source: `lightbulb/mcp_generated_tools.py:39276`.

### `xero_list_projects`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_list_projects(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `list_projects` (platform tool `xero.list_projects`).

Source: `lightbulb/mcp_generated_tools.py:39321`.

### `xero_list_purchase_orders`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_list_purchase_orders(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `list_purchase_orders` (platform tool `xero.list_purchase_orders`).

Source: `lightbulb/mcp_generated_tools.py:39366`.

### `xero_list_quotes`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_list_quotes(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `list_quotes` (platform tool `xero.list_quotes`).

Source: `lightbulb/mcp_generated_tools.py:39411`.

### `xero_list_receipts`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_list_receipts(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `list_receipts` (platform tool `xero.list_receipts`).

Source: `lightbulb/mcp_generated_tools.py:39456`.

### `xero_list_repeating_invoices`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_list_repeating_invoices(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `list_repeating_invoices` (platform tool `xero.list_repeating_invoices`).

Source: `lightbulb/mcp_generated_tools.py:39501`.

### `xero_list_statements`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_list_statements(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `list_statements` (platform tool `xero.list_statements`).

Source: `lightbulb/mcp_generated_tools.py:39546`.

### `xero_list_tasks`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_list_tasks(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `list_tasks` (platform tool `xero.list_tasks`).

Source: `lightbulb/mcp_generated_tools.py:39591`.

### `xero_list_tax_rates`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_list_tax_rates(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `list_tax_rates` (platform tool `xero.list_tax_rates`).

Source: `lightbulb/mcp_generated_tools.py:39636`.

### `xero_list_time_entries`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_list_time_entries(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `list_time_entries` (platform tool `xero.list_time_entries`).

Source: `lightbulb/mcp_generated_tools.py:39681`.

### `xero_list_tracking_categories`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_list_tracking_categories(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `list_tracking_categories` (platform tool `xero.list_tracking_categories`).

Source: `lightbulb/mcp_generated_tools.py:39726`.

### `xero_pay_bill`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_pay_bill(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `pay_bill` (platform tool `xero.pay_bill`).

Source: `lightbulb/mcp_generated_tools.py:39771`.

### `xero_payroll_summary_report`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_payroll_summary_report(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `payroll_summary_report` (platform tool `xero.payroll_summary_report`).

Source: `lightbulb/mcp_generated_tools.py:39816`.

### `xero_profit_loss_report`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_profit_loss_report(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `profit_loss_report` (platform tool `xero.profit_loss_report`).

Source: `lightbulb/mcp_generated_tools.py:39861`.

### `xero_revert_payroll_au_timesheet`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_revert_payroll_au_timesheet(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `revert_payroll_au_timesheet` (platform tool `xero.revert_payroll_au_timesheet`).

Source: `lightbulb/mcp_generated_tools.py:39906`.

### `xero_trial_balance_report`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_trial_balance_report(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `trial_balance_report` (platform tool `xero.trial_balance_report`).

Source: `lightbulb/mcp_generated_tools.py:39951`.

### `xero_update_asset`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_update_asset(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `update_asset` (platform tool `xero.update_asset`).

Source: `lightbulb/mcp_generated_tools.py:39996`.

### `xero_update_bank_transaction`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_update_bank_transaction(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `update_bank_transaction` (platform tool `xero.update_bank_transaction`).

Source: `lightbulb/mcp_generated_tools.py:40041`.

### `xero_update_contact`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_update_contact(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `update_contact` (platform tool `xero.update_contact`).

Source: `lightbulb/mcp_generated_tools.py:40086`.

### `xero_update_credit_note`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_update_credit_note(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `update_credit_note` (platform tool `xero.update_credit_note`).

Source: `lightbulb/mcp_generated_tools.py:40131`.

### `xero_update_expense_claim`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_update_expense_claim(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `update_expense_claim` (platform tool `xero.update_expense_claim`).

Source: `lightbulb/mcp_generated_tools.py:40176`.

### `xero_update_invoice`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_update_invoice(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `update_invoice` (platform tool `xero.update_invoice`).

Source: `lightbulb/mcp_generated_tools.py:40221`.

### `xero_update_item`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_update_item(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `update_item` (platform tool `xero.update_item`).

Source: `lightbulb/mcp_generated_tools.py:40266`.

### `xero_update_manual_journal`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_update_manual_journal(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `update_manual_journal` (platform tool `xero.update_manual_journal`).

Source: `lightbulb/mcp_generated_tools.py:40311`.

### `xero_update_project`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_update_project(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `update_project` (platform tool `xero.update_project`).

Source: `lightbulb/mcp_generated_tools.py:40356`.

### `xero_update_purchase_order`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_update_purchase_order(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `update_purchase_order` (platform tool `xero.update_purchase_order`).

Source: `lightbulb/mcp_generated_tools.py:40401`.

### `xero_update_quote`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_update_quote(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `update_quote` (platform tool `xero.update_quote`).

Source: `lightbulb/mcp_generated_tools.py:40446`.

### `xero_update_receipt`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_update_receipt(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `update_receipt` (platform tool `xero.update_receipt`).

Source: `lightbulb/mcp_generated_tools.py:40491`.

### `xero_update_repeating_invoice`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_update_repeating_invoice(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `update_repeating_invoice` (platform tool `xero.update_repeating_invoice`).

Source: `lightbulb/mcp_generated_tools.py:40536`.

### `xero_update_tracking_category`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_update_tracking_category(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `update_tracking_category` (platform tool `xero.update_tracking_category`).

Source: `lightbulb/mcp_generated_tools.py:40581`.

### `xero_update_tracking_options`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_update_tracking_options(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `update_tracking_options` (platform tool `xero.update_tracking_options`).

Source: `lightbulb/mcp_generated_tools.py:40626`.

### `xero_upload_attachment`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_upload_attachment(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `upload_attachment` (platform tool `xero.upload_attachment`).

Source: `lightbulb/mcp_generated_tools.py:40671`.

### `xero_upload_file`

Namespace: `xero`. Kind: `generated`. Policy annotations: `not declared; apply conservative host policy`.



~~~python
xero_upload_file(arguments: str='{}', *, project_id: Optional[str]=None, project_ref: Optional[str]=None, connector_account_ref: Optional[str]=None, idempotency_key: Optional[str]=None, effect: Optional[str]=None, approval_ref: Optional[str]=None) -> str
~~~


Xero connector operation `upload_file` (platform tool `xero.upload_file`).

Source: `lightbulb/mcp_generated_tools.py:40716`.
