@openclaw/lobster 2026.7.2-beta.7 → 2026.8.1-beta.2

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/index.js CHANGED
@@ -6,6 +6,7 @@ import { Type } from "typebox";
6
6
  import { stat } from "node:fs/promises";
7
7
  import path from "node:path";
8
8
  import { Readable, Writable } from "node:stream";
9
+ import { toErrorObject } from "openclaw/plugin-sdk/error-runtime";
9
10
  //#region extensions/lobster/src/lobster-runner.ts
10
11
  const workflowExts = /* @__PURE__ */ new Set([
11
12
  ".lobster",
@@ -40,66 +41,36 @@ function createLimitedSink(maxBytes, label) {
40
41
  } });
41
42
  }
42
43
  function normalizeEnvelope(envelope) {
43
- if (envelope.ok) {
44
- if (envelope.status === "needs_input") return {
45
- ok: false,
46
- error: {
47
- type: "unsupported_status",
48
- message: "Lobster input requests are not supported by the OpenClaw Lobster tool yet"
49
- }
50
- };
51
- return {
52
- ok: true,
53
- status: envelope.status ?? "ok",
54
- output: Array.isArray(envelope.output) ? envelope.output : [],
55
- requiresApproval: envelope.requiresApproval ? {
56
- type: "approval_request",
57
- prompt: envelope.requiresApproval.prompt,
58
- items: envelope.requiresApproval.items,
59
- ...envelope.requiresApproval.resumeToken ? { resumeToken: envelope.requiresApproval.resumeToken } : {},
60
- ...envelope.requiresApproval.approvalId ? { approvalId: envelope.requiresApproval.approvalId } : {}
61
- } : null
62
- };
63
- }
44
+ if (!envelope.ok) throw new Error(envelope.error?.message ?? "lobster runtime failed");
45
+ if (envelope.status === "needs_input") throw new Error("Lobster input requests are not supported by the OpenClaw Lobster tool yet");
64
46
  return {
65
- ok: false,
66
- error: {
67
- type: envelope.error?.type,
68
- message: envelope.error?.message ?? "lobster runtime failed"
69
- }
47
+ ok: true,
48
+ status: envelope.status ?? "ok",
49
+ output: Array.isArray(envelope.output) ? envelope.output : [],
50
+ requiresApproval: envelope.requiresApproval ? {
51
+ type: "approval_request",
52
+ prompt: envelope.requiresApproval.prompt,
53
+ items: envelope.requiresApproval.items,
54
+ ...envelope.requiresApproval.resumeToken ? { resumeToken: envelope.requiresApproval.resumeToken } : {},
55
+ ...envelope.requiresApproval.approvalId ? { approvalId: envelope.requiresApproval.approvalId } : {}
56
+ } : null
70
57
  };
71
58
  }
72
- function throwOnErrorEnvelope(envelope) {
73
- if (envelope.ok) return envelope;
74
- throw new Error(envelope.error.message);
75
- }
76
- async function resolveWorkflowFile(candidate, cwd) {
77
- const resolved = path.isAbsolute(candidate) ? candidate : path.resolve(cwd, candidate);
78
- if (!(await stat(resolved)).isFile()) throw new Error("Workflow path is not a file");
79
- const ext = path.extname(resolved).toLowerCase();
80
- if (!workflowExts.has(ext)) throw new Error("Workflow file must end in .lobster, .yaml, .yml, or .json");
81
- return resolved;
82
- }
83
59
  function isMissingPathError(error) {
84
60
  return typeof error === "object" && error !== null && "code" in error && error.code === "ENOENT";
85
61
  }
86
- function hasWorkflowFileExtension(candidate) {
87
- return workflowExts.has(path.extname(candidate).toLowerCase());
88
- }
89
62
  async function detectWorkflowFile(candidate, cwd) {
90
63
  const trimmed = candidate.trim();
91
- if (!trimmed || trimmed.includes("|") || !hasWorkflowFileExtension(trimmed)) return null;
92
- if (!/\s/.test(trimmed)) return await resolveWorkflowFile(trimmed, cwd);
64
+ if (!trimmed || trimmed.includes("|") || !workflowExts.has(path.extname(trimmed).toLowerCase())) return null;
65
+ const resolved = path.isAbsolute(trimmed) ? trimmed : path.resolve(cwd, trimmed);
93
66
  try {
94
- return await resolveWorkflowFile(trimmed, cwd);
67
+ if (!(await stat(resolved)).isFile()) throw new Error("Workflow path is not a file");
68
+ return resolved;
95
69
  } catch (error) {
96
- if (isMissingPathError(error)) return null;
70
+ if (/\s/.test(trimmed) && isMissingPathError(error)) return null;
97
71
  throw error;
98
72
  }
99
73
  }
