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.
- kawlnow-0.1.0/MANIFEST.in +4 -0
- kawlnow-0.1.0/PKG-INFO +111 -0
- kawlnow-0.1.0/README.md +94 -0
- kawlnow-0.1.0/pyproject.toml +32 -0
- kawlnow-0.1.0/setup.cfg +4 -0
- kawlnow-0.1.0/src/kawlnow/__init__.py +3 -0
- kawlnow-0.1.0/src/kawlnow/__main__.py +3 -0
- kawlnow-0.1.0/src/kawlnow/cli.py +927 -0
- kawlnow-0.1.0/src/kawlnow.egg-info/PKG-INFO +111 -0
- kawlnow-0.1.0/src/kawlnow.egg-info/SOURCES.txt +11 -0
- kawlnow-0.1.0/src/kawlnow.egg-info/dependency_links.txt +1 -0
- kawlnow-0.1.0/src/kawlnow.egg-info/entry_points.txt +2 -0
- kawlnow-0.1.0/src/kawlnow.egg-info/top_level.txt +1 -0
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).
|
kawlnow-0.1.0/README.md
ADDED
|
@@ -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"]
|
kawlnow-0.1.0/setup.cfg
ADDED