MCP 服务器

Meta Council

com.meta-council/decision-intelligence

此 MCP 可以做什么

Provides governed workflows for consulting, outreach, sales deals, invoices, marketing campaigns, content approvals, accounting analysis, and audit exports.

account_export
Account Export
Export this account's own data across every table the account owns, as the same JSON envelope the REST route returns. The set of tables served is derived from the same ownership reflection that decides what an account deletion removes, so a table the account can destroy is a table it can also read. Credentials never appear: columns held encrypted at rest are withheld unless recorded as the account's own content, and password hashes, reset and verification tokens, and API key hashes are withheld by name. Some tables are deliberately excluded -- see docs/ACCOUNT_DATA_EXPORT.md, and note that the coverage block on every response lists exactly which models are served and which are excluded with their reasons. Artifacts are described by their metadata rows rather than inlined. Bounded rather than streamed: each model reports truncated and the envelope reports complete, so narrow to one model and raise rows_per_model rather than re-reading everything. This is a data export, not an erasure request and not a claim of regulatory compliance. Requires authentication and the account:export scope.
只读 幂等
输入模式
{'type': 'object', 'properties': {'models': {'type': 'array', 'items': {'type': 'string', 'minLength': 1}, 'minItems': 1, 'description': 'Model names to narrow to, which is how a caller pages a table that truncated without re-reading the others. Omit to export every model the coverage block lists as served.'}, 'rows_per_model': {'type': 'integer', 'maximum': 5000, 'minimum': 1, 'description': 'Row ceiling applied to each model separately. Defaults to 500, maximum 5000.'}}, 'additionalProperties': False}
add_comparison_runs
Add Comparison Runs
Append finished runs you own to a set. All or nothing: a run that is unknown, not yours, still running, or already a member refuses the whole call and leaves the set exactly as it was. Requires comparisons:write.
输入模式
{'type': 'object', 'required': ['set_id', 'session_ids'], 'properties': {'set_id': {'type': 'string', 'format': 'uuid'}, 'session_ids': {'type': 'array', 'items': {'type': 'string'}, 'minItems': 1}}, 'additionalProperties': False}
add_invoice_line_item
Add Invoice Line Item
Add a billable line item to a draft or sent invoice; totals are recomputed automatically. Blocked once paid/void. invoice_id is required.
输入模式
{'type': 'object', 'required': ['invoice_id', 'description', 'unit_price'], 'properties': {'quantity': {'type': 'number', 'maximum': 1000000, 'description': 'Default 1.', 'exclusiveMinimum': 0}, 'invoice_id': {'type': 'string'}, 'unit_price': {'type': 'number', 'maximum': 999999999, 'minimum': 0}, 'description': {'type': 'string', 'maxLength': 500}}, 'additionalProperties': False}
add_outreach_lead
Add Outreach Lead
Add a single lead to the authenticated user's outreach book. Returns the new lead id. Provenance is stamped source="agent" server-side. Does not send any email. Requires authentication.
输入模式
{'type': 'object', 'required': [], 'properties': {'email': {'type': 'string', 'description': 'Optional published work email; omitted means held research.'}, 'notes': {'type': 'string', 'description': 'Optional free-text notes.'}, 'domain': {'type': 'string', 'description': 'Optional company domain.'}, 'company': {'type': 'string', 'description': 'Optional company name.'}, 'segment': {'type': 'string', 'description': 'Optional segment label.'}, 'contact_name': {'type': 'string', 'description': 'Optional contact full name.'}, 'contact_title': {'type': 'string', 'description': 'Optional contact job title.'}}, 'additionalProperties': False}
advance_workflow
Advance Workflow
Advance a workflow past a human checkpoint — approve or reject the paused step so the pipeline continues. Use the session id from run_workflow / get_workflow_session. Requires authentication.
可能执行破坏性操作
输入模式
{'type': 'object', 'required': ['session_id', 'action'], 'properties': {'notes': {'type': 'string', 'description': 'Optional reviewer notes recorded with the decision.'}, 'action': {'enum': ['approve', 'reject'], 'type': 'string', 'description': "Explicit checkpoint decision: 'approve' or 'reject'."}, 'session_id': {'type': 'string', 'description': 'The workflow session id (must be awaiting a checkpoint).'}, 'expected_step_id': {'type': 'string', 'description': 'For routed workflows, the paused result step_id returned by get_workflow_session.'}, 'expected_execution_seq': {'type': 'integer', 'minimum': 1, 'description': 'For routed workflows, the paused result execution_seq returned by get_workflow_session.'}}, 'additionalProperties': False}
approve_consulting_deliverable
Approve Consulting Deliverable
Approve one submitted internal deliverable and record approver evidence. Requires consulting:approve and never publishes or sends it.
输入模式
{'type': 'object', 'required': ['deliverable_id', 'expected_version', 'expected_content_hash'], 'properties': {'deliverable_id': {'type': 'string', 'format': 'uuid'}, 'expected_version': {'type': 'integer', 'minimum': 1}, 'expected_content_hash': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}}, 'additionalProperties': False}
approve_consulting_document_revision
Approve Consulting Document Revision
Approve and lock one exact proposal/SOW revision. Requires the separate consulting:approve scope and never publishes or shares it.
输入模式
{'type': 'object', 'required': ['document_id', 'expected_version', 'expected_content_hash'], 'properties': {'document_id': {'type': 'string', 'format': 'uuid'}, 'expected_version': {'type': 'integer', 'minimum': 1}, 'expected_content_hash': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}}, 'additionalProperties': False}
approve_content_asset
Approve Content Asset
Approve a submitted owned revision and attest to its exact content hash. Requires marketing:approve, separate from draft authority.
输入模式
{'type': 'object', 'required': ['asset_id'], 'properties': {'notes': {'type': 'string', 'maxLength': 10000}, 'asset_id': {'type': 'string', 'description': 'Full UUID from the matching list tool.'}}, 'additionalProperties': False}
approve_outreach_draft
Approve Outreach Draft
Record exact draft approval bound to recipient, campaign, subject and body. Supply the reviewed draft_sha256 as expected_draft_sha256; changed input refuses. This does not create consent, enroll or send. Requires outreach:write.
输入模式
{'type': 'object', 'title': 'DraftApprovalRequest', 'required': ['lead_id', 'expected_draft_sha256'], 'properties': {'body': {'anyOf': [{'type': 'string', 'maxLength': 100000}, {'type': 'null'}], 'title': 'Body', 'default': None}, 'lead_id': {'type': 'string', 'format': 'uuid'}, 'subject': {'anyOf': [{'type': 'string', 'maxLength': 998}, {'type': 'null'}], 'title': 'Subject', 'default': None}, 'recipient': {'anyOf': [{'type': 'string', 'maxLength': 320}, {'type': 'null'}], 'title': 'Recipient', 'default': None}, 'expected_draft_sha256': {'type': 'string', 'title': 'Expected Draft Sha256', 'pattern': '^[0-9a-f]{64}$'}}, 'description': 'Approve only against a reviewed current draft, including its campaign/recipient.', 'additionalProperties': False}
archive_saved_view
Archive Saved View
Retire one of YOUR OWN saved views without destroying it: it drops out of the default listing and execute_saved_view refuses it, but its definition is kept and restore_saved_view brings it back unchanged. Prefer this over delete_saved_view. Idempotent -- archiving twice keeps the original archive time. Archiving is your own working state and does not hide the view from a team it is shared with. Requires authentication and the tickets:write scope.
输入模式
{'type': 'object', 'required': ['view_id'], 'properties': {'view_id': {'type': 'string', 'maxLength': 64, 'minLength': 1, 'description': "The view's id, from list_saved_views."}, 'expected_revision': {'type': 'integer', 'maximum': 2147483647, 'minimum': 0, 'description': 'Current definition_revision, required to configure a scorecard or change any previously enrolled view. On conflict or uncertain reply, read current state and deliberately reconcile; this is not an exact-retry receipt.'}}, 'additionalProperties': False}
archive_ticket_provider_fields
Archive ticket provider fields
Archive an owned provider field link using its exact revision. Retains immutable captures and a revision tombstone; no provider call or remote unlink. Exact request retries recover the original result. Requires tickets:write.
幂等
输入模式
{'type': 'object', 'required': ['ticket_id', 'provider', 'request_id', 'expected_revision'], 'properties': {'provider': {'enum': ['github', 'gitlab', 'azure_devops', 'asana', 'jira', 'linear'], 'type': 'string'}, 'ticket_id': {'type': 'string', 'format': 'uuid'}, 'request_id': {'type': 'string', 'format': 'uuid'}, 'expected_revision': {'type': 'integer', 'maximum': 2147483646, 'minimum': 0}}, 'additionalProperties': False}
ask_legal
Ask Legal
Request fixed legacy Themis source/citation records and attach a proposed Laws & Regulations agent/source/synthesis plan whose routes are planned_not_run. Check the law uses fixed legacy provider-record retrieval, but returned records do not prove exact citation identity, relevance, authority, or corpus coverage. Generated research requires authentication, exact THEMIS_NEUTRAL_SCHEMA_VERSION=themis_neutral_research/v1, the operator gate, a verified authenticated corpus manifest, and an atomic spend reservation. The manifest verifier is not available yet, so generated mode remains disabled. Provider assertions/gaps are enum codes linked to evidence whose quote-fidelity state is provider-reported and rendered with fixed server text; any legacy verdict or answer prose is withheld. Returns legal_evidence_graph/v1. Automated research only, not legal advice. Requires legal:run.
只读 可访问外部资源 幂等
输入模式
{'type': 'object', 'required': ['question'], 'properties': {'context': {'type': 'string', 'default': '', 'maxLength': 2000, 'description': 'Optional factual context; treated as unverified input. The normalized question plus context must fit 2,000 characters total.'}, 'domains': {'type': 'array', 'items': {'type': 'string', 'maxLength': 80}, 'default': [], 'maxItems': 8, 'description': 'Optional domain hints such as OSHA, building_codes, or sports_regulation.'}, 'quality': {'enum': ['fast', 'balanced', 'deep'], 'type': 'string', 'default': 'balanced', 'description': 'Policy for proposed, unexecuted model-quality and reasoning-effort routes.'}, 'question': {'type': 'string', 'maxLength': 2000, 'minLength': 1, 'description': 'Laws or regulations research question (no credentials or secrets). After normalized context is appended, the combined provider question must fit 2,000 characters.'}, 'jurisdiction': {'enum': ['auto', 'federal', 'california', 'both'], 'type': 'string', 'default': 'auto', 'description': 'Request hint forwarded to the legacy provider; it does not prove corpus coverage.'}, 'max_sections': {'type': 'integer', 'maximum': 20, 'minimum': 1, 'description': 'Optional maximum number of provider-returned source/citation records.'}, 'research_mode': {'enum': ['check_law', 'themis'], 'type': 'string', 'default': 'check_law', 'description': 'Fixed legacy provider-record retrieval or an explicit request for fail-closed, neutral Themis generation.'}, 'model_overrides': {'type': 'object', 'default': {}, 'description': 'Optional model-id overrides for proposed, unexecuted agent routes.', 'maxProperties': 8, 'propertyNames': {'type': 'string', 'maxLength': 80, 'minLength': 1}, 'additionalProperties': {'type': 'string', 'maxLength': 160, 'minLength': 1}}, 'requested_agents': {'type': 'array', 'items': {'type': 'string', 'maxLength': 80}, 'default': [], 'maxItems': 7, 'description': 'Up to seven catalog agent additions for the proposed plan; one of the eight total agent slots is reserved for its baseline agent.'}, 'reasoning_effort_overrides': {'type': 'object', 'default': {}, 'description': 'Optional effort overrides for proposed, unexecuted agent routes.', 'maxProperties': 8, 'propertyNames': {'type': 'string', 'maxLength': 80, 'minLength': 1}, 'additionalProperties': {'enum': ['low', 'medium', 'high', 'max'], 'type': 'string'}}}, 'additionalProperties': False}
assign_leads_to_campaign
Assign Leads To Campaign
Assign one or more of the user's existing leads to one of the user's campaigns (both must be owned by the caller). Returns how many were assigned. Idempotent. Requires authentication.
输入模式
{'type': 'object', 'required': ['campaign_id', 'lead_ids'], 'properties': {'lead_ids': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Lead ids to assign (from search_outreach_leads).'}, 'campaign_id': {'type': 'string', 'description': 'Target campaign id (from list_outreach_campaigns).'}}, 'additionalProperties': False}
audit_export
Audit Export
Export this workspace's own agent-action audit trail as structured events, oldest first, for loading into a SIEM. Each event carries what triggered the action, which identity authorized it, which resource was touched, the outcome, and the error state. Metadata only -- no prompt text, document content, tool arguments, or model output is ever returned. Filter by date range and event action; page forward with the cursor each response returns. Covers a documented subset of platform activity rather than every action: see docs/WORKSPACE_AUDIT_EXPORT.md, and note that the coverage block on every response lists exactly which actions are exportable and which are not. Requires authentication and the audit:read scope.
只读 幂等
输入模式
{'type': 'object', 'properties': {'limit': {'type': 'integer', 'maximum': 500, 'minimum': 1, 'description': 'Events per page. Defaults to 100, maximum 500.'}, 'since': {'type': 'string', 'minLength': 1, 'description': 'ISO-8601 lower bound, inclusive, for example 2026-08-01T00:00:00Z. Omit for no lower bound.'}, 'until': {'type': 'string', 'minLength': 1, 'description': 'ISO-8601 upper bound, inclusive. Omit for no upper bound.'}, 'action': {'type': 'string', 'minLength': 1, 'description': 'Exact event action to filter to, for example mcp.tool_call. Omit to return every action this workspace can export.'}, 'after_id': {'type': 'integer', 'minimum': 0, 'description': 'Resume cursor. Pass the next_cursor from the previous page to continue without re-reading it.'}}, 'additionalProperties': False}
book_meeting
Book Meeting
Commit the exact owner-confirmed create preview using both independent scheduling grants. This can notify the recipient, including cancellation. Reuse the same preview, hash and confirmation reference after uncertainty. Missing private process custody permits receipt recovery but cannot authorize a new dispatch; no manage secret is reconstructed.
可能执行破坏性操作 可访问外部资源 幂等
输入模式
{'type': 'object', 'required': ['preview_id', 'preview_hash', 'confirmation_id'], 'properties': {'preview_id': {'type': 'string', 'format': 'uuid', 'maxLength': 36}, 'preview_hash': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'confirmation_id': {'type': 'string', 'format': 'uuid', 'maxLength': 36}}, 'additionalProperties': False}
campaign_pipeline_stats
Campaign Pipeline Stats
Pipeline-stage breakdown for one outreach campaign — total / sent / active / won / lost workflow labels, recorded status ratio, and incomplete outcome evidence. Requires authentication.
只读 幂等
输入模式
{'type': 'object', 'required': ['campaign_id'], 'properties': {'campaign_id': {'type': 'string', 'description': 'Campaign UUID (from list_outreach_campaigns).'}}, 'additionalProperties': False}
cancel_booking
Cancel Booking
Commit the exact owner-confirmed cancel preview using both independent scheduling grants. This can notify the recipient, including cancellation. Reuse the same preview, hash and confirmation reference after uncertainty. Missing private process custody permits receipt recovery but cannot authorize a new dispatch; no manage secret is reconstructed.
可能执行破坏性操作 可访问外部资源 幂等
输入模式
{'type': 'object', 'required': ['preview_id', 'preview_hash', 'confirmation_id'], 'properties': {'preview_id': {'type': 'string', 'format': 'uuid', 'maxLength': 36}, 'preview_hash': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'confirmation_id': {'type': 'string', 'format': 'uuid', 'maxLength': 36}}, 'additionalProperties': False}
capture_feature_forecast
Capture Feature Forecast
Explicitly save an immutable owner-private delivery scenario and minimal replay inputs for one epic's current descendants, including archives. Default window is eight UTC weeks. Reuse the same owner-wide request_id and exact arguments after an uncertain response; retries return the original capture even after source deletion. Missing history remains unavailable. No schedules, notifications or provider work.
幂等
输入模式
{'type': 'object', 'required': ['root_id', 'request_id'], 'properties': {'weeks': {'type': 'integer', 'maximum': 26, 'minimum': 1}, 'root_id': {'type': 'string', 'format': 'uuid'}, 'request_id': {'type': 'string', 'format': 'uuid'}}, 'additionalProperties': False}
check_ticket_provider_fields
Check ticket provider fields
Explicitly read five native fields for an existing owned link revision. Requires integrations:read and tickets:write. Reserve before I/O; retry exact request_id/arguments to recover its original result without another provider call. Changed link or credential refuses. Unsupported/missing fields and noncomparable native formats stay unknown. No remote writes or automatic reconciliation.
可访问外部资源 幂等
输入模式
{'type': 'object', 'required': ['ticket_id', 'provider', 'request_id', 'expected_revision'], 'properties': {'provider': {'enum': ['github', 'gitlab', 'azure_devops', 'asana', 'jira', 'linear'], 'type': 'string'}, 'ticket_id': {'type': 'string', 'format': 'uuid'}, 'request_id': {'type': 'string', 'format': 'uuid'}, 'expected_revision': {'type': 'integer', 'maximum': 2147483646, 'minimum': 0}}, 'additionalProperties': False}
check_ticket_provider_status
Check ticket provider status
Read the linked Jira/Linear issue status and retain an owner/link/configuration-bound observation. Requires explicit integrations:read and tickets:write. No issue creation, status transition, or automatic recovery of uncertain effects. Inspect the observation and current evidence, then use the original effect ID for explicit reconciliation if needed. Each deliberate check records new evidence; unavailable or changed bindings remain unknown.
可访问外部资源
输入模式
{'type': 'object', 'required': ['ticket_id', 'provider'], 'properties': {'provider': {'enum': ['jira', 'linear'], 'type': 'string'}, 'ticket_id': {'type': 'string', 'format': 'uuid'}}, 'additionalProperties': False}
compare_feature_forecasts
Compare Feature Forecasts
Replay and compare two owned saved delivery scenarios with the same cohort and window. Separately reports elapsed capture time, expected-date drift, remaining work, rate and exact modeled duration change. Date drift alone is not worsening throughput. Missing history or changed cohorts return noncomparable; no attention reason or notification is created.
只读 幂等
输入模式
{'type': 'object', 'required': ['earlier_id', 'later_id'], 'properties': {'later_id': {'type': 'string', 'format': 'uuid'}, 'earlier_id': {'type': 'string', 'format': 'uuid'}}, 'additionalProperties': False}
compare_scope_baseline
Compare Scope Baseline
Compare an owned baseline with current scope, estimates and completion. Deleted/moved tickets remain visible; unknown estimates are not zero. Requires tickets:read.
只读 幂等
输入模式
{'type': 'object', 'required': ['baseline_id'], 'properties': {'baseline_id': {'type': 'string', 'format': 'uuid'}}, 'additionalProperties': False}
complete_sales_task
Complete Sales Task
Mark one of the caller's sales tasks/activities done (or reopen it with done=false). Stamps or clears the completion time; activity_id is required.
输入模式
{'type': 'object', 'required': ['activity_id'], 'properties': {'done': {'type': 'boolean', 'description': 'Default true (complete). Pass false to reopen.'}, 'activity_id': {'type': 'string'}}, 'additionalProperties': False}
convert_deal_to_invoice
Convert Deal To Invoice
Create a draft invoice from one of the caller's deals: one line item for the deal's amount, client_name defaulted from the deal's company/title. deal_id is required.
输入模式
{'type': 'object', 'required': ['deal_id'], 'properties': {'notes': {'type': 'string', 'maxLength': 10000}, 'deal_id': {'type': 'string'}, 'due_date': {'type': 'string', 'description': 'ISO date YYYY-MM-DD.'}, 'tax_rate': {'type': 'number', 'maximum': 100, 'minimum': 0}, 'client_name': {'type': 'string', 'maxLength': 200, 'description': "Defaults to the deal's company or title."}, 'client_email': {'type': 'string', 'maxLength': 320}, 'payment_terms': {'type': 'string', 'maxLength': 100}}, 'additionalProperties': False}
convert_lead_to_deal
Convert Lead To Deal
Convert an owned outreach lead into a deal and advance the lead into the deal stage of the funnel (never downgrading an already-closed lead). Optional deal fields mirror create_deal; lead_id is required.
输入模式
{'type': 'object', 'required': ['lead_id'], 'properties': {'notes': {'type': 'string'}, 'stage': {'enum': ['qualification', 'discovery', 'proposal', 'negotiation', 'closed_won', 'closed_lost'], 'type': 'string'}, 'title': {'type': 'string', 'maxLength': 200}, 'amount': {'type': 'number', 'maximum': 999999999999, 'minimum': 0}, 'company': {'type': 'string', 'maxLength': 200}, 'lead_id': {'type': 'string'}, 'currency': {'type': 'string', 'pattern': '^[A-Za-z]{3}$', 'maxLength': 3, 'minLength': 3, 'description': 'Exactly three ASCII letters, such as USD; saved uppercase. Omit for USD. Syntax only, not an ISO registry.'}, 'probability': {'type': 'integer', 'maximum': 100, 'minimum': 0}, 'expected_close_date': {'type': 'string', 'description': 'ISO date YYYY-MM-DD.'}}, 'additionalProperties': False}
create_accounting_run
Create Accounting Run
Every new run requires one explicitly assigned entity and calendar tax_year in scope. Optional inclusive period_start/period_end must remain in that year. Unassigned source occurrences remain pending and excluded from amounts. Inspect catalog.scope_review, then resubmit with scope_assignments keyed by source document and original record number; raw receipts use record null. Bookings are caller decisions, never inferred. Conflicting source observations need an explicit review_note; wrong-entity/out-of-period assignments stay held. Canonical CSV may carry Assigned Entity,Booking Date,Scope Review Note columns. Use replaces_run_id for a scoped correction; the original history stays unchanged. Analyze supported textual accounting records with the pinned deterministic Writeoff engine and create a private, encrypted audit run owned by the caller. Accepted filenames end in .txt, .md, .text, .eml, .csv, .ofx, .qfx, or .qif. Returns estimates for review only: it does not file taxes, move money, or send data to an external accounting service. Send prepared rows, not raw document text. Pasting the output of a PDF-to-text converter does not fail loudly. Read verbatim as .txt, .text or .md, the whole paste collapses to exactly ONE entry, and that entry's figure can be a real number from the page that is not a charge at all: a statement with no footer total books its running BALANCE as spend. Stripping the page headers and the balance column does not change that; a genuinely empty paste raises instead. Convert each document into canonical CSV first: a Date,Description,Amount header, then one row per economic event. The Description column carrying the merchant name alone is the cleanest form, and prose is not merely untidy -- it CHANGES the answer. The matcher runs over the whole description against a vocabulary that holds ordinary words as well as vendor names: paper, printer, ink, notebook, legal, consulting, subscription, hosting and domain each classify alone with no vendor present, and contact lens or reading glasses classify as a MEDICAL deduction. A memo line saying what was bought can therefore create a deduction the vendor name alone would not. Send the merchant, not a description of the purchase. Not every phrase matches -- weekly grocery run, haircut and banana all stay unclassified -- but plain English is not inert. Classification is separately gated by context_text, but that gate is PARTIAL, not an off switch. Leaving it empty suppresses only the rules that need a business to exist: business, meals, vehicle and home-office. The personal rules stay live whatever you send -- a bare contact lens still classifies with context_text empty, under the category name fsa_hsa rather than anything called medical, and donation and tuition classify the same way. An empty context is NOT a way to stop deductions being proposed. The business gate is a bare substring test, not a reading of what you wrote: it opens on a keyword anywhere in the text, so I do not own a business and This is a personal return, not a business each switch the business rules ON rather than off. Negation is not detected. Suppress those rules with an EMPTY context, never with a denial. Booking is independent of all of it -- a row books its amount whether or not it classifies, and classification decides only whether the row becomes a deduction candidate. State the direction of every row. A .csv is routed as a statement, so each row has to say whether money went out or came in. Send exactly Date,Description,Amount,Type -- the amount column named Amount, and a Type of Purchase for money out or Refund for money in. Separate the fields with COMMAS. The delimiter is sniffed from the header row, and a semicolon additionally switches the amount parser to the European convention where the comma is the decimal point and the dot is a thousands separator. In a semicolon-delimited file an ordinary -20.00 is therefore read as 2000.00 and -1234.56 as 123456.00 -- silently, with no error, a hundred times the real figure. Tab and pipe keep the dot decimal. Send these four charge columns, each once; the optional duplicate-review metadata columns described below are also supported. Order among the four does not matter -- all 24 arrangements of Date,Description,Amount,Type measured identical -- and duplicate CSV headers are rejected before any transactions are returned. Names are compared after Unicode NFKC normalization, trimming outer whitespace and casefolding, including unknown and repeated blank headings. No copy is chosen, even when the repeated columns contain equal values. A literal Amount protects the figures from same-direction ancillary debit- or credit-looking columns. A literal Amount beats one or more same-direction ancillary columns in either order, whether those cells are populated or blank. Those ancillary values are not silently substituted. Opposite-direction ancillary columns together form a complete pair and fail closed beside Amount. Schema arbitration happens before row direction; Type cannot rescue an ambiguous schema. After arbitration selects one money representation, row direction uses a recognized Type first. Only when Type is absent or unrecognized does a trailing CR or DR marker decide. Only when both are absent does the selected money heading or sign decide. Thus Purchase and Refund outrank a conflicting marker on an otherwise unambiguous schema; notably, Payment is unrecognized and preserves the fallback. Conflicting money representations fail closed instead of being chosen by header order. Distinct equal-ranked amount aliases, multiple equally ranked same-direction money headers without a literal Amount, an amount alias beside a separate debit/credit representation, a literal Amount beside a complete pair, and a third amount candidate beside a pair each produce a named ambiguous-money error. A complete Debit/Credit pair remains supported, but a row with both pair cells nonzero fails closed. On a row with neither recognized Type nor CR/DR marker, a negative debit is a reversal and remains credit, while a negative credit is never promoted to spend. Within one role vocabulary, exact matches still beat partial matches. Column roles remain isolated. Description prefers an ordinary non-role heading. If none exists, exactly one releasable semantic-directional heading such as Charge Description or Payment Memo may serve, but only when an independent money representation survives without it. Outside that semantic-directional exception, suppressed lower-tier money, date and type candidates remain reserved and cannot become Description merely because a stronger sibling won their original role. Structural composites such as Amount Details, Transaction Type Description and Debit Details, or multiple competing semantic candidates, cannot serve as Description; when only those remain, the file fails closed rather than poaching merchant text. A duplicate-heading source contributes no transactions or amounts and carries a correction in catalog.errors. Inspect those errors even when other valid files let the batch complete. Check the original export and give each column a unique name before submitting a corrected file; saved historical results are not rewritten. Type is matched against a fixed vocabulary, not read as free text. purchase, debit, charge, withdrawal and dr mean money out; refund, credit, deposit, return and cr mean money in. All eight spelled-out words resolve in the plural as well, but the two abbreviations do not: drs and crs are unrecognised and fall through to the amount CELL, so a crs row written negative books as SPEND, not as money in. Anything else -- notably Payment, money in on a card but out on a checking account -- counts as unstated, and the direction then falls to the amount CELL rather than to the sign alone. Write the amount as a plain signed number, with nothing else in the cell. A trailing DR or CR and accounting parentheses are not decoration, and what they do depends on the column holding them and on the parser the CONTENT selected -- NOT on the file suffix. Two separate things happen to such a cell, and BOTH are confined to the statement path -- the fan-out described under Routing below. First, in every statement format and every column, the figure is given a sign: parentheses negate, DR negates, and CR does nothing at all. DR is a SIGN; CR is only a label. On the single-receipt path no marker is a sign at all: a total written 20.00 books 20.00, and that same total written 20.00 DR, (20.00) or 20.00 CR books 0.00 -- there the marker makes the amount UNREADABLE rather than negative. Second, when the content parses as CSV and schema arbitration has selected one money representation, row direction reads recognized Type first and then any marker on the selected money cell. A marker never overrides recognized Type; with Type absent or unrecognized it outranks the selected heading or sign. On a bare Date,Description,Amount file, 20.00 DR and (20.00) are both money OUT, and even -20.00 CR is money IN. A recognized Purchase or Refund still outranks either marker. A cell carrying no marker falls back to the SIGN, under the bank convention where money out is NEGATIVE, so a plain POSITIVE amount reads as money coming in and is dropped as non-deductible. On three rows totalling 137.19: written plain and positive they record nothing, and those same positives written 20.00 DR or (20.00) record all three. This CSV marker reading applies to the selected single money column or the selected nonzero cell of a complete pair. With Type absent or unrecognized, 20.00 CR is credit and 20.00 DR is debit under Amount, Charges or Payments. With neither recognized Type nor marker, heading/sign fallback remains: positive Charges is spend, negative Charges is a reversal, and a lone Payments column is credit. Beside literal Amount, even a blank Payments column is ancillary and cannot void honest figures. A money column whose name is in NEITHER vocabulary is a third way to record nothing. Purchases, Spend, Cost and Total were each measured doing it -- they are examples, not a list to check yours against -- and a file whose only figures sit under such a name returns zero rows at BOTH signs, with no error. Recognition is by name against a closed list, so the remedy is not a clearer word of your own but the four columns named at the top of this contract. Native OFX and QIF content behaves like a plain AMOUNT column and NOT like a money-out column, on all six markers, under .ofx, .qfx and .qif alike: the sign left by the first step decides, so -20.00 CR is money OUT, and so is (20.00 CR); 20.00 DR is money OUT because DR negated it; and a plain positive 20.00 is money IN and dropped. TRNTYPE is never consulted -- DEBIT with a positive TRNAMT still drops. Because the parser follows the CONTENT, a .qfx holding canonical CSV runs the CSV rules above instead, markers and all. Dropped rows are silent, and nothing in the result marks a row as dropped. A run does fail when it analyzed nothing at all across the whole submission, and separately on transport, input and engine errors -- but no failure mode reports a PARTIAL loss. If even one row anywhere survives, the run completes and the rest vanish with no notice, so a completed run is NOT evidence every row was read. A three-row file with one negative amount and two positive ones returns one row, no error, and a total indistinguishable from an honest one. The one loss that IS named is a document that contributed nothing at all. When a submitted file appears in no catalog channel -- no item, no unclassified row, no notice, no error -- and it held at least two non-empty lines, catalog.notices carries a source_left_no_trace entry naming that file. That covers whole-file loss: a statement whose rows use a different delimiter than its header, and a body of unreadable bytes under a valid header, both otherwise return the same empty success as a file that genuinely held nothing. A header-only export stays silent by design -- it has no body to lose. This does not narrow the PARTIAL case above: a file that recorded even one row counts as read, so rows dropped beside it remain silent. Routing is by filename suffix, not by content, against a CLOSED allowlist -- and the allowlist is assembled from two constants that DISAGREE. SUPPORTED_SUFFIXES in web/accounting_engine.py admits eight: .csv, .ofx, .qfx, .qif, .txt, .text, .md and .eml. STATEMENT_SUFFIXES in writeoff/batch.py names the five that fan out into one row per line, and one of those five is .xlsx, which the engine refuses before any parser sees it. What fans out is the INTERSECTION -- .csv, .ofx, .qfx and .qif. The other four -- .txt, .text, .md and .eml -- are read as a single receipt. Of those, .txt, .text and .md are read VERBATIM and behave identically to each other; .eml is NOT one of them. An .eml is parsed as an email FIRST -- headers dropped, transfer-encoding decoded, an HTML body flattened into lines at its block tags -- so every rule below applies to THOSE lines and not to the file's, and the same bytes can book a different figure, name a different merchant, or record a load error and contribute no entry at all. Statement rows sent that way collapse to ONE entry, and what that entry books turns on the PRICE pattern below: a file that LOADS and in which NO line ends in a price books 0.00, silently and with no error. An .eml with no extractable body -- an attachment-only mail -- never reaches that stage: it contributes NO entry and records an EmailIngestError in the run's errors, while still being listed among its sources. Its merchant is NOT the file's first line: it is the first line that neither ends in a price nor is a bare date, so a file led by a CSV header books that header text as the merchant, and a file whose every line ends in a PRICE books an EMPTY merchant. Ending in a bare number is not enough: a Closing balance 900 line is itself booked as the merchant. The winning figure is chosen by matching against the WHOLE lower-cased LINE, description included, so a purchase from TOTAL WINE AND MORE reads as the file's total. A label is only ever read on a line that ENDS in a price, and a price means EXACTLY TWO DECIMAL PLACES: a whole-dollar Total 137 is not a price, and neither are 137.1, 137.190 or a trailing 137. -- none of their labels are ever read. The pattern is anchored at the END only, so what stands in FRONT of the figure is unrestricted: Total USD 137.19 and even Total about 137.19 both read as totals, and a leading dollar sign is merely one case of that. After the digits it admits an optional minus and at MOST ONE trailing letter, and those letters are UPPERCASE ONLY -- T, N, X, F, E or an asterisk, while a lowercase t, n, x, f or e leaves the line with no price at all. So a line reading Total 137.19 USD, Total 137.19 (USD) or Total 137.19 EA carries no price at all, its label is never read, and the file falls through to its largest amount -- and a payable line behaves the same way, so an Amount Due 137.19 USD is not a payable line either. That property, not the marker, is why a Total 137.19 CR is not read as a total: CR is two letters, so the line has no price. Otherwise any line containing total is a total line and the LAST one wins -- not the first, not the largest -- so that wine row REPLACES an honest footer standing above it. Excluded are subtotal and sub total, though the near-miss sub-total is not excluded and does win, and any total line also holding saving, save, discount, coupon or reward as a bare substring; that is the entire exclusion list in the pinned dependency today. Those exclusions are the dangerous half: an excluded line is read as NO total rather than as a smaller one, and the search moves past it to the payable stage below, with no zero total present, and only then to the largest amount. Rows of 4812.00 and 12.34 under a Total Rewards Earned of 42.10 book 4812.00 -- a hundredfold over-book off a line the file itself labels a total. Give that same file an Amount Due of 42.10 and the payable stage rescues it. A ZERO is not an exclusion and does not chain that way. A total line reading 0.00 WINS its stage and sets the total to zero, and a zero total SUPPRESSES the payable stage, so the file drops to its LARGEST amount in EITHER order: an Amount Due of 42.10 standing above or below a Total of 0.00 does not rescue it. A paid-in-full invoice reading Total Due 0.00 books its largest line item. Last-wins covers zeros too, so a Total of 0.00 below a real Total of 42.10 WIPES it. The payable stage does not behave that way -- it takes the last payable line whose figure is NON-ZERO, so a trailing Amount Due of 0.00 leaves an earlier Amount Due of 42.10 standing. With no total line surviving, a line reading amount due, balance due, amount payable or please pay is used instead, last-wins again and only when its figure is non-zero. Those four are matched as LITERAL text, so the doubled-space spellings Amount Due and Balance Due, and likewise Amount-Due and AmountDue, are NOT payable lines at all; a file whose only payable label is spelled one of those ways skips to its LARGEST amount, which is the direction that over-books. A trailing colon in Amount Due: still matches. Failing every stage, the largest amount anywhere in the file. One hazard, though, is NOT confined to that last stage. The price read is END-anchored on the LINE, not on a column, so it reaches back across commas and swallows text belonging to the field BEFORE it. It takes the line's final cents pair and walks LEFT across each comma-separated group of EXACTLY three digits, then swallows up to three trailing digits of whatever text precedes the first such comma -- an amount's cents, a check or invoice number, a card last-4, a units or store-number column; money or not, decimal point or not. A group of one, two, or four-or-more digits terminates the walk. So a row of -12.34,887.66 yields 34,887.66 -- a figure that appears in NO cell of the document, even though those characters occur across the comma between two cells in the raw text. That splicing happens while the price is being READ, which is before any label is tested, so a spliced figure is what a total line or a payable line CARRIES INTO its own stage: a footer reading Total,-60.34,887.66 books 34,887.66 rather than 60.34, and an Amount Due,-12.34,887.66 books 34,887.66 the same way. Holding an explicit Total line is therefore NOT a way out of this. The field on the LEFT need not be money and need not carry a decimal point: a check register whose amount is the LAST column books 140,732.19 from a row reading 2029-06-02,8140,732.19, and an Amount Due,INV 4522,887.66 books 522,887.66. There is no ceiling on the RIGHT either -- -31.20 beside 412,880.55 books 20,412,880.55, because 412 and 880 are each groups of exactly three. What stops the walk is GROUP WIDTH alone, so a right-hand 1000.00, 4,887.66 or 12,345.67 is read whole, and the total line then books THAT figure rather than its own. A spliced figure is usually in no cell of the document, but not always: when the digits swallowed are all ZEROS -- an amount's 00 cents, or a round 1000 -- it lands exactly on the right-hand figure, so agreeing with a real cell is not evidence of a clean read. No error is raised in any of these cases. Send that file as .csv instead, where the splice does not occur. Rows of 200.00 and 12.34 under a Total of 137.19 book 137.19; delete that total line and the same file books 200.00. The winning line's own minus sign is DISCARDED at either stage, so a Total of -137.19 and an Amount Due of -137.19 both book 137.19. The entry books 0.00 whenever NO line in the file ends in a price, and a DR, CR or parenthesis marker on every amount is only ONE way to reach that state: whole-dollar amounts, a trailing currency code and a trailing period each book 0.00 with no marker anywhere in the file. Where a marker IS the cause, leaving the winning line unmarked makes it book in full, whether the winner is a total or a payable line. Every rule in this paragraph is measured on the LINES the loader hands the parser: for .txt, .text and .md those are the file's own lines, and for .eml they are the extracted body's. Anything outside the eight is REFUSED outright with an unsupported-file-type error rather than silently mis-read, so .pdf and .xlsx never reach the parser. Because the second set lives in a pinned dependency, treat the four as measured today, not as a promise. That split is by suffix; WITHIN those four the parser is chosen by CONTENT, so a .qfx holding canonical CSV runs the CSV column contract above in full. Preserve each verified source row. Exact equal amounts for the same merchant (case/whitespace normalized) within 14 days inclusive are candidate pairs. Missing dates and explicit shared Event ID also require review. Disputed contributions are excluded from all counted totals and shown as pending review; pending source-occurrence amounts are not unique-payment estimates. Raw documents and references remain evidence. Different invoice/order/card references alone never prove separate payments. Use duplicate_resolutions with exact source/row locators, a review_note and decision distinct_payments or same_payment; the latter requires an explicit counted_source and conflicting amounts/itemization stay pending. Create a new run with replacement choices to recalculate, or [] to reverse them; historical runs stay unchanged. At most 500 choices, 500 sources each, and 10,000 expanded reviewed pairs. Optional CSV columns Event ID, Payment Reference, Payment Review and Payment Review Note preserve evidence. Only explicit reviewed distinct rows with Payment Review=distinct_payment, different Event IDs and nonempty notes restore separate contributions without a resolution list. Scope each run to one entity and one tax year, and name it that way -- totals spanning entities or years match no filing. Book each event on the date money moved (cash basis) unless the entity files accrual, and never mix bases in one run. Submit runs one at a time: one ingest is active per owner at a time. The returned total counts classified spend only. Charges whose merchant matches no deterministic rule are excluded from it, so do not present it as total spend. Use preview_accounting_ticket_sync to turn those residuals into reviewable work. Never submit a figure you cannot find verbatim in the source document, and never adjust a merchant name to make a row classify: Description is what the engine matches on, so renaming an unrecognised vendor to a recognised one raises the deduction while every figure stays verbatim. An unclassified row is the engine declining to assert a rule it does not have. Leave it, and report the count.
输入模式
{'type': 'object', 'required': ['documents', 'scope'], 'properties': {'name': {'type': 'string', 'maxLength': 200, 'description': "Optional private label for this audit run. Name it for the entity and tax year it covers, for example 'Example, LLC 2024'."}, 'scope': {'type': 'object', 'required': ['entity', 'tax_year'], 'properties': {'entity': {'type': 'string', 'maxLength': 256, 'minLength': 1}, 'tax_year': {'type': 'integer', 'maximum': 9998, 'minimum': 1900}, 'period_end': {'type': 'string', 'description': 'Inclusive ISO date within tax_year'}, 'period_start': {'type': 'string', 'description': 'Inclusive ISO date within tax_year'}}, 'additionalProperties': False}, 'context': {'type': 'string', 'maxLength': 20480, 'description': 'Optional business/tax context used by the deterministic engine.'}, 'documents': {'type': 'array', 'items': {'type': 'object', 'required': ['filename', 'content'], 'properties': {'content': {'type': 'string', 'maxLength': 1048576, 'minLength': 1}, 'filename': {'type': 'string', 'maxLength': 255, 'minLength': 1}}, 'additionalProperties': False}, 'maxItems': 50, 'minItems': 1, 'description': '1-50 documents of prepared text. PDFs and other binaries are rejected at the byte-validation boundary by design, so extract text on the client and send canonical Date,Description,Amount,Type rows. Statements already in .csv/.ofx/.qfx/.qif form are parsed row per line, so do not retype their rows -- but do not send one unread: a semicolon-delimited .csv is read in the European convention and books -20.00 as 2000.00, and an OFX or QIF row whose amount is positive is dropped without TRNTYPE being consulted. Both are silent and neither raises an error.'}, 'marginal_rate': {'type': 'string', 'maxLength': 32, 'description': 'Optional decimal or percent, for example 0.24 or 24%.'}, 'replaces_run_id': {'type': 'string', 'format': 'uuid'}, 'scope_assignments': {'type': 'array', 'items': {'type': 'object', 'required': ['source', 'entity', 'booking_date'], 'properties': {'entity': {'type': 'string'}, 'record': {'type': ['integer', 'null'], 'minimum': 1}, 'source': {'type': 'string'}, 'review_note': {'type': 'string', 'maxLength': 4096}, 'booking_date': {'type': 'string'}}, 'additionalProperties': False}, 'maxItems': 10000}, 'duplicate_resolutions': {'type': 'array', 'items': {'type': 'object', 'required': ['sources', 'decision', 'review_note'], 'properties': {'sources': {'type': 'array', 'items': {'type': 'string', 'maxLength': 320, 'minLength': 1}, 'maxItems': 500, 'minItems': 2, 'uniqueItems': True}, 'decision': {'enum': ['distinct_payments', 'same_payment'], 'type': 'string'}, 'review_note': {'type': 'string', 'maxLength': 4096, 'minLength': 1}, 'counted_source': {'type': ['string', 'null'], 'maxLength': 320}}, 'additionalProperties': False}, 'maxItems': 500, 'description': 'Replacement reviewed duplicate decisions for this new run; omit or use [] to leave candidates pending.'}}, 'additionalProperties': False}
create_comparison_artifact
Create Comparison Artifact
Record one durable comparison between a member run and a candidate run you own, usually one a comparison just created. Requires comparisons:write.
输入模式
{'type': 'object', 'required': ['set_id', 'baseline_session_id', 'candidate_session_id'], 'properties': {'set_id': {'type': 'string', 'format': 'uuid'}, 'baseline_session_id': {'type': 'string', 'maxLength': 64, 'minLength': 1}, 'candidate_session_id': {'type': 'string', 'maxLength': 64, 'minLength': 1}}, 'additionalProperties': False}
create_comparison_set
Create Comparison Set
Create an empty owned collection of finished runs to measure against. Membership is append-only: nothing can be removed or edited once added, so a fixture cannot be adjusted after the result is seen. Requires comparisons:write.
输入模式
{'type': 'object', 'required': ['name'], 'properties': {'name': {'type': 'string', 'maxLength': 200, 'minLength': 1}}, 'additionalProperties': False}
create_comparison_verdict
Create Comparison Verdict
Record an accept or reject call over the comparisons you name, under the default decision rule or thresholds you state. An undecided result records nothing and is reported instead. Requires comparisons:write.
输入模式
{'type': 'object', 'required': ['set_id', 'artifact_ids'], 'properties': {'set_id': {'type': 'string', 'format': 'uuid'}, 'thresholds': {'anyOf': [{'type': 'object', 'properties': {'min_decisive': {'anyOf': [{'type': 'integer', 'maximum': 10000, 'minimum': 1}, {'type': 'null'}], 'default': None}, 'min_improved': {'anyOf': [{'type': 'integer', 'maximum': 10000, 'minimum': 0}, {'type': 'null'}], 'default': None}, 'max_regressed': {'anyOf': [{'type': 'integer', 'maximum': 10000, 'minimum': 0}, {'type': 'null'}], 'default': None}}, 'additionalProperties': False}, {'type': 'null'}], 'default': None}, 'artifact_ids': {'type': 'array', 'items': {'type': 'string'}, 'maxItems': 100, 'minItems': 1}}, 'additionalProperties': False}
create_consulting_client
Create Consulting Client
Create an account-private consulting client.
输入模式
{'type': 'object', 'required': ['name'], 'properties': {'name': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'notes': {'type': 'string', 'maxLength': 50000}, 'status': {'enum': ['active', 'inactive'], 'type': 'string'}, 'contact_name': {'type': 'string', 'maxLength': 200}, 'external_ref': {'type': 'string', 'maxLength': 180, 'minLength': 1}, 'organization': {'type': 'string', 'maxLength': 200}, 'contact_email': {'type': 'string', 'maxLength': 255}}, 'additionalProperties': False}
create_consulting_deliverable
Create Consulting Deliverable
Create an internal draft deliverable on an owned engagement.
输入模式
{'type': 'object', 'required': ['engagement_id', 'key', 'title'], 'properties': {'key': {'type': 'string', 'pattern': '^[a-z0-9][a-z0-9_-]{0,79}$'}, 'title': {'type': 'string', 'maxLength': 300, 'minLength': 1}, 'due_date': {'type': 'string', 'format': 'date'}, 'description': {'type': 'string', 'maxLength': 50000}, 'milestone_id': {'type': 'string', 'format': 'uuid'}, 'engagement_id': {'type': 'string', 'format': 'uuid'}}, 'additionalProperties': False}
create_consulting_document_revision
Create Consulting Document Revision
Create a revision-safe proposal or SOW draft on an owned engagement.
输入模式
{'type': 'object', 'required': ['engagement_id', 'kind', 'title', 'body'], 'properties': {'body': {'type': 'string', 'maxLength': 50000, 'minLength': 1}, 'kind': {'enum': ['proposal', 'sow'], 'type': 'string'}, 'title': {'type': 'string', 'maxLength': 300, 'minLength': 1}, 'engagement_id': {'type': 'string', 'format': 'uuid'}, 'expected_latest_revision': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}
create_consulting_engagement
Create Consulting Engagement
Create an engagement for an owned consulting client.
输入模式
{'type': 'object', 'required': ['client_id', 'title'], 'properties': {'title': {'type': 'string', 'maxLength': 300, 'minLength': 1}, 'status': {'enum': ['draft', 'active', 'on_hold', 'completed', 'cancelled'], 'type': 'string'}, 'client_id': {'type': 'string', 'format': 'uuid'}, 'objective': {'type': 'string', 'maxLength': 50000}, 'start_date': {'type': 'string', 'format': 'date'}, 'external_ref': {'type': 'string', 'maxLength': 180, 'minLength': 1}, 'sales_deal_ref': {'type': 'string', 'maxLength': 240}, 'target_end_date': {'type': 'string', 'format': 'date'}, 'accounting_run_ref': {'type': 'string', 'maxLength': 240}}, 'additionalProperties': False}
create_content_asset
Create Content Asset
Create a private draft content asset. There is no publish/send operation.
输入模式
{'type': 'object', 'required': ['campaign_id', 'title', 'content'], 'properties': {'title': {'type': 'string', 'maxLength': 240, 'minLength': 1}, 'channel': {'type': 'string', 'maxLength': 40, 'minLength': 1}, 'content': {'type': 'string', 'maxLength': 100000, 'minLength': 1}, 'asset_type': {'type': 'string', 'maxLength': 40, 'minLength': 1}, 'campaign_id': {'type': 'string', 'description': 'Full UUID from the matching list tool.'}, 'scheduled_for': {'type': 'string', 'format': 'date-time'}, 'revision_notes': {'type': 'string', 'maxLength': 10000}}, 'additionalProperties': False}
create_content_asset_revision
Create Content Asset Revision
Create a new owned draft revision from a frozen submitted/approved/rejected revision.
输入模式
{'type': 'object', 'required': ['asset_id'], 'properties': {'title': {'type': 'string', 'maxLength': 240, 'minLength': 1}, 'channel': {'type': 'string', 'maxLength': 40, 'minLength': 1}, 'content': {'type': 'string', 'maxLength': 100000, 'minLength': 1}, 'asset_id': {'type': 'string', 'description': 'Full UUID from the matching list tool.'}, 'asset_type': {'type': 'string', 'maxLength': 40, 'minLength': 1}, 'scheduled_for': {'type': 'string', 'format': 'date-time'}, 'revision_notes': {'type': 'string', 'maxLength': 10000}}, 'additionalProperties': False}
create_deal
Create Deal
Create a sales deal owned by the caller. Provide a title, or a lead_id to inherit the lead's company/name as the title. The deal appears live on the owner's Sales board. No deletes are exposed over MCP.
输入模式
{'type': 'object', 'properties': {'notes': {'type': 'string'}, 'stage': {'enum': ['qualification', 'discovery', 'proposal', 'negotiation', 'closed_won', 'closed_lost'], 'type': 'string', 'description': 'Pipeline stage (default qualification).'}, 'title': {'type': 'string', 'maxLength': 200, 'description': 'Deal title (required unless lead_id is given).'}, 'amount': {'type': 'number', 'maximum': 999999999999, 'minimum': 0, 'description': 'Deal value (>= 0).'}, 'company': {'type': 'string', 'maxLength': 200}, 'lead_id': {'type': 'string', 'description': 'Link to an existing owned lead.'}, 'currency': {'type': 'string', 'pattern': '^[A-Za-z]{3}$', 'maxLength': 3, 'minLength': 3, 'description': 'Exactly three ASCII letters, such as USD; saved uppercase. Omit for USD. Syntax only, not an ISO registry.'}, 'campaign_id': {'type': 'string', 'description': 'Link to an owned campaign.'}, 'probability': {'type': 'integer', 'maximum': 100, 'minimum': 0, 'description': 'Win probability 0-100.'}, 'expected_close_date': {'type': 'string', 'description': 'ISO date YYYY-MM-DD.'}}, 'additionalProperties': False}
create_invoice
Create Invoice
Create a draft invoice owned by the caller for a client, optionally seeded with line items and linked to an existing deal. Totals (subtotal/tax/total) are computed from the line items and tax_rate. The invoice starts in status 'draft' — call send_invoice to mark it sent.
输入模式
{'type': 'object', 'required': ['client_name'], 'properties': {'notes': {'type': 'string', 'maxLength': 10000}, 'deal_id': {'type': 'string', 'description': 'Optional: link to an owned deal.'}, 'currency': {'type': 'string', 'pattern': '^[A-Za-z]{3}$', 'maxLength': 3, 'minLength': 3, 'description': 'Three ASCII letters; normalized to uppercase (default USD). ISO membership is not checked.'}, 'due_date': {'type': 'string', 'description': 'ISO date YYYY-MM-DD.'}, 'tax_rate': {'type': 'number', 'maximum': 100, 'minimum': 0, 'description': 'Percentage, e.g. 8.5 for 8.5%.'}, 'line_items': {'type': 'array', 'items': {'type': 'object', 'required': ['description', 'unit_price'], 'properties': {'quantity': {'type': 'number', 'maximum': 1000000, 'exclusiveMinimum': 0}, 'unit_price': {'type': 'number', 'maximum': 999999999, 'minimum': 0}, 'description': {'type': 'string', 'maxLength': 500}}}, 'maxItems': 200}, 'client_name': {'type': 'string', 'maxLength': 200}, 'client_email': {'type': 'string', 'maxLength': 320}, 'payment_terms': {'type': 'string', 'maxLength': 100, 'description': "e.g. 'Net 30', 'Due on receipt'."}}, 'additionalProperties': False}
create_marketing_audience
Create Marketing Audience
Create an owner-private reusable audience definition.
输入模式
{'type': 'object', 'required': ['name'], 'properties': {'name': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'channels': {'type': 'array', 'items': {'type': 'string', 'maxLength': 40}, 'maxItems': 20}, 'description': {'type': 'string', 'maxLength': 20000}, 'pain_points': {'type': 'string', 'maxLength': 20000}}, 'additionalProperties': False}
create_marketing_brand
Create Marketing Brand
Create an owner-private brand identity. Requires marketing:agent_write.
输入模式
{'type': 'object', 'required': ['name'], 'properties': {'name': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'voice': {'type': 'string', 'maxLength': 10000}, 'guidelines': {'type': 'string', 'maxLength': 20000}, 'value_proposition': {'type': 'string', 'maxLength': 10000}}, 'additionalProperties': False}
create_marketing_campaign
Create Marketing Campaign
Create an owner-private marketing campaign linked only to owned brand/audience ids.
输入模式
{'type': 'object', 'required': ['name'], 'properties': {'name': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'status': {'enum': ['draft', 'planned', 'active', 'paused', 'completed', 'archived'], 'type': 'string'}, 'ends_on': {'type': 'string', 'format': 'date'}, 'brand_id': {'type': 'string', 'description': 'Full UUID from the matching list tool.'}, 'channels': {'type': 'array', 'items': {'type': 'string', 'maxLength': 40}, 'maxItems': 20}, 'objective': {'type': 'string', 'maxLength': 20000}, 'starts_on': {'type': 'string', 'format': 'date'}, 'audience_id': {'type': 'string', 'description': 'Full UUID from the matching list tool.'}}, 'additionalProperties': False}
create_monitor
Create Monitor
Save a standing watch that fires later, on its own: when a count you name crosses a line you set, do the thing you chose. Lets an agent bank a condition and stop polling for it. The watch survives the conversation that created it. Note that start_workflow spends the account's credits unattended each time it fires, so the cooldown is the only thing bounding what it costs. Requires authentication, a Pro or Enterprise account, and the monitors:write scope.
输入模式
{'type': 'object', 'required': ['name', 'subject', 'comparator', 'threshold', 'action'], 'properties': {'name': {'type': 'string', 'maxLength': 120, 'minLength': 1, 'description': "Human label for the watch, e.g. 'Backlog over 50'."}, 'action': {'enum': ['start_workflow', 'notify_slack'], 'type': 'string', 'description': 'What to do when the condition holds.'}, 'subject': {'enum': ['tickets', 'leads', 'invoices'], 'type': 'string', 'description': 'Which of your counts to watch.'}, 'threshold': {'type': 'integer', 'maximum': 1000000, 'minimum': 0, 'description': 'The line the count must cross.'}, 'comparator': {'enum': ['gt', 'gte', 'lt', 'lte', 'eq'], 'type': 'string', 'description': 'How the count is compared against threshold.'}, 'action_config': {'type': 'object', 'properties': {'query': {'type': 'string', 'maxLength': 2000, 'description': 'start_workflow only: optional query handed to the workflow.'}, 'message': {'type': 'string', 'maxLength': 2000, 'minLength': 1, 'description': 'notify_slack only: the message to send.'}, 'workflow_slug': {'type': 'string', 'maxLength': 100, 'minLength': 1, 'description': 'start_workflow only: slug of the workflow to run, from list_workflows.'}}, 'description': 'Settings for the chosen action. start_workflow needs workflow_slug; notify_slack needs message.', 'additionalProperties': False}, 'status_filter': {'type': 'string', 'maxLength': 40, 'description': "Optional: count only rows in this status, e.g. 'todo'. Omit to count them all."}, 'cooldown_seconds': {'type': 'integer', 'minimum': 0, 'description': 'Minimum gap between firings. Defaults to 3600. Values below one scheduler tick are raised to 60, and the stored value reflects that.'}}, 'additionalProperties': False}
create_outreach_campaign
Create Outreach Campaign
Create a new outreach campaign owned by the authenticated user. Returns the new campaign id. Reversible (campaigns can be edited/deleted in the dashboard). Requires authentication.
输入模式
{'type': 'object', 'required': ['name'], 'properties': {'name': {'type': 'string', 'description': 'Campaign name (required).'}, 'status': {'type': 'string', 'description': 'Optional initial status: draft (default) | active | paused | completed.'}, 'description': {'type': 'string', 'description': 'Optional description.'}, 'target_segment': {'type': 'string', 'description': 'Optional target segment label.'}, 'target_audience': {'type': 'string', 'description': 'Optional target-audience note.'}}, 'additionalProperties': False}
create_outreach_pitch
Create Outreach Pitch
Create a reusable pitch template (subject + body templates, optional drafting prompt) owned by the user. Provenance is stamped source="agent" server-side. Returns the new pitch id. Requires authentication.
输入模式
{'type': 'object', 'required': ['name', 'subject_template', 'body_template'], 'properties': {'name': {'type': 'string', 'description': 'Pitch name (required).'}, 'tone': {'type': 'string', 'description': "Optional tone (default 'professional')."}, 'prompt': {'type': 'string', 'description': 'Optional AI drafting instruction.'}, 'category': {'type': 'string', 'description': 'Optional category label.'}, 'body_template': {'type': 'string', 'description': 'Email-body template (required).'}, 'target_segment': {'type': 'string', 'description': 'Optional target segment label.'}, 'subject_template': {'type': 'string', 'description': 'Subject-line template (required).'}}, 'additionalProperties': False}
create_portfolio_report_share
Create Portfolio Report Share
Create an expiring read-only bearer link for the exact previewed report projection. Anyone possessing the link can read it; copied content cannot be recalled. Requires explicit reports:share and independent human approval. Expiry must be UTC Z, 60 seconds to 30 days from creation. Acknowledge public visibility explicitly. Keep request_id and exact arguments after an uncertain reply; retrieve the original receipt with get_portfolio_report_share_receipt and read current link state. No link is sent.
可访问外部资源 幂等
输入模式
{'type': 'object', 'title': 'ShareCreate', 'required': ['snapshot_id', 'request_id', 'expected_projection_hash', 'expires_at', 'acknowledge_public'], 'properties': {'expires_at': {'type': 'string', 'title': 'Expires At', 'format': 'date-time', 'pattern': '^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d{1,6})?Z$'}, 'request_id': {'type': 'string', 'title': 'Request Id', 'format': 'uuid'}, 'snapshot_id': {'type': 'string', 'title': 'Snapshot Id', 'format': 'uuid'}, 'acknowledge_public': {'type': 'boolean', 'const': True, 'title': 'Acknowledge Public'}, 'expected_projection_hash': {'type': 'string', 'title': 'Expected Projection Hash', 'pattern': '^[0-9a-f]{64}$', 'maxLength': 64, 'minLength': 64}}, 'additionalProperties': False}
create_portfolio_schedule
Create Portfolio Schedule
Create an owner-private daily, weekly or monthly portfolio report schedule. Defaults to paused; explicitly enable to start internal captures. Uses the same active-ticket aggregate as manual reports. Optional project_id from project_list limits captures to that owned project; each report retains its own inputs. No email or provider calls. Preserve request_id and exact intent when retrying an uncertain reply. Requires tickets:write.
幂等
输入模式
{'type': 'object', 'title': 'ScheduleCreate', 'required': ['request_id', 'definition'], 'properties': {'definition': {'type': 'object', 'title': 'ScheduleDefinition', 'required': ['name', 'frequency', 'timezone', 'hour', 'minute'], 'properties': {'hour': {'type': 'integer', 'title': 'Hour', 'maximum': 23, 'minimum': 0}, 'name': {'type': 'string', 'title': 'Name', 'maxLength': 200, 'minLength': 1}, 'minute': {'type': 'integer', 'title': 'Minute', 'maximum': 59, 'minimum': 0}, 'enabled': {'type': 'boolean', 'title': 'Enabled', 'default': False}, 'weekday': {'anyOf': [{'type': 'integer', 'maximum': 6, 'minimum': 0}, {'type': 'null'}], 'title': 'Weekday', 'default': None}, 'archived': {'type': 'boolean', 'title': 'Archived', 'default': False}, 'monthday': {'anyOf': [{'type': 'integer', 'maximum': 31, 'minimum': 1}, {'type': 'null'}], 'title': 'Monthday', 'default': None}, 'timezone': {'type': 'string', 'title': 'Timezone', 'maxLength': 100, 'minLength': 1}, 'frequency': {'enum': ['daily', 'weekly', 'monthly'], 'type': 'string', 'title': 'Frequency'}, 'project_id': {'anyOf': [{'type': 'string', 'format': 'uuid'}, {'type': 'null'}], 'title': 'Project Id', 'default': None, 'description': 'Owned project UUID from project_list. Omit or pass null for a portfolio-wide schedule; project identity is frozen in each capture.'}}, 'additionalProperties': False}, 'request_id': {'type': 'string', 'title': 'Request Id', 'format': 'uuid'}}, 'additionalProperties': False}
create_portfolio_snapshot
Create Portfolio Snapshot
Capture an immutable rollup of YOUR OWN ticket portfolio, or one owned ProjectWorkspace when project_id is supplied, as it stands right now -- totals by status and priority, fixed at this moment and never recomputed. A snapshot is the durable 'here is where we were' that a later diff_portfolio_snapshots measures movement against, so capture one before a review rather than after. Snapshots cannot be edited or deleted once taken. The snapshot records the credential that captured it, so one taken by an agent is attributable as such. Requires authentication and the tickets:write scope.
输入模式
{'type': 'object', 'properties': {'label': {'type': 'string', 'maxLength': 200, 'description': 'Optional human label, e.g. the review it was taken for. Omitted leaves the snapshot unlabelled.'}, 'project_id': {'type': 'string', 'format': 'uuid', 'description': 'Owned ProjectWorkspace UUID from project_list. Omit for the whole portfolio.'}, 'request_id': {'type': 'string', 'format': 'uuid', 'description': 'Reuse this UUID and the exact label/project scope to recover an uncertain capture.'}}, 'additionalProperties': False}
create_portfolio_snapshot_note
Create Portfolio Snapshot Note
Record a decision or comment against one of YOUR OWN portfolio snapshots. Pass expected_content_hash -- the hash you saw when you read the snapshot -- and a mismatch is REFUSED rather than quietly filed against a different revision; that check is the point of this tool. Omitting it still records the note, it just does not assert which revision was on the screen. This writes down what was decided; it does not approve, reject or block anything, and nothing downstream gates on it. A lost reply may have committed; this write has no replay key and must not be automatically retried. Requires authentication and the tickets:write scope.
输入模式
{'type': 'object', 'required': ['snapshot_id', 'body'], 'properties': {'body': {'type': 'string', 'maxLength': 10000, 'minLength': 1, 'description': 'What was decided or observed.'}, 'kind': {'enum': ['comment', 'decision'], 'type': 'string', 'default': 'comment', 'description': 'Whether this records a decision or an ordinary comment. Defaults to comment.'}, 'snapshot_id': {'type': 'string', 'maxLength': 64, 'minLength': 1, 'description': "The snapshot's id, from list_portfolio_snapshots."}, 'expected_content_hash': {'type': 'string', 'maxLength': 128, 'minLength': 1, 'description': "The snapshot's content_hash as you read it. A mismatch is refused."}}, 'additionalProperties': False}
create_report_review_envelope
Create Report Review Envelope
Freeze verified saved values with the definitions and disclosures shown now. Original-capture definitions are unavailable; this does not approve, share or hold data. Keep the exact request ID and fields after an uncertain reply. Requires tickets:write.
幂等
输入模式
{'type': 'object', 'required': ['request_id', 'snapshot_id', 'expected_source_schema', 'expected_source_hash'], 'properties': {'request_id': {'type': 'string', 'format': 'uuid', 'maxLength': 36, 'minLength': 36}, 'snapshot_id': {'type': 'string', 'format': 'uuid', 'maxLength': 36, 'minLength': 36}, 'expected_source_hash': {'type': 'string', 'pattern': '^[0-9a-f]{64}$', 'maxLength': 64, 'minLength': 64}, 'expected_source_schema': {'enum': [1, 2, 3, 4], 'type': 'integer'}}, 'additionalProperties': False}
create_saved_view
Create Saved View
Save a named ticket filter, column, grouping and sort bundle so you can reopen it later or share it with a team. Saves the QUESTION, not an answer: the view is re-run against live tickets every time it is opened, so it never goes stale. The new view is private until you share it. Same endpoint the web app's save button uses. Requires authentication and the tickets:write scope.
输入模式
{'type': 'object', 'required': ['name', 'columns'], 'properties': {'name': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'What to call the view.'}, 'columns': {'type': 'array', 'items': {'type': 'string'}, 'maxItems': 20, 'description': 'Which ticket columns the view shows, in order. At most 20.'}, 'filters': {'type': 'object', 'properties': {'q': {'type': 'string', 'description': 'Saved-view filter: q.'}, 'kind': {'type': 'string', 'description': 'Saved-view filter: kind.'}, 'scope': {'enum': ['active', 'archived', 'all'], 'type': 'string', 'default': 'active', 'description': 'Saved-view filter: scope.'}, 'state': {'enum': [None, 'unresolved', 'resolved', 'all'], 'type': ['string', 'null'], 'description': 'Saved-view filter: state.'}, 'reader': {'enum': ['tickets', 'attention', 'reviewed_attention'], 'type': 'string', 'default': 'tickets', 'description': 'Saved-view filter: reader.'}, 'reason': {'enum': [None, 'stale', 'aging', 'blocked', 'dependency_blocked', 'completion_blocked', 'missed_due_date', 'integration_drift', 'forecast_degradation'], 'type': ['string', 'null'], 'description': 'Saved-view filter: reason.'}, 'status': {'type': 'string', 'description': 'Saved-view filter: status.'}, 'assignee': {'type': 'string', 'description': 'Saved-view filter: assignee.'}, 'priority': {'type': 'string', 'description': 'Saved-view filter: priority.'}, 'follow_up': {'enum': [None, 'all', 'due'], 'type': ['string', 'null'], 'description': 'Saved-view filter: follow_up.'}, 'parent_id': {'type': 'string', 'description': 'Saved-view filter: parent_id.'}, 'recursive': {'type': 'boolean', 'description': 'Saved-view filter: recursive.'}, 'session_id': {'type': 'string', 'description': 'Saved-view filter: session_id.'}, 'action_type': {'type': 'string', 'description': 'Saved-view filter: action_type.'}, 'workflow_session_id': {'type': 'string', 'description': 'Saved-view filter: workflow_session_id.'}}, 'description': 'Saved question. Omitted reader selects ordinary tickets. Attention accepts reason; reviewed_attention accepts state and follow_up. Triage refuses other non-default ticket filters, grouping and sorting. Save intent only, never result pages.', 'additionalProperties': False}, 'sort_by': {'type': 'string', 'description': 'Optional ticket field to sort rows by.'}, 'group_by': {'type': 'string', 'description': 'Optional ticket field to group rows by.'}, 'sort_dir': {'enum': ['asc', 'desc'], 'type': 'string', 'default': 'asc', 'description': 'Sort direction. Defaults to asc.'}, 'scorecard': {'type': ['object', 'null'], 'required': ['version', 'preset', 'cards'], 'properties': {'cards': {'type': 'array', 'items': {'type': 'object', 'required': ['metric', 'threshold'], 'properties': {'metric': {'enum': ['total', 'open', 'todo', 'in_progress', 'blocked', 'done', 'cancelled'], 'type': 'string'}, 'threshold': {'type': ['object', 'null'], 'required': ['operator', 'value'], 'properties': {'value': {'type': 'integer', 'maximum': 2147483647, 'minimum': 0}, 'operator': {'enum': ['gte', 'lte'], 'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'maxItems': 7, 'minItems': 1}, 'preset': {'enum': ['custom', 'executive', 'pmo', 'manager'], 'type': 'string'}, 'version': {'type': 'integer', 'const': 1}}, 'description': 'Optional private ordinary live ticket counts; omit to retain, null to clear while retaining a nonzero revision. At most 10000 matching tickets, no actions or role grants. Shared and triage definitions cannot enroll.', 'additionalProperties': False}, 'expected_revision': {'type': 'integer', 'maximum': 2147483647, 'minimum': 0, 'description': 'Current definition_revision, required to configure a scorecard or change any previously enrolled view. On conflict or uncertain reply, read current state and deliberately reconcile; this is not an exact-retry receipt.'}}, 'additionalProperties': False}
create_scope_baseline
Create Scope Baseline
Save immutable scope, estimates and explicit plan versions/dates for an owned delivery group. Reuse request_id on retries; a new request_id captures a new baseline. Requires tickets:write.
输入模式
{'type': 'object', 'required': ['root_id', 'request_id', 'label'], 'properties': {'label': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'root_id': {'type': 'string', 'format': 'uuid'}, 'request_id': {'type': 'string', 'format': 'uuid'}}, 'additionalProperties': False}
create_workflow_template
Create Workflow Template
Create a new custom workflow template the caller owns, so a multi-step pipeline can be built in conversation instead of by hand in the browser. Saves the same definition the web builder saves. The slug is derived from the name and is returned — use it with run_workflow. Legacy workflows run in dependency order; steps ready together share one bounded parallel layer, while no depends_on keeps authored list order. Explicitly routed workflows use next_step and bounded quality-gate transitions and cannot mix those fields with depends_on. Requires authentication and the workflows:write scope.
输入模式
{'type': 'object', 'required': ['name', 'steps'], 'properties': {'name': {'type': 'string', 'maxLength': 120, 'minLength': 1, 'description': "Template name, e.g. 'Competitor Teardown'. The saved slug is derived from this."}, 'tags': {'type': 'array', 'items': {'type': 'string', 'maxLength': 64, 'minLength': 1}, 'maxItems': 20, 'description': 'Optional tags for discovery.'}, 'steps': {'type': 'array', 'items': {'type': 'object', 'allOf': [{'not': {'required': ['id', 'step_id']}}], 'required': ['name', 'agent_template'], 'properties': {'id': {'type': 'string', 'pattern': '^[A-Za-z0-9][A-Za-z0-9_.:-]*$', 'maxLength': 100, 'minLength': 1, 'description': 'Optional stable identifier for this step. Supply one only if another step names it in depends_on.'}, 'name': {'type': 'string', 'maxLength': 120, 'minLength': 1, 'description': "Human-readable step name, e.g. 'Draft the brief'."}, 'role': {'type': 'string', 'maxLength': 200, 'description': 'Optional short role label shown alongside the step.'}, 'type': {'enum': ['agent', 'transform', 'connector'], 'type': 'string', 'description': "Optional executable node kind. Defaults to 'agent', which asks a model a question. 'transform' runs a supported deterministic local operation; 'connector' invokes the configured connector runtime and fails that step if the runtime is unavailable."}, 'model': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': "Optional model id override for this step; omit to use the agent template's own model."}, 'tools': {'type': 'array', 'items': {'type': 'string', 'minLength': 1}, 'maxItems': 100, 'description': 'Optional subset of persona tools. [] disables tools for supplied-evidence drafts; omission inherits.', 'uniqueItems': True}, 'params': {'type': 'object', 'description': "Optional configuration for a non-agent step. Must be omitted or empty for an 'agent' step, whose configuration is the named fields above (model, temperature, instruction, ...); params would be silently ignored there, so it is refused."}, 'step_id': {'type': 'string', 'pattern': '^[A-Za-z0-9][A-Za-z0-9_.:-]*$', 'maxLength': 100, 'minLength': 1, 'description': 'Canonical stable identifier for routed steps. Do not supply both step_id and the legacy id field.'}, 'next_step': {'type': 'string', 'pattern': '^(?:__end__|[A-Za-z0-9][A-Za-z0-9_.:-]*)$', 'maxLength': 100, 'minLength': 1, 'description': 'Optional next step id for an explicitly routed workflow. Do not combine routed fields with depends_on.'}, 'checkpoint': {'type': 'boolean', 'description': 'Whether the run pauses for human approval after this step. Defaults to true when omitted.'}, 'depends_on': {'type': 'array', 'items': {'type': 'string', 'pattern': '^[A-Za-z0-9][A-Za-z0-9_.:-]*$', 'maxLength': 100, 'minLength': 1}, 'maxItems': 20, 'description': 'Optional ids of steps this one builds on. A step starts only once every id it names has finished. Steps ready together share one bounded parallel layer in authored order. A definition with no arrows still runs in list order. Do not combine depends_on with routed fields.'}, 'human_gate': {'type': 'boolean', 'description': 'Require approval from the authenticated human review UI. API-key and MCP callers cannot cross this gate.'}, 'max_tokens': {'type': 'integer', 'maximum': 65536, 'minimum': 1, 'description': 'Optional output token cap for this step.'}, 'instruction': {'type': 'string', 'maxLength': 20000, 'description': 'Optional step-specific instruction for the agent.'}, 'temperature': {'type': 'number', 'maximum': 2.0, 'minimum': 0.0, 'description': 'Optional sampling temperature override for this step.'}, 'quality_gate': {'type': 'object', 'allOf': [{'if': {'required': ['schema'], 'properties': {'schema': {'const': 'scope_decision/v1'}}}, 'then': {'properties': {'max_iterations': {'const': 1}, 'blocking_severities': {'const': ['P0', 'P1']}}}}], 'required': ['schema', 'loop_to', 'pass_to', 'max_iterations'], 'properties': {'schema': {'enum': ['severity_findings/v1', 'scope_decision/v1'], 'type': 'string'}, 'loop_to': {'type': 'string', 'pattern': '^[A-Za-z0-9][A-Za-z0-9_.:-]*$', 'maxLength': 100, 'minLength': 1}, 'pass_to': {'type': 'string', 'pattern': '^(?:__end__|[A-Za-z0-9][A-Za-z0-9_.:-]*)$', 'maxLength': 100, 'minLength': 1}, 'max_iterations': {'type': 'integer', 'maximum': 5, 'minimum': 1}, 'blocking_severities': {'type': 'array', 'items': {'enum': ['P0', 'P1', 'P2', 'P3', 'P4', 'P5'], 'type': 'string'}, 'maxItems': 6, 'minItems': 1, 'uniqueItems': True}}, 'additionalProperties': False}, 'agent_template': {'type': 'string', 'pattern': '^[a-z0-9][a-z0-9_-]*$', 'maxLength': 100, 'minLength': 1, 'description': 'Slug of the agent template this step runs, from list_agents.'}, 'requires_distinct_provider_from': {'type': 'string', 'pattern': '^[A-Za-z0-9][A-Za-z0-9_.:-]*$', 'maxLength': 100, 'minLength': 1, 'description': "Require this step's actual provider to differ from the provider that produced the named earlier step."}}, 'additionalProperties': False}, 'maxItems': 20, 'minItems': 1, 'description': 'The pipeline steps, in the order they will run.'}, 'domain': {'type': 'string', 'maxLength': 80, 'minLength': 1, 'description': "Optional grouping domain, e.g. 'research'. Defaults to 'general'."}, 'description': {'type': 'string', 'maxLength': 4000, 'description': 'Optional description of what the workflow does.'}}, 'additionalProperties': False}
decide_approval
Decide Approval
Answer a waiting checkpoint by request id: approve, reject, or amend. 'amend' means send the step back to be redone with the change described in notes, so notes are required for it. Spends money: approve continues the run and amend re-runs the step, both billed. Fails with a clear error, rather than silently doing nothing, if the run is no longer waiting. Requires authentication and the workflows:approve scope.
输入模式
{'type': 'object', 'required': ['approval_id', 'decision'], 'properties': {'notes': {'type': 'string', 'maxLength': 2000, 'description': 'What you want changed or why. Required when decision is amend; optional otherwise.'}, 'decision': {'enum': ['approve', 'reject', 'amend'], 'type': 'string', 'description': 'approve continues the run; reject sends the step back to be redone; amend does the same but requires notes saying what to change.'}, 'approval_id': {'type': 'string', 'maxLength': 64, 'minLength': 1, 'description': "The request's id, from list_approvals."}}, 'additionalProperties': False}
delete_accounting_run
Delete Accounting Run
Hide one owned Accounting run from normal lists and reads. Its encrypted data and provenance are retained and restore_accounting_run reverses this action; this is not permanent erasure. Repeating delete is safe. No external service is contacted.
幂等
输入模式
{'type': 'object', 'required': ['run_id'], 'properties': {'run_id': {'type': 'string', 'format': 'uuid', 'maxLength': 36, 'minLength': 36}, 'expected_revision': {'type': 'integer', 'maximum': 2147483646, 'minimum': 0, 'description': 'Optional visibility revision from get/list; refuses a stale visibility change.'}}, 'additionalProperties': False}
delete_monitor
Delete Monitor
Delete one of your standing watches, so it stops firing. Does not touch anything it already started. Requires authentication and the monitors:write scope.
输入模式
{'type': 'object', 'required': ['monitor_id'], 'properties': {'monitor_id': {'type': 'string', 'maxLength': 64, 'minLength': 1, 'description': "The monitor's id, from create_monitor or list_monitors."}}, 'additionalProperties': False}
delete_saved_view
Delete Saved View
Permanently delete one of YOUR OWN saved views. UNRECOVERABLE -- there is no undo and the definition is not retained. archive_saved_view is the reversible retirement and is almost always what is wanted instead; use this only for a view that should actually be gone. Deleting a shared view removes it for the team too. Requires authentication and the tickets:write scope.
可能执行破坏性操作
输入模式
{'type': 'object', 'required': ['view_id'], 'properties': {'view_id': {'type': 'string', 'maxLength': 64, 'minLength': 1, 'description': "The view's id, from list_saved_views."}, 'expected_revision': {'type': 'integer', 'maximum': 2147483647, 'minimum': 0, 'description': 'Current definition_revision, required to configure a scorecard or change any previously enrolled view. On conflict or uncertain reply, read current state and deliberately reconcile; this is not an exact-retry receipt.'}}, 'additionalProperties': False}
delete_workflow_template
Delete Workflow Template
Delete a custom workflow template the caller owns. Built-in templates cannot be deleted. This removes the saved definition; runs already started from it are unaffected. Requires authentication and the workflows:write scope.
输入模式
{'type': 'object', 'required': ['slug'], 'properties': {'slug': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'Slug of the template to delete, from list_workflows.'}, 'expected_template_fingerprint': {'type': 'string', 'maxLength': 64, 'minLength': 64, 'description': 'Optional. The definition fingerprint you last saw for this template, returned by update_workflow_template when it last succeeded. Supply it and the write refuses, changing nothing, if the stored template is no longer the one that fingerprint names -- someone else edited or deleted it since you read it. Omit it and the write proceeds as it always has, overwriting whatever is there. This is not the definition_sha reported for a run: that one also reflects global configuration, this one names the stored file alone.'}}, 'additionalProperties': False}
diff_portfolio_snapshots
Diff Portfolio Snapshots
Compare two of your own portfolio snapshots and return the per-dimension movement between them. snapshot_id is always the 'to' side; against is the 'from' baseline, defaulting to your newest snapshot in the same project or portfolio strictly older than it -- the 'what changed since last time' read, which is reported as not found when this is your first snapshot. Comparing an older snapshot against a newer one is allowed and disclosed rather than silently confusing: the result says whether the pair is chronological and the elapsed days go negative. Both sides are immutable, so a diff is reproducible indefinitely. Requires authentication and the tickets:read scope.
只读 幂等
输入模式
{'type': 'object', 'required': ['snapshot_id'], 'properties': {'against': {'type': 'string', 'maxLength': 64, 'minLength': 1, 'description': "The baseline to compare against -- the 'from' side. Omit for your newest snapshot older than snapshot_id."}, 'snapshot_id': {'type': 'string', 'maxLength': 64, 'minLength': 1, 'description': "The snapshot being examined -- the 'to' side, from list_portfolio_snapshots."}}, 'additionalProperties': False}
draft_outreach_email
Draft Outreach Email
Save a draft email subject and/or body onto one of the user's leads. This only stores the draft for human review — it does NOT send anything. A human sends from the dashboard. Requires authentication.
输入模式
{'type': 'object', 'required': ['lead_id'], 'properties': {'lead_id': {'type': 'string', 'description': 'Lead id to draft for (from search_outreach_leads).'}, 'email_body': {'type': 'string', 'description': 'Draft email body.'}, 'subject_line': {'type': 'string', 'description': 'Draft subject line.'}}, 'additionalProperties': False}
enable_attention_notification_rule
Enable Attention Notification Rule
Explicitly enable the exact owned configuration and start a fresh observation cycle. Requires notifications:send plus independent human approval of actual destinations, fields, stages and quiet hours. No priority bypass. Reuse exact request_id for uncertainty; retrieve the receipt then read current state. May cause signed webhook notifications; never sends email.
可访问外部资源 幂等
输入模式
{'type': 'object', 'title': 'Enable', 'required': ['request_id', 'expected_revision', 'expected_configuration_hash', 'acknowledge_delivery', 'rule_id'], 'properties': {'rule_id': {'type': 'string', 'format': 'uuid'}, 'request_id': {'type': 'string', 'title': 'Request Id', 'format': 'uuid'}, 'expected_revision': {'type': 'integer', 'title': 'Expected Revision', 'maximum': 2147483646, 'minimum': 1}, 'acknowledge_delivery': {'type': 'boolean', 'const': True, 'title': 'Acknowledge Delivery'}, 'expected_configuration_hash': {'type': 'string', 'title': 'Expected Configuration Hash', 'pattern': '^[0-9a-f]{64}$', 'maxLength': 64, 'minLength': 64}}, 'additionalProperties': False}
estimate_cost
Estimate Cost
Estimate what a panel or saved workflow would cost before running it: returns a per-agent/per-step price breakdown, the total for the requested number of runs, your remaining quota and platform credit, an honest list of any models the platform could not price, and a go/no-go decision. Reserves nothing, charges nothing, starts nothing.
只读 幂等
输入模式
{'type': 'object', 'required': ['kind'], 'properties': {'kind': {'enum': ['council', 'workflow'], 'type': 'string', 'description': 'What to price: a council panel or a saved workflow.'}, 'runs': {'type': 'integer', 'maximum': 1000, 'minimum': 1, 'description': 'How many runs to price (default 1).'}, 'model': {'type': 'string', 'description': 'Optional single model override applied to every agent or step. A model absent from the pricing catalog is reported in unpriced_models rather than silently priced as the default.'}, 'panel': {'type': 'string', 'description': "Panel slug when kind is 'council' (default: 'default')."}, 'workflow': {'type': 'string', 'description': "Workflow slug — required when kind is 'workflow'."}}, 'additionalProperties': False}
execute_saved_view
Execute Saved View
Run saved ticket, attention or reviewed-work intent against live owned data. Ordinary views return matching tickets and optional group counts. Triage returns the original reader envelope in data, the view and a definition_token. For triage continuation send expected_definition_token; attention uses next_offset, reviewed work uses next_cursor with offset0. A changed definition refuses409: reload and restart. Ordinary views refuse cursor/token. Results are always YOUR tickets: a shared view shares the question, not the answers, so opening a teammate's view runs it against your own work and never reveals theirs. An archived view is refused rather than executed. Returns the same payload the web app receives. Follow next_offset while has_more; live ticket or filter changes can shift offset pages, so restart to refresh. Requires authentication and the tickets:read scope.
只读 幂等
输入模式
{'type': 'object', 'required': ['view_id'], 'properties': {'limit': {'type': 'integer', 'maximum': 500, 'minimum': 1, 'description': "Page size: ordinary defaults200/max500, attention defaults100/max500, reviewed work defaults20/max50. Omit for the reader's default."}, 'cursor': {'type': 'string', 'maxLength': 2048, 'minLength': 1, 'description': 'Reviewed-work next_cursor only; never saved in the definition.'}, 'offset': {'type': 'integer', 'default': 0, 'maximum': 2147483647, 'minimum': 0, 'description': 'How many tickets to skip. Defaults to 0.'}, 'view_id': {'type': 'string', 'maxLength': 64, 'minLength': 1, 'description': "The view's id, from list_saved_views."}, 'expected_definition_token': {'type': 'string', 'pattern': '^[0-9a-f]{64}$', 'description': 'Required on triage continuation; bind to the preceding saved definition.'}}, 'additionalProperties': False}
export_portfolio_snapshot
Export Portfolio Snapshot
Download one owned saved report using the same JSON, CSV, accessible HTML or optional tagged PDF renderer as the browser. Returns filename, media_type, encoding, content and SHA-256; PDF content is base64. Unsupported PDF fonts or renderer dependencies return an explicit error with HTML fallback. No network delivery or share link is created. Requires tickets:read.
只读 幂等
输入模式
{'type': 'object', 'required': ['snapshot_id'], 'properties': {'format': {'enum': ['json', 'csv', 'html', 'pdf'], 'type': 'string', 'default': 'json'}, 'snapshot_id': {'type': 'string', 'format': 'uuid', 'maxLength': 36, 'minLength': 36}}, 'additionalProperties': False}
export_report_review_envelope
Export Report Review Envelope
Export one verified frozen review record as versioned JSON or CSV, accessible HTML or optional tagged PDF. Returns exact bytes as UTF-8 or PDF base64 with SHA-256. PDF dependency or glyph failures offer HTML fallback. No delivery, share or approval is created. Requires tickets:read.
只读 幂等
输入模式
{'type': 'object', 'required': ['envelope_id'], 'properties': {'format': {'enum': ['json', 'csv', 'html', 'pdf'], 'type': 'string'}, 'envelope_id': {'type': 'string', 'format': 'uuid', 'maxLength': 36, 'minLength': 36}}, 'additionalProperties': False}
export_ticket_to_provider
Export ticket to provider
Export the exact previewed owned ticket to Jira or Linear, using expected_export_hash from preview_ticket_export and the same destination. Requires explicit integrations:write, tickets:write, and independent human approval of the complete preview. Persists the operation before possible remote writes. After an uncertain response, inspect list_ticket_provider_effects and reconcile the original intent; never blindly export again. Remote confirmation is observed, not atomic protection against concurrent remote writers.
可访问外部资源
输入模式
{'type': 'object', 'required': ['ticket_id', 'provider', 'expected_export_hash'], 'properties': {'provider': {'enum': ['jira', 'linear'], 'type': 'string'}, 'ticket_id': {'type': 'string', 'format': 'uuid'}, 'destination': {'type': 'string', 'maxLength': 80, 'minLength': 1}, 'expected_export_hash': {'type': 'string', 'pattern': '^[a-f0-9]{64}$'}}, 'additionalProperties': False}
get_accounting_run
Get Accounting Run
Get one private Accounting run owned by the caller, including its deterministic estimates, disclaimer, engine revision, and audit timestamps. Source input stays omitted unless include_input=true is explicitly requested.
只读 幂等
输入模式
{'type': 'object', 'required': ['run_id'], 'properties': {'run_id': {'type': 'string', 'maxLength': 36, 'minLength': 36}, 'include_input': {'type': 'boolean', 'default': False, 'description': "Also return the caller's decrypted source text; use sparingly."}}, 'additionalProperties': False}
get_agent_detail
Get Agent Detail
Full detail on one expert agent by slug (from list_agents): role, description, default model, domain, tags, and tools.
只读 幂等
输入模式
{'type': 'object', 'required': ['slug'], 'properties': {'slug': {'type': 'string', 'description': "The agent slug, e.g. 'safety_officer'."}}, 'additionalProperties': False}
get_api_key_info
Get Api Key Info
Report the scopes, plan tier, expiry and remaining quota of the API key making this call, so an agent can check what it is allowed to do before attempting it rather than by being refused. Requires API-key authentication.
只读 幂等
输入模式
{'type': 'object', 'required': [], 'properties': {}, 'additionalProperties': False}
get_attention_notification_delivery
Get Attention Notification Delivery
Inspect exact retained notification payload and delivery state, with independent bounded attempt and recovery histories. Page attempts with next_before_attempt and recoveries with next_before_recovery_id separately. Uncertain is not delivered; owner received/cancel declarations do not rewrite network outcomes. Requires tickets:read.
只读 幂等
输入模式
{'type': 'object', 'required': ['delivery_id'], 'properties': {'limit': {'type': 'integer', 'default': 20, 'maximum': 100, 'minimum': 1}, 'delivery_id': {'type': 'string', 'format': 'uuid'}, 'before_attempt': {'type': 'integer', 'maximum': 2147483647, 'minimum': 1}, 'before_recovery_id': {'type': 'string', 'format': 'uuid'}}, 'additionalProperties': False}
get_attention_notification_receipt
Get Attention Notification Receipt
Recover the exact original request receipt without replaying or enabling delivery. Save receipts may contain destination signing secrets: requires notifications:manage. Historical receipt state is not current authority; read current state afterwards.
只读 幂等
输入模式
{'type': 'object', 'required': ['request_id'], 'properties': {'request_id': {'type': 'string', 'format': 'uuid'}}, 'additionalProperties': False}
get_attention_notification_rule
Get Attention Notification Rule
Read full owned notification configuration, copied selection, pinned quiet policy and health. Contains destination URLs but no signing secrets; handle privately. Requires notifications:manage.
只读 幂等
输入模式
{'type': 'object', 'required': ['rule_id'], 'properties': {'rule_id': {'type': 'string', 'format': 'uuid'}}, 'additionalProperties': False}
get_availability
Get Availability
Read current slots for one owned active meeting type in a window of at most 31 days. Existing host/provider gates and shared quotas apply. Availability is checked again before a booking; this read sends no invitation.
只读 可访问外部资源
输入模式
{'type': 'object', 'required': ['meeting_type_id', 'window_start', 'window_end'], 'properties': {'window_end': {'type': 'string', 'format': 'date-time', 'maxLength': 32}, 'window_start': {'type': 'string', 'format': 'date-time', 'maxLength': 32}, 'meeting_type_id': {'type': 'string', 'format': 'uuid', 'maxLength': 36}}, 'additionalProperties': False}
get_booking
Get Booking
Read one owned booking and its bounded operation receipts for recovery. Includes private intake details. Does not redispatch an uncertain operation or reconstruct its manage credential.
只读 幂等
输入模式
{'type': 'object', 'required': ['booking_id'], 'properties': {'booking_id': {'type': 'string', 'format': 'uuid', 'maxLength': 36}}, 'additionalProperties': False}
get_business_suite_overview
Get Business Suite Overview
What needs attention across my business? Return the same private, counts-only review as the browser: Sales tasks, Marketing approvals, Accounting runs and Consulting work, with deterministic next actions. Legal is a governed entry point, not a verified review queue; generated Legal advice is disabled. No raw documents, amounts, contacts or private text are returned. Never sends, approves, pays or calls a provider. Requires the explicit business_suite:read scope, absent from default and legacy keys. Returns the canonical snapshot as JSON and structured data.
只读 幂等
输入模式
{'type': 'object', 'properties': {}, 'additionalProperties': False}
输出模式
{'type': 'object', 'required': ['text', 'data'], 'properties': {'data': {'type': 'object'}, 'text': {'type': 'string'}}, 'additionalProperties': False}
get_comparison_artifact
Get Comparison Artifact
Read one recorded comparison back exactly as it was stored. Requires comparisons:read.
只读 幂等
输入模式
{'type': 'object', 'required': ['set_id', 'artifact_id'], 'properties': {'set_id': {'type': 'string', 'format': 'uuid'}, 'artifact_id': {'type': 'string', 'format': 'uuid'}}, 'additionalProperties': False}
get_comparison_eligibility
Get Comparison Eligibility
Report per member whether it can still be compared, and why not when it cannot. Membership is permanent, so a member that became unreadable is reported as ineligible rather than quietly dropped. Requires comparisons:read.
只读 幂等
输入模式
{'type': 'object', 'required': ['set_id'], 'properties': {'set_id': {'type': 'string', 'format': 'uuid'}}, 'additionalProperties': False}
get_comparison_set
Get Comparison Set
Read one comparison set and its membership in fixed order. Requires comparisons:read.
只读 幂等
输入模式
{'type': 'object', 'required': ['set_id'], 'properties': {'set_id': {'type': 'string', 'format': 'uuid'}}, 'additionalProperties': False}
get_comparison_verdict
Get Comparison Verdict
Read one recorded verdict, the comparisons it was asked over, and the rule it was decided under. Requires comparisons:read.
只读 幂等
输入模式
{'type': 'object', 'required': ['set_id', 'verdict_id'], 'properties': {'set_id': {'type': 'string', 'format': 'uuid'}, 'verdict_id': {'type': 'string', 'format': 'uuid'}}, 'additionalProperties': False}
get_consulting_engagement
Get Consulting Engagement
Get one owned engagement with its document revisions, milestones, and internal deliverables. Long document bodies are previewed.
只读 幂等
输入模式
{'type': 'object', 'required': ['engagement_id'], 'properties': {'engagement_id': {'type': 'string', 'format': 'uuid'}}, 'additionalProperties': False}
get_content_asset
Get Content Asset
Get one owned content revision, including its review state and exact content hashes.
只读 幂等
输入模式
{'type': 'object', 'required': ['asset_id'], 'properties': {'asset_id': {'type': 'string', 'description': 'Full UUID from the matching list tool.'}}, 'additionalProperties': False}
get_content_calendar
Get Content Calendar
List scheduled owned content between optional ISO-8601 boundaries. Scheduling is planning metadata, not publishing.
只读 幂等
输入模式
{'type': 'object', 'properties': {'end': {'type': 'string', 'format': 'date-time'}, 'start': {'type': 'string', 'format': 'date-time'}}, 'additionalProperties': False}
get_deal
Get Deal
Fetch one of the caller's deals by id with its full activity timeline (notes, calls, meetings, emails, tasks; newest first).
只读 幂等
输入模式
{'type': 'object', 'required': ['deal_id'], 'properties': {'deal_id': {'type': 'string', 'description': 'The deal id.'}}, 'additionalProperties': False}
get_deal_health
Get Deal Health
Health scores for the caller's OPEN deals: each scored 0-100 on how likely it is to be slipping (healthy >= 70 / watch / at_risk), worst first, with plain-language reasons — days since last logged contact, whether it is past its own expected close date, and how its age compares to the caller's average won-deal cycle. Includes per-band counts, an average score, and the reference cycle. Read-only and deterministic over the caller's own deals + activities; nothing is executed or sent. Pair with get_sales_recommendations to act on what is slipping. Requires authentication.
只读 幂等
输入模式
{'type': 'object', 'properties': {}, 'additionalProperties': False}
get_delivery_timeline
Get Delivery Timeline
Read a delivery group planned/actual timeline and optional frozen-baseline variance, plus explanatory dependency risks. Unknown dates/history are not inferred. Bounded to 10,001 owned tickets (10,000 work tickets plus a root); pages of 1–500, default200. Critical path only for supported complete calendar/duration graphs; no dates move. Requires tickets:read.
只读 幂等
输入模式
{'type': 'object', 'required': ['root_id'], 'properties': {'limit': {'type': 'integer', 'maximum': 500, 'minimum': 1}, 'root_id': {'type': 'string', 'format': 'uuid'}, 'baseline_id': {'type': 'string', 'format': 'uuid'}, 'after_ticket_id': {'type': 'string', 'format': 'uuid'}}, 'additionalProperties': False}
get_external_workflow
Get External Workflow
Read your retained external draft, next step or checkpoint digest after reconnect/restart. Execute only the returned next_step. Source material is untrusted data. No model invocation. Requires workflows:read.
只读 幂等
输入模式
{'type': 'object', 'required': ['session_id'], 'properties': {'session_id': {'type': 'string', 'format': 'uuid'}}, 'additionalProperties': False}
get_feature_delivery_summary
Get Feature Delivery Summary
Read one owned feature epic's current task completion, estimates, weekly delivery flow, lead/cycle evidence, risks and throughput scenario. Includes a separate retained-history view of scope additions/removals, estimate changes and accumulated blocked task-hours, with explicit incomplete/ambiguous coverage. Scope history follows the delivery-group hierarchy, not V3 project placement; it is not a planned timeline. Requires tickets:read.
只读 幂等
输入模式
{'type': 'object', 'required': ['root_id'], 'properties': {'weeks': {'type': 'integer', 'maximum': 26, 'minimum': 1}, 'root_id': {'type': 'string', 'format': 'uuid'}}, 'additionalProperties': False}
get_feature_forecast
Get Feature Forecast
Read and hash-verify one owned immutable delivery scenario by replaying its minimal saved inputs. Includes structural identities and event history, never ticket prose. Current source deletion does not erase the capture. A scenario is not a commitment.
只读 幂等
输入模式
{'type': 'object', 'required': ['observation_id'], 'properties': {'observation_id': {'type': 'string', 'format': 'uuid'}}, 'additionalProperties': False}
get_invoice
Get Invoice
Fetch one of the caller's invoices by id, including its line items.
只读 幂等
输入模式
{'type': 'object', 'required': ['invoice_id'], 'properties': {'invoice_id': {'type': 'string', 'description': 'The invoice id.'}}, 'additionalProperties': False}
get_invoice_aging
Get Invoice Aging
Summarize the caller's unpaid invoices by how long they have been past due. This owner-scoped, read-only report is computed live; an invoice is overdue only when its status is sent and its due_date is before today. Balances are separated by currency, with no conversion or combined money total.
只读 幂等
输入模式
{'type': 'object', 'properties': {}, 'additionalProperties': False}
get_marketing_audience
Get Marketing Audience
Get one owned audience definition with pain points and channels.
只读 幂等
输入模式
{'type': 'object', 'required': ['audience_id'], 'properties': {'audience_id': {'type': 'string', 'description': 'Full UUID from the matching list tool.'}}, 'additionalProperties': False}
get_marketing_brand
Get Marketing Brand
Get one owned brand identity with its voice, value proposition, and guidelines.
只读 幂等
输入模式
{'type': 'object', 'required': ['brand_id'], 'properties': {'brand_id': {'type': 'string', 'description': 'Full UUID from the matching list tool.'}}, 'additionalProperties': False}
get_marketing_campaign
Get Marketing Campaign
Get one owned marketing campaign with its brand, audience, channels, and dates.
只读 幂等
输入模式
{'type': 'object', 'required': ['campaign_id'], 'properties': {'campaign_id': {'type': 'string', 'description': 'Full UUID from the matching list tool.'}}, 'additionalProperties': False}
get_meta_council_platform_metrics
Get Meta Council Platform Metrics
OPERATOR ONLY: cross-owner analytics for the META COUNCIL PLATFORM itself — every account added together, NOT the caller's workspace (use get_workspace_metrics for that). Requires both the platform:admin scope AND an ADMIN_EMAILS operator account; everyone else gets a permission error. Returns content-free aggregates only: account counts, 30-day active owners, session counts by status and token totals, ticket open/done, deal pipeline and outstanding invoice amounts separated by recorded currency without FX conversion and with missing coverage stated, overdue invoice counts, feedback backlog, per-pillar adoption, the busiest panel slugs, and a per-account activity table (email and counts). It never returns query text, answers, feedback bodies, deal or invoice detail, or any other text a user typed — the aggregate reports how much, never what about. Note that open + done need not equal the ticket total: cancelled tickets are neither.
只读 幂等
输入模式
{'type': 'object', 'properties': {}, 'additionalProperties': False}
get_portfolio_report_lineage
Get Portfolio Report Lineage
Read bounded outgoing replacement chains and incoming owner declarations for one owned saved report. Absence means no replacement recorded, not approval. Continue outgoing pages with next_snapshot_id and incoming pages with next_before_relation_id. Original reports and downloads never change. tickets:read.
只读 幂等
输入模式
{'type': 'object', 'required': ['snapshot_id'], 'properties': {'limit': {'type': 'integer', 'default': 20, 'maximum': 100, 'minimum': 1}, 'snapshot_id': {'type': 'string', 'format': 'uuid', 'maxLength': 36, 'minLength': 36}, 'before_relation_id': {'type': 'string', 'format': 'uuid', 'maxLength': 36, 'minLength': 36}}, 'additionalProperties': False}
get_portfolio_report_share
Get Portfolio Report Share
Read current owned report-link metadata and active, expired or revoked state without disclosing its secret. Requires tickets:read. Stored report content remains unchanged.
只读 幂等
输入模式
{'type': 'object', 'required': ['share_id'], 'properties': {'share_id': {'type': 'string', 'format': 'uuid'}}, 'additionalProperties': False}
get_portfolio_report_share_receipt
Get Portfolio Report Share Receipt
Recover the exact original create/revoke receipt using its request_id, including the original bearer link for create. Requires explicit reports:share; no approval or new access is created. A receipt describes the original commit: separately get current link state before treating it as active.
只读 幂等
输入模式
{'type': 'object', 'required': ['request_id'], 'properties': {'request_id': {'type': 'string', 'format': 'uuid'}}, 'additionalProperties': False}
get_portfolio_schedule
Get Portfolio Schedule
Read an owned report schedule, next UTC time, configured local timezone and current capture health. Calendar disclosures explain skipped nonexistent times, the earlier repeated time and month-end clamping. Current health is not immutable failure history. Requires tickets:read.
只读 幂等
输入模式
{'type': 'object', 'required': ['schedule_id'], 'properties': {'schedule_id': {'type': 'string', 'format': 'uuid'}}, 'additionalProperties': False}
get_portfolio_snapshot
Get Portfolio Snapshot
Fetch one portfolio snapshot by id: its label, schema version, the exact stored rollup payload, its content hash, who recorded it and when. The payload is served from storage and is never recomputed from live tickets, so a snapshot read today reports what was true when it was taken. A snapshot you do not own is reported as not found rather than as forbidden. Requires authentication and the tickets:read scope.
只读 幂等
输入模式
{'type': 'object', 'required': ['snapshot_id'], 'properties': {'snapshot_id': {'type': 'string', 'maxLength': 64, 'minLength': 1, 'description': "The snapshot's id, from list_portfolio_snapshots."}}, 'additionalProperties': False}
get_portfolio_snapshot_inputs
Get Portfolio Snapshot Inputs
Verify and return the retained minimal inputs and regenerated counts of one owned project report. Reads stored inputs only; later ticket moves or deletion do not recapture the report. Legacy reports without retained inputs return a precise unavailable dependency. Requires tickets:read.
只读 幂等
输入模式
{'type': 'object', 'required': ['snapshot_id'], 'properties': {'snapshot_id': {'type': 'string', 'format': 'uuid', 'maxLength': 36, 'minLength': 36}}, 'additionalProperties': False}
get_project_attention_policy
Get Project Attention Policy
Read one owned project's current override or owner-policy inheritance, effective policy and immutable project history. Archived projects retain authority. Page history with next_before_revision while has_more. Requires tickets:read; no state changes.
只读 幂等
输入模式
{'type': 'object', 'required': ['project_id'], 'properties': {'limit': {'type': 'integer', 'maximum': 50, 'minimum': 1}, 'project_id': {'type': 'string', 'format': 'uuid'}, 'before_revision': {'type': 'integer', 'maximum': 2147483647, 'minimum': 1}}, 'additionalProperties': False}
get_report_review_envelope
Get Report Review Envelope
Read one owned frozen review record and source hash without rebuilding its definitions. No declaration or permission to share is inferred. Requires tickets:read.
只读 幂等
输入模式
{'type': 'object', 'required': ['envelope_id'], 'properties': {'envelope_id': {'type': 'string', 'format': 'uuid', 'maxLength': 36, 'minLength': 36}}, 'additionalProperties': False}
get_sales_analytics
Get Sales Analytics
Sales pipeline analytics for the caller: probability-weighted forecast, per-stage $ rollup, win rate (won / decided, by count and by value), average sales-cycle days over won deals, and open-deal aging with a stale count. Read-only; computed from the caller's own deals. Requires authentication.
只读 幂等
输入模式
{'type': 'object', 'properties': {}, 'additionalProperties': False}
get_sales_recommendations
Get Sales Recommendations
The caller's prioritized next-best sales actions: interested leads to convert, open deals gone stale enough to need a follow-up, and overdue tasks — each with a rationale and the exact governed tool to run next (convert_lead_to_deal / log_deal_activity / complete_sales_task) plus its arguments. Read-only; ranks the caller's own CRM data (overdue > convert > follow-up). Nothing is executed or sent — approve an item by calling the named write tool. Requires authentication.
只读 幂等
输入模式
{'type': 'object', 'properties': {}, 'additionalProperties': False}
get_saved_view
Get Saved View
Fetch one saved ticket view's definition by id: its name, filters, columns, grouping, sort and whether it is shared. This returns the view itself, not the tickets it selects -- use execute_saved_view to run it. A view you cannot read is reported as not found rather than as forbidden, so this cannot be used to discover that someone else's view exists. Requires authentication and the tickets:read scope.
只读 幂等
输入模式
{'type': 'object', 'required': ['view_id'], 'properties': {'view_id': {'type': 'string', 'maxLength': 64, 'minLength': 1, 'description': "The view's id, from list_saved_views."}}, 'additionalProperties': False}
get_scope_baseline
Get Scope Baseline
Read frozen structural scope, estimates and captured explicit plans for an owned baseline. Older schema1 dates remain unknown. Requires tickets:read.
只读 幂等
输入模式
{'type': 'object', 'required': ['baseline_id'], 'properties': {'baseline_id': {'type': 'string', 'format': 'uuid'}}, 'additionalProperties': False}
get_session
Get Session
Get the full results of a previous Meta Council session, including all agent opinions and the synthesis.
只读 幂等
输入模式
{'type': 'object', 'required': ['session_id'], 'properties': {'session_id': {'type': 'string', 'description': 'The session ID to retrieve'}}, 'additionalProperties': False}
get_settings
Get Settings
Get the authenticated user's Meta Council settings — preferred model, plan tier, which credentials are saved (not live-verified), and the registry-backed tools that require, optionally use, or do not use account credentials. Names and booleans only, never secret values. Requires authentication.
只读 幂等
输入模式
{'type': 'object', 'properties': {}, 'additionalProperties': False}
get_site_analytics
Get Site Analytics
OPERATOR ONLY: visitor traffic for the META COUNCIL PLATFORM's own website — every visitor added together, NOT the caller's workspace (use get_workspace_metrics for that) and NOT the business rollup (use get_meta_council_platform_metrics for that). Requires both the platform:admin scope AND an ADMIN_EMAILS operator account; everyone else gets a permission error naming which of the two requirements failed. Covers a window of whole UTC days ending today, set by days. Returns human total views, unique visitors, the authenticated/anonymous split, the busiest public paths, the busiest in-app sections, top referrers and a per-day series, separate bot page/section view counts, plus the window it covers so the caller need not track what it asked for. Page paths and in-app sections are counted separately and are not comparable to one another. It never returns per-visitor rows, email addresses, IP hashes, user agents, session identifiers or query text — the rollup reports how many, never who. Optional digest_limit includes retained weekly aggregate snapshots and delivery counts; digest_before_week pages strictly before a scheduled Monday YYYY-MM-DD. This read never captures or sends a digest.
只读 幂等
输入模式
{'type': 'object', 'properties': {'days': {'type': 'integer', 'maximum': 365, 'minimum': 1, 'description': 'Whole UTC days to cover, ending today. Defaults to 7.'}, 'digest_limit': {'type': 'integer', 'maximum': 52, 'minimum': 1}, 'digest_before_week': {'type': 'string', 'pattern': '^[0-9]{4}-[0-9]{2}-[0-9]{2}$'}}, 'additionalProperties': False}
get_ticket_attention_policy
Get Ticket Attention Policy
Read the owner-private effective attention policy, built-in defaults, applicable statuses and immutable history. Requires tickets:read. limit 1–50 (default 20); exclusive before_revision. Earlier unrecorded history is unknown. No writes or providers.
只读 幂等
输入模式
{'type': 'object', 'required': [], 'properties': {'limit': {'type': 'integer', 'maximum': 50, 'minimum': 1}, 'before_revision': {'type': 'integer', 'maximum': 2147483647, 'minimum': 1}}, 'additionalProperties': False}
get_ticket_attention_queue
Get Ticket Attention Queue
Read the same ranked Needs attention queue as the browser and REST. Returns complete JSON with reasons, UTC clock evidence, effective owner policy thresholds and revision, approximation flags, unmet prerequisites and suggested next actions. Open active owned tickets only; limit 1–500 (default 100), offset 0–2147483647 (default 0). Continue with next_offset when has_more; refresh at offset 0. Membership/rank can shift between live pages. total_flagged/truncated disclose partial coverage. Filter reason before the limit, including missed_due_date with saved date/timezone/calendar/version after its entire local day. Weekends and status pauses never extend commitments; age is elapsed 24-hour days. Completion blockers have no age or threshold. Blocked work with unproven history remains visible with an unknown age and its configured threshold. Ranked by greatest known days over threshold, then ticket UUID; items with no elapsed clock sort last. No state changes, acknowledgments, notifications or provider calls. Requires tickets:read.
只读 幂等
输入模式
{'type': 'object', 'properties': {'limit': {'type': 'integer', 'maximum': 500, 'minimum': 1}, 'offset': {'type': 'integer', 'maximum': 2147483647, 'minimum': 0}, 'reason': {'enum': ['stale', 'aging', 'blocked', 'dependency_blocked', 'completion_blocked', 'missed_due_date', 'integration_drift', 'forecast_degradation'], 'type': 'string'}}, 'additionalProperties': False}
get_ticket_attention_resolution
Get Ticket Attention Resolution
Inspect original reviewed evidence, a separately labeled fresh assessment and immutable owner resolution history. Requires tickets:read. limit 1–50, exclusive before_revision. Current state always refers to the latest review; unavailable work is not proof of deletion or resolution.
只读 幂等
输入模式
{'type': 'object', 'required': ['ticket_id'], 'properties': {'limit': {'type': 'integer', 'default': 20, 'maximum': 50, 'minimum': 1}, 'ticket_id': {'type': 'string', 'format': 'uuid', 'maxLength': 36, 'minLength': 36}, 'before_revision': {'type': 'integer', 'maximum': 2147483647, 'minimum': 1}}, 'additionalProperties': False}
get_ticket_attention_review
Get Ticket Attention Review
Read the owner-private current attention assessment, latest review and immutable history. Requires tickets:read. History uses limit 1–50 (default 20) and exclusive before_revision; stays readable after ticket closure/archive/deletion. Evidence-changed and follow-up-due are separate states. Dates become due at start of their recorded IANA calendar day. No writes or providers.
只读 幂等
输入模式
{'type': 'object', 'required': ['ticket_id'], 'properties': {'limit': {'type': 'integer', 'maximum': 50, 'minimum': 1}, 'ticket_id': {'type': 'string', 'pattern': '^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$', 'maxLength': 36, 'minLength': 36}, 'before_revision': {'type': 'integer', 'maximum': 2147483647, 'minimum': 1}}, 'additionalProperties': False}
get_ticket_burndown
Get Ticket Burndown
Daily burndown series replayed from the append-only ticket ledger: per-day scope (existing, non-cancelled), remaining, done levels plus added/completed flows, with a summary. Optionally scope to one epic's current subtree via root_id. Backfill (legacy_snapshot) rows seed state but never count as additions. days clamps to 7-180 (default 30). Optionally pass target_date to overlay a straight-line plan: an ideal series descending from the window-start remaining to zero on that date, for reading actual against plan. Alternatively pass baseline_id for exact frozen-task planned/actual JSON with coverage; this uses the same cohort and excludes epic estimates and later additions.
只读 幂等
输入模式
{'type': 'object', 'properties': {'days': {'type': 'integer', 'maximum': 180, 'minimum': 7}, 'root_id': {'type': 'string', 'maxLength': 64}, 'baseline_id': {'type': 'string', 'format': 'uuid'}, 'target_date': {'type': 'string', 'maxLength': 32, 'description': 'Optional plan-line end date, YYYY-MM-DD. Must be strictly after the window start. Omitting it leaves the output exactly as it is without a plan line.'}}, 'additionalProperties': False}
get_ticket_delivery_plan
Get Ticket Delivery Plan
Read the explicit dated plan of an owned ticket, including archived or retained deleted-ticket plans. Absent plans remain unknown. Requires tickets:read.
只读 幂等
输入模式
{'type': 'object', 'required': ['ticket_id'], 'properties': {'ticket_id': {'type': 'string', 'format': 'uuid'}}, 'additionalProperties': False}
get_ticket_label_cohort
Get Ticket Label Cohort
Report a fixed cohort holding one exact label at the UTC window start, observed daily task completions/reopens, status and point coverage. Today's labels never rewrite history. end_date is exclusive; default today UTC. Bounded cursor pagination; unknown history is disclosed.
只读 幂等
输入模式
{'type': 'object', 'required': ['label'], 'properties': {'days': {'type': 'integer', 'maximum': 180, 'minimum': 1}, 'label': {'type': 'string', 'maxLength': 50, 'minLength': 1}, 'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1}, 'cursor': {'type': 'string', 'maxLength': 4096, 'minLength': 1}, 'end_date': {'type': 'string', 'pattern': '^[0-9]{4}-[0-9]{2}-[0-9]{2}$', 'maxLength': 10, 'minLength': 10}}, 'additionalProperties': False}
get_ticket_label_history
Get Ticket Label History
Read immutable owner-private observed label assignments/removals, revision bindings and legacy limits. Retains deleted tickets. Bounded cursor pagination; no provider or ticket changes.
只读 幂等
输入模式
{'type': 'object', 'required': ['ticket_id'], 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1}, 'cursor': {'type': 'string', 'maxLength': 4096, 'minLength': 1}, 'ticket_id': {'type': 'string', 'pattern': '^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$', 'maxLength': 36, 'minLength': 36}}, 'additionalProperties': False}
get_ticket_projects
Get Ticket Projects
Projects overview of the caller's board: one entry per top-level epic with recursive descendant progress (done %, counts by status, blocked, points, sub-epics, last activity), plus a triage strip of unrouted work (backlog + unassigned root tickets). Read-only, recomputed live. Use this before planning a session to see initiative health at a glance; use ticket_list/ticket_get to drill into any id it returns. Refuses more than 10,000 source tickets, 500 emitted root/sub-epic entries or a 256 KiB UTF-8 result; never returns partial totals.
只读 幂等
输入模式
{'type': 'object', 'properties': {}, 'additionalProperties': False}
get_ticket_provider_field_options
Get ticket provider field options
List eligible exact owner credential identities/generations and fixed origins for explicit field capture. Never returns secret material or contacts a provider. Configure credentials in Settings; this tool creates no credential or grant. Requires integrations:read and tickets:read.
只读 幂等
输入模式
{'type': 'object', 'required': ['ticket_id'], 'properties': {'ticket_id': {'type': 'string', 'format': 'uuid'}}, 'additionalProperties': False}
get_ticket_provider_field_request
Get ticket provider field request
Read this owner’s exact retained link/check/archive request result. An attempted/unknown request is not permission to repeat a remote read. A missing request does not prove an earlier save could not finish. No provider request. Requires tickets:read.
只读 幂等
输入模式
{'type': 'object', 'required': ['request_id'], 'properties': {'request_id': {'type': 'string', 'format': 'uuid'}}, 'additionalProperties': False}
get_visualization
Get Visualization
Fetch a chart artifact generated by a council session or LOCUS determination. Returns the machine-readable spec (the data behind the chart) plus the stable SVG URL, or the raw SVG itself with include_svg=true. Artifact ids appear in session results as 'visualizations' / 'visualization' reference blocks. Requires authentication and enforces the artifact owner's tenant boundary.
只读 幂等
输入模式
{'type': 'object', 'required': ['artifact_id'], 'properties': {'artifact_id': {'type': 'string', 'description': '32-hex artifact id from a visualization reference'}, 'include_svg': {'type': 'boolean', 'description': 'Also return the full SVG markup (default false)'}}, 'additionalProperties': False}
get_workflow_session
Get Workflow Session
Poll a previously started workflow run for its current step-by-step status and output (useful when run_workflow timed out or is awaiting a checkpoint). Also returns that run's definition_sha — the fingerprint of the definition it resolved when it started, comparable against the one plan_workflow reported. Requires authentication.
只读 幂等
输入模式
{'type': 'object', 'required': ['session_id'], 'properties': {'session_id': {'type': 'string', 'description': 'The workflow session ID returned by run_workflow.'}}, 'additionalProperties': False}
输出模式
{'type': 'object', 'required': ['text', 'execution'], 'properties': {'text': {'type': 'string'}, 'execution': {'type': ['object', 'null'], 'required': ['order', 'layers', 'dependency_graph', 'degraded_to_list_order', 'degradation_reason', 'parallelism_used'], 'properties': {'order': {'type': 'array', 'items': {'type': 'string'}}, 'layers': {'type': 'array', 'items': {'type': 'array', 'items': {'type': 'string'}}}, 'dependency_graph': {'type': 'object', 'additionalProperties': {'type': 'array', 'items': {'type': 'string'}}}, 'parallelism_used': {'type': 'boolean'}, 'degradation_reason': {'type': ['string', 'null']}, 'degraded_to_list_order': {'type': 'boolean'}}, 'description': 'The execution plan frozen at run creation, or null when the run recorded none. Never recomputed from the current template.', 'additionalProperties': False}}, 'additionalProperties': False}
get_workspace_metrics
Get Workspace Metrics
One cross-domain rollup of the caller's own workspace: council sessions (total, last 30 days, by status, tokens), feedback ratings, tickets (open/done), deals (count by stage, open pipeline value) and invoices (count by status, outstanding total, overdue count). Read-only, recomputed live, and scoped to the caller — it never aggregates across accounts. Amounts are labelled and grouped by recorded currency, never converted or added across currencies; unavailable currency or amount coverage is stated explicitly. Use it for a single 'how is this workspace doing' answer instead of calling the per-domain analytics tools one by one; use those (get_sales_analytics, get_ticket_projects, list_invoices) to drill into whatever this surfaces. Counts of unrecognised stages or statuses are reported under 'unknown' rather than dropped, so each breakdown sums to its own total. Note that open + done need not equal the ticket total: cancelled tickets are neither. Invoice overdue status is computed at read time by comparing due dates against now, not stored on the record, so it is current as of this call and an invoice due today does not yet count as overdue.
只读 幂等
输入模式
{'type': 'object', 'properties': {}, 'additionalProperties': False}
initialize_consulting_milestones
Initialize Consulting Milestones
Idempotently initialize stable engagement milestones. Retries return the same ids and external refs.
输入模式
{'type': 'object', 'required': ['engagement_id'], 'properties': {'milestones': {'type': 'array', 'items': {'type': 'object', 'required': ['key', 'title'], 'properties': {'key': {'type': 'string', 'pattern': '^[a-z0-9][a-z0-9_-]{0,79}$'}, 'title': {'type': 'string', 'maxLength': 300, 'minLength': 1}, 'due_date': {'type': 'string', 'format': 'date'}, 'description': {'type': 'string', 'maxLength': 8000}, 'order_index': {'type': 'integer', 'maximum': 10000, 'minimum': 0}}, 'additionalProperties': False}, 'maxItems': 10}, 'engagement_id': {'type': 'string', 'format': 'uuid'}}, 'additionalProperties': False}
link_ticket_provider_fields
Link ticket provider fields
Link and check one explicitly selected remote item. GitHub container owner/repo + issue number; GitLab project numeric ID + issue iid; Azure organization/project UUID + work item ID; Asana workspace gid + task gid; Jira project key + issue key; Linear team UUID + issue UUID. New providers require exact configured credential_id; Jira/Linear use existing owner Settings credentials. Fixed hosted origins only, no remote writes. Immutable IDs are pinned only after a matching response. Reuse the exact request_id/arguments after lost replies; unknown attempts never redispatch. Requires integrations:read and tickets:write.
可访问外部资源 幂等
输入模式
{'type': 'object', 'required': ['ticket_id', 'provider', 'request_id', 'expected_revision', 'target'], 'properties': {'target': {'type': 'object', 'required': ['container', 'item'], 'properties': {'item': {'type': 'string', 'maxLength': 80, 'minLength': 1}, 'container': {'type': 'string', 'maxLength': 200, 'minLength': 1}}, 'additionalProperties': False}, 'provider': {'enum': ['github', 'gitlab', 'azure_devops', 'asana', 'jira', 'linear'], 'type': 'string'}, 'ticket_id': {'type': 'string', 'format': 'uuid'}, 'request_id': {'type': 'string', 'format': 'uuid'}, 'credential_id': {'anyOf': [{'type': 'string', 'format': 'uuid'}, {'type': 'null'}]}, 'expected_revision': {'type': 'integer', 'maximum': 2147483646, 'minimum': 0}}, 'additionalProperties': False}
list_accounting_runs
List Accounting Runs
List only the caller's private Accounting-run audit metadata, newest first. Raw source text and analysis results are intentionally omitted.
只读 幂等
输入模式
{'type': 'object', 'properties': {'limit': {'type': 'integer', 'default': 50, 'maximum': 200, 'minimum': 1}, 'offset': {'type': 'integer', 'default': 0, 'minimum': 0}, 'status': {'enum': ['pending', 'running', 'completed', 'failed'], 'type': 'string'}}, 'additionalProperties': False}
list_agents
List Agents
List all available expert agents with their roles, domains, and specialties.
只读 幂等
输入模式
{'type': 'object', 'properties': {'domain': {'type': 'string', 'description': "Filter agents by domain (e.g., 'finance', 'technology', 'healthcare')"}}, 'additionalProperties': False}
list_approvals
List Approvals
List workflow checkpoints waiting on you, soonest deadline first, with which step is paused and when it runs out. Defaults to the pending ones. Requires authentication and the workflows:read scope.
只读 幂等
输入模式
{'type': 'object', 'properties': {'status': {'enum': ['pending', 'resolved', 'expired', 'superseded'], 'type': 'string', 'description': 'Which lifecycle status to list. Defaults to pending -- the ones still waiting for an answer.'}}, 'additionalProperties': False}
list_attention_notification_deliveries
List Attention Notification Deliveries
List owned notification delivery metadata by optional rule and current state. No URL paths or signing secrets. Follow next_before_id while has_more; live state may change. Requires tickets:read.
只读 幂等
输入模式
{'type': 'object', 'required': [], 'properties': {'limit': {'type': 'integer', 'default': 20, 'maximum': 100, 'minimum': 1}, 'state': {'enum': ['all', 'pending', 'attempting', 'delivered', 'retryable', 'uncertain', 'failed', 'cancelled', 'received'], 'type': 'string'}, 'rule_id': {'type': 'string', 'format': 'uuid'}, 'before_id': {'type': 'string', 'format': 'uuid'}}, 'additionalProperties': False}
list_attention_notification_revisions
List Attention Notification Revisions
Read immutable notification configuration revisions, including private destination URLs and frozen selection, newest revision first. Follow next_before_revision while has_more. Requires notifications:manage; no signing secrets.
只读 幂等
输入模式
{'type': 'object', 'required': ['rule_id'], 'properties': {'limit': {'type': 'integer', 'default': 20, 'maximum': 100, 'minimum': 1}, 'rule_id': {'type': 'string', 'format': 'uuid'}, 'before_revision': {'type': 'integer', 'maximum': 2147483647, 'minimum': 1}}, 'additionalProperties': False}
list_attention_notification_rules
List Attention Notification Rules
List owned notification metadata without destination paths or signing secrets. Scope active includes paused unarchived rules; archived/all also available. Follow next_before_id while has_more; membership is live. Requires tickets:read.
只读 幂等
输入模式
{'type': 'object', 'required': [], 'properties': {'limit': {'type': 'integer', 'default': 20, 'maximum': 100, 'minimum': 1}, 'scope': {'enum': ['active', 'archived', 'all'], 'type': 'string'}, 'before_id': {'type': 'string', 'format': 'uuid'}}, 'additionalProperties': False}
list_booking_followups
List Booking Follow-ups
Read owner-only in-app meeting prompts or due follow-up tasks. Matches the app view and uses current task due/done state; page membership can change. No message or Calendar change is sent.
只读 幂等
输入模式
{'type': 'object', 'required': ['view', 'after', 'limit'], 'properties': {'view': {'enum': ['upcoming', 'outcomes', 'due'], 'type': 'string'}, 'after': {'anyOf': [{'type': 'string', 'format': 'uuid', 'maxLength': 36}, {'type': 'null'}]}, 'limit': {'type': 'integer', 'maximum': 50, 'minimum': 1}}, 'additionalProperties': False}
list_bookings
List Bookings
Read an owner-only page of up to 50 bookings. Continue with next_after; archived defaults to false. Includes recipient details, never manage credentials or raw Calendar access.
只读 幂等
输入模式
{'type': 'object', 'required': [], 'properties': {'after': {'type': 'string', 'format': 'uuid', 'maxLength': 36}, 'archived': {'type': 'boolean'}}, 'additionalProperties': False}
list_campaign_replies
List Campaign Replies
List sent / received emails for an outreach campaign, newest first — subject, body preview, and reply classification. Requires authentication.
只读 幂等
输入模式
{'type': 'object', 'required': ['campaign_id'], 'properties': {'limit': {'type': 'integer', 'description': 'Max rows (default 50, max 200).'}, 'direction': {'type': 'string', 'description': "'inbound' (replies from prospects — the default), 'outbound' (sent), or '' for all."}, 'campaign_id': {'type': 'string', 'description': 'Campaign UUID (from list_outreach_campaigns).'}}, 'additionalProperties': False}
list_campaign_triggers
List Campaign Triggers
List automation triggers (auto-reply rules, status updates, notifications) configured for an outreach campaign. Requires authentication.
只读 幂等
输入模式
{'type': 'object', 'required': ['campaign_id'], 'properties': {'campaign_id': {'type': 'string', 'description': 'Campaign UUID (from list_outreach_campaigns).'}}, 'additionalProperties': False}
list_comparison_sets
List Comparison Sets
List your comparison sets, newest first, without their membership. Requires comparisons:read.
只读 幂等
输入模式
{'type': 'object', 'required': [], 'properties': {}, 'additionalProperties': False}
list_consulting_clients
List Consulting Clients
List consulting clients owned by the API-key account.
只读 幂等
输入模式
{'type': 'object', 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1}, 'status': {'enum': ['active', 'inactive'], 'type': 'string'}}, 'additionalProperties': False}
list_consulting_engagements
List Consulting Engagements
List consulting engagements owned by the API-key account.
只读 幂等
输入模式
{'type': 'object', 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1}, 'status': {'enum': ['draft', 'active', 'on_hold', 'completed', 'cancelled'], 'type': 'string'}, 'client_id': {'type': 'string', 'format': 'uuid'}}, 'additionalProperties': False}
list_content_assets
List Content Assets
List owned content assets and immutable revisions; content is never published by this tool.
只读 幂等
输入模式
{'type': 'object', 'properties': {'limit': {'type': 'integer', 'maximum': 500, 'minimum': 1}, 'campaign_id': {'type': 'string', 'description': 'Full UUID from the matching list tool.'}, 'approval_state': {'enum': ['draft', 'pending_approval', 'approved', 'rejected'], 'type': 'string'}, 'include_archived': {'type': 'boolean'}}, 'additionalProperties': False}
list_deals
List Deals
List the caller's sales deals (newest first) together with a weighted pipeline forecast (open/weighted/won totals). Optionally filter by stage or lead_id. Deals are private to the API-key owner.
只读 幂等
输入模式
{'type': 'object', 'properties': {'stage': {'enum': ['qualification', 'discovery', 'proposal', 'negotiation', 'closed_won', 'closed_lost'], 'type': 'string', 'description': 'Optional stage filter.'}, 'lead_id': {'type': 'string', 'description': 'Optional: only deals linked to this lead.'}}, 'additionalProperties': False}
list_feature_forecasts
List Feature Forecasts
Page owned immutable capture identities for an epic, including one later deleted. Default limit20, maximum50. Continue with next_before_id while has_more. This metadata list does not replay inputs; use get_feature_forecast for verification. No automatic captures.
只读 幂等
输入模式
{'type': 'object', 'required': ['root_id'], 'properties': {'limit': {'type': 'integer', 'maximum': 50, 'minimum': 1}, 'root_id': {'type': 'string', 'format': 'uuid'}, 'before_id': {'type': 'string', 'format': 'uuid'}}, 'additionalProperties': False}
list_integrations
List Integrations
List which outside services the authenticated user has connected — ticket boards, stored connector credentials (name, kind, whether configured, and when last verified) and the connectors available to call them. Returns configured / not configured facts, names and dates ONLY, and never returns a secret value. Read this before planning a workflow that reaches an external service, so a step is not written against a credential the user has not registered. Requires authentication.
只读 幂等
输入模式
{'type': 'object', 'required': [], 'properties': {}, 'additionalProperties': False}
list_invoices
List Invoices
List the caller's invoices (newest first), optionally filtered by status (draft/sent/paid/void). Each entry includes its computed overdue flag.
只读 幂等
输入模式
{'type': 'object', 'properties': {'status': {'enum': ['draft', 'sent', 'paid', 'void'], 'type': 'string', 'description': 'Optional status filter.'}}, 'additionalProperties': False}
list_marketing_audiences
List Marketing Audiences
List reusable marketing audiences owned by the API-key account.
只读 幂等
输入模式
{'type': 'object', 'properties': {}, 'additionalProperties': False}
list_marketing_brands
List Marketing Brands
List brand identities owned by the API-key account.
只读 幂等
输入模式
{'type': 'object', 'properties': {}, 'additionalProperties': False}
list_marketing_campaigns
List Marketing Campaigns
List owned marketing campaigns. These are separate from Sales outreach campaigns.
只读 幂等
输入模式
{'type': 'object', 'properties': {'status': {'enum': ['draft', 'planned', 'active', 'paused', 'completed', 'archived'], 'type': 'string'}, 'include_archived': {'type': 'boolean'}}, 'additionalProperties': False}
list_meeting_types
List Meeting Types
Read the owner's bounded saved meeting types, including inactive types. Does not activate booking or expose Calendar credentials.
只读 幂等
输入模式
{'type': 'object', 'required': [], 'properties': {}, 'additionalProperties': False}
list_meta_council_feedback
List Meta Council Feedback
ADMIN ONLY: list platform-feedback reports — feedback about Meta Council itself, never a tenant's own business data — across all users for triage (requires an ADMIN_EMAILS account; everyone else gets a permission error). Filter by status, category, or severity.
只读 幂等
输入模式
{'type': 'object', 'properties': {'limit': {'type': 'integer', 'maximum': 500, 'minimum': 1}, 'status': {'enum': ['new', 'triaged', 'planned', 'resolved', 'dismissed'], 'type': 'string'}, 'category': {'enum': ['performance', 'missing_feature', 'bug', 'ux', 'docs', 'general'], 'type': 'string'}, 'severity': {'enum': ['blocker', 'major', 'minor', 'suggestion'], 'type': 'string'}}, 'additionalProperties': False}
list_monitors
List Monitors
List the standing watches you have saved, newest first, with what each one watches, what it does, and when it last fired. Requires authentication and the monitors:read scope.
只读 幂等
输入模式
{'type': 'object', 'properties': {}, 'additionalProperties': False}
list_outreach_campaigns
List Outreach Campaigns
List the authenticated user's outreach campaigns with current lead counts and recorded sent/replied workflow labels, not independently verified delivery or human-reply totals. Requires authentication.
只读 幂等
输入模式
{'type': 'object', 'properties': {}, 'additionalProperties': False}
list_panels
List Panels
List all available expert panels with their descriptions and agent counts.
只读 幂等
输入模式
{'type': 'object', 'properties': {}, 'additionalProperties': False}
list_portfolio_report_history
List Portfolio Report History
Browse owned saved reports in portfolio (default), project or all scopes, newest first. Project scope requires project_id. Each report supplies its immutable ID and payload hash for comparisons or replacement declarations. Continue with next_before_id while has_more; omit the cursor to refresh newest captures. Counts are stored rollups, not accuracy or approval claims. tickets:read.
只读 幂等
输入模式
{'type': 'object', 'required': [], 'properties': {'limit': {'type': 'integer', 'default': 20, 'maximum': 200, 'minimum': 1}, 'scope': {'enum': ['portfolio', 'project', 'all'], 'type': 'string'}, 'before_id': {'type': 'string', 'format': 'uuid', 'maxLength': 36, 'minLength': 36}, 'project_id': {'type': 'string', 'format': 'uuid', 'maxLength': 36, 'minLength': 36}}, 'additionalProperties': False}
list_portfolio_report_shares
List Portfolio Report Shares
List owned report links in newest creation-time/ID order, optionally for one owned report. Scope all, active, expired or revoked is live on each page. Follow next_before_id while has_more; refresh newest for changes. Metadata contains no bearer secret. Requires tickets:read.
只读 幂等
输入模式
{'type': 'object', 'required': [], 'properties': {'limit': {'type': 'integer', 'default': 20, 'maximum': 100, 'minimum': 1}, 'scope': {'enum': ['all', 'active', 'expired', 'revoked'], 'type': 'string', 'default': 'all'}, 'before_id': {'type': 'string', 'format': 'uuid'}, 'snapshot_id': {'type': 'string', 'format': 'uuid'}}, 'additionalProperties': False}
list_portfolio_schedule_captures
List Portfolio Schedule Captures
Read successful captures for one owned report schedule, including scheduled_for, actual captured_at, missed_count and the exact retained snapshot identity/hash. Downtime coalesces to one current capture, never fabricated historical counts. Follow next_before_id while has_more; report readers and exports open snapshot_id. Requires tickets:read.
只读 幂等
输入模式
{'type': 'object', 'required': ['schedule_id'], 'properties': {'limit': {'type': 'integer', 'default': 20, 'maximum': 100, 'minimum': 1}, 'before_id': {'type': 'string', 'format': 'uuid'}, 'schedule_id': {'type': 'string', 'format': 'uuid'}}, 'additionalProperties': False}
list_portfolio_schedule_revisions
List Portfolio Schedule Revisions
Read immutable definition revisions of one owned report schedule, including paused or archived schedules. Newest revision first; follow next_before_revision while has_more. No capture or state change. Requires tickets:read.
只读 幂等
输入模式
{'type': 'object', 'required': ['schedule_id'], 'properties': {'limit': {'type': 'integer', 'default': 20, 'maximum': 100, 'minimum': 1}, 'schedule_id': {'type': 'string', 'format': 'uuid'}, 'before_revision': {'type': 'integer', 'maximum': 2147483647, 'minimum': 1}}, 'additionalProperties': False}
list_portfolio_schedules
List Portfolio Schedules
List the caller's private report schedules in newest creation-time/ID order. Active includes paused schedules. Follow next_before_id while has_more; current archive membership is rechecked on each live page. Requires tickets:read.
只读 幂等
输入模式
{'type': 'object', 'required': [], 'properties': {'limit': {'type': 'integer', 'default': 20, 'maximum': 100, 'minimum': 1}, 'scope': {'enum': ['active', 'archived', 'all'], 'type': 'string', 'default': 'active'}, 'before_id': {'type': 'string', 'format': 'uuid'}}, 'additionalProperties': False}
list_portfolio_snapshot_notes
List Portfolio Snapshot Notes
Read the decision and comment thread recorded against one of your portfolio snapshots, oldest first. Each note carries the snapshot content hash it was written against plus binding_intact comparing that hash to the snapshot's hash now, so a note can be read as evidence of what was actually on the screen when it was written. Counts are over the notes actually returned, so a truncated page never reports a total it did not show. Continue with next_after_id as after_note_id when has_more is true. New notes can arrive between pages; restart to refresh the thread. This reads the thread; it does not approve, reject or block anything. Requires authentication and the tickets:read scope.
只读 幂等
输入模式
{'type': 'object', 'required': ['snapshot_id'], 'properties': {'limit': {'type': 'integer', 'default': 100, 'maximum': 500, 'minimum': 1, 'description': 'How many notes to return. Defaults to 100.'}, 'snapshot_id': {'type': 'string', 'maxLength': 64, 'minLength': 1, 'description': "The snapshot's id, from list_portfolio_snapshots."}, 'after_note_id': {'type': 'string', 'format': 'uuid', 'description': 'Continue after this note in the same owned snapshot, using next_after_id.'}}, 'additionalProperties': False}
list_portfolio_snapshots
List Portfolio Snapshots
List your own portfolio (default), project or all snapshots, newest first. Project scope requires project_id: the immutable rollups of how your ticket portfolio stood at the moments you captured them. Each carries its label, schema version, stored payload, content hash, recording actor and creation time. Snapshots are owner-private and never span accounts. Returns the same payload the web app's snapshot list returns. Requires authentication and the tickets:read scope.
只读 幂等
输入模式
{'type': 'object', 'properties': {'limit': {'type': 'integer', 'default': 50, 'maximum': 200, 'minimum': 1, 'description': 'How many snapshots to return. Defaults to 50.'}, 'scope': {'enum': ['portfolio', 'project', 'all'], 'type': 'string'}, 'project_id': {'type': 'string', 'format': 'uuid'}}, 'additionalProperties': False}
list_report_review_declarations
List Report Review Declarations
Read the append-only owner declaration history and current derived head for one exact review record. Approval is an owner declaration, not independent review, signature, sharing or legal-hold authority. Only a JWT owner session can approve or withdraw. Requires tickets:read.
只读 幂等
输入模式
{'type': 'object', 'required': ['envelope_id'], 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1}, 'before_id': {'type': 'string', 'format': 'uuid', 'maxLength': 36, 'minLength': 36}, 'envelope_id': {'type': 'string', 'format': 'uuid', 'maxLength': 36, 'minLength': 36}}, 'additionalProperties': False}
list_report_review_envelopes
List Report Review Envelopes
List immutable review records for one owned saved snapshot, newest first. Limit 1–100; use next_before_id while has_more. Records preserve review-time interpretation, not original-capture definitions. Requires tickets:read.
只读 幂等
输入模式
{'type': 'object', 'required': ['snapshot_id'], 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1}, 'before_id': {'type': 'string', 'format': 'uuid', 'maxLength': 36, 'minLength': 36}, 'snapshot_id': {'type': 'string', 'format': 'uuid', 'maxLength': 36, 'minLength': 36}}, 'additionalProperties': False}
list_reviewed_attention
List Reviewed Attention
Discover latest owned attention reviews, including cleared, terminal, archived and unavailable work. Requires tickets:read. Filter unresolved (including withdrawn), resolved or all; independently set follow_up=due for saved follow-ups whose stored UTC instant has arrived. Due pages sort oldest first and retain their cutoff; refresh without a cursor for newly due work. Latest-review and declaration membership remain live. limit 1–50, owner/filter-bound cursor. Current ticket metadata is separate from retained reviewed evidence. No queue filtering or providers.
只读 幂等
输入模式
{'type': 'object', 'required': [], 'properties': {'limit': {'type': 'integer', 'default': 20, 'maximum': 50, 'minimum': 1}, 'state': {'enum': ['unresolved', 'resolved', 'all'], 'type': 'string', 'default': 'unresolved'}, 'cursor': {'type': 'string', 'maxLength': 2048, 'minLength': 1}, 'follow_up': {'enum': ['all', 'due'], 'type': 'string', 'default': 'all'}}, 'additionalProperties': False}
list_sales_tasks
List Sales Tasks
List the caller's open sales tasks (activities of type 'task' not yet done), bucketed overdue / today / upcoming and ordered most-urgent-first with per-bucket counts. Close one with complete_sales_task.
只读 幂等
输入模式
{'type': 'object', 'properties': {}, 'additionalProperties': False}
list_saved_views
List Saved Views
List saved ticket views you can open: the stored filter, column, grouping and sort combinations saved by you, plus any shared with a team you belong to. Shared views appear under the active and all scopes and never once archived, because an owner's archive is their own working state. Returns the same payload the web app's saved-view list returns. Requires authentication and the tickets:read scope. Pages use immutable creation-time/ID order; follow next_cursor while has_more. Current permissions and archive state are rechecked on every page; this is live metadata.
只读 幂等
输入模式
{'type': 'object', 'properties': {'limit': {'type': 'integer', 'default': 50, 'maximum': 200, 'minimum': 1, 'description': 'How many views per page. Defaults to 50.'}, 'scope': {'enum': ['active', 'archived', 'all'], 'type': 'string', 'description': 'Which of YOUR OWN views to include: active (the default, excluding archived), archived (your recovery list), or all. Shared views are unaffected by archived and never appear under it.'}, 'cursor': {'type': 'string', 'maxLength': 1024, 'minLength': 1, 'description': 'Opaque next_cursor from the same caller and scope; expires after 24 hours. Omit to refresh.'}}, 'additionalProperties': False}
list_scope_baselines
List Scope Baselines
List saved baselines for an owned delivery group, newest first. Includes retained baselines after group deletion. Requires tickets:read.
只读 幂等
输入模式
{'type': 'object', 'required': ['root_id'], 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1}, 'root_id': {'type': 'string', 'format': 'uuid'}, 'before_id': {'type': 'string', 'format': 'uuid'}}, 'additionalProperties': False}
list_ticket_delivery_plan_history
List Ticket Delivery Plan History
Read immutable plan revisions, newest first, including retained deleted-ticket history. Continue with next_before_version. Requires tickets:read.
只读 幂等
输入模式
{'type': 'object', 'required': ['ticket_id'], 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1}, 'ticket_id': {'type': 'string', 'format': 'uuid'}, 'before_version': {'type': 'integer', 'maximum': 2147483647, 'minimum': 1}}, 'additionalProperties': False}
list_ticket_provider_effects
List ticket provider effects
Read bounded retained export and transition outcomes for an owned ticket. Requires tickets:read (or tickets:write). Follow next_before_id while has_more. Returns metadata only, never encrypted payloads, credentials or fresh provider state. Intent IDs identify original uncertain operations; historical outcomes are not permission to resend.
只读 幂等
输入模式
{'type': 'object', 'required': ['ticket_id'], 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1}, 'provider': {'enum': ['jira', 'linear'], 'type': 'string'}, 'before_id': {'type': 'string', 'format': 'uuid'}, 'ticket_id': {'type': 'string', 'format': 'uuid'}}, 'additionalProperties': False}
list_ticket_provider_fields
List ticket provider fields
Read a bounded page of encrypted owner-private field captures (decrypted only for their owner), exact target coordinates and current local comparison. Default20, maximum50; use next_before_id while has_more. Includes retained source-deletion history. Recent means checked within24hours, not live state. No provider request. Requires tickets:read.
只读 幂等
输入模式
{'type': 'object', 'required': ['ticket_id'], 'properties': {'limit': {'type': 'integer', 'maximum': 50, 'minimum': 1}, 'before_id': {'type': 'string', 'format': 'uuid'}, 'ticket_id': {'type': 'string', 'format': 'uuid'}}, 'additionalProperties': False}
list_ticket_provider_observations
List ticket provider observations
Read owner-private retained Jira/Linear status observations and effect evidence, optionally scoped to a ticket/provider. Includes deleted-ticket history. Follow next_before_id while has_more, limit 1–100. Requires tickets:read or tickets:write; no provider request or credential decryption. Historical checks are not proof of current remote state.
只读 幂等
输入模式
{'type': 'object', 'required': [], 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1}, 'provider': {'enum': ['jira', 'linear'], 'type': 'string'}, 'before_id': {'type': 'string', 'format': 'uuid'}, 'ticket_id': {'type': 'string', 'format': 'uuid'}}, 'additionalProperties': False}
list_workflows
List Workflows
List available multi-step workflow pipelines (composable bundles that chain several steps, each able to run on its own model/provider). Returns each workflow's slug, description, per-step model, and definition_sha — a fingerprint of that definition as loaded right now, comparable against the definition_sha reported by a run you start later.
只读 幂等
输入模式
{'type': 'object', 'properties': {}, 'additionalProperties': False}
locus_determine_from_scores
Locus Determine From Scores
Compute a LOCUS Level of Care from dimension ratings you already have. Deterministic — no LLM, instant: composite + Determination Grid + the inviolable override floors (e.g. Risk-of-Harm=4 → minimum Level 5), applied in code. Provide EITHER the seven flat D* ratings (1-5 each; Dimension IV splits into IV-A Stress / IV-B Support) OR a per-reviewer agent_scores map. Sending both is refused (422) rather than scored: agent_scores would win and your flat ratings would be discarded, override floors included. Requires authentication.
只读 幂等
输入模式
{'type': 'object', 'properties': {'D4A_Stress': {'type': 'integer', 'maximum': 5, 'minimum': 1, 'description': 'Recovery Environment — Stress (1-5).'}, 'D4B_Support': {'type': 'integer', 'maximum': 5, 'minimum': 1, 'description': 'Recovery Environment — Support (1-5).'}, 'agent_scores': {'type': 'object', 'description': 'Per-reviewer scores keyed by reviewer name, aggregated by median. Shape: {"<reviewer>": {"D1_RiskOfHarm": 4, ...}}. Mutually exclusive with the flat D* fields — sending both is refused (422), not merged. An empty map {} counts as not supplied.'}, 'D1_RiskOfHarm': {'type': 'integer', 'maximum': 5, 'minimum': 1, 'description': 'Risk of Harm (1-5).'}, 'D6_Engagement': {'type': 'integer', 'maximum': 5, 'minimum': 1, 'description': 'Engagement & Recovery Status (1-5).'}, 'D3_CoMorbidity': {'type': 'integer', 'maximum': 5, 'minimum': 1, 'description': 'Medical/Addictive/Psychiatric Co-Morbidity (1-5). Capital M in CoMorbidity.'}, 'D2_FunctionalStatus': {'type': 'integer', 'maximum': 5, 'minimum': 1, 'description': 'Functional Status (1-5).'}, 'D5_TreatmentHistory': {'type': 'integer', 'maximum': 5, 'minimum': 1, 'description': 'Treatment & Recovery History (1-5).'}}, 'additionalProperties': False}
log_deal_activity
Log Deal Activity
Log an activity on a deal (or lead) — a note/call/meeting/email, or a follow-up task with a due date. Pass deal_id and/or lead_id (each must be owned by the caller). type defaults to 'note'; for a task set type='task' and a due_date (YYYY-MM-DD). Tasks appear in list_sales_tasks.
输入模式
{'type': 'object', 'properties': {'body': {'type': 'string'}, 'done': {'type': 'boolean', 'description': 'Mark a task already done.'}, 'type': {'enum': ['note', 'call', 'meeting', 'email', 'task'], 'type': 'string', 'description': 'note|call|meeting|email|task (default note).'}, 'deal_id': {'type': 'string', 'description': 'Owned deal to attach to.'}, 'lead_id': {'type': 'string', 'description': 'Owned lead to attach to.'}, 'subject': {'type': 'string', 'maxLength': 255}, 'due_date': {'type': 'string', 'description': 'ISO date YYYY-MM-DD (for tasks).'}}, 'additionalProperties': False}
mark_invoice_paid
Mark Invoice Paid
Mark a draft or sent invoice as paid (stamps paid_at). Cannot be applied to a void invoice. invoice_id is required.
输入模式
{'type': 'object', 'required': ['invoice_id'], 'properties': {'invoice_id': {'type': 'string'}}, 'additionalProperties': False}
mint_child_api_key
Mint Child Api Key
Mint a short-lived child API key for a delegated subtask. The child can never exceed the calling key: requested scopes must be a subset of what the caller holds, its expiry is capped by the caller's, and it may never itself mint keys (delegation is exactly one level deep). A caller whose own scopes were never recorded explicitly cannot delegate at all until it rotates first. The child key is returned exactly once in the response and cannot be retrieved again; revoking the parent immediately revokes the child. Requires the keys:mint scope.
输入模式
{'type': 'object', 'required': ['scopes'], 'properties': {'name': {'type': 'string', 'description': "Label for the child key (default 'delegated key')."}, 'scopes': {'type': 'array', 'items': {'type': 'string'}, 'description': "Scopes to grant the child. Must be a subset of the calling key's own scopes and may not include keys:mint."}, 'expires_in_minutes': {'type': 'integer', 'maximum': 1440, 'minimum': 1, 'description': 'Child lifetime in minutes (default 60, maximum 1440).'}}, 'additionalProperties': False}
outreach_analytics
Outreach Analytics
Outreach summary for the user — total leads, recorded status counts/ratios and incomplete outcome evidence. Requires authentication.
只读 幂等
输入模式
{'type': 'object', 'properties': {}, 'additionalProperties': False}
pause_attention_notification_rule
Pause Attention Notification Rule
Pause an owned notification rule using current expected_revision; archived=true also archives it, archived=false restores it paused. Cancels future eligible sends from that activation, preserving prior outcomes. Requires notifications:manage; no human approval needed to reduce delivery. Exact request_id retries return the original receipt.
幂等
输入模式
{'type': 'object', 'title': 'Pause', 'required': ['request_id', 'expected_revision', 'rule_id'], 'properties': {'rule_id': {'type': 'string', 'format': 'uuid'}, 'archived': {'type': 'boolean', 'title': 'Archived', 'default': False}, 'request_id': {'type': 'string', 'title': 'Request Id', 'format': 'uuid'}, 'expected_revision': {'type': 'integer', 'title': 'Expected Revision', 'maximum': 2147483646, 'minimum': 1}}, 'additionalProperties': False}
plan_council
Plan Council
Resolve the effective Council models, parameters, tools, and setup reasons for this account without starting a session, calling a provider, or recording usage.
只读 幂等
输入模式
{'type': 'object', 'required': ['query'], 'properties': {'model': {'type': 'string', 'description': 'Optional model override for every Council agent'}, 'panel': {'type': 'string', 'description': 'Panel slug; omit to use the default panel'}, 'query': {'type': 'string', 'description': 'The question used for panel selection'}}, 'additionalProperties': False}
plan_workflow
Plan Workflow
Preview what a workflow WOULD do, without running it. Costs nothing and runs no models: returns the step execution order, each step's role/model/max_tokens and whether it pauses for a human checkpoint, the workflow's declared parameters (validated if you supply values), which required integrations your account already has credentials on file for, an upper-bound cost estimate, and definition_sha — a fingerprint of the definition this plan was built from, which tells you whether the definition changed between planning and running but never hands back the definition itself. Starts no session and records no usage. Use before run_workflow to check a pipeline fits before spending on it. Requires authentication.
只读 幂等
输入模式
{'type': 'object', 'required': ['workflow'], 'properties': {'workflow': {'type': 'string', 'description': "The workflow slug (from list_workflows), e.g. 'due_diligence'."}, 'parameters': {'type': 'object', 'description': 'Optional values for the workflow\'s declared parameters, as a flat name-to-value object, e.g. {"region": "EU"}. Supply them to have them validated; omit to skip validation.', 'additionalProperties': True}, 'step_models': {'type': 'object', 'description': 'Optional per-run model choices, keyed by zero-based step index (for example {"0": "claude-sonnet-4-6"}). Uses the same catalog validation as run_workflow; send the same choices when starting. Does not change the saved template or grant provider access.', 'additionalProperties': {'type': 'string'}}}, 'additionalProperties': False}
preview_accounting_ticket_sync
Preview Accounting Ticket Sync
Preview, without writing, how one completed owned Accounting run's WRITEOff work plan would map to stable Meta Council tickets. Reports creates, updates, unchanged tickets, human-edited generated fields that will be preserved, and identity conflicts. Requires both accounting:read and tickets:read; tickets:write also satisfies the ticket-read grant. Preview before committing because tickets are not field-encrypted; work-plan text may reproduce source-derived snippets or parser details, and after commit tickets:read can read it without accounting:read. Check the item count before committing. Statement-derived runs currently plan one ticket per unclassified transaction line, so a several-hundred-row statement plans several hundred tickets. When the count is large, report it and confirm with the owner rather than committing a board-flooding sync.
只读 幂等
输入模式
{'type': 'object', 'required': ['run_id'], 'properties': {'run_id': {'type': 'string', 'format': 'uuid', 'maxLength': 36, 'minLength': 36}}, 'additionalProperties': False}
preview_attention_notification_rule
Preview Attention Notification Rule
Preview a draft definition or one owned saved notification rule, never both. Lists the exact selected public notification fields and current canonical matches; page all matches by next_before_id. Copied saved-view selection is frozen on save. Creates no notification or external call. Requires notifications:manage.
只读 幂等
输入模式
{'type': 'object', 'oneOf': [{'required': ['definition'], 'properties': {'rule_id': {'type': 'null'}, 'definition': {'type': 'object'}}}, {'required': ['rule_id'], 'properties': {'rule_id': {'type': 'string', 'format': 'uuid'}, 'definition': {'type': 'null'}}}], 'title': 'Preview', 'properties': {'limit': {'type': 'integer', 'title': 'Limit', 'default': 20, 'maximum': 100, 'minimum': 1}, 'rule_id': {'anyOf': [{'type': 'string', 'format': 'uuid'}, {'type': 'null'}], 'title': 'Rule Id', 'default': None}, 'before_id': {'anyOf': [{'type': 'string', 'format': 'uuid'}, {'type': 'null'}], 'title': 'Before Id', 'default': None}, 'definition': {'anyOf': [{'type': 'object', 'title': 'Definition', 'required': ['name', 'selector', 'quiet_hours', 'destinations', 'stages'], 'properties': {'name': {'type': 'string', 'title': 'Name', 'maxLength': 200, 'minLength': 1}, 'stages': {'type': 'array', 'items': {'type': 'object', 'title': 'Stage', 'required': ['key', 'name', 'after_minutes', 'destination_key'], 'properties': {'key': {'type': 'string', 'title': 'Key', 'pattern': '^[a-z][a-z0-9_-]{0,31}$', 'maxLength': 32, 'minLength': 1}, 'name': {'type': 'string', 'title': 'Name', 'maxLength': 200, 'minLength': 1}, 'after_minutes': {'type': 'integer', 'title': 'After Minutes', 'maximum': 10080, 'minimum': 0}, 'destination_key': {'type': 'string', 'title': 'Destination Key', 'pattern': '^[a-z][a-z0-9_-]{0,31}$', 'maxLength': 32, 'minLength': 1}}, 'additionalProperties': False}, 'title': 'Stages', 'maxItems': 5, 'minItems': 1}, 'selector': {'type': 'object', 'title': 'Selector', 'required': ['reader', 'reasons', 'priorities', 'review_state', 'saved_view'], 'properties': {'reader': {'enum': ['attention', 'due_followups'], 'type': 'string', 'title': 'Reader'}, 'reasons': {'type': 'array', 'items': {'enum': ['stale', 'aging', 'blocked', 'dependency_blocked', 'completion_blocked', 'missed_due_date', 'integration_drift', 'forecast_degradation'], 'type': 'string'}, 'title': 'Reasons'}, 'priorities': {'type': 'array', 'items': {'enum': ['critical', 'high', 'medium', 'low'], 'type': 'string'}, 'title': 'Priorities', 'maxItems': 4, 'minItems': 1}, 'saved_view': {'anyOf': [{'type': 'object', 'title': 'SavedSelection', 'required': ['id', 'definition_token'], 'properties': {'id': {'type': 'string', 'title': 'Id', 'format': 'uuid'}, 'definition_token': {'type': 'string', 'title': 'Definition Token', 'pattern': '^[0-9a-f]{64}$', 'maxLength': 64, 'minLength': 64}}, 'additionalProperties': False}, {'type': 'null'}]}, 'review_state': {'enum': ['unresolved', 'resolved', 'all'], 'type': 'string', 'title': 'Review State'}}, 'additionalProperties': False}, 'quiet_hours': {'anyOf': [{'type': 'object', 'title': 'QuietHours', 'required': ['timezone', 'windows'], 'properties': {'windows': {'type': 'array', 'items': {'type': 'object', 'title': 'QuietWindow', 'required': ['days', 'start_minute', 'end_minute'], 'properties': {'days': {'type': 'array', 'items': {'type': 'integer'}, 'title': 'Days', 'maxItems': 7, 'minItems': 1}, 'end_minute': {'type': 'integer', 'title': 'End Minute', 'maximum': 1439, 'minimum': 0}, 'start_minute': {'type': 'integer', 'title': 'Start Minute', 'maximum': 1439, 'minimum': 0}}, 'additionalProperties': False}, 'title': 'Windows'}, 'timezone': {'type': 'string', 'title': 'Timezone', 'minLength': 1}}, 'additionalProperties': False}, {'type': 'null'}]}, 'destinations': {'type': 'array', 'items': {'type': 'object', 'title': 'Destination', 'required': ['key', 'name', 'url'], 'properties': {'key': {'type': 'string', 'title': 'Key', 'pattern': '^[a-z][a-z0-9_-]{0,31}$', 'maxLength': 32, 'minLength': 1}, 'url': {'type': 'string', 'title': 'Url', 'minLength': 1}, 'name': {'type': 'string', 'title': 'Name', 'maxLength': 200, 'minLength': 1}}, 'additionalProperties': False}, 'title': 'Destinations', 'maxItems': 3, 'minItems': 1}}, 'additionalProperties': False}, {'type': 'null'}], 'default': None}}, 'additionalProperties': False}
preview_portfolio_report_share
Preview Portfolio Report Share
Preview the exact public projection of an owned saved report, including its label, capture time, identity, fixed counts and disclosure. Private notes and unmodeled payload fields are excluded. Review this projection before requesting a link. Requires tickets:read; creates no access.
只读 幂等
输入模式
{'type': 'object', 'title': 'SharePreview', 'required': ['snapshot_id'], 'properties': {'snapshot_id': {'type': 'string', 'title': 'Snapshot Id', 'format': 'uuid'}}, 'additionalProperties': False}
preview_scheduling_action
Preview Scheduling Action
Freeze exactly one create, reschedule or cancel proposal for ten minutes. Sending requires separate explicit authenticated owner-session confirmation plus scheduling:agent_write and scheduling:invite_send. Preview sends no invitation; it grants no permission itself.
幂等
输入模式
{'type': 'object', 'required': ['request_id', 'proposal'], 'properties': {'proposal': {'oneOf': [{'type': 'object', 'required': ['action', 'meeting_type_id', 'offering_hash', 'start_at', 'timezone', 'name', 'email'], 'properties': {'name': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'email': {'type': 'string', 'format': 'email', 'maxLength': 255, 'minLength': 1}, 'notes': {'type': 'string', 'maxLength': 10000}, 'action': {'const': 'create'}, 'answers': {'type': 'object', 'maxProperties': 20, 'propertyNames': {'type': 'string', 'maxLength': 120, 'minLength': 1}, 'additionalProperties': {'type': 'string', 'maxLength': 1000}}, 'start_at': {'type': 'string', 'format': 'date-time', 'maxLength': 32}, 'timezone': {'type': 'string', 'maxLength': 100, 'minLength': 1}, 'offering_hash': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'meeting_type_id': {'type': 'string', 'format': 'uuid', 'maxLength': 36}}, 'additionalProperties': False}, {'type': 'object', 'required': ['action', 'booking_id', 'start_at', 'offering_hash'], 'properties': {'action': {'const': 'reschedule'}, 'start_at': {'type': 'string', 'format': 'date-time', 'maxLength': 32}, 'booking_id': {'type': 'string', 'format': 'uuid', 'maxLength': 36}, 'offering_hash': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['action', 'booking_id'], 'properties': {'action': {'const': 'cancel'}, 'reason': {'type': 'string', 'maxLength': 255}, 'booking_id': {'type': 'string', 'format': 'uuid', 'maxLength': 36}}, 'additionalProperties': False}]}, 'request_id': {'type': 'string', 'format': 'uuid', 'maxLength': 36}}, 'additionalProperties': False}
preview_ticket_export
Preview ticket export
Preview the exact owned ticket content, destination, correlation marker and status mapping for Jira or Linear. Supply destination (Jira project key or Linear team key) for an unlinked ticket. Returns expected export hash; no provider request or external write. Requires explicit integrations:write and tickets:write. Review this preview before export; a changed ticket or provider credential needs a fresh preview.
只读 幂等
输入模式
{'type': 'object', 'required': ['ticket_id', 'provider'], 'properties': {'provider': {'enum': ['jira', 'linear'], 'type': 'string'}, 'ticket_id': {'type': 'string', 'format': 'uuid'}, 'destination': {'type': 'string', 'maxLength': 80, 'minLength': 1}}, 'additionalProperties': False}
project_create
Project Create
Create an owner-private project with intent and goals. Persist request_id before calling; retry exact input after an uncertain response. Does not start work or create tickets.
幂等
输入模式
{'type': 'object', 'required': ['name', 'request_id'], 'properties': {'name': {'type': 'string', 'title': 'Name', 'maxLength': 120, 'minLength': 1}, 'goals': {'type': 'string', 'title': 'Goals', 'default': '', 'maxLength': 10000}, 'summary': {'type': 'string', 'title': 'Summary', 'default': '', 'maxLength': 4000}, 'request_id': {'type': 'string', 'title': 'Request Id', 'format': 'uuid'}, 'context_kind': {'enum': ['personal', 'business', 'client', 'contract', 'unclassified'], 'type': 'string', 'title': 'Context Kind'}, 'repository_url': {'type': 'string', 'title': 'Repository Url', 'default': '', 'maxLength': 2000}}, 'additionalProperties': False}
输出模式
{'type': 'object', 'required': ['text', 'data'], 'properties': {'data': {'type': 'object'}, 'text': {'type': 'string'}}, 'additionalProperties': False}
project_document_create
Project Document Create
Save the first immutable project brief, PRD, technical specification or decision revision. Optional ticket_id scopes the document to a linked feature. reviewed is editorial metadata, never execution approval.
幂等
输入模式
{'type': 'object', 'required': ['request_id', 'title', 'kind', 'body', 'project_id'], 'properties': {'body': {'type': 'string', 'title': 'Body', 'maxLength': 100000}, 'kind': {'enum': ['brief', 'prd', 'tech_spec', 'decision'], 'type': 'string', 'title': 'Kind'}, 'title': {'type': 'string', 'title': 'Title', 'maxLength': 200, 'minLength': 1}, 'status': {'enum': ['draft', 'reviewed'], 'type': 'string', 'title': 'Status', 'default': 'draft'}, 'ticket_id': {'anyOf': [{'type': 'string', 'format': 'uuid'}, {'type': 'null'}], 'title': 'Ticket Id', 'default': None}, 'project_id': {'type': 'string', 'format': 'uuid'}, 'request_id': {'type': 'string', 'title': 'Request Id', 'format': 'uuid'}}, 'additionalProperties': False}
输出模式
{'type': 'object', 'required': ['text', 'data'], 'properties': {'data': {'type': 'object'}, 'text': {'type': 'string'}}, 'additionalProperties': False}
project_document_get
Project Document Get
Read one exact owned project document revision and its bounded revision history. Omit revision for latest; use explicit revision when recording evidence.
只读 幂等
输入模式
{'type': 'object', 'required': ['project_id', 'document_id'], 'properties': {'revision': {'type': 'integer', 'maximum': 100, 'minimum': 1}, 'project_id': {'type': 'string', 'format': 'uuid'}, 'document_id': {'type': 'string', 'format': 'uuid'}}, 'additionalProperties': False}
输出模式
{'type': 'object', 'required': ['text', 'data'], 'properties': {'data': {'type': 'object'}, 'text': {'type': 'string'}}, 'additionalProperties': False}
project_document_revise
Project Document Revise
Append an immutable document revision using expected_revision and a caller-retained request_id. Exact retry reconciles even after later edits; changed input or stale base conflicts. No provider execution or external publication.
幂等
输入模式
{'type': 'object', 'required': ['request_id', 'title', 'kind', 'body', 'expected_revision', 'project_id', 'document_id'], 'properties': {'body': {'type': 'string', 'title': 'Body', 'maxLength': 100000}, 'kind': {'enum': ['brief', 'prd', 'tech_spec', 'decision'], 'type': 'string', 'title': 'Kind'}, 'title': {'type': 'string', 'title': 'Title', 'maxLength': 200, 'minLength': 1}, 'status': {'enum': ['draft', 'reviewed'], 'type': 'string', 'title': 'Status', 'default': 'draft'}, 'ticket_id': {'anyOf': [{'type': 'string', 'format': 'uuid'}, {'type': 'null'}], 'title': 'Ticket Id', 'default': None}, 'project_id': {'type': 'string', 'format': 'uuid'}, 'request_id': {'type': 'string', 'title': 'Request Id', 'format': 'uuid'}, 'document_id': {'type': 'string', 'format': 'uuid'}, 'expected_revision': {'type': 'integer', 'title': 'Expected Revision', 'minimum': 1}}, 'additionalProperties': False}
输出模式
{'type': 'object', 'required': ['text', 'data'], 'properties': {'data': {'type': 'object'}, 'text': {'type': 'string'}}, 'additionalProperties': False}
project_get
Project Get
Read project intent, current document IDs/revisions and linked feature epics. Read document bodies with project_document_get and follow ticket_get/ticket_list for execution work.
只读 幂等
输入模式
{'type': 'object', 'required': ['project_id'], 'properties': {'project_id': {'type': 'string', 'format': 'uuid'}}, 'additionalProperties': False}
输出模式
{'type': 'object', 'required': ['text', 'data'], 'properties': {'data': {'type': 'object'}, 'text': {'type': 'string'}}, 'additionalProperties': False}
project_link_feature
Project Link Feature
Link an existing owned parentless epic to this project. Exact retry reuses the link; linking an epic already belonging to another project conflicts. Does not reparent, claim or execute the ticket.
幂等
输入模式
{'type': 'object', 'required': ['ticket_id', 'project_id'], 'properties': {'ticket_id': {'type': 'string', 'title': 'Ticket Id', 'format': 'uuid'}, 'project_id': {'type': 'string', 'format': 'uuid'}}, 'additionalProperties': False}
输出模式
{'type': 'object', 'required': ['text', 'data'], 'properties': {'data': {'type': 'object'}, 'text': {'type': 'string'}}, 'additionalProperties': False}
project_list
Project List
List the account's overarching project workspaces, separate from feature epics. Optional context_kind filters the owner's classification; unclassified includes legacy unset projects. Requires tickets:read.
只读 幂等
输入模式
{'type': 'object', 'required': [], 'properties': {'context_kind': {'enum': ['personal', 'business', 'client', 'contract', 'unclassified'], 'type': 'string', 'title': 'Context Kind'}}, 'additionalProperties': False}
输出模式
{'type': 'object', 'required': ['text', 'data'], 'properties': {'data': {'type': 'object'}, 'text': {'type': 'string'}}, 'additionalProperties': False}
project_unlink_feature
Project Unlink Feature
Remove one exact project-feature placement, retaining the ticket. Read binding_id from project_get first; stale bindings or document references conflict. Does not delete tickets or documents.
幂等
输入模式
{'type': 'object', 'required': ['project_id', 'ticket_id', 'expected_binding_id'], 'properties': {'ticket_id': {'type': 'string', 'format': 'uuid'}, 'project_id': {'type': 'string', 'format': 'uuid'}, 'expected_binding_id': {'type': 'string', 'format': 'uuid'}}, 'additionalProperties': False}
输出模式
{'type': 'object', 'required': ['text', 'data'], 'properties': {'data': {'type': 'object'}, 'text': {'type': 'string'}}, 'additionalProperties': False}
project_update
Project Update
Revision-safely edit project context. Supply expected_revision from project_get and a new request_id. Stale edits conflict instead of overwriting another agent.
幂等
输入模式
{'type': 'object', 'required': ['request_id', 'expected_revision', 'project_id'], 'properties': {'name': {'type': 'string', 'title': 'Name', 'maxLength': 120, 'minLength': 1}, 'goals': {'type': 'string', 'title': 'Goals', 'maxLength': 10000}, 'summary': {'type': 'string', 'title': 'Summary', 'maxLength': 4000}, 'project_id': {'type': 'string', 'format': 'uuid'}, 'request_id': {'type': 'string', 'title': 'Request Id', 'format': 'uuid'}, 'context_kind': {'enum': ['personal', 'business', 'client', 'contract', 'unclassified'], 'type': 'string', 'title': 'Context Kind'}, 'repository_url': {'type': 'string', 'title': 'Repository Url', 'maxLength': 2000}, 'expected_revision': {'type': 'integer', 'title': 'Expected Revision', 'minimum': 1}}, 'additionalProperties': False}
输出模式
{'type': 'object', 'required': ['text', 'data'], 'properties': {'data': {'type': 'object'}, 'text': {'type': 'string'}}, 'additionalProperties': False}
recommend_panel
Recommend Panel
Recommend the best expert panel for a query (semantic match with keyword fallback). Returns the top panel + confidence and the runner-up options — feed the result into run_council's panel argument. Requires authentication because the query may be sent to the configured embedding provider.
只读 可访问外部资源 幂等
输入模式
{'type': 'object', 'required': ['query'], 'properties': {'query': {'type': 'string', 'description': 'The question or decision to match to a panel.'}}, 'additionalProperties': False}
reconcile_attention_notification_delivery
Reconcile Attention Notification Delivery
Record an owner declaration received or cancel with a note and current expected_version. Original network outcome and recovery history remain immutable. This is an attestation, never a fabricated receipt or permission to send again. Requires notifications:manage.
幂等
输入模式
{'type': 'object', 'title': 'Reconcile', 'required': ['request_id', 'expected_version', 'decision', 'note', 'delivery_id'], 'properties': {'note': {'type': 'string', 'title': 'Note', 'maxLength': 2000, 'minLength': 1}, 'decision': {'enum': ['received', 'cancel'], 'type': 'string', 'title': 'Decision'}, 'request_id': {'type': 'string', 'title': 'Request Id', 'format': 'uuid'}, 'delivery_id': {'type': 'string', 'format': 'uuid'}, 'expected_version': {'type': 'integer', 'title': 'Expected Version', 'maximum': 2147483646, 'minimum': 1}}, 'additionalProperties': False}
reconcile_ticket_provider_effect
Reconcile ticket provider effect
Check the original Jira or Linear intent against provider correlation/status using read-only provider requests. Requires explicit integrations:read and tickets:write. May record recovered local linkage/outcome; never creates a remote issue or sends a status transition. Missing, multiple, mismatched or unavailable evidence remains pending review. A changed credential cannot redirect the original operation. Use the original intent_id from list_ticket_provider_effects.
可访问外部资源
输入模式
{'type': 'object', 'required': ['ticket_id', 'provider', 'intent_id'], 'properties': {'provider': {'enum': ['jira', 'linear'], 'type': 'string'}, 'intent_id': {'type': 'string', 'format': 'uuid'}, 'ticket_id': {'type': 'string', 'format': 'uuid'}}, 'additionalProperties': False}
record_outreach_evidence
Record Outreach Evidence
Record owner-observed identity, employer, published work email, mailbox result/expiry and source-policy observations. This does not independently verify facts, create consent, enroll or send. Requires outreach:write.
输入模式
{'type': 'object', 'title': 'LeadEvidenceRequest', 'required': ['lead_id'], 'properties': {'email': {'anyOf': [{'type': 'string', 'maxLength': 255}, {'type': 'null'}], 'title': 'Email', 'default': None}, 'company': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}], 'title': 'Company', 'default': None}, 'lead_id': {'type': 'string', 'format': 'uuid'}, 'contact_name': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}], 'title': 'Contact Name', 'default': None}, 'employer_url': {'anyOf': [{'type': 'string', 'maxLength': 1000}, {'type': 'null'}], 'title': 'Employer Url', 'default': None}, 'identity_url': {'anyOf': [{'type': 'string', 'maxLength': 1000}, {'type': 'null'}], 'title': 'Identity Url', 'default': None}, 'mailbox_result': {'anyOf': [{'type': 'string', 'maxLength': 30}, {'type': 'null'}], 'title': 'Mailbox Result', 'default': None}, 'mailbox_expires_at': {'anyOf': [{'type': 'string', 'format': 'date-time'}, {'type': 'null'}], 'title': 'Mailbox Expires At', 'default': None}, 'mailbox_verified_at': {'anyOf': [{'type': 'string', 'format': 'date-time'}, {'type': 'null'}], 'title': 'Mailbox Verified At', 'default': None}, 'upstream_source_key': {'anyOf': [{'type': 'string', 'maxLength': 120}, {'type': 'null'}], 'title': 'Upstream Source Key', 'default': None}, 'email_provenance_url': {'anyOf': [{'type': 'string', 'maxLength': 1000}, {'type': 'null'}], 'title': 'Email Provenance Url', 'default': None}, 'employer_observed_at': {'anyOf': [{'type': 'string', 'format': 'date-time'}, {'type': 'null'}], 'title': 'Employer Observed At', 'default': None}, 'identity_observed_at': {'anyOf': [{'type': 'string', 'format': 'date-time'}, {'type': 'null'}], 'title': 'Identity Observed At', 'default': None}, 'source_policy_approved': {'anyOf': [{'type': 'boolean'}, {'type': 'null'}], 'title': 'Source Policy Approved', 'default': None}, 'email_provenance_observed_at': {'anyOf': [{'type': 'string', 'format': 'date-time'}, {'type': 'null'}], 'title': 'Email Provenance Observed At', 'default': None}}, 'description': 'Explicit research and mailbox evidence; omitted fields stay unchanged.', 'additionalProperties': False}
record_ticket_attention_resolution
Record Ticket Attention Resolution
Record or withdraw an owner resolution with a required explanation, latest review ID/revision, resolution revision and fresh assessment digest. Requires tickets:write. Use a stable idempotency key; exact retries return the original receipt, conflicts require fresh inspection. Resolution never changes tickets, queue membership, clocks, policy, reviews, follow-ups or action authority. A newer review starts unresolved. No providers or notifications.
幂等
输入模式
{'type': 'object', 'required': ['ticket_id', 'review_id', 'expected_review_revision', 'expected_resolution_revision', 'expected_assessment_digest', 'idempotency_key', 'disposition', 'explanation'], 'properties': {'review_id': {'type': 'string', 'format': 'uuid', 'maxLength': 36, 'minLength': 36}, 'ticket_id': {'type': 'string', 'format': 'uuid', 'maxLength': 36, 'minLength': 36}, 'disposition': {'enum': ['resolved', 'withdrawn'], 'type': 'string'}, 'explanation': {'type': 'string', 'maxLength': 2000, 'minLength': 1}, 'idempotency_key': {'type': 'string', 'pattern': '^[A-Za-z0-9_.:-]{8,128}$', 'maxLength': 128, 'minLength': 8}, 'expected_review_revision': {'type': 'integer', 'maximum': 2147483647, 'minimum': 1}, 'expected_assessment_digest': {'type': 'string', 'pattern': '^[0-9a-f]{64}$', 'maxLength': 64, 'minLength': 64}, 'expected_resolution_revision': {'type': 'integer', 'maximum': 2147483646, 'minimum': 0}}, 'additionalProperties': False}
reject_content_asset
Reject Content Asset
Reject a submitted owned revision with optional reviewer notes. Requires marketing:approve.
输入模式
{'type': 'object', 'required': ['asset_id'], 'properties': {'notes': {'type': 'string', 'maxLength': 10000}, 'asset_id': {'type': 'string', 'description': 'Full UUID from the matching list tool.'}}, 'additionalProperties': False}
reopen_consulting_deliverable
Reopen Consulting Deliverable
Return an unapproved review deliverable to editable draft status.
输入模式
{'type': 'object', 'required': ['deliverable_id'], 'properties': {'deliverable_id': {'type': 'string', 'format': 'uuid'}}, 'additionalProperties': False}
reschedule_booking
Reschedule Booking
Commit the exact owner-confirmed reschedule preview using both independent scheduling grants. This can notify the recipient, including cancellation. Reuse the same preview, hash and confirmation reference after uncertainty. Missing private process custody permits receipt recovery but cannot authorize a new dispatch; no manage secret is reconstructed.
可能执行破坏性操作 可访问外部资源 幂等
输入模式
{'type': 'object', 'required': ['preview_id', 'preview_hash', 'confirmation_id'], 'properties': {'preview_id': {'type': 'string', 'format': 'uuid', 'maxLength': 36}, 'preview_hash': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'confirmation_id': {'type': 'string', 'format': 'uuid', 'maxLength': 36}}, 'additionalProperties': False}
restore_accounting_run
Restore Accounting Run
Restore one owned soft-deleted Accounting run to normal lists and reads, retaining its original encrypted data and provenance. Repeating restore is safe. No external service is contacted.
幂等
输入模式
{'type': 'object', 'required': ['run_id'], 'properties': {'run_id': {'type': 'string', 'format': 'uuid', 'maxLength': 36, 'minLength': 36}, 'expected_revision': {'type': 'integer', 'maximum': 2147483646, 'minimum': 0, 'description': 'Optional visibility revision from get/list; refuses a stale visibility change.'}}, 'additionalProperties': False}
restore_saved_view
Restore Saved View
Return one of YOUR OWN archived saved views to the working set with its definition intact. Idempotent -- restoring a view that is already active is a no-op rather than an error. Use list_saved_views with scope=archived to find restorable views. Requires authentication and the tickets:write scope.
输入模式
{'type': 'object', 'required': ['view_id'], 'properties': {'view_id': {'type': 'string', 'maxLength': 64, 'minLength': 1, 'description': "The view's id, from list_saved_views with scope=archived."}, 'expected_revision': {'type': 'integer', 'maximum': 2147483647, 'minimum': 0, 'description': 'Current definition_revision, required to configure a scorecard or change any previously enrolled view. On conflict or uncertain reply, read current state and deliberately reconcile; this is not an exact-retry receipt.'}}, 'additionalProperties': False}
retry_attention_notification_delivery
Retry Attention Notification Delivery
Explicitly retry an eligible notification using expected_version and acknowledge_possible_duplicate=true. Requires notifications:send plus independent human approval. Preserves event/body/ID for receiver deduplication; cannot promise exactly once. An uncertain response must be reconciled through its request receipt before further action.
可访问外部资源 幂等
输入模式
{'type': 'object', 'title': 'Retry', 'required': ['request_id', 'expected_version', 'acknowledge_possible_duplicate', 'delivery_id'], 'properties': {'request_id': {'type': 'string', 'title': 'Request Id', 'format': 'uuid'}, 'delivery_id': {'type': 'string', 'format': 'uuid'}, 'expected_version': {'type': 'integer', 'title': 'Expected Version', 'maximum': 2147483646, 'minimum': 1}, 'acknowledge_possible_duplicate': {'type': 'boolean', 'const': True, 'title': 'Acknowledge Possible Duplicate'}}, 'additionalProperties': False}
retry_workflow
Retry Workflow
Continue a stalled or finished workflow run from a chosen step. This starts a NEW run that reuses the outputs the original run already recorded and only executes — and only pays for — the steps from 'from_step' onward. The original run is left untouched and the new one records which run it continues. Omit 'from_step' to resume at the first step that has no recorded output. A step whose output was never recorded is re-run, never skipped. Requires authentication.
输入模式
{'type': 'object', 'required': ['session_id'], 'properties': {'from_step': {'type': 'integer', 'minimum': 0, 'description': 'Zero-based index of the first step to actually execute. Defaults to the first step with no recorded output.'}, 'session_id': {'type': 'string', 'description': 'The workflow session id to continue from.'}}, 'additionalProperties': False}
review_external_workflow
Review External Workflow
Approve continuation or reject an ordinary internal draft checkpoint using its review_sha as input_sha. This is not a human-only approval or permission to send. Human-only gates are unsupported and refused at start. Requires workflows:approve.
输入模式
{'type': 'object', 'required': ['session_id', 'step_index', 'input_sha', 'decision'], 'properties': {'notes': {'type': 'string', 'maxLength': 4000}, 'decision': {'enum': ['approve', 'reject']}, 'input_sha': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'session_id': {'type': 'string', 'format': 'uuid'}, 'step_index': {'type': 'integer', 'maximum': 19, 'minimum': 0}}, 'additionalProperties': False}
revoke_portfolio_report_share
Revoke Portfolio Report Share
Revoke future reads through an owned report link. Requires explicit reports:share; reducing access does not need another human approval. Already copied content cannot be recalled. Preserve request_id for exact retry or receipt recovery; no report content is changed.
幂等
输入模式
{'type': 'object', 'title': 'ShareRevoke', 'required': ['request_id', 'share_id'], 'properties': {'share_id': {'type': 'string', 'format': 'uuid'}, 'request_id': {'type': 'string', 'title': 'Request Id', 'format': 'uuid'}}, 'additionalProperties': False}
rotate_api_key
Rotate Api Key
Replace the API key making this call with a fresh one carrying the same scopes. WARNING: this IRREVERSIBLY deactivates the current key the moment it succeeds — every other caller using that key stops working immediately, so do not call it on a shared credential. The new key is returned exactly once in the response and cannot be retrieved again. A delegated child key cannot rotate itself. Requires API-key authentication.
可能执行破坏性操作
输入模式
{'type': 'object', 'required': [], 'properties': {'expires_in_days': {'type': 'integer', 'maximum': 365, 'minimum': 1, 'description': 'Lifetime of the replacement key in days (default 90).'}}, 'additionalProperties': False}
run_comparison
Run Comparison
Re-run a member's workflow as it stands today and record the result as a new run. This calls model providers and costs money; it is priced and refused against your budget before anything starts. It does not act on the outside world a second time: connector steps are served from the baseline's recorded responses and agent steps keep only offline calculation tools. Returns the new run, not a comparison of it. Requires comparisons:write and workflows:run.
输入模式
{'type': 'object', 'required': ['set_id', 'baseline_session_id'], 'properties': {'set_id': {'type': 'string', 'format': 'uuid'}, 'baseline_session_id': {'type': 'string', 'maxLength': 64, 'minLength': 1}}, 'additionalProperties': False}
run_council
Run Council
Submit a question or decision to Meta Council. A panel of specialized AI agents will independently analyze it, then a synthesis step combines their opinions into a unified recommendation with full transparency. Starts asynchronously by default; use get_session with the returned session id.
可访问外部资源
输入模式
{'type': 'object', 'required': ['query'], 'properties': {'model': {'type': 'string', 'description': "Model to use (e.g., 'claude-sonnet-4-6', 'gpt-4o', 'deepseek-chat'). Omit to use user's default."}, 'panel': {'type': 'string', 'description': "Panel slug to use (e.g., 'default', 'technology', 'healthcare'). Use 'auto' for automatic panel selection. Omit to use default panel."}, 'query': {'type': 'string', 'description': 'The question or decision to analyze'}, 'wait_seconds': {'type': 'integer', 'default': 0, 'maximum': 90, 'minimum': 0, 'description': 'Optional synchronous wait (0-90 seconds). Default 0 returns the session id immediately, avoiding reverse-proxy timeouts.'}}, 'additionalProperties': False}
run_workflow
Run Workflow
Start a multi-step workflow pipeline and return its session id and definition_sha immediately by default — the fingerprint of the definition this run resolved, comparable against the one plan_workflow reported. Poll get_workflow_session for each step's model/provider and output. synthesis. Steps run on YOUR configured provider keys, so a pipeline can chain models across providers. If a step is a human checkpoint, returns the session id to advance. Requires authentication.
可访问外部资源
输入模式
{'type': 'object', 'required': ['workflow', 'query'], 'properties': {'query': {'type': 'string', 'description': "The input to run the pipeline on. Be specific, e.g. 'Analyze NVDA as an investment'."}, 'workflow': {'type': 'string', 'description': "The workflow slug (from list_workflows), e.g. 'live_market_pipeline', 'due_diligence', 'coding_tdd'."}, 'parameters': {'type': 'object', 'description': 'Values for the workflow\'s declared parameters, as a flat name-to-value object, e.g. {"region": "EU"}. Omitted names use their declared defaults. Workflows that declare no parameters take none.'}, 'step_models': {'type': 'object', 'description': 'Per-run model choices, keyed by zero-based step index, exactly as supplied to plan_workflow. IDs are catalog-validated; existing key, tier and platform fallback rules still apply. These choices must also match when recovering a start with an idempotency key.', 'additionalProperties': {'type': 'string'}}, 'wait_seconds': {'type': 'integer', 'default': 0, 'maximum': 90, 'minimum': 0, 'description': 'Optional synchronous wait; default 0 returns immediately.'}, 'idempotency_key': {'type': 'string', 'description': 'Caller-supplied key: sending the same key again returns the run that already exists instead of starting a second, paid run. Use a stable key derived from your own request so an uncertain retry converges. Max 120 chars, [A-Za-z0-9._:-].'}}, 'additionalProperties': False}
save_attention_notification_rule
Save Attention Notification Rule
Save a full owner notification configuration bound to expected_preview_hash; existing rules also require rule_id and expected_revision. Save always pauses. New/replaced or explicitly rotated destination keys appear only in the original receipt; retain request_id for recovery. URLs may contain credentials and remain private. Requires notifications:manage; never enables delivery.
幂等
输入模式
{'type': 'object', 'title': 'Save', 'required': ['request_id', 'definition', 'expected_preview_hash'], 'properties': {'rule_id': {'anyOf': [{'type': 'string', 'format': 'uuid'}, {'type': 'null'}], 'title': 'Rule Id', 'default': None}, 'definition': {'type': 'object', 'title': 'Definition', 'required': ['name', 'selector', 'quiet_hours', 'destinations', 'stages'], 'properties': {'name': {'type': 'string', 'title': 'Name', 'maxLength': 200, 'minLength': 1}, 'stages': {'type': 'array', 'items': {'type': 'object', 'title': 'Stage', 'required': ['key', 'name', 'after_minutes', 'destination_key'], 'properties': {'key': {'type': 'string', 'title': 'Key', 'pattern': '^[a-z][a-z0-9_-]{0,31}$', 'maxLength': 32, 'minLength': 1}, 'name': {'type': 'string', 'title': 'Name', 'maxLength': 200, 'minLength': 1}, 'after_minutes': {'type': 'integer', 'title': 'After Minutes', 'maximum': 10080, 'minimum': 0}, 'destination_key': {'type': 'string', 'title': 'Destination Key', 'pattern': '^[a-z][a-z0-9_-]{0,31}$', 'maxLength': 32, 'minLength': 1}}, 'additionalProperties': False}, 'title': 'Stages', 'maxItems': 5, 'minItems': 1}, 'selector': {'type': 'object', 'title': 'Selector', 'required': ['reader', 'reasons', 'priorities', 'review_state', 'saved_view'], 'properties': {'reader': {'enum': ['attention', 'due_followups'], 'type': 'string', 'title': 'Reader'}, 'reasons': {'type': 'array', 'items': {'enum': ['stale', 'aging', 'blocked', 'dependency_blocked', 'completion_blocked', 'missed_due_date', 'integration_drift', 'forecast_degradation'], 'type': 'string'}, 'title': 'Reasons'}, 'priorities': {'type': 'array', 'items': {'enum': ['critical', 'high', 'medium', 'low'], 'type': 'string'}, 'title': 'Priorities', 'maxItems': 4, 'minItems': 1}, 'saved_view': {'anyOf': [{'type': 'object', 'title': 'SavedSelection', 'required': ['id', 'definition_token'], 'properties': {'id': {'type': 'string', 'title': 'Id', 'format': 'uuid'}, 'definition_token': {'type': 'string', 'title': 'Definition Token', 'pattern': '^[0-9a-f]{64}$', 'maxLength': 64, 'minLength': 64}}, 'additionalProperties': False}, {'type': 'null'}]}, 'review_state': {'enum': ['unresolved', 'resolved', 'all'], 'type': 'string', 'title': 'Review State'}}, 'additionalProperties': False}, 'quiet_hours': {'anyOf': [{'type': 'object', 'title': 'QuietHours', 'required': ['timezone', 'windows'], 'properties': {'windows': {'type': 'array', 'items': {'type': 'object', 'title': 'QuietWindow', 'required': ['days', 'start_minute', 'end_minute'], 'properties': {'days': {'type': 'array', 'items': {'type': 'integer'}, 'title': 'Days', 'maxItems': 7, 'minItems': 1}, 'end_minute': {'type': 'integer', 'title': 'End Minute', 'maximum': 1439, 'minimum': 0}, 'start_minute': {'type': 'integer', 'title': 'Start Minute', 'maximum': 1439, 'minimum': 0}}, 'additionalProperties': False}, 'title': 'Windows'}, 'timezone': {'type': 'string', 'title': 'Timezone', 'minLength': 1}}, 'additionalProperties': False}, {'type': 'null'}]}, 'destinations': {'type': 'array', 'items': {'type': 'object', 'title': 'Destination', 'required': ['key', 'name', 'url'], 'properties': {'key': {'type': 'string', 'title': 'Key', 'pattern': '^[a-z][a-z0-9_-]{0,31}$', 'maxLength': 32, 'minLength': 1}, 'url': {'type': 'string', 'title': 'Url', 'minLength': 1}, 'name': {'type': 'string', 'title': 'Name', 'maxLength': 200, 'minLength': 1}}, 'additionalProperties': False}, 'title': 'Destinations', 'maxItems': 3, 'minItems': 1}}, 'additionalProperties': False}, 'request_id': {'type': 'string', 'title': 'Request Id', 'format': 'uuid'}, 'expected_revision': {'anyOf': [{'type': 'integer', 'maximum': 2147483646, 'minimum': 1}, {'type': 'null'}], 'title': 'Expected Revision', 'default': None}, 'rotate_destinations': {'anyOf': [{'type': 'array', 'items': {'type': 'string'}}, {'type': 'null'}], 'title': 'Rotate Destinations', 'default': None}, 'expected_preview_hash': {'type': 'string', 'title': 'Expected Preview Hash', 'pattern': '^[0-9a-f]{64}$', 'maxLength': 64, 'minLength': 64}}, 'additionalProperties': False}
save_project_attention_policy
Save Project Attention Policy
Record a complete project attention override or restore owner inheritance prospectively. Override requires explicit paused_statuses for all four reasons. Uses the project's expected_revision and an owner-wide idempotency_key. Exact retries return the original receipt, not current state: read current policy separately. Preserves anchors and historical pauses. Requires tickets:write; no external communication or team governance.
幂等
输入模式
{'type': 'object', 'allOf': [{'if': {'properties': {'mode': {'const': 'override'}}}, 'else': {'properties': {'policy': {'type': 'null'}}}, 'then': {'required': ['policy'], 'properties': {'policy': {'type': 'object', 'required': ['thresholds', 'status_overrides', 'paused_statuses'], 'properties': {'thresholds': {'type': 'object', 'required': ['stale', 'aging', 'blocked', 'dependency_blocked'], 'properties': {'aging': {'type': 'object', 'required': ['critical', 'high', 'medium', 'low'], 'properties': {'low': {'type': 'number', 'maximum': 3650, 'minimum': 0}, 'high': {'type': 'number', 'maximum': 3650, 'minimum': 0}, 'medium': {'type': 'number', 'maximum': 3650, 'minimum': 0}, 'critical': {'type': 'number', 'maximum': 3650, 'minimum': 0}}, 'additionalProperties': False}, 'stale': {'type': 'object', 'required': ['critical', 'high', 'medium', 'low'], 'properties': {'low': {'type': 'number', 'maximum': 3650, 'minimum': 0}, 'high': {'type': 'number', 'maximum': 3650, 'minimum': 0}, 'medium': {'type': 'number', 'maximum': 3650, 'minimum': 0}, 'critical': {'type': 'number', 'maximum': 3650, 'minimum': 0}}, 'additionalProperties': False}, 'blocked': {'type': 'object', 'required': ['critical', 'high', 'medium', 'low'], 'properties': {'low': {'type': 'number', 'maximum': 3650, 'minimum': 0}, 'high': {'type': 'number', 'maximum': 3650, 'minimum': 0}, 'medium': {'type': 'number', 'maximum': 3650, 'minimum': 0}, 'critical': {'type': 'number', 'maximum': 3650, 'minimum': 0}}, 'additionalProperties': False}, 'dependency_blocked': {'type': 'object', 'required': ['critical', 'high', 'medium', 'low'], 'properties': {'low': {'type': 'number', 'maximum': 3650, 'minimum': 0}, 'high': {'type': 'number', 'maximum': 3650, 'minimum': 0}, 'medium': {'type': 'number', 'maximum': 3650, 'minimum': 0}, 'critical': {'type': 'number', 'maximum': 3650, 'minimum': 0}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'paused_statuses': {'type': 'object', 'required': ['stale', 'aging', 'blocked', 'dependency_blocked'], 'properties': {'aging': {'type': 'array', 'items': {'enum': ['backlog', 'todo', 'in_progress', 'blocked', 'in_review', 'done', 'cancelled'], 'type': 'string'}, 'maxItems': 7, 'uniqueItems': True}, 'stale': {'type': 'array', 'items': {'enum': ['backlog', 'todo', 'in_progress', 'blocked', 'in_review', 'done', 'cancelled'], 'type': 'string'}, 'maxItems': 7, 'uniqueItems': True}, 'blocked': {'type': 'array', 'items': {'enum': ['backlog', 'todo', 'in_progress', 'blocked', 'in_review', 'done', 'cancelled'], 'type': 'string'}, 'maxItems': 7, 'uniqueItems': True}, 'dependency_blocked': {'type': 'array', 'items': {'enum': ['backlog', 'todo', 'in_progress', 'blocked', 'in_review', 'done', 'cancelled'], 'type': 'string'}, 'maxItems': 7, 'uniqueItems': True}}, 'additionalProperties': False}, 'status_overrides': {'type': 'object', 'required': [], 'properties': {'todo': {'type': 'object', 'required': [], 'properties': {'aging': {'type': 'object', 'required': [], 'properties': {'low': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'high': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'medium': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'critical': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}}, 'additionalProperties': False}, 'stale': {'type': 'object', 'required': [], 'properties': {'low': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'high': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'medium': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'critical': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}}, 'additionalProperties': False}, 'dependency_blocked': {'type': 'object', 'required': [], 'properties': {'low': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'high': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'medium': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'critical': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'backlog': {'type': 'object', 'required': [], 'properties': {'aging': {'type': 'object', 'required': [], 'properties': {'low': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'high': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'medium': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'critical': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}}, 'additionalProperties': False}, 'stale': {'type': 'object', 'required': [], 'properties': {'low': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'high': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'medium': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'critical': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}}, 'additionalProperties': False}, 'dependency_blocked': {'type': 'object', 'required': [], 'properties': {'low': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'high': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'medium': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'critical': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'blocked': {'type': 'object', 'required': [], 'properties': {'aging': {'type': 'object', 'required': [], 'properties': {'low': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'high': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'medium': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'critical': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}}, 'additionalProperties': False}, 'blocked': {'type': 'object', 'required': [], 'properties': {'low': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'high': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'medium': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'critical': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}}, 'additionalProperties': False}, 'dependency_blocked': {'type': 'object', 'required': [], 'properties': {'low': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'high': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'medium': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'critical': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'in_review': {'type': 'object', 'required': [], 'properties': {'aging': {'type': 'object', 'required': [], 'properties': {'low': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'high': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'medium': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'critical': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}}, 'additionalProperties': False}, 'stale': {'type': 'object', 'required': [], 'properties': {'low': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'high': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'medium': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'critical': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}}, 'additionalProperties': False}, 'dependency_blocked': {'type': 'object', 'required': [], 'properties': {'low': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'high': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'medium': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'critical': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'in_progress': {'type': 'object', 'required': [], 'properties': {'aging': {'type': 'object', 'required': [], 'properties': {'low': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'high': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'medium': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'critical': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}}, 'additionalProperties': False}, 'stale': {'type': 'object', 'required': [], 'properties': {'low': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'high': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'medium': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'critical': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}}, 'additionalProperties': False}, 'dependency_blocked': {'type': 'object', 'required': [], 'properties': {'low': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'high': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'medium': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'critical': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'additionalProperties': False}}}}], 'title': 'ProjectPolicySave', 'required': ['project_id', 'expected_revision', 'idempotency_key', 'mode'], 'properties': {'mode': {'enum': ['inherit', 'override'], 'type': 'string', 'title': 'Mode'}, 'policy': {'anyOf': [{'type': 'object', 'required': ['thresholds', 'status_overrides', 'paused_statuses'], 'properties': {'thresholds': {'type': 'object', 'required': ['stale', 'aging', 'blocked', 'dependency_blocked'], 'properties': {'aging': {'type': 'object', 'required': ['critical', 'high', 'medium', 'low'], 'properties': {'low': {'type': 'number', 'maximum': 3650, 'minimum': 0}, 'high': {'type': 'number', 'maximum': 3650, 'minimum': 0}, 'medium': {'type': 'number', 'maximum': 3650, 'minimum': 0}, 'critical': {'type': 'number', 'maximum': 3650, 'minimum': 0}}, 'additionalProperties': False}, 'stale': {'type': 'object', 'required': ['critical', 'high', 'medium', 'low'], 'properties': {'low': {'type': 'number', 'maximum': 3650, 'minimum': 0}, 'high': {'type': 'number', 'maximum': 3650, 'minimum': 0}, 'medium': {'type': 'number', 'maximum': 3650, 'minimum': 0}, 'critical': {'type': 'number', 'maximum': 3650, 'minimum': 0}}, 'additionalProperties': False}, 'blocked': {'type': 'object', 'required': ['critical', 'high', 'medium', 'low'], 'properties': {'low': {'type': 'number', 'maximum': 3650, 'minimum': 0}, 'high': {'type': 'number', 'maximum': 3650, 'minimum': 0}, 'medium': {'type': 'number', 'maximum': 3650, 'minimum': 0}, 'critical': {'type': 'number', 'maximum': 3650, 'minimum': 0}}, 'additionalProperties': False}, 'dependency_blocked': {'type': 'object', 'required': ['critical', 'high', 'medium', 'low'], 'properties': {'low': {'type': 'number', 'maximum': 3650, 'minimum': 0}, 'high': {'type': 'number', 'maximum': 3650, 'minimum': 0}, 'medium': {'type': 'number', 'maximum': 3650, 'minimum': 0}, 'critical': {'type': 'number', 'maximum': 3650, 'minimum': 0}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'paused_statuses': {'type': 'object', 'required': ['stale', 'aging', 'blocked', 'dependency_blocked'], 'properties': {'aging': {'type': 'array', 'items': {'enum': ['backlog', 'todo', 'in_progress', 'blocked', 'in_review', 'done', 'cancelled'], 'type': 'string'}, 'maxItems': 7, 'uniqueItems': True}, 'stale': {'type': 'array', 'items': {'enum': ['backlog', 'todo', 'in_progress', 'blocked', 'in_review', 'done', 'cancelled'], 'type': 'string'}, 'maxItems': 7, 'uniqueItems': True}, 'blocked': {'type': 'array', 'items': {'enum': ['backlog', 'todo', 'in_progress', 'blocked', 'in_review', 'done', 'cancelled'], 'type': 'string'}, 'maxItems': 7, 'uniqueItems': True}, 'dependency_blocked': {'type': 'array', 'items': {'enum': ['backlog', 'todo', 'in_progress', 'blocked', 'in_review', 'done', 'cancelled'], 'type': 'string'}, 'maxItems': 7, 'uniqueItems': True}}, 'additionalProperties': False}, 'status_overrides': {'type': 'object', 'required': [], 'properties': {'todo': {'type': 'object', 'required': [], 'properties': {'aging': {'type': 'object', 'required': [], 'properties': {'low': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'high': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'medium': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'critical': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}}, 'additionalProperties': False}, 'stale': {'type': 'object', 'required': [], 'properties': {'low': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'high': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'medium': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'critical': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}}, 'additionalProperties': False}, 'dependency_blocked': {'type': 'object', 'required': [], 'properties': {'low': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'high': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'medium': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'critical': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'backlog': {'type': 'object', 'required': [], 'properties': {'aging': {'type': 'object', 'required': [], 'properties': {'low': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'high': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'medium': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'critical': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}}, 'additionalProperties': False}, 'stale': {'type': 'object', 'required': [], 'properties': {'low': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'high': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'medium': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'critical': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}}, 'additionalProperties': False}, 'dependency_blocked': {'type': 'object', 'required': [], 'properties': {'low': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'high': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'medium': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'critical': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'blocked': {'type': 'object', 'required': [], 'properties': {'aging': {'type': 'object', 'required': [], 'properties': {'low': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'high': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'medium': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'critical': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}}, 'additionalProperties': False}, 'blocked': {'type': 'object', 'required': [], 'properties': {'low': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'high': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'medium': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'critical': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}}, 'additionalProperties': False}, 'dependency_blocked': {'type': 'object', 'required': [], 'properties': {'low': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'high': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'medium': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'critical': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'in_review': {'type': 'object', 'required': [], 'properties': {'aging': {'type': 'object', 'required': [], 'properties': {'low': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'high': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'medium': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'critical': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}}, 'additionalProperties': False}, 'stale': {'type': 'object', 'required': [], 'properties': {'low': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'high': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'medium': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'critical': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}}, 'additionalProperties': False}, 'dependency_blocked': {'type': 'object', 'required': [], 'properties': {'low': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'high': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'medium': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'critical': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'in_progress': {'type': 'object', 'required': [], 'properties': {'aging': {'type': 'object', 'required': [], 'properties': {'low': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'high': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'medium': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'critical': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}}, 'additionalProperties': False}, 'stale': {'type': 'object', 'required': [], 'properties': {'low': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'high': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'medium': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'critical': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}}, 'additionalProperties': False}, 'dependency_blocked': {'type': 'object', 'required': [], 'properties': {'low': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'high': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'medium': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'critical': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'additionalProperties': False}, {'type': 'null'}], 'title': 'Policy', 'default': None}, 'project_id': {'type': 'string', 'format': 'uuid'}, 'idempotency_key': {'type': 'string', 'title': 'Idempotency Key', 'pattern': '^[A-Za-z0-9_.:-]{8,128}$', 'maxLength': 128, 'minLength': 8}, 'expected_revision': {'type': 'integer', 'title': 'Expected Revision', 'maximum': 2147483646, 'minimum': 0}}, 'additionalProperties': False}
save_ticket_attention_policy
Save Ticket Attention Policy
Save owner-private attention thresholds in UTC days (finite 0–3650), status overrides and optional paused_statuses. Requires tickets:write. Supply full base thresholds, sparse overrides, expected_revision and caller-stable idempotency_key. paused_statuses specifies all four timed reasons with unique status lists including done/cancelled; pauses apply prospectively from this save. Explicit empty lists restore elapsed counting while retaining prior deductions. Omission cannot clear active pauses. Null overrides disable rules without pausing clocks. Saves require fresh reviews; exact retries retain original receipts. Missing history makes adjusted age unknown. Original anchors, follow-up dates and completion blockers are unchanged; no notification or provider calls.
幂等
输入模式
{'type': 'object', 'required': ['expected_revision', 'idempotency_key', 'policy'], 'properties': {'policy': {'type': 'object', 'required': ['thresholds', 'status_overrides'], 'properties': {'thresholds': {'type': 'object', 'required': ['stale', 'aging', 'blocked', 'dependency_blocked'], 'properties': {'aging': {'type': 'object', 'required': ['critical', 'high', 'medium', 'low'], 'properties': {'low': {'type': 'number', 'maximum': 3650, 'minimum': 0}, 'high': {'type': 'number', 'maximum': 3650, 'minimum': 0}, 'medium': {'type': 'number', 'maximum': 3650, 'minimum': 0}, 'critical': {'type': 'number', 'maximum': 3650, 'minimum': 0}}, 'additionalProperties': False}, 'stale': {'type': 'object', 'required': ['critical', 'high', 'medium', 'low'], 'properties': {'low': {'type': 'number', 'maximum': 3650, 'minimum': 0}, 'high': {'type': 'number', 'maximum': 3650, 'minimum': 0}, 'medium': {'type': 'number', 'maximum': 3650, 'minimum': 0}, 'critical': {'type': 'number', 'maximum': 3650, 'minimum': 0}}, 'additionalProperties': False}, 'blocked': {'type': 'object', 'required': ['critical', 'high', 'medium', 'low'], 'properties': {'low': {'type': 'number', 'maximum': 3650, 'minimum': 0}, 'high': {'type': 'number', 'maximum': 3650, 'minimum': 0}, 'medium': {'type': 'number', 'maximum': 3650, 'minimum': 0}, 'critical': {'type': 'number', 'maximum': 3650, 'minimum': 0}}, 'additionalProperties': False}, 'dependency_blocked': {'type': 'object', 'required': ['critical', 'high', 'medium', 'low'], 'properties': {'low': {'type': 'number', 'maximum': 3650, 'minimum': 0}, 'high': {'type': 'number', 'maximum': 3650, 'minimum': 0}, 'medium': {'type': 'number', 'maximum': 3650, 'minimum': 0}, 'critical': {'type': 'number', 'maximum': 3650, 'minimum': 0}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'paused_statuses': {'type': 'object', 'required': ['stale', 'aging', 'blocked', 'dependency_blocked'], 'properties': {'aging': {'type': 'array', 'items': {'enum': ['backlog', 'todo', 'in_progress', 'blocked', 'in_review', 'done', 'cancelled'], 'type': 'string'}, 'maxItems': 7, 'uniqueItems': True}, 'stale': {'type': 'array', 'items': {'enum': ['backlog', 'todo', 'in_progress', 'blocked', 'in_review', 'done', 'cancelled'], 'type': 'string'}, 'maxItems': 7, 'uniqueItems': True}, 'blocked': {'type': 'array', 'items': {'enum': ['backlog', 'todo', 'in_progress', 'blocked', 'in_review', 'done', 'cancelled'], 'type': 'string'}, 'maxItems': 7, 'uniqueItems': True}, 'dependency_blocked': {'type': 'array', 'items': {'enum': ['backlog', 'todo', 'in_progress', 'blocked', 'in_review', 'done', 'cancelled'], 'type': 'string'}, 'maxItems': 7, 'uniqueItems': True}}, 'additionalProperties': False}, 'status_overrides': {'type': 'object', 'required': [], 'properties': {'todo': {'type': 'object', 'required': [], 'properties': {'aging': {'type': 'object', 'required': [], 'properties': {'low': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'high': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'medium': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'critical': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}}, 'additionalProperties': False}, 'stale': {'type': 'object', 'required': [], 'properties': {'low': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'high': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'medium': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'critical': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}}, 'additionalProperties': False}, 'dependency_blocked': {'type': 'object', 'required': [], 'properties': {'low': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'high': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'medium': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'critical': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'backlog': {'type': 'object', 'required': [], 'properties': {'aging': {'type': 'object', 'required': [], 'properties': {'low': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'high': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'medium': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'critical': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}}, 'additionalProperties': False}, 'stale': {'type': 'object', 'required': [], 'properties': {'low': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'high': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'medium': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'critical': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}}, 'additionalProperties': False}, 'dependency_blocked': {'type': 'object', 'required': [], 'properties': {'low': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'high': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'medium': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'critical': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'blocked': {'type': 'object', 'required': [], 'properties': {'aging': {'type': 'object', 'required': [], 'properties': {'low': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'high': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'medium': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'critical': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}}, 'additionalProperties': False}, 'blocked': {'type': 'object', 'required': [], 'properties': {'low': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'high': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'medium': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'critical': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}}, 'additionalProperties': False}, 'dependency_blocked': {'type': 'object', 'required': [], 'properties': {'low': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'high': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'medium': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'critical': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'in_review': {'type': 'object', 'required': [], 'properties': {'aging': {'type': 'object', 'required': [], 'properties': {'low': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'high': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'medium': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'critical': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}}, 'additionalProperties': False}, 'stale': {'type': 'object', 'required': [], 'properties': {'low': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'high': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'medium': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'critical': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}}, 'additionalProperties': False}, 'dependency_blocked': {'type': 'object', 'required': [], 'properties': {'low': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'high': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'medium': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'critical': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'in_progress': {'type': 'object', 'required': [], 'properties': {'aging': {'type': 'object', 'required': [], 'properties': {'low': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'high': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'medium': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'critical': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}}, 'additionalProperties': False}, 'stale': {'type': 'object', 'required': [], 'properties': {'low': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'high': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'medium': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'critical': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}}, 'additionalProperties': False}, 'dependency_blocked': {'type': 'object', 'required': [], 'properties': {'low': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'high': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'medium': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}, 'critical': {'type': ['number', 'null'], 'maximum': 3650, 'minimum': 0}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'idempotency_key': {'type': 'string', 'pattern': '^[A-Za-z0-9_.:-]{8,128}$', 'maxLength': 128, 'minLength': 8}, 'expected_revision': {'type': 'integer', 'maximum': 2147483646, 'minimum': 0}}, 'additionalProperties': False}
save_ticket_attention_review
Save Ticket Attention Review
Record an owner-private review of current attention evidence, with optional note (2000 characters) and follow_up_date plus explicit IANA follow_up_timezone, or null for both. Requires tickets:write. Supply the current evidence digest, current review revision (0 first), and caller-stable idempotency key. Exact retries return the original receipt; changed requests, revision or evidence conflict. Retains immutable history; omitted fields clear note/date. Does not hide/reorder queue items, reset clocks/status, approve consequential actions, notify or call providers. Retained evidence discloses omitted prerequisite detail.
幂等
输入模式
{'type': 'object', 'required': ['ticket_id', 'expected_evidence_digest', 'expected_review_revision', 'idempotency_key'], 'properties': {'note': {'type': ['string', 'null'], 'maxLength': 2000}, 'ticket_id': {'type': 'string', 'pattern': '^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$', 'maxLength': 36, 'minLength': 36}, 'follow_up_date': {'type': ['string', 'null'], 'pattern': '^[0-9]{4}-[0-9]{2}-[0-9]{2}$'}, 'idempotency_key': {'type': 'string', 'pattern': '^[A-Za-z0-9_.:-]{8,128}$', 'maxLength': 128, 'minLength': 8}, 'follow_up_timezone': {'type': ['string', 'null'], 'maxLength': 100, 'minLength': 1}, 'expected_evidence_digest': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'expected_review_revision': {'type': 'integer', 'maximum': 2147483646, 'minimum': 0}}, 'additionalProperties': False}
save_ticket_delivery_plan
Save Ticket Delivery Plan
Explicitly replace or clear a ticket plan. Dates and working-day duration are separate from points. Pass current expected_version; reuse exact request_id on retries. Changed saves atomically record immutable revision and plan_changed history. No automatic scheduling/execution. Requires tickets:write.
输入模式
{'type': 'object', 'required': ['ticket_id', 'request_id', 'expected_version', 'plan'], 'properties': {'plan': {'type': ['object', 'null'], 'required': ['planned_start', 'due_date', 'estimated_duration_days', 'timezone', 'calendar', 'milestone'], 'properties': {'calendar': {'enum': [None, 'calendar_days', 'weekdays']}, 'due_date': {'type': ['string', 'null'], 'format': 'date'}, 'timezone': {'type': ['string', 'null'], 'maxLength': 64, 'minLength': 1}, 'milestone': {'type': 'boolean'}, 'planned_start': {'type': ['string', 'null'], 'format': 'date'}, 'estimated_duration_days': {'type': ['integer', 'null'], 'maximum': 3650, 'minimum': 0}}, 'additionalProperties': False}, 'ticket_id': {'type': 'string', 'format': 'uuid'}, 'request_id': {'type': 'string', 'format': 'uuid'}, 'expected_version': {'type': 'integer', 'maximum': 2147483646, 'minimum': 0}}, 'additionalProperties': False}
score_locus_case
Score Locus Case
Score an anonymized adult mental-health / addiction case against LOCUS. Convenes the LOCUS Assessment Panel (psychiatrist, addiction specialist, clinical social worker, utilization reviewer, peer specialist, safety officer); each reviewer independently rates all six LOCUS dimensions, then a DETERMINISTIC engine aggregates the ratings and applies the Determination Grid and the inviolable override floors IN CODE (safety floors like Risk-of-Harm=4 → Level 5 cannot be reasoned away). Returns the recommended Level of Care with a full audit trail. Adults only (CALOCUS/CASII covers child/adolescent); use ONLY anonymized cases. Starts asynchronously by default; poll get_session. Requires authentication.
可访问外部资源
输入模式
{'type': 'object', 'required': ['case'], 'properties': {'case': {'type': 'string', 'description': 'The anonymized clinical case text (presentation, history, substance use, functional status, environment, engagement).'}, 'model': {'type': 'string', 'description': 'Optional model override; omit for the platform default.'}, 'wait_seconds': {'type': 'integer', 'default': 0, 'maximum': 90, 'minimum': 0, 'description': 'Optional synchronous wait; default 0 returns immediately.'}}, 'additionalProperties': False}
search_outreach_leads
Search Outreach Leads
Search the user's outreach leads — filter by a text query (company / contact / email), pipeline status, and/or campaign. Returns stable IDs, evidence, holds and exact rendered draft bytes/hash for review. Replies over 256 KiB refuse in full; narrow the query or limit. Requires authentication.
只读 幂等
输入模式
{'type': 'object', 'properties': {'limit': {'type': 'integer', 'description': 'Max leads to return (default 20, max 100).'}, 'search': {'type': 'string', 'description': 'Text to match against company / contact name / title / email.'}, 'status': {'type': 'string', 'description': "Filter by pipeline status (e.g. 'ready', 'sent', 'replied')."}, 'campaign_id': {'type': 'string', 'description': 'Filter to a single campaign id.'}}, 'additionalProperties': False}
send_invoice
Send Invoice
Mark a draft invoice as sent (stamps issued_at). Re-sending an already-sent invoice is a harmless no-op. invoice_id is required.
输入模式
{'type': 'object', 'required': ['invoice_id'], 'properties': {'invoice_id': {'type': 'string'}}, 'additionalProperties': False}
set_outreach_sender_state
Set Outreach Sender State
Record an owner-observed sender posture and checked time. This does not inspect credentials or verify a provider. Unknown, paused and unsafe remain held; verified alone cannot permit a send. Requires outreach:write.
输入模式
{'type': 'object', 'title': 'SenderStateRequest', 'required': ['campaign_id', 'sender_state', 'sender_state_checked_at'], 'properties': {'campaign_id': {'type': 'string', 'format': 'uuid'}, 'sender_state': {'type': 'string', 'title': 'Sender State', 'maxLength': 24, 'minLength': 1}, 'sender_state_checked_at': {'type': 'string', 'title': 'Sender State Checked At', 'format': 'date-time'}}, 'additionalProperties': False}
share_saved_view
Share Saved View
Share one of YOUR OWN saved views with a single team you belong to. Members may read, list and execute it; only you may revise, re-share or delete it. Executing a shared view runs it against the READER's own tickets, so this shares the question and never the answers. Re-sharing to a different team MOVES the view rather than adding a second grant -- a view is readable by at most one team. Note: team ids are not currently discoverable from this MCP surface, so supply one you already hold. Requires authentication and the tickets:write scope.
输入模式
{'type': 'object', 'required': ['view_id', 'team_id'], 'properties': {'team_id': {'type': 'string', 'maxLength': 64, 'minLength': 1, 'description': 'The id of a team you belong to. Sharing with a team you are not a member of is refused.'}, 'view_id': {'type': 'string', 'maxLength': 64, 'minLength': 1, 'description': "The view's id, from list_saved_views."}, 'expected_revision': {'type': 'integer', 'maximum': 2147483647, 'minimum': 0, 'description': 'Current definition_revision, required to configure a scorecard or change any previously enrolled view. On conflict or uncertain reply, read current state and deliberately reconcile; this is not an exact-retry receipt.'}}, 'additionalProperties': False}
start_external_workflow
Start External Workflow
Start a caller-executed sales evidence draft. Returns frozen instructions for your agent to execute. No server model call, tools or sending. Reuse request_id only with identical inputs. Results are caller attestations, not verified provider usage. Requires workflows:run.
输入模式
{'type': 'object', 'required': ['workflow', 'query', 'request_id'], 'properties': {'query': {'type': 'string', 'pattern': '\\S', 'maxLength': 24000, 'minLength': 1}, 'workflow': {'enum': ['email_lead_pipeline_evidence', 'sales_pipeline_evidence', 'lead_outreach_tracker_evidence', 'client_proposal_generator_evidence']}, 'request_id': {'type': 'string', 'format': 'uuid'}}, 'additionalProperties': False}
submit_consulting_deliverable
Submit Consulting Deliverable
Submit an owned draft deliverable for internal review without publishing it.
输入模式
{'type': 'object', 'required': ['deliverable_id'], 'properties': {'deliverable_id': {'type': 'string', 'format': 'uuid'}}, 'additionalProperties': False}
submit_content_asset
Submit Content Asset
Submit an owned draft for review, freezing that exact revision and content hash.
输入模式
{'type': 'object', 'required': ['asset_id'], 'properties': {'asset_id': {'type': 'string', 'description': 'Full UUID from the matching list tool.'}}, 'additionalProperties': False}
submit_external_workflow_result
Submit External Workflow Result
Submit your output for the exact next_step input_sha and step_index. Retains authenticated caller provenance; model_label is self-reported. Identical retries are safe; conflicting/stale results fail. No server model call or outbound action. Requires workflows:run.
输入模式
{'type': 'object', 'required': ['session_id', 'step_index', 'input_sha', 'output', 'model_label'], 'properties': {'output': {'type': 'string', 'pattern': '\\S', 'maxLength': 16000, 'minLength': 1}, 'input_sha': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'session_id': {'type': 'string', 'format': 'uuid'}, 'step_index': {'type': 'integer', 'maximum': 19, 'minimum': 0}, 'model_label': {'type': 'string', 'pattern': '\\S', 'maxLength': 100, 'minLength': 1}}, 'additionalProperties': False}
submit_meta_council_feedback
Submit Meta Council Feedback
Report feedback about the META COUNCIL PLATFORM itself — a noticeable performance failure, a lacking/missing capability, a bug, or a UX/docs gap in Meta Council's tools, councils, workflows, or MCP surface. Platform feedback only: do NOT use this for anything about your own business, customers, deals, invoices, or other data Meta Council manages on your behalf — use the relevant business tool for that instead (e.g. create_deal, create_invoice). Use it the moment a tool result, council run, or workflow falls short. Stored per-user and visible only to platform admins — the response returns an id + acknowledgement and submissions cannot be read back. Include machine context (tool name, session id, model) in the context object.
输入模式
{'type': 'object', 'required': ['title'], 'properties': {'body': {'type': 'string', 'maxLength': 8000}, 'title': {'type': 'string', 'maxLength': 300}, 'context': {'type': 'object', 'description': 'Machine context: tool name, session id, model, timings.'}, 'category': {'enum': ['performance', 'missing_feature', 'bug', 'ux', 'docs', 'general'], 'type': 'string'}, 'severity': {'enum': ['blocker', 'major', 'minor', 'suggestion'], 'type': 'string'}}, 'additionalProperties': False}
supersede_portfolio_report
Supersede Portfolio Report
Record that one owned saved report replaces another, with a required reason and both fetched payload hashes. This is an immutable owner declaration, not approval, sharing or a claim of accuracy. Both reports must have no replacement recorded. Use the same key and exact payload after an uncertain response; exact retries return the original receipt even after later replacements. Conflicting keys, self-links and cycles are refused. Original exports stay unchanged. tickets:write.
幂等
输入模式
{'type': 'object', 'required': ['snapshot_id', 'replacement_id', 'reason', 'idempotency_key', 'expected_source_hash', 'expected_replacement_hash'], 'properties': {'reason': {'type': 'string', 'maxLength': 2000, 'minLength': 1}, 'snapshot_id': {'type': 'string', 'format': 'uuid', 'maxLength': 36, 'minLength': 36}, 'replacement_id': {'type': 'string', 'format': 'uuid', 'maxLength': 36, 'minLength': 36}, 'idempotency_key': {'type': 'string', 'pattern': '^[A-Za-z0-9_.:-]{8,128}$', 'maxLength': 128, 'minLength': 8}, 'expected_source_hash': {'type': 'string', 'pattern': '^[0-9a-f]{64}$', 'maxLength': 64, 'minLength': 64}, 'expected_replacement_hash': {'type': 'string', 'pattern': '^[0-9a-f]{64}$', 'maxLength': 64, 'minLength': 64}}, 'additionalProperties': False}
sync_accounting_tickets
Sync Accounting Tickets
Commit a previously previewed completed Accounting run's WRITEOff work plan to stable owner-private Meta Council tickets. The expected_plan_hash from the preview is required, retries are idempotent, stable references prevent duplicate tickets across reprocessed runs, and human edits to generated content fields are preserved. Status, assignee, hierarchy, and completion are not reset. Requires both accounting:read and tickets:write. This creates or updates only in-platform planning tickets; they are not field-encrypted and become readable through tickets:read without accounting:read. It never files, pays, sends, or publishes anything.
幂等
输入模式
{'type': 'object', 'required': ['run_id', 'expected_plan_hash'], 'properties': {'run_id': {'type': 'string', 'format': 'uuid', 'maxLength': 36, 'minLength': 36}, 'expected_plan_hash': {'type': 'string', 'pattern': '^[0-9a-f]{64}$', 'description': 'Exact plan_hash returned by preview_accounting_ticket_sync.'}}, 'additionalProperties': False}
test_workflow_step
Test Workflow Step
Run exactly ONE step of a workflow and return what it produced, so you can iterate on a single step's wording without running the steps before it. THIS SPENDS CREDITS EXACTLY LIKE A REAL STEP: the step runs on a real model through the same engine a full run uses and is billed identically -- it is not a simulation, a dry run, or a free preview. If you want to check a workflow's shape, parameters, models and cost estimate for free, use plan_workflow instead; that one runs nothing. Starts no session, so there is nothing to poll and nothing to advance. Requires authentication.
输入模式
{'type': 'object', 'required': ['workflow', 'step_index'], 'properties': {'query': {'type': 'string', 'description': 'The input the step works on, exactly as you would pass it to run_workflow. Optional -- omit for a step whose instruction already carries everything it needs.'}, 'workflow': {'type': 'string', 'description': "The workflow slug (from list_workflows), e.g. 'due_diligence'."}, 'parameters': {'type': 'object', 'description': 'Optional values for the workflow\'s declared parameters, as a flat name-to-value object, e.g. {"region": "EU"}. They are substituted into the step wording the same way a real run substitutes them.', 'additionalProperties': True}, 'step_index': {'type': 'integer', 'description': 'Which step to run, counting from 0. A workflow with 4 steps accepts 0 to 3; anything else is refused without spending.'}}, 'additionalProperties': False}
ticket_archive
Ticket Archive
Retire an owned ticket from the working set, or restore one. Archiving is a different axis from status: the ticket keeps whatever status it had, so a done ticket stays done and a blocked one comes back still blocked — never use status 'cancelled' to mean 'archived'. An archived ticket disappears from ticket_list, the stats, the buckets, the attention queue, and outbound JIRA/Linear sync, but keeps its id and URL so citations stay valid, and it refuses edits until restored. Cascades to the active subtree; restore brings back exactly what was archived alongside it. Nothing is destroyed — this is not a delete, and no delete tool is exposed.
输入模式
{'type': 'object', 'required': ['ticket_id'], 'properties': {'action': {'enum': ['archive', 'restore'], 'type': 'string', 'default': 'archive'}, 'ticket_id': {'type': 'string'}}, 'additionalProperties': False}
ticket_authority
Ticket Authority
Read an owned ticket's audited current readiness, dependencies, current and stale scenario validation metadata, and immutable completion history. Archived tickets remain readable. History windows explicitly report truncation; use ticket_authority_export for all retained evidence. Returns exact canonical JSON without raw evidence payloads. Requires tickets:read.
只读 幂等
输入模式
{'type': 'object', 'required': ['ticket_id'], 'properties': {'ticket_id': {'type': 'string', 'format': 'uuid', 'pattern': '^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$'}}, 'additionalProperties': False}
ticket_authority_export
Ticket Authority Export
Export the full owner-private ticket authority as canonical versioned native JSON, including retained dependency removals, revisions, validation evidence and completion manifests with their stored hashes and order. Includes private evidence; keep the file private. Export is capped at 64 MiB and refuses rather than truncating. The embedded integrity hash does not grant import or completion authority. Requires tickets:read.
只读 幂等
输入模式
{'type': 'object', 'required': ['ticket_id'], 'properties': {'ticket_id': {'type': 'string', 'format': 'uuid', 'pattern': '^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$'}}, 'additionalProperties': False}
ticket_batch_create
Ticket Batch Create
Preview or idempotently commit one atomic owner-private batch of structured tickets and nested subtickets. Preview is non-mutating and returns the normalized commit payload, exact preview_token, and deterministic predicted IDs as JSON. Commit requires that exact token: combine commit_payload with mode=commit, the caller-held idempotency_key, and preview_token. It returns the same IDs plus replay status. A caller-stable visible-ASCII idempotency_key is always required. MCP authorship is stamped by the server; callers cannot spoof it. Nested subtickets are bounded and validated by the ticket handler before any write. This never executes, sends, publishes, deletes, or mutates an external provider.
幂等
输入模式
{'type': 'object', 'allOf': [{'if': {'required': ['mode'], 'properties': {'mode': {'const': 'commit'}}}, 'then': {'required': ['preview_token']}}], 'required': ['mode', 'idempotency_key', 'tickets'], 'properties': {'mode': {'enum': ['preview', 'commit'], 'type': 'string'}, 'tickets': {'type': 'array', 'items': {'type': 'object', 'required': ['ref', 'title'], 'properties': {'ref': {'type': 'string', 'pattern': '^[A-Za-z0-9][A-Za-z0-9._:/-]{0,99}$', 'maxLength': 100, 'minLength': 1}, 'title': {'type': 'string', 'maxLength': 300, 'minLength': 1}, 'effort': {'enum': ['trivial', 'small', 'medium', 'large', 'epic', None], 'type': ['string', 'null']}, 'labels': {'type': ['array', 'null'], 'items': {'type': 'string', 'maxLength': 50, 'minLength': 1}, 'maxItems': 20}, 'status': {'enum': ['backlog', 'todo', 'in_progress', 'blocked', 'in_review', 'done', 'cancelled'], 'type': 'string', 'description': 'Terminal task states are allowed; an explicit or legacy-inferred epic cannot start done.'}, 'assignee': {'type': ['string', 'null'], 'maxLength': 100}, 'priority': {'enum': ['critical', 'high', 'medium', 'low'], 'type': 'string'}, 'session_id': {'type': ['string', 'null'], 'maxLength': 64}, 'subtickets': {'type': 'array', 'items': {'type': 'object'}, 'maxItems': 50}, 'action_type': {'enum': ['strategy', 'implementation', 'research', 'validation', 'testing', 'coordination', None], 'type': ['string', 'null']}, 'description': {'type': 'string', 'maxLength': 20000}, 'ticket_type': {'enum': ['task', 'epic', None], 'type': ['string', 'null'], 'description': "Immutable ticket kind. When omitted, legacy effort='epic' inference remains supported."}, 'external_ref': {'type': ['object', 'null'], 'maxProperties': 19, 'propertyNames': {'maxLength': 40}, 'additionalProperties': {'type': 'string', 'maxLength': 200}}, 'effort_points': {'type': ['integer', 'null']}, 'acceptance_criteria': {'type': ['string', 'null'], 'maxLength': 10000}, 'workflow_session_id': {'type': ['string', 'null'], 'maxLength': 64}}, 'additionalProperties': False}, 'maxItems': 50, 'minItems': 1}, 'parent_id': {'type': ['string', 'null'], 'format': 'uuid', 'maxLength': 36, 'minLength': 36}, 'preview_token': {'type': 'string', 'pattern': '^[0-9a-f]{64}$', 'description': 'Exact preview_token returned by preview mode.'}, 'idempotency_key': {'type': 'string', 'pattern': '^[!-~]+$', 'maxLength': 128, 'minLength': 1, 'description': 'Caller-stable visible-ASCII key. Reuse only for the exact same operation and payload.'}}, 'additionalProperties': False}
ticket_claim
Ticket Claim
Claim a ticket to work on: sets assignee to your agent name and moves it to in_progress in one step (the move is audit-logged). Refuses if another agent already has it in progress unless force=true. Follow up with ticket_comment progress updates and finish via ticket_update status='done'.
输入模式
{'type': 'object', 'required': ['ticket_id', 'assignee'], 'properties': {'force': {'type': 'boolean', 'description': 'Take over a ticket another agent holds.'}, 'assignee': {'type': 'string', 'maxLength': 100, 'description': "Your agent name, e.g. 'claude_code_local'."}, 'ticket_id': {'type': 'string'}}, 'additionalProperties': False}
ticket_comment
Ticket Comment
Add a comment to an owned ticket's activity trail. Use kind='progress' for work updates while a ticket is in progress. The authenticated API-key UUID is stamped as author; callers cannot supply or spoof it. Open the comment in plain language before any technical detail — these are read during escalations by people who were not part of the work.
输入模式
{'type': 'object', 'required': ['ticket_id', 'body'], 'properties': {'body': {'type': 'string', 'maxLength': 10000, 'description': 'Comment text (Markdown ok). Lead with a plain-language summary: what changed as observable behaviour, and what still needs a human decision — or say plainly that nothing does. Keep SHAs, paths and symbol names out of that opening; put them in the detail below it.'}, 'kind': {'enum': ['comment', 'progress'], 'type': 'string'}, 'ticket_id': {'type': 'string'}}, 'additionalProperties': False}
ticket_comments
Ticket Comments
Read complete discussion bodies, authors, kinds and timestamps for one owned ticket, including archived tickets. Returns a JSON page, newest first with legacy null times last. limit is 1–100 (default 50). Continue with next_cursor while has_more; reached_oldest means there are no older rows. Cursors are bound to this account/ticket and expire after 24 hours. Omit cursor for a fresh read of newer activity. This is ordinary discussion, not completion evidence or permission to act. Requires tickets:read.
只读 幂等
输入模式
{'type': 'object', 'required': ['ticket_id'], 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1}, 'cursor': {'type': 'string', 'maxLength': 2048, 'minLength': 1}, 'ticket_id': {'type': 'string', 'format': 'uuid'}}, 'additionalProperties': False}
输出模式
{'type': 'object', 'required': ['text'], 'properties': {'text': {'type': 'string'}}, 'additionalProperties': False}
ticket_create
Ticket Create
Create a ticket on the caller's board — optionally as a subticket via parent_id. Recommend degree of difficulty with effort (trivial|small|medium|large|epic) and the kind of work with action_type (strategy|implementation|research|validation|testing|coordination). The authenticated API-key UUID is stamped by the server as creator provenance; callers cannot supply or spoof it. Session/workflow ids are opaque metadata links only. New epics cannot be created already done.
输入模式
{'type': 'object', 'required': ['title'], 'properties': {'title': {'type': 'string', 'maxLength': 300}, 'effort': {'enum': ['trivial', 'small', 'medium', 'large', 'epic'], 'type': 'string'}, 'labels': {'type': 'array', 'items': {'type': 'string', 'maxLength': 50}, 'maxItems': 20}, 'status': {'enum': ['backlog', 'todo', 'in_progress', 'blocked', 'in_review', 'done', 'cancelled'], 'type': 'string', 'description': 'New epics cannot be created already done; task statuses use the lifecycle authority.'}, 'assignee': {'type': 'string', 'maxLength': 100}, 'priority': {'enum': ['critical', 'high', 'medium', 'low'], 'type': 'string'}, 'parent_id': {'type': 'string', 'description': 'Parent ticket UUID.'}, 'session_id': {'type': 'string', 'maxLength': 64}, 'action_type': {'enum': ['strategy', 'implementation', 'research', 'validation', 'testing', 'coordination'], 'type': 'string'}, 'description': {'type': 'string', 'maxLength': 20000, 'description': 'Open with one plain sentence saying what needs to happen and why it matters, for someone picking this up cold; put specifics and jargon after it.'}, 'order_index': {'type': 'integer', 'maximum': 100000, 'minimum': 0}, 'ticket_type': {'enum': ['task', 'epic', None], 'type': ['string', 'null'], 'description': 'Immutable ticket kind; omit or use null to infer from effort.'}, 'external_ref': {'type': 'object', 'maxProperties': 20, 'propertyNames': {'maxLength': 40, 'minLength': 1}, 'additionalProperties': {'type': 'string', 'maxLength': 200}}, 'effort_points': {'type': 'integer', 'maximum': 1000000, 'minimum': 0}, 'acceptance_criteria': {'type': 'string', 'maxLength': 10000}, 'workflow_session_id': {'type': 'string', 'maxLength': 64}}, 'additionalProperties': False}
ticket_dependency_add
Ticket Dependency Add
Record that an owned ticket cannot complete until another owned ticket is done. The edge is never erased: correct a mistake with ticket_dependency_remove, which marks the edge removed and appends to a ledger rather than deleting anything. Re-adding the same prerequisite reinstates that original edge instead of creating a second one, so an edge removed and restored says so. An edge stops blocking when the prerequisite reaches done, and only then — archiving the prerequisite does not release it. Only epics are gated, so an edge on a task is recorded and reported but never blocks its completion. Rejections carry a stable code: dependency_self (422), dependency_duplicate, dependency_cycle, dependency_graph_too_large (409), ticket_not_found (404).
输入模式
{'type': 'object', 'required': ['ticket_id', 'depends_on_ticket_id'], 'properties': {'ticket_id': {'type': 'string', 'format': 'uuid'}, 'depends_on_ticket_id': {'type': 'string', 'format': 'uuid'}}, 'additionalProperties': False}
ticket_dependency_list
Ticket Dependency List
List the prerequisites an owned ticket waits on. Read-only. Each edge reports satisfied, which is true only when the prerequisite is done, plus active/removed_at/removed_by_actor. Removed edges are omitted unless include_removed is true; they never gate completion, and are readable as history.
只读 幂等
输入模式
{'type': 'object', 'required': ['ticket_id'], 'properties': {'ticket_id': {'type': 'string', 'format': 'uuid'}, 'include_removed': {'type': 'boolean'}}, 'additionalProperties': False}
ticket_dependency_remove
Ticket Dependency Remove
Stop an owned ticket from waiting on a prerequisite. Removing the last unsatisfied edge can allow this ticket to close, so this is a gate-opening action. Nothing is deleted: the edge is retained, marked with who removed it and when, and the removal is appended to a ledger that survives everything after it. This is not a way to say the prerequisite work is finished — that remains a separate statement about that ticket. Removal is allowed even when either ticket is archived. Rejections carry a stable code: dependency_not_found (404), dependency_already_removed (409).
输入模式
{'type': 'object', 'required': ['ticket_id', 'dependency_id'], 'properties': {'ticket_id': {'type': 'string', 'format': 'uuid'}, 'dependency_id': {'type': 'string', 'format': 'uuid'}}, 'additionalProperties': False}
ticket_get
Ticket Get
Full detail for one owned ticket: description, acceptance criteria, subticket progress, and the recent activity/comment trail. ticket_id is required. Use ticket_comments for complete bodies and older discussion pages.
只读 幂等
输入模式
{'type': 'object', 'required': ['ticket_id'], 'properties': {'ticket_id': {'type': 'string'}}, 'additionalProperties': False}
ticket_label_archive
Archive Ticket Label
Hide an owned label from default suggestions without deleting its identity, assignments or history. Restore it with ticket_label_update archived=false. No ticket lifecycle, provider or permission change.
幂等
输入模式
{'type': 'object', 'required': ['label_id'], 'properties': {'label_id': {'type': 'string', 'format': 'uuid'}}, 'additionalProperties': False}
ticket_label_list
List Ticket Labels
List the private owner label catalog with retained assignment counts and separate non-archived open counts. Labels are metadata, never approval, priority, severity, assignee, readiness or access authority. No provider label writes.
只读 幂等
输入模式
{'type': 'object', 'required': [], 'properties': {'include_archived': {'type': 'boolean'}}, 'additionalProperties': False}
ticket_label_update
Edit Ticket Label Metadata
Edit color, description, group or archived state of an owned label. Explicit null clears optional metadata; identity and assigned ticket strings/history stay unchanged. Supply at least one metadata field. Archiving hides the suggestion but does not remove existing assignments.
幂等
输入模式
{'type': 'object', 'required': ['label_id'], 'properties': {'color': {'type': ['string', 'null'], 'pattern': '^#[0-9A-Fa-f]{6}$'}, 'archived': {'type': 'boolean'}, 'label_id': {'type': 'string', 'format': 'uuid'}, 'group_key': {'type': ['string', 'null'], 'maxLength': 50}, 'description': {'type': ['string', 'null'], 'maxLength': 500}}, 'additionalProperties': False}
ticket_label_upsert
Create or Restore Ticket Label
Create or restore an owner-private label by normalized name. Canonical aliases retain the first display name and identity. Optional metadata updates do not assign it to tickets or change any authority. No provider label writes.
幂等
输入模式
{'type': 'object', 'required': ['name'], 'properties': {'name': {'type': 'string', 'maxLength': 50, 'minLength': 1}, 'color': {'type': ['string', 'null'], 'pattern': '^#[0-9A-Fa-f]{6}$'}, 'group_key': {'type': ['string', 'null'], 'maxLength': 50}, 'description': {'type': ['string', 'null'], 'maxLength': 500}}, 'additionalProperties': False}
ticket_list
Ticket List
Page through the caller's tickets on the Meta Council board. The opaque next_cursor is owner- and filter-bound; keep every filter unchanged on the next call. Immutable cursor ordering keeps a stable full-board traversal exact while returned tickets are edited or reordered. Filter by status, assignee, action_type, priority, parent_id (a ticket UUID, or 'none' for root tickets only), or free-text q over title/description. With recursive=true, parent_id must be an owned UUID and all descendants (not the anchor) are returned as one flat, cycle-safe traversal. Session/workflow links are opaque metadata filters, not access grants. Start here to find work, then use ticket_get for detail and ticket_claim to take a ticket. output_format=json returns a minimized machine-readable page inside text, including labels and stored update timestamps, for read-only board mirrors. It is not a full ticket backup.
只读 幂等
输入模式
{'type': 'object', 'properties': {'q': {'type': 'string', 'maxLength': 200}, 'limit': {'type': 'integer', 'maximum': 200, 'minimum': 1}, 'scope': {'enum': ['active', 'archived', 'all'], 'type': 'string', 'default': 'active', 'description': "Archived tickets are out of the working set and hidden by default. Archiving never changed their status, so an archived ticket listed under scope='archived' still shows the status it had."}, 'cursor': {'type': 'string', 'maxLength': 2048, 'minLength': 1}, 'status': {'enum': ['backlog', 'todo', 'in_progress', 'blocked', 'in_review', 'done', 'cancelled'], 'type': 'string'}, 'assignee': {'type': 'string', 'maxLength': 100}, 'priority': {'enum': ['critical', 'high', 'medium', 'low'], 'type': 'string'}, 'parent_id': {'type': 'string', 'description': "Parent ticket UUID, or 'none' for roots only."}, 'recursive': {'type': 'boolean'}, 'labels_all': {'type': 'array', 'items': {'type': 'string', 'maxLength': 50, 'minLength': 1}, 'maxItems': 20}, 'labels_any': {'type': 'array', 'items': {'type': 'string', 'maxLength': 50, 'minLength': 1}, 'maxItems': 20}, 'session_id': {'type': 'string', 'maxLength': 64}, 'action_type': {'enum': ['strategy', 'implementation', 'research', 'validation', 'testing', 'coordination'], 'type': 'string'}, 'labels_none': {'type': 'array', 'items': {'type': 'string', 'maxLength': 50, 'minLength': 1}, 'maxItems': 20}, 'output_format': {'enum': ['markdown', 'json'], 'type': 'string', 'default': 'markdown'}, 'workflow_session_id': {'type': 'string', 'maxLength': 64}}, 'additionalProperties': False}
ticket_plan
Ticket Plan
Preview or idempotently commit an owner-private ticket tree generated from a planning prompt or supplied structured plan. Requires tickets:write. A preview without a supplied plan invokes the planner model and additionally requires councils:run; supplied-plan preview and commit are provider-free and need only tickets:write. Preview is non-mutating and returns the normalized commit payload, an exact preview_token, and deterministic predicted ticket IDs as JSON. To commit, combine that commit_payload with mode=commit, the caller-held idempotency_key, and that exact preview_token; the response returns the same IDs plus replay status. A caller-stable visible-ASCII idempotency_key is always required. This creates only in-platform planning tickets; it never runs them, sends, publishes, deletes, or changes an external provider.
可访问外部资源
输入模式
{'type': 'object', 'allOf': [{'if': {'required': ['mode'], 'properties': {'mode': {'const': 'commit'}}}, 'then': {'required': ['plan', 'preview_token']}}], 'required': ['mode', 'idempotency_key', 'prompt'], 'properties': {'mode': {'enum': ['preview', 'commit'], 'type': 'string'}, 'plan': {'type': 'object', 'required': ['tickets'], 'properties': {'summary': {'type': ['string', 'null'], 'maxLength': 2000}, 'tickets': {'type': 'array', 'items': {'type': 'object', 'required': ['title'], 'properties': {'title': {'type': 'string', 'maxLength': 300, 'minLength': 1}, 'effort': {'enum': ['trivial', 'small', 'medium', 'large', 'epic', None], 'type': ['string', 'null']}, 'labels': {'type': 'array', 'items': {'type': 'string', 'maxLength': 50, 'minLength': 1}, 'maxItems': 10}, 'assignee': {'type': ['string', 'null'], 'maxLength': 100}, 'priority': {'enum': ['critical', 'high', 'medium', 'low'], 'type': 'string'}, 'subtickets': {'type': 'array', 'items': {'type': 'object', 'required': ['title'], 'properties': {'title': {'type': 'string', 'maxLength': 300, 'minLength': 1}, 'effort': {'enum': ['trivial', 'small', 'medium', 'large', 'epic', None], 'type': ['string', 'null']}, 'labels': {'type': 'array', 'items': {'type': 'string', 'maxLength': 50, 'minLength': 1}, 'maxItems': 10}, 'assignee': {'type': ['string', 'null'], 'maxLength': 100}, 'priority': {'enum': ['critical', 'high', 'medium', 'low'], 'type': 'string'}, 'subtickets': {'type': 'array', 'maxItems': 0}, 'action_type': {'enum': ['strategy', 'implementation', 'research', 'validation', 'testing', 'coordination', None], 'type': ['string', 'null']}, 'description': {'type': ['string', 'null'], 'maxLength': 20000}, 'acceptance_criteria': {'type': ['string', 'null'], 'maxLength': 10000}, 'assignee_suggestion': {'type': ['string', 'null'], 'maxLength': 100}}, 'additionalProperties': False}, 'maxItems': 30}, 'action_type': {'enum': ['strategy', 'implementation', 'research', 'validation', 'testing', 'coordination', None], 'type': ['string', 'null']}, 'description': {'type': ['string', 'null'], 'maxLength': 20000}, 'acceptance_criteria': {'type': ['string', 'null'], 'maxLength': 10000}, 'assignee_suggestion': {'type': ['string', 'null'], 'maxLength': 100}}, 'additionalProperties': False}, 'maxItems': 30, 'minItems': 1}, 'behavior': {'type': ['string', 'null'], 'maxLength': 2000}, 'plan_title': {'type': ['string', 'null'], 'maxLength': 300}}, 'additionalProperties': False}, 'model': {'type': 'string', 'maxLength': 100}, 'prompt': {'type': 'string', 'maxLength': 8000, 'minLength': 1}, 'context': {'type': ['string', 'null'], 'maxLength': 8000}, 'session_id': {'type': ['string', 'null'], 'maxLength': 64}, 'auto_assign': {'type': 'boolean'}, 'max_tickets': {'type': 'integer', 'maximum': 30, 'minimum': 1}, 'preview_token': {'type': 'string', 'pattern': '^[0-9a-f]{64}$', 'description': 'Exact preview_token returned by preview mode.'}, 'idempotency_key': {'type': 'string', 'pattern': '^[!-~]+$', 'maxLength': 128, 'minLength': 1, 'description': 'Caller-stable visible-ASCII key. Reuse only for the exact same operation and payload.'}}, 'additionalProperties': False}
ticket_readiness
Ticket Readiness
Explain why an owned ticket is not ready to close, using the same readiness check as the browser. Returns gated, ready, and the complete bounded blocker list with each code, reference_id and message. An unready ticket is a successful diagnostic, not a tool failure. This snapshot does not authorize completion or change tickets, scenarios, evidence or validation-attempt budgets. Requires authentication and tickets:read; tickets:write also permits reading.
只读 幂等
输入模式
{'type': 'object', 'required': ['ticket_id'], 'properties': {'ticket_id': {'type': 'string', 'format': 'uuid', 'pattern': '^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$', 'maxLength': 36, 'minLength': 36}}, 'additionalProperties': False}
ticket_scenario_create
Ticket Scenario Create
Author one Given/When/Then scenario on an owned ticket. This is the specification an epic must carry before it can be completed: record a passing run against it with ticket_validation_finalize, then transition the epic. The server owns revision 1 and returns current_version and current_definition_hash — pass those exact values to ticket_validation_finalize. Authoring a scenario is not evidence; it states what must be proven, not that it was.
输入模式
{'type': 'object', 'required': ['ticket_id', 'name', 'given_steps', 'when_steps', 'then_steps'], 'properties': {'name': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'required': {'type': 'boolean'}, 'ticket_id': {'type': 'string', 'format': 'uuid'}, 'then_steps': {'type': 'array', 'items': {'type': 'string', 'maxLength': 1000, 'minLength': 1}, 'maxItems': 50, 'minItems': 1, 'description': 'Ordered clause steps; blank-only steps are rejected.'}, 'when_steps': {'type': 'array', 'items': {'type': 'string', 'maxLength': 1000, 'minLength': 1}, 'maxItems': 50, 'minItems': 1, 'description': 'Ordered clause steps; blank-only steps are rejected.'}, 'given_steps': {'type': 'array', 'items': {'type': 'string', 'maxLength': 1000, 'minLength': 1}, 'maxItems': 50, 'minItems': 1, 'description': 'Ordered clause steps; blank-only steps are rejected.'}, 'order_index': {'type': 'integer', 'maximum': 100000, 'minimum': 0}, 'scenario_key': {'type': ['string', 'null'], 'maxLength': 64}}, 'additionalProperties': False}
ticket_scenario_list
Ticket Scenario List
List an owned ticket's scenarios with their exact current revisions, including the current_version and current_definition_hash that ticket_validation_finalize requires. Read-only. Use it before recording a run to confirm which revision is current, and to see why an epic still reports required_scenario_missing.
只读 幂等
输入模式
{'type': 'object', 'required': ['ticket_id'], 'properties': {'ticket_id': {'type': 'string', 'format': 'uuid'}, 'include_archived': {'type': 'boolean'}}, 'additionalProperties': False}
ticket_scenario_revise
Ticket Scenario Revise
Replace an owned scenario's content, compare-and-swapping on expected_version. Revisions are append-only: validation runs already recorded keep naming the exact version and hash they were proven against, so revising never rewrites past evidence — it does mean the epic needs a fresh passing run against the new version. A stale expected_version conflicts rather than overwriting a concurrent edit.
输入模式
{'type': 'object', 'required': ['ticket_id', 'scenario_id', 'expected_version', 'name', 'given_steps', 'when_steps', 'then_steps'], 'properties': {'name': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'ticket_id': {'type': 'string', 'format': 'uuid'}, 'then_steps': {'type': 'array', 'items': {'type': 'string', 'maxLength': 1000, 'minLength': 1}, 'maxItems': 50, 'minItems': 1, 'description': 'Ordered clause steps; blank-only steps are rejected.'}, 'when_steps': {'type': 'array', 'items': {'type': 'string', 'maxLength': 1000, 'minLength': 1}, 'maxItems': 50, 'minItems': 1, 'description': 'Ordered clause steps; blank-only steps are rejected.'}, 'given_steps': {'type': 'array', 'items': {'type': 'string', 'maxLength': 1000, 'minLength': 1}, 'maxItems': 50, 'minItems': 1, 'description': 'Ordered clause steps; blank-only steps are rejected.'}, 'scenario_id': {'type': 'string', 'format': 'uuid'}, 'expected_version': {'type': 'integer', 'minimum': 1}}, 'additionalProperties': False}
ticket_transition
Ticket Transition
Change an owned ticket's status through the existing lifecycle gate. For an epic completion, persist completion_idempotency_key before calling and retry the same request after an uncertain response. Reopening a terminal epic requires the exact expected_completed_at and, for an attested completion, expected_completion_record_id from ticket_authority. Stale coordinates and unready completions refuse without changing status. Reconcile uncertain reopen responses with ticket_authority. Returns committed transition and ticket JSON. Requires tickets:write.
输入模式
{'type': 'object', 'required': ['ticket_id', 'status'], 'properties': {'status': {'enum': ['backlog', 'todo', 'in_progress', 'blocked', 'in_review', 'done', 'cancelled'], 'type': 'string'}, 'ticket_id': {'type': 'string', 'format': 'uuid', 'pattern': '^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$'}, 'expected_completed_at': {'type': 'string', 'format': 'date-time', 'pattern': '^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d{1,6})?(?:Z|[+-]\\d{2}:\\d{2})$', 'maxLength': 40}, 'completion_idempotency_key': {'type': 'string', 'pattern': '^[!-~]+$', 'maxLength': 128, 'minLength': 1}, 'expected_completion_record_id': {'type': 'string', 'format': 'uuid', 'pattern': '^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$'}}, 'additionalProperties': False}
ticket_update
Ticket Update
Update fields on an owned ticket — status moves (each one is auto-logged to the ticket's audit trail), reassignment, priority/effort/action_type recommendations, title/description edits, safe reparenting, opaque session/workflow links, effort points, order, and user-owned external refs. Clear flags are explicit so stdio clients never lose JSON nulls. System-owned provider, Accounting, plan, and batch refs are preserved and cannot be spoofed. The authenticated API-key UUID is stamped on the audit trail. Epic completion and terminal reopen fail closed on this generic tool until an explicit lifecycle operation supplies retry/version evidence.
输入模式
{'type': 'object', 'required': ['ticket_id'], 'properties': {'title': {'type': 'string', 'maxLength': 300}, 'effort': {'enum': ['trivial', 'small', 'medium', 'large', 'epic'], 'type': 'string'}, 'labels': {'type': 'array', 'items': {'type': 'string', 'maxLength': 50}, 'maxItems': 20}, 'status': {'enum': ['backlog', 'todo', 'in_progress', 'blocked', 'in_review', 'done', 'cancelled'], 'type': 'string', 'description': 'Task moves are audited. Epic done or terminal reopen requires an explicit lifecycle operation with retry/version evidence.'}, 'assignee': {'type': 'string', 'maxLength': 100}, 'priority': {'enum': ['critical', 'high', 'medium', 'low'], 'type': 'string'}, 'parent_id': {'type': 'string', 'format': 'uuid'}, 'ticket_id': {'type': 'string'}, 'labels_add': {'type': 'array', 'items': {'type': 'string', 'maxLength': 50, 'minLength': 1}, 'maxItems': 20}, 'session_id': {'type': 'string', 'maxLength': 64}, 'action_type': {'enum': ['strategy', 'implementation', 'research', 'validation', 'testing', 'coordination'], 'type': 'string'}, 'description': {'type': 'string', 'maxLength': 20000}, 'order_index': {'type': 'integer', 'maximum': 100000, 'minimum': 0}, 'clear_parent': {'type': 'boolean'}, 'external_ref': {'type': 'object', 'maxProperties': 20, 'propertyNames': {'maxLength': 40, 'minLength': 1}, 'additionalProperties': {'type': 'string', 'maxLength': 200}}, 'clear_session': {'type': 'boolean'}, 'effort_points': {'type': 'integer', 'maximum': 1000000, 'minimum': 0}, 'labels_remove': {'type': 'array', 'items': {'type': 'string', 'maxLength': 50, 'minLength': 1}, 'maxItems': 20}, 'acceptance_criteria': {'type': 'string', 'maxLength': 10000}, 'clear_effort_points': {'type': 'boolean'}, 'workflow_session_id': {'type': 'string', 'maxLength': 64}, 'clear_workflow_session': {'type': 'boolean'}, 'expected_label_revision': {'type': 'integer', 'maximum': 2147483647, 'minimum': 0}}, 'additionalProperties': False}
ticket_validation_finalize
Ticket Validation Finalize
Finalize one immutable validation run for an exact owned ticket scenario revision. Requires the opt-in tickets:validate scope. The server derives owner and actor only from the authenticated API key. Evidence payloads are bounded opaque JSON objects; locator-looking strings are recorded but never opened, resolved, redirected, or fetched. Exact retries by the same credential actor return the original receipt; a changed actor or changed content under the same key conflicts.
幂等
输入模式
{'type': 'object', 'required': ['ticket_id', 'scenario_id', 'scenario_version', 'scenario_hash', 'verdict', 'runner', 'environment', 'source_revision', 'evidence', 'idempotency_key'], 'properties': {'runner': {'type': 'string', 'maxLength': 120, 'minLength': 1}, 'summary': {'type': ['string', 'null'], 'maxLength': 10000}, 'verdict': {'enum': ['passed', 'failed', 'skipped', 'blocked'], 'type': 'string'}, 'evidence': {'type': 'array', 'items': {'type': 'object', 'required': ['kind', 'payload'], 'properties': {'kind': {'enum': ['assertion', 'artifact', 'log', 'metric', 'link'], 'type': 'string'}, 'payload': {'type': 'object'}}, 'additionalProperties': False}, 'maxItems': 100}, 'ticket_id': {'type': 'string', 'format': 'uuid'}, 'environment': {'type': 'string', 'maxLength': 120, 'minLength': 1}, 'scenario_id': {'type': 'string', 'format': 'uuid'}, 'scenario_hash': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'idempotency_key': {'type': 'string', 'pattern': '^[!-~]+$', 'maxLength': 128, 'minLength': 1}, 'source_revision': {'type': 'string', 'maxLength': 160, 'minLength': 1}, 'scenario_version': {'type': 'integer', 'minimum': 1}}, 'additionalProperties': False}
triage_meta_council_feedback
Triage Meta Council Feedback
ADMIN ONLY: triage a platform-feedback report — set its status and/or admin notes (requires an ADMIN_EMAILS account; everyone else gets a permission error). Get the full feedback id from list_meta_council_feedback.
输入模式
{'type': 'object', 'required': ['feedback_id'], 'properties': {'status': {'enum': ['new', 'triaged', 'planned', 'resolved', 'dismissed'], 'type': 'string'}, 'admin_notes': {'type': 'string', 'maxLength': 8000, 'description': 'Triage notes; an empty string clears them.'}, 'feedback_id': {'type': 'string', 'description': 'Full feedback UUID from list_meta_council_feedback.'}}, 'additionalProperties': False}
unshare_saved_view
Unshare Saved View
Make one of YOUR OWN shared saved views private again. Idempotent. Revocation is immediate: team membership is resolved on every read and never copied into a grant, so this takes effect on each member's next request. Requires authentication and the tickets:write scope.
输入模式
{'type': 'object', 'required': ['view_id'], 'properties': {'view_id': {'type': 'string', 'maxLength': 64, 'minLength': 1, 'description': "The view's id, from list_saved_views."}, 'expected_revision': {'type': 'integer', 'maximum': 2147483647, 'minimum': 0, 'description': 'Current definition_revision, required to configure a scorecard or change any previously enrolled view. On conflict or uncertain reply, read current state and deliberately reconcile; this is not an exact-retry receipt.'}}, 'additionalProperties': False}
update_consulting_client
Update Consulting Client
Update mutable fields on an owned consulting client.
输入模式
{'type': 'object', 'required': ['client_id'], 'properties': {'name': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'notes': {'type': 'string', 'maxLength': 50000}, 'status': {'enum': ['active', 'inactive'], 'type': 'string'}, 'client_id': {'type': 'string', 'format': 'uuid'}, 'contact_name': {'type': 'string', 'maxLength': 200}, 'organization': {'type': 'string', 'maxLength': 200}, 'contact_email': {'type': 'string', 'maxLength': 255}}, 'additionalProperties': False}
update_consulting_deliverable
Update Consulting Deliverable
Edit an internal draft deliverable; review/approval state is separate.
输入模式
{'type': 'object', 'required': ['deliverable_id'], 'properties': {'title': {'type': 'string', 'maxLength': 300, 'minLength': 1}, 'due_date': {'type': 'string', 'format': 'date'}, 'description': {'type': 'string', 'maxLength': 50000}, 'milestone_id': {'type': 'string', 'format': 'uuid'}, 'deliverable_id': {'type': 'string', 'format': 'uuid'}}, 'additionalProperties': False}
update_consulting_document_revision
Update Consulting Document Revision
Edit an unapproved proposal/SOW revision; approved revisions are immutable.
输入模式
{'type': 'object', 'required': ['document_id'], 'properties': {'body': {'type': 'string', 'maxLength': 50000, 'minLength': 1}, 'title': {'type': 'string', 'maxLength': 300, 'minLength': 1}, 'document_id': {'type': 'string', 'format': 'uuid'}}, 'additionalProperties': False}
update_consulting_engagement
Update Consulting Engagement
Update mutable fields on an owned consulting engagement.
输入模式
{'type': 'object', 'required': ['engagement_id'], 'properties': {'title': {'type': 'string', 'maxLength': 300, 'minLength': 1}, 'status': {'enum': ['draft', 'active', 'on_hold', 'completed', 'cancelled'], 'type': 'string'}, 'client_id': {'type': 'string', 'format': 'uuid'}, 'objective': {'type': 'string', 'maxLength': 50000}, 'start_date': {'type': 'string', 'format': 'date'}, 'engagement_id': {'type': 'string', 'format': 'uuid'}, 'sales_deal_ref': {'type': 'string', 'maxLength': 240}, 'target_end_date': {'type': 'string', 'format': 'date'}, 'accounting_run_ref': {'type': 'string', 'maxLength': 240}}, 'additionalProperties': False}
update_consulting_milestone
Update Consulting Milestone
Update an owned consulting milestone while preserving its stable ref.
输入模式
{'type': 'object', 'required': ['milestone_id', 'expected_version'], 'properties': {'title': {'type': 'string', 'maxLength': 300, 'minLength': 1}, 'status': {'enum': ['planned', 'in_progress', 'blocked', 'done'], 'type': 'string'}, 'due_date': {'type': 'string', 'format': 'date'}, 'description': {'type': 'string', 'maxLength': 50000}, 'order_index': {'type': 'integer', 'maximum': 10000, 'minimum': 0}, 'milestone_id': {'type': 'string', 'format': 'uuid'}, 'expected_version': {'type': 'integer', 'minimum': 1}}, 'additionalProperties': False}
update_content_asset
Update Content Asset
Edit an owned draft. Submitted/approved/rejected revisions are immutable and must be revised.
输入模式
{'type': 'object', 'required': ['asset_id'], 'properties': {'title': {'type': 'string', 'maxLength': 240, 'minLength': 1}, 'channel': {'type': 'string', 'maxLength': 40, 'minLength': 1}, 'content': {'type': 'string', 'maxLength': 100000, 'minLength': 1}, 'asset_id': {'type': 'string', 'description': 'Full UUID from the matching list tool.'}, 'asset_type': {'type': 'string', 'maxLength': 40, 'minLength': 1}, 'scheduled_for': {'type': 'string', 'format': 'date-time'}, 'revision_notes': {'type': 'string', 'maxLength': 10000}}, 'additionalProperties': False}
update_deal
Update Deal
Update one of the caller's deals — most commonly to ADVANCE its stage (e.g. discovery -> proposal). Moving to closed_won/closed_lost stamps the close date; reopening to an open stage clears it. Only the fields you pass change; deal_id is required.
输入模式
{'type': 'object', 'required': ['deal_id'], 'properties': {'notes': {'type': 'string'}, 'stage': {'enum': ['qualification', 'discovery', 'proposal', 'negotiation', 'closed_won', 'closed_lost'], 'type': 'string'}, 'title': {'type': 'string', 'maxLength': 200}, 'amount': {'type': 'number', 'maximum': 999999999999, 'minimum': 0}, 'company': {'type': 'string', 'maxLength': 200}, 'deal_id': {'type': 'string'}, 'currency': {'type': 'string', 'pattern': '^[A-Za-z]{3}$', 'maxLength': 3, 'minLength': 3, 'description': 'Exactly three ASCII letters, such as USD; saved uppercase. Omit to keep the current currency. Syntax only, not an ISO registry.'}, 'probability': {'type': 'integer', 'maximum': 100, 'minimum': 0}, 'expected_close_date': {'type': 'string', 'description': 'ISO date YYYY-MM-DD.'}}, 'additionalProperties': False}
update_invoice
Update Invoice
Update a draft or sent invoice's header fields (client, terms, due date, tax rate, notes). Only the fields you pass change. Blocked once paid/void — void and re-issue instead. invoice_id is required.
输入模式
{'type': 'object', 'required': ['invoice_id'], 'properties': {'notes': {'type': 'string', 'maxLength': 10000}, 'currency': {'type': 'string', 'pattern': '^[A-Za-z]{3}$', 'maxLength': 3, 'minLength': 3, 'description': 'Three ASCII letters; normalized to uppercase. ISO membership is not checked.'}, 'due_date': {'type': 'string', 'description': 'ISO date YYYY-MM-DD.'}, 'tax_rate': {'type': 'number', 'maximum': 100, 'minimum': 0}, 'invoice_id': {'type': 'string'}, 'client_name': {'type': 'string', 'maxLength': 200}, 'client_email': {'type': 'string', 'maxLength': 320}, 'payment_terms': {'type': 'string', 'maxLength': 100}}, 'additionalProperties': False}
update_marketing_audience
Update Marketing Audience
Update fields on one owned audience definition. No delete is exposed over MCP.
输入模式
{'type': 'object', 'required': ['audience_id'], 'properties': {'name': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'channels': {'type': 'array', 'items': {'type': 'string', 'maxLength': 40}, 'maxItems': 20}, 'audience_id': {'type': 'string', 'description': 'Full UUID from the matching list tool.'}, 'description': {'type': 'string', 'maxLength': 20000}, 'pain_points': {'type': 'string', 'maxLength': 20000}}, 'additionalProperties': False}
update_marketing_brand
Update Marketing Brand
Update fields on one owned brand identity. No delete is exposed over MCP.
输入模式
{'type': 'object', 'required': ['brand_id'], 'properties': {'name': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'voice': {'type': 'string', 'maxLength': 10000}, 'brand_id': {'type': 'string', 'description': 'Full UUID from the matching list tool.'}, 'guidelines': {'type': 'string', 'maxLength': 20000}, 'value_proposition': {'type': 'string', 'maxLength': 10000}}, 'additionalProperties': False}
update_marketing_campaign
Update Marketing Campaign
Update one owned marketing campaign. Campaign status never publishes content.
输入模式
{'type': 'object', 'required': ['campaign_id'], 'properties': {'name': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'status': {'enum': ['draft', 'planned', 'active', 'paused', 'completed', 'archived'], 'type': 'string'}, 'ends_on': {'type': 'string', 'format': 'date'}, 'brand_id': {'type': 'string', 'description': 'Full UUID from the matching list tool.'}, 'channels': {'type': 'array', 'items': {'type': 'string', 'maxLength': 40}, 'maxItems': 20}, 'objective': {'type': 'string', 'maxLength': 20000}, 'starts_on': {'type': 'string', 'format': 'date'}, 'audience_id': {'type': 'string', 'description': 'Full UUID from the matching list tool.'}, 'campaign_id': {'type': 'string', 'description': 'Full UUID from the matching list tool.'}}, 'additionalProperties': False}
update_outreach_lead_status
Update Outreach Lead Status
Advance a lead through the pipeline — set its status / pipeline stage and, optionally, a recorded reply, pitch, or notes. The core pipeline-drive action. Idempotent (setting the same status twice is a no-op). Requires authentication.
输入模式
{'type': 'object', 'required': ['lead_id'], 'properties': {'notes': {'type': 'string', 'description': 'Optional free-text notes.'}, 'status': {'type': 'string', 'description': "New pipeline status (e.g. 'ready', 'sent', 'replied', 'closed_won', 'closed_lost')."}, 'lead_id': {'type': 'string', 'description': 'Lead id to update (from search_outreach_leads).'}, 'pitch_id': {'type': 'string', 'description': 'Optional pitch id to attach to the lead.'}, 'response_text': {'type': 'string', 'description': 'Optional recorded reply text.'}, 'response_type': {'type': 'string', 'description': "Optional reply classification (e.g. 'positive', 'negative', 'neutral')."}}, 'additionalProperties': False}
update_portfolio_schedule
Update Portfolio Schedule
Replace the full definition of an owned report schedule using its current expected_revision. Preserve project_id from project_list when retaining project scope; omission or null selects portfolio scope. Pause with enabled=false; archive also disables, and restore paused. Editing an enabled schedule starts at its next future occurrence. Reuse the exact request_id and request for recovery; an exact retry returns the original receipt, so read current state afterward. Requires tickets:write.
幂等
输入模式
{'type': 'object', 'title': 'ScheduleUpdate', 'required': ['request_id', 'definition', 'expected_revision', 'schedule_id'], 'properties': {'definition': {'type': 'object', 'title': 'ScheduleDefinition', 'required': ['name', 'frequency', 'timezone', 'hour', 'minute'], 'properties': {'hour': {'type': 'integer', 'title': 'Hour', 'maximum': 23, 'minimum': 0}, 'name': {'type': 'string', 'title': 'Name', 'maxLength': 200, 'minLength': 1}, 'minute': {'type': 'integer', 'title': 'Minute', 'maximum': 59, 'minimum': 0}, 'enabled': {'type': 'boolean', 'title': 'Enabled', 'default': False}, 'weekday': {'anyOf': [{'type': 'integer', 'maximum': 6, 'minimum': 0}, {'type': 'null'}], 'title': 'Weekday', 'default': None}, 'archived': {'type': 'boolean', 'title': 'Archived', 'default': False}, 'monthday': {'anyOf': [{'type': 'integer', 'maximum': 31, 'minimum': 1}, {'type': 'null'}], 'title': 'Monthday', 'default': None}, 'timezone': {'type': 'string', 'title': 'Timezone', 'maxLength': 100, 'minLength': 1}, 'frequency': {'enum': ['daily', 'weekly', 'monthly'], 'type': 'string', 'title': 'Frequency'}, 'project_id': {'anyOf': [{'type': 'string', 'format': 'uuid'}, {'type': 'null'}], 'title': 'Project Id', 'default': None, 'description': 'Owned project UUID from project_list. Omit or pass null for a portfolio-wide schedule; project identity is frozen in each capture.'}}, 'additionalProperties': False}, 'request_id': {'type': 'string', 'title': 'Request Id', 'format': 'uuid'}, 'schedule_id': {'type': 'string', 'format': 'uuid'}, 'expected_revision': {'type': 'integer', 'title': 'Expected Revision', 'maximum': 2147483646, 'minimum': 1}}, 'additionalProperties': False}
update_saved_view
Update Saved View
Revise one of YOUR OWN saved views in place, keeping its id and any existing team share. Only the fields you send change; the rest are left exactly as they were, while scorecard-enrolled views require the current definition_revision; after a conflict or uncertain reply, read current state and deliberately reconcile. Sharing a view does not let its readers revise it -- only the owner may. Requires authentication and the tickets:write scope.
输入模式
{'type': 'object', 'required': ['view_id'], 'properties': {'name': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'New name for the view.'}, 'columns': {'type': 'array', 'items': {'type': 'string'}, 'maxItems': 20, 'description': 'Replacement column list, in order. At most 20.'}, 'filters': {'type': 'object', 'properties': {'q': {'type': 'string', 'description': 'Saved-view filter: q.'}, 'kind': {'type': 'string', 'description': 'Saved-view filter: kind.'}, 'scope': {'enum': ['active', 'archived', 'all'], 'type': 'string', 'default': 'active', 'description': 'Saved-view filter: scope.'}, 'state': {'enum': [None, 'unresolved', 'resolved', 'all'], 'type': ['string', 'null'], 'description': 'Saved-view filter: state.'}, 'reader': {'enum': ['tickets', 'attention', 'reviewed_attention'], 'type': 'string', 'default': 'tickets', 'description': 'Saved-view filter: reader.'}, 'reason': {'enum': [None, 'stale', 'aging', 'blocked', 'dependency_blocked', 'completion_blocked', 'missed_due_date', 'integration_drift', 'forecast_degradation'], 'type': ['string', 'null'], 'description': 'Saved-view filter: reason.'}, 'status': {'type': 'string', 'description': 'Saved-view filter: status.'}, 'assignee': {'type': 'string', 'description': 'Saved-view filter: assignee.'}, 'priority': {'type': 'string', 'description': 'Saved-view filter: priority.'}, 'follow_up': {'enum': [None, 'all', 'due'], 'type': ['string', 'null'], 'description': 'Saved-view filter: follow_up.'}, 'parent_id': {'type': 'string', 'description': 'Saved-view filter: parent_id.'}, 'recursive': {'type': 'boolean', 'description': 'Saved-view filter: recursive.'}, 'session_id': {'type': 'string', 'description': 'Saved-view filter: session_id.'}, 'action_type': {'type': 'string', 'description': 'Saved-view filter: action_type.'}, 'workflow_session_id': {'type': 'string', 'description': 'Saved-view filter: workflow_session_id.'}}, 'description': 'Saved question. Omitted reader selects ordinary tickets. Attention accepts reason; reviewed_attention accepts state and follow_up. Triage refuses other non-default ticket filters, grouping and sorting. Save intent only, never result pages.', 'additionalProperties': False}, 'sort_by': {'type': ['string', 'null'], 'description': 'New sorting field; null clears it. Clear explicit grouping and sorting when switching to triage.'}, 'view_id': {'type': 'string', 'maxLength': 64, 'minLength': 1, 'description': "The view's id, from list_saved_views."}, 'group_by': {'type': ['string', 'null'], 'description': 'New grouping field; null clears it. Clear explicit grouping and sorting when switching to triage.'}, 'sort_dir': {'enum': ['asc', 'desc'], 'type': 'string', 'description': 'New sort direction.'}, 'scorecard': {'type': ['object', 'null'], 'required': ['version', 'preset', 'cards'], 'properties': {'cards': {'type': 'array', 'items': {'type': 'object', 'required': ['metric', 'threshold'], 'properties': {'metric': {'enum': ['total', 'open', 'todo', 'in_progress', 'blocked', 'done', 'cancelled'], 'type': 'string'}, 'threshold': {'type': ['object', 'null'], 'required': ['operator', 'value'], 'properties': {'value': {'type': 'integer', 'maximum': 2147483647, 'minimum': 0}, 'operator': {'enum': ['gte', 'lte'], 'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'maxItems': 7, 'minItems': 1}, 'preset': {'enum': ['custom', 'executive', 'pmo', 'manager'], 'type': 'string'}, 'version': {'type': 'integer', 'const': 1}}, 'description': 'Optional private ordinary live ticket counts; omit to retain, null to clear while retaining a nonzero revision. At most 10000 matching tickets, no actions or role grants. Shared and triage definitions cannot enroll.', 'additionalProperties': False}, 'expected_revision': {'type': 'integer', 'maximum': 2147483647, 'minimum': 0, 'description': 'Current definition_revision, required to configure a scorecard or change any previously enrolled view. On conflict or uncertain reply, read current state and deliberately reconcile; this is not an exact-retry receipt.'}}, 'additionalProperties': False}
update_workflow_template
Update Workflow Template
Replace an existing custom workflow template's definition. This is a full replacement, not a patch: supply name and steps as you want them to end up, because anything omitted is not carried over. Built-in templates are read-only, and only the template's owner may change it. Legacy workflows run in dependency order; steps ready together share one bounded parallel layer, while no depends_on keeps authored list order. Explicitly routed workflows use next_step and bounded quality-gate transitions and cannot mix those fields with depends_on. Requires authentication and the workflows:write scope.
输入模式
{'type': 'object', 'required': ['slug'], 'properties': {'name': {'type': 'string', 'maxLength': 120, 'minLength': 1, 'description': 'Template name after the update.'}, 'slug': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'Slug of the template to replace, from list_workflows.'}, 'tags': {'type': 'array', 'items': {'type': 'string', 'maxLength': 64, 'minLength': 1}, 'maxItems': 20, 'description': 'Tags after the update.'}, 'steps': {'type': 'array', 'items': {'type': 'object', 'allOf': [{'not': {'required': ['id', 'step_id']}}], 'required': ['name', 'agent_template'], 'properties': {'id': {'type': 'string', 'pattern': '^[A-Za-z0-9][A-Za-z0-9_.:-]*$', 'maxLength': 100, 'minLength': 1, 'description': 'Optional stable identifier for this step. Supply one only if another step names it in depends_on.'}, 'name': {'type': 'string', 'maxLength': 120, 'minLength': 1, 'description': "Human-readable step name, e.g. 'Draft the brief'."}, 'role': {'type': 'string', 'maxLength': 200, 'description': 'Optional short role label shown alongside the step.'}, 'type': {'enum': ['agent', 'transform', 'connector'], 'type': 'string', 'description': "Optional executable node kind. Defaults to 'agent', which asks a model a question. 'transform' runs a supported deterministic local operation; 'connector' invokes the configured connector runtime and fails that step if the runtime is unavailable."}, 'model': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': "Optional model id override for this step; omit to use the agent template's own model."}, 'tools': {'type': 'array', 'items': {'type': 'string', 'minLength': 1}, 'maxItems': 100, 'description': 'Optional subset of persona tools. [] disables tools for supplied-evidence drafts; omission inherits.', 'uniqueItems': True}, 'params': {'type': 'object', 'description': "Optional configuration for a non-agent step. Must be omitted or empty for an 'agent' step, whose configuration is the named fields above (model, temperature, instruction, ...); params would be silently ignored there, so it is refused."}, 'step_id': {'type': 'string', 'pattern': '^[A-Za-z0-9][A-Za-z0-9_.:-]*$', 'maxLength': 100, 'minLength': 1, 'description': 'Canonical stable identifier for routed steps. Do not supply both step_id and the legacy id field.'}, 'next_step': {'type': 'string', 'pattern': '^(?:__end__|[A-Za-z0-9][A-Za-z0-9_.:-]*)$', 'maxLength': 100, 'minLength': 1, 'description': 'Optional next step id for an explicitly routed workflow. Do not combine routed fields with depends_on.'}, 'checkpoint': {'type': 'boolean', 'description': 'Whether the run pauses for human approval after this step. Defaults to true when omitted.'}, 'depends_on': {'type': 'array', 'items': {'type': 'string', 'pattern': '^[A-Za-z0-9][A-Za-z0-9_.:-]*$', 'maxLength': 100, 'minLength': 1}, 'maxItems': 20, 'description': 'Optional ids of steps this one builds on. A step starts only once every id it names has finished. Steps ready together share one bounded parallel layer in authored order. A definition with no arrows still runs in list order. Do not combine depends_on with routed fields.'}, 'human_gate': {'type': 'boolean', 'description': 'Require approval from the authenticated human review UI. API-key and MCP callers cannot cross this gate.'}, 'max_tokens': {'type': 'integer', 'maximum': 65536, 'minimum': 1, 'description': 'Optional output token cap for this step.'}, 'instruction': {'type': 'string', 'maxLength': 20000, 'description': 'Optional step-specific instruction for the agent.'}, 'temperature': {'type': 'number', 'maximum': 2.0, 'minimum': 0.0, 'description': 'Optional sampling temperature override for this step.'}, 'quality_gate': {'type': 'object', 'allOf': [{'if': {'required': ['schema'], 'properties': {'schema': {'const': 'scope_decision/v1'}}}, 'then': {'properties': {'max_iterations': {'const': 1}, 'blocking_severities': {'const': ['P0', 'P1']}}}}], 'required': ['schema', 'loop_to', 'pass_to', 'max_iterations'], 'properties': {'schema': {'enum': ['severity_findings/v1', 'scope_decision/v1'], 'type': 'string'}, 'loop_to': {'type': 'string', 'pattern': '^[A-Za-z0-9][A-Za-z0-9_.:-]*$', 'maxLength': 100, 'minLength': 1}, 'pass_to': {'type': 'string', 'pattern': '^(?:__end__|[A-Za-z0-9][A-Za-z0-9_.:-]*)$', 'maxLength': 100, 'minLength': 1}, 'max_iterations': {'type': 'integer', 'maximum': 5, 'minimum': 1}, 'blocking_severities': {'type': 'array', 'items': {'enum': ['P0', 'P1', 'P2', 'P3', 'P4', 'P5'], 'type': 'string'}, 'maxItems': 6, 'minItems': 1, 'uniqueItems': True}}, 'additionalProperties': False}, 'agent_template': {'type': 'string', 'pattern': '^[a-z0-9][a-z0-9_-]*$', 'maxLength': 100, 'minLength': 1, 'description': 'Slug of the agent template this step runs, from list_agents.'}, 'requires_distinct_provider_from': {'type': 'string', 'pattern': '^[A-Za-z0-9][A-Za-z0-9_.:-]*$', 'maxLength': 100, 'minLength': 1, 'description': "Require this step's actual provider to differ from the provider that produced the named earlier step."}}, 'additionalProperties': False}, 'maxItems': 20, 'minItems': 1, 'description': 'The complete step list after the update, in run order.'}, 'domain': {'type': 'string', 'maxLength': 80, 'minLength': 1, 'description': 'Grouping domain after the update.'}, 'description': {'type': 'string', 'maxLength': 4000, 'description': 'Description after the update.'}, 'expected_template_fingerprint': {'type': 'string', 'maxLength': 64, 'minLength': 64, 'description': 'Optional. The definition fingerprint you last saw for this template, returned by update_workflow_template when it last succeeded. Supply it and the write refuses, changing nothing, if the stored template is no longer the one that fingerprint names -- someone else edited or deleted it since you read it. Omit it and the write proceeds as it always has, overwriting whatever is there. This is not the definition_sha reported for a run: that one also reflects global configuration, this one names the stored file alone.'}}, 'additionalProperties': False}
void_invoice
Void Invoice
Void a draft or sent invoice. Cannot be applied to an already-paid invoice (issue a credit note instead). invoice_id is required. No delete tool is exposed over MCP — void is the terminal non-destructive state.
输入模式
{'type': 'object', 'required': ['invoice_id'], 'properties': {'invoice_id': {'type': 'string'}}, 'additionalProperties': False}
已添加
get_ticket_provider_field_options
2026年10月1日 02:54
已添加
get_ticket_provider_field_request
2026年10月1日 02:54
已添加
list_ticket_provider_fields
2026年10月1日 02:54
已添加
archive_ticket_provider_fields
2026年10月1日 02:54
已添加
check_ticket_provider_fields
2026年10月1日 02:54
已添加
link_ticket_provider_fields
2026年10月1日 02:54
已添加
cancel_booking
2026年10月1日 02:54
已添加
reschedule_booking
2026年10月1日 02:54
已添加
book_meeting
2026年10月1日 02:54
已添加
preview_scheduling_action
2026年10月1日 02:54
已添加
list_booking_followups
2026年10月1日 02:54
已添加
get_booking
2026年10月1日 02:54
已添加
list_bookings
2026年10月1日 02:54
已添加
get_availability
2026年10月1日 02:54
已添加
list_meeting_types
2026年10月1日 02:54
已添加
ticket_label_archive
2026年10月1日 02:54
已添加
ticket_label_update
2026年10月1日 02:54
已添加
ticket_label_upsert
2026年10月1日 02:54
已添加
ticket_label_list
2026年10月1日 02:54
已添加
compare_feature_forecasts
2026年10月1日 02:54
已添加
list_feature_forecasts
2026年10月1日 02:54
已添加
get_feature_forecast
2026年10月1日 02:54
已添加
capture_feature_forecast
2026年10月1日 02:54
已添加
list_report_review_declarations
2026年10月1日 02:54
已添加
export_report_review_envelope
2026年10月1日 02:54
已添加
list_report_review_envelopes
2026年10月1日 02:54
已添加
get_report_review_envelope
2026年10月1日 02:54
已添加
create_report_review_envelope
2026年10月1日 02:54
已添加
approve_outreach_draft
2026年10月1日 02:54
已添加
set_outreach_sender_state
2026年10月1日 02:54