kawlnow 0.1.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.
@@ -0,0 +1,4 @@
1
+ include README.md pyproject.toml
2
+ recursive-include src/kawlnow *.py
3
+ prune tests
4
+ global-exclude __pycache__ *.py[cod]
kawlnow-0.1.0/PKG-INFO ADDED
@@ -0,0 +1,111 @@
1
+ Metadata-Version: 2.4
2
+ Name: kawlnow
3
+ Version: 0.1.0
4
+ Summary: Install Kawl Now in HTML, Flask and Django websites before connecting a setup key.
5
+ Author: Kawl Now
6
+ Project-URL: Homepage, https://www.kawlnow.com/install
7
+ Project-URL: Documentation, https://app.kawlnow.com/agent-setup.md
8
+ Project-URL: Source, https://pypi.org/project/kawlnow/0.1.0/#files
9
+ Project-URL: Support, https://www.kawlnow.com/install
10
+ Keywords: kawlnow,voice,support,sales,installer,agent,flask,django
11
+ Classifier: Environment :: Console
12
+ Classifier: Programming Language :: Python :: 3
13
+ Classifier: Programming Language :: Python :: 3 :: Only
14
+ Classifier: Topic :: Software Development :: Build Tools
15
+ Requires-Python: >=3.10
16
+ Description-Content-Type: text/markdown
17
+
18
+ # Kawl Now for Python websites
19
+
20
+ Prepare the voice widget in an existing HTML, Flask/Jinja or Django shared
21
+ template, run your website checks, then connect a short-lived setup API key.
22
+ This is a native Python installer: it has no runtime dependencies and does not
23
+ download or invoke Node, npm, a JavaScript runtime, or your application code.
24
+ Python 3.10 or newer is required.
25
+
26
+ Ask your coding agent:
27
+
28
+ > Install Kawl Now in this website using https://www.kawlnow.com/install.
29
+ > Finish the local integration and checks first, then ask me for my setup API key.
30
+
31
+ Run a pinned, isolated installer with [uv](https://docs.astral.sh/uv/guides/tools/):
32
+
33
+ ```sh
34
+ uvx --from kawlnow==0.1.0 kawlnow init --channel support --write --json
35
+ ```
36
+
37
+ For an explicit shared template:
38
+
39
+ ```sh
40
+ uvx --from kawlnow==0.1.0 kawlnow init --channel support --target templates/base.html --write --json
41
+ ```
42
+
43
+ Use `--channel sales` for Sales. Without `--write`, `init` only prints a local
44
+ plan; it never reads a key, makes a network request or changes a file.
45
+ Auto-detection accepts one unambiguous existing shared HTML shell. If several
46
+ candidate shells exist, select the intended file with `--target`.
47
+ It preserves the existing template, scripts, template expressions and line
48
+ endings. The inactive marker does not load the widget. Review template conditions
49
+ and inheritance with your coding agent; a source-file check cannot prove which
50
+ pages actually render that template.
51
+
52
+ For a reusable isolated tool, `pipx install kawlnow==0.1.0` exposes the same
53
+ `kawlnow` command. In an existing virtual environment, use
54
+ `python -m pip install kawlnow==0.1.0`, then `python -m kawlnow`.
55
+ Use the npm installer for React and Next.js applications; this distribution
56
+ does not pretend to install React dependencies or wire JSX layouts.
57
+
58
+ Check the prepared integration without account access:
59
+
60
+ ```sh
61
+ uvx --from kawlnow==0.1.0 kawlnow doctor --channel support --site-origin https://YOUR_VERIFIED_DOMAIN --json
62
+ ```
63
+
64
+ `doctor` (also named `status`) checks the saved public plan, owned marker, file
65
+ hash and shared shell. The shared `kawlnow-install` protocol version 1 exposes
66
+ `readiness.keyInputAllowed`: it is true only for unchanged local preparation
67
+ and an explicitly supplied production origin. A missing origin reports
68
+ `awaiting_site_origin`; a missing plan reports `not_prepared`.
69
+ Its structured `nextActions` and `resume.argv` explain
70
+ the next step. Exit **0** means a local dry run, a ready local doctor check or a connected local integration;
71
+ exit **2** means input or a later acceptance step is still required; exit **1**
72
+ means a conflict or error. None of those states establishes voice acceptance.
73
+
74
+ After local preparation, create a **setup key** in Kawl Now's Installation panel
75
+ for the selected brand and Support/Sales agent. It expires after 24 hours.
76
+ No workspace ID or browser OAuth session is needed to begin. Connect using the
77
+ same pinned installer version that created the plan:
78
+
79
+ ```sh
80
+ uvx --from kawlnow==0.1.0 kawlnow connect --channel support --site-origin https://YOUR_VERIFIED_DOMAIN --write
81
+ ```
82
+
83
+ The interactive command reads a hidden terminal prompt. A coding agent or CI
84
+ runner can instead supply one secret line through `--api-key-stdin` or the
85
+ `KAWLNOW_SETUP_KEY` variable using its ephemeral secret facility. `--json`
86
+ never prompts. Never paste a key into a command argument, inline environment
87
+ assignment, source file, chat prompt, public plan or log. Keys are used in memory
88
+ and are not persisted. A full-management token is rejected.
89
+
90
+ The production origin is explicit: metadata inside your repository cannot
91
+ authorize a new origin or choose a credential destination. Connection verifies
92
+ the selected brand and channel, merges only the supplied origin and preserves
93
+ existing origins. `--expect-workspace PUBLIC_BRAND_ID` can bind public brand
94
+ context copied from the dashboard. The default key destination is
95
+ `https://app.kawlnow.com`; a custom public HTTPS endpoint must be explicitly
96
+ trusted with `--app-origin` on every connection. Redirects are refused.
97
+
98
+ The public `kawlnow.python.install.support.json` (or Sales equivalent) records
99
+ only public integration context. It is deliberately separate from npm plans.
100
+ The installer refuses changed files, symbolic links, unsupported paths and
101
+ existing integrations requiring review. Repeated preparation is idempotent.
102
+
103
+ The installer does not publish your website, approve knowledge, enable customer
104
+ calls, change billing or destinations, start conversations or test a microphone.
105
+ After an authorized website deployment, inspect the real widget and use the
106
+ Installation panel's bounded verifier. The verifier is static; browser behavior,
107
+ voice acceptance and owner call enablement remain separate checks.
108
+
109
+ Public guides: [installation and starters](https://www.kawlnow.com/install),
110
+ [complete setup reference](https://app.kawlnow.com/setup-guide),
111
+ [browser-local widget checker](https://www.kawlnow.com/tools/widget-checker).
@@ -0,0 +1,94 @@
1
+ # Kawl Now for Python websites
2
+
3
+ Prepare the voice widget in an existing HTML, Flask/Jinja or Django shared
4
+ template, run your website checks, then connect a short-lived setup API key.
5
+ This is a native Python installer: it has no runtime dependencies and does not
6
+ download or invoke Node, npm, a JavaScript runtime, or your application code.
7
+ Python 3.10 or newer is required.
8
+
9
+ Ask your coding agent:
10
+
11
+ > Install Kawl Now in this website using https://www.kawlnow.com/install.
12
+ > Finish the local integration and checks first, then ask me for my setup API key.
13
+
14
+ Run a pinned, isolated installer with [uv](https://docs.astral.sh/uv/guides/tools/):
15
+
16
+ ```sh
17
+ uvx --from kawlnow==0.1.0 kawlnow init --channel support --write --json
18
+ ```
19
+
20
+ For an explicit shared template:
21
+
22
+ ```sh
23
+ uvx --from kawlnow==0.1.0 kawlnow init --channel support --target templates/base.html --write --json
24
+ ```
25
+
26
+ Use `--channel sales` for Sales. Without `--write`, `init` only prints a local
27
+ plan; it never reads a key, makes a network request or changes a file.
28
+ Auto-detection accepts one unambiguous existing shared HTML shell. If several
29
+ candidate shells exist, select the intended file with `--target`.
30
+ It preserves the existing template, scripts, template expressions and line
31
+ endings. The inactive marker does not load the widget. Review template conditions
32
+ and inheritance with your coding agent; a source-file check cannot prove which
33
+ pages actually render that template.
34
+
35
+ For a reusable isolated tool, `pipx install kawlnow==0.1.0` exposes the same
36
+ `kawlnow` command. In an existing virtual environment, use
37
+ `python -m pip install kawlnow==0.1.0`, then `python -m kawlnow`.
38
+ Use the npm installer for React and Next.js applications; this distribution
39
+ does not pretend to install React dependencies or wire JSX layouts.
40
+
41
+ Check the prepared integration without account access:
42
+
43
+ ```sh
44
+ uvx --from kawlnow==0.1.0 kawlnow doctor --channel support --site-origin https://YOUR_VERIFIED_DOMAIN --json
45
+ ```
46
+
47
+ `doctor` (also named `status`) checks the saved public plan, owned marker, file
48
+ hash and shared shell. The shared `kawlnow-install` protocol version 1 exposes
49
+ `readiness.keyInputAllowed`: it is true only for unchanged local preparation
50
+ and an explicitly supplied production origin. A missing origin reports
51
+ `awaiting_site_origin`; a missing plan reports `not_prepared`.
52
+ Its structured `nextActions` and `resume.argv` explain
53
+ the next step. Exit **0** means a local dry run, a ready local doctor check or a connected local integration;
54
+ exit **2** means input or a later acceptance step is still required; exit **1**
55
+ means a conflict or error. None of those states establishes voice acceptance.
56
+
57
+ After local preparation, create a **setup key** in Kawl Now's Installation panel
58
+ for the selected brand and Support/Sales agent. It expires after 24 hours.
59
+ No workspace ID or browser OAuth session is needed to begin. Connect using the
60
+ same pinned installer version that created the plan:
61
+
62
+ ```sh
63
+ uvx --from kawlnow==0.1.0 kawlnow connect --channel support --site-origin https://YOUR_VERIFIED_DOMAIN --write
64
+ ```
65
+
66
+ The interactive command reads a hidden terminal prompt. A coding agent or CI
67
+ runner can instead supply one secret line through `--api-key-stdin` or the
68
+ `KAWLNOW_SETUP_KEY` variable using its ephemeral secret facility. `--json`
69
+ never prompts. Never paste a key into a command argument, inline environment
70
+ assignment, source file, chat prompt, public plan or log. Keys are used in memory
71
+ and are not persisted. A full-management token is rejected.
72
+
73
+ The production origin is explicit: metadata inside your repository cannot
74
+ authorize a new origin or choose a credential destination. Connection verifies
75
+ the selected brand and channel, merges only the supplied origin and preserves
76
+ existing origins. `--expect-workspace PUBLIC_BRAND_ID` can bind public brand
77
+ context copied from the dashboard. The default key destination is
78
+ `https://app.kawlnow.com`; a custom public HTTPS endpoint must be explicitly
79
+ trusted with `--app-origin` on every connection. Redirects are refused.
80
+
81
+ The public `kawlnow.python.install.support.json` (or Sales equivalent) records
82
+ only public integration context. It is deliberately separate from npm plans.
83
+ The installer refuses changed files, symbolic links, unsupported paths and
84
+ existing integrations requiring review. Repeated preparation is idempotent.
85
+
86
+ The installer does not publish your website, approve knowledge, enable customer
87
+ calls, change billing or destinations, start conversations or test a microphone.
88
+ After an authorized website deployment, inspect the real widget and use the
89
+ Installation panel's bounded verifier. The verifier is static; browser behavior,
90
+ voice acceptance and owner call enablement remain separate checks.
91
+
92
+ Public guides: [installation and starters](https://www.kawlnow.com/install),
93
+ [complete setup reference](https://app.kawlnow.com/setup-guide),
94
+ [browser-local widget checker](https://www.kawlnow.com/tools/widget-checker).
@@ -0,0 +1,32 @@
1
+ [build-system]
2
+ requires = ["setuptools==84.2.1"]
3
+ build-backend = "setuptools.build_meta"
4
+
5
+ [project]
6
+ name = "kawlnow"
7
+ version = "0.1.0"
8
+ description = "Install Kawl Now in HTML, Flask and Django websites before connecting a setup key."
9
+ readme = "README.md"
10
+ requires-python = ">=3.10"
11
+ authors = [{name = "Kawl Now"}]
12
+ dependencies = []
13
+ keywords = ["kawlnow", "voice", "support", "sales", "installer", "agent", "flask", "django"]
14
+ classifiers = [
15
+ "Environment :: Console",
16
+ "Programming Language :: Python :: 3",
17
+ "Programming Language :: Python :: 3 :: Only",
18
+ "Topic :: Software Development :: Build Tools",
19
+ ]
20
+
21
+ [project.scripts]
22
+ kawlnow = "kawlnow.cli:main"
23
+
24
+ [project.urls]
25
+ Homepage = "https://www.kawlnow.com/install"
26
+ Documentation = "https://app.kawlnow.com/agent-setup.md"
27
+ Source = "https://pypi.org/project/kawlnow/0.1.0/#files"
28
+ Support = "https://www.kawlnow.com/install"
29
+
30
+ [tool.setuptools.packages.find]
31
+ where = ["src"]
32
+ include = ["kawlnow"]
@@ -0,0 +1,4 @@
1
+ [egg_info]
2
+ tag_build =
3
+ tag_date = 0
4
+
@@ -0,0 +1,3 @@
1
+ """Kawl Now's dependency-free Python website installer."""
2
+
3
+ __version__ = "0.1.0"
@@ -0,0 +1,3 @@
1
+ from .cli import main
2
+
3
+ raise SystemExit(main())