100
- function parseWorkflowArgs(argsJson) {
101
- return JSON.parse(argsJson);
102
- }
103
74
  function createEmbeddedToolContext(params, signal) {
104
75
  const env = { ...process.env };
105
76
  return {
@@ -127,7 +98,7 @@ async function withTimeout(timeoutMs, fn) {
127
98
  resolve(value);
128
99
  }, (error) => {
129
100
  clearTimeout(timer);
130
- reject(toLintErrorObject(error, "Non-Error rejection"));
101
+ reject(toErrorObject(error, "Non-Error rejection"));
131
102
  });
132
103
  });
133
104
  }
@@ -154,41 +125,34 @@ function createEmbeddedLobsterRunner(options) {
154
125
  const parsedArgsJson = params.argsJson?.trim() ?? "";
155
126
  let args;
156
127
  if (parsedArgsJson) try {
157
- args = parseWorkflowArgs(parsedArgsJson);
128
+ args = JSON.parse(parsedArgsJson);
158
129
  } catch {
159
130
  throw new Error("run --args-json must be valid JSON");
160
131
  }
161
- return throwOnErrorEnvelope(normalizeEnvelope(await runtime.runToolRequest({
132
+ return normalizeEnvelope(await runtime.runToolRequest({
162
133
  filePath,
163
134
  args,
164
135
  ctx
165
- })));
136
+ }));
166
137
  }
167
- return throwOnErrorEnvelope(normalizeEnvelope(await runtime.runToolRequest({
138
+ return normalizeEnvelope(await runtime.runToolRequest({
168
139
  pipeline,
169
140
  ctx
170
- })));
141
+ }));
171
142
  }
172
143
  const token = params.token?.trim() ?? "";
173
144
  const approvalId = params.approvalId?.trim() ?? "";
174
145
  if (!token && !approvalId) throw new Error("token or approvalId required");
175
146
  if (typeof params.approve !== "boolean") throw new Error("approve required");
176
- return throwOnErrorEnvelope(normalizeEnvelope(await runtime.resumeToolRequest({
147
+ return normalizeEnvelope(await runtime.resumeToolRequest({
177
148
  ...token ? { token } : {},
178
149
  ...approvalId ? { approvalId } : {},
179
150
  approved: params.approve,
180
151
  ctx
181
- })));
152
+ }));
182
153
  });
183
154
  } };
184
155
  }
185
- function toLintErrorObject(value, fallbackMessage) {
186
- if (value instanceof Error) return value;
187
- if (typeof value === "string") return new Error(value);
188
- const error = new Error(fallbackMessage, { cause: value });
189
- if (typeof value === "object" && value !== null || typeof value === "function") Object.assign(error, value);
190
- return error;
191
- }
192
156
  //#endregion
193
157
  //#region extensions/lobster/src/lobster-taskflow.ts
