docent-python 0.1.57a0__tar.gz → 0.1.58a0__tar.gz

{docent_python-0.1.57a0 → docent_python-0.1.58a0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: docent-python
-Version: 0.1.57a0
+Version: 0.1.58a0
 Summary: Docent SDK
 Project-URL: Homepage, https://github.com/TransluceAI/docent
 Project-URL: Issues, https://github.com/TransluceAI/docent/issues

{docent_python-0.1.57a0 → docent_python-0.1.58a0}/docent/data_models/reading.py

@@ -185,6 +185,25 @@ class ReadingStep(BaseModel):
     approved_at: datetime | None = None
     submitted_at: datetime | None = None
 
+    def to_submission(self, *, dql_query: str | None = None) -> "ReadingStepSubmission":
+        """Convert to a ReadingStepSubmission for resolve_reading_entry.
+
+        Optionally overrides dql_query (e.g. after alias substitution).
+        """
+        return ReadingStepSubmission(
+            alias=self.alias,
+            name=self.name,
+            model=self.model,
+            output_schema=self.output_schema,
+            max_new_tokens=self.max_new_tokens,
+            user_metadata=self.user_metadata,
+            prompt_template_segments=self.prompt_template_segments,
+            context_config=self.context_config,
+            dql_query=dql_query if dql_query is not None else self.dql_query,
+            source_reading_preset_id=self.source_reading_preset_id,
+            cache_mode=self.cache_mode,
+        )
+
 
 PlanStep: TypeAlias = BeginGroupStep | EndGroupStep | DqlOnlyStep | ReadingStep
 
@@ -285,7 +304,6 @@ class PlanSubmissionRequest(BaseModel):
     plan_name: str | None = None
     source_script: str | None = None
     entries: list[PlanStepSubmission]
-    upsert_by_name: bool = False
 
 
 class PlanStepSubmissionStatus(BaseModel):

{docent_python-0.1.57a0 → docent_python-0.1.58a0}/docent/sdk/client.py

@@ -373,7 +373,6 @@ class Docent:
         self._plan_name_sent: bool = False
         self._is_notebook: bool = False
         self._notebook_hook_registered: bool = False
-        self._flushed_names: set[str] = set()
 
         self._register_notebook_hook()
 
@@ -2279,7 +2278,10 @@ class Docent:
         output_schema: dict[str, Any] | None = None,
         max_concurrency: int | None = None,
     ) -> dict[str, Any]:
-        """Submit LLM requests for processing.
+        """
+        Deprecated - use readings instead.
+
+        Submit LLM requests for processing.
 
         Creates a result set and submits requests for background LLM processing.
         Prints the result set URL and returns submission details.
@@ -2380,7 +2382,10 @@ class Docent:
         result_set_name: str | None = None,
         exists_ok: bool = False,
     ) -> dict[str, Any]:
-        """Submit pre-computed results directly.
+        """
+        Deprecated.
+
+        Submit pre-computed results directly.
 
         For use when you've run analysis locally (e.g., with a local LLM)
         and want to upload the results to Docent for viewing.
@@ -2431,7 +2436,10 @@ class Docent:
         collection_id: str,
         name_or_id: str,
     ) -> dict[str, Any]:
-        """Get a result set by name or ID.
+        """
+        Deprecated - use readings instead.
+
+        Get a result set by name or ID.
 
         Args:
             collection_id: ID of the Collection.
@@ -2456,7 +2464,10 @@ class Docent:
         with_auto_joins: bool = False,
         include_incomplete: bool = False,
     ) -> "pd.DataFrame":
-        """Get result set contents as a pandas DataFrame.
+        """
+        Deprecated - use readings instead.
+
+        Get result set contents as a pandas DataFrame.
 
         Args:
             collection_id: ID of the Collection.
@@ -2563,7 +2574,10 @@ class Docent:
         collection_id: str,
         name_or_id: str,
     ) -> str:
-        """Open a result set in the browser.
+        """
+        Deprecated - use readings instead.
+
+        Open a result set in the browser.
 
         Args:
             collection_id: ID of the Collection.
@@ -2665,14 +2679,6 @@ class Docent:
         return alias
 
     def _enqueue_pending(self, entry: PendingEntry) -> None:
-        """Add a pending entry, replacing any existing entry with the same name."""
-        name: str | None = getattr(entry, "name", None)
-        if name is not None:
-            for i, existing in enumerate(self._pending):
-                existing_name: str | None = getattr(existing, "name", None)
-                if existing_name == name:
-                    self._pending[i] = entry
-                    return
         self._pending.append(entry)
 
     def _register_atexit(self) -> None:
