feat(ql3): add profile-aware run log reads

2026-09-22 10:32:40 +08:00 · 2026-08-12 01:43:14 +08:00
parent c699c32461
commit 308aa75d89
33 changed files with 2880 additions and 306 deletions
@@ -0,0 +1,109 @@
+const assert = require('node:assert/strict');
+const { test } = require('node:test');
+
+const {
+  RunAttemptLogReadUnavailableError,
+} = require('@qinglong/runtime-core/run-attempt-log-read');
+const {
+  createLocalApiRunAttemptLogReadRoute,
+} = require('../dist/run/runAttemptLogReadRoute.js');
+
+function request(overrides = {}) {
+  return {
+    projectId: 'prj_default',
+    runId: 'run_123',
+    attemptId: 'attempt_123',
+    offset: 2,
+    length: 16,
+    ...overrides,
+  };
+}
+
+test('projects an available byte range as bounded base64 JSON', async () => {
+  const route = createLocalApiRunAttemptLogReadRoute({
+    async read(value) {
+      assert.deepEqual(value.range, { offset: 2, length: 16 });
+      return {
+        status: 'available',
+        projectId: value.projectId,
+        runId: value.runId,
+        attemptId: value.attemptId,
+        logArtifactId: `local-${'a'.repeat(30)}`,
+        content: Buffer.from('hello'),
+        start: 2,
+        endExclusive: 7,
+        totalBytes: 9,
+        nextOffset: 7,
+        truncation: { truncated: 'unknown' },
+      };
+    },
+  });
+  assert.deepEqual(await route.handle(request()), {
+    statusCode: 200,
+    body: {
+      schema: 'qinglong/run-attempt-log-read-result@v1',
+      status: 'available',
+      projectId: 'prj_default',
+      runId: 'run_123',
+      attemptId: 'attempt_123',
+      range: { start: 2, endExclusive: 7, totalBytes: 9, nextOffset: 7 },
+      encoding: 'base64',
+      content: Buffer.from('hello').toString('base64'),
+      truncation: { truncated: 'unknown' },
+    },
+  });
+});
+
+test('maps pending, masked absence, missing storage and unavailable evidence', async () => {
+  const cases = [
+    [
+      {
+        status: 'pending',
+        projectId: 'prj_default',
+        runId: 'run_123',
+        attemptId: 'attempt_123',
+      },
+      {
+        statusCode: 202,
+        body: {
+          schema: 'qinglong/run-attempt-log-read-result@v1',
+          status: 'pending',
+          projectId: 'prj_default',
+          runId: 'run_123',
+          attemptId: 'attempt_123',
+        },
+      },
+    ],
+    [
+      { status: 'not_found' },
+      { statusCode: 404, body: { code: 'artifact_not_found' } },
+    ],
+    [
+      {
+        status: 'missing',
+        projectId: 'prj_default',
+        runId: 'run_123',
+        attemptId: 'attempt_123',
+        logArtifactId: `local-${'a'.repeat(30)}`,
+      },
+      { statusCode: 503, body: { code: 'artifact_unavailable' } },
+    ],
+  ];
+  for (const [result, expected] of cases) {
+    const route = createLocalApiRunAttemptLogReadRoute({
+      async read() {
+        return result;
+      },
+    });
+    assert.deepEqual(await route.handle(request()), expected);
+  }
+  const unavailable = createLocalApiRunAttemptLogReadRoute({
+    async read() {
+      throw new RunAttemptLogReadUnavailableError();
+    },
+  });
+  assert.deepEqual(await unavailable.handle(request()), {
+    statusCode: 503,
+    body: { code: 'artifact_unavailable' },
+  });
+});