@theia/ai-ide 1.76.0-next.18 → 1.76.0-next.23

package/lib/common/user-interaction-tool.js

@@ -97,49 +97,80 @@ function parseUserInteractionResult(raw) {
     }
     return obj;
 }
+const JSON_ENCODING_HINT = 'Do not JSON-encode nested values - pass real arrays and objects.';
+function describeType(value) {
+    // eslint-disable-next-line no-null/no-null
+    if (value === null) {
+        return 'null';
+    }
+    if (Array.isArray(value)) {
+        return 'array';
+    }
+    return typeof value;
+}
+/**
+ * Describe the received type, adding the JSON-encoding hint when a string was received where
+ * a structured value was expected - by far the most common way agents get these arguments wrong.
+ */
+function describeReceived(value) {
+    const type = describeType(value);
+    return type === 'string' ? `${type}. ${JSON_ENCODING_HINT}` : `${type}.`;
+}
 function parseUserInteractionArgs(args) {
     if (!args) {
-        return undefined;
+        return { ok: false, error: 'No arguments were provided.' };
     }
+    let parsed;
     try {
-        const parsed = JSON.parse(args);
-        if (!Array.isArray(parsed.interactions)) {
-            return undefined;
-        }
-        const validSteps = parsed.interactions
-            .map(parseStep)
-            .filter((step) => step !== undefined);
-        if (validSteps.length === 0) {
-            return undefined;
-        }
-        return { interactions: validSteps };
+        parsed = JSON.parse(args);
     }
     catch {
-        return undefined;
+        return { ok: false, error: 'Arguments are not valid JSON.' };
+    }
+    if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
+        return { ok: false, error: `Arguments must be an object with an "interactions" array, received ${describeReceived(parsed)}` };
+    }
+    const interactions = parsed.interactions;
+    if (!Array.isArray(interactions)) {
+        return { ok: false, error: `"interactions" must be an array of step objects, received ${describeReceived(interactions)}` };
+    }
+    if (interactions.length === 0) {
+        return { ok: false, error: '"interactions" must contain at least one step.' };
     }
+    const steps = [];
+    for (let index = 0; index < interactions.length; index++) {
+        const step = parseStep(interactions[index], index + 1);
+        if (!step.ok) {
+            return step;
+        }
+        steps.push(step.step);
+    }
+    return { ok: true, args: { interactions: steps } };
 }
