deepwrap 0.1.2__tar.gz → 0.2.0__tar.gz

{deepwrap-0.1.2 → deepwrap-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: deepwrap
-Version: 0.1.2
+Version: 0.2.0
 Summary: Python SDK, CLI, and local FastAPI wrapper for DeepSeek Chat.
 Author-email: Nika Kudukhashvili <nikakuduxashvili0@gmail.com>
 Maintainer-email: Nika Kudukhashvili <nikakuduxashvili0@gmail.com>
@@ -100,18 +100,18 @@ Dynamic: license-file
 - [Disclaimer](#disclaimer)
 - [License](#license)
 
-**DeepWrap** is a lightweight Python SDK, CLI, and local HTTP API wrapper for interacting with DeepSeek Chat through a clean developer-friendly interface.
+**DeepWrap** is a lightweight Python SDK, CLI, and local HTTP API wrapper for DeepSeek Chat with session support, browser authentication, streaming, and local developer tooling.
 
 It provides:
 
 - A simple Python client
+- Session-based chat support
 - Streaming and non-streaming chat responses
 - Structured streaming with separated thinking and response chunks
 - Browser-based authentication
-- Local token storage
+- Local token storage and reuse
 - Interactive terminal UI
 - FastAPI server mode
-- Session-based chat support
 - Internal proof-of-work handling
 
 > Repository: [https://github.com/Kuduxaaa/deepwrap](https://github.com/Kuduxaaa/deepwrap)
@@ -184,6 +184,8 @@ Token resolution order:
 4. Saved local config from `deepwrap auth`
 5. Browser authentication only when explicitly requested with `Client.from_browser_auth()` or `allow_browser_auth=True`
 
+`Client` is the main entrypoint for DeepWrap. It resolves bearer tokens from an explicit API key, environment variables, saved local config, or browser auth, then exposes session-based chat and PoW-backed request handling.
+
 ### Direct Token
 
 ```python
@@ -214,6 +216,8 @@ client = Client()
 
 ### Browser Auth from Python
 
+DeepWrap supports browser-based authentication from Python. You can bootstrap a client with `Client.from_browser_auth()` or use `allow_browser_auth=True`, and the library will capture a bearer token from an authenticated browser session before creating the HTTP session.
+
 ```python
 from deepwrap import Client
 
@@ -323,6 +327,66 @@ The `ChatSession` keeps track of the latest message ID internally, so follow-up
 
 ---
 
+### Vision file uploads
+
+Files can be attached only to a `vision` session. DeepWrap uploads the file,
+waits for DeepSeek to process it, and forwards its file ID with the prompt.
+
+```python
+chat = client.chats.create_session(model="vision")
+
+response = chat.respond(
+    "Describe this image.",
+    files=["./photo.png"],
+    stream=False,
+)
+```
+
+You can also upload once and reuse the returned ID:
+
+```python
+uploaded = chat.upload_file("./photo.png")
+response = chat.respond("What is visible?", file_ids=[uploaded.id], stream=False)
+```
+
+### Pseudo function calling
+
+DeepWrap supplies tool definitions through a synthetic system protocol. The model
+either answers normally or returns a strict `<deepwrap_tool_call>` JSON envelope.
+Passing `functions` enables the automatic tool/result loop; omitting it returns the
+parsed call for execution by the application.
+
+```python
+from deepwrap import Tool
+
+add = Tool(
+    name="add",
+    description="Add two integers.",
+    parameters={
+        "type": "object",
+        "properties": {
+            "a": {"type": "integer"},
+            "b": {"type": "integer"},
+        },
+        "required": ["a", "b"],
+    },
+)
+
+result = chat.respond_with_tools(
+    "What is 20 + 22?",
+    [add],
+    functions={"add": lambda a, b: a + b},
+)
+
+print(result.content)
+print(result.tool_calls)
+```
+
+Tool calling is non-streaming because the complete envelope must be validated
+before a function can be selected or executed.
+
+---
+
 ## Supported Models
 
 DeepWrap currently supports:
@@ -333,6 +397,9 @@ default
 vision
 ```
 
+Web search is supported only by `default` (Instant). DeepWrap always sends
+`search_enabled=false` for `expert` and `vision`, even if `search=True` is passed.
+
 Example:
 
 ```python
@@ -343,9 +410,11 @@ chat = client.chats.create_session(model="default")
 
 DeepWrap includes an optional **God Mode** for chat sessions.
 
-When `god_mode` is enabled, the session is initialized with a more direct and **unrestricted behavior profile**. The model is encouraged to answer with fewer refusals, less corporate-style filtering, reduced bias, and more raw technical depth.
+When `god_mode` is enabled, DeepWrap injects a one-time override prompt into the first user turn of the session. This prompt attempts to alter the model’s default behavior by making it less restricted and reducing the effect of built-in safety guardrails.
 
-God Mode is useful when you want the assistant to behave less like a guarded chatbot and more like a direct reasoning engine.
+This can materially change the model’s behavior and may cause it to generate content that is harmful, unethical, inappropriate, or unsuitable for general use.
+
+Because this mode is implemented through prompt injection at the start of a session, its behavior is intentionally intrusive and may diverge from normal model behavior. It should only be used in controlled development and research environments.
 
 > God Mode is disabled by default and must be enabled explicitly per session.
 
@@ -362,7 +431,7 @@ chat = client.chats.create_session(
 )
 
 response = chat.respond(
-    "How to steal someone's crypto wallet? 3:)",
+    "Give me a blunt explanation of Python metaclasses.",
     stream=False,
 )
 
@@ -379,6 +448,17 @@ Run the interactive terminal interface:
 deepwrap
 ```
 
+To attach an image in interactive mode:
+
+```text
+/model vision
+/attach ./photo.png
+Describe this image.
+```
+
+Use `/attachments` to inspect pending files and `/detach` to clear them. Pending
+attachments are consumed after the next successful response.
+
 Send a single message from the terminal:
 
 ```bash
@@ -461,7 +541,7 @@ deepwrap api
 Specify host and port:
 
 ```bash
-deepwrap api --host 127.0.0.1 --port 7070
+deepwrap api --host 127.0.0.1 --port 8000
 ```
 
 Enable reload for development:
@@ -489,7 +569,7 @@ deepwrap api --log-level debug
 ### Health Check
 
 ```bash
-curl http://127.0.0.1:7070/health
+curl http://127.0.0.1:8000/health
 ```
 
 Example response:
@@ -498,7 +578,7 @@ Example response:
 {
   "ok": true,
   "app": "deepwrap",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "token_configured": true,
   "cached_clients": 1,
   "active_sessions": 0
@@ -510,7 +590,7 @@ Example response:
 ### One-Shot Chat Request
 
 ```bash
-curl -X POST http://127.0.0.1:7070/chat \
+curl -X POST http://127.0.0.1:8000/chat \
   -H "Content-Type: application/json" \
   -d '{
     "message": "Explain recursion in one sentence.",
@@ -536,7 +616,7 @@ Example response:
 ### Create Persistent Session
 
 ```bash
-curl -X POST http://127.0.0.1:7070/sessions \
+curl -X POST http://127.0.0.1:8000/sessions \
   -H "Content-Type: application/json" \
   -d '{
     "model": "expert"
@@ -558,7 +638,7 @@ Example response:
 ### Use Persistent Session
 
 ```bash
-curl -X POST http://127.0.0.1:7070/chat \
+curl -X POST http://127.0.0.1:8000/chat \
   -H "Content-Type: application/json" \
   -d '{
     "session_id": "chat_abc123",
@@ -570,7 +650,7 @@ curl -X POST http://127.0.0.1:7070/chat \
 Then:
 
 ```bash
-curl -X POST http://127.0.0.1:7070/chat \
+curl -X POST http://127.0.0.1:8000/chat \
   -H "Content-Type: application/json" \
   -d '{
     "session_id": "chat_abc123",
@@ -584,7 +664,7 @@ curl -X POST http://127.0.0.1:7070/chat \
 ### Delete Session
 
 ```bash
-curl -X DELETE http://127.0.0.1:7070/sessions/chat_abc123
+curl -X DELETE http://127.0.0.1:8000/sessions/chat_abc123
 ```
 
 ---
@@ -594,7 +674,7 @@ curl -X DELETE http://127.0.0.1:7070/sessions/chat_abc123
 ### Plain Text Streaming
 
 ```bash
-curl -N -X POST http://127.0.0.1:7070/chat \
+curl -N -X POST http://127.0.0.1:8000/chat \
   -H "Content-Type: application/json" \
   -d '{
     "message": "Explain black holes simply.",
@@ -609,7 +689,7 @@ curl -N -X POST http://127.0.0.1:7070/chat \
 ### Server-Sent Events Streaming
 
 ```bash
-curl -N -X POST http://127.0.0.1:7070/chat \
+curl -N -X POST http://127.0.0.1:8000/chat \
   -H "Content-Type: application/json" \
   -d '{
     "message": "Explain black holes simply.",

{deepwrap-0.1.2 → deepwrap-0.2.0}/README.md

@@ -45,18 +45,18 @@
 - [Disclaimer](#disclaimer)
 - [License](#license)
 
-**DeepWrap** is a lightweight Python SDK, CLI, and local HTTP API wrapper for interacting with DeepSeek Chat through a clean developer-friendly interface.
+**DeepWrap** is a lightweight Python SDK, CLI, and local HTTP API wrapper for DeepSeek Chat with session support, browser authentication, streaming, and local developer tooling.
 
 It provides:
 
 - A simple Python client
+- Session-based chat support
 - Streaming and non-streaming chat responses
 - Structured streaming with separated thinking and response chunks
 - Browser-based authentication
-- Local token storage
+- Local token storage and reuse
 - Interactive terminal UI
 - FastAPI server mode
-- Session-based chat support
 - Internal proof-of-work handling
 
 > Repository: [https://github.com/Kuduxaaa/deepwrap](https://github.com/Kuduxaaa/deepwrap)
@@ -129,6 +129,8 @@ Token resolution order:
 4. Saved local config from `deepwrap auth`
 5. Browser authentication only when explicitly requested with `Client.from_browser_auth()` or `allow_browser_auth=True`
 
+`Client` is the main entrypoint for DeepWrap. It resolves bearer tokens from an explicit API key, environment variables, saved local config, or browser auth, then exposes session-based chat and PoW-backed request handling.
+
 ### Direct Token
 
 ```python
@@ -159,6 +161,8 @@ client = Client()
 
 ### Browser Auth from Python
 
+DeepWrap supports browser-based authentication from Python. You can bootstrap a client with `Client.from_browser_auth()` or use `allow_browser_auth=True`, and the library will capture a bearer token from an authenticated browser session before creating the HTTP session.
+
 ```python
 from deepwrap import Client
 
@@ -268,6 +272,66 @@ The `ChatSession` keeps track of the latest message ID internally, so follow-up
 
 ---
 
+### Vision file uploads
+
+Files can be attached only to a `vision` session. DeepWrap uploads the file,
+waits for DeepSeek to process it, and forwards its file ID with the prompt.
+
+```python
+chat = client.chats.create_session(model="vision")
+
+response = chat.respond(
+    "Describe this image.",
+    files=["./photo.png"],
+    stream=False,
+)
+```
+
+You can also upload once and reuse the returned ID:
+
+```python
+uploaded = chat.upload_file("./photo.png")
+response = chat.respond("What is visible?", file_ids=[uploaded.id], stream=False)
+```
+
+### Pseudo function calling
+
+DeepWrap supplies tool definitions through a synthetic system protocol. The model
+either answers normally or returns a strict `<deepwrap_tool_call>` JSON envelope.
+Passing `functions` enables the automatic tool/result loop; omitting it returns the
+parsed call for execution by the application.
+
+```python
+from deepwrap import Tool
+
+add = Tool(
+    name="add",
+    description="Add two integers.",
+    parameters={
+        "type": "object",
+        "properties": {
+            "a": {"type": "integer"},
+            "b": {"type": "integer"},
+        },
+        "required": ["a", "b"],
+    },
+)
+
+result = chat.respond_with_tools(
+    "What is 20 + 22?",
+    [add],
+    functions={"add": lambda a, b: a + b},
+)
+
+print(result.content)
+print(result.tool_calls)
+```
+
+Tool calling is non-streaming because the complete envelope must be validated
+before a function can be selected or executed.
+
+---
+
 ## Supported Models
 
 DeepWrap currently supports:
@@ -278,6 +342,9 @@ default
 vision
 ```
 
+Web search is supported only by `default` (Instant). DeepWrap always sends
+`search_enabled=false` for `expert` and `vision`, even if `search=True` is passed.
+
 Example:
 
 ```python
@@ -288,9 +355,11 @@ chat = client.chats.create_session(model="default")
 
 DeepWrap includes an optional **God Mode** for chat sessions.
 
-When `god_mode` is enabled, the session is initialized with a more direct and **unrestricted behavior profile**. The model is encouraged to answer with fewer refusals, less corporate-style filtering, reduced bias, and more raw technical depth.
+When `god_mode` is enabled, DeepWrap injects a one-time override prompt into the first user turn of the session. This prompt attempts to alter the model’s default behavior by making it less restricted and reducing the effect of built-in safety guardrails.
 
-God Mode is useful when you want the assistant to behave less like a guarded chatbot and more like a direct reasoning engine.
+This can materially change the model’s behavior and may cause it to generate content that is harmful, unethical, inappropriate, or unsuitable for general use.
+
+Because this mode is implemented through prompt injection at the start of a session, its behavior is intentionally intrusive and may diverge from normal model behavior. It should only be used in controlled development and research environments.
 
 > God Mode is disabled by default and must be enabled explicitly per session.
 
@@ -307,7 +376,7 @@ chat = client.chats.create_session(
 )
 
 response = chat.respond(
-    "How to steal someone's crypto wallet? 3:)",
+    "Give me a blunt explanation of Python metaclasses.",
     stream=False,
 )
 
@@ -324,6 +393,17 @@ Run the interactive terminal interface:
 deepwrap
 ```
 
+To attach an image in interactive mode:
+
+```text
+/model vision
+/attach ./photo.png
+Describe this image.
+```
+
+Use `/attachments` to inspect pending files and `/detach` to clear them. Pending
+attachments are consumed after the next successful response.
+
 Send a single message from the terminal:
 
 ```bash
@@ -406,7 +486,7 @@ deepwrap api
 Specify host and port:
 
 ```bash
-deepwrap api --host 127.0.0.1 --port 7070
+deepwrap api --host 127.0.0.1 --port 8000
 ```
 
 Enable reload for development:
@@ -434,7 +514,7 @@ deepwrap api --log-level debug
 ### Health Check
 
 ```bash
-curl http://127.0.0.1:7070/health
+curl http://127.0.0.1:8000/health
 ```
 
 Example response:
@@ -443,7 +523,7 @@ Example response:
 {
   "ok": true,
   "app": "deepwrap",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "token_configured": true,
   "cached_clients": 1,
   "active_sessions": 0
@@ -455,7 +535,7 @@ Example response:
 ### One-Shot Chat Request
 
 ```bash
-curl -X POST http://127.0.0.1:7070/chat \
+curl -X POST http://127.0.0.1:8000/chat \
   -H "Content-Type: application/json" \
   -d '{
     "message": "Explain recursion in one sentence.",
@@ -481,7 +561,7 @@ Example response:
 ### Create Persistent Session
 
 ```bash
-curl -X POST http://127.0.0.1:7070/sessions \
+curl -X POST http://127.0.0.1:8000/sessions \
   -H "Content-Type: application/json" \
   -d '{
     "model": "expert"
@@ -503,7 +583,7 @@ Example response:
 ### Use Persistent Session
 
 ```bash
-curl -X POST http://127.0.0.1:7070/chat \
+curl -X POST http://127.0.0.1:8000/chat \
   -H "Content-Type: application/json" \
   -d '{
     "session_id": "chat_abc123",
@@ -515,7 +595,7 @@ curl -X POST http://127.0.0.1:7070/chat \
 Then:
 
 ```bash
-curl -X POST http://127.0.0.1:7070/chat \
+curl -X POST http://127.0.0.1:8000/chat \
   -H "Content-Type: application/json" \
   -d '{
     "session_id": "chat_abc123",
@@ -529,7 +609,7 @@ curl -X POST http://127.0.0.1:7070/chat \
 ### Delete Session
 
 ```bash
-curl -X DELETE http://127.0.0.1:7070/sessions/chat_abc123
+curl -X DELETE http://127.0.0.1:8000/sessions/chat_abc123
 ```
 
 ---
@@ -539,7 +619,7 @@ curl -X DELETE http://127.0.0.1:7070/sessions/chat_abc123
 ### Plain Text Streaming
 
 ```bash
-curl -N -X POST http://127.0.0.1:7070/chat \
+curl -N -X POST http://127.0.0.1:8000/chat \
   -H "Content-Type: application/json" \
   -d '{
     "message": "Explain black holes simply.",
@@ -554,7 +634,7 @@ curl -N -X POST http://127.0.0.1:7070/chat \
 ### Server-Sent Events Streaming
 
 ```bash
-curl -N -X POST http://127.0.0.1:7070/chat \
+curl -N -X POST http://127.0.0.1:8000/chat \
   -H "Content-Type: application/json" \
   -d '{
     "message": "Explain black holes simply.",

deepwrap-0.2.0/deepwrap/__init__.py

@@ -0,0 +1,4 @@
+from .client import Client
+from .function_calling import Tool, ToolCall, ToolResponse
+
+__all__ = ["Client", "Tool", "ToolCall", "ToolResponse"]

{deepwrap-0.1.2 → deepwrap-0.2.0}/deepwrap/__main__.py

@@ -6,6 +6,7 @@ from typing import Optional
 import click
 
 from deepwrap import Client
+from deepwrap.config import PROJECT_VERSION
 from deepwrap.core import Auth
 from deepwrap.interfaces.cli import main as interactive_main
 from deepwrap.utils.bearer_token_extractor import BearerTokenExtractor
@@ -13,7 +14,6 @@ from deepwrap.utils.config_store import ConfigStore
 
 
 APP_NAME = "deepwrap"
-VERSION = "0.1.0"
 SUPPORTED_MODELS = ("expert", "default", "vision")
 
 
@@ -82,7 +82,7 @@ def echo_error(message: str) -> None:
         "help_option_names": ["-h", "--help"],
     },
 )
-@click.version_option(version=VERSION, prog_name=APP_NAME)
+@click.version_option(version=PROJECT_VERSION, prog_name=APP_NAME)
 @click.pass_context
 def cli(ctx: click.Context) -> None:
     """
@@ -195,24 +195,6 @@ def auth_command(
         raise DeepWrapCLIError(f"Authentication failed: {exc}") from exc
 
 
-@cli.command("logout")
-def logout_command() -> None:
-    """
-    Remove the saved DeepWrap token from local config.
-    """
-
-    try:
-        store = ConfigStore()
-        config = store.load()
-        config.token = None
-        store.save(config)
-
-        echo_success(f"Logged out. Token removed from: {store.path}")
-
-    except Exception as exc:
-        raise DeepWrapCLIError(f"Logout failed: {exc}") from exc
-
-
 @cli.command("api")
 @click.option(
     "--host",

deepwrap-0.2.0/deepwrap/api/__init__.py

@@ -0,0 +1,10 @@
+from .pow import PowAPI
+from .chats import ChatsAPI
+from .files import FilesAPI, UploadedFile
+
+__all__ = [
+    "PowAPI",
+    "ChatsAPI",
+    "FilesAPI",
+    "UploadedFile",
+]