@aaep/typescript-producer 1.0.1

package/dist/server.d.ts

@@ -0,0 +1,23 @@
+#!/usr/bin/env node
+/**
+ * HTTP/SSE server wrapping the TypeScript AgentLoop for conformance testing.
+ *
+ * Endpoints (identical to the Python example servers):
+ *     POST /sessions   - Start a new session
+ *     GET  /events     - SSE event stream
+ *     POST /messages   - Reply messages (confirmation, clarification)
+ *     GET  /healthz    - Health check
+ *
+ * Run with:
+ *     npm run server                  (auto-restart via tsx)
+ *     node dist/server.js             (after `npm run build`)
+ *
+ * Then test with:
+ *     aaep-conformance producer --endpoint http://localhost:8084 --level 2
+ *
+ * Cross-language conformance: the same Python conformance suite verifies
+ * this TypeScript server. Pass Level 2 here AND in the Python examples
+ * = AAEP is language-independent in practice, not just in theory.
+ */
+export {};
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;GAmBG"}

package/dist/server.js

@@ -0,0 +1,258 @@
+#!/usr/bin/env node
+/**
+ * HTTP/SSE server wrapping the TypeScript AgentLoop for conformance testing.
+ *
+ * Endpoints (identical to the Python example servers):
+ *     POST /sessions   - Start a new session
+ *     GET  /events     - SSE event stream
+ *     POST /messages   - Reply messages (confirmation, clarification)
+ *     GET  /healthz    - Health check
+ *
+ * Run with:
+ *     npm run server                  (auto-restart via tsx)
+ *     node dist/server.js             (after `npm run build`)
+ *
+ * Then test with:
+ *     aaep-conformance producer --endpoint http://localhost:8084 --level 2
+ *
+ * Cross-language conformance: the same Python conformance suite verifies
+ * this TypeScript server. Pass Level 2 here AND in the Python examples
+ * = AAEP is language-independent in practice, not just in theory.
+ */
+import { createServer } from "node:http";
+import { AAEPEmitter } from "./emitter.js";
+import { AgentLoop } from "./agent.js";
+// === Event broadcaster ===
+class EventBroadcaster {
+    subscribers = new Set();
+    buffer = [];
+    maxBuffer = 1000;
+    publish(event) {
+        this.buffer.push(event);
+        if (this.buffer.length > this.maxBuffer) {
+            // Critical event bypass: never drop critical events on overflow
+            const dropIndex = this.buffer.findIndex((e) => e.urgency !== "critical");
+            if (dropIndex >= 0) {
+                this.buffer.splice(dropIndex, 1);
+            }
+            else {
+                this.buffer.shift(); // all critical; reluctantly drop oldest
+            }
+        }
+        const data = `data: ${JSON.stringify(event)}\n\n`;
+        for (const res of this.subscribers) {
+            try {
+                res.write(data);
+            }
+            catch {
+                this.subscribers.delete(res);
+            }
+        }
+    }
+    addSubscriber(res) {
+        this.subscribers.add(res);
+        // Replay buffer to new subscribers
+        for (const event of this.buffer) {
+            try {
+                res.write(`data: ${JSON.stringify(event)}\n\n`);
+            }
+            catch {
+                this.subscribers.delete(res);
+                return;
+            }
+        }
+    }
+    removeSubscriber(res) {
+        this.subscribers.delete(res);
+    }
+}
+// === Request body parsing ===
+async function readJsonBody(req) {
+    return new Promise((resolve, reject) => {
+        const chunks = [];
+        req.on("data", (chunk) => chunks.push(chunk));
+        req.on("end", () => {
+            try {
+                const text = Buffer.concat(chunks).toString("utf-8");
+                resolve(text ? JSON.parse(text) : {});
+            }
+            catch (err) {
+                reject(err);
+            }
+        });
+        req.on("error", reject);
+    });
+}
+// === CORS headers ===
+function corsHeaders() {
+    return {
+        "Access-Control-Allow-Origin": "*",
+        "Access-Control-Allow-Methods": "GET, POST, OPTIONS",
+        "Access-Control-Allow-Headers": "Content-Type, Authorization",
+    };
+}
+// === Main ===
+async function main() {
+    const port = Number(process.env.PORT ?? 8084);
+    const host = process.env.HOST ?? "127.0.0.1";
+    const broadcaster = new EventBroadcaster();
+    const emitter = new AAEPEmitter({
+        sendEvent: (event) => broadcaster.publish(event),
+        agentId: "aaep-typescript-server",
+        agentName: "AAEP TypeScript Test Server",
+        model: "mock-model",
+    });
+    const agent = new AgentLoop({ emitter });
+    const server = createServer(async (req, res) => {
+        // CORS preflight
+        if (req.method === "OPTIONS") {
+            res.writeHead(204, corsHeaders());
+            res.end();
+            return;
+        }
+        const url = req.url ?? "/";
+        try {
+            // GET /healthz
+            if (req.method === "GET" && url === "/healthz") {
+                res.writeHead(200, {
+                    ...corsHeaders(),
+                    "Content-Type": "application/json",
+                });
+                res.end(JSON.stringify({
+                    status: "ok",
+                    aaep_version: "1.0.0",
+                    implementation: "typescript-minimal",
+                }));
+                return;
+            }
+            // GET /events (SSE stream)
+            if (req.method === "GET" && url === "/events") {
+                res.writeHead(200, {
+                    ...corsHeaders(),
+                    "Content-Type": "text/event-stream",
+                    "Cache-Control": "no-cache",
+                    "Connection": "keep-alive",
+                    "X-Accel-Buffering": "no",
+                });
+                broadcaster.addSubscriber(res);
+                req.on("close", () => broadcaster.removeSubscriber(res));
+                return;
+            }
+            // POST /sessions
+            if (req.method === "POST" && url === "/sessions") {
+                const body = (await readJsonBody(req));
+                if (typeof body.user_message !== "string" || !body.user_message.trim()) {
+                    res.writeHead(400, {
+                        ...corsHeaders(),
+                        "Content-Type": "application/json",
+                    });
+                    res.end(JSON.stringify({ error: "user_message must be a non-empty string" }));
+                    return;
+                }
+                // Schedule the agent run as a background task
+                agent.run(body.user_message, {
+                    userId: typeof body.user_id === "string" ? body.user_id : undefined,
+                }).catch((err) => {
+                    console.error("Session failed:", err);
+                });
+                // Small delay to let the session.started event be queued
+                await new Promise((resolve) => setTimeout(resolve, 50));
+                res.writeHead(202, {
+                    ...corsHeaders(),
+                    "Content-Type": "application/json",
+                });
+                res.end(JSON.stringify({
+                    status: "started",
+                    user_message: body.user_message,
+                }));
+                return;
+            }
+            // POST /messages
+            if (req.method === "POST" && url === "/messages") {
+                const body = (await readJsonBody(req));
+                const replyToken = body.reply_token;
+                if (typeof replyToken !== "string" || !replyToken) {
+                    res.writeHead(400, {
+                        ...corsHeaders(),
+                        "Content-Type": "application/json",
+                    });
+                    res.end(JSON.stringify({ error: "reply_token is required" }));
+                    return;
+                }
+                const msgType = body.type;
+                if (msgType === "confirmation.reply") {
+                    const decision = body.decision;
+                    if (decision !== "accept" && decision !== "reject") {
+                        res.writeHead(400, {
+                            ...corsHeaders(),
+                            "Content-Type": "application/json",
+                        });
+                        res.end(JSON.stringify({ error: "decision must be accept or reject" }));
+                        return;
+                    }
+                    emitter.submitReply(replyToken, decision);
+                    res.writeHead(200, {
+                        ...corsHeaders(),
+                        "Content-Type": "application/json",
+                    });
+                    res.end(JSON.stringify({ status: "received" }));
+                    return;
+                }
+                if (msgType === "clarification.reply") {
+                    const response = body.response;
+                    if (response === undefined) {
+                        res.writeHead(400, {
+                            ...corsHeaders(),
+                            "Content-Type": "application/json",
+                        });
+                        res.end(JSON.stringify({ error: "response field required" }));
+                        return;
+                    }
+                    emitter.submitReply(replyToken, String(response));
+                    res.writeHead(200, {
+                        ...corsHeaders(),
+                        "Content-Type": "application/json",
+                    });
+                    res.end(JSON.stringify({ status: "received" }));
+                    return;
+                }
+                res.writeHead(400, {
+                    ...corsHeaders(),
+                    "Content-Type": "application/json",
+                });
+                res.end(JSON.stringify({ error: `unsupported message type: ${String(msgType)}` }));
+                return;
+            }
+            // 404
+            res.writeHead(404, {
+                ...corsHeaders(),
+                "Content-Type": "application/json",
+            });
+            res.end(JSON.stringify({ error: "Not found" }));
+        }
+        catch (error) {
+            const err = error instanceof Error ? error : new Error(String(error));
+            console.error("Request handler error:", err);
+            res.writeHead(500, {
+                ...corsHeaders(),
+                "Content-Type": "application/json",
+            });
+            res.end(JSON.stringify({ error: err.message }));
+        }
+    });
+    server.listen(port, host, () => {
+        console.log(`Starting AAEP TypeScript server on http://${host}:${port}`);
+        console.log(`Test with: aaep-conformance producer --endpoint http://${host}:${port} --level 2`);
+    });
+    // Graceful shutdown
+    process.on("SIGINT", () => {
+        console.log("\nShutting down...");
+        server.close(() => process.exit(0));
+    });
+}
+// === Entry point ===
+main().catch((err) => {
+    console.error("Server failed:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,208 @@
+/**
+ * TypeScript type definitions for AAEP events.
+ *
+ * These interfaces match the JSON Schemas exactly. Importing this file
+ * gives you full type safety: editor autocomplete shows valid field names,
+ * the compiler catches missing required fields, and discriminated unions
+ * allow exhaustive switch statements on event type.
+ *
+ * See https://aaep-protocol.org/schemas/v1/ for the canonical schemas.
+ */
+export type Urgency = "normal" | "critical";
+export type Verbosity = "terse" | "normal" | "detailed";
+export type AgentState = "idle" | "thinking" | "calling_tool" | "writing_output" | "awaiting_user" | "completed";
+export type RiskLevel = "low" | "medium" | "high";
+export type ToolStatus = "success" | "error" | "timeout";
+export type CoalesceHint = "none" | "word" | "sentence" | "paragraph" | "completion";
+export type Decision = "accept" | "reject";
+export type ErrorCategory = "timeout" | "network" | "authentication" | "authorization" | "rate_limit" | "invalid_input" | "policy" | "internal" | "transient" | "unknown";
+export type CancelledBy = "user" | "system" | "timeout" | "policy";
+export type Reversibility = "reversible_easy" | "reversible_with_effort" | "irreversible";
+export interface Producer {
+    agent_id: string;
+    agent_version?: string;
+    agent_name?: string;
+    model?: string;
+}
+export interface LocalizationHints {
+    primary_language?: string;
+    text_direction?: "ltr" | "rtl";
+    available_languages?: string[];
+}
+export interface AAEPEnvelope {
+    "@context": string;
+    aaep_version?: string;
+    type: string;
+    event_id: string;
+    session_id: string;
+    sequence_number?: number;
+    timestamp: string;
+    producer: Producer;
+    urgency: Urgency;
+    verbosity?: Verbosity;
+    localization_hints?: LocalizationHints;
+    summary_terse?: string;
+    summary_normal: string;
+    summary_detailed?: string;
+}
+export interface SessionStartedEvent extends AAEPEnvelope {
+    type: "aaep:agent.session.started";
+    request_text?: string;
+    requested_by?: string;
+    expected_duration_ms?: number;
+    tools_available?: string[];
+}
+export interface SessionCompletedEvent extends AAEPEnvelope {
+    type: "aaep:agent.session.completed";
+    duration_ms?: number;
+    tool_invocations_count?: number;
+    output_summary?: string;
+}
+export interface SessionErroredEvent extends AAEPEnvelope {
+    type: "aaep:agent.session.errored";
+    urgency: "critical";
+    error_category: ErrorCategory;
+    error_message?: string;
+    recoverable?: boolean;
+    remediation_hint?: string;
+}
+export interface SessionCancelledEvent extends AAEPEnvelope {
+    type: "aaep:agent.session.cancelled";
+    cancelled_by: CancelledBy;
+    cancellation_reason?: string;
+}
+export interface StateChangedEvent extends AAEPEnvelope {
+    type: "aaep:agent.state.changed";
+    from_state: AgentState | string;
+    to_state: AgentState | string;
+}
+export interface ProgressUpdatedEvent extends AAEPEnvelope {
+    type: "aaep:agent.progress.updated";
+    progress_percent?: number;
+    progress_message?: string;
+    estimated_remaining_ms?: number;
+}
+export interface ToolInvokedEvent extends AAEPEnvelope {
+    type: "aaep:agent.tool.invoked";
+    tool: string;
+    tool_call_id?: string;
+    description?: string;
+    args_summary: string;
+    expected_duration_ms?: number;
+    risk_level: RiskLevel;
+    irreversible: boolean;
+}
+export interface ToolCompletedEvent extends AAEPEnvelope {
+    type: "aaep:agent.tool.completed";
+    tool: string;
+    tool_call_id?: string;
+    status: ToolStatus;
+    error_message?: string;
+}
+export interface OutputStreamingEvent extends AAEPEnvelope {
+    type: "aaep:agent.output.streaming";
+    chunk: string;
+    position: number;
+    complete: boolean;
+    coalesce_hint: CoalesceHint;
+    output_id?: string;
+    content_type?: string;
+    language?: string;
+}
+export interface AwaitingConfirmationEvent extends AAEPEnvelope {
+    type: "aaep:agent.awaiting.confirmation";
+    urgency: "critical";
+    action: string;
+    consequence: string;
+    reply_token: string;
+    timeout_seconds: number;
+    default_decision: Decision;
+    risk_level: RiskLevel;
+    irreversible: boolean;
+    reversibility?: Reversibility;
+}
+export interface AwaitingClarificationEvent extends AAEPEnvelope {
+    type: "aaep:agent.awaiting.clarification";
+    urgency: "critical";
+    question: string;
+    reply_token: string;
+    timeout_seconds: number;
+    options?: string[];
+    multi_select?: boolean;
+    free_form_allowed?: boolean;
+}
+export interface HandoffRequestedEvent extends AAEPEnvelope {
+    type: "aaep:agent.handoff.requested";
+    urgency: "critical";
+    reason: string;
+    handoff_target: string;
+    context_summary?: string;
+}
+export type AAEPEvent = SessionStartedEvent | SessionCompletedEvent | SessionErroredEvent | SessionCancelledEvent | StateChangedEvent | ProgressUpdatedEvent | ToolInvokedEvent | ToolCompletedEvent | OutputStreamingEvent | AwaitingConfirmationEvent | AwaitingClarificationEvent | HandoffRequestedEvent;
+export interface SubscriptionRequest {
+    type: "subscription.request";
+    aaep_version: string;
+    subscriber_id: string;
+    subscriber_name?: string;
+    subscriber_version?: string;
+    capabilities: Capabilities;
+}
+export interface Capabilities {
+    max_events_per_second?: number;
+    preferred_verbosity?: Verbosity;
+    languages?: string[];
+    supports_confirmation_reply?: boolean;
+    supports_clarification_reply?: boolean;
+    coalesce_boundaries?: CoalesceHint[];
+    event_filters?: {
+        include?: string[];
+        exclude?: string[];
+    };
+    supported_conformance_levels?: number[];
+    supported_extensions?: string[];
+    cognitive_load?: "high" | "medium" | "low";
+    pace_wpm?: number;
+    accept_signed_manifests_only?: boolean;
+    [key: string]: unknown;
+}
+export interface SubscriptionAccepted {
+    type: "subscription.accepted";
+    subscription_id: string;
+    aaep_version: string;
+    producer: Producer;
+    honored_capabilities: Capabilities;
+    signed_manifest?: string;
+}
+export type RejectReason = "version_unsupported" | "manifest_signature_required" | "capabilities_incompatible" | "rate_limit" | "authentication_required" | "authorization_denied" | "transport_unavailable" | "unknown";
+export interface SubscriptionRejected {
+    type: "subscription.rejected";
+    reason_code: RejectReason;
+    reason_message: string;
+    retry_after_seconds?: number;
+}
+export interface ConfirmationReply {
+    type: "confirmation.reply";
+    reply_token: string;
+    decision: Decision;
+    subscription_id?: string;
+    decided_by?: string;
+    timestamp: string;
+    decision_reason?: string;
+}
+export interface ClarificationReply {
+    type: "clarification.reply";
+    reply_token: string;
+    response: unknown;
+    subscription_id?: string;
+    decided_by?: string;
+    timestamp: string;
+}
+export declare function isSessionEvent(event: AAEPEvent): event is SessionStartedEvent | SessionCompletedEvent | SessionErroredEvent | SessionCancelledEvent;
+export declare function isToolEvent(event: AAEPEvent): event is ToolInvokedEvent | ToolCompletedEvent;
+export declare function isAwaitingEvent(event: AAEPEvent): event is AwaitingConfirmationEvent | AwaitingClarificationEvent;
+export declare function isCriticalEvent(event: AAEPEvent): boolean;
+export declare const AAEP_CONTEXT_URL = "https://aaep-protocol.org/context/v1";
+export declare const AAEP_VERSION = "1.0.0";
+export declare const CRITICAL_URGENCY_EVENT_TYPES: Set<"aaep:agent.session.errored" | "aaep:agent.awaiting.confirmation" | "aaep:agent.awaiting.clarification" | "aaep:agent.handoff.requested">;
+export declare const HIGH_RISK_TOOL_NAMES: Set<"send_email" | "transfer_funds" | "delete_record" | "delete_file" | "publish_post" | "make_payment" | "execute_trade" | "send_sms" | "send_message">;
+//# 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,45 @@
+/**
+ * TypeScript type definitions for AAEP events.
+ *
+ * These interfaces match the JSON Schemas exactly. Importing this file
+ * gives you full type safety: editor autocomplete shows valid field names,
+ * the compiler catches missing required fields, and discriminated unions
+ * allow exhaustive switch statements on event type.
+ *
+ * See https://aaep-protocol.org/schemas/v1/ for the canonical schemas.
+ */
+// === Type guards ===
+export function isSessionEvent(event) {
+    return event.type.startsWith("aaep:agent.session.");
+}
+export function isToolEvent(event) {
+    return event.type === "aaep:agent.tool.invoked"
+        || event.type === "aaep:agent.tool.completed";
+}
+export function isAwaitingEvent(event) {
+    return event.type.startsWith("aaep:agent.awaiting.");
+}
+export function isCriticalEvent(event) {
+    return event.urgency === "critical";
+}
+// === Constants ===
+export const AAEP_CONTEXT_URL = "https://aaep-protocol.org/context/v1";
+export const AAEP_VERSION = "1.0.0";
+export const CRITICAL_URGENCY_EVENT_TYPES = new Set([
+    "aaep:agent.session.errored",
+    "aaep:agent.awaiting.confirmation",
+    "aaep:agent.awaiting.clarification",
+    "aaep:agent.handoff.requested",
+]);
+export const HIGH_RISK_TOOL_NAMES = new Set([
+    "send_email",
+    "transfer_funds",
+    "delete_record",
+    "delete_file",
+    "publish_post",
+    "make_payment",
+    "execute_trade",
+    "send_sms",
+    "send_message",
+]);
+//# 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;;;;;;;;;GASG;AA2RH,sBAAsB;AAEtB,MAAM,UAAU,cAAc,CAC1B,KAAgB;IAGhB,OAAO,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,qBAAqB,CAAC,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,WAAW,CACvB,KAAgB;IAEhB,OAAO,KAAK,CAAC,IAAI,KAAK,yBAAyB;WACxC,KAAK,CAAC,IAAI,KAAK,2BAA2B,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,eAAe,CAC3B,KAAgB;IAEhB,OAAO,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,sBAAsB,CAAC,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAgB;IAC5C,OAAO,KAAK,CAAC,OAAO,KAAK,UAAU,CAAC;AACxC,CAAC;AAGD,oBAAoB;AAEpB,MAAM,CAAC,MAAM,gBAAgB,GAAG,sCAAsC,CAAC;AACvE,MAAM,CAAC,MAAM,YAAY,GAAG,OAAO,CAAC;AAEpC,MAAM,CAAC,MAAM,4BAA4B,GAAG,IAAI,GAAG,CAAC;IAChD,4BAA4B;IAC5B,kCAAkC;IAClC,mCAAmC;IACnC,8BAA8B;CACxB,CAAC,CAAC;AAEZ,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAI,GAAG,CAAC;IACxC,YAAY;IACZ,gBAAgB;IAChB,eAAe;IACf,aAAa;IACb,cAAc;IACd,cAAc;IACd,eAAe;IACf,UAAU;IACV,cAAc;CACR,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,81 @@
+{
+  "name": "@aaep/typescript-producer",
+  "version": "1.0.1",
+  "description": "AAEP producer example in TypeScript / Node.js — manual loop pattern with full safety machinery",
+  "keywords": [
+    "aaep",
+    "accessibility",
+    "agent",
+    "typescript",
+    "nodejs",
+    "screen-reader",
+    "assistive-technology"
+  ],
+  "homepage": "https://aaep-protocol.org",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Ramseyxlil/aaep.git",
+    "directory": "examples/producers/typescript-minimal"
+  },
+  "bugs": {
+    "url": "https://github.com/Ramseyxlil/aaep/issues"
+  },
+  "license": "MIT",
+  "author": {
+    "name": "Abdulrafiu Izuafa",
+    "email": "Abdulrafiu@izusoft.tech",
+    "url": "https://aaep-protocol.org"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./emitter": {
+      "types": "./dist/emitter.d.ts",
+      "import": "./dist/emitter.js"
+    },
+    "./agent": {
+      "types": "./dist/agent.d.ts",
+      "import": "./dist/agent.js"
+    },
+    "./types": {
+      "types": "./dist/types.d.ts",
+      "import": "./dist/types.js"
+    }
+  },
+  "files": [
+    "dist/",
+    "README.md",
+    "LICENSE"
+  ],
+  "bin": {
+    "aaep-ts-server": "./dist/server.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "watch": "tsc --watch",
+    "demo": "tsx src/agent.ts",
+    "server": "tsx src/server.ts",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {},
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "tsx": "^4.7.0",
+    "typescript": "^5.3.0",
+    "vitest": "^1.2.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}