owenloop 0.5.0 → 0.5.1
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/CHANGELOG.md +45 -0
- package/README.md +137 -35
- package/bin/owenloop.mjs +49 -1
- package/dist/packages/work/src/agent/brief.d.ts +8 -4
- package/dist/packages/work/src/agent/brief.js +7 -3
- package/dist/packages/work/src/agent/loop.d.ts +13 -7
- package/dist/packages/work/src/agent/loop.js +136 -9
- package/dist/packages/work/src/agent/model-policy.d.ts +49 -0
- package/dist/packages/work/src/agent/model-policy.js +138 -0
- package/dist/packages/work/src/bundle/cache.d.ts +7 -5
- package/dist/packages/work/src/bundle/cache.js +20 -6
- package/dist/packages/work/src/bundle/fetch.d.ts +7 -5
- package/dist/packages/work/src/bundle/fetch.js +27 -7
- package/dist/packages/work/src/bundle/types.d.ts +8 -4
- package/dist/packages/work/src/consumed-verifier.d.ts +45 -0
- package/dist/packages/work/src/consumed-verifier.js +205 -0
- package/dist/packages/work/src/exec/instructions.d.ts +99 -0
- package/dist/packages/work/src/exec/instructions.js +323 -0
- package/dist/packages/work/src/exec/loop.d.ts +12 -1
- package/dist/packages/work/src/exec/loop.js +137 -20
- package/dist/packages/work/src/exec/payload.d.ts +29 -0
- package/dist/packages/work/src/exec/payload.js +54 -0
- package/dist/packages/work/src/exec/receipt.d.ts +9 -6
- package/dist/packages/work/src/exec/receipt.js +12 -1
- package/dist/packages/work/src/exec/runner.d.ts +7 -1
- package/dist/packages/work/src/exec/runner.js +74 -3
- package/dist/packages/work/src/harness/child-env.js +7 -0
- package/dist/packages/work/src/harness/claude.d.ts +20 -8
- package/dist/packages/work/src/harness/claude.js +260 -58
- package/dist/packages/work/src/harness/codex.d.ts +5 -4
- package/dist/packages/work/src/harness/codex.js +169 -41
- package/dist/packages/work/src/harness/contract.d.ts +36 -11
- package/dist/packages/work/src/harness/fake.js +1 -0
- package/dist/packages/work/src/harness/jsonrpc-stdio.js +7 -0
- package/dist/packages/work/src/harness/permissions.d.ts +16 -3
- package/dist/packages/work/src/harness/permissions.js +102 -13
- package/dist/packages/work/src/harness/session-store.d.ts +27 -9
- package/dist/packages/work/src/harness/session-store.js +271 -67
- package/dist/packages/work/src/hold/mcp.d.ts +25 -5
- package/dist/packages/work/src/hold/mcp.js +126 -11
- package/dist/packages/work/src/hub/client.d.ts +2 -1
- package/dist/packages/work/src/hub/client.js +14 -1
- package/dist/packages/work/src/hub/types.d.ts +69 -33
- package/dist/packages/work/src/hub/types.js +8 -10
- package/dist/packages/work/src/mcp/server.js +1 -1
- package/dist/packages/work/src/owenloop-bin.d.ts +1 -0
- package/dist/packages/work/src/owenloop-bin.js +18 -0
- package/dist/packages/work/src/roles/agent-run.d.ts +12 -6
- package/dist/packages/work/src/roles/agent-run.js +116 -34
- package/dist/packages/work/src/roles/exec.d.ts +8 -0
- package/dist/packages/work/src/roles/exec.js +27 -2
- package/dist/packages/work/src/roles/hold.d.ts +4 -0
- package/dist/packages/work/src/roles/hold.js +44 -5
- package/dist/packages/work/src/roles/lint.d.ts +3 -4
- package/dist/packages/work/src/roles/lint.js +41 -7
- package/dist/packages/work/src/roles/settings.js +5 -0
- package/dist/packages/work/src/roles/shift.d.ts +1 -0
- package/dist/packages/work/src/roles/shift.js +23 -1
- package/dist/packages/work/src/settings/settings.d.ts +17 -1
- package/dist/packages/work/src/settings/settings.js +39 -0
- package/dist/packages/work/src/shift/loop.d.ts +14 -3
- package/dist/packages/work/src/shift/loop.js +447 -164
- package/dist/packages/work/src/shift/protocol.d.ts +4 -0
- package/dist/packages/work/src/shift/runtime.d.ts +2 -0
- package/dist/packages/work/src/shift/runtime.js +66 -3
- package/dist/packages/work/src/shift/spawn.d.ts +41 -18
- package/dist/packages/work/src/shift/spawn.js +89 -31
- package/dist/packages/work/src/shift/state.d.ts +53 -51
- package/dist/packages/work/src/shift/state.js +325 -102
- package/dist/packages/work/src/submit-proof.d.ts +36 -0
- package/dist/packages/work/src/submit-proof.js +93 -0
- package/dist/src/add.d.ts +64 -259
- package/dist/src/add.js +81 -615
- package/dist/src/archive.d.ts +97 -0
- package/dist/src/archive.js +591 -0
- package/dist/src/bundle/index.d.ts +64 -0
- package/dist/src/bundle/index.js +508 -0
- package/dist/src/bundle/manifest.d.ts +50 -0
- package/dist/src/bundle/manifest.js +435 -0
- package/dist/src/bundle/runtime.d.ts +26 -0
- package/dist/src/bundle/runtime.js +64 -0
- package/dist/src/bundle/tar.d.ts +62 -0
- package/dist/src/bundle/tar.js +238 -0
- package/dist/src/bundle/types.d.ts +105 -0
- package/dist/src/bundle/types.js +21 -0
- package/dist/src/cli.d.ts +90 -20
- package/dist/src/cli.js +2407 -365
- package/dist/src/credentials.d.ts +4 -3
- package/dist/src/credentials.js +21 -19
- package/dist/src/crypto/allowed-signers.d.ts +68 -0
- package/dist/src/crypto/allowed-signers.js +307 -0
- package/dist/src/crypto/canonical.d.ts +8 -0
- package/dist/src/crypto/canonical.js +92 -0
- package/dist/src/crypto/chain.d.ts +65 -0
- package/dist/src/crypto/chain.js +377 -0
- package/dist/src/crypto/dsse.d.ts +209 -0
- package/dist/src/crypto/dsse.js +282 -0
- package/dist/src/crypto/enrollment.d.ts +78 -0
- package/dist/src/crypto/enrollment.js +186 -0
- package/dist/src/crypto/index.d.ts +48 -0
- package/dist/src/crypto/index.js +44 -0
- package/dist/src/crypto/keys.d.ts +258 -0
- package/dist/src/crypto/keys.js +908 -0
- package/dist/src/crypto/org-root.d.ts +33 -0
- package/dist/src/crypto/org-root.js +78 -0
- package/dist/src/crypto/origin-rules.d.ts +56 -0
- package/dist/src/crypto/origin-rules.js +143 -0
- package/dist/src/crypto/policy-floor.d.ts +98 -0
- package/dist/src/crypto/policy-floor.js +353 -0
- package/dist/src/crypto/records.d.ts +316 -0
- package/dist/src/crypto/records.js +157 -0
- package/dist/src/crypto/scope.d.ts +49 -0
- package/dist/src/crypto/scope.js +83 -0
- package/dist/src/crypto/ssh.d.ts +171 -0
- package/dist/src/crypto/ssh.js +396 -0
- package/dist/src/crypto/submission.d.ts +33 -0
- package/dist/src/crypto/submission.js +47 -0
- package/dist/src/crypto/trust-roots.d.ts +29 -0
- package/dist/src/crypto/trust-roots.js +39 -0
- package/dist/src/crypto/verify-consumed.d.ts +67 -0
- package/dist/src/crypto/verify-consumed.js +259 -0
- package/dist/src/crypto/verify-origin.d.ts +50 -0
- package/dist/src/crypto/verify-origin.js +151 -0
- package/dist/src/crypto/verify-publication.d.ts +60 -0
- package/dist/src/crypto/verify-publication.js +150 -0
- package/dist/src/defs.d.ts +24 -1
- package/dist/src/defs.js +145 -25
- package/dist/src/engine.d.ts +99 -3
- package/dist/src/engine.js +238 -34
- package/dist/src/factory.d.ts +16 -0
- package/dist/src/factory.js +16 -4
- package/dist/src/global-config.d.ts +59 -0
- package/dist/src/global-config.js +84 -0
- package/dist/src/hub.d.ts +75 -21
- package/dist/src/hub.js +123 -40
- package/dist/src/index.d.ts +17 -2
- package/dist/src/index.js +20 -2
- package/dist/src/install.d.ts +538 -0
- package/dist/src/install.js +1981 -0
- package/dist/src/lock.d.ts +15 -57
- package/dist/src/lock.js +251 -143
- package/dist/src/mcp/serve.d.ts +46 -22
- package/dist/src/mcp/serve.js +167 -44
- package/dist/src/mcp/server.js +12 -1
- package/dist/src/model.d.ts +15 -0
- package/dist/src/model.js +111 -1
- package/dist/src/order-resolver.d.ts +184 -0
- package/dist/src/order-resolver.js +252 -0
- package/dist/src/package-version.d.ts +10 -0
- package/dist/src/package-version.js +42 -0
- package/dist/src/paths.d.ts +14 -1
- package/dist/src/paths.js +18 -0
- package/dist/src/schemas/enrollment-grant.v1.schema.json +90 -0
- package/dist/src/schemas/index.d.ts +1416 -0
- package/dist/src/schemas/index.js +31 -0
- package/dist/src/schemas/order.v1.schema.json +106 -0
- package/dist/src/schemas/origin.v1.schema.json +68 -0
- package/dist/src/schemas/policy-floor.v1.schema.json +29 -0
- package/dist/src/schemas/publication.v1.schema.json +31 -0
- package/dist/src/schemas/revocation.v1.schema.json +39 -0
- package/dist/src/schemas/submission.v1.schema.json +61 -0
- package/dist/src/store/def-source.d.ts +52 -0
- package/dist/src/store/def-source.js +335 -0
- package/dist/src/store/index-file.d.ts +69 -0
- package/dist/src/store/index-file.js +151 -0
- package/dist/src/store/index.d.ts +27 -0
- package/dist/src/store/index.js +22 -0
- package/dist/src/store/ingestor.d.ts +43 -0
- package/dist/src/store/ingestor.js +211 -0
- package/dist/src/store/install.d.ts +228 -0
- package/dist/src/store/install.js +555 -0
- package/dist/src/store/instruction-source.d.ts +49 -0
- package/dist/src/store/instruction-source.js +298 -0
- package/dist/src/store/origin-evidence.d.ts +21 -0
- package/dist/src/store/origin-evidence.js +66 -0
- package/dist/src/store/pre-commit-verifier.d.ts +68 -0
- package/dist/src/store/pre-commit-verifier.js +418 -0
- package/dist/src/store/resolve.d.ts +138 -0
- package/dist/src/store/resolve.js +363 -0
- package/dist/src/store/types.d.ts +288 -0
- package/dist/src/store/types.js +356 -0
- package/dist/src/types.d.ts +45 -11
- package/dist/src/untar.d.ts +8 -23
- package/dist/src/untar.js +10 -136
- package/docs/agent-runner.md +86 -0
- package/docs/authoring.md +57 -6
- package/docs/bundles.md +250 -0
- package/docs/cli.md +1171 -97
- package/docs/crypto.md +816 -0
- package/docs/design.md +342 -20
- package/docs/embedding.md +132 -25
- package/docs/wire-contracts.md +380 -0
- package/package.json +6 -1
- package/plugins/claude-code/.claude-plugin/marketplace.json +14 -0
- package/plugins/claude-code/plugin/.claude-plugin/plugin.json +8 -0
- package/plugins/claude-code/plugin/.mcp.json +14 -0
- package/plugins/claude-code/plugin/hooks/hooks.json +26 -0
- package/plugins/claude-code/plugin/hooks/session-end.sh +40 -0
- package/plugins/claude-code/plugin/hooks/session-start.sh +52 -0
- package/plugins/claude-code/plugin/skills/author/SKILL.md +181 -0
- package/plugins/claude-code/plugin/skills/conduct/SKILL.md +106 -0
- package/plugins/claude-code/plugin/skills/shift/SKILL.md +105 -0
- package/plugins/codex/.agents/plugins/marketplace.json +21 -0
- package/plugins/codex/plugins/owenloop/.codex-plugin/plugin.json +7 -0
- package/plugins/codex/plugins/owenloop/.mcp.json +20 -0
- package/plugins/codex/plugins/owenloop/hooks/hooks.json +26 -0
- package/plugins/codex/plugins/owenloop/hooks/session-end.sh +40 -0
- package/plugins/codex/plugins/owenloop/hooks/session-start.sh +52 -0
- package/plugins/codex/plugins/owenloop/skills/author/SKILL.md +181 -0
- package/plugins/codex/plugins/owenloop/skills/conduct/SKILL.md +106 -0
- package/plugins/codex/plugins/owenloop/skills/shift/SKILL.md +105 -0
|
@@ -0,0 +1,238 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Deterministic `.wnlp` archive writer (WP-A1).
|
|
3
|
+
*
|
|
4
|
+
* Canonical tar rules (see `docs/bundles.md`): regular-file entries only,
|
|
5
|
+
* `/`-separated paths sorted by ascending UTF-8 bytes, uid/gid 0, empty
|
|
6
|
+
* uname/gname, mtime 0, mode 0755 when any source execute bit is set and
|
|
7
|
+
* 0644 otherwise, USTAR name when it fits (UTF-8 bytes ≤ 100), else ONE
|
|
8
|
+
* deterministic POSIX PAX `path` extended record in a `PaxHeader` block
|
|
9
|
+
* (mode 0644, uid/gid 0, mtime 0), exactly two trailing zero blocks. The
|
|
10
|
+
* gzip wrapper uses fixed options, zero mtime bytes, and OS byte 0 (patched
|
|
11
|
+
* explicitly — Node reports OS 19 on Darwin). The raw header helpers are
|
|
12
|
+
* deliberately module-private: the public bundle surface exposes only the
|
|
13
|
+
* high-level pack/inspect/digest/unpack API.
|
|
14
|
+
*/
|
|
15
|
+
import { lstatSync, readdirSync } from 'node:fs';
|
|
16
|
+
import { join, resolve } from 'node:path';
|
|
17
|
+
import { gzipSync } from 'node:zlib';
|
|
18
|
+
import { canonicalBundleFilePrefix, canonicalBundlePathViolation, canonicalPaxNamePlaceholder, DEFAULT_TAR_LIMITS, } from "../archive.js";
|
|
19
|
+
import { BundleError } from "./types.js";
|
|
20
|
+
const BLOCK = 512;
|
|
21
|
+
/** Fixed gzip level for canonical output. */
|
|
22
|
+
export const BUNDLE_GZIP_LEVEL = 9;
|
|
23
|
+
/** An octal header field: `width - 1` zero-padded octal digits plus a trailing NUL. */
|
|
24
|
+
function octalField(value, width) {
|
|
25
|
+
const digits = value.toString(8);
|
|
26
|
+
if (digits.length > width - 1) {
|
|
27
|
+
throw new BundleError('MANIFEST_ERROR', `tar field overflow: ${value} does not fit ${width} bytes`);
|
|
28
|
+
}
|
|
29
|
+
return Buffer.from(digits.padStart(width - 1, '0') + '\0', 'ascii');
|
|
30
|
+
}
|
|
31
|
+
function padBlock(data) {
|
|
32
|
+
const padded = Math.ceil(data.length / BLOCK) * BLOCK;
|
|
33
|
+
const out = Buffer.alloc(padded);
|
|
34
|
+
Buffer.from(data).copy(out);
|
|
35
|
+
return out;
|
|
36
|
+
}
|
|
37
|
+
/**
|
|
38
|
+
* One 512-byte canonical USTAR header: name (ASCII, ≤100 bytes), mode,
|
|
39
|
+
* uid/gid 0, size, mtime 0, checksum, typeflag, magic `ustar\0`, version
|
|
40
|
+
* `00`, empty uname/gname and blank prefix/dev fields (zero-filled).
|
|
41
|
+
*/
|
|
42
|
+
function buildHeader(name, size, typeflag, mode) {
|
|
43
|
+
const buf = Buffer.alloc(BLOCK);
|
|
44
|
+
const nameBytes = Buffer.from(name, 'utf8');
|
|
45
|
+
if (nameBytes.length > 100) {
|
|
46
|
+
throw new BundleError('ARCHIVE_PATH_TOO_LONG', `tar name field cannot hold '${name}'`);
|
|
47
|
+
}
|
|
48
|
+
nameBytes.copy(buf, 0);
|
|
49
|
+
octalField(mode, 8).copy(buf, 100);
|
|
50
|
+
octalField(0, 8).copy(buf, 108); // uid
|
|
51
|
+
octalField(0, 8).copy(buf, 116); // gid
|
|
52
|
+
octalField(size, 12).copy(buf, 124);
|
|
53
|
+
octalField(0, 12).copy(buf, 136); // mtime
|
|
54
|
+
buf.fill(0x20, 148, 156); // checksum field: spaces while computing
|
|
55
|
+
buf[156] = typeflag.charCodeAt(0);
|
|
56
|
+
buf.write('ustar', 257, 'ascii'); // magic "ustar\0" (rest zero-filled)
|
|
57
|
+
buf[262] = 0;
|
|
58
|
+
buf.write('00', 263, 2, 'ascii'); // version
|
|
59
|
+
// uname/gname (265..329), linkname (329..400), prefix (345..500), devmajor/
|
|
60
|
+
// devminor stay zero — canonical.
|
|
61
|
+
let sum = 0;
|
|
62
|
+
for (let i = 0; i < BLOCK; i++)
|
|
63
|
+
sum += buf[i];
|
|
64
|
+
const chksum = Buffer.from(sum.toString(8).padStart(6, '0') + '\0 ', 'ascii');
|
|
65
|
+
chksum.copy(buf, 148);
|
|
66
|
+
return buf;
|
|
67
|
+
}
|
|
68
|
+
/** The one canonical pax extended-header data block: a single self-inclusive `path` record. */
|
|
69
|
+
function buildPaxPathRecord(path) {
|
|
70
|
+
const valueBytes = Buffer.byteLength(path, 'utf8');
|
|
71
|
+
// Record: "<len> path=<value>\n"; len counts every byte of the record.
|
|
72
|
+
const suffixLen = 1 + 'path='.length + valueBytes + 1;
|
|
73
|
+
let digits = String(suffixLen).length;
|
|
74
|
+
let total = digits + suffixLen;
|
|
75
|
+
while (String(total).length !== digits) {
|
|
76
|
+
digits = String(total).length;
|
|
77
|
+
total = digits + suffixLen;
|
|
78
|
+
}
|
|
79
|
+
return Buffer.from(`${total} path=${path}\n`, 'utf8');
|
|
80
|
+
}
|
|
81
|
+
/**
|
|
82
|
+
* Build the canonical uncompressed tar bytes for a set of files. The input
|
|
83
|
+
* MUST already be sorted by ascending UTF-8 byte order of `path` and carry
|
|
84
|
+
* canonical modes; the bundle packer guarantees both.
|
|
85
|
+
*/
|
|
86
|
+
export function buildCanonicalTar(files, limits = DEFAULT_TAR_LIMITS) {
|
|
87
|
+
let headerCount = 0;
|
|
88
|
+
const chunks = [];
|
|
89
|
+
let previousPath;
|
|
90
|
+
const filePaths = new Set();
|
|
91
|
+
for (const f of files) {
|
|
92
|
+
const violation = canonicalBundlePathViolation(f.path);
|
|
93
|
+
if (violation) {
|
|
94
|
+
throw new BundleError('SOURCE_INVALID_PATH', `unsafe path '${f.path}': ${violation}`, f.path);
|
|
95
|
+
}
|
|
96
|
+
if (previousPath !== undefined) {
|
|
97
|
+
const order = compareUtf8Paths(previousPath, f.path);
|
|
98
|
+
if (order === 0) {
|
|
99
|
+
throw new BundleError('ARCHIVE_DUPLICATE_PATH', `duplicate archive path '${f.path}'`, f.path);
|
|
100
|
+
}
|
|
101
|
+
if (order > 0) {
|
|
102
|
+
throw new BundleError('NON_CANONICAL_HEADER', `archive entries are not sorted by UTF-8 path: '${f.path}' follows '${previousPath}'`, f.path);
|
|
103
|
+
}
|
|
104
|
+
}
|
|
105
|
+
const filePrefix = canonicalBundleFilePrefix(f.path, filePaths);
|
|
106
|
+
if (filePrefix !== undefined) {
|
|
107
|
+
throw new BundleError('ARCHIVE_PATH_PREFIX_COLLISION', `archive file path '${filePrefix}' is a complete-segment prefix of '${f.path}'`, f.path);
|
|
108
|
+
}
|
|
109
|
+
filePaths.add(f.path);
|
|
110
|
+
previousPath = f.path;
|
|
111
|
+
if (f.path.length > limits.maxPathLength) {
|
|
112
|
+
throw new BundleError('ARCHIVE_PATH_TOO_LONG', `archive entry path length ${f.path.length} exceeds limit of ${limits.maxPathLength} chars`, f.path);
|
|
113
|
+
}
|
|
114
|
+
if (f.bytes.length > limits.maxFileBytes) {
|
|
115
|
+
throw new BundleError('ARCHIVE_ENTRY_TOO_LARGE', `archive entry '${f.path}' is ${f.bytes.length} bytes; limit is ${limits.maxFileBytes}`, f.path);
|
|
116
|
+
}
|
|
117
|
+
if (f.mode !== 0o644 && f.mode !== 0o755) {
|
|
118
|
+
throw new BundleError('NON_CANONICAL_HEADER', `archive entry '${f.path}' must use mode 0644 or 0755`, f.path);
|
|
119
|
+
}
|
|
120
|
+
const nameBytes = Buffer.byteLength(f.path, 'utf8');
|
|
121
|
+
if (nameBytes > 100) {
|
|
122
|
+
// USTAR name cannot hold it — emit a deterministic PAX path header.
|
|
123
|
+
headerCount += 2;
|
|
124
|
+
const paxData = buildPaxPathRecord(f.path);
|
|
125
|
+
chunks.push(buildHeader('PaxHeader', paxData.length, 'x', 0o644));
|
|
126
|
+
chunks.push(padBlock(paxData));
|
|
127
|
+
// The 100-byte name field is only a deterministic placeholder; the PAX
|
|
128
|
+
// record carries the effective UTF-8 path. Use the shared placeholder
|
|
129
|
+
// rule so the strict reader requires exactly what the writer emits.
|
|
130
|
+
chunks.push(buildHeader(canonicalPaxNamePlaceholder(f.path), f.bytes.length, '0', f.mode));
|
|
131
|
+
}
|
|
132
|
+
else {
|
|
133
|
+
headerCount += 1;
|
|
134
|
+
chunks.push(buildHeader(f.path, f.bytes.length, '0', f.mode));
|
|
135
|
+
}
|
|
136
|
+
if (headerCount > limits.maxFileCount) {
|
|
137
|
+
throw new BundleError('ARCHIVE_TOO_MANY_ENTRIES', `archive entry count exceeds limit of ${limits.maxFileCount}`);
|
|
138
|
+
}
|
|
139
|
+
chunks.push(padBlock(f.bytes));
|
|
140
|
+
}
|
|
141
|
+
chunks.push(Buffer.alloc(BLOCK * 2)); // two zero blocks end the archive
|
|
142
|
+
const tar = Buffer.concat(chunks);
|
|
143
|
+
if (tar.length > limits.maxExpandedBytes) {
|
|
144
|
+
throw new BundleError('BUNDLE_LIMIT', `expanded archive size ${tar.length} exceeds limit of ${limits.maxExpandedBytes} bytes`);
|
|
145
|
+
}
|
|
146
|
+
return tar;
|
|
147
|
+
}
|
|
148
|
+
/**
|
|
149
|
+
* Gzip `tar` with fixed options and a normalized header: no FEXTRA/FNAME/
|
|
150
|
+
* FCOMMENT, mtime bytes zeroed, OS byte forced to 0. Node's zlib reports
|
|
151
|
+
* OS 19 on Darwin and embeds the clock in mtime by default — patch both so
|
|
152
|
+
* the output is byte-identical across platforms and times.
|
|
153
|
+
*/
|
|
154
|
+
export function gzipDeterministic(tar) {
|
|
155
|
+
const gz = gzipSync(Buffer.from(tar), { level: BUNDLE_GZIP_LEVEL });
|
|
156
|
+
gz[4] = 0; // mtime byte 0
|
|
157
|
+
gz[5] = 0; // mtime byte 1
|
|
158
|
+
gz[6] = 0; // mtime byte 2
|
|
159
|
+
gz[7] = 0; // mtime byte 3
|
|
160
|
+
gz[9] = 0; // OS byte (Darwin reports 19; the format fixes 0)
|
|
161
|
+
return gz;
|
|
162
|
+
}
|
|
163
|
+
/** Compare archive paths by ascending UTF-8 bytes, as required by canonical packing. */
|
|
164
|
+
export function compareUtf8Paths(a, b) {
|
|
165
|
+
return Buffer.compare(Buffer.from(a, 'utf8'), Buffer.from(b, 'utf8'));
|
|
166
|
+
}
|
|
167
|
+
const byNameBytes = (a, b) => compareUtf8Paths(a.name, b.name);
|
|
168
|
+
export function collectSourceFiles(sourceRoot, limits = DEFAULT_TAR_LIMITS, options = {}) {
|
|
169
|
+
const root = resolve(sourceRoot);
|
|
170
|
+
const readDir = options.readDir ?? ((directory) => readdirSync(directory, { withFileTypes: true }));
|
|
171
|
+
let rootStat;
|
|
172
|
+
try {
|
|
173
|
+
rootStat = lstatSync(root);
|
|
174
|
+
}
|
|
175
|
+
catch {
|
|
176
|
+
throw new BundleError('SOURCE_NOT_A_DIRECTORY', `source directory '${sourceRoot}' does not exist`);
|
|
177
|
+
}
|
|
178
|
+
if (rootStat.isSymbolicLink()) {
|
|
179
|
+
throw new BundleError('SOURCE_SYMLINK', `source root '${sourceRoot}' is a symbolic link`);
|
|
180
|
+
}
|
|
181
|
+
if (!rootStat.isDirectory()) {
|
|
182
|
+
throw new BundleError('SOURCE_NOT_A_DIRECTORY', `source '${sourceRoot}' is not a directory`);
|
|
183
|
+
}
|
|
184
|
+
const out = [];
|
|
185
|
+
let archiveEntryCount = 0;
|
|
186
|
+
const walk = (dirAbs, relPrefix) => {
|
|
187
|
+
let dirents;
|
|
188
|
+
try {
|
|
189
|
+
dirents = readDir(dirAbs);
|
|
190
|
+
}
|
|
191
|
+
catch (e) {
|
|
192
|
+
throw new BundleError('SOURCE_NOT_A_DIRECTORY', `cannot read '${dirAbs}': ${e.message}`);
|
|
193
|
+
}
|
|
194
|
+
dirents.sort(byNameBytes);
|
|
195
|
+
for (const d of dirents) {
|
|
196
|
+
const abs = join(dirAbs, d.name);
|
|
197
|
+
const rel = relPrefix === '' ? d.name : `${relPrefix}/${d.name}`;
|
|
198
|
+
options.onVisit?.(rel);
|
|
199
|
+
const violation = canonicalBundlePathViolation(rel);
|
|
200
|
+
if (violation) {
|
|
201
|
+
throw new BundleError('SOURCE_INVALID_PATH', `unsafe path '${rel}': ${violation}`, rel);
|
|
202
|
+
}
|
|
203
|
+
if (rel.length > limits.maxPathLength) {
|
|
204
|
+
throw new BundleError('ARCHIVE_PATH_TOO_LONG', `archive entry path length ${rel.length} exceeds limit of ${limits.maxPathLength} chars`, rel);
|
|
205
|
+
}
|
|
206
|
+
const st = lstatSync(abs);
|
|
207
|
+
if (st.isSymbolicLink()) {
|
|
208
|
+
throw new BundleError('SOURCE_SYMLINK', `symbolic link '${rel}' cannot be packed`, rel);
|
|
209
|
+
}
|
|
210
|
+
if (st.isDirectory()) {
|
|
211
|
+
walk(abs, rel);
|
|
212
|
+
continue;
|
|
213
|
+
}
|
|
214
|
+
if (!st.isFile()) {
|
|
215
|
+
throw new BundleError('SOURCE_NOT_A_FILE', `'${rel}' is not a regular file or directory`, rel);
|
|
216
|
+
}
|
|
217
|
+
if (st.size > limits.maxFileBytes) {
|
|
218
|
+
throw new BundleError('ARCHIVE_ENTRY_TOO_LARGE', `archive entry '${rel}' is ${st.size} bytes; limit is ${limits.maxFileBytes}`, rel);
|
|
219
|
+
}
|
|
220
|
+
out.push({ rel, abs, executable: (st.mode & 0o111) !== 0 });
|
|
221
|
+
archiveEntryCount += Buffer.byteLength(rel, 'utf8') > 100 ? 2 : 1;
|
|
222
|
+
if (archiveEntryCount > limits.maxFileCount) {
|
|
223
|
+
throw new BundleError('ARCHIVE_TOO_MANY_ENTRIES', `archive entry count exceeds limit of ${limits.maxFileCount}`);
|
|
224
|
+
}
|
|
225
|
+
}
|
|
226
|
+
};
|
|
227
|
+
walk(root, '');
|
|
228
|
+
out.sort((a, b) => compareUtf8Paths(a.rel, b.rel));
|
|
229
|
+
const filePaths = new Set();
|
|
230
|
+
for (const file of out) {
|
|
231
|
+
const filePrefix = canonicalBundleFilePrefix(file.rel, filePaths);
|
|
232
|
+
if (filePrefix !== undefined) {
|
|
233
|
+
throw new BundleError('ARCHIVE_PATH_PREFIX_COLLISION', `source file path '${filePrefix}' is a complete-segment prefix of '${file.rel}'`, file.rel);
|
|
234
|
+
}
|
|
235
|
+
filePaths.add(file.rel);
|
|
236
|
+
}
|
|
237
|
+
return out;
|
|
238
|
+
}
|
|
@@ -0,0 +1,105 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Public types for the deterministic `.wnlp` bundle format (WP-A1).
|
|
3
|
+
*
|
|
4
|
+
* A `.wnlp` file is gzip-compressed canonical POSIX/PAX tar; its identity
|
|
5
|
+
* ("def digest") is the lowercase SHA-256 of the UNCOMPRESSED canonical tar
|
|
6
|
+
* bytes. See `docs/bundles.md` for the full format contract.
|
|
7
|
+
*/
|
|
8
|
+
import type { TarLimits } from '../archive.ts';
|
|
9
|
+
/** Every bundle failure carries one of these stable codes (machines match on `code`). */
|
|
10
|
+
export type BundleErrorCode = 'BUNDLE_IO' | 'BUNDLE_NOT_GZIP' | 'BUNDLE_LIMIT' | 'ARCHIVE_TOO_MANY_ENTRIES' | 'ARCHIVE_ENTRY_TOO_LARGE' | 'ARCHIVE_PATH_TOO_LONG' | 'ARCHIVE_PATH_VIOLATION' | 'ARCHIVE_DUPLICATE_PATH' | 'ARCHIVE_PATH_PREFIX_COLLISION' | 'ARCHIVE_TRUNCATED' | 'ARCHIVE_BAD_CHECKSUM' | 'ARCHIVE_BAD_OCTAL' | 'ARCHIVE_BAD_PAX' | 'ARCHIVE_DANGLING_PAX' | 'ARCHIVE_TRAILING_BYTES' | 'UNSUPPORTED_ENTRY_TYPE' | 'NON_CANONICAL_HEADER' | 'MANIFEST_ERROR' | 'RUNTIME_INCOMPATIBLE' | 'UNSUPPORTED_FORMAT_VERSION' | 'MANIFEST_MISSING' | 'WORKFLOW_MISSING' | 'WORKFLOW_INVALID' | 'INTEGRITY_MISMATCH' | 'SOURCE_NOT_A_DIRECTORY' | 'SOURCE_NOT_A_FILE' | 'SOURCE_SYMLINK' | 'SOURCE_INVALID_PATH' | 'SOURCE_FILE_CHANGED' | 'OUTPUT_INSIDE_SOURCE' | 'OUTPUT_INVALID' | 'DESTINATION_EXISTS' | 'DESTINATION_PARENT_INVALID' | 'WORKFLOW_ERROR';
|
|
11
|
+
/**
|
|
12
|
+
* A typed bundle failure. `message` is human-readable; `entryPath` carries
|
|
13
|
+
* the offending archive/manifest entry when applicable.
|
|
14
|
+
*/
|
|
15
|
+
export declare class BundleError extends Error {
|
|
16
|
+
readonly code: BundleErrorCode;
|
|
17
|
+
readonly entryPath?: string;
|
|
18
|
+
constructor(code: BundleErrorCode, message: string, entryPath?: string);
|
|
19
|
+
}
|
|
20
|
+
/** Compatibility requirements that a format-v2 bundle places on its reader/runtime. */
|
|
21
|
+
export interface BundleRuntimeRequirements {
|
|
22
|
+
/** Minimum canonical Owenloop SemVer accepted by the bundle. */
|
|
23
|
+
minVersion?: string;
|
|
24
|
+
/** Versioned runtime feature identifiers that the reader must implement. */
|
|
25
|
+
features?: string[];
|
|
26
|
+
}
|
|
27
|
+
/**
|
|
28
|
+
* The v2 package-only manifest (`bundle.yaml`). All collections are
|
|
29
|
+
* duplicate-free; serialization order is deterministic (see
|
|
30
|
+
* `docs/bundles.md` §Manifest).
|
|
31
|
+
*/
|
|
32
|
+
export interface BundleManifest {
|
|
33
|
+
/** Always `2` in this format version. */
|
|
34
|
+
formatVersion: 2;
|
|
35
|
+
package: {
|
|
36
|
+
/** Portable package namespace. */
|
|
37
|
+
name: string;
|
|
38
|
+
/** Non-empty version string. */
|
|
39
|
+
version: string;
|
|
40
|
+
};
|
|
41
|
+
/** Optional reader/runtime compatibility requirements. */
|
|
42
|
+
runtime?: BundleRuntimeRequirements;
|
|
43
|
+
/** Workflow name to archive-relative definition path. */
|
|
44
|
+
workflows: Record<string, string>;
|
|
45
|
+
/** Optional default workflow name. */
|
|
46
|
+
default?: string;
|
|
47
|
+
/** Platform selectors this package targets (may be empty). */
|
|
48
|
+
platforms: string[];
|
|
49
|
+
integrity: {
|
|
50
|
+
/** Always `'sha256'`. */
|
|
51
|
+
algorithm: 'sha256';
|
|
52
|
+
/**
|
|
53
|
+
* Lowercase 64-hex SHA-256 for every regular archive file EXCEPT
|
|
54
|
+
* `bundle.yaml` (self-hash is recursive; the def digest still covers the
|
|
55
|
+
* manifest through the canonical tar).
|
|
56
|
+
*/
|
|
57
|
+
files: Record<string, string>;
|
|
58
|
+
};
|
|
59
|
+
/**
|
|
60
|
+
* Requested capability classes and values — REQUESTS only; this format
|
|
61
|
+
* neither grants nor enforces them.
|
|
62
|
+
*/
|
|
63
|
+
capabilities: Record<string, string[]>;
|
|
64
|
+
/**
|
|
65
|
+
* Digest-pinned cross-bundle references: exact `namespace/name@version`
|
|
66
|
+
* reference text → lowercase 64-hex def digest of the called bundle.
|
|
67
|
+
*/
|
|
68
|
+
lock: Record<string, string>;
|
|
69
|
+
}
|
|
70
|
+
/** One regular-file entry of a bundle, as returned by pack/inspect. */
|
|
71
|
+
export interface BundleEntryInfo {
|
|
72
|
+
path: string;
|
|
73
|
+
size: number;
|
|
74
|
+
/** True when the source carried any execute bit (canonical mode 0755). */
|
|
75
|
+
executable: boolean;
|
|
76
|
+
/** Lowercase 64-hex SHA-256 of the entry's bytes. */
|
|
77
|
+
sha256: string;
|
|
78
|
+
}
|
|
79
|
+
/** Result of {@link packBundle}. */
|
|
80
|
+
export interface PackResult {
|
|
81
|
+
/** The complete `.wnlp` bytes (gzip of the canonical tar). */
|
|
82
|
+
bytes: Uint8Array;
|
|
83
|
+
/** Lowercase 64-hex SHA-256 over the uncompressed canonical tar bytes. */
|
|
84
|
+
digest: string;
|
|
85
|
+
/** The canonical manifest actually archived (source manifest regenerated). */
|
|
86
|
+
manifest: BundleManifest;
|
|
87
|
+
/** Archive entries in canonical (sorted) order, including `bundle.yaml`. */
|
|
88
|
+
entries: BundleEntryInfo[];
|
|
89
|
+
}
|
|
90
|
+
/** Result of {@link inspectBundle}. */
|
|
91
|
+
export interface InspectResult {
|
|
92
|
+
digest: string;
|
|
93
|
+
manifest: BundleManifest;
|
|
94
|
+
entries: BundleEntryInfo[];
|
|
95
|
+
}
|
|
96
|
+
/** Resource bounds for reading/writing bundles (the shared archive limits). */
|
|
97
|
+
export type BundleLimits = TarLimits;
|
|
98
|
+
/** Options for {@link packBundle}. */
|
|
99
|
+
export interface PackOptions {
|
|
100
|
+
limits?: Partial<BundleLimits>;
|
|
101
|
+
}
|
|
102
|
+
/** Options for {@link inspectBundle} / {@link digestBundle} / {@link unpackBundle}. */
|
|
103
|
+
export interface InspectOptions {
|
|
104
|
+
limits?: Partial<BundleLimits>;
|
|
105
|
+
}
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Public types for the deterministic `.wnlp` bundle format (WP-A1).
|
|
3
|
+
*
|
|
4
|
+
* A `.wnlp` file is gzip-compressed canonical POSIX/PAX tar; its identity
|
|
5
|
+
* ("def digest") is the lowercase SHA-256 of the UNCOMPRESSED canonical tar
|
|
6
|
+
* bytes. See `docs/bundles.md` for the full format contract.
|
|
7
|
+
*/
|
|
8
|
+
/**
|
|
9
|
+
* A typed bundle failure. `message` is human-readable; `entryPath` carries
|
|
10
|
+
* the offending archive/manifest entry when applicable.
|
|
11
|
+
*/
|
|
12
|
+
export class BundleError extends Error {
|
|
13
|
+
code;
|
|
14
|
+
entryPath;
|
|
15
|
+
constructor(code, message, entryPath) {
|
|
16
|
+
super(message);
|
|
17
|
+
this.code = code;
|
|
18
|
+
if (entryPath !== undefined)
|
|
19
|
+
this.entryPath = entryPath;
|
|
20
|
+
}
|
|
21
|
+
}
|
package/dist/src/cli.d.ts
CHANGED
|
@@ -9,6 +9,7 @@
|
|
|
9
9
|
*
|
|
10
10
|
* owenloop defs list available workflow definitions
|
|
11
11
|
* owenloop add <owner>/<repo>[@ref] fetch, validate, and install a repo's workflow defs (public repos)
|
|
12
|
+
* owenloop start <def> [--provide n=json] [--crew name] start a published hub workflow
|
|
12
13
|
* owenloop create <def> [--provide n=json] [--title t] start an instance
|
|
13
14
|
* owenloop provide <wf> <name> [--value json] supply an owed input
|
|
14
15
|
* owenloop tick <wf> [--now ms] pull eligible orders
|
|
@@ -31,10 +32,13 @@
|
|
|
31
32
|
*
|
|
32
33
|
* Global: --db <path> (env OWENLOOP_DB), --defs <dir> (env OWENLOOP_DEFS).
|
|
33
34
|
*/
|
|
34
|
-
import
|
|
35
|
+
import { hasDefiniteCheckDefect } from './model.ts';
|
|
36
|
+
import { PrincipalKeyManager } from './crypto/keys.ts';
|
|
35
37
|
import type { LineStream } from './mcp/server.ts';
|
|
38
|
+
import type { BundleIngestor, PreCommitVerifier } from './store/index.ts';
|
|
36
39
|
import type { AgentIdentitySummary, Keychain } from './hub.ts';
|
|
37
40
|
export type { Keychain } from './hub.ts';
|
|
41
|
+
export type HarnessId = 'claude-code' | 'codex';
|
|
38
42
|
export interface CliIO {
|
|
39
43
|
cwd: string;
|
|
40
44
|
env: Record<string, string | undefined>;
|
|
@@ -42,6 +46,24 @@ export interface CliIO {
|
|
|
42
46
|
err: (line: string) => void;
|
|
43
47
|
/** Injectable for hermetic tests — the network-touching verbs (`add`, hub commands) use this. */
|
|
44
48
|
fetch?: typeof globalThis.fetch;
|
|
49
|
+
/**
|
|
50
|
+
* The bundle adapter for the `.wnlp` install route (unpacking, manifest
|
|
51
|
+
* integrity, canonical digest, coordinate). Injectable for tests and for
|
|
52
|
+
* wiring layers that carry the bundle-format module. `add` with bundle
|
|
53
|
+
* input FAILS CLOSED when this is absent — there is no default accepting
|
|
54
|
+
* parser or digest algorithm. The GitHub repo route never uses it.
|
|
55
|
+
*/
|
|
56
|
+
bundleIngestor?: BundleIngestor;
|
|
57
|
+
/**
|
|
58
|
+
* The pre-commit verifier for the `.wnlp` install route, called after
|
|
59
|
+
* content/engine validation and before any object swap or index write.
|
|
60
|
+
* Injectable for tests and for wiring layers that carry the verification
|
|
61
|
+
* module. `add` with bundle input FAILS CLOSED when this is absent — there
|
|
62
|
+
* is no default accepting verifier. The GitHub repo route never uses it.
|
|
63
|
+
*/
|
|
64
|
+
preCommitVerifier?: PreCommitVerifier;
|
|
65
|
+
/** Optional test/runtime override for the external install/repair transaction marker directory. */
|
|
66
|
+
recoveryMarkerDir?: string;
|
|
45
67
|
/** Open a URL in the user's browser (login). Default: fire-and-forget `open`/`xdg-open`/`start`. */
|
|
46
68
|
openUrl?: (url: string) => void;
|
|
47
69
|
/**
|
|
@@ -71,33 +93,33 @@ export interface CliIO {
|
|
|
71
93
|
*/
|
|
72
94
|
prompt?: (question: string) => Promise<string>;
|
|
73
95
|
/**
|
|
74
|
-
* Run a local command and capture its result — used
|
|
75
|
-
* Claude Code plugin
|
|
96
|
+
* Run a local command and capture its result — used by `setup`/`doctor`'s
|
|
97
|
+
* Claude Code and Codex plugin probes and convergers. Default: a `spawnSync`
|
|
76
98
|
* wrapper with `shell: false` (never interpolates argv into a shell) that
|
|
77
|
-
* never inherits stdio. Injectable so tests model
|
|
78
|
-
* real
|
|
99
|
+
* never inherits stdio. Injectable so tests model plugin state and installs
|
|
100
|
+
* without real harness binaries or configuration writes.
|
|
79
101
|
*/
|
|
80
102
|
runCommand?: (cmd: string, args: string[]) => {
|
|
81
103
|
status: number | null;
|
|
82
104
|
stdout: string;
|
|
83
105
|
stderr: string;
|
|
84
106
|
};
|
|
107
|
+
/** Optional resolver override for hermetic tests of a missing bundled marketplace. */
|
|
108
|
+
resolveBundledMarketplaceRoot?: (harness: HarnessId) => string | null;
|
|
109
|
+
/**
|
|
110
|
+
* The principal signing-key manager for `setup`'s `[4/7] signing keys` step.
|
|
111
|
+
* Injectable so setup tests never reach the developer's real `ssh-keygen`,
|
|
112
|
+
* Keychain, libsecret, SSH agent, or `$HOME` (`makeFakePrincipalKeys` in
|
|
113
|
+
* test/hubkit.ts). Default: a real `PrincipalKeyManager` over `io.env`.
|
|
114
|
+
* Structurally `Pick<PrincipalKeyManager, 'ensure' | 'inspect' | 'withSigningKey' |
|
|
115
|
+
* 'resolveRef'>` — the narrow surface setup and publish use — so fakes stay
|
|
116
|
+
* hermetic.
|
|
117
|
+
*/
|
|
118
|
+
principalKeys?: Pick<PrincipalKeyManager, 'ensure' | 'inspect' | 'withSigningKey' | 'resolveRef'>;
|
|
85
119
|
}
|
|
86
|
-
export declare
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
* `check`, `add` (dispatchAdd) and `push` (dispatchPush) so all three
|
|
90
|
-
* accept-or-reject a def identically. A pure function of the report object — it
|
|
91
|
-
* does NOT read or change how any caller seeded its modelCheck (add/push seed
|
|
92
|
-
* `assumeProvided: true`; check seeds `assumeProvided: !strictInputs`).
|
|
93
|
-
*
|
|
94
|
-
* invariant violations and structurally-dead steps are ALWAYS definite (sound
|
|
95
|
-
* regardless of bounds); a true deadlock counts ONLY when the search was
|
|
96
|
-
* exhaustive (`!bounded`) because a tight maxCollectionSize cap can manufacture
|
|
97
|
-
* a spurious one. `unreachedSteps` is deliberately EXCLUDED — it is a bounds
|
|
98
|
-
* artifact ("raise --max-states/--max-depth"), never a definite defect.
|
|
99
|
-
*/
|
|
100
|
-
export declare function hasDefiniteCheckDefect(report: CheckReport): boolean;
|
|
120
|
+
export declare function defaultIO(): CliIO;
|
|
121
|
+
export declare const USAGE: string;
|
|
122
|
+
export { hasDefiniteCheckDefect };
|
|
101
123
|
/**
|
|
102
124
|
* Single source of truth for the `--options` each command accepts, consulted by
|
|
103
125
|
* `preflight` before any side effect. Unknown-OPTION rejection AND
|
|
@@ -112,6 +134,40 @@ export declare function hasDefiniteCheckDefect(report: CheckReport): boolean;
|
|
|
112
134
|
* `last/all/flag/needOpt/numOpt` call site.
|
|
113
135
|
*/
|
|
114
136
|
export declare const COMMAND_OPTIONS: ReadonlyMap<string, ReadonlySet<string>>;
|
|
137
|
+
/**
|
|
138
|
+
* The classification of a single `add` positional. Pure and independently
|
|
139
|
+
* tested: no filesystem access, no network, no state.
|
|
140
|
+
*
|
|
141
|
+
* - `github`: `owner/repo[@ref]` with no URL scheme and no `.wnlp` path —
|
|
142
|
+
* the byte-for-byte preserved GitHub route.
|
|
143
|
+
* - `file`: a local path ending in `.wnlp` — a bundle FILE (origin data only,
|
|
144
|
+
* never identity).
|
|
145
|
+
* - `url`: an `http:`/`https:` URL — a bundle URL; any other scheme is
|
|
146
|
+
* rejected, never a silent fallback.
|
|
147
|
+
*/
|
|
148
|
+
export type AddSource = {
|
|
149
|
+
kind: 'github';
|
|
150
|
+
spec: string;
|
|
151
|
+
} | {
|
|
152
|
+
kind: 'file';
|
|
153
|
+
path: string;
|
|
154
|
+
} | {
|
|
155
|
+
kind: 'url';
|
|
156
|
+
url: string;
|
|
157
|
+
};
|
|
158
|
+
/**
|
|
159
|
+
* Classify one `add` positional WITHOUT changing GitHub behavior: the GitHub
|
|
160
|
+
* shape (`owner/repo[@ref]`, no scheme, not a `.wnlp` path) returns
|
|
161
|
+
* `{ kind: 'github' }` for exactly the same inputs `parseRepoSpec` accepts,
|
|
162
|
+
* and the GitHub route keeps parsing it — so every error message for a
|
|
163
|
+
* malformed repo spec is unchanged. `.wnlp` file paths and http/https URLs
|
|
164
|
+
* take the bundle route; everything else is a specific usage refusal.
|
|
165
|
+
*
|
|
166
|
+
* The classifier never inspects the filesystem: a `.wnlp` path that does not
|
|
167
|
+
* exist is still classified as a file (the reader refuses it afterward with
|
|
168
|
+
* the reason), and a URL is classified by scheme alone.
|
|
169
|
+
*/
|
|
170
|
+
export declare function classifyAddSource(spec: string): AddSource;
|
|
115
171
|
/**
|
|
116
172
|
* Coerce a raw string (a hostname) into a valid agent account name, or `''` when
|
|
117
173
|
* nothing usable survives. Lowercase; drop every character outside the account
|
|
@@ -133,6 +189,20 @@ export declare function lastActiveMs(identity: AgentIdentitySummary): number | n
|
|
|
133
189
|
* renders `never`. Negative deltas (clock skew) clamp to `just now`.
|
|
134
190
|
*/
|
|
135
191
|
export declare function formatLastActive(deltaMs: number | null): string;
|
|
192
|
+
export interface HarnessPluginState {
|
|
193
|
+
id: HarnessId;
|
|
194
|
+
cliName: 'claude' | 'codex';
|
|
195
|
+
cliFound: boolean;
|
|
196
|
+
installed: boolean;
|
|
197
|
+
installedVersion: string | null;
|
|
198
|
+
cliVersion: string | null;
|
|
199
|
+
}
|
|
200
|
+
/**
|
|
201
|
+
* Resolve a bundled marketplace root from either the source tree (`src/cli.ts`)
|
|
202
|
+
* or the shipped tree (`dist/src/cli.js`). The manifest check prevents a partial
|
|
203
|
+
* package from producing a path that the harness cannot consume.
|
|
204
|
+
*/
|
|
205
|
+
export declare function resolveBundledMarketplaceRoot(harness: HarnessId): string | null;
|
|
136
206
|
/**
|
|
137
207
|
* Async entry point that adds network I/O for `add` and the hub commands on top
|
|
138
208
|
* of the otherwise fully-synchronous engine/CLI (see the doc comment on
|