Stoory Hire Specialist

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['task_id'], 'properties': {'task_id': {'type': 'string'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['specialist_ids', 'title', 'description', 'problem_context', 'budget', 'language', 'user_confirmed'], 'properties': {'title': {'type': 'string'}, 'budget': {'type': 'number', 'minimum': 0}, 'language': {'enum': ['English', 'Polish', 'French', 'German', 'Spanish', 'Italian'], 'type': 'string', 'description': "The task's language â\x80\x94 must match the language the user phrased title/description in (there is no auto-detection, set it according to the user's input)."}, 'timeline': {'enum': ['In a week', 'In a month', 'In 3 months', 'No rush', 'Do not know'], 'type': 'string', 'default': 'No rush', 'description': "How urgent the project is from the client's perspective â\x80\x94 ask the user directly, do not guess."}, 'description': {'type': 'string'}, 'context_files': {'type': 'array', 'items': {'type': 'object', 'required': ['name'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'name': {'type': 'string'}, 'content_base64': {'type': 'string'}}, 'additionalProperties': False}, 'description': "The minimal set of files the specialist needs. Each entry is { name, url?, content_base64? } and must carry exactly one source. `url` is strongly preferred: pass a link if the user gave one (Google Drive / Dropbox / S3 / raw GitHub) â\x80\x94 the server rewrites common Google Drive and Dropbox share links to their direct-download form, and rejects a URL that returns a web page instead of a file â\x80\x94 or, if you have a way to upload the file yourself (e.g. a code execution / shell environment) â\x80\x94 upload it to any URL-reachable location first and pass that link instead of the raw bytes; the server just downloads it, which is fast and costs you almost no extra tokens. Use `content_base64` only as a last resort, when there is no URL and you have no way to produce one yourself (e.g. a small file the user attached directly in a chat-only client with no upload capability of its own) â\x80\x94 inlining bytes means writing out the entire file as text, which is slow and burns far more tokens than a URL for anything beyond a tiny file. Before falling back to it, tell the user that creating the task will take noticeably longer and use more tokens because of it. Raw base64 only, never a `data:...;base64,` prefix. This server runs remotely and cannot read the caller's disk, so never pass local paths. The server scans every file for secrets, then uploads the rest to the task's file storage on Stoory; contents never enter the model context. Max 5MB per file. Entries that are unreadable or filtered as secrets come back in blocked_files â\x80\x94 the task is still created without them."}, 'specialist_ids': {'type': 'array', 'items': {'type': 'string'}, 'minItems': 1, 'description': 'Id of one or more specialists to invite.'}, 'user_confirmed': {'type': 'boolean', 'description': "Must be true â\x80\x94 set it only after the user's explicit confirmation in the conversation."}, 'problem_context': {'type': 'string'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['task_id'], 'properties': {'task_id': {'type': 'string'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['query'], 'properties': {'limit': {'type': 'number', 'maximum': 20, 'minimum': 1, 'description': 'Default 10, raise to 20 for weak results or when the user asks for more options (max 20).'}, 'query': {'type': 'string', 'maxLength': 120, 'description': "The specialist's role and skills, MAX 12 words, natural language â\x80\x94 not a full sentence describing the user's problem. In English if possible (faster response and better hits than other languages). Good: 'Senior Stripe developer', 'Professional logo designer', 'Experienced UX designer for mobile apps'. Bad: 'I need someone who can help me with branding and visual identity design' (full sentence instead of a role), 'Full-stack developer with microservices architecture experience' (too much glued-together specificity at once). When results are weak (<3 hits or only 'Alternative fit'), retry with a progressively simpler/broader query instead of asking the user, e.g. 'Senior mobile app developer for fintech startup' â\x86\x92 'Mobile app developer' â\x86\x92 'App developer' â\x86\x92 'Mobile development'; or 'GDPR compliance lawyer for healthcare startup' â\x86\x92 'GDPR lawyer' â\x86\x92 'Data protection lawyer' â\x86\x92 'Lawyer'."}, 'country': {'type': 'string', 'description': 'Only when the user explicitly asks for the specialist\'s country (e.g. \'a designer from Poland\'). Full English country name, e.g. "Poland", "Germany" â\x80\x94 not an ISO code. Ignored if geo_location is also given. Omit the field when the user did not mention a country.'}, 'languages': {'type': 'array', 'items': {'type': 'string'}, 'description': "Only when the user explicitly asks for a specific specialist language (e.g. 'a Polish-speaking designer'). Allowed values: English, Polish, German, French, Spanish, Italian â\x80\x94 any other value is rejected by the API. Omit the field (or []) when the user did not mention a language."}, 'geo_location': {'type': 'object', 'required': ['lat', 'lon', 'radius_meters'], 'properties': {'lat': {'type': 'number'}, 'lon': {'type': 'number'}, 'radius_meters': {'type': 'number'}}, 'description': "Only when the user gives a specific city/location and wants to search nearby (e.g. 'near Warsaw', 'a designer in Warsaw'). An object { lat, lon, radius_meters } â\x80\x94 determine the lat/lon of the named city yourself. Default radius_meters is 50000 (50km); when there are too few results, raise it to 100000, then 200000 instead of broadening the query. Takes priority over `country` if both are given. Omit the field when the user did not mention a location.", 'additionalProperties': False}}, 'additionalProperties': False}