@astrale-os/adapter-cloudflare 0.1.5 → 0.1.6
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.
- package/dist/astrale.d.ts +3 -3
- package/dist/astrale.d.ts.map +1 -1
- package/dist/astrale.js +18 -6
- package/dist/astrale.js.map +1 -1
- package/dist/cloudflare.d.ts.map +1 -1
- package/dist/cloudflare.js +12 -2
- package/dist/cloudflare.js.map +1 -1
- package/dist/params.d.ts +18 -0
- package/dist/params.d.ts.map +1 -1
- package/dist/wrangler-cli.d.ts +2 -0
- package/dist/wrangler-cli.d.ts.map +1 -1
- package/dist/wrangler-cli.js +19 -3
- package/dist/wrangler-cli.js.map +1 -1
- package/package.json +2 -2
- package/src/astrale.ts +19 -6
- package/src/cloudflare.ts +13 -2
- package/src/params.ts +18 -0
- package/src/wrangler-cli.ts +24 -3
- package/template/.agents/skills/astrale-cli/SKILL.md +408 -0
- package/template/.agents/skills/astrale-domain/SKILL.md +2 -0
- package/template/package.json +3 -3
package/dist/astrale.d.ts
CHANGED
|
@@ -17,9 +17,9 @@
|
|
|
17
17
|
* localhost) — managed deploys change WHERE the worker runs, not how you
|
|
18
18
|
* iterate locally.
|
|
19
19
|
*
|
|
20
|
-
*
|
|
21
|
-
*
|
|
22
|
-
*
|
|
20
|
+
* Managed deploys ship the client SPA (served under `/ui` by the box) and
|
|
21
|
+
* runtime secrets (dotenv map on the install call, encrypted at rest
|
|
22
|
+
* platform-side; platform-managed env keys always win precedence).
|
|
23
23
|
*/
|
|
24
24
|
import type { DomainAdapter } from '@astrale-os/devkit';
|
|
25
25
|
import type { AstraleParams } from './params';
|
package/dist/astrale.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"astrale.d.ts","sourceRoot":"","sources":["../src/astrale.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAQvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAY7C,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,GAAG,aAAa,CAAC,aAAa,CAAC,
|
|
1
|
+
{"version":3,"file":"astrale.d.ts","sourceRoot":"","sources":["../src/astrale.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAQvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAY7C,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,GAAG,aAAa,CAAC,aAAa,CAAC,CAmIzF"}
|
package/dist/astrale.js
CHANGED
|
@@ -17,9 +17,9 @@
|
|
|
17
17
|
* localhost) — managed deploys change WHERE the worker runs, not how you
|
|
18
18
|
* iterate locally.
|
|
19
19
|
*
|
|
20
|
-
*
|
|
21
|
-
*
|
|
22
|
-
*
|
|
20
|
+
* Managed deploys ship the client SPA (served under `/ui` by the box) and
|
|
21
|
+
* runtime secrets (dotenv map on the install call, encrypted at rest
|
|
22
|
+
* platform-side; platform-managed env keys always win precedence).
|
|
23
23
|
*/
|
|
24
24
|
import { defineAdapter, loadDotenvFile } from '@astrale-os/devkit';
|
|
25
25
|
import { spawn } from 'node:child_process';
|
|
@@ -41,16 +41,21 @@ export function astrale(envs) {
|
|
|
41
41
|
// Local dev is unchanged: wrangler dev on localhost. Managed deploys change
|
|
42
42
|
// WHERE the worker ships, not the inner loop.
|
|
43
43
|
async watch(params, ctx) {
|
|
44
|
-
const { configPath } = await prepare({
|
|
44
|
+
const { configPath } = await prepare({
|
|
45
|
+
...(params.vars ? { vars: params.vars } : {}),
|
|
46
|
+
...(params.host ? { host: params.host } : {}),
|
|
47
|
+
port: params.port ?? DEFAULT_PORT,
|
|
48
|
+
}, ctx, 'dev');
|
|
45
49
|
const handle = await runWranglerDev({
|
|
46
50
|
projectDir: ctx.projectDir,
|
|
47
51
|
configPath,
|
|
48
52
|
port: params.port ?? DEFAULT_PORT,
|
|
49
53
|
remote: false,
|
|
54
|
+
...(params.host ? { ip: '0.0.0.0' } : {}),
|
|
50
55
|
onReload: ctx.onReload,
|
|
51
56
|
onLog: logTo(),
|
|
52
57
|
});
|
|
53
|
-
return { url: handle.url, stop: handle.stop };
|
|
58
|
+
return { url: params.host ?? handle.url, stop: handle.stop };
|
|
54
59
|
},
|
|
55
60
|
async deploy(params, ctx) {
|
|
56
61
|
const log = logTo();
|
|
@@ -129,7 +134,14 @@ export function astrale(envs) {
|
|
|
129
134
|
throw new Error('managed install returned no serviceSlug — cannot derive the service URL');
|
|
130
135
|
}
|
|
131
136
|
const region = params.region ?? DEFAULT_REGION;
|
|
132
|
-
|
|
137
|
+
const url = `https://${installed.serviceSlug}.svc.${region}.astrale.ai`;
|
|
138
|
+
return {
|
|
139
|
+
url,
|
|
140
|
+
// Managed deploys already installed on the instance — override the
|
|
141
|
+
// devkit's default "install on an instance" footer with the truth.
|
|
142
|
+
nextSteps: ` installed on "${params.instance}" — call it:\n` +
|
|
143
|
+
` astrale call "/${ctx.domain.origin}/..." -i ${params.instance}`,
|
|
144
|
+
};
|
|
133
145
|
},
|
|
134
146
|
secretsFile(params) {
|
|
135
147
|
return params.secrets;
|
package/dist/astrale.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"astrale.js","sourceRoot":"","sources":["../src/astrale.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAIH,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAClE,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAC3C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAIhC,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AACtC,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAC7C,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAElE,MAAM,YAAY,GAAG,IAAI,CAAA;AACzB,MAAM,iBAAiB,GAAG,iCAAiC,CAAA;AAC3D,MAAM,cAAc,GAAG,IAAI,CAAA;AAC3B,MAAM,YAAY,GAAG,kBAAkB,CAAA;AAEvC,MAAM,UAAU,OAAO,CAAC,IAAmC;IACzD,OAAO,aAAa,CAAgB;QAClC,IAAI,EAAE,SAAS;QACf,IAAI;QAEJ,4EAA4E;QAC5E,8CAA8C;QAC9C,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG;YACrB,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,OAAO,CAClC,
|
|
1
|
+
{"version":3,"file":"astrale.js","sourceRoot":"","sources":["../src/astrale.ts"],"names":[],"mappings":"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"}
|
package/dist/cloudflare.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"cloudflare.d.ts","sourceRoot":"","sources":["../src/cloudflare.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAM5E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAA;AAUhD,wBAAgB,UAAU,CACxB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,GACrC,aAAa,CAAC,gBAAgB,CAAC,
|
|
1
|
+
{"version":3,"file":"cloudflare.d.ts","sourceRoot":"","sources":["../src/cloudflare.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAM5E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAA;AAUhD,wBAAgB,UAAU,CACxB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,GACrC,aAAa,CAAC,gBAAgB,CAAC,CAyDjC;AAID,wBAAsB,OAAO,CAC3B,MAAM,EAAE,gBAAgB,EACxB,GAAG,EAAE,QAAQ,GAAG,SAAS,EACzB,IAAI,EAAE,KAAK,GAAG,QAAQ,GACrB,OAAO,CAAC;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,CAkFhG;AAoCD,wBAAgB,UAAU,CAAC,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAsB3E;AAED,wBAAgB,KAAK,IAAI,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAE9C"}
|
package/dist/cloudflare.js
CHANGED
|
@@ -30,10 +30,13 @@ export function cloudflare(envs) {
|
|
|
30
30
|
configPath,
|
|
31
31
|
port,
|
|
32
32
|
remote: Boolean(params.remote),
|
|
33
|
+
...(params.host ? { ip: '0.0.0.0' } : {}),
|
|
33
34
|
onReload: ctx.onReload,
|
|
34
35
|
onLog: logTo(),
|
|
35
36
|
});
|
|
36
|
-
|
|
37
|
+
// With --host the actionable URL is the PUBLIC one (the tunnel/proxy
|
|
38
|
+
// front), not the local bind — print and spec-stamp that.
|
|
39
|
+
return { url: params.host ?? handle.url, stop: handle.stop };
|
|
37
40
|
},
|
|
38
41
|
async deploy(params, ctx) {
|
|
39
42
|
const { configPath, fallbackConfigPath, workerName: name, } = await prepare(params, ctx, 'deploy');
|
|
@@ -94,7 +97,14 @@ export async function prepare(params, ctx, mode) {
|
|
|
94
97
|
// hostnames. Dev + workers.dev-only deploys are single-host, so the worker
|
|
95
98
|
// falls back to the per-request Host (always the canonical URL there).
|
|
96
99
|
// An explicit `vars.WORKER_URL` (e.g. a tunnel/proxy front) wins.
|
|
97
|
-
|
|
100
|
+
// Dev behind a tunnel/proxy (`--host`) pins WORKER_URL the same way a routed
|
|
101
|
+
// deploy does — the per-request Host there is the proxy's INTERNAL hostname
|
|
102
|
+
// and would corrupt the worker's `iss`.
|
|
103
|
+
const workerUrl = mode === 'deploy' && params.route
|
|
104
|
+
? `https://${params.route}`
|
|
105
|
+
: mode === 'dev' && params.host
|
|
106
|
+
? params.host
|
|
107
|
+
: undefined;
|
|
98
108
|
// Dev injects secrets as local vars (the gitignored .astrale config never
|
|
99
109
|
// ships); deploy keeps secrets out of the config and pushes them encrypted.
|
|
100
110
|
const vars = {
|
package/dist/cloudflare.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"cloudflare.js","sourceRoot":"","sources":["../src/cloudflare.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AACjE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAIhC,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AACnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAA;AACtD,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAA;AAC3D,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAElF,MAAM,YAAY,GAAG,IAAI,CAAA;AAEzB,MAAM,UAAU,UAAU,CACxB,IAAsC;IAEtC,OAAO,aAAa,CAAmB;QACrC,IAAI,EAAE,YAAY;QAClB,IAAI;QAEJ,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG;YACrB,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,GAAG,MAAM,OAAO,CAAC,MAAM,EAAE,GAAG,EAAE,KAAK,CAAC,CAAA;YAC9D,IAAI,GAAG,CAAC,SAAS;gBAAE,MAAM,WAAW,CAAC,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,UAAU,EAAE,KAAK,EAAE,CAAC,CAAA;YAC5E,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC;gBAClC,UAAU,EAAE,GAAG,CAAC,UAAU;gBAC1B,UAAU;gBACV,IAAI;gBACJ,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC;gBAC9B,QAAQ,EAAE,GAAG,CAAC,QAAQ;gBACtB,KAAK,EAAE,KAAK,EAAE;aACf,CAAC,CAAA;YACF,OAAO,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAA;
|
|
1
|
+
{"version":3,"file":"cloudflare.js","sourceRoot":"","sources":["../src/cloudflare.ts"],"names":[],"mappings":"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"}
|
package/dist/params.d.ts
CHANGED
|
@@ -21,6 +21,15 @@ export interface CloudflareParams {
|
|
|
21
21
|
secrets?: string;
|
|
22
22
|
/** Local dev port for `wrangler dev`. Default 8787. */
|
|
23
23
|
port?: number;
|
|
24
|
+
/**
|
|
25
|
+
* Public URL the dev server is reached through (tunnel / sandbox preview /
|
|
26
|
+
* reverse proxy), e.g. `'https://my-box.preview.dev'`. Sets BOTH effects an
|
|
27
|
+
* off-localhost dev needs: wrangler binds 0.0.0.0 (reachable from outside)
|
|
28
|
+
* and `WORKER_URL` is pinned to this URL so the worker's per-request-Host
|
|
29
|
+
* identity (`iss`) doesn't drift to the proxy's internal hostname.
|
|
30
|
+
* Usually injected by `pnpm dev --host <url>` rather than written here.
|
|
31
|
+
*/
|
|
32
|
+
host?: string;
|
|
24
33
|
/** Override the Worker name. Default: derived from the domain origin. */
|
|
25
34
|
workerName?: string;
|
|
26
35
|
/** Run `wrangler dev --remote` (edge isolate) instead of local workerd. */
|
|
@@ -67,6 +76,15 @@ export interface AstraleParams {
|
|
|
67
76
|
secrets?: string;
|
|
68
77
|
/** Local dev port for `wrangler dev`. Default 8787. */
|
|
69
78
|
port?: number;
|
|
79
|
+
/**
|
|
80
|
+
* Public URL the dev server is reached through (tunnel / sandbox preview /
|
|
81
|
+
* reverse proxy), e.g. `'https://my-box.preview.dev'`. Sets BOTH effects an
|
|
82
|
+
* off-localhost dev needs: wrangler binds 0.0.0.0 (reachable from outside)
|
|
83
|
+
* and `WORKER_URL` is pinned to this URL so the worker's per-request-Host
|
|
84
|
+
* identity (`iss`) doesn't drift to the proxy's internal hostname.
|
|
85
|
+
* Usually injected by `pnpm dev --host <url>` rather than written here.
|
|
86
|
+
*/
|
|
87
|
+
host?: string;
|
|
70
88
|
/** Extra plain vars for local `watch`. */
|
|
71
89
|
vars?: Record<string, string>;
|
|
72
90
|
}
|
package/dist/params.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"params.d.ts","sourceRoot":"","sources":["../src/params.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,6EAA6E;IAC7E,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,uDAAuD;IACvD,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,yEAAyE;IACzE,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,2EAA2E;IAC3E,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,8DAA8D;IAC9D,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC7B;;;;;;;;;;;;;;;;;OAiBG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACnC;AAED,gEAAgE;AAChE,MAAM,WAAW,aAAa;IAC5B;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,mEAAmE;IACnE,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,gEAAgE;IAChE,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,uFAAuF;IACvF,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,wNAAwN;IACxN,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,uDAAuD;IACvD,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,0CAA0C;IAC1C,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC9B"}
|
|
1
|
+
{"version":3,"file":"params.d.ts","sourceRoot":"","sources":["../src/params.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,6EAA6E;IAC7E,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,uDAAuD;IACvD,IAAI,CAAC,EAAE,MAAM,CAAA;IACb;;;;;;;OAOG;IACH,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,yEAAyE;IACzE,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,2EAA2E;IAC3E,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,8DAA8D;IAC9D,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC7B;;;;;;;;;;;;;;;;;OAiBG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACnC;AAED,gEAAgE;AAChE,MAAM,WAAW,aAAa;IAC5B;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,mEAAmE;IACnE,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,gEAAgE;IAChE,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,uFAAuF;IACvF,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,wNAAwN;IACxN,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,uDAAuD;IACvD,IAAI,CAAC,EAAE,MAAM,CAAA;IACb;;;;;;;OAOG;IACH,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,0CAA0C;IAC1C,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC9B"}
|
package/dist/wrangler-cli.d.ts
CHANGED
|
@@ -15,6 +15,8 @@ export declare function runWranglerDev(args: {
|
|
|
15
15
|
configPath: string;
|
|
16
16
|
port: number;
|
|
17
17
|
remote: boolean;
|
|
18
|
+
/** Bind address — '0.0.0.0' for tunneled/proxied dev (`--host`). Default loopback. */
|
|
19
|
+
ip?: string;
|
|
18
20
|
onReload: () => void;
|
|
19
21
|
onLog?: (line: string) => void;
|
|
20
22
|
}): Promise<DevHandle>;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"wrangler-cli.d.ts","sourceRoot":"","sources":["../src/wrangler-cli.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAkBH,MAAM,WAAW,SAAS;IACxB,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACtB;AAED,wBAAsB,cAAc,CAAC,IAAI,EAAE;IACzC,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;IAClB,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,OAAO,CAAA;IACf,QAAQ,EAAE,MAAM,IAAI,CAAA;IACpB,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;CAC/B,GAAG,OAAO,CAAC,SAAS,CAAC,
|
|
1
|
+
{"version":3,"file":"wrangler-cli.d.ts","sourceRoot":"","sources":["../src/wrangler-cli.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAkBH,MAAM,WAAW,SAAS;IACxB,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACtB;AAED,wBAAsB,cAAc,CAAC,IAAI,EAAE;IACzC,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;IAClB,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,OAAO,CAAA;IACf,sFAAsF;IACtF,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,QAAQ,EAAE,MAAM,IAAI,CAAA;IACpB,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;CAC/B,GAAG,OAAO,CAAC,SAAS,CAAC,CAqFrB;AAED,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,MAAM,CAAA;IAClB,qFAAqF;IACrF,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,0EAA0E;IAC1E,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;CAC/B;AAED,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,UAAU,GAAG;IAAE,UAAU,EAAE,MAAM,CAAA;CAAE,GACxC,OAAO,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC,CAKvC;AAED;;;;;;;GAOG;AACH,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC,EACtE,IAAI,EAAE,UAAU,GACf,OAAO,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC,CAwBvC;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAO9E;AAED,wBAAsB,cAAc,CAAC,IAAI,EAAE;IACzC,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC/B,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;CAC/B,GAAG,OAAO,CAAC,IAAI,CAAC,CAoBhB;AAyCD;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;CAC/B,GAAG,OAAO,CAAC,MAAM,CAAC,CAalB"}
|
package/dist/wrangler-cli.js
CHANGED
|
@@ -30,7 +30,7 @@ export async function runWranglerDev(args) {
|
|
|
30
30
|
'--local-protocol',
|
|
31
31
|
'http',
|
|
32
32
|
'--ip',
|
|
33
|
-
'127.0.0.1',
|
|
33
|
+
args.ip ?? '127.0.0.1',
|
|
34
34
|
...(args.remote ? ['--remote'] : []),
|
|
35
35
|
];
|
|
36
36
|
const child = spawn(cmd, wranglerArgs, {
|
|
@@ -40,6 +40,10 @@ export async function runWranglerDev(args) {
|
|
|
40
40
|
});
|
|
41
41
|
const fallbackUrl = `http://localhost:${args.port}`;
|
|
42
42
|
let resolved = false;
|
|
43
|
+
// Wrangler's watch mode STAYS ALIVE on a build failure (listener up, worker
|
|
44
|
+
// never answers) — the classic silent hang. Track build errors so the
|
|
45
|
+
// safety net can fail LOUD instead of resolving a dead URL.
|
|
46
|
+
let buildErrorTail = '';
|
|
43
47
|
const url = await new Promise((resolve, reject) => {
|
|
44
48
|
const onData = (buf) => {
|
|
45
49
|
const text = buf.toString();
|
|
@@ -47,6 +51,9 @@ export async function runWranglerDev(args) {
|
|
|
47
51
|
if (line.trim())
|
|
48
52
|
args.onLog?.(line);
|
|
49
53
|
}
|
|
54
|
+
if (/✘ \[ERROR\]|Build failed|Could not resolve "/.test(text)) {
|
|
55
|
+
buildErrorTail = (buildErrorTail + text).slice(-2000);
|
|
56
|
+
}
|
|
50
57
|
if (!resolved) {
|
|
51
58
|
const ready = parseDevReadyUrl(text, args.port);
|
|
52
59
|
if (ready) {
|
|
@@ -73,11 +80,20 @@ export async function runWranglerDev(args) {
|
|
|
73
80
|
}
|
|
74
81
|
});
|
|
75
82
|
// Safety net: if we never matched a URL but the process is alive, assume the
|
|
76
|
-
// conventional localhost URL after a grace period
|
|
83
|
+
// conventional localhost URL after a grace period — UNLESS the build
|
|
84
|
+
// failed, in which case a listener may be up but the worker will never
|
|
85
|
+
// answer: fail loud with the build output instead of handing back a dead
|
|
86
|
+
// URL.
|
|
77
87
|
setTimeout(() => {
|
|
78
88
|
if (!resolved && child.exitCode === null) {
|
|
79
89
|
resolved = true;
|
|
80
|
-
|
|
90
|
+
if (buildErrorTail) {
|
|
91
|
+
void stopChild(child);
|
|
92
|
+
reject(new Error(`worker build failed — the dev server would hang silently.\n${buildErrorTail}`));
|
|
93
|
+
}
|
|
94
|
+
else {
|
|
95
|
+
resolve(fallbackUrl);
|
|
96
|
+
}
|
|
81
97
|
}
|
|
82
98
|
}, 15_000).unref?.();
|
|
83
99
|
});
|
package/dist/wrangler-cli.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"wrangler-cli.js","sourceRoot":"","sources":["../src/wrangler-cli.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAC1C,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AACjD,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AACzD,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AAChC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAEhC,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAEjE,SAAS,eAAe,CAAC,UAAkB;IACzC,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,EAAE,cAAc,EAAE,MAAM,EAAE,UAAU,CAAC,CAAA;IAClE,IAAI,UAAU,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,CAAA;IACxD,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,OAAO,EAAE,UAAU,CAAC,EAAE,CAAA;AACtD,CAAC;AAOD,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,
|
|
1
|
+
{"version":3,"file":"wrangler-cli.js","sourceRoot":"","sources":["../src/wrangler-cli.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@astrale-os/adapter-cloudflare",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.6",
|
|
4
4
|
"description": "Deploy an Astrale domain as a standalone Cloudflare Worker",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"adapter",
|
|
@@ -28,7 +28,7 @@
|
|
|
28
28
|
},
|
|
29
29
|
"dependencies": {
|
|
30
30
|
"jose": "^6.1.3",
|
|
31
|
-
"@astrale-os/devkit": "^0.1.
|
|
31
|
+
"@astrale-os/devkit": "^0.1.5"
|
|
32
32
|
},
|
|
33
33
|
"devDependencies": {
|
|
34
34
|
"@astrale-os/ox": ">=0.1.0 <1.0.0",
|
package/src/astrale.ts
CHANGED
|
@@ -17,9 +17,9 @@
|
|
|
17
17
|
* localhost) — managed deploys change WHERE the worker runs, not how you
|
|
18
18
|
* iterate locally.
|
|
19
19
|
*
|
|
20
|
-
*
|
|
21
|
-
*
|
|
22
|
-
*
|
|
20
|
+
* Managed deploys ship the client SPA (served under `/ui` by the box) and
|
|
21
|
+
* runtime secrets (dotenv map on the install call, encrypted at rest
|
|
22
|
+
* platform-side; platform-managed env keys always win precedence).
|
|
23
23
|
*/
|
|
24
24
|
|
|
25
25
|
import type { DomainAdapter } from '@astrale-os/devkit'
|
|
@@ -51,7 +51,11 @@ export function astrale(envs: Record<string, AstraleParams>): DomainAdapter<Astr
|
|
|
51
51
|
// WHERE the worker ships, not the inner loop.
|
|
52
52
|
async watch(params, ctx) {
|
|
53
53
|
const { configPath } = await prepare(
|
|
54
|
-
{
|
|
54
|
+
{
|
|
55
|
+
...(params.vars ? { vars: params.vars } : {}),
|
|
56
|
+
...(params.host ? { host: params.host } : {}),
|
|
57
|
+
port: params.port ?? DEFAULT_PORT,
|
|
58
|
+
},
|
|
55
59
|
ctx,
|
|
56
60
|
'dev',
|
|
57
61
|
)
|
|
@@ -60,10 +64,11 @@ export function astrale(envs: Record<string, AstraleParams>): DomainAdapter<Astr
|
|
|
60
64
|
configPath,
|
|
61
65
|
port: params.port ?? DEFAULT_PORT,
|
|
62
66
|
remote: false,
|
|
67
|
+
...(params.host ? { ip: '0.0.0.0' } : {}),
|
|
63
68
|
onReload: ctx.onReload,
|
|
64
69
|
onLog: logTo(),
|
|
65
70
|
})
|
|
66
|
-
return { url: handle.url, stop: handle.stop }
|
|
71
|
+
return { url: params.host ?? handle.url, stop: handle.stop }
|
|
67
72
|
},
|
|
68
73
|
|
|
69
74
|
async deploy(params, ctx) {
|
|
@@ -153,7 +158,15 @@ export function astrale(envs: Record<string, AstraleParams>): DomainAdapter<Astr
|
|
|
153
158
|
throw new Error('managed install returned no serviceSlug — cannot derive the service URL')
|
|
154
159
|
}
|
|
155
160
|
const region = params.region ?? DEFAULT_REGION
|
|
156
|
-
|
|
161
|
+
const url = `https://${installed.serviceSlug}.svc.${region}.astrale.ai`
|
|
162
|
+
return {
|
|
163
|
+
url,
|
|
164
|
+
// Managed deploys already installed on the instance — override the
|
|
165
|
+
// devkit's default "install on an instance" footer with the truth.
|
|
166
|
+
nextSteps:
|
|
167
|
+
` installed on "${params.instance}" — call it:\n` +
|
|
168
|
+
` astrale call "/${ctx.domain.origin}/..." -i ${params.instance}`,
|
|
169
|
+
}
|
|
157
170
|
},
|
|
158
171
|
|
|
159
172
|
secretsFile(params) {
|
package/src/cloudflare.ts
CHANGED
|
@@ -40,10 +40,13 @@ export function cloudflare(
|
|
|
40
40
|
configPath,
|
|
41
41
|
port,
|
|
42
42
|
remote: Boolean(params.remote),
|
|
43
|
+
...(params.host ? { ip: '0.0.0.0' } : {}),
|
|
43
44
|
onReload: ctx.onReload,
|
|
44
45
|
onLog: logTo(),
|
|
45
46
|
})
|
|
46
|
-
|
|
47
|
+
// With --host the actionable URL is the PUBLIC one (the tunnel/proxy
|
|
48
|
+
// front), not the local bind — print and spec-stamp that.
|
|
49
|
+
return { url: params.host ?? handle.url, stop: handle.stop }
|
|
47
50
|
},
|
|
48
51
|
|
|
49
52
|
async deploy(params, ctx) {
|
|
@@ -121,7 +124,15 @@ export async function prepare(
|
|
|
121
124
|
// hostnames. Dev + workers.dev-only deploys are single-host, so the worker
|
|
122
125
|
// falls back to the per-request Host (always the canonical URL there).
|
|
123
126
|
// An explicit `vars.WORKER_URL` (e.g. a tunnel/proxy front) wins.
|
|
124
|
-
|
|
127
|
+
// Dev behind a tunnel/proxy (`--host`) pins WORKER_URL the same way a routed
|
|
128
|
+
// deploy does — the per-request Host there is the proxy's INTERNAL hostname
|
|
129
|
+
// and would corrupt the worker's `iss`.
|
|
130
|
+
const workerUrl =
|
|
131
|
+
mode === 'deploy' && params.route
|
|
132
|
+
? `https://${params.route}`
|
|
133
|
+
: mode === 'dev' && params.host
|
|
134
|
+
? params.host
|
|
135
|
+
: undefined
|
|
125
136
|
|
|
126
137
|
// Dev injects secrets as local vars (the gitignored .astrale config never
|
|
127
138
|
// ships); deploy keeps secrets out of the config and pushes them encrypted.
|
package/src/params.ts
CHANGED
|
@@ -21,6 +21,15 @@ export interface CloudflareParams {
|
|
|
21
21
|
secrets?: string
|
|
22
22
|
/** Local dev port for `wrangler dev`. Default 8787. */
|
|
23
23
|
port?: number
|
|
24
|
+
/**
|
|
25
|
+
* Public URL the dev server is reached through (tunnel / sandbox preview /
|
|
26
|
+
* reverse proxy), e.g. `'https://my-box.preview.dev'`. Sets BOTH effects an
|
|
27
|
+
* off-localhost dev needs: wrangler binds 0.0.0.0 (reachable from outside)
|
|
28
|
+
* and `WORKER_URL` is pinned to this URL so the worker's per-request-Host
|
|
29
|
+
* identity (`iss`) doesn't drift to the proxy's internal hostname.
|
|
30
|
+
* Usually injected by `pnpm dev --host <url>` rather than written here.
|
|
31
|
+
*/
|
|
32
|
+
host?: string
|
|
24
33
|
/** Override the Worker name. Default: derived from the domain origin. */
|
|
25
34
|
workerName?: string
|
|
26
35
|
/** Run `wrangler dev --remote` (edge isolate) instead of local workerd. */
|
|
@@ -68,6 +77,15 @@ export interface AstraleParams {
|
|
|
68
77
|
secrets?: string
|
|
69
78
|
/** Local dev port for `wrangler dev`. Default 8787. */
|
|
70
79
|
port?: number
|
|
80
|
+
/**
|
|
81
|
+
* Public URL the dev server is reached through (tunnel / sandbox preview /
|
|
82
|
+
* reverse proxy), e.g. `'https://my-box.preview.dev'`. Sets BOTH effects an
|
|
83
|
+
* off-localhost dev needs: wrangler binds 0.0.0.0 (reachable from outside)
|
|
84
|
+
* and `WORKER_URL` is pinned to this URL so the worker's per-request-Host
|
|
85
|
+
* identity (`iss`) doesn't drift to the proxy's internal hostname.
|
|
86
|
+
* Usually injected by `pnpm dev --host <url>` rather than written here.
|
|
87
|
+
*/
|
|
88
|
+
host?: string
|
|
71
89
|
/** Extra plain vars for local `watch`. */
|
|
72
90
|
vars?: Record<string, string>
|
|
73
91
|
}
|
package/src/wrangler-cli.ts
CHANGED
|
@@ -33,6 +33,8 @@ export async function runWranglerDev(args: {
|
|
|
33
33
|
configPath: string
|
|
34
34
|
port: number
|
|
35
35
|
remote: boolean
|
|
36
|
+
/** Bind address — '0.0.0.0' for tunneled/proxied dev (`--host`). Default loopback. */
|
|
37
|
+
ip?: string
|
|
36
38
|
onReload: () => void
|
|
37
39
|
onLog?: (line: string) => void
|
|
38
40
|
}): Promise<DevHandle> {
|
|
@@ -47,7 +49,7 @@ export async function runWranglerDev(args: {
|
|
|
47
49
|
'--local-protocol',
|
|
48
50
|
'http',
|
|
49
51
|
'--ip',
|
|
50
|
-
'127.0.0.1',
|
|
52
|
+
args.ip ?? '127.0.0.1',
|
|
51
53
|
...(args.remote ? ['--remote'] : []),
|
|
52
54
|
]
|
|
53
55
|
|
|
@@ -59,6 +61,10 @@ export async function runWranglerDev(args: {
|
|
|
59
61
|
|
|
60
62
|
const fallbackUrl = `http://localhost:${args.port}`
|
|
61
63
|
let resolved = false
|
|
64
|
+
// Wrangler's watch mode STAYS ALIVE on a build failure (listener up, worker
|
|
65
|
+
// never answers) — the classic silent hang. Track build errors so the
|
|
66
|
+
// safety net can fail LOUD instead of resolving a dead URL.
|
|
67
|
+
let buildErrorTail = ''
|
|
62
68
|
|
|
63
69
|
const url = await new Promise<string>((resolve, reject) => {
|
|
64
70
|
const onData = (buf: Buffer) => {
|
|
@@ -66,6 +72,9 @@ export async function runWranglerDev(args: {
|
|
|
66
72
|
for (const line of text.split('\n')) {
|
|
67
73
|
if (line.trim()) args.onLog?.(line)
|
|
68
74
|
}
|
|
75
|
+
if (/✘ \[ERROR\]|Build failed|Could not resolve "/.test(text)) {
|
|
76
|
+
buildErrorTail = (buildErrorTail + text).slice(-2000)
|
|
77
|
+
}
|
|
69
78
|
if (!resolved) {
|
|
70
79
|
const ready = parseDevReadyUrl(text, args.port)
|
|
71
80
|
if (ready) {
|
|
@@ -91,11 +100,23 @@ export async function runWranglerDev(args: {
|
|
|
91
100
|
}
|
|
92
101
|
})
|
|
93
102
|
// Safety net: if we never matched a URL but the process is alive, assume the
|
|
94
|
-
// conventional localhost URL after a grace period
|
|
103
|
+
// conventional localhost URL after a grace period — UNLESS the build
|
|
104
|
+
// failed, in which case a listener may be up but the worker will never
|
|
105
|
+
// answer: fail loud with the build output instead of handing back a dead
|
|
106
|
+
// URL.
|
|
95
107
|
setTimeout(() => {
|
|
96
108
|
if (!resolved && child.exitCode === null) {
|
|
97
109
|
resolved = true
|
|
98
|
-
|
|
110
|
+
if (buildErrorTail) {
|
|
111
|
+
void stopChild(child)
|
|
112
|
+
reject(
|
|
113
|
+
new Error(
|
|
114
|
+
`worker build failed — the dev server would hang silently.\n${buildErrorTail}`,
|
|
115
|
+
),
|
|
116
|
+
)
|
|
117
|
+
} else {
|
|
118
|
+
resolve(fallbackUrl)
|
|
119
|
+
}
|
|
99
120
|
}
|
|
100
121
|
}, 15_000).unref?.()
|
|
101
122
|
})
|
|
@@ -0,0 +1,408 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: astrale-cli
|
|
3
|
+
description: Reference for the Astrale CLI (binary `astrale`, package `@astrale-os/astrale`) - CLI setup, command composition, graph exploration and querying, kernel calls, instance bookmarks and admin-provisioned instances, identity management, delegation tokens, browser sessions, output behavior, debugging, and local storage.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Astrale CLI
|
|
7
|
+
|
|
8
|
+
`astrale` is the CLI for connecting to Astrale kernels. It authenticates,
|
|
9
|
+
selects an instance, calls kernel operations, inspects graph nodes, mints
|
|
10
|
+
delegation tokens, and prepares authenticated browser sessions for agents.
|
|
11
|
+
|
|
12
|
+
The command surface lives in the code. Use `astrale --help` and
|
|
13
|
+
`astrale <cmd> --help` as the source of truth for commands, flags, defaults,
|
|
14
|
+
and examples. This skill should only hold cross-cutting model details and
|
|
15
|
+
common recipes that help compose those commands correctly.
|
|
16
|
+
|
|
17
|
+
- Binary: `astrale`
|
|
18
|
+
- npm package: `@astrale-os/astrale`
|
|
19
|
+
- Runtime: Bun
|
|
20
|
+
- Framework: Commander.js
|
|
21
|
+
- Dev entrypoint: `bun cli/bin/astrale.ts <command>`
|
|
22
|
+
|
|
23
|
+
## Command Surface
|
|
24
|
+
|
|
25
|
+
Current top-level commands:
|
|
26
|
+
|
|
27
|
+
```bash
|
|
28
|
+
astrale whoami
|
|
29
|
+
astrale use <name>
|
|
30
|
+
astrale update
|
|
31
|
+
astrale call <path> [params...]
|
|
32
|
+
astrale token
|
|
33
|
+
astrale get <path>
|
|
34
|
+
astrale ls [path]
|
|
35
|
+
astrale describe <path>
|
|
36
|
+
astrale query <cypher>
|
|
37
|
+
astrale status
|
|
38
|
+
astrale browser
|
|
39
|
+
astrale instance ...
|
|
40
|
+
astrale admin ...
|
|
41
|
+
astrale identity ...
|
|
42
|
+
astrale auth ...
|
|
43
|
+
astrale idp ...
|
|
44
|
+
```
|
|
45
|
+
|
|
46
|
+
Command groups:
|
|
47
|
+
|
|
48
|
+
| Group | Commands |
|
|
49
|
+
|---|---|
|
|
50
|
+
| Kernel | `call`, `token`, `get`, `ls`, `describe`, `query` |
|
|
51
|
+
| Context | `status`, `whoami`, `use` |
|
|
52
|
+
| Management | `admin`, `instance`, `identity`, `auth`, `idp`, `update` |
|
|
53
|
+
| Agent | `browser` |
|
|
54
|
+
|
|
55
|
+
Shared kernel options are merged onto kernel-touching commands at registration
|
|
56
|
+
time: `--format`, `--json`, `--raw`, `--url`, `-i/--instance`, `--timeout`,
|
|
57
|
+
`--as`, `--creds`, and `--debug`. Check `astrale <cmd> --help` before relying
|
|
58
|
+
on an option for a specific command.
|
|
59
|
+
|
|
60
|
+
## Path Syntax
|
|
61
|
+
|
|
62
|
+
Clients address graph entities and operations with Paths.
|
|
63
|
+
|
|
64
|
+
| Form | Grammar | Use when |
|
|
65
|
+
|---|---|---|
|
|
66
|
+
| Absolute path | `/domain`, `/domain/class.Name`, `/domain/interface.Name` | Domain, Class namespace, or Interface namespace |
|
|
67
|
+
| Static method | `/:domain:class.Name:method` or `/domain/class.Name/method` | Class-level or interface-level operation |
|
|
68
|
+
| Instance method | `<nodePath>::method` or `@id::method` | Operation on a node instance |
|
|
69
|
+
| Id reference | `@nodeId` | Reference a node by UID |
|
|
70
|
+
| Self reference | `@self` | CLI-side shorthand for the active caller node |
|
|
71
|
+
|
|
72
|
+
Load-bearing rules:
|
|
73
|
+
|
|
74
|
+
- Keep the `class.` or `interface.` prefix in namespace segments:
|
|
75
|
+
`/:host.astrale.ai:class.KernelInstance:list`, not
|
|
76
|
+
`/:host.astrale.ai:KernelInstance:list`.
|
|
77
|
+
- Static methods declared on an Interface are reached through the declaring
|
|
78
|
+
interface namespace, not through a concrete Class namespace.
|
|
79
|
+
- Instance dispatch uses double colon `::`; single colon is for domain-path
|
|
80
|
+
static method syntax.
|
|
81
|
+
- Prefer the domain-path form `/:domain:class.Name:method` for static calls
|
|
82
|
+
when possible. It resolves by domain membership rather than tree layout.
|
|
83
|
+
- `@<id>` takes a graph node UUID only — `@<slug>` is NOT_FOUND. And a
|
|
84
|
+
permission error naming a node that "should exist" often means the node
|
|
85
|
+
does NOT exist (missing targets surface as permission denied, not
|
|
86
|
+
NOT_FOUND) — verify with `astrale get <path>` before chasing grants.
|
|
87
|
+
|
|
88
|
+
Examples:
|
|
89
|
+
|
|
90
|
+
```bash
|
|
91
|
+
astrale call /:blog.acme.com:class.Author:list
|
|
92
|
+
astrale call /:blog.acme.com:interface.NoteOps:createNote title=Hello
|
|
93
|
+
astrale call /blog.acme.com/alice::deactivate
|
|
94
|
+
astrale call @f00d...::deactivate
|
|
95
|
+
```
|
|
96
|
+
|
|
97
|
+
### @self
|
|
98
|
+
|
|
99
|
+
`@self` is a CLI-side literal expanded before a call is signed and sent. It
|
|
100
|
+
resolves to the active identity's registered node id on the target instance.
|
|
101
|
+
The kernel receives the concrete `@<nodeId>` value.
|
|
102
|
+
|
|
103
|
+
Supported positions:
|
|
104
|
+
|
|
105
|
+
- Path head: `@self`, `@self::method`, `@self/child`
|
|
106
|
+
- Param value head: `key=@self`, `key=@self::method`
|
|
107
|
+
|
|
108
|
+
Not expanded:
|
|
109
|
+
|
|
110
|
+
- `--url`
|
|
111
|
+
- `--data`
|
|
112
|
+
- stdin JSON
|
|
113
|
+
- substrings such as `prefix@self`
|
|
114
|
+
- comma lists such as `@self,@other`
|
|
115
|
+
|
|
116
|
+
For JSON payloads, resolve manually before building the payload.
|
|
117
|
+
|
|
118
|
+
```bash
|
|
119
|
+
astrale describe @self
|
|
120
|
+
astrale call @self::deactivate
|
|
121
|
+
astrale call /:d:class.X:m owner=@self
|
|
122
|
+
```
|
|
123
|
+
|
|
124
|
+
If `@self` expands to a deleted or stale id, refresh the registration with
|
|
125
|
+
`astrale identity register <name> -i <instance>`.
|
|
126
|
+
|
|
127
|
+
For IdP-backed identities (`astrale auth login`), `@self` just works: on the
|
|
128
|
+
first use against an instance the CLI does ONE kernel `whoami` round-trip,
|
|
129
|
+
caches the node id as a registration, and expands locally afterwards. If that
|
|
130
|
+
lookup fails (offline, expired session), the error carries the manual recipe:
|
|
131
|
+
|
|
132
|
+
```bash
|
|
133
|
+
astrale call "/:kernel.astrale.ai:interface.Identity:whoami" --json # → { id }
|
|
134
|
+
astrale describe @<that-id>
|
|
135
|
+
```
|
|
136
|
+
|
|
137
|
+
## Instances
|
|
138
|
+
|
|
139
|
+
`astrale instance` manages admin-provisioned instances and local bookmarks.
|
|
140
|
+
|
|
141
|
+
Use:
|
|
142
|
+
|
|
143
|
+
```bash
|
|
144
|
+
astrale instance create my-app
|
|
145
|
+
astrale instance status my-app
|
|
146
|
+
astrale instance use my-app
|
|
147
|
+
astrale instance active
|
|
148
|
+
astrale instance bookmark staging --url https://kernel.example.com
|
|
149
|
+
astrale instance forget staging
|
|
150
|
+
astrale instance install https://domain.example.com
|
|
151
|
+
```
|
|
152
|
+
|
|
153
|
+
Important distinctions:
|
|
154
|
+
|
|
155
|
+
- `instance use` changes the active target instance.
|
|
156
|
+
- `instance active` shows the active target instance.
|
|
157
|
+
- `instance bookmark` records an existing remote kernel URL locally.
|
|
158
|
+
- `instance forget` removes a local bookmark only.
|
|
159
|
+
- `instance delete` is destructive for admin-managed instances.
|
|
160
|
+
- In scripts, prefer explicit `-i <instance>` over relying on ambient active
|
|
161
|
+
instance state.
|
|
162
|
+
|
|
163
|
+
## Domain Dev Workflow
|
|
164
|
+
|
|
165
|
+
**The `astrale` CLI is connect-only — it does not build, run, or deploy
|
|
166
|
+
domains.** There is no `astrale domain …` command group. Domain development
|
|
167
|
+
lives in two separate tools:
|
|
168
|
+
|
|
169
|
+
- **`create-astrale-domain`** scaffolds a new standalone domain project
|
|
170
|
+
(`pnpm create astrale-domain <slug>`), writing an `astrale.config.ts`.
|
|
171
|
+
- **`astrale-domain`** (the `@astrale-os/devkit` bin, behind the project's
|
|
172
|
+
`pnpm dev` / `pnpm prod` scripts) runs `dev | prod | deploy <env> | build`.
|
|
173
|
+
|
|
174
|
+
Domains are **installed by URL**, never from a file: run or deploy the domain
|
|
175
|
+
worker, then `astrale instance install <url> -i <slug>` — the kernel fetches a
|
|
176
|
+
signed install bundle from the running worker. There is no committed
|
|
177
|
+
`spec.json` and no `astrale domain install`; install lives under the
|
|
178
|
+
`instance` group because it operates on an instance graph.
|
|
179
|
+
|
|
180
|
+
With the **managed (`astrale`) adapter**, `pnpm prod` publishes the bundle
|
|
181
|
+
through the platform AND installs it on the configured instance in one step —
|
|
182
|
+
no manual `instance install`. The service serves at
|
|
183
|
+
`https://<name>-<hash>.svc.<region>.astrale.ai` (the CLI session is the auth).
|
|
184
|
+
|
|
185
|
+
For authoring domains end-to-end (schema, handlers, external APIs, deploys),
|
|
186
|
+
load the **astrale-domain** skill; for graph-level schema surgery on a live
|
|
187
|
+
kernel, **astrale-live-domain-edit**.
|
|
188
|
+
|
|
189
|
+
## Auth And Credentials
|
|
190
|
+
|
|
191
|
+
Keep the auth model simple:
|
|
192
|
+
|
|
193
|
+
- `astrale auth login` authenticates with an IdP and stores an IdP-backed local
|
|
194
|
+
identity/session.
|
|
195
|
+
- `astrale identity create <name>` creates a local key-backed identity.
|
|
196
|
+
- `astrale identity register <name> -i <instance>` registers that identity with
|
|
197
|
+
a target instance.
|
|
198
|
+
- `astrale use <name>` switches the active identity or active instance when the
|
|
199
|
+
name is unambiguous. Use `--identity` or `--instance` when it is ambiguous.
|
|
200
|
+
- `--as <identity>` makes a kernel command call as that identity.
|
|
201
|
+
- `--creds <token>` sends an already minted credential and skips normal signing.
|
|
202
|
+
|
|
203
|
+
Useful checks:
|
|
204
|
+
|
|
205
|
+
```bash
|
|
206
|
+
astrale status
|
|
207
|
+
astrale whoami
|
|
208
|
+
astrale auth status
|
|
209
|
+
astrale identity list
|
|
210
|
+
astrale identity whoami
|
|
211
|
+
```
|
|
212
|
+
|
|
213
|
+
`astrale auth token --raw` prints a cached IdP provider token for shell use.
|
|
214
|
+
That is different from `astrale token`, which mints a delegation token for
|
|
215
|
+
kernel/worker calls.
|
|
216
|
+
|
|
217
|
+
## Delegation Tokens
|
|
218
|
+
|
|
219
|
+
`astrale token` mints a delegation token for the active instance and identity.
|
|
220
|
+
Use it when another process, script, or worker needs to call with delegated
|
|
221
|
+
authority.
|
|
222
|
+
|
|
223
|
+
Common flow:
|
|
224
|
+
|
|
225
|
+
```bash
|
|
226
|
+
export TOKEN=$(astrale token --audience dist.astrale.ai --raw)
|
|
227
|
+
astrale call /:dist.astrale.ai:class.Domain:install \
|
|
228
|
+
--url https://dist.astrale.ai \
|
|
229
|
+
--creds "$TOKEN" \
|
|
230
|
+
-d '{"name":"alice"}'
|
|
231
|
+
```
|
|
232
|
+
|
|
233
|
+
Notes:
|
|
234
|
+
|
|
235
|
+
- Default TTL is 3600 seconds.
|
|
236
|
+
- `--audience <aud>` should match the receiving service or worker expectation.
|
|
237
|
+
- `--for <identity>` is an alias for `--as <identity>`.
|
|
238
|
+
- Use `--raw` when assigning the token to an environment variable.
|
|
239
|
+
- Use `--json` when a machine should parse token metadata.
|
|
240
|
+
|
|
241
|
+
## Graph Exploration
|
|
242
|
+
|
|
243
|
+
Use these commands for graph inspection:
|
|
244
|
+
|
|
245
|
+
```bash
|
|
246
|
+
astrale ls /
|
|
247
|
+
astrale get /some/path
|
|
248
|
+
astrale describe /some/path
|
|
249
|
+
astrale query 'MATCH (n) RETURN n LIMIT 5'
|
|
250
|
+
astrale call <path> --describe
|
|
251
|
+
```
|
|
252
|
+
|
|
253
|
+
Gotchas:
|
|
254
|
+
|
|
255
|
+
- `query` is read-only; the kernel rejects write keywords such as `CREATE`,
|
|
256
|
+
`DELETE`, `SET`, `MERGE`, `REMOVE`, and `DETACH`.
|
|
257
|
+
- `describe` can return large properties such as serialized schemas. Pipe to
|
|
258
|
+
`jq` or use command-specific flags when available.
|
|
259
|
+
- `ls` has list-specific output controls such as `-q/--quiet`, `--count`, and
|
|
260
|
+
`-l/--long`; check `astrale ls --help`.
|
|
261
|
+
- For operation schemas, prefer `astrale call <path> --describe` before
|
|
262
|
+
executing a call you are unsure about.
|
|
263
|
+
- **`class.<Name>` materializes as a `Folder` node** (kind `Folder`, name
|
|
264
|
+
prefixed `class.`) whose children are the class's callable Functions. There
|
|
265
|
+
is no `Class` node at that tree position — the Class definition lives inside
|
|
266
|
+
the Domain's serialized `schema` prop. So `--filter Class` returns zero; use
|
|
267
|
+
`--filter Folder`, or descend into `class.<X>` and filter on `Function`.
|
|
268
|
+
|
|
269
|
+
## Output / TTY Behavior
|
|
270
|
+
|
|
271
|
+
Output is selected from stdout shape and flags:
|
|
272
|
+
|
|
273
|
+
- TTY default: human-readable output, usually YAML for objects and tables for
|
|
274
|
+
lists.
|
|
275
|
+
- Pipe, redirect, `--json`, or `--raw`: machine-oriented output.
|
|
276
|
+
- `--json`: always valid JSON for tools like `jq`.
|
|
277
|
+
- `--raw`: unwrap scalars for shell assignment and write raw bytes for binary
|
|
278
|
+
responses.
|
|
279
|
+
- `--format yaml|json`: explicit structured output where supported.
|
|
280
|
+
- `call --output <file>` writes binary/raw output to a file.
|
|
281
|
+
- Piped stdin is read by `astrale call`; stdin on a TTY is ignored.
|
|
282
|
+
- `--data` takes precedence over stdin and `key=value` params.
|
|
283
|
+
- `key=value` values are auto-coerced: `true`/`false`/`null`, numeric strings
|
|
284
|
+
→ numbers, `{…}`/`[…]` → parsed JSON; everything else stays a string. To
|
|
285
|
+
force a digits-only STRING (or pass nested values), use `--data`.
|
|
286
|
+
- **Big payloads go through stdin** — argv caps around 128 KB, so multi-MB
|
|
287
|
+
JSON (e.g. a base64 bundle) must be piped:
|
|
288
|
+
`echo "$PAYLOAD_JSON" | astrale call <path> --json`.
|
|
289
|
+
|
|
290
|
+
Examples:
|
|
291
|
+
|
|
292
|
+
```bash
|
|
293
|
+
astrale ls / --json | jq .
|
|
294
|
+
TOKEN=$(astrale token --audience dist.astrale.ai --raw)
|
|
295
|
+
astrale call /:d:class.Asset:render id=123 --output asset.png
|
|
296
|
+
astrale call /:d:class.X:m -d '{"name":"alice"}'
|
|
297
|
+
```
|
|
298
|
+
|
|
299
|
+
## Driving The GUI
|
|
300
|
+
|
|
301
|
+
Use `astrale browser` to prepare an authenticated GUI browser session that an
|
|
302
|
+
agent can drive with `agent-browser`.
|
|
303
|
+
|
|
304
|
+
Install once:
|
|
305
|
+
|
|
306
|
+
```bash
|
|
307
|
+
npm install -g agent-browser && agent-browser install
|
|
308
|
+
npx skills add vercel-labs/agent-browser
|
|
309
|
+
```
|
|
310
|
+
|
|
311
|
+
Connect and verify:
|
|
312
|
+
|
|
313
|
+
```bash
|
|
314
|
+
astrale browser
|
|
315
|
+
astrale browser --check
|
|
316
|
+
astrale browser --login
|
|
317
|
+
astrale browser --cdp 9222
|
|
318
|
+
```
|
|
319
|
+
|
|
320
|
+
After `astrale browser` connects, it prints the exact `agent-browser --profile`
|
|
321
|
+
command to use. Driving the page is agent-browser's job:
|
|
322
|
+
|
|
323
|
+
```bash
|
|
324
|
+
agent-browser --profile <dir> snapshot
|
|
325
|
+
agent-browser --profile <dir> open <url>
|
|
326
|
+
agent-browser --profile <dir> click @e3
|
|
327
|
+
agent-browser --profile <dir> eval '<js>'
|
|
328
|
+
```
|
|
329
|
+
|
|
330
|
+
The GUI session uses an httpOnly cookie. There is no token-injection shortcut;
|
|
331
|
+
the persistent browser profile is the session boundary.
|
|
332
|
+
|
|
333
|
+
## Debugging And Common Errors
|
|
334
|
+
|
|
335
|
+
Start with local context:
|
|
336
|
+
|
|
337
|
+
```bash
|
|
338
|
+
astrale status
|
|
339
|
+
astrale admin status
|
|
340
|
+
astrale instance active
|
|
341
|
+
astrale auth status
|
|
342
|
+
astrale whoami
|
|
343
|
+
```
|
|
344
|
+
|
|
345
|
+
Use diagnostics:
|
|
346
|
+
|
|
347
|
+
- Add `--debug` to kernel commands for full error diagnostics — including
|
|
348
|
+
the server-side cause chain (`data.cause`), which shows the ROOT failure
|
|
349
|
+
inside wrapped errors (e.g. what actually failed under a
|
|
350
|
+
`Delegation mint failed` or `KERNEL_ERROR`).
|
|
351
|
+
- Use global `--log-level debug` for verbose CLI logging.
|
|
352
|
+
- Use global `--log-format json` when an agent or script should parse logs.
|
|
353
|
+
- Use `--json` or `--raw` for structured command output.
|
|
354
|
+
- Use `--ci` and `--no-prompt` in non-interactive automation.
|
|
355
|
+
- Use `--timeout <ms>` when a kernel call is valid but slow.
|
|
356
|
+
|
|
357
|
+
Common error classes and first checks:
|
|
358
|
+
|
|
359
|
+
| Error shape | First check |
|
|
360
|
+
|---|---|
|
|
361
|
+
| Connection error | `astrale status`; verify the instance URL and network path |
|
|
362
|
+
| Authentication error | `astrale auth status`, `astrale whoami`, active identity |
|
|
363
|
+
| Permission denied | Does the named node actually exist (`astrale get`)? Then active identity and target operation permissions |
|
|
364
|
+
| Not found | Path spelling, active instance, installed domain |
|
|
365
|
+
| Validation error | `astrale call <path> --describe` |
|
|
366
|
+
| Timeout | Target availability and `--timeout <ms>` |
|
|
367
|
+
|
|
368
|
+
If a command fails only in a script, compare TTY vs non-TTY behavior and pass
|
|
369
|
+
explicit `--json`, `--raw`, `-i <instance>`, and `--as <identity>` as needed.
|
|
370
|
+
|
|
371
|
+
## Storage
|
|
372
|
+
|
|
373
|
+
CLI state lives under `ASTRALE_HOME` when set, otherwise `~/.astrale`.
|
|
374
|
+
|
|
375
|
+
Core paths:
|
|
376
|
+
|
|
377
|
+
```text
|
|
378
|
+
~/.astrale/
|
|
379
|
+
config.json CLI and admin config
|
|
380
|
+
install.json Script-install metadata for `astrale update`
|
|
381
|
+
instances.json Active instance and local instance records
|
|
382
|
+
identities.json Active identity and identity metadata
|
|
383
|
+
idps/ IdP provider metadata
|
|
384
|
+
idp-sessions/ Cached IdP sessions
|
|
385
|
+
keys/ Local identity keypairs
|
|
386
|
+
data/ Local data directory used by local adapters
|
|
387
|
+
browser.json Last connected GUI browser session
|
|
388
|
+
browser/<host>/ Persistent browser profile for GUI auth
|
|
389
|
+
```
|
|
390
|
+
|
|
391
|
+
Optional overrides:
|
|
392
|
+
|
|
393
|
+
- `ASTRALE_HOME`: root for CLI state.
|
|
394
|
+
- `ASTRALE_KEYS_DIR`: keypair directory.
|
|
395
|
+
- `ASTRALE_DATA_DIR`: data directory.
|
|
396
|
+
|
|
397
|
+
Keep storage references centralized in this section. Other sections should
|
|
398
|
+
describe behavior, not repeat file locations.
|
|
399
|
+
|
|
400
|
+
## Source Map
|
|
401
|
+
|
|
402
|
+
- Entry: `cli/bin/astrale.ts`
|
|
403
|
+
- Program and help wiring: `cli/src/program.ts`
|
|
404
|
+
- Command registration helpers: `cli/src/registry.ts`, `cli/src/command.ts`
|
|
405
|
+
- Commands: `cli/src/commands/`
|
|
406
|
+
- Shared output, auth, browser, paths, and local helpers: `cli/src/lib/`
|
|
407
|
+
- Kernel command plumbing and error formatting: `cli/src/kernel/`
|
|
408
|
+
- Tests for help and command behavior: `cli/src/commands/__tests__/`
|
|
@@ -23,6 +23,8 @@ npx -y create-astrale-domain@latest my-domain --yes # scaffold
|
|
|
23
23
|
cd my-domain && pnpm install
|
|
24
24
|
pnpm dev # local wrangler dev (prints a URL; install it on an instance to test)
|
|
25
25
|
pnpm dev --port 8899 # when 8787 is taken (orphan wrangler etc.)
|
|
26
|
+
pnpm dev --host https://my-box.preview.dev # dev behind a tunnel/sandbox preview:
|
|
27
|
+
# binds 0.0.0.0 + pins WORKER_URL so iss doesn't drift
|
|
26
28
|
pnpm prod # deploy + (astrale adapter) auto-install on your instance
|
|
27
29
|
```
|
|
28
30
|
|
package/template/package.json
CHANGED
|
@@ -14,11 +14,11 @@
|
|
|
14
14
|
"typecheck": "tsgo --noEmit"
|
|
15
15
|
},
|
|
16
16
|
"dependencies": {
|
|
17
|
-
"@astrale-os/adapter-cloudflare": ">=0.1.
|
|
18
|
-
"@astrale-os/devkit": ">=0.1.
|
|
17
|
+
"@astrale-os/adapter-cloudflare": ">=0.1.6 <1.0.0",
|
|
18
|
+
"@astrale-os/devkit": ">=0.1.5 <1.0.0",
|
|
19
19
|
"@astrale-os/kernel-core": ">=0.4.3 <1.0.0",
|
|
20
20
|
"@astrale-os/kernel-dsl": ">=0.1.2 <1.0.0",
|
|
21
|
-
"@astrale-os/sdk": ">=0.1.
|
|
21
|
+
"@astrale-os/sdk": ">=0.1.4 <1.0.0",
|
|
22
22
|
"@hono/node-server": "^1.19.0",
|
|
23
23
|
"zod": "^4.3.6"
|
|
24
24
|
},
|