interhumanai 2.0.0__tar.gz → 3.0.0__tar.gz

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.
@@ -5,6 +5,19 @@ All notable changes to `interhumanai` are documented here. The package follows
5
5
  the TypeScript SDK (`@interhumanai/sdk`): both packages always carry the same
6
6
  version and release together.
7
7
 
8
+ ## 3.0.0
9
+
10
+ - **Breaking:** renamed the five section fields of ``UploadJobReasoning`` to
11
+ match the sections Inter-2 Deep now reasons in. They are, in order,
12
+ ``baseline_context``, ``observable_evidence``, ``appraisal_inference``,
13
+ ``mental_state_hypothesis`` and ``signal_conclusion``; they replace
14
+ ``perceptual_cues``, ``mental_state_hypothesis``, ``cognitive_execution``,
15
+ ``relational_stance`` and ``synthesis``. ``mental_state_hypothesis`` keeps
16
+ its name but is now the fourth section, and ``signal_conclusion``, which names
17
+ the signals and the evidence for each, is the closest counterpart to
18
+ ``synthesis``. ``trace`` is unchanged, and the
19
+ sections are still ``None`` when the reasoning could not be split into them.
20
+
8
21
  ## 2.0.0
9
22
 
10
23
  - **Breaking:** removed the four legacy per-model scopes from ``Scope``:
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.5
2
2
  Name: interhumanai
3
- Version: 2.0.0
3
+ Version: 3.0.0
4
4
  Summary: First-party Python SDK for the Interhuman API: upload and stream social-signal analysis.
5
5
  Project-URL: Homepage, https://docs.interhuman.ai
6
6
  Project-URL: Repository, https://github.com/interhuman-core/interhuman-api
@@ -190,8 +190,8 @@ else:
190
190
  before it answers: each window carries `reasoning` whenever the model wrote
191
191
  it, an
192
192
  `UploadJobReasoning` with the model's reasoning in five sections
193
- (`perceptual_cues`, `mental_state_hypothesis`, `cognitive_execution`,
194
- `relational_stance`, `synthesis`) and in full as `trace`. The sections are
193
+ (`baseline_context`, `observable_evidence`, `appraisal_inference`,
194
+ `mental_state_hypothesis`, `signal_conclusion`) and in full as `trace`. The sections are
195
195
  `None` when the reasoning could not be split into them; `trace` is always
196
196
  set. It needs `Scope.UPLOAD_INTER_2_DEEP`, which `Scope.UPLOAD` does not
197
197
  cover, and is served on upload jobs only. A window can take a minute or
@@ -201,7 +201,7 @@ else:
201
201
  job = await client.upload.submit("pitch.mp4", model=UploadModel.INTER_2_DEEP)
202
202
  job = await client.upload.wait_for_job(job, timeout=3600)
203
203
  for window in job.result.windows:
204
- print(window.start_seconds, window.reasoning.synthesis or window.reasoning.trace)
204
+ print(window.start_seconds, window.reasoning.signal_conclusion or window.reasoning.trace)
205
205
  ```
206
206
 
207
207
  ### Inter-1 upload (V1, compatibility)
@@ -164,8 +164,8 @@ else:
164
164
  before it answers: each window carries `reasoning` whenever the model wrote
165
165
  it, an
166
166
  `UploadJobReasoning` with the model's reasoning in five sections
167
- (`perceptual_cues`, `mental_state_hypothesis`, `cognitive_execution`,
168
- `relational_stance`, `synthesis`) and in full as `trace`. The sections are
167
+ (`baseline_context`, `observable_evidence`, `appraisal_inference`,
168
+ `mental_state_hypothesis`, `signal_conclusion`) and in full as `trace`. The sections are
169
169
  `None` when the reasoning could not be split into them; `trace` is always
170
170
  set. It needs `Scope.UPLOAD_INTER_2_DEEP`, which `Scope.UPLOAD` does not
171
171
  cover, and is served on upload jobs only. A window can take a minute or
@@ -175,7 +175,7 @@ else:
175
175
  job = await client.upload.submit("pitch.mp4", model=UploadModel.INTER_2_DEEP)
176
176
  job = await client.upload.wait_for_job(job, timeout=3600)
177
177
  for window in job.result.windows:
178
- print(window.start_seconds, window.reasoning.synthesis or window.reasoning.trace)
178
+ print(window.start_seconds, window.reasoning.signal_conclusion or window.reasoning.trace)
179
179
  ```
180
180
 
181
181
  ### Inter-1 upload (V1, compatibility)
@@ -1,3 +1,3 @@
1
1
  """Package version (single source of truth, read by hatchling at build time)."""
2
2
 
3
- __version__ = "2.0.0"
3
+ __version__ = "3.0.0"
@@ -299,24 +299,30 @@ class UploadJobReasoning(BaseModel):
299
299
  sections, and ``trace`` then still carries all of it.
300
300
 
301
301
  Attributes:
302
- perceptual_cues: The visual, verbal and vocal evidence the model
303
- observed.
304
- mental_state_hypothesis: What the person appears to believe, intend,
305
- attend to or doubt.
306
- cognitive_execution: The person's internal state: friction or flow,
307
- such as hesitation, confusion, fluency or self-assurance.
308
- relational_stance: The person's stance toward the partner, task or
309
- topic, such as interest, agreement, skepticism or withdrawal.
310
- synthesis: Why the evidence points to the reported result, and the
311
- closest alternative it rules out.
302
+ baseline_context: The interaction type, topic and social role the
303
+ model read, the baseline behavior it expects for that kind of
304
+ interaction, and what would count as a meaningful deviation.
305
+ observable_evidence: The concrete visual, verbal and vocal cues the
306
+ model observed, without interpretation, and which of them deviate
307
+ from the baseline.
308
+ appraisal_inference: The most probable appraisal behind a deviation,
309
+ such as incomplete understanding, a blocked goal, pressure,
310
+ motivated attention or stable self-assurance, or a note that the
311
+ behavior is within the baseline.
312
+ mental_state_hypothesis: What the person most probably believes,
313
+ intends, feels, attends to or resists given that appraisal, with
314
+ the model's confidence.
315
+ signal_conclusion: Every signal the evidence supports, with its
316
+ strongest grounded evidence, and the closest contrasting signal it
317
+ rules out; or a statement that no signal is supported.
312
318
  trace: The whole reasoning, exactly as the model wrote it.
313
319
  """
314
320
 
315
- perceptual_cues: str | None = None
321
+ baseline_context: str | None = None
322
+ observable_evidence: str | None = None
323
+ appraisal_inference: str | None = None
316
324
  mental_state_hypothesis: str | None = None
317
- cognitive_execution: str | None = None
318
- relational_stance: str | None = None
319
- synthesis: str | None = None
325
+ signal_conclusion: str | None = None
320
326
  trace: str
321
327
 
322
328
 
File without changes
File without changes