@@ -2900,11 +2906,13 @@ class Docent:
 
                 param_name = seg.column_name
                 param_type = seg.type_annotation or "unknown"
+                # Unknown type means "defer to server-side inference"; false here does not
+                # mean the caller explicitly declared a scalar placeholder.
                 segments.append(
                     {
                         "param_name": param_name,
                         "param_type": param_type,
-                        "is_list": False,
+                        "is_list": seg.is_list_annotation if seg.type_annotation else False,
                     }
                 )
                 if context_config and param_name not in param_configs:
@@ -3119,14 +3127,11 @@ class Docent:
             else None
         )
 
-        upsert_by_name = bool(self._flushed_names)
-
         request_body = PlanSubmissionRequest(
             plan_id=self._plan_id,
             plan_name=plan_name,
             source_script=source_script,
             entries=entries,
-            upsert_by_name=upsert_by_name,
         )
         is_first_flush_for_plan = self._plan_id is None
 
@@ -3141,10 +3146,6 @@ class Docent:
         self._flushed_collection_id = collection_id
         self._plan_name_sent = True
 
-        for p in self._pending:
-            entry_name: str | None = getattr(p, "name", None)
-            if entry_name is not None:
-                self._flushed_names.add(entry_name)
         self._pending.clear()
 
         for status_entry in result.get("entry_statuses", []):

{docent_python-0.1.57a0 → docent_python-0.1.58a0}/docent/sdk/llm_request.py

@@ -6,7 +6,10 @@ from docent.sdk.llm_context import PromptData
 
 
 class LLMRequest(BaseModel):
-    """Represents a request for LLM analysis of agent runs/transcripts.
+    """
+    Deprecated - use readings instead.
+
+    Represents a request for LLM analysis of agent runs/transcripts.
 
     Example:
         from docent.sdk.llm_context import Prompt, AgentRunRef
@@ -34,7 +37,11 @@ class LLMRequest(BaseModel):
 
 
 class ExternalAnalysisResult(BaseModel):
-    """Result of run analysis from an external source."""
+    """
+    Deprecated.
+
+    Result of run analysis from an external source.
+    """
 
     request: LLMRequest
     output: dict[str, Any]

{docent_python-0.1.57a0 → docent_python-0.1.58a0}/docent/sdk/reading.py

@@ -30,6 +30,7 @@ class ColumnRef:
         self._query_result = query_result
         self._column_name = column_name
         self._type_annotation: AnnotatableReadingParamType | None = None
+        self._is_list_annotation = False
 
     @property
     def query_result(self) -> QueryResult:
@@ -43,16 +44,29 @@ class ColumnRef:
     def type_annotation(self) -> AnnotatableReadingParamType | None:
         return self._type_annotation
 
-    def as_type(self, type_name: AnnotatableReadingParamType) -> ColumnRef:
+    @property
+    def is_list_annotation(self) -> bool:
+        return self._is_list_annotation
+
+    def as_type(
+        self,
+        type_name: AnnotatableReadingParamType,
+        *,
+        is_list: bool = False,
+    ) -> ColumnRef:
         """Annotate this column reference with an explicit type (e.g. 'transcript')."""
         clone = ColumnRef(self._query_result, self._column_name)
         clone._type_annotation = type_name
+        clone._is_list_annotation = is_list
         return clone
 
     def __repr__(self) -> str:
         base = f"ColumnRef({self._query_result!r}, {self._column_name!r})"
         if self._type_annotation:
-            base = f"{base}.as_type({self._type_annotation!r})"
+            if self._is_list_annotation:
+                base = f"{base}.as_type({self._type_annotation!r}, is_list=True)"
+            else:
+                base = f"{base}.as_type({self._type_annotation!r})"
         return base
 
 

{docent_python-0.1.57a0 → docent_python-0.1.58a0}/pyproject.toml

@@ -1,7 +1,7 @@
 [project]
 name = "docent-python"
 description = "Docent SDK"
-version = "0.1.57-alpha"
+version = "0.1.58-alpha"
 authors = [
   { name="Transluce", email="info@transluce.org" },
 ]

{docent_python-0.1.57a0 → docent_python-0.1.58a0}/uv.lock

@@ -553,7 +553,7 @@ wheels = [
 
 [[package]]
 name = "docent-python"
-version = "0.1.57a0"
+version = "0.1.58a0"
 source = { editable = "." }
 dependencies = [
     { name = "anthropic" },