-function parseStep(raw) {
-    if (!raw || typeof raw !== 'object') {
-        return undefined;
+function parseStep(raw, position) {
+    if (!raw || typeof raw !== 'object' || Array.isArray(raw)) {
+        return { ok: false, error: `Step ${position}: expected a step object, received ${describeReceived(raw)}` };
     }
     const obj = raw;
     if (typeof obj.title !== 'string' || typeof obj.message !== 'string') {
-        return undefined;
+        return { ok: false, error: `Step ${position}: "title" and "message" are required strings.` };
     }
-    let options;
-    if (Array.isArray(obj.options)) {
-        const validOptions = obj.options.filter((opt) => !!opt && typeof opt === 'object'
-            && typeof opt.text === 'string'
-            && typeof opt.value === 'string');
-        options = validOptions.length > 0 ? validOptions : undefined;
+    const options = parseOptions(obj.options, position);
+    if (!options.ok) {
+        return options;
     }
     let links;
-    if (Array.isArray(obj.links)) {
-        const filtered = obj.links
+    // eslint-disable-next-line no-null/no-null
+    const rawLinks = obj.links === null ? undefined : obj.links;
+    if (Array.isArray(rawLinks)) {
+        const filtered = rawLinks
             .map(normalizeUserInteractionLink)
             .filter((link) => link !== undefined);
         links = filtered.length > 0 ? filtered : undefined;
     }
+    else if (rawLinks !== undefined) {
+        return { ok: false, error: `Step ${position}: "links" must be an array of link objects, received ${describeReceived(rawLinks)}` };
+    }
     else {
         const link = normalizeUserInteractionLink(obj.link);
         if (link) {
@@ -147,12 +178,52 @@ function parseStep(raw) {
         }
     }
     return {
-        title: obj.title,
-        message: obj.message,
-        options,
-        links
+        ok: true,
+        step: {
+            title: obj.title,
+            message: obj.message,
+            options: options.options,
+            links
+        }
     };
 }
+/**
+ * Validate a step's `options`. An absent or explicitly empty list means the step is
+ * informational; anything else must be a fully well-formed array, since a partially
+ * dropped option would silently offer the user a different choice than the agent intended.
+ */
+function parseOptions(raw, stepPosition) {
+    // eslint-disable-next-line no-null/no-null
+    if (raw === undefined || raw === null) {
+        return { ok: true, options: undefined };
+    }
+    if (!Array.isArray(raw)) {
+        return {
+            ok: false,
+            error: `Step ${stepPosition}: "options" must be an array of {text, value} objects, received ${describeReceived(raw)}`
+        };
+    }
+    const options = [];
+    for (let index = 0; index < raw.length; index++) {
+        const candidate = raw[index];
+        const obj = candidate;
+        if (!obj || typeof obj !== 'object' || Array.isArray(obj) || typeof obj.text !== 'string' || typeof obj.value !== 'string') {
+            return {
+                ok: false,
+                error: `Step ${stepPosition}, option ${index + 1}: "text" and "value" are required strings, received ${describeReceived(candidate)}`
+            };
+        }
+        const option = { text: obj.text, value: obj.value };
+        if (typeof obj.description === 'string') {
+            option.description = obj.description;
+        }
+        if (typeof obj.buttonLabel === 'string') {
+            option.buttonLabel = obj.buttonLabel;
+        }
+        options.push(option);
+    }
+    return { ok: true, options: options.length > 0 ? options : undefined };
+}
 function normalizeContentRef(ref) {
     if (typeof ref === 'string') {
         return ref.length > 0 ? ref : undefined;

package/lib/common/user-interaction-tool.js.map

@@ -1 +1 @@
-{"version":3,"file":"user-interaction-tool.js","sourceRoot":"","sources":["../../src/common/user-interaction-tool.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"user-interaction-tool.js","sourceRoot":"","sources":["../../src/common/user-interaction-tool.ts"],"names":[],"mappings":"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"}

package/lib/common/user-interaction-tool.spec.js

@@ -17,185 +17,222 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const chai_1 = require("chai");
 const user_interaction_tool_1 = require("./user-interaction-tool");
+function expectRejected(input) {
+    const result = (0, user_interaction_tool_1.parseUserInteractionArgs)(input);
+    (0, chai_1.expect)(result.ok, `expected a rejection but got: ${JSON.stringify(result)}`).to.be.false;
+    return result.error;
+}
+function expectAccepted(input) {
+    const result = (0, user_interaction_tool_1.parseUserInteractionArgs)(input);
+    (0, chai_1.expect)(result.ok, `expected acceptance but got: ${JSON.stringify(result)}`).to.be.true;
+    return result.args;
+}
 describe('parseUserInteractionArgs', () => {
-    it('should return undefined for undefined input', () => {
-        (0, chai_1.expect)((0, user_interaction_tool_1.parseUserInteractionArgs)(undefined)).to.be.undefined;
-    });
-    it('should return undefined for invalid JSON', () => {
-        (0, chai_1.expect)((0, user_interaction_tool_1.parseUserInteractionArgs)('not json')).to.be.undefined;
-    });
-    it('should return undefined when interactions is missing', () => {
-        const input = JSON.stringify({ foo: 'bar' });
-        (0, chai_1.expect)((0, user_interaction_tool_1.parseUserInteractionArgs)(input)).to.be.undefined;
-    });
-    it('should return undefined when interactions is not an array', () => {
-        const input = JSON.stringify({ interactions: 'nope' });
-        (0, chai_1.expect)((0, user_interaction_tool_1.parseUserInteractionArgs)(input)).to.be.undefined;
-    });
-    it('should return undefined when no step is valid', () => {
-        const input = JSON.stringify({ interactions: [{ foo: 'bar' }, { title: 1 }] });
-        (0, chai_1.expect)((0, user_interaction_tool_1.parseUserInteractionArgs)(input)).to.be.undefined;
-    });
-    it('should drop steps that are missing title or message', () => {
-        const input = JSON.stringify({
-            interactions: [
-                { title: 'Valid', message: 'Hello' },
-                { title: 'No message' },
-                { message: 'No title' }
-            ]
-        });
-        const result = (0, user_interaction_tool_1.parseUserInteractionArgs)(input);
-        (0, chai_1.expect)(result).to.not.be.undefined;
-        (0, chai_1.expect)(result.interactions).to.have.length(1);
-        (0, chai_1.expect)(result.interactions[0].title).to.equal('Valid');
-    });
-    it('should accept a step without options (informational)', () => {
-        const input = JSON.stringify({
-            interactions: [{ title: 'Info', message: 'Just so you know' }]
+    describe('rejecting malformed arguments', () => {
+        it('should reject undefined input', () => {
+            (0, chai_1.expect)(expectRejected(undefined)).to.match(/no arguments/i);
         });
-        const result = (0, user_interaction_tool_1.parseUserInteractionArgs)(input);
-        (0, chai_1.expect)(result).to.not.be.undefined;
-        (0, chai_1.expect)(result.interactions[0].options).to.be.undefined;
-    });
-    it('should filter out invalid options within a step', () => {
-        const input = JSON.stringify({
-            interactions: [{
-                    title: 'T', message: 'M',
-                    options: [{ text: 'A', value: 'a' }, { bad: true }, { text: 'B', value: 'b' }]
-                }]
-        });
-        const result = (0, user_interaction_tool_1.parseUserInteractionArgs)(input);
-        (0, chai_1.expect)(result.interactions[0].options).to.have.length(2);
-    });
-    it('should drop options array if no options are valid', () => {
-        const input = JSON.stringify({
-            interactions: [{
-                    title: 'T', message: 'M',
-                    options: [{ bad: true }]
-                }]
-        });
-        const result = (0, user_interaction_tool_1.parseUserInteractionArgs)(input);
-        (0, chai_1.expect)(result.interactions[0].options).to.be.undefined;
-    });
-    it('should normalize singular link into a links array on a step', () => {
-        const input = JSON.stringify({
-            interactions: [{
-                    title: 'T', message: 'M',
-                    options: [{ text: 'A', value: 'a' }],
-                    link: { ref: 'src/index.ts' }
-                }]
-        });
-        const result = (0, user_interaction_tool_1.parseUserInteractionArgs)(input);
-        (0, chai_1.expect)(result.interactions[0].links).to.deep.equal([{ ref: 'src/index.ts' }]);
-    });
-    it('should accept a links array with multiple entries', () => {
-        const input = JSON.stringify({
-            interactions: [{
-                    title: 'T', message: 'M',
-                    options: [{ text: 'A', value: 'a' }],
-                    links: [
-                        { ref: 'src/a.ts' },
-                        { ref: 'src/old.ts', rightRef: 'src/new.ts' }
-                    ]
-                }]
-        });
-        const result = (0, user_interaction_tool_1.parseUserInteractionArgs)(input);
-        (0, chai_1.expect)(result.interactions[0].links).to.have.length(2);
-    });
-    it('should filter out invalid links from a step', () => {
-        const input = JSON.stringify({
-            interactions: [{
-                    title: 'T', message: 'M',
-                    options: [{ text: 'A', value: 'a' }],
-                    links: [
-                        { ref: 'src/a.ts' },
-                        { noRef: true },
-                        { ref: '' }
-                    ]
-                }]
-        });
-        const result = (0, user_interaction_tool_1.parseUserInteractionArgs)(input);
-        (0, chai_1.expect)(result.interactions[0].links).to.have.length(1);
-    });
-    it('should ignore invalid rightRef placeholders and keep multi-step file links', () => {
-        const emptyRightRefPlaceholder = {
-            path: '',
-            gitRef: '',
-            line: 0,
-            empty: false,
-            label: ''
-        };
-        const input = JSON.stringify({
-            interactions: ['README.md', 'package.json', 'CONTRIBUTING.md'].map((path, index) => ({
-                title: `File link: ${path}`,
-                message: 'Open the file link.',
-                links: [{
-                        ref: { path, gitRef: '', line: 1, empty: false, label: '' },
-                        rightRef: emptyRightRefPlaceholder,
-                        label: `Open ${path}`,
-                        autoOpen: index === 0
+        it('should reject input that is not valid JSON', () => {
+            (0, chai_1.expect)(expectRejected('not json')).to.match(/valid JSON/i);
+        });
+        it('should reject arguments without an interactions property', () => {
+            (0, chai_1.expect)(expectRejected(JSON.stringify({ foo: 'bar' }))).to.match(/"interactions" must be an array of step objects/);
+        });
+        it('should reject a JSON-encoded argument blob and name the received type', () => {
+            const error = expectRejected(JSON.stringify('{"interactions":[{"title":"T","message":"M"}]}'));
+            (0, chai_1.expect)(error).to.match(/arguments must be an object with an "interactions" array, received string/i);
+            (0, chai_1.expect)(error).to.match(/do not JSON-encode nested values/i);
+        });
+        it('should reject a top-level array', () => {
+            (0, chai_1.expect)(expectRejected('[]')).to.match(/arguments must be an object with an "interactions" array, received array/i);
+        });
+        it('should reject top-level null', () => {
+            (0, chai_1.expect)(expectRejected('null')).to.match(/arguments must be an object with an "interactions" array, received null/i);
+        });
+        it('should reject a JSON-encoded interactions string and name the received type', () => {
+            const error = expectRejected(JSON.stringify({ interactions: '[{"title":"T","message":"M"}]' }));
+            (0, chai_1.expect)(error).to.match(/"interactions" must be an array of step objects, received string/);
+            (0, chai_1.expect)(error).to.match(/do not JSON-encode nested values/i);
+        });
+        it('should reject an empty interactions array', () => {
+            (0, chai_1.expect)(expectRejected(JSON.stringify({ interactions: [] }))).to.match(/at least one step/);
+        });
+        it('should reject a step that is missing its message, naming the step position', () => {
+            const error = expectRejected(JSON.stringify({
+                interactions: [{ title: 'Valid', message: 'Hello' }, { title: 'No message' }]
+            }));
+            (0, chai_1.expect)(error).to.match(/step 2: "title" and "message" are required strings/i);
+        });
+        it('should reject a step that is missing its title, naming the step position', () => {
+            const error = expectRejected(JSON.stringify({
+                interactions: [{ message: 'No title' }]
+            }));
+            (0, chai_1.expect)(error).to.match(/step 1: "title" and "message" are required strings/i);
+        });
+        it('should reject a step whose options are a JSON-encoded string', () => {
+            const error = expectRejected(JSON.stringify({
+                interactions: [{ title: 'Apply fix?', message: 'M', options: '[{"text":"Yes","value":"yes"}]' }]
+            }));
+            (0, chai_1.expect)(error).to.match(/step 1: "options" must be an array of \{text, value\} objects, received string/i);
+            (0, chai_1.expect)(error).to.match(/do not JSON-encode nested values/i);
+        });
+        it('should reject a step when a single option is malformed, even though others are valid', () => {
+            const error = expectRejected(JSON.stringify({
+                interactions: [{
+                        title: 'T', message: 'M',
+                        options: [{ text: 'A', value: 'a' }, { label: 'B', value: 'b' }, { text: 'C', value: 'c' }]
                     }]
-            }))
-        });
-        const result = (0, user_interaction_tool_1.parseUserInteractionArgs)(input);
-        (0, chai_1.expect)(result.interactions.map(step => step.links[0])).to.deep.equal([
-            { ref: { path: 'README.md', line: 1 }, label: 'Open README.md', autoOpen: true },
-            { ref: { path: 'package.json', line: 1 }, label: 'Open package.json', autoOpen: false },
-            { ref: { path: 'CONTRIBUTING.md', line: 1 }, label: 'Open CONTRIBUTING.md', autoOpen: false }
-        ]);
-    });
-    it('should accept multiple steps in order', () => {
-        const input = JSON.stringify({
-            interactions: [
-                { title: 'Overview', message: 'PR summary' },
-                { title: 'Area 1', message: 'finding', options: [{ text: 'OK', value: 'approve' }] },
-                { title: 'Area 2', message: 'no findings' }
-            ]
-        });
-        const result = (0, user_interaction_tool_1.parseUserInteractionArgs)(input);
-        (0, chai_1.expect)(result.interactions).to.have.length(3);
-        (0, chai_1.expect)(result.interactions[1].options).to.have.length(1);
-        (0, chai_1.expect)(result.interactions[2].options).to.be.undefined;
-    });
-    it('should preserve buttonLabel in options', () => {
-        const input = JSON.stringify({
-            interactions: [{
-                    title: 'T', message: 'M',
-                    options: [{ text: 'Confirm changes', value: 'confirm', buttonLabel: '✅ Confirm' }]
-                }]
-        });
-        const result = (0, user_interaction_tool_1.parseUserInteractionArgs)(input);
-        (0, chai_1.expect)(result.interactions[0].options[0].buttonLabel).to.equal('✅ Confirm');
-    });
-    it('should reject step links with empty path in object ref', () => {
-        const input = JSON.stringify({
-            interactions: [{
-                    title: 'T', message: 'M',
-                    links: [{ ref: { path: '' } }]
-                }]
-        });
-        const result = (0, user_interaction_tool_1.parseUserInteractionArgs)(input);
-        (0, chai_1.expect)(result.interactions[0].links).to.be.undefined;
+            }));
+            (0, chai_1.expect)(error).to.match(/step 1, option 2: "text" and "value" are required strings/i);
+        });
+        it('should reject options given as an object rather than an array', () => {
+            const error = expectRejected(JSON.stringify({
+                interactions: [{ title: 'T', message: 'M', options: { text: 'Yes', value: 'yes' } }]
+            }));
+            (0, chai_1.expect)(error).to.match(/step 1: "options" must be an array of \{text, value\} objects, received object/i);
+        });
+        it('should reject plain string options and name the received type', () => {
+            const error = expectRejected(JSON.stringify({
+                interactions: [{ title: 'T', message: 'M', options: ['Yes', 'No'] }]
+            }));
+            (0, chai_1.expect)(error).to.match(/step 1, option 1: "text" and "value" are required strings, received string/i);
+            (0, chai_1.expect)(error).to.match(/do not JSON-encode nested values/i);
+        });
+        it('should reject a JSON-encoded links string', () => {
+            const error = expectRejected(JSON.stringify({
+                interactions: [{ title: 'T', message: 'M', links: '[{"ref":"a.ts"}]' }]
+            }));
+            (0, chai_1.expect)(error).to.match(/step 1: "links" must be an array of link objects, received string/i);
+            (0, chai_1.expect)(error).to.match(/do not JSON-encode nested values/i);
+        });
+        it('should report the offending option position within the offending step', () => {
+            const error = expectRejected(JSON.stringify({
+                interactions: [
+                    { title: 'Fine', message: 'M', options: [{ text: 'A', value: 'a' }] },
+                    { title: 'Broken', message: 'M', options: [{ text: 'A', value: 'a' }, { text: 'B' }] }
+                ]
+            }));
+            (0, chai_1.expect)(error).to.match(/step 2, option 2: "text" and "value" are required strings/i);
+        });
     });
-    it('should accept step links with EmptyContentRef', () => {
-        const input = JSON.stringify({
-            interactions: [{
-                    title: 'T', message: 'M',
-                    links: [{ ref: { empty: true, label: 'New file' } }]
-                }]
-        });
-        const result = (0, user_interaction_tool_1.parseUserInteractionArgs)(input);
-        (0, chai_1.expect)(result.interactions[0].links[0].ref).to.deep.equal({ empty: true, label: 'New file' });
+    describe('accepting well-formed arguments', () => {
+        it('should accept a step without options (informational)', () => {
+            const args = expectAccepted(JSON.stringify({
+                interactions: [{ title: 'Info', message: 'Just so you know' }]
+            }));
+            (0, chai_1.expect)(args.interactions[0].options).to.be.undefined;
+        });
+        it('should accept an explicitly empty options array as informational', () => {
+            const args = expectAccepted(JSON.stringify({
+                interactions: [{ title: 'Info', message: 'Just so you know', options: [] }]
+            }));
+            (0, chai_1.expect)(args.interactions[0].options).to.be.undefined;
+        });
+        it('should accept multiple steps in order', () => {
+            const args = expectAccepted(JSON.stringify({
+                interactions: [
+                    { title: 'Overview', message: 'PR summary' },
+                    { title: 'Area 1', message: 'finding', options: [{ text: 'OK', value: 'approve' }] },
+                    { title: 'Area 2', message: 'no findings' }
+                ]
+            }));
+            (0, chai_1.expect)(args.interactions).to.have.length(3);
+            (0, chai_1.expect)(args.interactions[1].options).to.have.length(1);
+            (0, chai_1.expect)(args.interactions[2].options).to.be.undefined;
+        });
+        it('should preserve buttonLabel and description in options', () => {
+            const args = expectAccepted(JSON.stringify({
+                interactions: [{
+                        title: 'T', message: 'M',
+                        options: [{ text: 'Confirm changes', value: 'confirm', description: 'Applies the patch', buttonLabel: '✅ Confirm' }]
+                    }]
+            }));
+            (0, chai_1.expect)(args.interactions[0].options[0].buttonLabel).to.equal('✅ Confirm');
+            (0, chai_1.expect)(args.interactions[0].options[0].description).to.equal('Applies the patch');
+        });
     });
-    it('should accept step links with EmptyContentRef as rightRef', () => {
-        const input = JSON.stringify({
-            interactions: [{
-                    title: 'T', message: 'M',
-                    links: [{ ref: 'src/old.ts', rightRef: { empty: true } }]
-                }]
-        });
-        const result = (0, user_interaction_tool_1.parseUserInteractionArgs)(input);
-        (0, chai_1.expect)(result.interactions[0].links[0].rightRef).to.deep.equal({ empty: true });
+    describe('links remain leniently filtered', () => {
+        it('should normalize a singular link into a links array on a step', () => {
+            const args = expectAccepted(JSON.stringify({
+                interactions: [{
+                        title: 'T', message: 'M',
+                        options: [{ text: 'A', value: 'a' }],
+                        link: { ref: 'src/index.ts' }
+                    }]
+            }));
+            (0, chai_1.expect)(args.interactions[0].links).to.deep.equal([{ ref: 'src/index.ts' }]);
+        });
+        it('should accept a links array with multiple entries', () => {
+            const args = expectAccepted(JSON.stringify({
+                interactions: [{
+                        title: 'T', message: 'M',
+                        links: [{ ref: 'a.ts' }, { ref: 'b.ts', label: 'B' }]
+                    }]
+            }));
+            (0, chai_1.expect)(args.interactions[0].links).to.have.length(2);
+        });
+        it('should drop invalid links from a step without rejecting the step', () => {
+            const args = expectAccepted(JSON.stringify({
+                interactions: [{
+                        title: 'T', message: 'M',
+                        links: [{ ref: 'a.ts' }, { nope: true }, { ref: 42 }]
+                    }]
+            }));
+            (0, chai_1.expect)(args.interactions[0].links).to.have.length(1);
+        });
+        it('should ignore invalid rightRef placeholders and keep multi-step file links', () => {
+            const emptyRightRefPlaceholder = {
+                path: '',
+                gitRef: '',
+                line: 0,
+                empty: false,
+                label: ''
+            };
+            const args = expectAccepted(JSON.stringify({
+                interactions: ['README.md', 'package.json', 'CONTRIBUTING.md'].map((path, index) => ({
+                    title: `File link: ${path}`,
+                    message: 'Open the file link.',
+                    links: [{
+                            ref: { path, gitRef: '', line: 1, empty: false, label: '' },
+                            rightRef: emptyRightRefPlaceholder,
+                            label: `Open ${path}`,
+                            autoOpen: index === 0
+                        }]
+                }))
+            }));
+            (0, chai_1.expect)(args.interactions.map(step => step.links[0])).to.deep.equal([
+                { ref: { path: 'README.md', line: 1 }, label: 'Open README.md', autoOpen: true },
+                { ref: { path: 'package.json', line: 1 }, label: 'Open package.json', autoOpen: false },
+                { ref: { path: 'CONTRIBUTING.md', line: 1 }, label: 'Open CONTRIBUTING.md', autoOpen: false }
+            ]);
+        });
+        it('should drop a link whose object ref has an empty path', () => {
+            const args = expectAccepted(JSON.stringify({
+                interactions: [{
+                        title: 'T', message: 'M',
+                        links: [{ ref: { path: '' } }]
+                    }]
+            }));
+            (0, chai_1.expect)(args.interactions[0].links).to.be.undefined;
+        });
+        it('should accept step links with EmptyContentRef', () => {
+            const args = expectAccepted(JSON.stringify({
+                interactions: [{
+                        title: 'T', message: 'M',
+                        links: [{ ref: { empty: true, label: 'New file' } }]
+                    }]
+            }));
+            (0, chai_1.expect)(args.interactions[0].links[0].ref).to.deep.equal({ empty: true, label: 'New file' });
+        });
+        it('should accept step links with EmptyContentRef as rightRef', () => {
+            const args = expectAccepted(JSON.stringify({
+                interactions: [{
+                        title: 'T', message: 'M',
+                        links: [{ ref: 'src/old.ts', rightRef: { empty: true } }]
+                    }]
+            }));
+            (0, chai_1.expect)(args.interactions[0].links[0].rightRef).to.deep.equal({ empty: true });
+        });
     });
 });
 describe('parseUserInteractionInput', () => {
@@ -217,6 +254,10 @@ describe('parseUserInteractionInput', () => {
         const input = '{"interactions": [{"title": "Streaming Title", "message": "incom';
         (0, chai_1.expect)((0, user_interaction_tool_1.parseUserInteractionInput)(input).title).to.equal('Streaming Title');
     });
+    it('should extract a partial title from JSON truncated mid-title', () => {
+        const input = '{"interactions":[{"title":"Streaming ti';
+        (0, chai_1.expect)((0, user_interaction_tool_1.parseUserInteractionInput)(input)).to.deep.equal({ title: 'Streaming ti', stepCount: 0 });
+    });
     it('should return empty title from incomplete JSON without title field', () => {
         const input = '{"interactions": [{"message": "no title here';
         (0, chai_1.expect)((0, user_interaction_tool_1.parseUserInteractionInput)(input).title).to.equal('');