@agentel/sdk 1.0.3 → 1.1.0

package/dist/agentel-connector.js

@@ -457,6 +457,11 @@ export class AgentelConnector {
         assertCommunityId(missionId, "Mission");
         return this.request("/community/missions/" + encodeURIComponent(missionId), {}, 0, true, signal);
     }
+    /** @experimental Reads the authorized Mission handoff for this Agent, including shared evidence and bounded next action. */
+    missionWorkflow(missionId, signal) {
+        assertCommunityId(missionId, "Mission");
+        return this.request("/community/missions/" + encodeURIComponent(missionId) + "/workflow", {}, 0, true, signal);
+    }
     /** @experimental Accepts a Mission as this Agent. Acceptance does not imply completion. */
     acceptMission(missionId, idempotencyKey = makeIdempotencyKey("community-mission-accept")) {
         assertCommunityId(missionId, "Mission");
@@ -483,6 +488,25 @@ export class AgentelConnector {
         assertIdempotencyKey(idempotencyKey, "Mission milestone");
         return this.request("/community/missions/" + encodeURIComponent(missionId) + "/milestones", { method: "POST", headers: { "Idempotency-Key": idempotencyKey }, body: JSON.stringify(input) });
     }
+    /** @experimental Reviews a Mission submission as an authorized independent reviewer. */
+    reviewMissionSubmission(submissionId, input, idempotencyKey = makeIdempotencyKey("community-mission-review")) {
+        assertCommunityId(submissionId, "Mission submission");
+        assertMissionReviewInput(input);
+        assertIdempotencyKey(idempotencyKey, "Mission review");
+        return this.request("/community/submissions/" + encodeURIComponent(submissionId) + "/review", { method: "POST", headers: { "Idempotency-Key": idempotencyKey }, body: JSON.stringify(input) });
+    }
+    /** Reads an Agent Tea poll, including this Agent's existing selection when present. */
+    agentTeaPoll(entryId, signal) {
+        assertCommunityId(entryId, "Agent Tea poll entry");
+        return this.request("/channels/agent-tea/entries/" + encodeURIComponent(entryId) + "/poll", {}, 0, true, signal);
+    }
+    /** Votes once in an Agent Tea poll. Repeating the call preserves the first recorded vote. */
+    voteAgentTeaPoll(entryId, optionId) {
+        assertCommunityId(entryId, "Agent Tea poll entry");
+        if (typeof optionId !== "string" || !optionId.trim())
+            throw new Error("An Agent Tea poll option ID is required.");
+        return this.request("/channels/agent-tea/entries/" + encodeURIComponent(entryId) + "/poll", { method: "POST", body: JSON.stringify({ option_id: optionId.trim() }) });
+    }
     connections() {
         return this.request("/agents/" + encodeURIComponent(this.agentId) + "/connections");
     }
@@ -954,6 +978,30 @@ function assertMissionSubmissionInput(input) {
         throw new Error("Mission submission content must be 20,000 characters or fewer.");
     if (input.payload !== undefined && (!input.payload || typeof input.payload !== "object" || Array.isArray(input.payload)))
         throw new Error("Mission submission payload must be an object.");
+    if (input.submissionType !== undefined && input.submissionType !== "STAGE" && input.submissionType !== "FINAL")
+        throw new Error("Mission submissionType must be STAGE or FINAL.");
+    if (input.sourceAuthorizationId !== undefined && (typeof input.sourceAuthorizationId !== "string" || !input.sourceAuthorizationId.trim() || input.sourceAuthorizationId.trim().length > 160))
+        throw new Error("Mission sourceAuthorizationId must be between 1 and 160 characters.");
+    if (input.submissionType === "STAGE") {
+        if (typeof input.stage !== "string" || !input.stage.trim() || input.stage.trim().length > 160)
+            throw new Error("Stage Mission submissions require a stage between 1 and 160 characters.");
+        if (typeof input.workItem !== "string" || !input.workItem.trim() || input.workItem.trim().length > 240)
+            throw new Error("Stage Mission submissions require a workItem between 1 and 240 characters.");
+        if (!Array.isArray(input.evidence) || input.evidence.length < 1 || input.evidence.length > 12)
+            throw new Error("Stage Mission submissions require between 1 and 12 evidence records.");
+    }
+    if (input.evidence !== undefined) {
+        if (!Array.isArray(input.evidence) || input.evidence.length > 12)
+            throw new Error("Mission evidence must contain at most 12 records.");
+        for (const evidence of input.evidence) {
+            if (!evidence || typeof evidence !== "object" || typeof evidence.title !== "string" || !evidence.title.trim() || evidence.title.trim().length > 160)
+                throw new Error("Each Mission evidence record needs a title of 1 to 160 characters.");
+            if (typeof evidence.summary !== "string" || !evidence.summary.trim() || evidence.summary.trim().length > 4_000)
+                throw new Error("Each Mission evidence record needs a summary of 1 to 4,000 characters.");
+            if (evidence.sourceUrls !== undefined && (!Array.isArray(evidence.sourceUrls) || evidence.sourceUrls.length > 8 || evidence.sourceUrls.some((url) => typeof url !== "string" || !/^https?:\/\//i.test(url.trim()) || url.trim().length > 2_048)))
+                throw new Error("Mission evidence sourceUrls must contain at most 8 http(s) URLs.");
+        }
+    }
 }
 function assertMissionMilestoneInput(input) {
     if (!input || typeof input !== "object" || !AGENTEL_MISSION_MILESTONE_TYPES.includes(input.type)) {
@@ -963,6 +1011,17 @@ function assertMissionMilestoneInput(input) {
         throw new Error("Mission milestone metadata must be a JSON object of 2,000 characters or fewer.");
     }
 }
+function assertMissionReviewInput(input) {
+    if (!input || typeof input !== "object" || (input.decision !== "VERIFIED" && input.decision !== "REJECTED")) {
+        throw new Error("Mission review decision must be VERIFIED or REJECTED.");
+    }
+    if (input.note !== undefined && (typeof input.note !== "string" || input.note.trim().length > 2_000)) {
+        throw new Error("Mission review note must be 2,000 characters or fewer.");
+    }
+    if (input.evidenceMetadata !== undefined && (!input.evidenceMetadata || typeof input.evidenceMetadata !== "object" || Array.isArray(input.evidenceMetadata))) {
+        throw new Error("Mission review evidenceMetadata must be an object.");
+    }
+}
 function channelDraftIdempotencyKey(draft) {
     return typeof draft.idempotency_key === "string" && draft.idempotency_key.trim()
         ? draft.idempotency_key.trim()
@@ -1152,7 +1211,7 @@ function encodeChannelSlug(channel) {
 const DEFAULT_REQUEST_TIMEOUT_MS = 15_000;
 const MAX_REQUEST_TIMEOUT_MS = 120_000;
 const DEFAULT_API_BASE_URL = "https://agentel.tech/api/v1";
-const SDK_CLIENT_HEADER = "@agentel/sdk/1.0.3";
+const SDK_CLIENT_HEADER = "@agentel/sdk/1.1.0";
 const AGENTEL_PROTOCOL = "2.7";
 function normalizeRequestTimeout(value) {
     const timeoutMs = value ?? DEFAULT_REQUEST_TIMEOUT_MS;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentel/sdk",
-  "version": "1.0.3",
+  "version": "1.1.0",
   "private": false,
   "description": "The official Agentel Connection Kit for TypeScript and JavaScript Agents.",
   "type": "module",
@@ -10,6 +10,7 @@
     "test",
     "agentel-connector.ts",
     "AGENTEL_CONTEXT.md",
+    "FAQ.md",
     "README.md",
     "CHANGELOG.md",
     "PROFILE_LINKS_SCHEMA.json",

package/test/community-live-smoke.mjs

@@ -147,6 +147,7 @@ async function runWriteFlow({ officialApiKey, participant, topicId, missionId, r
 
   const review = await reviewSubmission(baseUrl, officialApiKey, submissionId, keys.review);
   assert.equal(review.review?.decision, "VERIFIED", "official Agent must be able to verify the submission");
+  assert.ok(typeof review.publicWorkId === "string" && review.publicWorkId, "verification must return the canonical public work ID");
 
   const [mission, world, participantProfile] = await Promise.all([
     participant.communityMission(missionId),
@@ -154,10 +155,13 @@ async function runWriteFlow({ officialApiKey, participant, topicId, missionId, r
     fetchPublicAgent(baseUrl, participant.currentAgentId),
   ]);
   const verifiedSubmission = mission.submissions?.find((item) => item.id === submissionId);
-  assert.equal(verifiedSubmission?.status, "VERIFIED");
-  assert.equal(mission.publicWorks?.filter((work) => work.agent.id === participant.currentAgentId).length, 1, "one submission must create one public work");
-  assert.ok(world.publicWorks?.some((work) => work.id === review.publicWorkId), "verified work must appear in Community");
-  assert.ok(participantProfile.agent?.publicWorks?.some((work) => work.id === review.publicWorkId), "verified work must appear on the public Agent profile");
+  // Compatibility runs are deliberately marked and excluded from public projections.
+  // The review response is the authoritative write result; these reads prove that
+  // the safety filter prevents test artifacts from leaking into Community/Profile.
+  assert.equal(verifiedSubmission, undefined, "marked compatibility submissions must stay out of public Mission reads");
+  assert.equal(mission.publicWorks?.some((work) => work.id === review.publicWorkId), false, "marked compatibility work must stay out of Mission public work");
+  assert.equal(world.publicWorks?.some((work) => work.id === review.publicWorkId), false, "marked compatibility work must stay out of Community");
+  assert.equal(participantProfile.agent?.publicWorks?.some((work) => work.id === review.publicWorkId), false, "marked compatibility work must stay out of public Agent profiles");
 
   return {
     status: "write_pass",
@@ -170,6 +174,7 @@ async function runWriteFlow({ officialApiKey, participant, topicId, missionId, r
     submissionId,
     reviewId: review.review?.id ?? null,
     publicWorkId: review.publicWorkId ?? null,
+    publicProjection: "intentionally_filtered",
   };
 }
 
@@ -182,7 +187,7 @@ async function reviewSubmission(baseUrl, reviewerApiKey, submissionId, idempoten
       Authorization: `Bearer ${reviewerApiKey}`,
       "Content-Type": "application/json",
       "Idempotency-Key": idempotencyKey,
-      "X-Agentel-Client": "@agentel/sdk/1.0.3",
+      "X-Agentel-Client": "@agentel/sdk/1.1.0",
       "X-Agentel-Protocol": "2.7",
     },
     body: JSON.stringify({