ot-cli 0.2.1__py3-none-any.whl

openterminal/shell_integration.py

@@ -0,0 +1,7 @@
+"""旧路径壳（阶段二 Task 13）：实现已迁至 shell/integration.py。"""
+
+from .shell.integration import *  # noqa: F401,F403
+from .shell import integration as _impl  # noqa: F401 —— 便于测试直引私有名
+
+def __getattr__(name):
+    return getattr(_impl, name)

openterminal/shell_session.py

@@ -0,0 +1,8 @@
+"""旧路径壳（阶段二 Task 12）：实现已迁至 session/base.py。"""
+
+from .session.base import (  # noqa: F401
+    BEGIN_MARKER, END_MARKER, BasePtySession, CommandResult, ShellSession,
+    _ANSI_RE, _BEGIN_RE, _END_RE, _PASSWORD_PROMPT_RE, _clean,
+    _needs_password_prompt, slice_capture, truncate_output, wrap_command,
+    wrap_passthrough,
+)

openterminal/skills/__init__.py

@@ -0,0 +1,45 @@
+"""内置 Agent Skills（数据包）。
+
+目录结构遵循 Anthropic Agent Skills 约定：每个 skill 一个子目录，
+内含带 YAML frontmatter（name + description）的 SKILL.md。加载、
+校验与渐进式披露由 deepagents 的 SkillsMiddleware 完成（见 agent.py
+的 build_agent），本包只承载数据并描述内置/用户两层挂载点。
+
+挂载方式：内置与用户目录都不在 agent 文件沙箱（shell cwd）内，故经
+CompositeBackend 以虚拟前缀挂进文件系统——模型用 read_file 读
+/skills/.../SKILL.md 即可加载全文，用户目录后挂、同名覆盖内置。
+"""
+
+from __future__ import annotations
+
+from pathlib import Path
+
+# 打包后的内置 skill 根目录（wheel/sdist 均为真实目录）
+BUILTIN_DIR = Path(__file__).resolve().parent
+
+# 虚拟挂载前缀：出现在系统提示词与模型 read_file 的路径里
+BUILTIN_PREFIX = "/skills/builtin/"
+USER_PREFIX = "/skills/user/"
+
+
+def user_skills_dir() -> Path:
+    """用户级 skill 目录：同名 skill 覆盖内置版。"""
+    return Path.home() / ".openterminal" / "skills"
+
+
+def skill_routes() -> dict[str, Path]:
+    """虚拟前缀 → 实际 skill 目录。用户目录不存在时不挂载，
+    避免无意义的加载告警。"""
+    routes = {BUILTIN_PREFIX: BUILTIN_DIR}
+    user = user_skills_dir()
+    if user.is_dir():
+        routes[USER_PREFIX] = user
+    return routes
+
+
+def skill_sources() -> list[tuple[str, str]]:
+    """SkillsMiddleware 的 sources：内置在前、用户在后（后源覆盖先源）。"""
+    return [
+        (prefix, "内置" if prefix == BUILTIN_PREFIX else "用户")
+        for prefix in skill_routes()
+    ]

openterminal/skills/markdown-tables/SKILL.md

