@plurnk/plurnk-agui 0.3.0

package/dist/types.d.ts

@@ -0,0 +1,134 @@
+export type AguiEvent = {
+    type: "RUN_STARTED";
+    threadId: string;
+    runId: string;
+} | {
+    type: "RUN_FINISHED";
+    threadId: string;
+    runId: string;
+} | {
+    type: "RUN_ERROR";
+    message: string;
+    code?: string;
+} | {
+    type: "STEP_STARTED";
+    stepName: string;
+} | {
+    type: "STEP_FINISHED";
+    stepName: string;
+} | {
+    type: "TEXT_MESSAGE_START";
+    messageId: string;
+    role: "assistant";
+} | {
+    type: "TEXT_MESSAGE_CONTENT";
+    messageId: string;
+    delta: string;
+} | {
+    type: "TEXT_MESSAGE_END";
+    messageId: string;
+} | {
+    type: "THINKING_TEXT_MESSAGE_START";
+} | {
+    type: "THINKING_TEXT_MESSAGE_CONTENT";
+    delta: string;
+} | {
+    type: "THINKING_TEXT_MESSAGE_END";
+} | {
+    type: "TOOL_CALL_START";
+    toolCallId: string;
+    toolCallName: string;
+    parentMessageId?: string;
+} | {
+    type: "TOOL_CALL_ARGS";
+    toolCallId: string;
+    delta: string;
+} | {
+    type: "TOOL_CALL_END";
+    toolCallId: string;
+} | {
+    type: "TOOL_CALL_RESULT";
+    toolCallId: string;
+    messageId: string;
+    content: string;
+} | {
+    type: "MESSAGES_SNAPSHOT";
+    messages: Array<{
+        id: string;
+        role: string;
+        content: string;
+    }>;
+} | {
+    type: "STATE_SNAPSHOT";
+    snapshot: unknown;
+} | {
+    type: "STATE_DELTA";
+    delta: Array<{
+        op: string;
+        path: string;
+        value?: unknown;
+    }>;
+} | {
+    type: "CUSTOM";
+    name: string;
+    value: unknown;
+};
+export interface RunAgentInput {
+    threadId: string;
+    runId: string;
+    messages?: Array<{
+        role: string;
+        content?: string;
+    }>;
+    state?: unknown;
+    forwardedProps?: unknown;
+}
+export interface LogEntryNotification {
+    entry: {
+        id: number;
+        coordinate?: string;
+        op: string;
+        origin: string;
+        suffix?: string;
+        signal?: unknown;
+        scheme?: string | null;
+        pathname?: string | null;
+        tx?: unknown;
+        rx?: unknown;
+        status_rx?: number;
+        turn_id?: number;
+        expanded?: number;
+        attrs?: string | null;
+    };
+}
+export interface ProposalNotification {
+    logEntryId: number;
+    sessionId: number;
+    runId: number;
+    loopId: number;
+    turnId: number;
+    op: string;
+    target: {
+        scheme: string | null;
+        pathname: string | null;
+    };
+    body: string;
+    attrs: Record<string, unknown>;
+    flags: Record<string, unknown>;
+    staleClobberRisk?: boolean;
+}
+export interface TerminatedNotification {
+    loopId: number;
+    finalStatus: number;
+    hitMaxTurns: boolean;
+    turnIds: number[];
+    usage: {
+        promptTokens: number;
+        completionTokens: number;
+        costPico: number;
+        contextTokens: number;
+        contextSize: number | null;
+        meta: Record<string, unknown>;
+    };
+}
+//# 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":"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"}

package/dist/types.js

@@ -0,0 +1,10 @@
+// The AG-UI event vocabulary this bridge emits — hand-defined from the protocol spec
+// (https://docs.ag-ui.com), deliberately WITHOUT the @ag-ui/* SDK dependency: the shapes are
+// plain JSON, the protocol is young, and a zero-dep daughter beats tracking SDK churn. When the
+// official SDK stabilizes, adopting it is a types-only swap (§agui-zero-dep).
+//
+// Plurnk-specific richness the core vocabulary can't hold (fold state, coordinates, tags,
+// proposals) rides CUSTOM events under the `plurnk.` namespace — generic frontends skip them,
+// plurnk-aware frontends render them richly (§agui-custom-namespace).
+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,qFAAqF;AACrF,6FAA6F;AAC7F,gGAAgG;AAChG,8EAA8E;AAC9E,EAAE;AACF,0FAA0F;AAC1F,8FAA8F;AAC9F,sEAAsE"}

package/package.json

@@ -0,0 +1,65 @@
+{
+    "name": "@plurnk/plurnk-agui",
+    "version": "0.3.0",
+    "description": "The plurnk daemon's transport daughter — owns the client interface, serving AG-UI+ (the Agent-User Interaction Protocol + plurnk metadata extensions) as the sole client interaction surface. In-process module activated at the daemon's boot plug-point; any AG-UI frontend is a plurnk client.",
+    "type": "module",
+    "license": "MIT",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/plurnk/plurnk-agui.git"
+    },
+    "exports": {
+        ".": {
+            "types": "./dist/index.d.ts",
+            "default": "./dist/index.js"
+        },
+        "./package.json": "./package.json"
+    },
+    "bin": {
+        "plurnk-agui": "dist/bin/serve.js"
+    },
+    "files": [
+        "dist/**/*",
+        ".env.example",
+        "README.md",
+        "SPEC.md"
+    ],
+    "engines": {
+        "node": ">=26"
+    },
+    "scripts": {
+        "start": "node --env-file-if-exists=.env.example --env-file-if-exists=.env src/bin/serve.ts",
+        "test": "npm run test:lint && npm run test:unit && npm run test:intg",
+        "test:lint": "tsc --noEmit",
+        "test:unit": "node --env-file-if-exists=.env.example --test src/*.test.ts",
+        "test:intg": "node --env-file-if-exists=.env.example --test test/intg/*.test.ts",
+        "deps:fresh": "npm outdated",
+        "prepare": "git config core.hooksPath .githooks || true; npm run build",
+        "prepublishOnly": "npm test",
+        "build:dist": "tsc -p tsconfig.build.json",
+        "build": "npm run build:dist"
+    },
+    "devDependencies": {
+        "@types/node": "^26.1.1",
+        "@types/ws": "8.18.1",
+        "typescript": "^7.0.2",
+        "ws": "8.21.0"
+    },
+    "keywords": [
+        "plurnk",
+        "ag-ui",
+        "agui",
+        "agent",
+        "transport",
+        "sse",
+        "human-in-the-loop"
+    ],
+    "homepage": "https://github.com/plurnk/plurnk-agui#readme",
+    "bugs": {
+        "url": "https://github.com/plurnk/plurnk-agui/issues"
+    },
+    "author": "@wikitopian",
+    "publishConfig": {
+        "access": "public"
+    }
+}