cecli-dev 1.0.0rc5__tar.gz → 1.0.0rc6__tar.gz

{cecli_dev-1.0.0rc5 → cecli_dev-1.0.0rc6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cecli-dev
-Version: 1.0.0rc5
+Version: 1.0.0rc6
 Summary: we also can't pronounce cecli
 Project-URL: Homepage, https://github.com/dwash96/cecli
 Project-URL: Documentation, https://github.com/dwash96/cecli

{cecli_dev-1.0.0rc5 → cecli_dev-1.0.0rc6}/cecli/_version.py

@@ -18,7 +18,7 @@ version_tuple: tuple[int | str, ...]
 commit_id: str | None
 __commit_id__: str | None
 
-__version__ = version = '1.0.0rc5'
-__version_tuple__ = version_tuple = (1, 0, 0, 'rc5')
+__version__ = version = '1.0.0rc6'
+__version_tuple__ = version_tuple = (1, 0, 0, 'rc6')
 
-__commit_id__ = commit_id = 'g5575d3301'
+__commit_id__ = commit_id = 'gddead555a'

{cecli_dev-1.0.0rc5 → cecli_dev-1.0.0rc6}/cecli/helpers/hashpos/hashpos.py

@@ -101,15 +101,14 @@ class HashPos:
         packed = (line_hash << 20) | (idx_bits << 6) | occ_bits
 
         res = ""
-        for _ in range(4):
-            res += self.B1024[packed % 1024]
-            packed //= 1024
+        for i in range(3, -1, -1):
+            res += self.B1024[(packed >> (10 * i)) & 0x3FF]
         return res
 
     def unpack_public_id(self, public_id: str) -> tuple[int, int, int]:
         packed = 0
         for i, char in enumerate(public_id):
-            packed |= self.B1024.index(char) << (10 * i)
+            packed |= self.B1024.index(char) << (10 * (3 - i))
 
         occ_bits = packed & 0x3F
         idx_bits = (packed >> 6) & 0x3FFF

{cecli_dev-1.0.0rc5 → cecli_dev-1.0.0rc6}/cecli/helpers/orchestration/environment.py

@@ -478,7 +478,8 @@ def build_orchestration_context_block(agent_config: dict[str, Any]) -> str | Non
         return None
 
     return """<context name="orchestration" from="agent">
-The `Orchestrate` tool lets you coordinate chains of sub agents and tools with Python code in a limited, secure sandbox across multiple turns.
+The `Orchestrate` tool lets you batch multiple tool calls in a single step by writing Python code in a limited, secure sandbox.
+This is much more efficient than making individual tool calls for loop-heavy workflows.
 Variables and methods defined in a script are persisted in subsequent turns.
 As such, results from previous calls can be reused and helper methods can be defined to enhance ease of use within the environment.
 
@@ -495,6 +496,10 @@ As such, results from previous calls can be reused and helper methods can be def
 | `Agent.peek(result)` | Inspect a tool result's structure and leaf content — returns a string; use `print(Agent.peek(result))` to see it |
 | `Agent.get_value(result, path, default?)` | Safely access nested values in tool results using dot-notation (e.g. `"result.0.content"`)  |
 
+| `Agent.get_content_id(path, text)` | Resolve a content ID from `@L{num}` or line text for EditFile |
+| `Agent.resolve_regions(path, regions)` | Batch-resolve text patterns to content IDs. Use `start_line_hint` / `end_line_hint` in region spec entries for disambiguation (supports `@L<num>`, `@A{{regex}}`, `@B{{regex}}` — same hint syntax as ReadFile). Ambiguous patterns raise immediately. The returned `AgentRegion` has `.get_start(name)`, `.get_end(name)`, `.names()`, `.get(name)` |
+| `Agent.edit_region(path, edits)` | Thin wrapper around EditFile that accepts pre-resolved region dicts `{"start": content_id, "end": content_id}`. Use with `Agent.resolve_regions()` and `regions.get(name)` |
+
 | `await Agent.sleep(seconds)` | Pause execution (0-120s max) |
 
 | `gather(**named_tasks)` | Run tasks concurrently; returns an iterable with `.key` / `["key"]` access |
@@ -524,8 +529,8 @@ All other module imports will fail.
 ```python
 tool = Agent.get_tool("delegate")
 tool_outputs = await gather(
-    a=tool.call(prompt="A", async=False),
-    b=tool.call(prompt="B", async=False),
+    a=tool.call(prompt="A"),
+    b=tool.call(prompt="B"),
 )
 print(tool_outputs.a)              # attribute access
 print(tool_outputs["b"])           # key access
@@ -547,6 +552,51 @@ to extract specific fields by dot-path::
 Result list items are plain dicts — use item['content'] / item.get('content')
 and item['_'] / item.get('_') to access data and metadata respectively.
 
+### Creating New Files
+
+Use `ResourceManager` to create an empty file, then `EditFile` to write
+initial content (use `@000` for start/end on empty files)::
+
+    rm = Agent.get_tool("ResourceManager")
+    edit = Agent.get_tool("EditFile")
+
+    await rm.call(create=["path/to/new_file.py"])
+    await edit.call(edits=[{
+        "file_path": "path/to/new_file.py",
+        "operation": "replace",
+        "start_line": "@000",
+        "end_line": "@000",
+        "text": "def greet(name):\n    return f\"Hello, {name}!\"\n",
+    }])
+
+After creation, use `resolve_regions` and `edit_region` for targeted edits.
+
+### Editing with Regions
+
+Use `Agent.resolve_regions()` to convert text patterns into content IDs, then `Agent.edit_region()` to apply edits using the resolved IDs.
+
+#### Step 1 —  resolve region boundaries once
+
+```python
+regions = Agent.resolve_regions("foo.py", [
+    {"name": "my_func", "start": "def my_func", "end": "return result"},
+    {"name": "init",    "start": "def __init__", "end": "self.x = x"},
+])
+```
+
+#### Step 2 — Use `regions.get(name)` with `Agent.edit_region()` (recommended shorthand)
+
+```python
+await Agent.edit_region(
+    file_path="foo.py",
+    edits=[
+        {"region": regions.get("my_func"), "text": "def my_func():\n    return 42"},
+    ],
+)
+```
+
+#### Alternative: Call `EditFile` directly with `regions.get_start()` / `regions.get_end()`
+
 ### Gotchas
 
 - **Types**: compare with `typeof(x) == dict` or `isinstance(x, dict)` — NOT `typeof(x) == "dict"`

{cecli_dev-1.0.0rc5 → cecli_dev-1.0.0rc6}/cecli/tools/grep.py

@@ -228,25 +228,18 @@ class Tool(BaseTool):
                                     "default": True,
                                     "description": "Whether to perform a case-insensitive search.",
                                 },
-                                "count": {
-                                    "type": "boolean",
-                                    "default": True,
-                                    "description": (
-                                        "Include match counts per file in the output summary."
-                                    ),
-                                },
                                 "context_before": {
                                     "type": "integer",
                                     "default": 2,
                                     "description": (
-                                        "Number of context lines to show before each match."
+                                        "Number of context lines to show before each match. Max 5"
                                     ),
                                 },
                                 "context_after": {
                                     "type": "integer",
                                     "default": 2,
                                     "description": (
-                                        "Number of context lines to show after each match."
+                                        "Number of context lines to show after each match. Max 5"
                                     ),
                                 },
                             },
@@ -362,8 +355,8 @@ class Tool(BaseTool):
             directory = search_op.get("directory", search_op.get("path", "."))
             use_regex = search_op.get("use_regex", False)
             case_insensitive = search_op.get("case_insensitive", True)
-            context_before = search_op.get("context_before", 2)
-            context_after = search_op.get("context_after", 2)
+            context_before = max(min(int(search_op.get("context_before", 2)), 5), 0)
+            context_after = max(min(int(search_op.get("context_after", 2)), 5), 0)
             count_enabled = search_op.get("count", True)
 
             op_result = {
@@ -502,7 +495,7 @@ class Tool(BaseTool):
                     MAX_MATCHES_PER_FILE = 10
                     MAX_FILES = 20
 
-                    truncated_files = []
+                    truncated_files = {}
                     total_matches = 0
                     total_files = 0
 
@@ -510,14 +503,21 @@ class Tool(BaseTool):
                         file_lines = pf["content"].splitlines()
                         # Find actual match lines (lines with `:LINE:` pattern)
                         filepath_escaped = re.escape(pf["path"])
-                        match_line_re = re.compile(r"^" + filepath_escaped + r":\d+:")
+                        match_line_re = re.compile(r"^" + filepath_escaped + r":(\d+):")
                         match_lines_found = [ln for ln in file_lines if match_line_re.match(ln)]
 
                         # Normalize path to be relative to repo root
                         pf["path"] = os.path.relpath(pf["path"], repo.root)
 
                         if len(match_lines_found) > MAX_MATCHES_PER_FILE:
-                            truncated_files.append(pf["path"])
+                            # Extract line numbers from excess matches (beyond first 10)
+                            extra_lines = match_lines_found[MAX_MATCHES_PER_FILE:]
+                            extra_line_nums = []
+                            for xline in extra_lines:
+                                xm = match_line_re.match(xline)
+                                if xm:
+                                    extra_line_nums.append(int(xm.group(1)))
+                            truncated_files[pf["path"]] = extra_line_nums
                             trimmed = "\n".join(match_lines_found[:MAX_MATCHES_PER_FILE])
                             pf["content"] = trimmed
                         total_matches += pf.get("count_from_pass", 0)
@@ -536,7 +536,7 @@ class Tool(BaseTool):
                         {
                             "file": pf["path"],
                             "match_count": pf.get("count_from_pass", 0),
-                            "truncated": pf["path"] in truncated_files,
+                            "additional_matched_lines": truncated_files.get(pf["path"], []),
                             "content": pf["content"],
                         }
                         for pf in parsed_files[:MAX_FILES]
@@ -573,7 +573,7 @@ class Tool(BaseTool):
         response = ToolResponse(cls.NORM_NAME, result_type=cls.RESULT_TYPE)
         for op_result in all_operation_results:
             files = op_result.get("files", [])
-            metadata = {k: v for k, v in op_result.items() if k != "files"}
+            metadata = op_result.copy()
 
             # Build a human-readable string summary as content
             pattern = op_result.get("pattern", "")
@@ -584,7 +584,7 @@ class Tool(BaseTool):
             else:
                 lines = [f"[{pattern}]"]
                 for f in files:
-                    truncated_mark = " (truncated)" if f.get("truncated") else ""
+                    truncated_mark = " (truncated)" if f.get("additional_matched_lines") else ""
                     lines.append(f"{f['file']}: {f['match_count']} match(es){truncated_mark}")
                 if op_result.get("has_more_files"):
                     lines.append(f"... ({op_result['total_files']} files total)")
@@ -616,7 +616,7 @@ class Tool(BaseTool):
             for i, search_op in enumerate(searches):
                 pattern = search_op.get("pattern", "")
                 file_pattern = search_op.get("file_glob", "*")
-                directory = search_op.get("directory", ".")
+                directory = search_op.get("directory", search_op.get("path", "."))
                 use_regex = search_op.get("use_regex", False)
                 case_insensitive = search_op.get("case_insensitive", True)
                 context_before = search_op.get("context_before", 2)

{cecli_dev-1.0.0rc5 → cecli_dev-1.0.0rc6}/cecli_dev.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cecli-dev
-Version: 1.0.0rc5
+Version: 1.0.0rc6
 Summary: we also can't pronounce cecli
 Project-URL: Homepage, https://github.com/dwash96/cecli
 Project-URL: Documentation, https://github.com/dwash96/cecli

{cecli_dev-1.0.0rc5 → cecli_dev-1.0.0rc6}/cecli_dev.egg-info/scm_version.json

@@ -1,7 +1,7 @@
 {
-  "tag": "1.0.0rc5",
+  "tag": "1.0.0rc6",
   "distance": 0,
-  "node": "g5575d3301026886433978c5438db76e897987533",
+  "node": "gddead555a59f1c7b5a8d8dae32010e26bbb899e6",
   "dirty": false,
   "branch": "HEAD",
   "node_date": "2026-07-20"