194
158
  function toJsonLike(value, seen = /* @__PURE__ */ new WeakSet()) {
@@ -218,51 +182,30 @@ function toJsonLike(value, seen = /* @__PURE__ */ new WeakSet()) {
218
182
  return null;
219
183
  }
220
184
  function buildApprovalWaitState(envelope) {
221
- if (!envelope.requiresApproval) return {
222
- kind: "lobster_approval",
223
- prompt: "",
224
- items: []
225
- };
185
+ const approval = envelope.requiresApproval;
226
186
  return {
227
187
  kind: "lobster_approval",
228
- prompt: envelope.requiresApproval.prompt,
229
- items: envelope.requiresApproval.items.map((item) => toJsonLike(item)),
230
- ...envelope.requiresApproval.resumeToken ? { resumeToken: envelope.requiresApproval.resumeToken } : {},
231
- ...envelope.requiresApproval.approvalId ? { approvalId: envelope.requiresApproval.approvalId } : {}
188
+ prompt: approval ? approval.prompt : "",
189
+ items: approval ? approval.items.map((item) => toJsonLike(item)) : [],
190
+ ...approval?.resumeToken ? { resumeToken: approval.resumeToken } : {},
191
+ ...approval?.approvalId ? { approvalId: approval.approvalId } : {}
232
192
  };
233
193
  }
234
194
  function applyEnvelopeToFlow(params) {
235
195
  const { taskFlow, flow, envelope, waitingStep } = params;
236
- if (!envelope.ok) return taskFlow.fail({
196
+ const flowMutation = {
237
197
  flowId: flow.flowId,
238
198
  expectedRevision: flow.revision
239
- });
199
+ };
200
+ if (!envelope.ok) return taskFlow.fail(flowMutation);
240
201
  if (envelope.status === "needs_approval") return taskFlow.setWaiting({
241
- flowId: flow.flowId,
242
- expectedRevision: flow.revision,
202
+ ...flowMutation,
243
203
  currentStep: waitingStep,
244
204
  waitJson: buildApprovalWaitState(envelope)
245
205
  });
246
- return taskFlow.finish({
247
- flowId: flow.flowId,
248
- expectedRevision: flow.revision
249
- });
250
- }
251
- function buildEnvelopeError(envelope) {
252
- return new Error(envelope.error.message);
206
+ return taskFlow.finish(flowMutation);
253
207
  }
254
- async function runManagedLobsterFlow(params) {
255
- const createFlowParams = {
256
- controllerId: params.controllerId,
257
- goal: params.goal,
258
- currentStep: params.currentStep ?? "run_lobster",
259
- ...params.stateJson !== void 0 ? { stateJson: params.stateJson } : {}
260
- };
261
- const flow = params.taskFlow.tryCreateManaged ? params.taskFlow.tryCreateManaged(createFlowParams) : params.taskFlow.createManaged(createFlowParams);
262
- if (!flow) return {
263
- ok: false,
264
- error: /* @__PURE__ */ new Error("TaskFlow persistence failed.")
265
- };
208
+ async function executeManagedLobsterFlow(params, flow, failureFlowId = flow.flowId) {
266
209
  try {
267
210
  const envelope = await params.runner.run(params.runnerParams);
268
211
  const mutation = applyEnvelopeToFlow({
@@ -275,7 +218,7 @@ async function runManagedLobsterFlow(params) {
275
218
  ok: false,
276
219
  flow,
277
220
  mutation,
278
- error: buildEnvelopeError(envelope)
221
+ error: new Error(envelope.error.message)
279
222
  };
280
223
  return {
281
224
  ok: true,
@@ -290,7 +233,7 @@ async function runManagedLobsterFlow(params) {
290
233
  ok: false,
291
234
  flow,
292
235
  mutation: params.taskFlow.fail({
293
- flowId: flow.flowId,
236
+ flowId: failureFlowId,
294
237
  expectedRevision: flow.revision
295
238
  }),
296
239
  error: err
@@ -304,6 +247,20 @@ async function runManagedLobsterFlow(params) {
304
247
  }
305
248
  }
306
249
  }
250
+ async function runManagedLobsterFlow(params) {
251
+ const createFlowParams = {
252
+ controllerId: params.controllerId,
253
+ goal: params.goal,
254
+ currentStep: params.currentStep ?? "run_lobster",
255
+ ...params.stateJson !== void 0 ? { stateJson: params.stateJson } : {}
256
+ };
257
+ const flow = params.taskFlow.tryCreateManaged ? params.taskFlow.tryCreateManaged(createFlowParams) : params.taskFlow.createManaged(createFlowParams);
258
+ if (!flow) return {
259
+ ok: false,
260
+ error: /* @__PURE__ */ new Error("TaskFlow persistence failed.")
261
+ };
262
+ return await executeManagedLobsterFlow(params, flow);
263
+ }
307
264
  async function resumeManagedLobsterFlow(params) {
308
265
  const resumed = params.taskFlow.resume({
309
266
  flowId: params.flowId,
@@ -316,47 +273,7 @@ async function resumeManagedLobsterFlow(params) {
316
273
  mutation: resumed,
317
274
  error: /* @__PURE__ */ new Error(`TaskFlow resume failed: ${resumed.code}`)
318
275
  };
319
- try {
320
- const envelope = await params.runner.run(params.runnerParams);
321
- const mutation = applyEnvelopeToFlow({
322
- taskFlow: params.taskFlow,
323
- flow: resumed.flow,
324
- envelope,
325
- waitingStep: params.waitingStep ?? "await_lobster_approval"
326
- });
327
- if (!envelope.ok) return {
328
- ok: false,
329
- flow: resumed.flow,
330
- mutation,
331
- error: buildEnvelopeError(envelope)
332
- };
333
- return {
334
- ok: true,
335
- envelope,
336
- flow: resumed.flow,
337
- mutation
338
- };
339
- } catch (error) {
340
- const err = error instanceof Error ? error : new Error(String(error));
341
- try {
342
- const mutation = params.taskFlow.fail({
343
- flowId: params.flowId,
344
- expectedRevision: resumed.flow.revision
345
- });
346
- return {
347
- ok: false,
348
- flow: resumed.flow,
349
- mutation,
350
- error: err
351
- };
352
- } catch {
353
- return {
354
- ok: false,
355
- flow: resumed.flow,
356
- error: err
357
- };
358
- }
359
- }
276
+ return await executeManagedLobsterFlow(params, resumed.flow, params.flowId);
360
277
  }
361
278
  //#endregion
362
279
  //#region extensions/lobster/src/lobster-tool.ts
@@ -434,9 +351,10 @@ function parseResumeFlowParams(params) {
434
351
  ...waitingStep ? { waitingStep } : {}
435
352
  };
436
353
  }
437
- function formatManagedFlowResult(result) {
354
+ function resolveManagedFlowToolResult(result) {
355
+ if (!result.ok) throw result.error;
438
356
  return jsonResult({
439
- ...result.envelope && typeof result.envelope === "object" && !Array.isArray(result.envelope) ? result.envelope : { envelope: result.envelope },
357
+ ...result.envelope,
440
358
  flow: result.flow,
441
359
  mutation: result.mutation
442
360
  });
@@ -445,10 +363,6 @@ function requireTaskFlowRuntime(taskFlow, action) {
445
363
  if (!taskFlow) throw new Error(`Managed TaskFlow ${action} mode requires a bound taskFlow runtime`);
446
364
  return taskFlow;
447
365
  }
448
- function resolveManagedFlowToolResult(result) {
449
- if (!result.ok) throw result.error;
450
- return formatManagedFlowResult(result);
451
- }
452
366
  function createLobsterTool(api, options) {
453
367
  const runner = options?.runner ?? createEmbeddedLobsterRunner();
454
368
  return {
@@ -30,11 +30,11 @@ jobs:
30
30
  matrix:
31
31
  node-version: ['20', '22', '24', '26']
32
32
  steps:
33
- - uses: actions/checkout@v7
33
+ - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
34
34
  with:
35
35
  persist-credentials: false
36
36
 
37
- - uses: actions/setup-node@v6
37
+ - uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v7.0.0
38
38
  with:
39
39
  node-version: ${{ matrix.node-version }}
40
40
  cache: 'npm'
@@ -54,11 +54,11 @@ jobs:
54
54
  matrix:
55
55
  node-version: ['16', '18', '20', '22', '24', '26']
56
56
  steps:
57
- - uses: actions/checkout@v7
57
+ - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
58
58
  with:
59
59
  persist-credentials: false
60
60
 
61
- - uses: actions/setup-node@v6
61
+ - uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v7.0.0
62
62
  with:
63
63
  node-version: ${{ matrix.node-version }}
64
64
  cache: 'npm'
@@ -77,11 +77,11 @@ jobs:
77
77
  permissions:
78
78
  contents: read
79
79
  steps:
80
- - uses: actions/checkout@v7
80
+ - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
81
81
  with:
82
82
  persist-credentials: false
83
83
 
84
- - uses: actions/setup-node@v6
84
+ - uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v7.0.0
85
85
  with:
86
86
  node-version: '10'
87
87
  cache: 'npm'
@@ -119,11 +119,11 @@ jobs:
119
119
  permissions:
120
120
  contents: read
121
121
  steps:
122
- - uses: actions/checkout@v7
122
+ - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
123
123
  with:
124
124
  persist-credentials: false
125
125
 
126
- - uses: actions/setup-node@v6
126
+ - uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v7.0.0
127
127
  with:
128
128
  node-version: '24'
129
129
  cache: 'npm'
@@ -147,7 +147,7 @@ jobs:
147
147
  permissions:
148
148
  contents: write
149
149
  pull-requests: write
150
- uses: fastify/workflows/.github/workflows/plugins-ci.yml@v6
150
+ uses: fastify/workflows/.github/workflows/plugins-ci.yml@2073dc8e1f9e172bf42daa3843c9dbd31af1e8cb # v6.0.0
151
151
  with:
152
152
  license-check: true
153
153
  lint: true
@@ -16,4 +16,4 @@ jobs:
16
16
  permissions:
17
17
  issues: write
18
18
  pull-requests: write
19
- uses: fastify/workflows/.github/workflows/lock-threads.yml@v6
19
+ uses: fastify/workflows/.github/workflows/lock-threads.yml@2073dc8e1f9e172bf42daa3843c9dbd31af1e8cb # v6.0.0
@@ -0,0 +1,45 @@
1
+ name: OSSF Scorecard Analysis
2
+
3
+ # **What it does**: Runs OSSF Scorecard analysis on the repository and uploads the results.
4
+ # **Why we have it**: Security scanning.
5
+
6
+ on:
7
+ branch_protection_rule:
8
+ push:
9
+ branches:
10
+ - main
11
+ paths-ignore:
12
+ - "docs/**"
13
+ - "*.md"
14
+ schedule:
15
+ # ┌───────────── minute (0 - 59)
16
+ # │ ┌───────────── hour (0 - 23)
17
+ # │ │ ┌───────────── day of the month (1 - 31)
18
+ # │ │ │ ┌───────────── month (1 - 12 or JAN-DEC)
19
+ # │ │ │ │ ┌───────────── day of the week (0 - 6 or SUN-SAT)
20
+ # │ │ │ │ │
21
+ # │ │ │ │ │
22
+ # │ │ │ │ │
23
+ # * * * * *
24
+ - cron: "21 17 * * 0"
25
+ # Allows this workflow to be run manually from the Actions tab
26
+ workflow_dispatch:
27
+
28
+ # This allows a subsequently queued workflow run to interrupt previous runs
29
+ concurrency:
30
+ group: "${{ github.workflow }}-${{ github.event.pull_request.head.label || github.head_ref || github.ref }}"
31
+ cancel-in-progress: true
32
+
33
+ permissions:
34
+ contents: read
35
+
36
+ jobs:
37
+ analysis:
38
+ name: OSSF Scorecard Analysis
39
+ permissions:
40
+ contents: read
41
+ id-token: write
42
+ security-events: write
43
+ uses: fastify/workflows/.github/workflows/reusable-ossf-scorecard.yml@ef591e2186785d5ab36b9fe6a79c7ce2f1d94e57 #v7.0.0
44
+ with:
45
+ publish_results: true
@@ -3,6 +3,7 @@
3
3
  [![NPM version](https://img.shields.io/npm/v/fast-uri.svg?style=flat)](https://www.npmjs.com/package/fast-uri)
4
4
  [![CI](https://github.com/fastify/fast-uri/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/fastify/fast-uri/actions/workflows/ci.yml)
5
5
  [![neostandard javascript style](https://img.shields.io/badge/code_style-neostandard-brightgreen?style=flat)](https://github.com/neostandard/neostandard)
6
+ [![OSSF Scorecard](https://api.scorecard.dev/projects/github.com/fastify/fast-uri/badge)](https://scorecard.dev/viewer/?uri=github.com/fastify/fast-uri)
6
7
 
7
8
  Dependency-free RFC 3986 URI toolbox.
8
9
 
@@ -0,0 +1,168 @@
1
+ # Security Policy
2
+
3
+ This document describes the management of vulnerabilities for `fast-uri`, an
4
+ official Fastify project package. It supplements the Fastify project's
5
+ [organization-wide security policy](https://github.com/fastify/.github/blob/main/SECURITY.md).
6
+
7
+ ## Standards and scope
8
+
9
+ `fast-uri` implements URI parsing and normalization according to
10
+ [RFC 3986](https://www.rfc-editor.org/rfc/rfc3986). It does not implement the
11
+ [WHATWG URL Standard](https://url.spec.whatwg.org/).
12
+
13
+ Differences between `fast-uri` and WHATWG URL implementations are expected.
14
+ Reports based on comparing or mixing parsers that follow these different
15
+ standards are out of scope. Applications must use the same parsing and
16
+ normalization rules for both security decisions and subsequent URI use.
17
+
18
+ ## Threat model
19
+
20
+ `fast-uri`'s threat model extends the
21
+ [Node.js threat model](https://github.com/nodejs/node/blob/main/SECURITY.md#the-nodejs-threat-model).
22
+
23
+ **Trusted:** Application code, parser options, configuration, and the runtime
24
+ environment.
25
+
26
+ **Untrusted:** URI and IRI strings passed to the package's public APIs.
27
+
28
+ ### Examples of vulnerabilities
29
+
30
+ - RFC 3986 parsing or normalization flaws that bypass security controls
31
+ - Denial of service through malformed input
32
+ - Inconsistent parsing or normalization between `fast-uri` APIs
33
+
34
+ ### Examples of non-vulnerabilities
35
+
36
+ The following are **not** considered vulnerabilities in `fast-uri`:
37
+
38
+ - **Different URL standards:** Differences between RFC 3986 behavior and
39
+ WHATWG URL behavior, including differences exposed by mixing parsers that
40
+ implement those standards
41
+ - **Unsupported scheme semantics:** Scheme-specific behavior for schemes that
42
+ `fast-uri` does not document as supported
43
+ - **Application code vulnerabilities:** Security flaws in code that consumes
44
+ `fast-uri` output
45
+ - **Configuration mistakes:** Security issues caused by incorrect parser
46
+ options or application configuration
47
+ - **Missing security features:** Application-level protections that are not
48
+ part of URI parsing or normalization
49
+ - **Third-party dependencies:** Vulnerabilities in packages used by an
50
+ application alongside `fast-uri`
51
+
52
+ ## Reporting vulnerabilities
53
+
54
+ Individuals who find potential vulnerabilities in `fast-uri` are invited to
55
+ complete a vulnerability report via the
56
+ [GitHub Security page][advisory].
57
+
58
+ Do not assign or request a CVE directly.
59
+ CVE assignment is handled by the Fastify Security Team.
60
+ Fastify falls under the [OpenJS CNA](https://cna.openjsf.org/).
61
+ A CVE will be assigned as part of our responsible disclosure process.
62
+
63
+ > [!NOTE]
64
+ > Fastify's [HackerOne](https://hackerone.com/fastify) program is now closed.
65
+
66
+ [advisory]: ../../security/advisories/new
67
+
68
+ ### Strict measures when reporting vulnerabilities
69
+
70
+ It is of the utmost importance that you read carefully and follow these
71
+ guidelines to ensure the ecosystem as a whole is not disrupted due to
72
+ improperly reported vulnerabilities:
73
+
74
+ - Avoid creating new "informative" reports. Only create a new report if you are
75
+ confident the issue is an actual vulnerability. Third-party vendors and
76
+ individuals track new GitHub security reports and may flag them for their
77
+ customers.
78
+ - Security reports should never be created and triaged by the same person. A
79
+ second Security Team member must triage a report submitted by a team member
80
+ or on their behalf. If in doubt, invite more Fastify collaborators to help
81
+ review the report.
82
+ - **Do not** attempt to demonstrate CI/CD vulnerabilities by creating pull
83
+ requests in Fastify organization repositories. Doing so will result in a
84
+ [content report][content-report] to GitHub as an unsolicited exploit. Create
85
+ a separate repository configured like the affected repository and provide
86
+ the proof of concept there instead.
87
+
88
+ [content-report]: https://docs.github.com/en/communities/maintaining-your-safety-on-github/reporting-abuse-or-spam#reporting-an-issue-or-pull-request
89
+
90
+ ### Vulnerabilities found outside this process
91
+
92
+ The Fastify project does not support vulnerability reporting outside the
93
+ process described in this document.
94
+
95
+ ## Handling vulnerability reports
96
+
97
+ When a potential vulnerability is reported, the following actions are taken.
98
+
99
+ ### Triage
100
+
101
+ **Delay:** 4 business days
102
+
103
+ Within 4 business days, a member of the Security Team provides a first response
104
+ to the reporter. The possible responses are:
105
+
106
+ - **Acceptance:** The report is considered a new vulnerability.
107
+ - **Rejection:** The report is not considered a new vulnerability.
108
+ - **Need more information:** The Security Team needs more information to
109
+ evaluate the report.
110
+
111
+ Triaging should include updating these issue fields:
112
+
113
+ - Asset: set or create the module affected by the report
114
+ - Severity: TBD, initially left empty
115
+
116
+ ### Correction follow-up
117
+
118
+ **Delay:** 90 days
119
+
120
+ When a vulnerability is confirmed, a member of the Security Team volunteers to
121
+ follow up on the report.
122
+
123
+ With the reporter's help, they contact the maintainers of the vulnerable
124
+ package and may invite them as participants in the report. Together, they
125
+ define a publication date. Ideally, publication should not happen before the
126
+ package has been patched.
127
+
128
+ The report's vulnerable-version upper limit should be set to:
129
+
130
+ - `*` if no fixed version is available when the report is published
131
+ - the last vulnerable version, such as `<=1.2.3`, if the fix is released in
132
+ `1.2.4`
133
+
134
+ ### Publication
135
+
136
+ **Delay:** 90 days
137
+
138
+ Within 90 days after triage, the vulnerability must be made public.
139
+
140
+ Vulnerability severity is assessed using
141
+ [CVSS v3](https://www.first.org/cvss/user-guide).
142
+
143
+ If package maintainers are actively developing a patch, the Security Team and
144
+ the reporter may approve an additional delay.
145
+
146
+ ### Secondary contact
147
+
148
+ If you do not receive an acknowledgment within 6 business days, or cannot find
149
+ a private security contact, contact the OpenJS Foundation CNA at
150
+ <https://cna.openjsf.org/> or `security@lists.openjsf.org` for assistance.
151
+
152
+ The CNA can help ensure that reports are acknowledged, coordinate disclosure
153
+ timelines, and assign CVEs when necessary.
154
+
155
+ ## The Fastify Security Team
156
+
157
+ The core team manages the security program, policy, and process.
158
+
159
+ Team members must keep all privileged information private. This includes the
160
+ existence of undisclosed issues, expected release dates, and upcoming patches.
161
+
162
+ ### Members
163
+
164
+ - [Matteo Collina](https://github.com/mcollina)
165
+ - [Tomas Della Vedova](https://github.com/delvedor)
166
+ - [Vincent Le Goff](https://github.com/zekth)
167
+ - [KaKa Ng](https://github.com/climba03003)
168
+ - [James Sumners](https://github.com/jsumners)
@@ -26,7 +26,12 @@ function normalize (uri, options) {
26
26
  */
27
27
  function resolve (baseURI, relativeURI, options) {
28
28
  const schemelessOptions = options ? Object.assign({ scheme: 'null' }, options) : { scheme: 'null' }
29
- const resolved = resolveComponent(parse(baseURI, schemelessOptions), parse(relativeURI, schemelessOptions), schemelessOptions, true)
29
+ const { parsed: baseParsed, malformedAuthorityOrPort: baseMalformed } = parseWithStatus(baseURI, schemelessOptions)
30
+ const { parsed: relativeParsed, malformedAuthorityOrPort: relativeMalformed } = parseWithStatus(relativeURI, schemelessOptions)
31
+ if (baseMalformed || relativeMalformed) {
32
+ throw new Error(baseParsed.error || relativeParsed.error || 'URI is malformed.')
33
+ }
34
+ const resolved = resolveComponent(baseParsed, relativeParsed, schemelessOptions, true)
30
35
  schemelessOptions.skipEscape = true
31
36
  return serialize(resolved, schemelessOptions)
32
37
  }
@@ -206,6 +211,15 @@ const URI_PARSE = /^(?:([^#/:?]+):)?(?:\/\/((?:([^#/?@]*)@)?(\[[^#/?\]]+\]|[^#/:
206
211
  // with or without a scheme prefix, for the literal-backslash rejection below.
207
212
  const AUTHORITY_PREFIX = /^(?:[^#/:?]+:)?\/\/([^/?#]*)/
208
213
 
214
+ // Captures the leading authority-introducer region after an optional scheme: a
215
+ // run of forward slashes, backslashes, and the characters the WHATWG URL parser
216
+ // removes before parsing (TAB U+0009, LF U+000A, CR U+000D). A valid introducer
217
+ // is exactly "//". Node treats "\" as "/" on special schemes and strips those
218
+ // characters first, so forms like "\\", "/\", "\/", "/<TAB>/", or a leading
219
+ // "<TAB>//" reach an authority in Node while fast-uri's URI_PARSE folds them into
220
+ // the path group (host confusion / SSRF / redirect bypass).
221
+ const AUTHORITY_INTRODUCER_REGION = /^(?:[^#/:?]+:)?([/\\\t\n\r]*)/
222
+
209
223
  /**
210
224
  * @param {import('./types/index').URIComponent} parsed
211
225
  * @param {RegExpMatchArray} matches
@@ -265,6 +279,28 @@ function parseWithStatus (uri, opts) {
265
279
  malformedAuthorityOrPort = true
266
280
  }
267
281
 
282
+ // Reject a malformed or whitespace-smuggled authority introducer. fast-uri
283
+ // only recognizes a literal "//"; anything else in the leading separator run
284
+ // (a backslash, or a "//" that appears only after removing the TAB/LF/CR that
285
+ // Node strips) means the authority fast-uri parses differs from the one Node's
286
+ // URL resolves. Reject rather than rewrite, mirroring the literal-backslash
287
+ // guard above. Percent-encoded forms (%5C, %09) are untouched, valid data.
288
+ const introducerMatch = uri.match(AUTHORITY_INTRODUCER_REGION)
289
+ if (introducerMatch !== null) {
290
+ const region = introducerMatch[1]
291
+ const normalizedRegion = region.replace(/[\t\n\r]/g, '')
292
+ // Two or more leading separators introduce an authority.
293
+ if (normalizedRegion.length >= 2) {
294
+ if (normalizedRegion.slice(0, 2) !== '//') {
295
+ parsed.error = parsed.error || 'URI authority must not contain a literal backslash.'
296
+ malformedAuthorityOrPort = true
297
+ } else if (region.length !== normalizedRegion.length) {
298
+ parsed.error = parsed.error || 'URI authority introducer must not contain whitespace.'
299
+ malformedAuthorityOrPort = true
300
+ }
301
+ }
302
+ }
303
+
268
304
  const matches = uri.match(URI_PARSE)
269
305
 
270
306
  if (matches) {
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "fast-uri",
3
3
  "description": "Dependency-free RFC 3986 URI toolbox",
4
- "version": "4.1.1",
4
+ "version": "4.1.2",
5
5
  "main": "index.js",
6
6
  "type": "commonjs",
7
7
  "types": "types/index.d.ts",
@@ -221,3 +221,139 @@ test('parse does not reject a literal backslash in the query or fragment', (t) =
221
221
  t.notOk(parsed.error, 'backslash in query/fragment does not mark the URI malformed')
222
222
  t.equal(parsed.host, 'host.example.com', 'host parsed normally')
223
223
  })
224
+
225
+ test('parse rejects a malformed authority introducer (\\\\, /\\, \\/) in place of //', (t) => {
226
+ // Regression: "\\", "/\\", "\\/" after the scheme colon are not valid authority
227
+ // introducers. Node's URL treats "\\" as interchangeable with "/" on special
228
+ // schemes, so "http:\\\\evil.com/path" would be parsed as host "evil.com" by
229
+ // Node, but fast-uri must reject it as malformed to prevent SSRF/redirect bypass.
230
+ const cases = [
231
+ 'http:\\\\evil.com/path',
232
+ 'http:/\\evil.com/path',
233
+ 'http:\\/evil.com/path',
234
+ 'ws:\\\\evil.com/chat',
235
+ 'wss:\\\\evil.com/chat',
236
+ 'ftp:\\\\evil.com/',
237
+ '\\\\evil.com/path'
238
+ ]
239
+
240
+ t.plan(cases.length)
241
+
242
+ cases.forEach((input) => {
243
+ t.equal(
244
+ fastURI.parse(input).error,
245
+ 'URI authority must not contain a literal backslash.',
246
+ input
247
+ )
248
+ })
249
+ })
250
+
251
+ test('normalize does not canonicalize a malformed-authority-introducer URI', (t) => {
252
+ const cases = [
253
+ 'http:\\\\evil.com/path',
254
+ 'http:/\\evil.com/path'
255
+ ]
256
+
257
+ t.plan(cases.length)
258
+
259
+ cases.forEach((input) => {
260
+ t.equal(fastURI.normalize(input), input, input)
261
+ })
262
+ })
263
+
264
+ test('equal returns false for malformed-authority-introducer URIs', (t) => {
265
+ const pairs = [
266
+ ['http:\\\\evil.com/path', 'http://evil.com/path'],
267
+ ['http:/\\evil.com/path', 'http://evil.com/path']
268
+ ]
269
+
270
+ t.plan(pairs.length)
271
+
272
+ pairs.forEach(([left, right]) => {
273
+ t.equal(fastURI.equal(left, right), false, `${left} != ${right}`)
274
+ })
275
+ })
276
+
277
+ test('resolve throws on malformed authority introducer', (t) => {
278
+ // resolve() returns a plain string with no error field, so the only safe
279
+ // behavior is to throw when either component has a malformed authority.
280
+ const pairs = [
281
+ ['https://allowed.com/', '\\\\evil.com/path'],
282
+ ['\\\\evil.com/path', 'https://allowed.com/'],
283
+ ['https://allowed.com/', 'http:/\\evil.com/path'],
284
+ ['https://allowed.com/', 'http:\\/evil.com/path']
285
+ ]
286
+
287
+ t.plan(pairs.length)
288
+
289
+ pairs.forEach(([base, rel]) => {
290
+ t.throws(
291
+ () => fastURI.resolve(base, rel),
292
+ /URI authority must not contain a literal backslash/,
293
+ `${base} + ${rel}`
294
+ )
295
+ })
296
+ })
297
+
298
+ test('parse rejects a whitespace-split authority introducer (TAB, LF, CR)', (t) => {
299
+ // The WHATWG URL parser removes TAB (U+0009), LF (U+000A) and CR (U+000D) from
300
+ // the input before parsing, so a stripped character wedged into the introducer
301
+ // ("/<TAB>\\", "/<TAB>/", or a leading "<TAB>//") reaches an authority in Node
302
+ // while fast-uri would otherwise fold it into the path. These must be rejected
303
+ // like the adjacent "\\", "/\\", "\\/" forms.
304
+ const cases = [
305
+ { input: '/\t\\evil.com/path', expectedError: 'URI authority must not contain a literal backslash.' },
306
+ { input: '/\t/evil.com/path', expectedError: 'URI authority introducer must not contain whitespace.' },
307
+ { input: '/\n\\evil.com/path', expectedError: 'URI authority must not contain a literal backslash.' },
308
+ { input: '/\r\\evil.com/path', expectedError: 'URI authority must not contain a literal backslash.' },
309
+ { input: '\t//evil.com/path', expectedError: 'URI authority introducer must not contain whitespace.' },
310
+ { input: '\t/\\evil.com/path', expectedError: 'URI authority must not contain a literal backslash.' },
311
+ { input: 'https:/\t/evil.com/path', expectedError: 'URI authority introducer must not contain whitespace.' }
312
+ ]
313
+
314
+ t.plan(cases.length)
315
+
316
+ cases.forEach(({ input, expectedError }) => {
317
+ t.equal(fastURI.parse(input).error, expectedError, JSON.stringify(input))
318
+ })
319
+ })
320
+
321
+ test('resolve throws on a whitespace-split authority introducer', (t) => {
322
+ const pairs = [
323
+ ['https://allowed.com/', '/\t\\evil.com/path'],
324
+ ['https://allowed.com/', '/\t/evil.com/path'],
325
+ ['https://allowed.com/', '/\n\\evil.com/path'],
326
+ ['/\t/evil.com/path', 'https://allowed.com/']
327
+ ]
328
+
329
+ t.plan(pairs.length)
330
+
331
+ pairs.forEach(([base, rel]) => {
332
+ t.throws(
333
+ () => fastURI.resolve(base, rel),
334
+ /URI authority (must not contain a literal backslash|introducer must not contain whitespace)/,
335
+ `${JSON.stringify(base)} + ${JSON.stringify(rel)}`
336
+ )
337
+ })
338
+ })
339
+
340
+ test('parse does not reject valid authority introducer patterns', (t) => {
341
+ // No false positives: "//" introducer and scheme-less "//" must be valid.
342
+ const cases = [
343
+ 'http://good.com/',
344
+ 'https://good.com/',
345
+ 'ws://good.com/chat',
346
+ 'wss://good.com/chat',
347
+ 'ftp://good.com/',
348
+ '//good.com/path',
349
+ '/absolute/path',
350
+ 'relative/path'
351
+ ]
352
+
353
+ t.plan(cases.length)
354
+
355
+ cases.forEach((input) => {
356
+ const parsed = fastURI.parse(input)
357
+ t.notOk(parsed.error, input)
358
+ })
359
+ })
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@openclaw/lobster",
3
- "version": "2026.7.2-beta.7",
3
+ "version": "2026.8.1-beta.2",
4
4
  "description": "Lobster workflow tool plugin for typed pipelines and resumable approvals.",
5
5
  "repository": {
6
6
  "type": "git",
@@ -21,10 +21,10 @@
21
21
  "minHostVersion": ">=2026.4.25"
22
22
  },
23
23
  "compat": {
24
- "pluginApi": ">=2026.7.2-beta.7"
24
+ "pluginApi": ">=2026.8.1-beta.2"
25
25
  },
26
26
  "build": {
27
- "openclawVersion": "2026.7.2-beta.7"
27
+ "openclawVersion": "2026.8.1-beta.2"
28
28
  },
29
29
  "release": {
30
30
  "publishToClawHub": true,
@@ -41,7 +41,7 @@
41
41
  "SKILL.md"
42
42
  ],
43
43
  "peerDependencies": {
44
- "openclaw": ">=2026.7.2-beta.7"
44
+ "openclaw": ">=2026.8.1-beta.2"
45
45
  },
46
46
  "peerDependenciesMeta": {
47
47
  "openclaw": {