@c0-ui/protocol 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 c0 contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export type { ArtifactMeta, ArtifactPart, ContentPart, CustomMarkdownPart, MessagePart, ParsedResponse, StreamParser, StreamParserOptions, ThinkItem, } from './types.js';
+export { createStreamParser, parseResponse } from './parser.js';
+export { extractContext, serializeResponse } from './serializer.js';
+export { escapeXml, TAGS, unescapeXml, wrapArtifact, wrapArtifactDiff, wrapContent, wrapContext, wrapCustomMarkdown, wrapThinkItem, } from './tags.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,kBAAkB,EAClB,WAAW,EACX,cAAc,EACd,YAAY,EACZ,mBAAmB,EACnB,SAAS,GACV,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAGhE,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAGpE,OAAO,EACL,SAAS,EACT,IAAI,EACJ,WAAW,EACX,YAAY,EACZ,gBAAgB,EAChB,WAAW,EACX,WAAW,EACX,kBAAkB,EAClB,aAAa,GACd,MAAM,WAAW,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+// Parser
+export { createStreamParser, parseResponse } from './parser.js';
+// Serializer
+export { extractContext, serializeResponse } from './serializer.js';
+// Tag builders
+export { escapeXml, TAGS, unescapeXml, wrapArtifact, wrapArtifactDiff, wrapContent, wrapContext, wrapCustomMarkdown, wrapThinkItem, } from './tags.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAaA,SAAS;AACT,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEhE,aAAa;AACb,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEpE,eAAe;AACf,OAAO,EACL,SAAS,EACT,IAAI,EACJ,WAAW,EACX,YAAY,EACZ,gBAAgB,EAChB,WAAW,EACX,WAAW,EACX,kBAAkB,EAClB,aAAa,GACd,MAAM,WAAW,CAAC"}

package/dist/parser.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Streaming XML-DSL parser for c0.
+ *
+ * Reverse-engineered from C1's xmlParser-B5C8tiiX.js.
+ * Uses htmlparser2 in XML mode for incremental parsing,
+ * and immer for immutable state updates on each chunk.
+ */
+import type { ParsedResponse, StreamParser, StreamParserOptions } from './types.js';
+/**
+ * Create a streaming XML-DSL parser.
+ *
+ * Call `write(chunk)` for each streamed chunk.
+ * Call `getResult()` at any time to get the current parsed state.
+ *
+ * @example
+ * ```ts
+ * const parser = createStreamParser();
+ * parser.write('<content thesys="true">Hello');
+ * parser.write(' world</content>');
+ * const result = parser.getResult();
+ * // result.parts[0] = { type: 'content', data: 'Hello world' }
+ * ```
+ */
+export declare function createStreamParser(options?: StreamParserOptions): StreamParser;
+/**
+ * Parse a complete XML-DSL string in one shot.
+ * Convenience wrapper for non-streaming use cases.
+ */
+export declare function parseResponse(xml: string): ParsedResponse;
+//# sourceMappingURL=parser.d.ts.map

package/dist/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../src/parser.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,KAAK,EAKV,cAAc,EAEd,YAAY,EACZ,mBAAmB,EAGpB,MAAM,YAAY,CAAC;AAuNpB;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,CAAC,EAAE,mBAAmB,GAAG,YAAY,CAkE9E;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,CAIzD"}

package/dist/parser.js

