Outreach Desk

{'type': 'object', 'required': ['desk_key', 'evaluation_id'], 'properties': {'decision': {'enum': ['interested', 'request_info', 'decline'], 'type': 'string', 'description': "The response decision (defaults to the evaluation's recommended_action)."}, 'desk_key': {'type': 'string', 'pattern': '^od_[0-9a-f]{32}$', 'description': 'The secret desk_key returned when the desk was created. It is the only credential for this desk and cannot be recovered.'}, 'evaluation_id': {'type': 'string', 'description': 'The evaluation_id of the pitch to draft a reply for.'}, 'include_feedback': {'type': 'boolean', 'description': 'If true, appends an objective calibration feedback card to a decline draft.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['evaluation_id', 'sender_domain', 'decision', 'subject', 'body', 'feedback_card', 'notes', 'source', 'as_of'], 'properties': {'body': {'type': 'string'}, 'as_of': {'type': 'string'}, 'notes': {'type': 'string'}, 'source': {'type': 'string'}, 'subject': {'type': 'string'}, 'decision': {'type': 'string'}, 'evaluation_id': {'type': 'string'}, 'feedback_card': {'type': ['string', 'null']}, 'sender_domain': {'type': 'string'}}}

{'type': 'object', 'required': ['ticket'], 'properties': {'ticket': {'type': 'string', 'pattern': '^fb_[0-9a-f]{32}$', 'description': 'The ticket id that submit_feedback returned.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['ticket', 'status'], 'properties': {'note': {'type': 'string'}, 'reply': {'type': ['string', 'null']}, 'status': {'enum': ['pending', 'answered'], 'type': 'string'}, 'ticket': {'type': 'string'}}}

{'type': 'object', 'required': ['desk_key'], 'properties': {'desk_key': {'type': 'string', 'pattern': '^od_[0-9a-f]{32}$', 'description': 'The secret desk_key returned when the desk was created. It is the only credential for this desk and cannot be recovered.'}, 'sender_domain': {'type': 'string', 'description': 'Optional sender domain to filter scoreboard results.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['senders', 'recent_evaluations', 'summary', 'source', 'as_of'], 'properties': {'as_of': {'type': 'string'}, 'source': {'type': 'string'}, 'senders': {'type': 'array', 'items': {'type': 'object', 'required': ['sender_domain', 'volume', 'avg_composite', 'avg_relevance', 'avg_specificity', 'yield_count', 'yield_rate', 'recommendation', 'last_contact_day'], 'properties': {'volume': {'type': 'integer'}, 'yield_rate': {'type': 'number'}, 'yield_count': {'type': 'integer'}, 'avg_composite': {'type': 'integer'}, 'avg_relevance': {'type': 'integer'}, 'sender_domain': {'type': 'string'}, 'recommendation': {'type': 'string'}, 'avg_specificity': {'type': 'integer'}, 'last_contact_day': {'type': 'string'}}}}, 'summary': {'type': 'string'}, 'recent_evaluations': {'type': 'array', 'items': {'type': 'object', 'required': ['evaluation_id', 'created_day', 'sender_domain', 'composite_score', 'recommended_action', 'summary', 'flags'], 'properties': {'flags': {'type': 'array', 'items': {'type': 'string'}}, 'summary': {'type': 'string'}, 'created_day': {'type': 'string'}, 'evaluation_id': {'type': 'string'}, 'sender_domain': {'type': 'string'}, 'composite_score': {'type': 'integer'}, 'recommended_action': {'type': 'string'}}}}}}

{'type': 'object', 'properties': {'task': {'type': 'string', 'description': 'Alias for query: task phrase to search.'}, 'query': {'type': 'string', 'description': "Optional task keyword or phrase to search tools (e.g. 'recruiter', 'linkedin', 'feedback', 'broken links', 'jobs'). Omit to list all tools."}, 'keyword': {'type': 'string', 'description': 'Alias for query: keyword to search.'}}, 'additionalProperties': True}

{'type': 'object', 'properties': {'file': {'type': 'object', 'required': ['name', 'resourceUri'], 'properties': {'name': {'type': 'string', 'minLength': 1}, 'resourceUri': {'type': 'string', 'minLength': 1}}, 'description': 'File metadata injected when opened through a file extension entrypoint.'}, 'sender': {'type': 'string', 'description': 'Optional recruiter sender info (email address, URL or domain).'}, 'channel': {'enum': ['email', 'linkedin', 'x', 'other'], 'type': 'string', 'description': 'Communication channel the message was received on.'}, 'message': {'type': 'string', 'description': 'The inbound outreach or recruiter pitch text to evaluate.'}, 'desk_key': {'type': 'string', 'pattern': '^od_[0-9a-f]{32}$', 'description': 'Optional secret desk_key. If provided, evaluates against your private criteria and saves evaluation to your scoreboard.'}, 'priority': {'enum': ['high', 'medium', 'low'], 'type': 'string', 'description': 'Optional candidate priority assigned to this inbound opportunity.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['status', 'interactive_ui'], 'properties': {'file': {'type': 'object'}, 'as_of': {'type': 'string'}, 'drafts': {'type': 'object', 'required': ['interested', 'request_info', 'decline'], 'properties': {'decline': {'type': 'string'}, 'interested': {'type': 'string'}, 'request_info': {'type': 'string'}}}, 'source': {'type': 'string'}, 'status': {'enum': ['ok', 'ready'], 'type': 'string'}, 'channel': {'type': 'string'}, 'message': {'type': 'string'}, 'priority': {'type': 'string'}, 'evaluation': {'type': 'object', 'required': ['evaluation_id', 'sender_domain', 'composite_score', 'breakdown', 'flags', 'summary', 'recommended_action', 'key_reasons'], 'properties': {'flags': {'type': 'array', 'items': {'type': 'string'}}, 'summary': {'type': 'string'}, 'breakdown': {'type': 'object', 'required': ['relevance', 'specificity', 'cadence', 'spam'], 'properties': {'spam': {'type': 'integer'}, 'cadence': {'type': 'integer'}, 'relevance': {'type': 'integer'}, 'specificity': {'type': 'integer'}}}, 'key_reasons': {'type': 'array', 'items': {'type': 'string'}}, 'evaluation_id': {'type': 'string'}, 'sender_domain': {'type': 'string'}, 'composite_score': {'type': 'integer'}, 'recommended_action': {'enum': ['interested', 'request_info', 'decline'], 'type': 'string'}}}, 'interactive_ui': {'type': 'string'}}}

{'type': 'object', 'required': ['desk_key', 'scope'], 'properties': {'scope': {'enum': ['desk', 'sender'], 'type': 'string', 'description': 'Whether to wipe the entire desk or records for a specific sender domain.'}, 'desk_key': {'type': 'string', 'pattern': '^od_[0-9a-f]{32}$', 'description': 'The secret desk_key returned when the desk was created. It is the only credential for this desk and cannot be recovered.'}, 'sender_domain': {'type': 'string', 'description': "Required if scope is 'sender': the domain name to delete."}}, 'additionalProperties': False}

{'type': 'object', 'required': ['purged', 'scope', 'message', 'source', 'as_of'], 'properties': {'as_of': {'type': 'string'}, 'scope': {'type': 'string'}, 'purged': {'type': 'boolean'}, 'source': {'type': 'string'}, 'message': {'type': 'string'}}}

{'type': 'object', 'required': ['desk_key', 'message'], 'properties': {'sender': {'type': 'string', 'description': 'Optional recruiter sender info (email address, URL or domain) to associate with scoreboard.'}, 'message': {'type': 'string', 'description': 'The inbound outreach or recruiter pitch text to evaluate.'}, 'desk_key': {'type': 'string', 'pattern': '^od_[0-9a-f]{32}$', 'description': 'The secret desk_key returned when the desk was created. It is the only credential for this desk and cannot be recovered.'}, 'cadence_days': {'type': 'integer', 'minimum': 0, 'description': 'Days elapsed since the previous message from this sender (defaults to 7).'}, 'is_follow_up': {'type': 'boolean', 'description': 'Whether this message is a follow-up to earlier outreach.'}, 'sender_domain': {'type': 'string', 'description': "Optional explicit sender domain (e.g. 'stripe.com')."}, 'previous_declined': {'type': 'boolean', 'description': 'Whether the candidate previously declined outreach from this sender.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['evaluation_id', 'sender_domain', 'composite_score', 'breakdown', 'flags', 'summary', 'recommended_action', 'key_reasons', 'source', 'as_of'], 'properties': {'as_of': {'type': 'string'}, 'flags': {'type': 'array', 'items': {'type': 'string'}}, 'source': {'type': 'string'}, 'summary': {'type': 'string'}, 'breakdown': {'type': 'object', 'required': ['relevance', 'specificity', 'cadence', 'spam'], 'properties': {'spam': {'type': 'integer'}, 'cadence': {'type': 'integer'}, 'relevance': {'type': 'integer'}, 'specificity': {'type': 'integer'}}}, 'key_reasons': {'type': 'array', 'items': {'type': 'string'}}, 'evaluation_id': {'type': 'string'}, 'sender_domain': {'type': 'string'}, 'composite_score': {'type': 'integer'}, 'recommended_action': {'enum': ['interested', 'request_info', 'decline'], 'type': 'string'}}}

{'type': 'object', 'required': ['target_role', 'skills', 'salary_floor', 'remote_policy'], 'properties': {'skills': {'type': 'array', 'items': {'type': 'string'}, 'description': 'List of core required skills or technical focus areas.'}, 'desk_key': {'type': 'string', 'pattern': '^od_[0-9a-f]{32}$', 'description': 'The secret desk_key returned when the desk was created. It is the only credential for this desk and cannot be recovered.'}, 'target_role': {'type': 'string', 'description': "Target job title or seniority level (e.g. 'Staff Distributed Systems Engineer')."}, 'dealbreakers': {'type': 'array', 'items': {'type': 'string'}, 'description': "Non-negotiable constraints that automatically rule out a pitch (e.g. 'Onsite required', 'Legacy Java')."}, 'salary_floor': {'type': 'integer', 'minimum': 0, 'description': 'Minimum acceptable annual base salary in USD.'}, 'remote_policy': {'type': 'string', 'description': "Target work arrangement (e.g. '100% remote', 'hybrid 1 day', 'any')."}}, 'additionalProperties': False}

{'type': 'object', 'required': ['status', 'desk_key', 'target_role', 'skills', 'salary_floor', 'remote_policy', 'dealbreakers', 'retention_note', 'source', 'as_of'], 'properties': {'as_of': {'type': 'string'}, 'skills': {'type': 'array', 'items': {'type': 'string'}}, 'source': {'type': 'string'}, 'status': {'type': 'string'}, 'desk_key': {'type': 'string'}, 'target_role': {'type': 'string'}, 'dealbreakers': {'type': 'array', 'items': {'type': 'string'}}, 'salary_floor': {'type': 'integer'}, 'remote_policy': {'type': 'string'}, 'retention_note': {'type': 'string'}}}

{'type': 'object', 'required': ['kind', 'message'], 'properties': {'kind': {'enum': ['need_tool', 'need_data', 'bug', 'other'], 'type': 'string', 'description': 'need_tool: a tool you want. need_data: data a tool lacks. bug: something broke. other: anything else about the tools.'}, 'tool': {'type': 'string', 'pattern': '^[A-Za-z0-9_.:-]{1,64}$', 'description': 'Optional: the name of the tool this is about, for example find_tariff_codes.'}, 'message': {'type': 'string', 'maxLength': 1000, 'minLength': 10, 'description': 'What you need or what broke, in plain words, at most 1000 characters. Links, email addresses and phone numbers are removed. Never include secrets or personal details.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['ticket', 'status'], 'properties': {'note': {'type': 'string'}, 'reply': {'type': ['string', 'null']}, 'status': {'enum': ['pending', 'answered'], 'type': 'string'}, 'ticket': {'type': 'string'}}}