@ubiquity-os/plugin-sdk 3.12.4 → 3.12.5

package/dist/configuration.js

@@ -104,6 +104,11 @@ function normalizeBaseUrl(baseUrl) {
 // src/types/manifest.ts
 var import_typebox2 = require("@sinclair/typebox");
 var import_webhooks2 = require("@octokit/webhooks");
+
+// src/helpers/runtime-manifest.ts
+var EMPTY_VALUE = String();
+
+// src/types/manifest.ts
 var runEvent = import_typebox2.Type.Union(import_webhooks2.emitterEventNames.map((o) => import_typebox2.Type.Literal(o)));
 var exampleCommandExecutionSchema = import_typebox2.Type.Object({
   commandInvocation: import_typebox2.Type.String({ minLength: 1 }),

package/dist/configuration.mjs

@@ -65,6 +65,11 @@ function normalizeBaseUrl(baseUrl) {
 // src/types/manifest.ts
 import { Type as T2 } from "@sinclair/typebox";
 import { emitterEventNames as emitterEventNames2 } from "@octokit/webhooks";
+
+// src/helpers/runtime-manifest.ts
+var EMPTY_VALUE = String();
+
+// src/types/manifest.ts
 var runEvent = T2.Union(emitterEventNames2.map((o) => T2.Literal(o)));
 var exampleCommandExecutionSchema = T2.Object({
   commandInvocation: T2.String({ minLength: 1 }),

package/dist/index.js

@@ -854,35 +854,43 @@ var import_hono = require("hono");
 var import_adapter2 = require("hono/adapter");
 var import_http_exception = require("hono/http-exception");
 
+// src/types/manifest.ts
+var import_typebox4 = require("@sinclair/typebox");
+var import_webhooks = require("@octokit/webhooks");
+
 // src/helpers/runtime-manifest.ts
 var EMPTY_VALUE = String();
-function readRuntimeTimeline() {
-  if (typeof globalThis.Deno !== "undefined" && typeof globalThis.Deno?.env?.get === "function") {
-    const denoTimeline = globalThis.Deno.env.get("DENO_TIMELINE");
-    if (typeof denoTimeline === "string" && denoTimeline.trim()) {
-      return denoTimeline.trim();
+var GITHUB_HEADS_PREFIX = "refs/heads/";
+var GITHUB_TAGS_PREFIX = "refs/tags/";
+function readRuntimeEnvValue(env, key) {
+  const explicitValue = env?.[key];
+  if (typeof explicitValue === "string" && explicitValue.trim()) {
+    return explicitValue.trim();
+  }
+  const runtime = globalThis;
+  if (typeof runtime.Deno?.env?.get === "function") {
+    const denoValue = runtime.Deno.env.get(key);
+    if (typeof denoValue === "string" && denoValue.trim()) {
+      return denoValue.trim();
     }
   }
   if (typeof process !== "undefined") {
-    const processTimeline = process.env.DENO_TIMELINE;
-    if (typeof processTimeline === "string" && processTimeline.trim()) {
-      return processTimeline.trim();
+    const processValue = process.env[key];
+    if (typeof processValue === "string" && processValue.trim()) {
+      return processValue.trim();
     }
   }
   return EMPTY_VALUE;
 }
-function resolveRuntimeRefName(timeline) {
-  if (!timeline) {
+function parseRefNameFromGitHubRef(ref) {
+  if (!ref) {
     return EMPTY_VALUE;
   }
-  if (timeline === "production") {
-    return "main";
-  }
-  if (timeline.startsWith("git-branch/")) {
-    return timeline.slice("git-branch/".length);
+  if (ref.startsWith(GITHUB_HEADS_PREFIX)) {
+    return ref.slice(GITHUB_HEADS_PREFIX.length);
   }
-  if (timeline.startsWith("preview/")) {
-    return timeline.slice("preview/".length);
+  if (ref.startsWith(GITHUB_TAGS_PREFIX)) {
+    return ref.slice(GITHUB_TAGS_PREFIX.length);
   }
   return EMPTY_VALUE;
 }
@@ -897,25 +905,59 @@ function overrideShortName(shortName, refName) {
   }
   return `${repository}@${refName}`;
 }
-function resolveRuntimeManifest(manifest, requestUrl) {
-  const timeline = readRuntimeTimeline();
-  const refName = resolveRuntimeRefName(timeline);
+function resolveRuntimeRefName(env) {
+  const explicitRefName = readRuntimeEnvValue(env, "REF_NAME");
+  if (explicitRefName) {
+    return explicitRefName;
+  }
+  const legacyManifestRefName = readRuntimeEnvValue(env, "PLUGIN_MANIFEST_REF_NAME");
+  if (legacyManifestRefName) {
+    return legacyManifestRefName;
+  }
+  const githubRefName = readRuntimeEnvValue(env, "GITHUB_REF_NAME");
+  if (githubRefName) {
+    return githubRefName;
+  }
+  return parseRefNameFromGitHubRef(readRuntimeEnvValue(env, "GITHUB_REF"));
+}
+function resolveRuntimeManifest(manifest, env) {
+  const refName = resolveRuntimeRefName(env);
   if (!refName) {
     return manifest;
   }
-  let homepageUrl;
-  try {
-    homepageUrl = new URL(requestUrl).origin;
-  } catch {
-    homepageUrl = void 0;
-  }
   return {
     ...manifest,
-    short_name: overrideShortName(manifest.short_name, refName),
-    ...homepageUrl ? { homepage_url: homepageUrl } : {}
+    short_name: overrideShortName(manifest.short_name, refName)
   };
 }
 
+// src/types/manifest.ts
+var runEvent = import_typebox4.Type.Union(import_webhooks.emitterEventNames.map((o) => import_typebox4.Type.Literal(o)));
+var exampleCommandExecutionSchema = import_typebox4.Type.Object({
+  commandInvocation: import_typebox4.Type.String({ minLength: 1 }),
+  githubContext: import_typebox4.Type.Optional(import_typebox4.Type.Record(import_typebox4.Type.String(), import_typebox4.Type.Any())),
+  expectedToolCallResult: import_typebox4.Type.Object({
+    function: import_typebox4.Type.String({ minLength: 1 }),
+    parameters: import_typebox4.Type.Record(import_typebox4.Type.String(), import_typebox4.Type.Any())
+  })
+});
+var commandSchema = import_typebox4.Type.Object({
+  description: import_typebox4.Type.String({ minLength: 1 }),
+  "ubiquity:example": import_typebox4.Type.String({ minLength: 1 }),
+  parameters: import_typebox4.Type.Optional(import_typebox4.Type.Record(import_typebox4.Type.String(), import_typebox4.Type.Any())),
+  examples: import_typebox4.Type.Optional(import_typebox4.Type.Array(exampleCommandExecutionSchema, { default: [] }))
+});
+var manifestSchema = import_typebox4.Type.Object({
+  name: import_typebox4.Type.String({ minLength: 1 }),
+  short_name: import_typebox4.Type.String({ minLength: 1 }),
+  description: import_typebox4.Type.Optional(import_typebox4.Type.String({ default: "" })),
+  commands: import_typebox4.Type.Optional(import_typebox4.Type.Record(import_typebox4.Type.String({ pattern: "^[A-Za-z-_]+$" }), commandSchema, { default: {} })),
+  "ubiquity:listeners": import_typebox4.Type.Optional(import_typebox4.Type.Array(runEvent, { default: [] })),
+  configuration: import_typebox4.Type.Optional(import_typebox4.Type.Record(import_typebox4.Type.String(), import_typebox4.Type.Any(), { default: {} })),
+  skipBotEvents: import_typebox4.Type.Optional(import_typebox4.Type.Boolean({ default: true })),
+  homepage_url: import_typebox4.Type.Optional(import_typebox4.Type.String())
+});
+
 // src/server.ts
 async function handleError2(context, pluginOptions, error) {
   console.error(error);
@@ -929,7 +971,7 @@ function createPlugin(handler, manifest, options) {
   const pluginOptions = getPluginOptions(options);
   const app = new import_hono.Hono();
   app.get("/manifest.json", (ctx) => {
-    return ctx.json(resolveRuntimeManifest(manifest, ctx.req.url));
+    return ctx.json(resolveRuntimeManifest(manifest, (0, import_adapter2.env)(ctx)));
   });
   app.post("/", async function appPost(ctx) {
     if (ctx.req.header("content-type") !== "application/json") {

package/dist/index.mjs

@@ -813,35 +813,43 @@ import { Hono } from "hono";
 import { env as honoEnv } from "hono/adapter";
 import { HTTPException } from "hono/http-exception";
 
+// src/types/manifest.ts
+import { Type as T3 } from "@sinclair/typebox";
+import { emitterEventNames } from "@octokit/webhooks";
+
 // src/helpers/runtime-manifest.ts
 var EMPTY_VALUE = String();
-function readRuntimeTimeline() {
-  if (typeof globalThis.Deno !== "undefined" && typeof globalThis.Deno?.env?.get === "function") {
-    const denoTimeline = globalThis.Deno.env.get("DENO_TIMELINE");
-    if (typeof denoTimeline === "string" && denoTimeline.trim()) {
-      return denoTimeline.trim();
+var GITHUB_HEADS_PREFIX = "refs/heads/";
+var GITHUB_TAGS_PREFIX = "refs/tags/";
+function readRuntimeEnvValue(env, key) {
+  const explicitValue = env?.[key];
+  if (typeof explicitValue === "string" && explicitValue.trim()) {
+    return explicitValue.trim();
+  }
+  const runtime = globalThis;
+  if (typeof runtime.Deno?.env?.get === "function") {
+    const denoValue = runtime.Deno.env.get(key);
+    if (typeof denoValue === "string" && denoValue.trim()) {
+      return denoValue.trim();
     }
   }
   if (typeof process !== "undefined") {
-    const processTimeline = process.env.DENO_TIMELINE;
-    if (typeof processTimeline === "string" && processTimeline.trim()) {
-      return processTimeline.trim();
+    const processValue = process.env[key];
+    if (typeof processValue === "string" && processValue.trim()) {
+      return processValue.trim();
     }
   }
   return EMPTY_VALUE;
 }
-function resolveRuntimeRefName(timeline) {
-  if (!timeline) {
+function parseRefNameFromGitHubRef(ref) {
+  if (!ref) {
     return EMPTY_VALUE;
   }
-  if (timeline === "production") {
-    return "main";
-  }
-  if (timeline.startsWith("git-branch/")) {
-    return timeline.slice("git-branch/".length);
+  if (ref.startsWith(GITHUB_HEADS_PREFIX)) {
+    return ref.slice(GITHUB_HEADS_PREFIX.length);
   }
-  if (timeline.startsWith("preview/")) {
-    return timeline.slice("preview/".length);
+  if (ref.startsWith(GITHUB_TAGS_PREFIX)) {
+    return ref.slice(GITHUB_TAGS_PREFIX.length);
   }
   return EMPTY_VALUE;
 }
@@ -856,25 +864,59 @@ function overrideShortName(shortName, refName) {
   }
   return `${repository}@${refName}`;
 }
-function resolveRuntimeManifest(manifest, requestUrl) {
-  const timeline = readRuntimeTimeline();
-  const refName = resolveRuntimeRefName(timeline);
+function resolveRuntimeRefName(env) {
+  const explicitRefName = readRuntimeEnvValue(env, "REF_NAME");
+  if (explicitRefName) {
+    return explicitRefName;
+  }
+  const legacyManifestRefName = readRuntimeEnvValue(env, "PLUGIN_MANIFEST_REF_NAME");
+  if (legacyManifestRefName) {
+    return legacyManifestRefName;
+  }
+  const githubRefName = readRuntimeEnvValue(env, "GITHUB_REF_NAME");
+  if (githubRefName) {
+    return githubRefName;
+  }
+  return parseRefNameFromGitHubRef(readRuntimeEnvValue(env, "GITHUB_REF"));
+}
+function resolveRuntimeManifest(manifest, env) {
+  const refName = resolveRuntimeRefName(env);
   if (!refName) {
     return manifest;
   }
-  let homepageUrl;
-  try {
-    homepageUrl = new URL(requestUrl).origin;
-  } catch {
-    homepageUrl = void 0;
-  }
   return {
     ...manifest,
-    short_name: overrideShortName(manifest.short_name, refName),
-    ...homepageUrl ? { homepage_url: homepageUrl } : {}
+    short_name: overrideShortName(manifest.short_name, refName)
   };
 }
 
+// src/types/manifest.ts
+var runEvent = T3.Union(emitterEventNames.map((o) => T3.Literal(o)));
+var exampleCommandExecutionSchema = T3.Object({
+  commandInvocation: T3.String({ minLength: 1 }),
+  githubContext: T3.Optional(T3.Record(T3.String(), T3.Any())),
+  expectedToolCallResult: T3.Object({
+    function: T3.String({ minLength: 1 }),
+    parameters: T3.Record(T3.String(), T3.Any())
+  })
+});
+var commandSchema = T3.Object({
+  description: T3.String({ minLength: 1 }),
+  "ubiquity:example": T3.String({ minLength: 1 }),
+  parameters: T3.Optional(T3.Record(T3.String(), T3.Any())),
+  examples: T3.Optional(T3.Array(exampleCommandExecutionSchema, { default: [] }))
+});
+var manifestSchema = T3.Object({
+  name: T3.String({ minLength: 1 }),
+  short_name: T3.String({ minLength: 1 }),
+  description: T3.Optional(T3.String({ default: "" })),
+  commands: T3.Optional(T3.Record(T3.String({ pattern: "^[A-Za-z-_]+$" }), commandSchema, { default: {} })),
+  "ubiquity:listeners": T3.Optional(T3.Array(runEvent, { default: [] })),
+  configuration: T3.Optional(T3.Record(T3.String(), T3.Any(), { default: {} })),
+  skipBotEvents: T3.Optional(T3.Boolean({ default: true })),
+  homepage_url: T3.Optional(T3.String())
+});
+
 // src/server.ts
 async function handleError2(context, pluginOptions, error) {
   console.error(error);
@@ -888,7 +930,7 @@ function createPlugin(handler, manifest, options) {
   const pluginOptions = getPluginOptions(options);
   const app = new Hono();
   app.get("/manifest.json", (ctx) => {
-    return ctx.json(resolveRuntimeManifest(manifest, ctx.req.url));
+    return ctx.json(resolveRuntimeManifest(manifest, honoEnv(ctx)));
   });
   app.post("/", async function appPost(ctx) {
     if (ctx.req.header("content-type") !== "application/json") {

package/dist/manifest.d.mts

@@ -1,6 +1,9 @@
 import * as _sinclair_typebox from '@sinclair/typebox';
 import { Static } from '@sinclair/typebox';
 
+type RuntimeManifestEnv = Record<string, unknown>;
+declare function resolveRuntimeManifest(manifest: Manifest, env?: RuntimeManifestEnv): Manifest;
+
 declare const runEvent: _sinclair_typebox.TUnion<_sinclair_typebox.TLiteral<"branch_protection_configuration" | "branch_protection_configuration.disabled" | "branch_protection_configuration.enabled" | "branch_protection_rule" | "branch_protection_rule.created" | "branch_protection_rule.deleted" | "branch_protection_rule.edited" | "check_run" | "check_run.completed" | "check_run.created" | "check_run.requested_action" | "check_run.rerequested" | "check_suite" | "check_suite.completed" | "check_suite.requested" | "check_suite.rerequested" | "code_scanning_alert" | "code_scanning_alert.appeared_in_branch" | "code_scanning_alert.closed_by_user" | "code_scanning_alert.created" | "code_scanning_alert.fixed" | "code_scanning_alert.reopened" | "code_scanning_alert.reopened_by_user" | "commit_comment" | "commit_comment.created" | "create" | "custom_property" | "custom_property.created" | "custom_property.deleted" | "custom_property.promote_to_enterprise" | "custom_property.updated" | "custom_property_values" | "custom_property_values.updated" | "delete" | "dependabot_alert" | "dependabot_alert.auto_dismissed" | "dependabot_alert.auto_reopened" | "dependabot_alert.created" | "dependabot_alert.dismissed" | "dependabot_alert.fixed" | "dependabot_alert.reintroduced" | "dependabot_alert.reopened" | "deploy_key" | "deploy_key.created" | "deploy_key.deleted" | "deployment" | "deployment.created" | "deployment_protection_rule" | "deployment_protection_rule.requested" | "deployment_review" | "deployment_review.approved" | "deployment_review.rejected" | "deployment_review.requested" | "deployment_status" | "deployment_status.created" | "discussion" | "discussion.answered" | "discussion.category_changed" | "discussion.closed" | "discussion.created" | "discussion.deleted" | "discussion.edited" | "discussion.labeled" | "discussion.locked" | "discussion.pinned" | "discussion.reopened" | "discussion.transferred" | "discussion.unanswered" | "discussion.unlabeled" | "discussion.unlocked" | "discussion.unpinned" | "discussion_comment" | "discussion_comment.created" | "discussion_comment.deleted" | "discussion_comment.edited" | "fork" | "github_app_authorization" | "github_app_authorization.revoked" | "gollum" | "installation" | "installation.created" | "installation.deleted" | "installation.new_permissions_accepted" | "installation.suspend" | "installation.unsuspend" | "installation_repositories" | "installation_repositories.added" | "installation_repositories.removed" | "installation_target" | "installation_target.renamed" | "issue_comment" | "issue_comment.created" | "issue_comment.deleted" | "issue_comment.edited" | "issue_dependencies" | "issue_dependencies.blocked_by_added" | "issue_dependencies.blocked_by_removed" | "issue_dependencies.blocking_added" | "issue_dependencies.blocking_removed" | "issues" | "issues.assigned" | "issues.closed" | "issues.deleted" | "issues.demilestoned" | "issues.edited" | "issues.labeled" | "issues.locked" | "issues.milestoned" | "issues.opened" | "issues.pinned" | "issues.reopened" | "issues.transferred" | "issues.typed" | "issues.unassigned" | "issues.unlabeled" | "issues.unlocked" | "issues.unpinned" | "issues.untyped" | "label" | "label.created" | "label.deleted" | "label.edited" | "marketplace_purchase" | "marketplace_purchase.cancelled" | "marketplace_purchase.changed" | "marketplace_purchase.pending_change" | "marketplace_purchase.pending_change_cancelled" | "marketplace_purchase.purchased" | "member" | "member.added" | "member.edited" | "member.removed" | "membership" | "membership.added" | "membership.removed" | "merge_group" | "merge_group.checks_requested" | "merge_group.destroyed" | "meta" | "meta.deleted" | "milestone" | "milestone.closed" | "milestone.created" | "milestone.deleted" | "milestone.edited" | "milestone.opened" | "org_block" | "org_block.blocked" | "org_block.unblocked" | "organization" | "organization.deleted" | "organization.member_added" | "organization.member_invited" | "organization.member_removed" | "organization.renamed" | "package" | "package.published" | "package.updated" | "page_build" | "personal_access_token_request" | "personal_access_token_request.approved" | "personal_access_token_request.cancelled" | "personal_access_token_request.created" | "personal_access_token_request.denied" | "ping" | "project" | "project.closed" | "project.created" | "project.deleted" | "project.edited" | "project.reopened" | "project_card" | "project_card.converted" | "project_card.created" | "project_card.deleted" | "project_card.edited" | "project_card.moved" | "project_column" | "project_column.created" | "project_column.deleted" | "project_column.edited" | "project_column.moved" | "projects_v2" | "projects_v2.closed" | "projects_v2.created" | "projects_v2.deleted" | "projects_v2.edited" | "projects_v2.reopened" | "projects_v2_item" | "projects_v2_item.archived" | "projects_v2_item.converted" | "projects_v2_item.created" | "projects_v2_item.deleted" | "projects_v2_item.edited" | "projects_v2_item.reordered" | "projects_v2_item.restored" | "projects_v2_status_update" | "projects_v2_status_update.created" | "projects_v2_status_update.deleted" | "projects_v2_status_update.edited" | "public" | "pull_request" | "pull_request.assigned" | "pull_request.auto_merge_disabled" | "pull_request.auto_merge_enabled" | "pull_request.closed" | "pull_request.converted_to_draft" | "pull_request.demilestoned" | "pull_request.dequeued" | "pull_request.edited" | "pull_request.enqueued" | "pull_request.labeled" | "pull_request.locked" | "pull_request.milestoned" | "pull_request.opened" | "pull_request.ready_for_review" | "pull_request.reopened" | "pull_request.review_request_removed" | "pull_request.review_requested" | "pull_request.synchronize" | "pull_request.unassigned" | "pull_request.unlabeled" | "pull_request.unlocked" | "pull_request_review" | "pull_request_review.dismissed" | "pull_request_review.edited" | "pull_request_review.submitted" | "pull_request_review_comment" | "pull_request_review_comment.created" | "pull_request_review_comment.deleted" | "pull_request_review_comment.edited" | "pull_request_review_thread" | "pull_request_review_thread.resolved" | "pull_request_review_thread.unresolved" | "push" | "registry_package" | "registry_package.published" | "registry_package.updated" | "release" | "release.created" | "release.deleted" | "release.edited" | "release.prereleased" | "release.published" | "release.released" | "release.unpublished" | "repository" | "repository.archived" | "repository.created" | "repository.deleted" | "repository.edited" | "repository.privatized" | "repository.publicized" | "repository.renamed" | "repository.transferred" | "repository.unarchived" | "repository_advisory" | "repository_advisory.published" | "repository_advisory.reported" | "repository_dispatch" | "repository_dispatch.sample.collected" | "repository_import" | "repository_ruleset" | "repository_ruleset.created" | "repository_ruleset.deleted" | "repository_ruleset.edited" | "repository_vulnerability_alert" | "repository_vulnerability_alert.create" | "repository_vulnerability_alert.dismiss" | "repository_vulnerability_alert.reopen" | "repository_vulnerability_alert.resolve" | "secret_scanning_alert" | "secret_scanning_alert.assigned" | "secret_scanning_alert.created" | "secret_scanning_alert.publicly_leaked" | "secret_scanning_alert.reopened" | "secret_scanning_alert.resolved" | "secret_scanning_alert.unassigned" | "secret_scanning_alert.validated" | "secret_scanning_alert_location" | "secret_scanning_alert_location.created" | "secret_scanning_scan" | "secret_scanning_scan.completed" | "security_advisory" | "security_advisory.published" | "security_advisory.updated" | "security_advisory.withdrawn" | "security_and_analysis" | "sponsorship" | "sponsorship.cancelled" | "sponsorship.created" | "sponsorship.edited" | "sponsorship.pending_cancellation" | "sponsorship.pending_tier_change" | "sponsorship.tier_changed" | "star" | "star.created" | "star.deleted" | "status" | "sub_issues" | "sub_issues.parent_issue_added" | "sub_issues.parent_issue_removed" | "sub_issues.sub_issue_added" | "sub_issues.sub_issue_removed" | "team" | "team.added_to_repository" | "team.created" | "team.deleted" | "team.edited" | "team.removed_from_repository" | "team_add" | "watch" | "watch.started" | "workflow_dispatch" | "workflow_job" | "workflow_job.completed" | "workflow_job.in_progress" | "workflow_job.queued" | "workflow_job.waiting" | "workflow_run" | "workflow_run.completed" | "workflow_run.in_progress" | "workflow_run.requested">[]>;
 declare const exampleCommandExecutionSchema: _sinclair_typebox.TObject<{
     commandInvocation: _sinclair_typebox.TString;
@@ -47,4 +50,4 @@ declare const manifestSchema: _sinclair_typebox.TObject<{
 }>;
 type Manifest = Static<typeof manifestSchema>;
 
-export { type Manifest, commandSchema, exampleCommandExecutionSchema, manifestSchema, runEvent };
+export { type Manifest, commandSchema, exampleCommandExecutionSchema, manifestSchema, resolveRuntimeManifest, runEvent };

package/dist/manifest.d.ts

@@ -1,6 +1,9 @@
 import * as _sinclair_typebox from '@sinclair/typebox';
 import { Static } from '@sinclair/typebox';
 
+type RuntimeManifestEnv = Record<string, unknown>;
+declare function resolveRuntimeManifest(manifest: Manifest, env?: RuntimeManifestEnv): Manifest;
+
 declare const runEvent: _sinclair_typebox.TUnion<_sinclair_typebox.TLiteral<"branch_protection_configuration" | "branch_protection_configuration.disabled" | "branch_protection_configuration.enabled" | "branch_protection_rule" | "branch_protection_rule.created" | "branch_protection_rule.deleted" | "branch_protection_rule.edited" | "check_run" | "check_run.completed" | "check_run.created" | "check_run.requested_action" | "check_run.rerequested" | "check_suite" | "check_suite.completed" | "check_suite.requested" | "check_suite.rerequested" | "code_scanning_alert" | "code_scanning_alert.appeared_in_branch" | "code_scanning_alert.closed_by_user" | "code_scanning_alert.created" | "code_scanning_alert.fixed" | "code_scanning_alert.reopened" | "code_scanning_alert.reopened_by_user" | "commit_comment" | "commit_comment.created" | "create" | "custom_property" | "custom_property.created" | "custom_property.deleted" | "custom_property.promote_to_enterprise" | "custom_property.updated" | "custom_property_values" | "custom_property_values.updated" | "delete" | "dependabot_alert" | "dependabot_alert.auto_dismissed" | "dependabot_alert.auto_reopened" | "dependabot_alert.created" | "dependabot_alert.dismissed" | "dependabot_alert.fixed" | "dependabot_alert.reintroduced" | "dependabot_alert.reopened" | "deploy_key" | "deploy_key.created" | "deploy_key.deleted" | "deployment" | "deployment.created" | "deployment_protection_rule" | "deployment_protection_rule.requested" | "deployment_review" | "deployment_review.approved" | "deployment_review.rejected" | "deployment_review.requested" | "deployment_status" | "deployment_status.created" | "discussion" | "discussion.answered" | "discussion.category_changed" | "discussion.closed" | "discussion.created" | "discussion.deleted" | "discussion.edited" | "discussion.labeled" | "discussion.locked" | "discussion.pinned" | "discussion.reopened" | "discussion.transferred" | "discussion.unanswered" | "discussion.unlabeled" | "discussion.unlocked" | "discussion.unpinned" | "discussion_comment" | "discussion_comment.created" | "discussion_comment.deleted" | "discussion_comment.edited" | "fork" | "github_app_authorization" | "github_app_authorization.revoked" | "gollum" | "installation" | "installation.created" | "installation.deleted" | "installation.new_permissions_accepted" | "installation.suspend" | "installation.unsuspend" | "installation_repositories" | "installation_repositories.added" | "installation_repositories.removed" | "installation_target" | "installation_target.renamed" | "issue_comment" | "issue_comment.created" | "issue_comment.deleted" | "issue_comment.edited" | "issue_dependencies" | "issue_dependencies.blocked_by_added" | "issue_dependencies.blocked_by_removed" | "issue_dependencies.blocking_added" | "issue_dependencies.blocking_removed" | "issues" | "issues.assigned" | "issues.closed" | "issues.deleted" | "issues.demilestoned" | "issues.edited" | "issues.labeled" | "issues.locked" | "issues.milestoned" | "issues.opened" | "issues.pinned" | "issues.reopened" | "issues.transferred" | "issues.typed" | "issues.unassigned" | "issues.unlabeled" | "issues.unlocked" | "issues.unpinned" | "issues.untyped" | "label" | "label.created" | "label.deleted" | "label.edited" | "marketplace_purchase" | "marketplace_purchase.cancelled" | "marketplace_purchase.changed" | "marketplace_purchase.pending_change" | "marketplace_purchase.pending_change_cancelled" | "marketplace_purchase.purchased" | "member" | "member.added" | "member.edited" | "member.removed" | "membership" | "membership.added" | "membership.removed" | "merge_group" | "merge_group.checks_requested" | "merge_group.destroyed" | "meta" | "meta.deleted" | "milestone" | "milestone.closed" | "milestone.created" | "milestone.deleted" | "milestone.edited" | "milestone.opened" | "org_block" | "org_block.blocked" | "org_block.unblocked" | "organization" | "organization.deleted" | "organization.member_added" | "organization.member_invited" | "organization.member_removed" | "organization.renamed" | "package" | "package.published" | "package.updated" | "page_build" | "personal_access_token_request" | "personal_access_token_request.approved" | "personal_access_token_request.cancelled" | "personal_access_token_request.created" | "personal_access_token_request.denied" | "ping" | "project" | "project.closed" | "project.created" | "project.deleted" | "project.edited" | "project.reopened" | "project_card" | "project_card.converted" | "project_card.created" | "project_card.deleted" | "project_card.edited" | "project_card.moved" | "project_column" | "project_column.created" | "project_column.deleted" | "project_column.edited" | "project_column.moved" | "projects_v2" | "projects_v2.closed" | "projects_v2.created" | "projects_v2.deleted" | "projects_v2.edited" | "projects_v2.reopened" | "projects_v2_item" | "projects_v2_item.archived" | "projects_v2_item.converted" | "projects_v2_item.created" | "projects_v2_item.deleted" | "projects_v2_item.edited" | "projects_v2_item.reordered" | "projects_v2_item.restored" | "projects_v2_status_update" | "projects_v2_status_update.created" | "projects_v2_status_update.deleted" | "projects_v2_status_update.edited" | "public" | "pull_request" | "pull_request.assigned" | "pull_request.auto_merge_disabled" | "pull_request.auto_merge_enabled" | "pull_request.closed" | "pull_request.converted_to_draft" | "pull_request.demilestoned" | "pull_request.dequeued" | "pull_request.edited" | "pull_request.enqueued" | "pull_request.labeled" | "pull_request.locked" | "pull_request.milestoned" | "pull_request.opened" | "pull_request.ready_for_review" | "pull_request.reopened" | "pull_request.review_request_removed" | "pull_request.review_requested" | "pull_request.synchronize" | "pull_request.unassigned" | "pull_request.unlabeled" | "pull_request.unlocked" | "pull_request_review" | "pull_request_review.dismissed" | "pull_request_review.edited" | "pull_request_review.submitted" | "pull_request_review_comment" | "pull_request_review_comment.created" | "pull_request_review_comment.deleted" | "pull_request_review_comment.edited" | "pull_request_review_thread" | "pull_request_review_thread.resolved" | "pull_request_review_thread.unresolved" | "push" | "registry_package" | "registry_package.published" | "registry_package.updated" | "release" | "release.created" | "release.deleted" | "release.edited" | "release.prereleased" | "release.published" | "release.released" | "release.unpublished" | "repository" | "repository.archived" | "repository.created" | "repository.deleted" | "repository.edited" | "repository.privatized" | "repository.publicized" | "repository.renamed" | "repository.transferred" | "repository.unarchived" | "repository_advisory" | "repository_advisory.published" | "repository_advisory.reported" | "repository_dispatch" | "repository_dispatch.sample.collected" | "repository_import" | "repository_ruleset" | "repository_ruleset.created" | "repository_ruleset.deleted" | "repository_ruleset.edited" | "repository_vulnerability_alert" | "repository_vulnerability_alert.create" | "repository_vulnerability_alert.dismiss" | "repository_vulnerability_alert.reopen" | "repository_vulnerability_alert.resolve" | "secret_scanning_alert" | "secret_scanning_alert.assigned" | "secret_scanning_alert.created" | "secret_scanning_alert.publicly_leaked" | "secret_scanning_alert.reopened" | "secret_scanning_alert.resolved" | "secret_scanning_alert.unassigned" | "secret_scanning_alert.validated" | "secret_scanning_alert_location" | "secret_scanning_alert_location.created" | "secret_scanning_scan" | "secret_scanning_scan.completed" | "security_advisory" | "security_advisory.published" | "security_advisory.updated" | "security_advisory.withdrawn" | "security_and_analysis" | "sponsorship" | "sponsorship.cancelled" | "sponsorship.created" | "sponsorship.edited" | "sponsorship.pending_cancellation" | "sponsorship.pending_tier_change" | "sponsorship.tier_changed" | "star" | "star.created" | "star.deleted" | "status" | "sub_issues" | "sub_issues.parent_issue_added" | "sub_issues.parent_issue_removed" | "sub_issues.sub_issue_added" | "sub_issues.sub_issue_removed" | "team" | "team.added_to_repository" | "team.created" | "team.deleted" | "team.edited" | "team.removed_from_repository" | "team_add" | "watch" | "watch.started" | "workflow_dispatch" | "workflow_job" | "workflow_job.completed" | "workflow_job.in_progress" | "workflow_job.queued" | "workflow_job.waiting" | "workflow_run" | "workflow_run.completed" | "workflow_run.in_progress" | "workflow_run.requested">[]>;
 declare const exampleCommandExecutionSchema: _sinclair_typebox.TObject<{
     commandInvocation: _sinclair_typebox.TString;
@@ -47,4 +50,4 @@ declare const manifestSchema: _sinclair_typebox.TObject<{
 }>;
 type Manifest = Static<typeof manifestSchema>;
 
-export { type Manifest, commandSchema, exampleCommandExecutionSchema, manifestSchema, runEvent };
+export { type Manifest, commandSchema, exampleCommandExecutionSchema, manifestSchema, resolveRuntimeManifest, runEvent };

package/dist/manifest.js

@@ -23,11 +23,87 @@ __export(manifest_exports, {
   commandSchema: () => commandSchema,
   exampleCommandExecutionSchema: () => exampleCommandExecutionSchema,
   manifestSchema: () => manifestSchema,
+  resolveRuntimeManifest: () => resolveRuntimeManifest,
   runEvent: () => runEvent
 });
 module.exports = __toCommonJS(manifest_exports);
 var import_typebox = require("@sinclair/typebox");
 var import_webhooks = require("@octokit/webhooks");
+
+// src/helpers/runtime-manifest.ts
+var EMPTY_VALUE = String();
+var GITHUB_HEADS_PREFIX = "refs/heads/";
+var GITHUB_TAGS_PREFIX = "refs/tags/";
+function readRuntimeEnvValue(env, key) {
+  const explicitValue = env?.[key];
+  if (typeof explicitValue === "string" && explicitValue.trim()) {
+    return explicitValue.trim();
+  }
+  const runtime = globalThis;
+  if (typeof runtime.Deno?.env?.get === "function") {
+    const denoValue = runtime.Deno.env.get(key);
+    if (typeof denoValue === "string" && denoValue.trim()) {
+      return denoValue.trim();
+    }
+  }
+  if (typeof process !== "undefined") {
+    const processValue = process.env[key];
+    if (typeof processValue === "string" && processValue.trim()) {
+      return processValue.trim();
+    }
+  }
+  return EMPTY_VALUE;
+}
+function parseRefNameFromGitHubRef(ref) {
+  if (!ref) {
+    return EMPTY_VALUE;
+  }
+  if (ref.startsWith(GITHUB_HEADS_PREFIX)) {
+    return ref.slice(GITHUB_HEADS_PREFIX.length);
+  }
+  if (ref.startsWith(GITHUB_TAGS_PREFIX)) {
+    return ref.slice(GITHUB_TAGS_PREFIX.length);
+  }
+  return EMPTY_VALUE;
+}
+function overrideShortName(shortName, refName) {
+  if (!shortName || !refName) {
+    return shortName;
+  }
+  const separatorIndex = shortName.lastIndexOf("@");
+  const repository = separatorIndex === -1 ? shortName : shortName.slice(0, separatorIndex);
+  if (!repository) {
+    return shortName;
+  }
+  return `${repository}@${refName}`;
+}
+function resolveRuntimeRefName(env) {
+  const explicitRefName = readRuntimeEnvValue(env, "REF_NAME");
+  if (explicitRefName) {
+    return explicitRefName;
+  }
+  const legacyManifestRefName = readRuntimeEnvValue(env, "PLUGIN_MANIFEST_REF_NAME");
+  if (legacyManifestRefName) {
+    return legacyManifestRefName;
+  }
+  const githubRefName = readRuntimeEnvValue(env, "GITHUB_REF_NAME");
+  if (githubRefName) {
+    return githubRefName;
+  }
+  return parseRefNameFromGitHubRef(readRuntimeEnvValue(env, "GITHUB_REF"));
+}
+function resolveRuntimeManifest(manifest, env) {
+  const refName = resolveRuntimeRefName(env);
+  if (!refName) {
+    return manifest;
+  }
+  return {
+    ...manifest,
+    short_name: overrideShortName(manifest.short_name, refName)
+  };
+}
+
+// src/types/manifest.ts
 var runEvent = import_typebox.Type.Union(import_webhooks.emitterEventNames.map((o) => import_typebox.Type.Literal(o)));
 var exampleCommandExecutionSchema = import_typebox.Type.Object({
   commandInvocation: import_typebox.Type.String({ minLength: 1 }),
@@ -58,5 +134,6 @@ var manifestSchema = import_typebox.Type.Object({
   commandSchema,
   exampleCommandExecutionSchema,
   manifestSchema,
+  resolveRuntimeManifest,
   runEvent
 });

package/dist/manifest.mjs

@@ -1,6 +1,81 @@
 // src/types/manifest.ts
 import { Type as T } from "@sinclair/typebox";
 import { emitterEventNames } from "@octokit/webhooks";
+
+// src/helpers/runtime-manifest.ts
+var EMPTY_VALUE = String();
+var GITHUB_HEADS_PREFIX = "refs/heads/";
+var GITHUB_TAGS_PREFIX = "refs/tags/";
+function readRuntimeEnvValue(env, key) {
+  const explicitValue = env?.[key];
+  if (typeof explicitValue === "string" && explicitValue.trim()) {
+    return explicitValue.trim();
+  }
+  const runtime = globalThis;
+  if (typeof runtime.Deno?.env?.get === "function") {
+    const denoValue = runtime.Deno.env.get(key);
+    if (typeof denoValue === "string" && denoValue.trim()) {
+      return denoValue.trim();
+    }
+  }
+  if (typeof process !== "undefined") {
+    const processValue = process.env[key];
+    if (typeof processValue === "string" && processValue.trim()) {
+      return processValue.trim();
+    }
+  }
+  return EMPTY_VALUE;
+}
+function parseRefNameFromGitHubRef(ref) {
+  if (!ref) {
+    return EMPTY_VALUE;
+  }
+  if (ref.startsWith(GITHUB_HEADS_PREFIX)) {
+    return ref.slice(GITHUB_HEADS_PREFIX.length);
+  }
+  if (ref.startsWith(GITHUB_TAGS_PREFIX)) {
+    return ref.slice(GITHUB_TAGS_PREFIX.length);
+  }
+  return EMPTY_VALUE;
+}
+function overrideShortName(shortName, refName) {
+  if (!shortName || !refName) {
+    return shortName;
+  }
+  const separatorIndex = shortName.lastIndexOf("@");
+  const repository = separatorIndex === -1 ? shortName : shortName.slice(0, separatorIndex);
+  if (!repository) {
+    return shortName;
+  }
+  return `${repository}@${refName}`;
+}
+function resolveRuntimeRefName(env) {
+  const explicitRefName = readRuntimeEnvValue(env, "REF_NAME");
+  if (explicitRefName) {
+    return explicitRefName;
+  }
+  const legacyManifestRefName = readRuntimeEnvValue(env, "PLUGIN_MANIFEST_REF_NAME");
+  if (legacyManifestRefName) {
+    return legacyManifestRefName;
+  }
+  const githubRefName = readRuntimeEnvValue(env, "GITHUB_REF_NAME");
+  if (githubRefName) {
+    return githubRefName;
+  }
+  return parseRefNameFromGitHubRef(readRuntimeEnvValue(env, "GITHUB_REF"));
+}
+function resolveRuntimeManifest(manifest, env) {
+  const refName = resolveRuntimeRefName(env);
+  if (!refName) {
+    return manifest;
+  }
+  return {
+    ...manifest,
+    short_name: overrideShortName(manifest.short_name, refName)
+  };
+}
+
+// src/types/manifest.ts
 var runEvent = T.Union(emitterEventNames.map((o) => T.Literal(o)));
 var exampleCommandExecutionSchema = T.Object({
   commandInvocation: T.String({ minLength: 1 }),
@@ -30,5 +105,6 @@ export {
   commandSchema,
   exampleCommandExecutionSchema,
   manifestSchema,
+  resolveRuntimeManifest,
   runEvent
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ubiquity-os/plugin-sdk",
-  "version": "3.12.4",
+  "version": "3.12.5",
   "description": "SDK for plugin support.",
   "author": "Ubiquity DAO",
   "license": "MIT",