@@ -0,0 +1,274 @@
+/**
+ * Streaming XML-DSL parser for c0.
+ *
+ * Reverse-engineered from C1's xmlParser-B5C8tiiX.js.
+ * Uses htmlparser2 in XML mode for incremental parsing,
+ * and immer for immutable state updates on each chunk.
+ */
+import { Parser } from 'htmlparser2';
+import { produce } from 'immer';
+// ─── Initial State ────────────────────────────────────────
+function initialState() {
+    return {
+        currentTag: undefined,
+        parts: [],
+        think: [],
+        context: '',
+        isContentClosed: false,
+    };
+}
+// ─── Index Helpers ────────────────────────────────────────
+function findContentIndex(parts) {
+    return parts.findIndex((p) => p.type === 'content');
+}
+function findLastArtifactIndex(parts) {
+    for (let i = parts.length - 1; i >= 0; i--) {
+        if (parts[i].type === 'artifact')
+            return i;
+    }
+    return -1;
+}
+function findLastCustomMarkdownIndex(parts) {
+    for (let i = parts.length - 1; i >= 0; i--) {
+        if (parts[i].type === 'customMarkdown')
+            return i;
+    }
+    return -1;
+}
+// ─── Tag Open Handler ─────────────────────────────────────
+function handleOpenTag(state, name, attrs) {
+    state.currentTag = name;
+    switch (name) {
+        case 'content': {
+            state.isContentClosed = false;
+            const idx = findContentIndex(state.parts);
+            if (idx !== -1) {
+                state.parts[idx].data = '';
+            }
+            else {
+                state.parts.push({ type: 'content', data: '' });
+            }
+            break;
+        }
+        case 'artifact': {
+            const id = attrs.id ?? crypto.randomUUID();
+            const version = attrs.version ? parseInt(attrs.version, 10) : 1;
+            const existingIdx = state.parts.findIndex((p) => p.type === 'artifact' && p.id === id);
+            if (existingIdx === -1) {
+                state.parts.push({
+                    type: 'artifact',
+                    artifactType: attrs.type || 'slides',
+                    data: '',
+                    diff: '',
+                    version,
+                    id,
+                    isDiffClosed: true,
+                });
+            }
+            else {
+                state.parts[existingIdx].data = '';
+            }
+            break;
+        }
+        case 'artifact_diff': {
+            const idx = findLastArtifactIndex(state.parts);
+            if (idx !== -1) {
+                const artifact = state.parts[idx];
+                artifact.diff = '';
+                artifact.isDiffClosed = false;
+            }
+            break;
+        }
+        case 'context':
+            state.context = '';
+            break;
+        case 'thinkitem':
+            state.think.push({
+                title: '',
+                content: '',
+                ephemeral: attrs.ephemeral === 'true',
+            });
+            break;
+        case 'custommarkdown':
+            state.parts.push({
+                type: 'customMarkdown',
+                data: { content: '' },
+            });
+            break;
+    }
+}
+// ─── Text Handler ─────────────────────────────────────────
+function handleText(state, text) {
+    switch (state.currentTag) {
+        case 'content': {
+            const idx = findContentIndex(state.parts);
+            if (idx !== -1) {
+                state.parts[idx].data += text;
+            }
+            break;
+        }
+        case 'artifact': {
+            const idx = findLastArtifactIndex(state.parts);
+            if (idx !== -1) {
+                state.parts[idx].data += text;
+            }
+            break;
+        }
+        case 'artifact_diff': {
+            const idx = findLastArtifactIndex(state.parts);
+            if (idx !== -1) {
+                state.parts[idx].diff += text;
+            }
+            break;
+        }
+        case 'context':
+            state.context += text;
+            break;
+        case 'thinkitem':
+            // Ignore text directly inside <thinkitem> (only children matter)
+            break;
+        case 'thinkitemtitle': {
+            const item = state.think[state.think.length - 1];
+            if (item)
+                item.title += text;
+            break;
+        }
+        case 'thinkitemcontent': {
+            const item = state.think[state.think.length - 1];
+            if (item)
+                item.content += text;
+            break;
+        }
+        case 'custommarkdown': {
+            const idx = findLastCustomMarkdownIndex(state.parts);
+            if (idx !== -1) {
+                state.parts[idx].data.content += text;
+            }
+            break;
+        }
+        default: {
+            // Text outside any known tag → treat as content
+            const idx = findContentIndex(state.parts);
+            if (idx !== -1) {
+                state.parts[idx].data += text;
+            }
+            else {
+                state.parts.push({ type: 'content', data: text });
+            }
+        }
+    }
+}
+// ─── Close Tag Handler ────────────────────────────────────
+/** Returns the closing tag name so callers can fire callbacks */
+function handleCloseTag(state) {
+    const closingTag = state.currentTag;
+    if (state.currentTag === 'content' ||
+        state.currentTag === 'artifact' ||
+        state.currentTag === 'artifact_diff') {
+        state.isContentClosed = true;
+    }
+    if (state.currentTag === 'artifact_diff') {
+        const idx = findLastArtifactIndex(state.parts);
+        if (idx !== -1) {
+            state.parts[idx].isDiffClosed = true;
+        }
+    }
+    state.currentTag = undefined;
+    return closingTag;
+}
+// ─── State → Response ─────────────────────────────────────
+function toResponse(state) {
+    return {
+        parts: state.parts,
+        think: state.think,
+        context: state.context,
+        isContentClosed: state.isContentClosed,
+    };
+}
+// ─── Public API ───────────────────────────────────────────
+/**
+ * Create a streaming XML-DSL parser.
+ *
+ * Call `write(chunk)` for each streamed chunk.
+ * Call `getResult()` at any time to get the current parsed state.
+ *
+ * @example
+ * ```ts
+ * const parser = createStreamParser();
+ * parser.write('<content thesys="true">Hello');
+ * parser.write(' world</content>');
+ * const result = parser.getResult();
+ * // result.parts[0] = { type: 'content', data: 'Hello world' }
+ * ```
+ */
+export function createStreamParser(options) {
+    let state = initialState();
+    const parser = new Parser({
+        onopentag(name, attrs) {
+            state = produce(state, (draft) => {
+                handleOpenTag(draft, name, attrs);
+            });
+        },
+        ontext(text) {
+            state = produce(state, (draft) => {
+                handleText(draft, text);
+            });
+        },
+        onclosetag() {
+            let closingTag;
+            state = produce(state, (draft) => {
+                closingTag = handleCloseTag(draft);
+            });
+            // Fire callbacks after produce() so consumers see final immutable state
+            if (options && closingTag) {
+                switch (closingTag) {
+                    case 'content': {
+                        const idx = findContentIndex(state.parts);
+                        if (idx !== -1) {
+                            options.onContent?.(state.parts[idx].data);
+                        }
+                        break;
+                    }
+                    case 'artifact': {
+                        const idx = findLastArtifactIndex(state.parts);
+                        if (idx !== -1) {
+                            options.onArtifact?.(state.parts[idx]);
+                        }
+                        break;
+                    }
+                    case 'thinkitemcontent': {
+                        const item = state.think[state.think.length - 1];
+                        if (item) {
+                            options.onThink?.(item);
+                        }
+                        break;
+                    }
+                }
+            }
+        },
+    }, { xmlMode: true, decodeEntities: true });
+    return {
+        write(chunk) {
+            parser.write(chunk);
+        },
+        getResult() {
+            return toResponse(state);
+        },
+        getState() {
+            return toResponse(state);
+        },
+        reset() {
+            state = initialState();
+        },
+    };
+}
+/**
+ * Parse a complete XML-DSL string in one shot.
+ * Convenience wrapper for non-streaming use cases.
+ */
+export function parseResponse(xml) {
+    const parser = createStreamParser();
+    parser.write(xml);
+    return parser.getResult();
+}
+//# sourceMappingURL=parser.js.map

