@smartytalent/openai-tools 0.8.1 → 0.8.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/dist/tools.json +1427 -48
  2. package/package.json +1 -1
package/dist/tools.json CHANGED
@@ -9299,15 +9299,700 @@
9299
9299
  "filterStatus": {
9300
9300
  "type": "string",
9301
9301
  "description": "Returns surveys with the current status.",
9302
+ "enum": [
9303
+ "draft",
9304
+ "active",
9305
+ "archived"
9306
+ ]
9307
+ },
9308
+ "filterKind": {
9309
+ "type": "string",
9310
+ "description": "Returns surveys of one kind.",
9311
+ "enum": [
9312
+ "cnps",
9313
+ "general"
9314
+ ]
9315
+ },
9316
+ "filterCreatedFrom": {
9317
+ "type": "string",
9318
+ "description": "Filters results to include only those created from the specified date and time. The value must be in ISO 8601 format."
9319
+ },
9320
+ "filterCreatedTo": {
9321
+ "type": "string",
9322
+ "description": "Filters results to include only those created up to the specified date and time. The value must be in ISO 8601 format."
9323
+ },
9324
+ "filterModifiedFrom": {
9325
+ "type": "string",
9326
+ "description": "Filters results to include only those modified from the specified date and time. The value must be in ISO 8601 format."
9327
+ },
9328
+ "filterModifiedTo": {
9329
+ "type": "string",
9330
+ "description": "Filters results to include only those modified up to the specified date and time. The value must be in ISO 8601 format."
9331
+ },
9332
+ "pageSize": {
9333
+ "type": "integer",
9334
+ "description": "Specifies the number of items to retrieve per page. The maximum value is 100."
9335
+ },
9336
+ "pageNumber": {
9337
+ "type": "integer",
9338
+ "description": "Specifies the page number to retrieve. Used for traditional pagination."
9339
+ },
9340
+ "pageAfter": {
9341
+ "type": "string",
9342
+ "description": "Opaque base64-encoded cursor returned by a previous list response, used for forward cursor-based pagination. Pass the value verbatim; do not decode or mutate it."
9343
+ },
9344
+ "pageBefore": {
9345
+ "type": "string",
9346
+ "description": "Returns the data encoded in Base64 format, used for cursor-based pagination"
9347
+ }
9348
+ }
9349
+ }
9350
+ }
9351
+ },
9352
+ {
9353
+ "type": "function",
9354
+ "function": {
9355
+ "name": "create_survey",
9356
+ "description": "Create Survey",
9357
+ "parameters": {
9358
+ "title": "CreateSurveyRequestBody",
9359
+ "type": "object",
9360
+ "required": [
9361
+ "data"
9362
+ ],
9363
+ "properties": {
9364
+ "data": {
9365
+ "title": "CreateSurveyRequestBodyData",
9366
+ "type": "object",
9367
+ "required": [
9368
+ "type",
9369
+ "attributes"
9370
+ ],
9371
+ "properties": {
9372
+ "type": {
9373
+ "type": "string",
9374
+ "enum": [
9375
+ "surveys"
9376
+ ]
9377
+ },
9378
+ "attributes": {
9379
+ "title": "CreateSurveyRequestBodyDataAttributes",
9380
+ "type": "object",
9381
+ "required": [
9382
+ "name"
9383
+ ],
9384
+ "properties": {
9385
+ "name": {
9386
+ "type": "string",
9387
+ "minLength": 5,
9388
+ "maxLength": 255
9389
+ },
9390
+ "kind": {
9391
+ "type": "string",
9392
+ "enum": [
9393
+ "cnps",
9394
+ "general"
9395
+ ]
9396
+ },
9397
+ "content": {
9398
+ "title": "SurveyContentSchema",
9399
+ "type": "object",
9400
+ "description": "The questionnaire: a locale-keyed title plus an ordered question list.",
9401
+ "properties": {
9402
+ "title": {
9403
+ "type": "object",
9404
+ "additionalProperties": {
9405
+ "type": "string"
9406
+ },
9407
+ "description": "Locale map, e.g. {\"en-US\": \"Your application experience\", \"pl-PL\": \"...\"}. en-US is required to publish; clients render by locale prefix with en-US fallback."
9408
+ },
9409
+ "questions": {
9410
+ "type": "array",
9411
+ "minItems": 1,
9412
+ "maxItems": 50,
9413
+ "items": {
9414
+ "title": "SurveyQuestionSchema",
9415
+ "type": "object",
9416
+ "description": "One question. Common fields: questionId (server-assigned when\nomitted; stable forever after - answers key on it), type, text\n(locale map), required. Per-type fields:\n scale - scaleMin/scaleMax (integers, min < max),\n optional scaleLabels {min, max} locale maps,\n optional subtype \"nps\" (pins 0-10, enables\n detractor/passive/promoter classification)\n single-choice / multiple-choice\n - options: 2-20 entries of {value, label};\n value is a stable lowercase slug (a-z, 0-9, -)\n the recipient submits; label is a locale map\n open-text - maxLength (default 2000, max 5000)",
9417
+ "properties": {
9418
+ "questionId": {
9419
+ "type": "string",
9420
+ "maxLength": 64,
9421
+ "description": "Stable identity of the question. Server-assigned uuid hex when omitted at save."
9422
+ },
9423
+ "type": {
9424
+ "type": "string",
9425
+ "enum": [
9426
+ "scale",
9427
+ "single-choice",
9428
+ "multiple-choice",
9429
+ "open-text"
9430
+ ]
9431
+ },
9432
+ "subtype": {
9433
+ "type": "string",
9434
+ "enum": [
9435
+ "nps"
9436
+ ],
9437
+ "description": "scale only. nps pins scaleMin=0/scaleMax=10 and classifies answers detractor/passive/promoter on submit."
9438
+ },
9439
+ "required": {
9440
+ "type": "boolean",
9441
+ "default": false
9442
+ },
9443
+ "text": {
9444
+ "type": "object",
9445
+ "additionalProperties": {
9446
+ "type": "string"
9447
+ },
9448
+ "description": "Locale map of the question text. en-US required to publish."
9449
+ },
9450
+ "scaleMin": {
9451
+ "type": "integer",
9452
+ "minimum": 0,
9453
+ "maximum": 100
9454
+ },
9455
+ "scaleMax": {
9456
+ "type": "integer",
9457
+ "minimum": 0,
9458
+ "maximum": 100
9459
+ },
9460
+ "scaleLabels": {
9461
+ "type": "object",
9462
+ "description": "Optional locale maps for the scale endpoints.",
9463
+ "properties": {
9464
+ "min": {
9465
+ "type": "object",
9466
+ "additionalProperties": {
9467
+ "type": "string"
9468
+ }
9469
+ },
9470
+ "max": {
9471
+ "type": "object",
9472
+ "additionalProperties": {
9473
+ "type": "string"
9474
+ }
9475
+ }
9476
+ }
9477
+ },
9478
+ "options": {
9479
+ "type": "array",
9480
+ "minItems": 2,
9481
+ "maxItems": 20,
9482
+ "items": {
9483
+ "title": "SurveyQuestionOptionSchema",
9484
+ "type": "object",
9485
+ "properties": {
9486
+ "value": {
9487
+ "type": "string",
9488
+ "maxLength": 64,
9489
+ "description": "Stable lowercase slug (a-z, 0-9, -). What the recipient submits - locale-proof, never the label."
9490
+ },
9491
+ "label": {
9492
+ "type": "object",
9493
+ "additionalProperties": {
9494
+ "type": "string"
9495
+ },
9496
+ "description": "Locale map. en-US required to publish."
9497
+ }
9498
+ }
9499
+ }
9500
+ },
9501
+ "maxLength": {
9502
+ "type": "integer",
9503
+ "minimum": 1,
9504
+ "maximum": 5000,
9505
+ "description": "open-text only. Default 2000."
9506
+ }
9507
+ }
9508
+ }
9509
+ }
9510
+ }
9511
+ }
9512
+ }
9513
+ }
9514
+ }
9515
+ }
9516
+ }
9517
+ }
9518
+ }
9519
+ },
9520
+ {
9521
+ "type": "function",
9522
+ "function": {
9523
+ "name": "surveys_options",
9524
+ "description": "Surveys Options",
9525
+ "parameters": {
9526
+ "type": "object",
9527
+ "properties": {}
9528
+ }
9529
+ }
9530
+ },
9531
+ {
9532
+ "type": "function",
9533
+ "function": {
9534
+ "name": "show_survey",
9535
+ "description": "Show Survey",
9536
+ "parameters": {
9537
+ "type": "object",
9538
+ "properties": {
9539
+ "surveyId": {
9540
+ "type": "string",
9541
+ "description": "surveyId parameter"
9542
+ }
9543
+ },
9544
+ "required": [
9545
+ "surveyId"
9546
+ ]
9547
+ }
9548
+ }
9549
+ },
9550
+ {
9551
+ "type": "function",
9552
+ "function": {
9553
+ "name": "update_survey",
9554
+ "description": "Update Survey",
9555
+ "parameters": {
9556
+ "type": "object",
9557
+ "properties": {
9558
+ "surveyId": {
9559
+ "type": "string",
9560
+ "description": "surveyId parameter"
9561
+ },
9562
+ "requestBody": {
9563
+ "title": "UpdateSurveyRequestBody",
9564
+ "type": "object",
9565
+ "required": [
9566
+ "data"
9567
+ ],
9568
+ "properties": {
9569
+ "data": {
9570
+ "title": "UpdateSurveyRequestBodyData",
9571
+ "type": "object",
9572
+ "required": [
9573
+ "type"
9574
+ ],
9575
+ "properties": {
9576
+ "type": {
9577
+ "type": "string",
9578
+ "enum": [
9579
+ "surveys"
9580
+ ]
9581
+ },
9582
+ "id": {
9583
+ "type": "string"
9584
+ },
9585
+ "attributes": {
9586
+ "title": "UpdateSurveyRequestBodyDataAttributes",
9587
+ "type": "object",
9588
+ "properties": {
9589
+ "name": {
9590
+ "type": "string",
9591
+ "minLength": 5,
9592
+ "maxLength": 255
9593
+ },
9594
+ "status": {
9595
+ "type": "string",
9596
+ "enum": [
9597
+ "draft",
9598
+ "active",
9599
+ "archived"
9600
+ ],
9601
+ "description": "active = publish. Allowed transitions: draft->active, draft->archived, active->archived, archived->active; active->active re-publishes the edited draft."
9602
+ },
9603
+ "content": {
9604
+ "title": "SurveyContentSchema",
9605
+ "type": "object",
9606
+ "description": "The questionnaire: a locale-keyed title plus an ordered question list.",
9607
+ "properties": {
9608
+ "title": {
9609
+ "type": "object",
9610
+ "additionalProperties": {
9611
+ "type": "string"
9612
+ },
9613
+ "description": "Locale map, e.g. {\"en-US\": \"Your application experience\", \"pl-PL\": \"...\"}. en-US is required to publish; clients render by locale prefix with en-US fallback."
9614
+ },
9615
+ "questions": {
9616
+ "type": "array",
9617
+ "minItems": 1,
9618
+ "maxItems": 50,
9619
+ "items": {
9620
+ "title": "SurveyQuestionSchema",
9621
+ "type": "object",
9622
+ "description": "One question. Common fields: questionId (server-assigned when\nomitted; stable forever after - answers key on it), type, text\n(locale map), required. Per-type fields:\n scale - scaleMin/scaleMax (integers, min < max),\n optional scaleLabels {min, max} locale maps,\n optional subtype \"nps\" (pins 0-10, enables\n detractor/passive/promoter classification)\n single-choice / multiple-choice\n - options: 2-20 entries of {value, label};\n value is a stable lowercase slug (a-z, 0-9, -)\n the recipient submits; label is a locale map\n open-text - maxLength (default 2000, max 5000)",
9623
+ "properties": {
9624
+ "questionId": {
9625
+ "type": "string",
9626
+ "maxLength": 64,
9627
+ "description": "Stable identity of the question. Server-assigned uuid hex when omitted at save."
9628
+ },
9629
+ "type": {
9630
+ "type": "string",
9631
+ "enum": [
9632
+ "scale",
9633
+ "single-choice",
9634
+ "multiple-choice",
9635
+ "open-text"
9636
+ ]
9637
+ },
9638
+ "subtype": {
9639
+ "type": "string",
9640
+ "enum": [
9641
+ "nps"
9642
+ ],
9643
+ "description": "scale only. nps pins scaleMin=0/scaleMax=10 and classifies answers detractor/passive/promoter on submit."
9644
+ },
9645
+ "required": {
9646
+ "type": "boolean",
9647
+ "default": false
9648
+ },
9649
+ "text": {
9650
+ "type": "object",
9651
+ "additionalProperties": {
9652
+ "type": "string"
9653
+ },
9654
+ "description": "Locale map of the question text. en-US required to publish."
9655
+ },
9656
+ "scaleMin": {
9657
+ "type": "integer",
9658
+ "minimum": 0,
9659
+ "maximum": 100
9660
+ },
9661
+ "scaleMax": {
9662
+ "type": "integer",
9663
+ "minimum": 0,
9664
+ "maximum": 100
9665
+ },
9666
+ "scaleLabels": {
9667
+ "type": "object",
9668
+ "description": "Optional locale maps for the scale endpoints.",
9669
+ "properties": {
9670
+ "min": {
9671
+ "type": "object",
9672
+ "additionalProperties": {
9673
+ "type": "string"
9674
+ }
9675
+ },
9676
+ "max": {
9677
+ "type": "object",
9678
+ "additionalProperties": {
9679
+ "type": "string"
9680
+ }
9681
+ }
9682
+ }
9683
+ },
9684
+ "options": {
9685
+ "type": "array",
9686
+ "minItems": 2,
9687
+ "maxItems": 20,
9688
+ "items": {
9689
+ "title": "SurveyQuestionOptionSchema",
9690
+ "type": "object",
9691
+ "properties": {
9692
+ "value": {
9693
+ "type": "string",
9694
+ "maxLength": 64,
9695
+ "description": "Stable lowercase slug (a-z, 0-9, -). What the recipient submits - locale-proof, never the label."
9696
+ },
9697
+ "label": {
9698
+ "type": "object",
9699
+ "additionalProperties": {
9700
+ "type": "string"
9701
+ },
9702
+ "description": "Locale map. en-US required to publish."
9703
+ }
9704
+ }
9705
+ }
9706
+ },
9707
+ "maxLength": {
9708
+ "type": "integer",
9709
+ "minimum": 1,
9710
+ "maximum": 5000,
9711
+ "description": "open-text only. Default 2000."
9712
+ }
9713
+ }
9714
+ }
9715
+ }
9716
+ }
9717
+ }
9718
+ }
9719
+ }
9720
+ }
9721
+ }
9722
+ }
9723
+ }
9724
+ },
9725
+ "required": [
9726
+ "surveyId",
9727
+ "requestBody"
9728
+ ]
9729
+ }
9730
+ }
9731
+ },
9732
+ {
9733
+ "type": "function",
9734
+ "function": {
9735
+ "name": "delete_survey",
9736
+ "description": "Delete Survey",
9737
+ "parameters": {
9738
+ "type": "object",
9739
+ "properties": {
9740
+ "surveyId": {
9741
+ "type": "string",
9742
+ "description": "surveyId parameter"
9743
+ },
9744
+ "permanentDelete": {
9745
+ "type": "string",
9746
+ "description": "true removes the row instead of archiving it.",
9747
+ "enum": [
9748
+ "true",
9749
+ "false"
9750
+ ]
9751
+ }
9752
+ },
9753
+ "required": [
9754
+ "surveyId"
9755
+ ]
9756
+ }
9757
+ }
9758
+ },
9759
+ {
9760
+ "type": "function",
9761
+ "function": {
9762
+ "name": "survey_options",
9763
+ "description": "Survey Options",
9764
+ "parameters": {
9765
+ "type": "object",
9766
+ "properties": {}
9767
+ }
9768
+ }
9769
+ },
9770
+ {
9771
+ "type": "function",
9772
+ "function": {
9773
+ "name": "list_responses",
9774
+ "description": "List Responses",
9775
+ "parameters": {
9776
+ "type": "object",
9777
+ "properties": {
9778
+ "filterStatus": {
9779
+ "type": "string",
9780
+ "description": "Returns responses with the current status.",
9302
9781
  "enum": [
9303
9782
  "pending",
9304
9783
  "completed",
9305
9784
  "expired"
9306
9785
  ]
9307
9786
  },
9787
+ "filterSurveyId": {
9788
+ "type": "string",
9789
+ "description": "Filter by the survey definition the response belongs to."
9790
+ },
9791
+ "filterCandidateId": {
9792
+ "type": "string",
9793
+ "description": "Filter by the candidate the invitation was sent to."
9794
+ },
9795
+ "filterCreatedFrom": {
9796
+ "type": "string",
9797
+ "description": "Filters results to include only those created from the specified date and time. The value must be in ISO 8601 format."
9798
+ },
9799
+ "filterCreatedTo": {
9800
+ "type": "string",
9801
+ "description": "Filters results to include only those created up to the specified date and time. The value must be in ISO 8601 format."
9802
+ },
9803
+ "filterModifiedFrom": {
9804
+ "type": "string",
9805
+ "description": "Filters results to include only those modified from the specified date and time. The value must be in ISO 8601 format."
9806
+ },
9807
+ "filterModifiedTo": {
9808
+ "type": "string",
9809
+ "description": "Filters results to include only those modified up to the specified date and time. The value must be in ISO 8601 format."
9810
+ },
9811
+ "pageSize": {
9812
+ "type": "integer",
9813
+ "description": "Specifies the number of items to retrieve per page. The maximum value is 100."
9814
+ },
9815
+ "pageNumber": {
9816
+ "type": "integer",
9817
+ "description": "Specifies the page number to retrieve. Used for traditional pagination."
9818
+ },
9819
+ "pageAfter": {
9820
+ "type": "string",
9821
+ "description": "Opaque base64-encoded cursor returned by a previous list response, used for forward cursor-based pagination. Pass the value verbatim; do not decode or mutate it."
9822
+ },
9823
+ "pageBefore": {
9824
+ "type": "string",
9825
+ "description": "Returns the data encoded in Base64 format, used for cursor-based pagination"
9826
+ }
9827
+ }
9828
+ }
9829
+ }
9830
+ },
9831
+ {
9832
+ "type": "function",
9833
+ "function": {
9834
+ "name": "responses_options",
9835
+ "description": "Responses Options",
9836
+ "parameters": {
9837
+ "type": "object",
9838
+ "properties": {}
9839
+ }
9840
+ }
9841
+ },
9842
+ {
9843
+ "type": "function",
9844
+ "function": {
9845
+ "name": "show_response",
9846
+ "description": "Show Response",
9847
+ "parameters": {
9848
+ "type": "object",
9849
+ "properties": {
9850
+ "responseId": {
9851
+ "type": "string",
9852
+ "description": "responseId parameter"
9853
+ }
9854
+ },
9855
+ "required": [
9856
+ "responseId"
9857
+ ]
9858
+ }
9859
+ }
9860
+ },
9861
+ {
9862
+ "type": "function",
9863
+ "function": {
9864
+ "name": "response_options",
9865
+ "description": "Response Options",
9866
+ "parameters": {
9867
+ "type": "object",
9868
+ "properties": {}
9869
+ }
9870
+ }
9871
+ },
9872
+ {
9873
+ "type": "function",
9874
+ "function": {
9875
+ "name": "show_guest_response",
9876
+ "description": "Show Guest Response",
9877
+ "parameters": {
9878
+ "type": "object",
9879
+ "properties": {
9880
+ "tenantId": {
9881
+ "type": "string",
9882
+ "description": "Base tenant id from the emailed link. Half of the guest auth pair."
9883
+ },
9884
+ "token": {
9885
+ "type": "string",
9886
+ "description": "Per-response accessToken from the emailed link. Compared with hmac.compare_digest; mismatch returns 404."
9887
+ }
9888
+ },
9889
+ "required": [
9890
+ "tenantId",
9891
+ "token"
9892
+ ]
9893
+ }
9894
+ }
9895
+ },
9896
+ {
9897
+ "type": "function",
9898
+ "function": {
9899
+ "name": "submit_guest_response",
9900
+ "description": "Submit Guest Response",
9901
+ "parameters": {
9902
+ "title": "SubmitGuestResponseRequestBody",
9903
+ "type": "object",
9904
+ "required": [
9905
+ "data",
9906
+ "meta"
9907
+ ],
9908
+ "properties": {
9909
+ "data": {
9910
+ "title": "SubmitGuestResponseRequestBodyData",
9911
+ "type": "object",
9912
+ "required": [
9913
+ "type",
9914
+ "attributes"
9915
+ ],
9916
+ "properties": {
9917
+ "type": {
9918
+ "type": "string",
9919
+ "enum": [
9920
+ "responses"
9921
+ ]
9922
+ },
9923
+ "id": {
9924
+ "type": "string"
9925
+ },
9926
+ "attributes": {
9927
+ "title": "SubmitGuestResponseRequestBodyDataAttributes",
9928
+ "type": "object",
9929
+ "required": [
9930
+ "answers"
9931
+ ],
9932
+ "properties": {
9933
+ "answers": {
9934
+ "type": "object",
9935
+ "description": "Keyed by questionId. Scale values are classified server-side (0-6 detractor, 7-8 passive, 9-10 promoter for nps questions)."
9936
+ }
9937
+ }
9938
+ }
9939
+ }
9940
+ },
9941
+ "meta": {
9942
+ "title": "GuestResponseMetaSchema",
9943
+ "description": "Auth context for the unauthenticated PATCH\n/v1/guest/responses/{id}. Both values come from the emailed link,\nnever from a session - there is no authorizer on the guest path.\ntenantId is the BASE tenant id; accessToken is the per-response\ntoken minted at create and compared with hmac.compare_digest. Any\nmismatch returns 404, intentionally indistinguishable from\n\"response not found\" so existence is never leaked.",
9944
+ "type": "object",
9945
+ "required": [
9946
+ "tenantId",
9947
+ "accessToken"
9948
+ ],
9949
+ "properties": {
9950
+ "tenantId": {
9951
+ "type": "string"
9952
+ },
9953
+ "accessToken": {
9954
+ "type": "string"
9955
+ }
9956
+ }
9957
+ }
9958
+ }
9959
+ }
9960
+ }
9961
+ },
9962
+ {
9963
+ "type": "function",
9964
+ "function": {
9965
+ "name": "guest_response_options",
9966
+ "description": "Guest Response Options",
9967
+ "parameters": {
9968
+ "type": "object",
9969
+ "properties": {}
9970
+ }
9971
+ }
9972
+ },
9973
+ {
9974
+ "type": "function",
9975
+ "function": {
9976
+ "name": "list_documents",
9977
+ "description": "List Documents",
9978
+ "parameters": {
9979
+ "type": "object",
9980
+ "properties": {
9981
+ "filterStatus": {
9982
+ "type": "string",
9983
+ "description": "Returns documents with the current status.",
9984
+ "enum": [
9985
+ "draft",
9986
+ "pending",
9987
+ "completed",
9988
+ "declined",
9989
+ "expired",
9990
+ "withdrawn"
9991
+ ]
9992
+ },
9308
9993
  "filterCandidateId": {
9309
9994
  "type": "string",
9310
- "description": "Filter by the candidate the survey was sent to."
9995
+ "description": "Filter by the candidate the document belongs to."
9311
9996
  },
9312
9997
  "filterCreatedFrom": {
9313
9998
  "type": "string",
@@ -9348,8 +10033,159 @@
9348
10033
  {
9349
10034
  "type": "function",
9350
10035
  "function": {
9351
- "name": "surveys_options",
9352
- "description": "Surveys Options",
10036
+ "name": "create_document",
10037
+ "description": "Create Document",
10038
+ "parameters": {
10039
+ "title": "CreateDocumentRequestBody",
10040
+ "type": "object",
10041
+ "required": [
10042
+ "data"
10043
+ ],
10044
+ "properties": {
10045
+ "data": {
10046
+ "title": "CreateDocumentRequestBodyData",
10047
+ "type": "object",
10048
+ "required": [
10049
+ "type",
10050
+ "attributes"
10051
+ ],
10052
+ "properties": {
10053
+ "type": {
10054
+ "type": "string",
10055
+ "enum": [
10056
+ "documents"
10057
+ ]
10058
+ },
10059
+ "attributes": {
10060
+ "title": "CreateDocumentRequestBodyDataAttributes",
10061
+ "type": "object",
10062
+ "required": [
10063
+ "documentType"
10064
+ ],
10065
+ "properties": {
10066
+ "documentType": {
10067
+ "type": "string",
10068
+ "enum": [
10069
+ "employment_offer",
10070
+ "employment_contract",
10071
+ "b2b_contract",
10072
+ "nda",
10073
+ "policy",
10074
+ "consent"
10075
+ ]
10076
+ },
10077
+ "process": {
10078
+ "type": "string",
10079
+ "enum": [
10080
+ "offer",
10081
+ "contract",
10082
+ "document"
10083
+ ]
10084
+ },
10085
+ "title": {
10086
+ "type": "object",
10087
+ "additionalProperties": {
10088
+ "type": "string"
10089
+ }
10090
+ },
10091
+ "languageCode": {
10092
+ "type": "string"
10093
+ },
10094
+ "organizationName": {
10095
+ "type": "string"
10096
+ },
10097
+ "body": {
10098
+ "type": "array",
10099
+ "items": {
10100
+ "type": "object"
10101
+ }
10102
+ },
10103
+ "fields": {
10104
+ "type": "array",
10105
+ "items": {
10106
+ "type": "object"
10107
+ }
10108
+ },
10109
+ "participants": {
10110
+ "type": "array",
10111
+ "items": {
10112
+ "type": "object"
10113
+ }
10114
+ },
10115
+ "expiresAt": {
10116
+ "type": "string",
10117
+ "format": "date-time"
10118
+ }
10119
+ }
10120
+ },
10121
+ "relationships": {
10122
+ "title": "DocumentRelationshipsSchema",
10123
+ "type": "object",
10124
+ "properties": {
10125
+ "candidate": {
10126
+ "title": "DocumentRelationshipsCandidateSchema",
10127
+ "type": "object",
10128
+ "properties": {
10129
+ "data": {
10130
+ "type": "object",
10131
+ "properties": {
10132
+ "type": {
10133
+ "type": "string"
10134
+ },
10135
+ "id": {
10136
+ "type": "string"
10137
+ }
10138
+ }
10139
+ }
10140
+ }
10141
+ },
10142
+ "job": {
10143
+ "title": "DocumentRelationshipsJobSchema",
10144
+ "type": "object",
10145
+ "properties": {
10146
+ "data": {
10147
+ "type": "object",
10148
+ "properties": {
10149
+ "type": {
10150
+ "type": "string"
10151
+ },
10152
+ "id": {
10153
+ "type": "string"
10154
+ }
10155
+ }
10156
+ }
10157
+ }
10158
+ },
10159
+ "conversation": {
10160
+ "title": "DocumentRelationshipsConversationSchema",
10161
+ "type": "object",
10162
+ "properties": {
10163
+ "data": {
10164
+ "type": "object",
10165
+ "properties": {
10166
+ "type": {
10167
+ "type": "string"
10168
+ },
10169
+ "id": {
10170
+ "type": "string"
10171
+ }
10172
+ }
10173
+ }
10174
+ }
10175
+ }
10176
+ }
10177
+ }
10178
+ }
10179
+ }
10180
+ }
10181
+ }
10182
+ }
10183
+ },
10184
+ {
10185
+ "type": "function",
10186
+ "function": {
10187
+ "name": "documents_options",
10188
+ "description": "Documents Options",
9353
10189
  "parameters": {
9354
10190
  "type": "object",
9355
10191
  "properties": {}
@@ -9359,18 +10195,18 @@
9359
10195
  {
9360
10196
  "type": "function",
9361
10197
  "function": {
9362
- "name": "show_survey",
9363
- "description": "Show Survey",
10198
+ "name": "show_document",
10199
+ "description": "Show Document",
9364
10200
  "parameters": {
9365
10201
  "type": "object",
9366
10202
  "properties": {
9367
- "surveyId": {
10203
+ "documentId": {
9368
10204
  "type": "string",
9369
- "description": "surveyId parameter"
10205
+ "description": "documentId parameter"
9370
10206
  }
9371
10207
  },
9372
10208
  "required": [
9373
- "surveyId"
10209
+ "documentId"
9374
10210
  ]
9375
10211
  }
9376
10212
  }
@@ -9378,8 +10214,179 @@
9378
10214
  {
9379
10215
  "type": "function",
9380
10216
  "function": {
9381
- "name": "survey_options",
9382
- "description": "Survey Options",
10217
+ "name": "update_document",
10218
+ "description": "Update Document",
10219
+ "parameters": {
10220
+ "type": "object",
10221
+ "properties": {
10222
+ "documentId": {
10223
+ "type": "string",
10224
+ "description": "documentId parameter"
10225
+ },
10226
+ "requestBody": {
10227
+ "title": "UpdateDocumentRequestBody",
10228
+ "type": "object",
10229
+ "required": [
10230
+ "data"
10231
+ ],
10232
+ "properties": {
10233
+ "data": {
10234
+ "title": "UpdateDocumentRequestBodyData",
10235
+ "type": "object",
10236
+ "required": [
10237
+ "type"
10238
+ ],
10239
+ "properties": {
10240
+ "type": {
10241
+ "type": "string",
10242
+ "enum": [
10243
+ "documents"
10244
+ ]
10245
+ },
10246
+ "id": {
10247
+ "type": "string"
10248
+ },
10249
+ "attributes": {
10250
+ "title": "UpdateDocumentRequestBodyDataAttributes",
10251
+ "type": "object",
10252
+ "properties": {
10253
+ "status": {
10254
+ "type": "string",
10255
+ "enum": [
10256
+ "pending",
10257
+ "withdrawn"
10258
+ ],
10259
+ "description": "pending = the SEND door (draft only); withdrawn = withdraw a sent document."
10260
+ },
10261
+ "title": {
10262
+ "type": "object",
10263
+ "additionalProperties": {
10264
+ "type": "string"
10265
+ }
10266
+ },
10267
+ "languageCode": {
10268
+ "type": "string"
10269
+ },
10270
+ "organizationName": {
10271
+ "type": "string"
10272
+ },
10273
+ "body": {
10274
+ "type": "array",
10275
+ "items": {
10276
+ "type": "object"
10277
+ }
10278
+ },
10279
+ "fields": {
10280
+ "type": "array",
10281
+ "items": {
10282
+ "type": "object"
10283
+ }
10284
+ },
10285
+ "participants": {
10286
+ "type": "array",
10287
+ "items": {
10288
+ "type": "object"
10289
+ }
10290
+ },
10291
+ "expiresAt": {
10292
+ "type": "string",
10293
+ "format": "date-time"
10294
+ }
10295
+ }
10296
+ },
10297
+ "relationships": {
10298
+ "title": "DocumentRelationshipsSchema",
10299
+ "type": "object",
10300
+ "properties": {
10301
+ "candidate": {
10302
+ "title": "DocumentRelationshipsCandidateSchema",
10303
+ "type": "object",
10304
+ "properties": {
10305
+ "data": {
10306
+ "type": "object",
10307
+ "properties": {
10308
+ "type": {
10309
+ "type": "string"
10310
+ },
10311
+ "id": {
10312
+ "type": "string"
10313
+ }
10314
+ }
10315
+ }
10316
+ }
10317
+ },
10318
+ "job": {
10319
+ "title": "DocumentRelationshipsJobSchema",
10320
+ "type": "object",
10321
+ "properties": {
10322
+ "data": {
10323
+ "type": "object",
10324
+ "properties": {
10325
+ "type": {
10326
+ "type": "string"
10327
+ },
10328
+ "id": {
10329
+ "type": "string"
10330
+ }
10331
+ }
10332
+ }
10333
+ }
10334
+ },
10335
+ "conversation": {
10336
+ "title": "DocumentRelationshipsConversationSchema",
10337
+ "type": "object",
10338
+ "properties": {
10339
+ "data": {
10340
+ "type": "object",
10341
+ "properties": {
10342
+ "type": {
10343
+ "type": "string"
10344
+ },
10345
+ "id": {
10346
+ "type": "string"
10347
+ }
10348
+ }
10349
+ }
10350
+ }
10351
+ }
10352
+ }
10353
+ }
10354
+ }
10355
+ }
10356
+ }
10357
+ }
10358
+ },
10359
+ "required": [
10360
+ "documentId",
10361
+ "requestBody"
10362
+ ]
10363
+ }
10364
+ }
10365
+ },
10366
+ {
10367
+ "type": "function",
10368
+ "function": {
10369
+ "name": "delete_document",
10370
+ "description": "Delete Document",
10371
+ "parameters": {
10372
+ "type": "object",
10373
+ "properties": {
10374
+ "documentId": {
10375
+ "type": "string",
10376
+ "description": "documentId parameter"
10377
+ }
10378
+ },
10379
+ "required": [
10380
+ "documentId"
10381
+ ]
10382
+ }
10383
+ }
10384
+ },
10385
+ {
10386
+ "type": "function",
10387
+ "function": {
10388
+ "name": "document_options",
10389
+ "description": "Document Options",
9383
10390
  "parameters": {
9384
10391
  "type": "object",
9385
10392
  "properties": {}
@@ -9389,18 +10396,27 @@
9389
10396
  {
9390
10397
  "type": "function",
9391
10398
  "function": {
9392
- "name": "show_guest_survey",
9393
- "description": "Show Guest Survey",
10399
+ "name": "show_guest_document",
10400
+ "description": "Show Guest Document",
9394
10401
  "parameters": {
9395
10402
  "type": "object",
9396
10403
  "properties": {
9397
10404
  "tenantId": {
9398
10405
  "type": "string",
9399
- "description": "Base tenant id from the emailed link. Half of the guest auth pair."
10406
+ "description": "Base tenant id from the emailed link. Part of the guest auth."
9400
10407
  },
9401
10408
  "token": {
9402
10409
  "type": "string",
9403
- "description": "Per-survey accessToken from the emailed link. Compared with hmac.compare_digest; mismatch returns 404."
10410
+ "description": "Per-participant accessToken from the emailed link. Compared with hmac.compare_digest; mismatch returns 404."
10411
+ },
10412
+ "process": {
10413
+ "type": "string",
10414
+ "description": "The link's {process} path segment (offer | contract | document). Mismatch with the row returns 404.",
10415
+ "enum": [
10416
+ "offer",
10417
+ "contract",
10418
+ "document"
10419
+ ]
9404
10420
  }
9405
10421
  },
9406
10422
  "required": [
@@ -9413,10 +10429,10 @@
9413
10429
  {
9414
10430
  "type": "function",
9415
10431
  "function": {
9416
- "name": "submit_guest_survey",
9417
- "description": "Submit Guest Survey",
10432
+ "name": "submit_guest_document",
10433
+ "description": "Submit Guest Document",
9418
10434
  "parameters": {
9419
- "title": "SubmitGuestSurveyRequestBody",
10435
+ "title": "SubmitGuestDocumentRequestBody",
9420
10436
  "type": "object",
9421
10437
  "required": [
9422
10438
  "data",
@@ -9424,7 +10440,7 @@
9424
10440
  ],
9425
10441
  "properties": {
9426
10442
  "data": {
9427
- "title": "SubmitGuestSurveyRequestBodyData",
10443
+ "title": "SubmitGuestDocumentRequestBodyData",
9428
10444
  "type": "object",
9429
10445
  "required": [
9430
10446
  "type",
@@ -9434,37 +10450,40 @@
9434
10450
  "type": {
9435
10451
  "type": "string",
9436
10452
  "enum": [
9437
- "surveys"
10453
+ "documents"
9438
10454
  ]
9439
10455
  },
9440
10456
  "id": {
9441
10457
  "type": "string"
9442
10458
  },
9443
10459
  "attributes": {
9444
- "title": "SubmitGuestSurveyRequestBodyDataAttributes",
10460
+ "title": "SubmitGuestDocumentRequestBodyDataAttributes",
9445
10461
  "type": "object",
9446
10462
  "required": [
9447
- "score"
10463
+ "action"
9448
10464
  ],
9449
10465
  "properties": {
9450
- "score": {
9451
- "type": "integer",
9452
- "minimum": 0,
9453
- "maximum": 10,
9454
- "description": "The NPS answer. 0-6 buckets to detractor, 7-8 passive, 9-10 promoter - the bucketing happens server-side."
9455
- },
9456
- "comment": {
10466
+ "action": {
9457
10467
  "type": "string",
9458
- "maxLength": 2000,
9459
- "description": "Optional free text. Trimmed server-side; an empty string is stored as absent."
10468
+ "enum": [
10469
+ "VIEW",
10470
+ "ACCEPT",
10471
+ "DECLINE"
10472
+ ]
10473
+ },
10474
+ "confirmations": {
10475
+ "type": "array",
10476
+ "items": {
10477
+ "type": "string"
10478
+ }
9460
10479
  }
9461
10480
  }
9462
10481
  }
9463
10482
  }
9464
10483
  },
9465
10484
  "meta": {
9466
- "title": "GuestSurveyMetaSchema",
9467
- "description": "Auth context for the unauthenticated PATCH /v1/guest/surveys/{id}.\nBoth values come from the emailed link, never from a session -\nthere is no authorizer on the guest path. tenantId is the BASE\ntenant id; accessToken is the per-survey token minted at create and\ncompared with hmac.compare_digest. Any mismatch returns 404,\nintentionally indistinguishable from \"survey not found\" so survey\nexistence is never leaked.",
10485
+ "title": "GuestDocumentMetaSchema",
10486
+ "description": "Auth context for the unauthenticated PATCH\n/v1/guest/documents/{id}. Both values come from the emailed link,\nnever from a session. tenantId is the BASE tenant id; accessToken\nis the per-participant token minted at send and compared with\nhmac.compare_digest. Any mismatch returns 404, intentionally\nindistinguishable from \"document not found\".",
9468
10487
  "type": "object",
9469
10488
  "required": [
9470
10489
  "tenantId",
@@ -9486,8 +10505,8 @@
9486
10505
  {
9487
10506
  "type": "function",
9488
10507
  "function": {
9489
- "name": "guest_survey_options",
9490
- "description": "Guest Survey Options",
10508
+ "name": "guest_document_options",
10509
+ "description": "Guest Document Options",
9491
10510
  "parameters": {
9492
10511
  "type": "object",
9493
10512
  "properties": {}
@@ -13901,6 +14920,10 @@
13901
14920
  "archived"
13902
14921
  ]
13903
14922
  },
14923
+ "filterScopeKey": {
14924
+ "type": "string",
14925
+ "description": "Returns the persona for one position family in one market.\nFormat `{positionFamily}#{scope}`, where scope is\n`city:<slug>`, `voivodeship:<slug>`, `country:<code>` or\n`remote` - for example\n`regional-sales-representative#city:krakow`. Slugs are folded\n(lowercase, no diacritics), so Krakow and Kraków are one key."
14926
+ },
13904
14927
  "filterCreatedFrom": {
13905
14928
  "type": "string",
13906
14929
  "description": "Filters results to include only those created from the specified date and time. The value must be in ISO 8601 format."
@@ -13966,16 +14989,74 @@
13966
14989
  "attributes": {
13967
14990
  "title": "PersonaAttributesSchema",
13968
14991
  "type": "object",
13969
- "required": [
13970
- "name",
13971
- "email"
13972
- ],
14992
+ "description": "A persona is a REGIONAL COHORT profile, not a person: it is\nsynthesized from the talents this tenant actually hired for one\nposition family in one market. Nothing here describes an individual,\nand `name` / `profilePictureUrl` are an invented label for the\ncohort, never a real person.",
13973
14993
  "properties": {
13974
- "name": {
14994
+ "status": {
14995
+ "type": "string",
14996
+ "description": "Only `active` personas may be shown as a benchmark - see\n`memberCount`. Everything else is a work in progress.",
14997
+ "enum": [
14998
+ "active",
14999
+ "inactive",
15000
+ "draft",
15001
+ "pending",
15002
+ "archived",
15003
+ "failed"
15004
+ ]
15005
+ },
15006
+ "source": {
13975
15007
  "type": "string"
13976
15008
  },
13977
- "status": {
13978
- "type": "string"
15009
+ "name": {
15010
+ "type": "object",
15011
+ "description": "Language-keyed invented name for the archetype. Written once, then stable across rebuilds.",
15012
+ "additionalProperties": true
15013
+ },
15014
+ "profilePictureUrl": {
15015
+ "type": "string",
15016
+ "description": "Illustration for the archetype. Not a photograph of anyone."
15017
+ },
15018
+ "gender": {
15019
+ "type": "object",
15020
+ "description": "Language-keyed, cohort-derived. Locale value unconstrained (Any).",
15021
+ "additionalProperties": true
15022
+ },
15023
+ "ageRange": {
15024
+ "type": "object",
15025
+ "description": "Language-keyed, cohort-derived. Locale value unconstrained (Any).",
15026
+ "additionalProperties": true
15027
+ },
15028
+ "scope": {
15029
+ "type": "object",
15030
+ "description": "Which market this persona describes: `{level: city|voivodeship|\ncountry|remote, city?, voivodeship?, country?}`. A hire feeds\nthree personas (city, voivodeship, country), and consumers take\nthe most specific USABLE one.",
15031
+ "additionalProperties": true
15032
+ },
15033
+ "scopeKey": {
15034
+ "type": "string",
15035
+ "description": "`{positionFamily}#{scope}` - the list filter (`filterScopeKey`) and the index key."
15036
+ },
15037
+ "positionFamily": {
15038
+ "type": "string",
15039
+ "description": "Slug of the role the cohort was hired for, e.g. `regional-sales-representative`."
15040
+ },
15041
+ "memberCount": {
15042
+ "type": "integer",
15043
+ "description": "How many hired talents the cohort holds. Below 3 the profile is\nthose few people in disguise, so it is never published and never\nconsumed - k-anonymity, not a display preference."
15044
+ },
15045
+ "cohortRead": {
15046
+ "type": "integer",
15047
+ "description": "How many members actually fed the profile on this row (diagnostic; can be lower than memberCount)."
15048
+ },
15049
+ "talentCount": {
15050
+ "type": "integer",
15051
+ "description": "Legacy mirror of memberCount."
15052
+ },
15053
+ "version": {
15054
+ "type": "integer",
15055
+ "description": "Bumped by every rebuild that wrote something."
15056
+ },
15057
+ "publishedAt": {
15058
+ "type": "string",
15059
+ "description": "When this persona last became consumable."
13979
15060
  },
13980
15061
  "timestamps": {
13981
15062
  "title": "ResourceTimestampsSchema",
@@ -13990,6 +15071,126 @@
13990
15071
  "format": "date-time"
13991
15072
  }
13992
15073
  }
15074
+ },
15075
+ "availability": {
15076
+ "type": "object",
15077
+ "description": "Language-keyed availability pattern across the cohort. Each entry carries its own prevalence (\"N of M hired talents\").",
15078
+ "additionalProperties": true
15079
+ },
15080
+ "certifications": {
15081
+ "type": "object",
15082
+ "description": "Language-keyed certifications pattern across the cohort. Each entry carries its own prevalence (\"N of M hired talents\").",
15083
+ "additionalProperties": true
15084
+ },
15085
+ "companyTypeExperience": {
15086
+ "type": "object",
15087
+ "description": "Language-keyed companyTypeExperience pattern across the cohort. Each entry carries its own prevalence (\"N of M hired talents\").",
15088
+ "additionalProperties": true
15089
+ },
15090
+ "education": {
15091
+ "type": "object",
15092
+ "description": "Language-keyed education pattern across the cohort. Each entry carries its own prevalence (\"N of M hired talents\").",
15093
+ "additionalProperties": true
15094
+ },
15095
+ "experienceAndSeniority": {
15096
+ "type": "object",
15097
+ "description": "Language-keyed experienceAndSeniority pattern across the cohort. Each entry carries its own prevalence (\"N of M hired talents\").",
15098
+ "additionalProperties": true
15099
+ },
15100
+ "industryExperience": {
15101
+ "type": "object",
15102
+ "description": "Language-keyed industryExperience pattern across the cohort. Each entry carries its own prevalence (\"N of M hired talents\").",
15103
+ "additionalProperties": true
15104
+ },
15105
+ "jobPositions": {
15106
+ "type": "object",
15107
+ "description": "Language-keyed jobPositions pattern across the cohort. Each entry carries its own prevalence (\"N of M hired talents\").",
15108
+ "additionalProperties": true
15109
+ },
15110
+ "jobTendencies": {
15111
+ "type": "object",
15112
+ "description": "Language-keyed jobTendencies pattern across the cohort. Each entry carries its own prevalence (\"N of M hired talents\").",
15113
+ "additionalProperties": true
15114
+ },
15115
+ "languagesSpoken": {
15116
+ "type": "object",
15117
+ "description": "Language-keyed languagesSpoken pattern across the cohort. Each entry carries its own prevalence (\"N of M hired talents\").",
15118
+ "additionalProperties": true
15119
+ },
15120
+ "licenses": {
15121
+ "type": "object",
15122
+ "description": "Language-keyed licenses pattern across the cohort. Each entry carries its own prevalence (\"N of M hired talents\").",
15123
+ "additionalProperties": true
15124
+ },
15125
+ "locationPreferences": {
15126
+ "type": "object",
15127
+ "description": "Language-keyed locationPreferences pattern across the cohort. Each entry carries its own prevalence (\"N of M hired talents\").",
15128
+ "additionalProperties": true
15129
+ },
15130
+ "personalityAndSoftSkills": {
15131
+ "type": "object",
15132
+ "description": "Language-keyed personalityAndSoftSkills pattern across the cohort. Each entry carries its own prevalence (\"N of M hired talents\").",
15133
+ "additionalProperties": true
15134
+ },
15135
+ "salaryExpectation": {
15136
+ "type": "object",
15137
+ "description": "Language-keyed salaryExpectation pattern across the cohort. Each entry carries its own prevalence (\"N of M hired talents\").",
15138
+ "additionalProperties": true
15139
+ },
15140
+ "skillsAndExpertise": {
15141
+ "type": "object",
15142
+ "description": "Language-keyed skillsAndExpertise pattern across the cohort. Each entry carries its own prevalence (\"N of M hired talents\").",
15143
+ "additionalProperties": true
15144
+ },
15145
+ "workAuthorization": {
15146
+ "type": "object",
15147
+ "description": "Language-keyed workAuthorization pattern across the cohort. Each entry carries its own prevalence (\"N of M hired talents\").",
15148
+ "additionalProperties": true
15149
+ },
15150
+ "workPreferences": {
15151
+ "type": "object",
15152
+ "description": "Language-keyed workPreferences pattern across the cohort. Each entry carries its own prevalence (\"N of M hired talents\").",
15153
+ "additionalProperties": true
15154
+ },
15155
+ "responsibilities": {
15156
+ "type": "object",
15157
+ "description": "Language-keyed responsibilities pattern across the cohort. Each entry carries its own prevalence (\"N of M hired talents\").",
15158
+ "additionalProperties": true
15159
+ },
15160
+ "hobbiesAndInterests": {
15161
+ "type": "object",
15162
+ "description": "Language-keyed narrative synthesis. Locale value unconstrained (Any) - see the candidate schema note.",
15163
+ "additionalProperties": true
15164
+ },
15165
+ "personalTraits": {
15166
+ "type": "object",
15167
+ "description": "Language-keyed narrative synthesis. Locale value unconstrained (Any) - see the candidate schema note.",
15168
+ "additionalProperties": true
15169
+ },
15170
+ "goalsAndAspirations": {
15171
+ "type": "object",
15172
+ "description": "Language-keyed narrative synthesis. Locale value unconstrained (Any) - see the candidate schema note.",
15173
+ "additionalProperties": true
15174
+ },
15175
+ "mainFrustrations": {
15176
+ "type": "object",
15177
+ "description": "Language-keyed narrative synthesis. Locale value unconstrained (Any) - see the candidate schema note.",
15178
+ "additionalProperties": true
15179
+ },
15180
+ "keyCompetenciesAndStrengths": {
15181
+ "type": "object",
15182
+ "description": "Language-keyed narrative synthesis. Locale value unconstrained (Any) - see the candidate schema note.",
15183
+ "additionalProperties": true
15184
+ },
15185
+ "quickInsights": {
15186
+ "type": "object",
15187
+ "description": "Language-keyed narrative synthesis. Locale value unconstrained (Any) - see the candidate schema note.",
15188
+ "additionalProperties": true
15189
+ },
15190
+ "keywords": {
15191
+ "type": "object",
15192
+ "description": "Language-keyed narrative synthesis. Locale value unconstrained (Any) - see the candidate schema note.",
15193
+ "additionalProperties": true
13993
15194
  }
13994
15195
  }
13995
15196
  },
@@ -14123,17 +15324,75 @@
14123
15324
  "attributes": {
14124
15325
  "title": "PersonaAttributesSchema",
14125
15326
  "type": "object",
14126
- "required": [
14127
- "name",
14128
- "email"
14129
- ],
15327
+ "description": "A persona is a REGIONAL COHORT profile, not a person: it is\nsynthesized from the talents this tenant actually hired for one\nposition family in one market. Nothing here describes an individual,\nand `name` / `profilePictureUrl` are an invented label for the\ncohort, never a real person.",
14130
15328
  "properties": {
14131
- "name": {
14132
- "type": "string"
14133
- },
14134
15329
  "status": {
15330
+ "type": "string",
15331
+ "description": "Only `active` personas may be shown as a benchmark - see\n`memberCount`. Everything else is a work in progress.",
15332
+ "enum": [
15333
+ "active",
15334
+ "inactive",
15335
+ "draft",
15336
+ "pending",
15337
+ "archived",
15338
+ "failed"
15339
+ ]
15340
+ },
15341
+ "source": {
14135
15342
  "type": "string"
14136
15343
  },
15344
+ "name": {
15345
+ "type": "object",
15346
+ "description": "Language-keyed invented name for the archetype. Written once, then stable across rebuilds.",
15347
+ "additionalProperties": true
15348
+ },
15349
+ "profilePictureUrl": {
15350
+ "type": "string",
15351
+ "description": "Illustration for the archetype. Not a photograph of anyone."
15352
+ },
15353
+ "gender": {
15354
+ "type": "object",
15355
+ "description": "Language-keyed, cohort-derived. Locale value unconstrained (Any).",
15356
+ "additionalProperties": true
15357
+ },
15358
+ "ageRange": {
15359
+ "type": "object",
15360
+ "description": "Language-keyed, cohort-derived. Locale value unconstrained (Any).",
15361
+ "additionalProperties": true
15362
+ },
15363
+ "scope": {
15364
+ "type": "object",
15365
+ "description": "Which market this persona describes: `{level: city|voivodeship|\ncountry|remote, city?, voivodeship?, country?}`. A hire feeds\nthree personas (city, voivodeship, country), and consumers take\nthe most specific USABLE one.",
15366
+ "additionalProperties": true
15367
+ },
15368
+ "scopeKey": {
15369
+ "type": "string",
15370
+ "description": "`{positionFamily}#{scope}` - the list filter (`filterScopeKey`) and the index key."
15371
+ },
15372
+ "positionFamily": {
15373
+ "type": "string",
15374
+ "description": "Slug of the role the cohort was hired for, e.g. `regional-sales-representative`."
15375
+ },
15376
+ "memberCount": {
15377
+ "type": "integer",
15378
+ "description": "How many hired talents the cohort holds. Below 3 the profile is\nthose few people in disguise, so it is never published and never\nconsumed - k-anonymity, not a display preference."
15379
+ },
15380
+ "cohortRead": {
15381
+ "type": "integer",
15382
+ "description": "How many members actually fed the profile on this row (diagnostic; can be lower than memberCount)."
15383
+ },
15384
+ "talentCount": {
15385
+ "type": "integer",
15386
+ "description": "Legacy mirror of memberCount."
15387
+ },
15388
+ "version": {
15389
+ "type": "integer",
15390
+ "description": "Bumped by every rebuild that wrote something."
15391
+ },
15392
+ "publishedAt": {
15393
+ "type": "string",
15394
+ "description": "When this persona last became consumable."
15395
+ },
14137
15396
  "timestamps": {
14138
15397
  "title": "ResourceTimestampsSchema",
14139
15398
  "type": "object",
@@ -14147,6 +15406,126 @@
14147
15406
  "format": "date-time"
14148
15407
  }
14149
15408
  }
15409
+ },
15410
+ "availability": {
15411
+ "type": "object",
15412
+ "description": "Language-keyed availability pattern across the cohort. Each entry carries its own prevalence (\"N of M hired talents\").",
15413
+ "additionalProperties": true
15414
+ },
15415
+ "certifications": {
15416
+ "type": "object",
15417
+ "description": "Language-keyed certifications pattern across the cohort. Each entry carries its own prevalence (\"N of M hired talents\").",
15418
+ "additionalProperties": true
15419
+ },
15420
+ "companyTypeExperience": {
15421
+ "type": "object",
15422
+ "description": "Language-keyed companyTypeExperience pattern across the cohort. Each entry carries its own prevalence (\"N of M hired talents\").",
15423
+ "additionalProperties": true
15424
+ },
15425
+ "education": {
15426
+ "type": "object",
15427
+ "description": "Language-keyed education pattern across the cohort. Each entry carries its own prevalence (\"N of M hired talents\").",
15428
+ "additionalProperties": true
15429
+ },
15430
+ "experienceAndSeniority": {
15431
+ "type": "object",
15432
+ "description": "Language-keyed experienceAndSeniority pattern across the cohort. Each entry carries its own prevalence (\"N of M hired talents\").",
15433
+ "additionalProperties": true
15434
+ },
15435
+ "industryExperience": {
15436
+ "type": "object",
15437
+ "description": "Language-keyed industryExperience pattern across the cohort. Each entry carries its own prevalence (\"N of M hired talents\").",
15438
+ "additionalProperties": true
15439
+ },
15440
+ "jobPositions": {
15441
+ "type": "object",
15442
+ "description": "Language-keyed jobPositions pattern across the cohort. Each entry carries its own prevalence (\"N of M hired talents\").",
15443
+ "additionalProperties": true
15444
+ },
15445
+ "jobTendencies": {
15446
+ "type": "object",
15447
+ "description": "Language-keyed jobTendencies pattern across the cohort. Each entry carries its own prevalence (\"N of M hired talents\").",
15448
+ "additionalProperties": true
15449
+ },
15450
+ "languagesSpoken": {
15451
+ "type": "object",
15452
+ "description": "Language-keyed languagesSpoken pattern across the cohort. Each entry carries its own prevalence (\"N of M hired talents\").",
15453
+ "additionalProperties": true
15454
+ },
15455
+ "licenses": {
15456
+ "type": "object",
15457
+ "description": "Language-keyed licenses pattern across the cohort. Each entry carries its own prevalence (\"N of M hired talents\").",
15458
+ "additionalProperties": true
15459
+ },
15460
+ "locationPreferences": {
15461
+ "type": "object",
15462
+ "description": "Language-keyed locationPreferences pattern across the cohort. Each entry carries its own prevalence (\"N of M hired talents\").",
15463
+ "additionalProperties": true
15464
+ },
15465
+ "personalityAndSoftSkills": {
15466
+ "type": "object",
15467
+ "description": "Language-keyed personalityAndSoftSkills pattern across the cohort. Each entry carries its own prevalence (\"N of M hired talents\").",
15468
+ "additionalProperties": true
15469
+ },
15470
+ "salaryExpectation": {
15471
+ "type": "object",
15472
+ "description": "Language-keyed salaryExpectation pattern across the cohort. Each entry carries its own prevalence (\"N of M hired talents\").",
15473
+ "additionalProperties": true
15474
+ },
15475
+ "skillsAndExpertise": {
15476
+ "type": "object",
15477
+ "description": "Language-keyed skillsAndExpertise pattern across the cohort. Each entry carries its own prevalence (\"N of M hired talents\").",
15478
+ "additionalProperties": true
15479
+ },
15480
+ "workAuthorization": {
15481
+ "type": "object",
15482
+ "description": "Language-keyed workAuthorization pattern across the cohort. Each entry carries its own prevalence (\"N of M hired talents\").",
15483
+ "additionalProperties": true
15484
+ },
15485
+ "workPreferences": {
15486
+ "type": "object",
15487
+ "description": "Language-keyed workPreferences pattern across the cohort. Each entry carries its own prevalence (\"N of M hired talents\").",
15488
+ "additionalProperties": true
15489
+ },
15490
+ "responsibilities": {
15491
+ "type": "object",
15492
+ "description": "Language-keyed responsibilities pattern across the cohort. Each entry carries its own prevalence (\"N of M hired talents\").",
15493
+ "additionalProperties": true
15494
+ },
15495
+ "hobbiesAndInterests": {
15496
+ "type": "object",
15497
+ "description": "Language-keyed narrative synthesis. Locale value unconstrained (Any) - see the candidate schema note.",
15498
+ "additionalProperties": true
15499
+ },
15500
+ "personalTraits": {
15501
+ "type": "object",
15502
+ "description": "Language-keyed narrative synthesis. Locale value unconstrained (Any) - see the candidate schema note.",
15503
+ "additionalProperties": true
15504
+ },
15505
+ "goalsAndAspirations": {
15506
+ "type": "object",
15507
+ "description": "Language-keyed narrative synthesis. Locale value unconstrained (Any) - see the candidate schema note.",
15508
+ "additionalProperties": true
15509
+ },
15510
+ "mainFrustrations": {
15511
+ "type": "object",
15512
+ "description": "Language-keyed narrative synthesis. Locale value unconstrained (Any) - see the candidate schema note.",
15513
+ "additionalProperties": true
15514
+ },
15515
+ "keyCompetenciesAndStrengths": {
15516
+ "type": "object",
15517
+ "description": "Language-keyed narrative synthesis. Locale value unconstrained (Any) - see the candidate schema note.",
15518
+ "additionalProperties": true
15519
+ },
15520
+ "quickInsights": {
15521
+ "type": "object",
15522
+ "description": "Language-keyed narrative synthesis. Locale value unconstrained (Any) - see the candidate schema note.",
15523
+ "additionalProperties": true
15524
+ },
15525
+ "keywords": {
15526
+ "type": "object",
15527
+ "description": "Language-keyed narrative synthesis. Locale value unconstrained (Any) - see the candidate schema note.",
15528
+ "additionalProperties": true
14150
15529
  }
14151
15530
  }
14152
15531
  }