@@ -0,0 +1,247 @@
+---
+name: markdown-tables
+description: Use when creating or formatting tables in markdown. Covers table syntax, alignment, escaping, and best practices.
+---
+
+# Markdown Tables
+
+Comprehensive guide to creating and formatting tables in markdown.
+
+## Basic Table Syntax
+
+```markdown
+| Header 1 | Header 2 | Header 3 |
+|----------|----------|----------|
+| Cell 1   | Cell 2   | Cell 3   |
+| Cell 4   | Cell 5   | Cell 6   |
+```
+
+Renders as:
+
+| Header 1 | Header 2 | Header 3 |
+|----------|----------|----------|
+| Cell 1   | Cell 2   | Cell 3   |
+| Cell 4   | Cell 5   | Cell 6   |
+
+## Column Alignment
+
+```markdown
+| Left     | Center   | Right    |
+|:---------|:--------:|---------:|
+| Left     | Center   | Right    |
+| aligned  | aligned  | aligned  |
+```
+
+Renders as:
+
+| Left     | Center   | Right    |
+|:---------|:--------:|---------:|
+| Left     | Center   | aligned  |
+| text     | text     | text     |
+
+- `:---` Left align (default)
+- `:--:` Center align
+- `---:` Right align
+
+## Minimum Syntax
+
+The pipes and dashes don't need to align:
+
+```markdown
+|Header|Header|
+|-|-|
+|Cell|Cell|
+```
+
+However, aligned tables are more readable in source.
+
+## Escaping Pipe Characters
+
+Use `\|` to include a literal pipe in a cell:
+
+```markdown
+| Command | Description |
+|---------|-------------|
+| `a \| b` | Pipe operator |
+| `cmd \|\| exit` | Or operator |
+```
+
+## Inline Formatting in Tables
+
+Tables support inline markdown:
+
+```markdown
+| Feature | Syntax |
+|---------|--------|
+| **Bold** | `**text**` |
+| *Italic* | `*text*` |
+| `Code` | `` `code` `` |
+| [Link](url) | `[text](url)` |
+```
+
+## Multi-line Cell Content
+
+Standard markdown tables don't support multi-line cells. Workarounds:
+
+### Using `<br>` Tags
+
+```markdown
+| Step | Description |
+|------|-------------|
+| 1 | First line<br>Second line |
+| 2 | Another step |
+```
+
+### Using HTML Tables
+
+For complex layouts, use HTML:
+
+```html
+<table>
+  <tr>
+    <th>Header</th>
+    <th>Description</th>
+  </tr>
+  <tr>
+    <td>Item</td>
+    <td>
+      <ul>
+        <li>Point one</li>
+        <li>Point two</li>
+      </ul>
+    </td>
+  </tr>
+</table>
+```
+
+## Empty Cells
+
+Use a space or leave empty:
+
+```markdown
+| A | B | C |
+|---|---|---|
+| 1 |   | 3 |
+| 4 | 5 |   |
+```
+
+## Wide Tables
+
+For tables with many columns, consider:
+
+### Scrollable Container (HTML)
+
+```html
+<div style="overflow-x: auto;">
+
+| Col 1 | Col 2 | Col 3 | Col 4 | Col 5 | Col 6 |
+|-------|-------|-------|-------|-------|-------|
+| Data  | Data  | Data  | Data  | Data  | Data  |
+
+</div>
+```
+
+### Vertical Layout
+
+Transform wide tables into key-value pairs:
+
+```markdown
+### Item 1
+
+| Property | Value |
+|----------|-------|
+| Name     | Foo   |
+| Type     | Bar   |
+| Status   | Active |
+```
+
+## Common Table Patterns
+
+### Comparison Table
+
+```markdown
+| Feature | Free | Pro | Enterprise |
+|---------|:----:|:---:|:----------:|
+| Users   | 5    | 50  | Unlimited  |
+| Storage | 1GB  | 10GB| 100GB      |
+| Support | ❌   | ✅  | ✅         |
+```
+
+### API Reference
+
+```markdown
+| Parameter | Type | Required | Description |
+|-----------|------|:--------:|-------------|
+| `id`      | string | ✅ | Unique identifier |
+| `name`    | string | ✅ | Display name |
+| `limit`   | number | ❌ | Max results (default: 10) |
+```
+
+### Keyboard Shortcuts
+
+```markdown
+| Action | Windows/Linux | macOS |
+|--------|---------------|-------|
+| Copy   | `Ctrl+C`      | `⌘+C` |
+| Paste  | `Ctrl+V`      | `⌘+V` |
+| Undo   | `Ctrl+Z`      | `⌘+Z` |
+```
+
+### Changelog
+
+```markdown
+| Version | Date | Changes |
+|---------|------|---------|
+| 2.0.0 | 2024-01-15 | Breaking: New API |
+| 1.2.0 | 2024-01-01 | Added feature X |
+| 1.1.0 | 2023-12-15 | Bug fixes |
+```
+
+## Best Practices
+
+1. **Keep tables simple**: If content is complex, consider alternatives
+2. **Use consistent alignment**: Align source pipes for readability
+3. **Header row required**: Always include a header row
+4. **Escape special characters**: Use `\|` for literal pipes
+5. **Limit columns**: Wide tables are hard to read
+6. **Consider alternatives**: Lists or definition lists may work better
+7. **Test rendering**: Tables render differently across platforms
+
+## Markdownlint Rules for Tables
+
+| Rule | Description |
+|------|-------------|
+| MD055 | Table pipe style should be consistent |
+| MD056 | Table column count should match header |
+| MD058 | Tables should be surrounded by blank lines |
+
+## Alternatives to Tables
+
+### Definition Lists (Some Parsers)
+
+```markdown
+Term 1
+: Definition 1
+
+Term 2
+: Definition 2
+```
+
+### Bullet Lists with Bold Keys
+
+```markdown
+- **Name**: John Doe
+- **Email**: john@example.com
+- **Role**: Developer
+```
+
+### Nested Lists
+
+```markdown
+- Item 1
+  - Property A: Value
+  - Property B: Value
+- Item 2
+  - Property A: Value
+  - Property B: Value
+```

openterminal/ssh_pty.py

@@ -0,0 +1,6 @@
+"""旧路径壳（阶段二 Task 12）：实现已迁至 session/ssh.py。"""
+
+from .session.ssh import (  # noqa: F401
+    SshPtySession, format_known_host_line, known_hosts_has_entry,
+    known_hosts_path,
+)

openterminal/sysprobe.py

@@ -0,0 +1,7 @@
+"""旧路径壳（阶段二 Task 14）：实现已迁至 agent/sysprobe.py。"""
+
+from .agent.sysprobe import *  # noqa: F401,F403
+from .agent import sysprobe as _impl  # noqa: F401
+
+def __getattr__(name):
+    return getattr(_impl, name)

openterminal/taskview.py

@@ -0,0 +1,7 @@
+"""旧路径壳（阶段二 Task 15）：实现已迁至 frontend/taskview.py。"""
+
+from .frontend.taskview import *  # noqa: F401,F403
+from .frontend import taskview as _impl  # noqa: F401
+
+def __getattr__(name):
+    return getattr(_impl, name)

openterminal/term_frontend.py

@@ -0,0 +1,7 @@
+"""旧路径壳（阶段二 Task 15）：实现已迁至 frontend/term.py。"""
+
+from .frontend.term import *  # noqa: F401,F403
+from .frontend import term as _impl  # noqa: F401
+
+def __getattr__(name):
+    return getattr(_impl, name)

openterminal/token_est.py

@@ -0,0 +1,3 @@
+"""旧路径壳（阶段二 Task 14）：实现已迁至 agent/token_est.py。"""
+
+from .agent.token_est import count_tokens  # noqa: F401

openterminal/transcript.py

@@ -0,0 +1,7 @@
+"""旧路径壳（阶段二 Task 16）：实现已收编至 core/transcript.py。"""
+
+from .core.transcript import *  # noqa: F401,F403
+from .core import transcript as _impl  # noqa: F401
+
+def __getattr__(name):
+    return getattr(_impl, name)

openterminal/web/__init__.py

@@ -0,0 +1 @@
+"""Web 终端：ot web（FastAPI + xterm.js + WebSocket）。"""