package/dist/parser.js.map

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

package/dist/serializer.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Serialize ParsedResponse back to XML-DSL string.
+ * Useful for message storage and conversation history.
+ *
+ * Mirrors C1's serialization (function U in xmlParser).
+ */
+import type { ParsedResponse } from './types.js';
+export declare function serializeResponse(response: ParsedResponse): string;
+/**
+ * Extract context from a raw c0 response string.
+ * Returns the response without context tags and the extracted context.
+ */
+export declare function extractContext(raw: string): {
+    response: string;
+    context: string;
+};
+//# sourceMappingURL=serializer.d.ts.map

package/dist/serializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serializer.d.ts","sourceRoot":"","sources":["../src/serializer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAgB,cAAc,EAAE,MAAM,YAAY,CAAC;AAU/D,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,cAAc,GAAG,MAAM,CAsClE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB,CAcA"}

package/dist/serializer.js

@@ -0,0 +1,59 @@
+/**
+ * Serialize ParsedResponse back to XML-DSL string.
+ * Useful for message storage and conversation history.
+ *
+ * Mirrors C1's serialization (function U in xmlParser).
+ */
+import { wrapArtifact, wrapArtifactDiff, wrapContent, wrapContext, wrapCustomMarkdown, wrapThinkItem, } from './tags.js';
+export function serializeResponse(response) {
+    let result = '';
+    // Think items first (matches C1 output order)
+    for (const item of response.think) {
+        result += wrapThinkItem(item.title, item.content, item.ephemeral);
+    }
+    // Message parts
+    for (const part of response.parts) {
+        switch (part.type) {
+            case 'content':
+                result += wrapContent(part.data);
+                break;
+            case 'customMarkdown':
+                result += wrapCustomMarkdown(part.data.content);
+                break;
+            case 'artifact': {
+                const artifact = part;
+                result += wrapArtifact(artifact.data, {
+                    type: artifact.artifactType,
+                    id: artifact.id,
+                    version: artifact.version,
+                });
+                if (artifact.diff) {
+                    result += wrapArtifactDiff(artifact.diff);
+                }
+                break;
+            }
+        }
+    }
+    // Context last
+    if (response.context) {
+        result += wrapContext(response.context);
+    }
+    return result;
+}
+/**
+ * Extract context from a raw c0 response string.
+ * Returns the response without context tags and the extracted context.
+ */
+export function extractContext(raw) {
+    const openTag = '<context>';
+    const closeTag = '</context>';
+    const startIdx = raw.indexOf(openTag);
+    const endIdx = raw.indexOf(closeTag);
+    if (startIdx !== -1 && endIdx > startIdx) {
+        const response = raw.slice(0, startIdx) + raw.slice(endIdx + closeTag.length);
+        const context = raw.slice(startIdx + openTag.length, endIdx);
+        return { response, context };
+    }
+    return { response: raw, context: '' };
+}
+//# sourceMappingURL=serializer.js.map

