@cotal-ai/workspace 0.90.1 → 0.92.0
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/build/Release/win32-arm64/build.json +1 -1
- package/build/Release/win32-x64/build.json +2 -2
- package/build/Release/win32-x64/creation.node +0 -0
- package/dist/agent-secrets.d.ts +2 -2
- package/dist/agent-secrets.d.ts.map +1 -1
- package/dist/agent-secrets.js +2 -2
- package/dist/agent-secrets.js.map +1 -1
- package/dist/auth-paths.d.ts +8 -2
- package/dist/auth-paths.d.ts.map +1 -1
- package/dist/auth-paths.js +12 -5
- package/dist/auth-paths.js.map +1 -1
- package/dist/broker-display.d.ts +4 -0
- package/dist/broker-display.d.ts.map +1 -0
- package/dist/broker-display.js +29 -0
- package/dist/broker-display.js.map +1 -0
- package/dist/colors.d.ts +11 -4
- package/dist/colors.d.ts.map +1 -1
- package/dist/colors.js +36 -9
- package/dist/colors.js.map +1 -1
- package/dist/connect.d.ts +81 -10
- package/dist/connect.d.ts.map +1 -1
- package/dist/connect.js +195 -75
- package/dist/connect.js.map +1 -1
- package/dist/control-target.d.ts +2 -2
- package/dist/control-target.d.ts.map +1 -1
- package/dist/control-target.js +13 -5
- package/dist/control-target.js.map +1 -1
- package/dist/credential-actions.d.ts +91 -0
- package/dist/credential-actions.d.ts.map +1 -0
- package/dist/credential-actions.js +74 -0
- package/dist/credential-actions.js.map +1 -0
- package/dist/deprecated-daemon-entries.d.ts +30 -0
- package/dist/deprecated-daemon-entries.d.ts.map +1 -0
- package/dist/deprecated-daemon-entries.js +37 -0
- package/dist/deprecated-daemon-entries.js.map +1 -0
- package/dist/endpoint-actions.d.ts +31 -0
- package/dist/endpoint-actions.d.ts.map +1 -0
- package/dist/endpoint-actions.js +2 -0
- package/dist/endpoint-actions.js.map +1 -0
- package/dist/endpoint-caller.d.ts +74 -0
- package/dist/endpoint-caller.d.ts.map +1 -0
- package/dist/endpoint-caller.js +118 -0
- package/dist/endpoint-caller.js.map +1 -0
- package/dist/endpoint-contract.d.ts +32 -0
- package/dist/endpoint-contract.d.ts.map +1 -0
- package/dist/endpoint-contract.js +92 -0
- package/dist/endpoint-contract.js.map +1 -0
- package/dist/extension-mutation.d.ts.map +1 -1
- package/dist/extension-mutation.js +4 -1
- package/dist/extension-mutation.js.map +1 -1
- package/dist/extensions.d.ts +28 -8
- package/dist/extensions.d.ts.map +1 -1
- package/dist/extensions.js +20 -8
- package/dist/extensions.js.map +1 -1
- package/dist/flags.d.ts +8 -1
- package/dist/flags.d.ts.map +1 -1
- package/dist/flags.js +9 -7
- package/dist/flags.js.map +1 -1
- package/dist/index.d.ts +25 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +25 -0
- package/dist/index.js.map +1 -1
- package/dist/launch-persona.d.ts +10 -0
- package/dist/launch-persona.d.ts.map +1 -0
- package/dist/launch-persona.js +34 -0
- package/dist/launch-persona.js.map +1 -0
- package/dist/local-process.d.ts +60 -12
- package/dist/local-process.d.ts.map +1 -1
- package/dist/local-process.js +173 -4
- package/dist/local-process.js.map +1 -1
- package/dist/maintenance.d.ts +267 -4
- package/dist/maintenance.d.ts.map +1 -1
- package/dist/maintenance.js +666 -12
- package/dist/maintenance.js.map +1 -1
- package/dist/mesh-manifest-schema.d.ts +118 -0
- package/dist/mesh-manifest-schema.d.ts.map +1 -0
- package/dist/mesh-manifest-schema.js +96 -0
- package/dist/mesh-manifest-schema.js.map +1 -0
- package/dist/mesh-registry.d.ts +30 -0
- package/dist/mesh-registry.d.ts.map +1 -1
- package/dist/mesh-registry.js +74 -13
- package/dist/mesh-registry.js.map +1 -1
- package/dist/mesh-target.d.ts +15 -7
- package/dist/mesh-target.d.ts.map +1 -1
- package/dist/mesh-target.js +77 -26
- package/dist/mesh-target.js.map +1 -1
- package/dist/official-connectors.d.ts +13 -0
- package/dist/official-connectors.d.ts.map +1 -1
- package/dist/official-connectors.js +18 -2
- package/dist/official-connectors.js.map +1 -1
- package/dist/output.d.ts +147 -0
- package/dist/output.d.ts.map +1 -0
- package/dist/output.js +186 -0
- package/dist/output.js.map +1 -0
- package/dist/pid.d.ts +5 -3
- package/dist/pid.d.ts.map +1 -1
- package/dist/pid.js +25 -13
- package/dist/pid.js.map +1 -1
- package/dist/preferences.d.ts +93 -0
- package/dist/preferences.d.ts.map +1 -0
- package/dist/preferences.js +272 -0
- package/dist/preferences.js.map +1 -0
- package/dist/preflight.d.ts +3 -0
- package/dist/preflight.d.ts.map +1 -1
- package/dist/preflight.js +6 -3
- package/dist/preflight.js.map +1 -1
- package/dist/prepared-spaces.d.ts +27 -0
- package/dist/prepared-spaces.d.ts.map +1 -0
- package/dist/prepared-spaces.js +57 -0
- package/dist/prepared-spaces.js.map +1 -0
- package/dist/present.d.ts +108 -0
- package/dist/present.d.ts.map +1 -0
- package/dist/present.js +249 -0
- package/dist/present.js.map +1 -0
- package/dist/prompt-input.d.ts +12 -0
- package/dist/prompt-input.d.ts.map +1 -0
- package/dist/prompt-input.js +35 -0
- package/dist/prompt-input.js.map +1 -0
- package/dist/protected-records.d.ts +102 -0
- package/dist/protected-records.d.ts.map +1 -0
- package/dist/protected-records.js +465 -0
- package/dist/protected-records.js.map +1 -0
- package/dist/registration-policy.d.ts +4 -1
- package/dist/registration-policy.d.ts.map +1 -1
- package/dist/registration-policy.js +4 -3
- package/dist/registration-policy.js.map +1 -1
- package/dist/render.d.ts +8 -0
- package/dist/render.d.ts.map +1 -1
- package/dist/render.js +49 -32
- package/dist/render.js.map +1 -1
- package/dist/renewal-path.d.ts +5 -0
- package/dist/renewal-path.d.ts.map +1 -0
- package/dist/renewal-path.js +9 -0
- package/dist/renewal-path.js.map +1 -0
- package/dist/renewal.d.ts +6 -9
- package/dist/renewal.d.ts.map +1 -1
- package/dist/renewal.js +7 -12
- package/dist/renewal.js.map +1 -1
- package/dist/service-adapter.d.ts +201 -0
- package/dist/service-adapter.d.ts.map +1 -0
- package/dist/service-adapter.js +294 -0
- package/dist/service-adapter.js.map +1 -0
- package/dist/service-custody.d.ts +5 -0
- package/dist/service-custody.d.ts.map +1 -0
- package/dist/service-custody.js +41 -0
- package/dist/service-custody.js.map +1 -0
- package/dist/service-definition.d.ts +52 -0
- package/dist/service-definition.d.ts.map +1 -0
- package/dist/service-definition.js +85 -0
- package/dist/service-definition.js.map +1 -0
- package/dist/service-definition.schema.json +79 -0
- package/dist/service-extension-metadata.d.ts +11 -0
- package/dist/service-extension-metadata.d.ts.map +1 -0
- package/dist/service-extension-metadata.js +66 -0
- package/dist/service-extension-metadata.js.map +1 -0
- package/dist/service-identity.d.ts +51 -0
- package/dist/service-identity.d.ts.map +1 -0
- package/dist/service-identity.js +103 -0
- package/dist/service-identity.js.map +1 -0
- package/dist/service-observation.d.ts +32 -0
- package/dist/service-observation.d.ts.map +1 -0
- package/dist/service-observation.js +134 -0
- package/dist/service-observation.js.map +1 -0
- package/dist/service-preset.d.ts +12 -0
- package/dist/service-preset.d.ts.map +1 -0
- package/dist/service-preset.js +10 -0
- package/dist/service-preset.js.map +1 -0
- package/dist/service-startup.d.ts +23 -0
- package/dist/service-startup.d.ts.map +1 -0
- package/dist/service-startup.js +39 -0
- package/dist/service-startup.js.map +1 -0
- package/dist/service-stop.d.ts +47 -0
- package/dist/service-stop.d.ts.map +1 -0
- package/dist/service-stop.js +152 -0
- package/dist/service-stop.js.map +1 -0
- package/dist/service-target.d.ts +5 -0
- package/dist/service-target.d.ts.map +1 -0
- package/dist/service-target.js +19 -0
- package/dist/service-target.js.map +1 -0
- package/dist/signer-export.d.ts +31 -0
- package/dist/signer-export.d.ts.map +1 -0
- package/dist/signer-export.js +114 -0
- package/dist/signer-export.js.map +1 -0
- package/dist/space-segmentation.d.ts +21 -7
- package/dist/space-segmentation.d.ts.map +1 -1
- package/dist/space-segmentation.js +26 -9
- package/dist/space-segmentation.js.map +1 -1
- package/dist/space.d.ts +5 -5
- package/dist/space.d.ts.map +1 -1
- package/dist/space.js +8 -6
- package/dist/space.js.map +1 -1
- package/dist/system-rotation.d.ts +4 -3
- package/dist/system-rotation.d.ts.map +1 -1
- package/dist/system-rotation.js +16 -6
- package/dist/system-rotation.js.map +1 -1
- package/dist/web-session.d.ts +7 -0
- package/dist/web-session.d.ts.map +1 -1
- package/dist/web-session.js +9 -0
- package/dist/web-session.js.map +1 -1
- package/package.json +6 -2
|
@@ -0,0 +1,272 @@
|
|
|
1
|
+
import { existsSync, mkdirSync, readFileSync } from "node:fs";
|
|
2
|
+
import { join } from "node:path";
|
|
3
|
+
import { acquireLock, globalConfigDir, token, writeSecretFileAtomic } from "@cotal-ai/core";
|
|
4
|
+
import { CommandFailure } from "./output.js";
|
|
5
|
+
import { DEFAULT_CONNECTOR, OFFICIAL_CONNECTORS } from "./official-connectors.js";
|
|
6
|
+
/**
|
|
7
|
+
* Personal workstation preferences: defaults a person sets for their own commands, saved for the
|
|
8
|
+
* user and optionally per space. They never hold credentials, and they change future commands, not
|
|
9
|
+
* running agents. One resolver decides every key, so `cotal config` shows the same winner the command
|
|
10
|
+
* that reads the key uses.
|
|
11
|
+
*/
|
|
12
|
+
export const PREFERENCES_SCHEMA_VERSION = 1;
|
|
13
|
+
const COLOR_VALUES = ["auto", "always", "never"];
|
|
14
|
+
/** A detach key spelled `ctrl-<char>` or `^<char>`: a letter, or one of `@ [ \ ] ^ _`. */
|
|
15
|
+
export function parseDetachKey(spec) {
|
|
16
|
+
const m = /^(?:ctrl-|\^)([a-z@[\\\]^_])$/i.exec(spec.trim());
|
|
17
|
+
if (!m)
|
|
18
|
+
return undefined;
|
|
19
|
+
const ch = m[1].toUpperCase();
|
|
20
|
+
return { byte: ch.charCodeAt(0) & 0x1f, label: `Ctrl-${ch}` };
|
|
21
|
+
}
|
|
22
|
+
const nonEmpty = (value) => (value.trim() ? undefined : "it cannot be empty");
|
|
23
|
+
const fromNonEmpty = (_name, raw) => raw.trim() || undefined;
|
|
24
|
+
const KEYS = [
|
|
25
|
+
{
|
|
26
|
+
key: "harness",
|
|
27
|
+
about: "the agent harness a launch uses when neither a flag nor the persona names one",
|
|
28
|
+
perSpace: true,
|
|
29
|
+
env: ["COTAL_DEFAULT_AGENT"],
|
|
30
|
+
productDefault: DEFAULT_CONNECTOR,
|
|
31
|
+
check: nonEmpty,
|
|
32
|
+
fromEnv: fromNonEmpty,
|
|
33
|
+
},
|
|
34
|
+
{
|
|
35
|
+
key: "persona",
|
|
36
|
+
about: "the persona a launch uses when none is named",
|
|
37
|
+
perSpace: true,
|
|
38
|
+
env: ["COTAL_DEFAULT_PERSONA"],
|
|
39
|
+
productDefault: "default",
|
|
40
|
+
check: nonEmpty,
|
|
41
|
+
fromEnv: fromNonEmpty,
|
|
42
|
+
},
|
|
43
|
+
{
|
|
44
|
+
key: "detach-key",
|
|
45
|
+
about: "the key that detaches from an attached agent",
|
|
46
|
+
perSpace: false,
|
|
47
|
+
env: ["COTAL_DETACH_KEY"],
|
|
48
|
+
productDefault: "ctrl-]",
|
|
49
|
+
check: (value) => (parseDetachKey(value) ? undefined : "use ctrl-<char> or ^<char>, where <char> is a letter or one of @ [ \\ ] ^ _"),
|
|
50
|
+
// A set but unparseable variable is reported where the key is used, so it still wins here.
|
|
51
|
+
fromEnv: (_name, raw) => raw,
|
|
52
|
+
},
|
|
53
|
+
{
|
|
54
|
+
key: "color",
|
|
55
|
+
about: "whether output is colored: auto (on a terminal), always or never",
|
|
56
|
+
perSpace: false,
|
|
57
|
+
// FORCE_COLOR keeps the precedence over NO_COLOR it has always had: `0` or `false` is never and
|
|
58
|
+
// any other value always. NO_COLOR is a no-color preference when it is non-empty (no-color.org).
|
|
59
|
+
env: ["FORCE_COLOR", "NO_COLOR"],
|
|
60
|
+
productDefault: "auto",
|
|
61
|
+
check: (value) => (COLOR_VALUES.includes(value) ? undefined : `use ${COLOR_VALUES.join(", ")}`),
|
|
62
|
+
fromEnv: (name, raw) => (name === "FORCE_COLOR" ? (raw === "0" || raw === "false" ? "never" : "always") : raw ? "never" : undefined),
|
|
63
|
+
},
|
|
64
|
+
{
|
|
65
|
+
key: "editor",
|
|
66
|
+
about: "the editor command `personas edit` opens",
|
|
67
|
+
perSpace: false,
|
|
68
|
+
env: ["VISUAL", "EDITOR"],
|
|
69
|
+
check: nonEmpty,
|
|
70
|
+
fromEnv: fromNonEmpty,
|
|
71
|
+
},
|
|
72
|
+
];
|
|
73
|
+
/** Every preference key, in display order. */
|
|
74
|
+
export const PREFERENCE_KEYS = KEYS.map((k) => k.key);
|
|
75
|
+
function specOf(key) {
|
|
76
|
+
const spec = KEYS.find((k) => k.key === key);
|
|
77
|
+
if (!spec)
|
|
78
|
+
throw new CommandFailure("refused", "USAGE_INVALID", `unknown preference "${key}"; valid keys: ${PREFERENCE_KEYS.join(", ")}`);
|
|
79
|
+
return spec;
|
|
80
|
+
}
|
|
81
|
+
/** What `key` means, whether it may be saved per space, and the variables that supply it. */
|
|
82
|
+
export function preferenceInfo(key) {
|
|
83
|
+
const spec = specOf(key);
|
|
84
|
+
return { key: spec.key, about: spec.about, perSpace: spec.perSpace, env: spec.env, productDefault: spec.productDefault ?? null };
|
|
85
|
+
}
|
|
86
|
+
const EMPTY = { schemaVersion: PREFERENCES_SCHEMA_VERSION, revision: 0, defaults: {}, spaces: {} };
|
|
87
|
+
/** `<globalConfigDir()>/preferences.json`, private to its owner. */
|
|
88
|
+
export function preferencesPath() {
|
|
89
|
+
return join(globalConfigDir(), "preferences.json");
|
|
90
|
+
}
|
|
91
|
+
const invalid = (problem) => new CommandFailure("refused", "SCHEMA_INVALID", `the preferences file ${preferencesPath()} is invalid: ${problem}`, {
|
|
92
|
+
remedy: `fix or remove ${preferencesPath()}; nothing reset it`,
|
|
93
|
+
});
|
|
94
|
+
/** Why a space name cannot hold preferences, or undefined. */
|
|
95
|
+
export function preferenceSpaceProblem(space) {
|
|
96
|
+
return space && token(space) === space ? undefined : `"${space}" is not a space name: use letters, digits, - and _`;
|
|
97
|
+
}
|
|
98
|
+
function checkScope(where, value, perSpaceOnly) {
|
|
99
|
+
if (typeof value !== "object" || value === null || Array.isArray(value))
|
|
100
|
+
throw invalid(`${where} is not an object`);
|
|
101
|
+
for (const [key, v] of Object.entries(value)) {
|
|
102
|
+
const spec = KEYS.find((k) => k.key === key);
|
|
103
|
+
if (!spec)
|
|
104
|
+
throw invalid(`${where} has an unknown key "${key}"`);
|
|
105
|
+
if (perSpaceOnly && !spec.perSpace)
|
|
106
|
+
throw invalid(`${where} sets "${key}", which has no per-space value`);
|
|
107
|
+
if (typeof v !== "string")
|
|
108
|
+
throw invalid(`${where}.${key} is not a string`);
|
|
109
|
+
const problem = spec.check(v);
|
|
110
|
+
if (problem)
|
|
111
|
+
throw invalid(`${where}.${key} ${JSON.stringify(v)}: ${problem}`);
|
|
112
|
+
}
|
|
113
|
+
return value;
|
|
114
|
+
}
|
|
115
|
+
/** Validate a parsed preferences document. Anything unexpected refuses; nothing is dropped. */
|
|
116
|
+
function parsePreferences(text) {
|
|
117
|
+
let doc;
|
|
118
|
+
try {
|
|
119
|
+
doc = JSON.parse(text);
|
|
120
|
+
}
|
|
121
|
+
catch (e) {
|
|
122
|
+
throw invalid(`not JSON (${e.message})`);
|
|
123
|
+
}
|
|
124
|
+
if (typeof doc !== "object" || doc === null || Array.isArray(doc))
|
|
125
|
+
throw invalid("not an object");
|
|
126
|
+
const { schemaVersion, revision, defaults, spaces, ...rest } = doc;
|
|
127
|
+
const extra = Object.keys(rest);
|
|
128
|
+
if (extra.length)
|
|
129
|
+
throw invalid(`unknown field "${extra[0]}"`);
|
|
130
|
+
if (schemaVersion !== PREFERENCES_SCHEMA_VERSION)
|
|
131
|
+
throw invalid(`schemaVersion ${JSON.stringify(schemaVersion)} is not ${PREFERENCES_SCHEMA_VERSION}; this cotal reads version ${PREFERENCES_SCHEMA_VERSION}`);
|
|
132
|
+
if (typeof revision !== "number" || !Number.isSafeInteger(revision) || revision < 1)
|
|
133
|
+
throw invalid("revision is not a positive integer");
|
|
134
|
+
checkScope("defaults", defaults, false);
|
|
135
|
+
if (typeof spaces !== "object" || spaces === null || Array.isArray(spaces))
|
|
136
|
+
throw invalid("spaces is not an object");
|
|
137
|
+
for (const [space, scope] of Object.entries(spaces)) {
|
|
138
|
+
const problem = preferenceSpaceProblem(space);
|
|
139
|
+
if (problem)
|
|
140
|
+
throw invalid(`spaces: ${problem}`);
|
|
141
|
+
checkScope(`spaces.${space}`, scope, true);
|
|
142
|
+
}
|
|
143
|
+
return doc;
|
|
144
|
+
}
|
|
145
|
+
/** The saved preferences. A missing file is no preferences at revision 0; a file that does not
|
|
146
|
+
* validate refuses with `SCHEMA_INVALID`, and is never reset. */
|
|
147
|
+
export function readPreferences() {
|
|
148
|
+
let text;
|
|
149
|
+
try {
|
|
150
|
+
text = readFileSync(preferencesPath(), "utf8");
|
|
151
|
+
}
|
|
152
|
+
catch (e) {
|
|
153
|
+
if (e.code === "ENOENT")
|
|
154
|
+
return EMPTY;
|
|
155
|
+
throw invalid(`it could not be read (${e.message})`);
|
|
156
|
+
}
|
|
157
|
+
return parsePreferences(text);
|
|
158
|
+
}
|
|
159
|
+
/** The last preferences this process read or wrote, by file. */
|
|
160
|
+
let cached;
|
|
161
|
+
/**
|
|
162
|
+
* Set (`value` a string) or clear (`value` undefined) one key in one scope, and report whether the
|
|
163
|
+
* file changed. The write holds the preferences lock, refuses with `CONFLICT` when the file is no
|
|
164
|
+
* longer at `expectedRevision`, and replaces the file atomically, so a concurrent edit is never lost.
|
|
165
|
+
*/
|
|
166
|
+
export function writePreference(scope, key, value, expectedRevision) {
|
|
167
|
+
const spec = specOf(key);
|
|
168
|
+
if (scope.space !== undefined) {
|
|
169
|
+
const problem = preferenceSpaceProblem(scope.space);
|
|
170
|
+
if (problem)
|
|
171
|
+
throw new CommandFailure("refused", "USAGE_INVALID", problem);
|
|
172
|
+
if (!spec.perSpace)
|
|
173
|
+
throw new CommandFailure("refused", "USAGE_INVALID", `${key} has no per-space value; set it for the user`);
|
|
174
|
+
}
|
|
175
|
+
if (value !== undefined) {
|
|
176
|
+
const problem = spec.check(value);
|
|
177
|
+
if (problem)
|
|
178
|
+
throw new CommandFailure("refused", "USAGE_INVALID", `invalid ${key} ${JSON.stringify(value)}: ${problem}`);
|
|
179
|
+
}
|
|
180
|
+
mkdirSync(globalConfigDir(), { recursive: true });
|
|
181
|
+
const lock = acquireLock(`${preferencesPath()}.lock`, { label: "a preferences write", waitMs: 10_000 });
|
|
182
|
+
try {
|
|
183
|
+
const current = readPreferences();
|
|
184
|
+
if (current.revision !== expectedRevision)
|
|
185
|
+
throw new CommandFailure("refused", "CONFLICT", `the preferences changed while this command ran (revision ${expectedRevision} became ${current.revision})`, {
|
|
186
|
+
remedy: "run the command again",
|
|
187
|
+
});
|
|
188
|
+
const defaults = { ...current.defaults };
|
|
189
|
+
const spaces = { ...current.spaces };
|
|
190
|
+
const target = scope.space === undefined ? defaults : { ...spaces[scope.space] };
|
|
191
|
+
if (target[spec.key] === value)
|
|
192
|
+
return { changed: false, revision: current.revision };
|
|
193
|
+
if (value === undefined)
|
|
194
|
+
delete target[spec.key];
|
|
195
|
+
else
|
|
196
|
+
target[spec.key] = value;
|
|
197
|
+
if (scope.space !== undefined) {
|
|
198
|
+
if (Object.keys(target).length)
|
|
199
|
+
spaces[scope.space] = target;
|
|
200
|
+
else
|
|
201
|
+
delete spaces[scope.space];
|
|
202
|
+
}
|
|
203
|
+
const next = { schemaVersion: PREFERENCES_SCHEMA_VERSION, revision: current.revision + 1, defaults, spaces };
|
|
204
|
+
writeSecretFileAtomic(preferencesPath(), `${JSON.stringify(next, null, 2)}\n`);
|
|
205
|
+
cached = { path: preferencesPath(), prefs: next };
|
|
206
|
+
return { changed: true, revision: next.revision };
|
|
207
|
+
}
|
|
208
|
+
finally {
|
|
209
|
+
lock.release();
|
|
210
|
+
}
|
|
211
|
+
}
|
|
212
|
+
/**
|
|
213
|
+
* Decide `key`: an explicit flag, then the persona pin, then the named environment variables, the
|
|
214
|
+
* per-space preference, the user preference and the product default. The first layer that sets the
|
|
215
|
+
* key wins and every later one is reported as shadowed.
|
|
216
|
+
*/
|
|
217
|
+
export function resolvePreference(key, ctx = {}) {
|
|
218
|
+
const spec = specOf(key);
|
|
219
|
+
const env = ctx.env ?? process.env;
|
|
220
|
+
const prefs = ctx.preferences ?? readPreferences();
|
|
221
|
+
const layers = [];
|
|
222
|
+
if (ctx.flag?.value !== undefined)
|
|
223
|
+
layers.push({ source: "flag", name: ctx.flag.name, value: ctx.flag.value });
|
|
224
|
+
if (ctx.pin !== undefined)
|
|
225
|
+
layers.push({ source: "pin", value: ctx.pin });
|
|
226
|
+
for (const name of spec.env) {
|
|
227
|
+
const raw = env[name];
|
|
228
|
+
const value = raw === undefined ? undefined : spec.fromEnv(name, raw);
|
|
229
|
+
if (value !== undefined)
|
|
230
|
+
layers.push({ source: "environment", name, value });
|
|
231
|
+
}
|
|
232
|
+
const spaceValue = ctx.space !== undefined && spec.perSpace ? prefs.spaces[ctx.space]?.[key] : undefined;
|
|
233
|
+
if (spaceValue !== undefined)
|
|
234
|
+
layers.push({ source: "space", name: ctx.space, value: spaceValue });
|
|
235
|
+
const userValue = prefs.defaults[key];
|
|
236
|
+
if (userValue !== undefined)
|
|
237
|
+
layers.push({ source: "user", value: userValue });
|
|
238
|
+
if (spec.productDefault !== undefined)
|
|
239
|
+
layers.push({ source: "default", value: spec.productDefault });
|
|
240
|
+
const [winner, ...shadowed] = layers;
|
|
241
|
+
return { key, value: winner?.value ?? null, winner: winner ?? null, shadowed };
|
|
242
|
+
}
|
|
243
|
+
/** How a layer reads in a sentence: `COTAL_DEFAULT_AGENT`, `your preference for space x`. */
|
|
244
|
+
export function describeLayer(layer) {
|
|
245
|
+
switch (layer.source) {
|
|
246
|
+
case "flag":
|
|
247
|
+
return `--${layer.name}`;
|
|
248
|
+
case "pin":
|
|
249
|
+
return "the persona's pin";
|
|
250
|
+
case "environment":
|
|
251
|
+
return layer.name;
|
|
252
|
+
case "space":
|
|
253
|
+
return `your preference for space ${layer.name}`;
|
|
254
|
+
case "user":
|
|
255
|
+
return "your preference";
|
|
256
|
+
case "default":
|
|
257
|
+
return "the default";
|
|
258
|
+
}
|
|
259
|
+
}
|
|
260
|
+
/** The harnesses this workstation knows: the official connectors and the ones `installed` names. */
|
|
261
|
+
export function knownHarnesses(installed) {
|
|
262
|
+
return [...new Set([...Object.keys(OFFICIAL_CONNECTORS), ...installed])].sort();
|
|
263
|
+
}
|
|
264
|
+
/** The preferences, read once per file in this process and kept current by its own writes, for a
|
|
265
|
+
* reader on every output line (color). It throws as {@link readPreferences} does. */
|
|
266
|
+
export function cachedPreferences() {
|
|
267
|
+
const path = preferencesPath();
|
|
268
|
+
if (cached?.path !== path)
|
|
269
|
+
cached = { path, prefs: existsSync(path) ? readPreferences() : EMPTY };
|
|
270
|
+
return cached.prefs;
|
|
271
|
+
}
|
|
272
|
+
//# sourceMappingURL=preferences.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"preferences.js","sourceRoot":"","sources":["../src/preferences.ts"],"names":[],"mappings":"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"}
|
package/dist/preflight.d.ts
CHANGED
|
@@ -59,5 +59,8 @@ export interface MeshSweep {
|
|
|
59
59
|
/** Spaces kept despite a dead broker. */
|
|
60
60
|
offline: string[];
|
|
61
61
|
}
|
|
62
|
+
/** Whether `server` answers a liveness probe. A first miss is confirmed with a second, longer probe
|
|
63
|
+
* before it counts, so a slow link reads as live. */
|
|
64
|
+
export declare function brokerAnswers(server: string): Promise<boolean>;
|
|
62
65
|
export declare function pruneStaleMeshes(): Promise<MeshSweep>;
|
|
63
66
|
//# sourceMappingURL=preflight.d.ts.map
|
package/dist/preflight.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"preflight.d.ts","sourceRoot":"","sources":["../src/preflight.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD;;;;;;;;;;GAUG;AAEH;;kGAEkG;AAClG,MAAM,MAAM,gBAAgB,GACxB,aAAa,GACb,yBAAyB,GACzB,wBAAwB,GACxB,gBAAgB,GAChB,iBAAiB,GACjB,YAAY;AACd;;;8DAG8D;GAC5D,WAAW;AACb;;;;qDAIqD;GACnD,WAAW,CAAC;AAEhB;;;;;oGAKoG;AACpG,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,UAAU,CAAC,QAAQ,CAAC,EAC5B,MAAM,EAAE,eAAe,GAAG,YAAY,GAAG,aAAa,GAAG,SAAS,EAClE,OAAO,EAAE,OAAO,GACf;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,gBAAgB,CAAA;CAAE,CAqB5C;AAED;;;uFAGuF;AACvF,wBAAsB,eAAe,CACnC,MAAM,EAAE,UAAU,EAClB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,gBAAgB,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC,CA+D/E;AA6ED;;sGAEsG;AACtG,eAAO,MAAM,4BAA4B,OAAQ,CAAC;AAElD;;qEAEqE;AACrE,MAAM,WAAW,SAAS;IACxB,+EAA+E;IAC/E,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,yCAAyC;IACzC,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,SAAS,CAAC,
|
|
1
|
+
{"version":3,"file":"preflight.d.ts","sourceRoot":"","sources":["../src/preflight.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD;;;;;;;;;;GAUG;AAEH;;kGAEkG;AAClG,MAAM,MAAM,gBAAgB,GACxB,aAAa,GACb,yBAAyB,GACzB,wBAAwB,GACxB,gBAAgB,GAChB,iBAAiB,GACjB,YAAY;AACd;;;8DAG8D;GAC5D,WAAW;AACb;;;;qDAIqD;GACnD,WAAW,CAAC;AAEhB;;;;;oGAKoG;AACpG,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,UAAU,CAAC,QAAQ,CAAC,EAC5B,MAAM,EAAE,eAAe,GAAG,YAAY,GAAG,aAAa,GAAG,SAAS,EAClE,OAAO,EAAE,OAAO,GACf;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,gBAAgB,CAAA;CAAE,CAqB5C;AAED;;;uFAGuF;AACvF,wBAAsB,eAAe,CACnC,MAAM,EAAE,UAAU,EAClB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,gBAAgB,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC,CA+D/E;AA6ED;;sGAEsG;AACtG,eAAO,MAAM,4BAA4B,OAAQ,CAAC;AAElD;;qEAEqE;AACrE,MAAM,WAAW,SAAS;IACxB,+EAA+E;IAC/E,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,yCAAyC;IACzC,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;sDACsD;AACtD,wBAAsB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAEpE;AAED,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,SAAS,CAAC,CAe3D"}
|
package/dist/preflight.js
CHANGED
|
@@ -183,6 +183,11 @@ const PRUNE_CONFIRM_TIMEOUT_MS = 5_000;
|
|
|
183
183
|
* because this probe completes an AUTH HANDSHAKE, not just a TCP+INFO liveness check. Exported so
|
|
184
184
|
* {@link renderWorkspaceError}'s `slow-link` sentence can name the real budget instead of a copy. */
|
|
185
185
|
export const PREFLIGHT_CONFIRM_TIMEOUT_MS = 8_000;
|
|
186
|
+
/** Whether `server` answers a liveness probe. A first miss is confirmed with a second, longer probe
|
|
187
|
+
* before it counts, so a slow link reads as live. */
|
|
188
|
+
export async function brokerAnswers(server) {
|
|
189
|
+
return (await isReachable(server)) || (await isReachable(server, { timeoutMs: PRUNE_CONFIRM_TIMEOUT_MS }));
|
|
190
|
+
}
|
|
186
191
|
export async function pruneStaleMeshes() {
|
|
187
192
|
const sweep = { pruned: [], offline: [] };
|
|
188
193
|
await Promise.all(loadMeshes().map(async (m) => {
|
|
@@ -192,9 +197,7 @@ export async function pruneStaleMeshes() {
|
|
|
192
197
|
// selected target is allowed to connect.
|
|
193
198
|
if (m.origin === "catalog")
|
|
194
199
|
return;
|
|
195
|
-
if (await
|
|
196
|
-
return;
|
|
197
|
-
if (await isReachable(m.server, { timeoutMs: PRUNE_CONFIRM_TIMEOUT_MS }))
|
|
200
|
+
if (await brokerAnswers(m.server))
|
|
198
201
|
return;
|
|
199
202
|
// pruneMesh, not removeMesh: a liveness miss keeps the record (manual and up alike).
|
|
200
203
|
(pruneMesh(m.space) ? sweep.pruned : sweep.offline).push(m.space);
|
package/dist/preflight.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"preflight.js","sourceRoot":"","sources":["../src/preflight.ts"],"names":[],"mappings":"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
|
|
1
|
+
{"version":3,"file":"preflight.js","sourceRoot":"","sources":["../src/preflight.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* A local space `cotal space create` prepared and no `cotal up` has started: its name and root.
|
|
3
|
+
*
|
|
4
|
+
* Prepared spaces are kept apart from the mesh registry on purpose. The registry holds spaces a
|
|
5
|
+
* command can connect to, and every reader of it may dial a record's server; a prepared space has
|
|
6
|
+
* no broker yet, so a record there would let a reader, or an older binary that knows nothing of a
|
|
7
|
+
* prepared state, dial the planned address as that space while another broker answers on it.
|
|
8
|
+
*/
|
|
9
|
+
export interface PreparedSpace {
|
|
10
|
+
readonly space: string;
|
|
11
|
+
/** Absolute path whose `.cotal/` the space will use once `cotal up` starts it there. */
|
|
12
|
+
readonly root: string;
|
|
13
|
+
/** ISO timestamp of when it was prepared. */
|
|
14
|
+
readonly ts: string;
|
|
15
|
+
}
|
|
16
|
+
export declare function preparedSpacesDir(): string;
|
|
17
|
+
/** Every prepared space. A file that is not a prepared space record throws naming it, as the
|
|
18
|
+
* registry does, so a damaged record is never read as an absent one. */
|
|
19
|
+
export declare function loadPreparedSpaces(): PreparedSpace[];
|
|
20
|
+
export declare function findPreparedSpace(space: string): PreparedSpace | undefined;
|
|
21
|
+
/** The space prepared at `root`, matched by its canonical path. */
|
|
22
|
+
export declare function preparedSpaceAt(root: string): PreparedSpace | undefined;
|
|
23
|
+
/** Write a prepared space: atomic, 0600, in a directory only this user can list. Returns the file. */
|
|
24
|
+
export declare function recordPreparedSpace(p: PreparedSpace): string;
|
|
25
|
+
/** Drop a prepared space. Absent is a no-op. */
|
|
26
|
+
export declare function removePreparedSpace(space: string): void;
|
|
27
|
+
//# sourceMappingURL=prepared-spaces.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"prepared-spaces.d.ts","sourceRoot":"","sources":["../src/prepared-spaces.ts"],"names":[],"mappings":"AAMA;;;;;;;GAOG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,wFAAwF;IACxF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAID;yEACyE;AACzE,wBAAgB,kBAAkB,IAAI,aAAa,EAAE,CASpD;AAcD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAE1E;AAED,mEAAmE;AACnE,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAGvE;AAED,sGAAsG;AACtG,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,aAAa,GAAG,MAAM,CAO5D;AAED,gDAAgD;AAChD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAEvD"}
|
|
@@ -0,0 +1,57 @@
|
|
|
1
|
+
import { isAbsolute, join } from "node:path";
|
|
2
|
+
import { readFileSync, readdirSync, renameSync, rmSync } from "node:fs";
|
|
3
|
+
import { mkSecretDir, writeSecretFile } from "@cotal-ai/core";
|
|
4
|
+
import { spaceSegment } from "./auth-paths.js";
|
|
5
|
+
import { canonicalRoot, homeCotalDir } from "./mesh-registry.js";
|
|
6
|
+
export function preparedSpacesDir() {
|
|
7
|
+
return join(homeCotalDir(), "prepared");
|
|
8
|
+
}
|
|
9
|
+
const preparedFile = (space) => join(preparedSpacesDir(), `${spaceSegment(space)}.json`);
|
|
10
|
+
/** Every prepared space. A file that is not a prepared space record throws naming it, as the
|
|
11
|
+
* registry does, so a damaged record is never read as an absent one. */
|
|
12
|
+
export function loadPreparedSpaces() {
|
|
13
|
+
let files;
|
|
14
|
+
try {
|
|
15
|
+
files = readdirSync(preparedSpacesDir()).filter((f) => f.endsWith(".json"));
|
|
16
|
+
}
|
|
17
|
+
catch (e) {
|
|
18
|
+
if (e.code === "ENOENT")
|
|
19
|
+
return [];
|
|
20
|
+
throw e;
|
|
21
|
+
}
|
|
22
|
+
return files.sort().map((f) => readPreparedFile(join(preparedSpacesDir(), f)));
|
|
23
|
+
}
|
|
24
|
+
function readPreparedFile(file) {
|
|
25
|
+
let doc;
|
|
26
|
+
try {
|
|
27
|
+
doc = JSON.parse(readFileSync(file, "utf8"));
|
|
28
|
+
}
|
|
29
|
+
catch (e) {
|
|
30
|
+
throw new Error(`${file} does not parse as a prepared space record (${e.message}) - remove it`);
|
|
31
|
+
}
|
|
32
|
+
if (typeof doc.space !== "string" || typeof doc.root !== "string" || !isAbsolute(doc.root) || typeof doc.ts !== "string" || file !== preparedFile(doc.space))
|
|
33
|
+
throw new Error(`${file} is not a usable prepared space record - remove it`);
|
|
34
|
+
return { space: doc.space, root: doc.root, ts: doc.ts };
|
|
35
|
+
}
|
|
36
|
+
export function findPreparedSpace(space) {
|
|
37
|
+
return loadPreparedSpaces().find((p) => p.space === space);
|
|
38
|
+
}
|
|
39
|
+
/** The space prepared at `root`, matched by its canonical path. */
|
|
40
|
+
export function preparedSpaceAt(root) {
|
|
41
|
+
const key = canonicalRoot(root);
|
|
42
|
+
return loadPreparedSpaces().find((p) => canonicalRoot(p.root) === key);
|
|
43
|
+
}
|
|
44
|
+
/** Write a prepared space: atomic, 0600, in a directory only this user can list. Returns the file. */
|
|
45
|
+
export function recordPreparedSpace(p) {
|
|
46
|
+
mkSecretDir(preparedSpacesDir());
|
|
47
|
+
const file = preparedFile(p.space);
|
|
48
|
+
const tmp = `${file}.${process.pid}.tmp`;
|
|
49
|
+
writeSecretFile(tmp, JSON.stringify(p, null, 2));
|
|
50
|
+
renameSync(tmp, file);
|
|
51
|
+
return file;
|
|
52
|
+
}
|
|
53
|
+
/** Drop a prepared space. Absent is a no-op. */
|
|
54
|
+
export function removePreparedSpace(space) {
|
|
55
|
+
rmSync(preparedFile(space), { force: true });
|
|
56
|
+
}
|
|
57
|
+
//# sourceMappingURL=prepared-spaces.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"prepared-spaces.js","sourceRoot":"","sources":["../src/prepared-spaces.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,108 @@
|
|
|
1
|
+
import { CommandFailure, type Completeness, type OutputWarning } from "./output.js";
|
|
2
|
+
/**
|
|
3
|
+
* The terminal presentation every command surface shares: one view model of a finished report,
|
|
4
|
+
* rendered rich (color and marks) or plain (no ANSI, ASCII only), and the same result written as
|
|
5
|
+
* the JSON envelope. A command builds the view from its result, so the three never disagree about
|
|
6
|
+
* what was found. The tokens carry meaning; the renderer picks the color, and the word always stays.
|
|
7
|
+
*/
|
|
8
|
+
/** What a piece of text means. Blue for commands and the selected item, green for proven healthy
|
|
9
|
+
* or done, amber for waiting or partial, red for failed, denied or destructive. Labels and hints are
|
|
10
|
+
* subdued, titles bold. */
|
|
11
|
+
export type Tone = "command" | "selected" | "ok" | "waiting" | "failed" | "label" | "hint" | "title";
|
|
12
|
+
/** Text with a tone. `mark` is a decoration only the rich renderer draws (`●`); the text must name
|
|
13
|
+
* the state on its own, since plain output and a screen without color show only the text. */
|
|
14
|
+
export interface Styled {
|
|
15
|
+
readonly text: string;
|
|
16
|
+
readonly tone?: Tone;
|
|
17
|
+
readonly mark?: string;
|
|
18
|
+
}
|
|
19
|
+
export type Cell = string | Styled;
|
|
20
|
+
export interface Column {
|
|
21
|
+
readonly key: string;
|
|
22
|
+
readonly label: string;
|
|
23
|
+
}
|
|
24
|
+
/** Rows under column labels; a terminal too narrow for them gets one labeled record per row. */
|
|
25
|
+
export interface Table {
|
|
26
|
+
readonly kind: "table";
|
|
27
|
+
readonly columns: readonly Column[];
|
|
28
|
+
readonly header?: boolean;
|
|
29
|
+
readonly rows: readonly Readonly<Record<string, Cell>>[];
|
|
30
|
+
}
|
|
31
|
+
/** Label and value pairs, one per line, values aligned. */
|
|
32
|
+
export interface Fields {
|
|
33
|
+
readonly kind: "fields";
|
|
34
|
+
readonly rows: readonly (readonly [label: string, value: Cell])[];
|
|
35
|
+
}
|
|
36
|
+
/** Free lines, such as hints. */
|
|
37
|
+
export interface Lines {
|
|
38
|
+
readonly kind: "lines";
|
|
39
|
+
readonly lines: readonly Cell[];
|
|
40
|
+
}
|
|
41
|
+
/** Useful actions, with the command distinct from its explanation. */
|
|
42
|
+
export interface Commands {
|
|
43
|
+
readonly kind: "commands";
|
|
44
|
+
readonly items: readonly {
|
|
45
|
+
readonly command: string;
|
|
46
|
+
readonly description: string;
|
|
47
|
+
}[];
|
|
48
|
+
}
|
|
49
|
+
export type Block = Table | Fields | Lines | Commands;
|
|
50
|
+
export interface Section {
|
|
51
|
+
readonly title?: string;
|
|
52
|
+
readonly blocks: readonly Block[];
|
|
53
|
+
}
|
|
54
|
+
/** A finished report: sections in order. Every text in it is treated as untrusted and escaped with
|
|
55
|
+
* {@link oneLine}, so a name or message cannot move the cursor, restyle the screen or end its line. */
|
|
56
|
+
export interface Report {
|
|
57
|
+
/** The resolved mesh, supplied by the operation rather than inferred from ambient selection. */
|
|
58
|
+
readonly space?: string;
|
|
59
|
+
readonly sections: readonly Section[];
|
|
60
|
+
}
|
|
61
|
+
/** `rich` colors when color is on and draws marks; `plain` writes no ANSI and no marks, and draws
|
|
62
|
+
* the report's own punctuation in ASCII. */
|
|
63
|
+
export type Style = "rich" | "plain";
|
|
64
|
+
/** Which presentation a run asked for: `--json`, `--plain`, or neither. */
|
|
65
|
+
export type Presentation = Style | "json";
|
|
66
|
+
/** The columns `text` occupies on a terminal: grapheme clusters, wide East Asian and emoji
|
|
67
|
+
* characters as two, combining marks and zero-width characters as none, ANSI sequences as none. */
|
|
68
|
+
export declare function displayWidth(text: string): number;
|
|
69
|
+
/** `text` in lines of at most `width` display columns, broken at spaces, or only between the given
|
|
70
|
+
* words. A word wider than `width` keeps a line of its own, so an identity, path or command is never
|
|
71
|
+
* split. Below 20 columns, and when the output is not a terminal, nothing is wrapped. */
|
|
72
|
+
export declare function wrapWords(text: string | readonly string[], width: number): string[];
|
|
73
|
+
/** A report as lines of text, fitted to `width` columns (unbounded when output is not a terminal):
|
|
74
|
+
* tables fit or become records, and long values and lines wrap at spaces. */
|
|
75
|
+
export declare function renderReport(report: Report, style: Style, width?: number): string;
|
|
76
|
+
/** The columns a stream can show: its terminal's width, or unbounded when it is not a terminal. */
|
|
77
|
+
export declare function terminalWidth(stream: {
|
|
78
|
+
readonly isTTY?: boolean;
|
|
79
|
+
readonly columns?: number;
|
|
80
|
+
}): number;
|
|
81
|
+
/** The presentation `--json` and `--plain` ask for. Both at once is a usage error. */
|
|
82
|
+
export declare function presentationOf(values: {
|
|
83
|
+
readonly json?: unknown;
|
|
84
|
+
readonly plain?: unknown;
|
|
85
|
+
}): Presentation;
|
|
86
|
+
/** One finished result in the presentation the run asked for: the envelope for `json`, otherwise the
|
|
87
|
+
* report `view` builds from the same result, fitted to the terminal stdout is, with each warning on
|
|
88
|
+
* stderr. `partial` marks a read that answered for only part of what was asked: the result keeps
|
|
89
|
+
* what was read, the outcome is `partial`, and the run exits 4. `noOp` marks a change that was
|
|
90
|
+
* already in place: the outcome is `no-op` and the run exits 0. `failure` retains an attributed
|
|
91
|
+
* multi-member result alongside its classified error. A failure without useful result data is
|
|
92
|
+
* thrown as a {@link CommandFailure} for the kernel to write. */
|
|
93
|
+
export declare function writeResult<R>(presentation: Presentation, out: {
|
|
94
|
+
command: string;
|
|
95
|
+
target: unknown;
|
|
96
|
+
result: R;
|
|
97
|
+
completeness?: Completeness;
|
|
98
|
+
warnings?: readonly OutputWarning[];
|
|
99
|
+
partial?: {
|
|
100
|
+
message: string;
|
|
101
|
+
remedy?: string;
|
|
102
|
+
};
|
|
103
|
+
noOp?: boolean;
|
|
104
|
+
failure?: CommandFailure;
|
|
105
|
+
}, view: (result: R) => Report): void;
|
|
106
|
+
/** A failure report exposes only attributed target/receipt fields, never arbitrary input objects. */
|
|
107
|
+
export declare function commandFailureReport(failure: CommandFailure): Report;
|
|
108
|
+
//# sourceMappingURL=present.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"present.d.ts","sourceRoot":"","sources":["../src/present.ts"],"names":[],"mappings":"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"}
|