package/dist/serializer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serializer.js","sourceRoot":"","sources":["../src/serializer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,WAAW,EACX,WAAW,EACX,kBAAkB,EAClB,aAAa,GACd,MAAM,WAAW,CAAC;AAEnB,MAAM,UAAU,iBAAiB,CAAC,QAAwB;IACxD,IAAI,MAAM,GAAG,EAAE,CAAC;IAEhB,8CAA8C;IAC9C,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;QAClC,MAAM,IAAI,aAAa,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;IACpE,CAAC;IAED,gBAAgB;IAChB,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;QAClC,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;YAClB,KAAK,SAAS;gBACZ,MAAM,IAAI,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACjC,MAAM;YACR,KAAK,gBAAgB;gBACnB,MAAM,IAAI,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBAChD,MAAM;YACR,KAAK,UAAU,CAAC,CAAC,CAAC;gBAChB,MAAM,QAAQ,GAAG,IAAoB,CAAC;gBACtC,MAAM,IAAI,YAAY,CAAC,QAAQ,CAAC,IAAI,EAAE;oBACpC,IAAI,EAAE,QAAQ,CAAC,YAAY;oBAC3B,EAAE,EAAE,QAAQ,CAAC,EAAE;oBACf,OAAO,EAAE,QAAQ,CAAC,OAAO;iBAC1B,CAAC,CAAC;gBACH,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC;oBAClB,MAAM,IAAI,gBAAgB,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;gBAC5C,CAAC;gBACD,MAAM;YACR,CAAC;QACH,CAAC;IACH,CAAC;IAED,eAAe;IACf,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;QACrB,MAAM,IAAI,WAAW,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC1C,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,GAAW;IAIxC,MAAM,OAAO,GAAG,WAAW,CAAC;IAC5B,MAAM,QAAQ,GAAG,YAAY,CAAC;IAC9B,MAAM,QAAQ,GAAG,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACtC,MAAM,MAAM,GAAG,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAErC,IAAI,QAAQ,KAAK,CAAC,CAAC,IAAI,MAAM,GAAG,QAAQ,EAAE,CAAC;QACzC,MAAM,QAAQ,GACZ,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;QAC/D,MAAM,OAAO,GAAG,GAAG,CAAC,KAAK,CAAC,QAAQ,GAAG,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC7D,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;IAC/B,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;AACxC,CAAC"}

package/dist/tags.d.ts

@@ -0,0 +1,40 @@
+/**
+ * XML tag builders for the c0 streaming protocol.
+ *
+ * These mirror C1's internal tag format:
+ *   <content thesys="true">...</content>
+ *   <artifact type="..." id="..." version="...">...</artifact>
+ *   <thinkitem ephemeral="true|false">
+ *     <thinkitemtitle>...</thinkitemtitle>
+ *     <thinkitemcontent>...</thinkitemcontent>
+ *   </thinkitem>
+ *   <context>...</context>
+ *   <custommarkdown>...</custommarkdown>
+ */
+export declare const TAGS: {
+    readonly CONTENT: "content";
+    readonly ARTIFACT: "artifact";
+    readonly ARTIFACT_DIFF: "artifact_diff";
+    readonly CONTEXT: "context";
+    readonly THINK_ITEM: "thinkitem";
+    readonly THINK_TITLE: "thinkitemtitle";
+    readonly THINK_CONTENT: "thinkitemcontent";
+    readonly CUSTOM_MARKDOWN: "custommarkdown";
+};
+/**
+ * Escape HTML entities for safe embedding in XML.
+ * Matches lodash/escape behavior used by C1.
+ */
+export declare function escapeXml(str: string): string;
+export declare function unescapeXml(str: string): string;
+export declare function wrapContent(text: string): string;
+export declare function wrapArtifact(data: string, meta: {
+    type: string;
+    id: string;
+    version: number;
+}): string;
+export declare function wrapArtifactDiff(diff: string): string;
+export declare function wrapContext(context: string): string;
+export declare function wrapThinkItem(title: string, content: string, ephemeral?: boolean): string;
+export declare function wrapCustomMarkdown(markdown: string): string;
+//# sourceMappingURL=tags.d.ts.map

package/dist/tags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tags.d.ts","sourceRoot":"","sources":["../src/tags.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,eAAO,MAAM,IAAI;;;;;;;;;CASP,CAAC;AAkBX;;;GAGG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAO7C;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAO/C;AAID,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAClD,MAAM,CAMR;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,wBAAgB,aAAa,CAC3B,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,SAAS,GAAE,OAAc,GACxB,MAAM,CAKR;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE3D"}

package/dist/tags.js

@@ -0,0 +1,81 @@
+/**
+ * XML tag builders for the c0 streaming protocol.
+ *
+ * These mirror C1's internal tag format:
+ *   <content thesys="true">...</content>
+ *   <artifact type="..." id="..." version="...">...</artifact>
+ *   <thinkitem ephemeral="true|false">
+ *     <thinkitemtitle>...</thinkitemtitle>
+ *     <thinkitemcontent>...</thinkitemcontent>
+ *   </thinkitem>
+ *   <context>...</context>
+ *   <custommarkdown>...</custommarkdown>
+ */
+// ─── Tag Names ────────────────────────────────────────────
+export const TAGS = {
+    CONTENT: 'content',
+    ARTIFACT: 'artifact',
+    ARTIFACT_DIFF: 'artifact_diff',
+    CONTEXT: 'context',
+    THINK_ITEM: 'thinkitem',
+    THINK_TITLE: 'thinkitemtitle',
+    THINK_CONTENT: 'thinkitemcontent',
+    CUSTOM_MARKDOWN: 'custommarkdown',
+};
+// ─── Helpers ──────────────────────────────────────────────
+function openTag(name, attrs) {
+    const attrStr = attrs
+        ? ' ' + Object.entries(attrs).map(([k, v]) => `${k}="${v}"`).join(' ')
+        : '';
+    return `<${name}${attrStr}>`;
+}
+function closeTag(name) {
+    return `</${name}>`;
+}
+/**
+ * Escape HTML entities for safe embedding in XML.
+ * Matches lodash/escape behavior used by C1.
+ */
+export function escapeXml(str) {
+    return str
+        .replace(/&/g, '&amp;')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;')
+        .replace(/'/g, '&#39;');
+}
+export function unescapeXml(str) {
+    return str
+        .replace(/&amp;/g, '&')
+        .replace(/&lt;/g, '<')
+        .replace(/&gt;/g, '>')
+        .replace(/&quot;/g, '"')
+        .replace(/&#39;/g, "'");
+}
+// ─── Tag Builders ─────────────────────────────────────────
+export function wrapContent(text) {
+    return `${openTag(TAGS.CONTENT, { thesys: 'true' })}${escapeXml(text)}${closeTag(TAGS.CONTENT)}`;
+}
+export function wrapArtifact(data, meta) {
+    return `${openTag(TAGS.ARTIFACT, {
+        type: meta.type,
+        id: meta.id,
+        version: String(meta.version),
+    })}${escapeXml(data)}${closeTag(TAGS.ARTIFACT)}`;
+}
+export function wrapArtifactDiff(diff) {
+    return `${openTag(TAGS.ARTIFACT_DIFF)}${escapeXml(diff)}${closeTag(TAGS.ARTIFACT_DIFF)}`;
+}
+export function wrapContext(context) {
+    return `${openTag(TAGS.CONTEXT)}${escapeXml(context)}${closeTag(TAGS.CONTEXT)}`;
+}
+export function wrapThinkItem(title, content, ephemeral = true) {
+    const titleTag = `${openTag(TAGS.THINK_TITLE)}${escapeXml(title)}${closeTag(TAGS.THINK_TITLE)}`;
+    const contentTag = `${openTag(TAGS.THINK_CONTENT)}${escapeXml(content)}${closeTag(TAGS.THINK_CONTENT)}`;
+    const attrs = ephemeral ? { ephemeral: 'true' } : undefined;
+    return `${openTag(TAGS.THINK_ITEM, attrs)}${titleTag}${contentTag}${closeTag(TAGS.THINK_ITEM)}`;
+}
+export function wrapCustomMarkdown(markdown) {
+    return `${openTag(TAGS.CUSTOM_MARKDOWN)}${escapeXml(markdown)}${closeTag(TAGS.CUSTOM_MARKDOWN)}`;
+}
+//# sourceMappingURL=tags.js.map

package/dist/tags.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,60 @@
+export interface ContentPart {
+    type: 'content';
+    data: string;
+}
+export interface ArtifactPart {
+    type: 'artifact';
+    artifactType: string;
+    id: string;
+    version: number;
+    data: string;
+    diff: string;
+    isDiffClosed: boolean;
+}
+export interface CustomMarkdownPart {
+    type: 'customMarkdown';
+    data: {
+        content: string;
+    };
+}
+export type MessagePart = ContentPart | ArtifactPart | CustomMarkdownPart;
+export interface ThinkItem {
+    title: string;
+    content: string;
+    ephemeral: boolean;
+}
+export interface ParsedResponse {
+    parts: MessagePart[];
+    think: ThinkItem[];
+    context: string;
+    isContentClosed: boolean;
+}
+export interface StreamParserOptions {
+    onArtifact?: (artifact: ArtifactPart) => void;
+    onThink?: (item: ThinkItem) => void;
+    onContent?: (content: string) => void;
+}
+export interface StreamParser {
+    /** Feed a chunk of XML-DSL into the parser */
+    write(chunk: string): void;
+    /** Get current parsed state (safe to call during streaming) */
+    getResult(): ParsedResponse;
+    /** Alias for getResult() */
+    getState(): ParsedResponse;
+    /** Reset parser to initial state */
+    reset(): void;
+}
+export interface ArtifactMeta {
+    type: string;
+    id: string;
+    version: number;
+}
+export type TagName = 'content' | 'artifact' | 'artifact_diff' | 'context' | 'thinkitem' | 'thinkitemtitle' | 'thinkitemcontent' | 'custommarkdown';
+export interface ParserState {
+    currentTag: TagName | undefined;
+    parts: MessagePart[];
+    think: ThinkItem[];
+    context: string;
+    isContentClosed: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,UAAU,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,gBAAgB,CAAC;IACvB,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAC3B;AAED,MAAM,MAAM,WAAW,GAAG,WAAW,GAAG,YAAY,GAAG,kBAAkB,CAAC;AAI1E,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;CACpB;AAID,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,OAAO,CAAC;CAC1B;AAID,MAAM,WAAW,mBAAmB;IAClC,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,YAAY,KAAK,IAAI,CAAC;IAC9C,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,IAAI,CAAC;IACpC,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACvC;AAID,MAAM,WAAW,YAAY;IAC3B,8CAA8C;IAC9C,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,+DAA+D;IAC/D,SAAS,IAAI,cAAc,CAAC;IAC5B,4BAA4B;IAC5B,QAAQ,IAAI,cAAc,CAAC;IAC3B,oCAAoC;IACpC,KAAK,IAAI,IAAI,CAAC;CACf;AAID,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;CACjB;AAID,MAAM,MAAM,OAAO,GACf,SAAS,GACT,UAAU,GACV,eAAe,GACf,SAAS,GACT,WAAW,GACX,gBAAgB,GAChB,kBAAkB,GAClB,gBAAgB,CAAC;AAErB,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,OAAO,GAAG,SAAS,CAAC;IAChC,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,OAAO,CAAC;CAC1B"}

package/dist/types.js

@@ -0,0 +1,3 @@
+// ─── Message Part Types ───────────────────────────────────
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,6DAA6D"}

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@c0-ui/protocol",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "htmlparser2": "^9.1.0",
+    "immer": "^10.1.1"
+  },
+  "devDependencies": {
+    "typescript": "^5.7",
+    "vitest": "^3"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "clean": "rm -rf dist"
+  }
+}