@vess-id/ai-identity 0.8.0 → 0.10.0

package/dist/index.mjs

@@ -1976,7 +1976,7 @@ var ToolManager = class {
             projectKey: "string",
             summary: "string",
             description: "string?",
-            issueType: "string",
+            issueTypeName: "string",
             priority: "string?",
             assignee: "string?"
           }
@@ -4543,11 +4543,39 @@ var ACTION_REGISTRY = {
       },
       version: "1.0.0"
     },
+    {
+      action: "slack.message.read_paginated",
+      resource_type: "slack:channel",
+      required_relations: ["viewer", "editor", "admin", "owner"],
+      required_scopes: ["channels:history", "groups:history"],
+      capability: "slack.read.basic",
+      input_schema: {
+        type: "object",
+        properties: {
+          channel: { type: "string", description: "Channel ID, channel name, or channel name with # prefix" },
+          cursor: { type: "string", description: "Pagination cursor from previous response" },
+          limit: { type: "integer", minimum: 1, maximum: 30 }
+        },
+        required: ["channel"],
+        additionalProperties: false
+      },
+      constraints: { rate_bucket: "slack.read" },
+      effects: ["Read:Message"],
+      risk: "low",
+      target_bindings: {
+        resource_id: { source: "param", param: "channel" }
+      },
+      version: "1.0.0"
+    },
     {
       action: "slack.batch.read",
       resource_type: "slack:channel",
       required_relations: ["viewer", "editor", "admin", "owner"],
-      required_scopes: ["channels:read", "groups:read", "channels:history", "groups:history"],
+      // Documentation only — NOT used for runtime access control.
+      // Actual permission granting uses parseSlackScopes (oauth.service.ts) with OR-logic:
+      // any read scope + any history scope grants slack.batch.read.
+      // Tokens with partial scopes (e.g. channels:read + channels:history) will still receive this permission.
+      required_scopes: ["channels:read", "groups:read", "im:read", "mpim:read", "channels:history", "groups:history", "im:history", "mpim:history"],
       capability: "slack.read.basic",
       input_schema: {
         type: "object",
@@ -4919,10 +4947,10 @@ var ACTION_REGISTRY = {
       input_schema: {
         type: "object",
         properties: {
-          calendarId: { type: "string" },
-          timeMin: { type: "string" },
-          timeMax: { type: "string" },
-          maxResults: { type: "integer", minimum: 1, maximum: 2500 }
+          calendarId: { type: "string", description: "Calendar ID (email address). Defaults to primary calendar." },
+          timeMin: { type: "string", description: 'Lower bound (inclusive) for event start time, as ISO 8601 datetime, e.g. "2025-01-15T00:00:00Z"' },
+          timeMax: { type: "string", description: 'Upper bound (exclusive) for event start time, as ISO 8601 datetime, e.g. "2025-01-16T00:00:00Z"' },
+          maxResults: { type: "integer", minimum: 1, maximum: 2500, description: "Maximum number of events to return" }
         },
         additionalProperties: false
       },
@@ -4966,13 +4994,29 @@ var ACTION_REGISTRY = {
       input_schema: {
         type: "object",
         properties: {
-          calendarId: { type: "string" },
-          summary: { type: "string", minLength: 1 },
-          description: { type: "string" },
-          start: { type: "object" },
-          end: { type: "object" },
-          attendees: { type: "array" },
-          location: { type: "string" }
+          calendarId: { type: "string", description: "Calendar ID (email address). Defaults to primary calendar." },
+          summary: { type: "string", minLength: 1, description: "Event title" },
+          description: { type: "string", description: "Event description" },
+          start: {
+            type: "object",
+            description: "Start time. Use dateTime + timeZone for timed events, or date for all-day events.",
+            properties: {
+              dateTime: { type: "string", description: 'ISO 8601 datetime, e.g. "2025-01-15T10:00:00"' },
+              date: { type: "string", description: 'Date for all-day event, e.g. "2025-01-15"' },
+              timeZone: { type: "string", description: 'IANA time zone, e.g. "Asia/Tokyo"' }
+            }
+          },
+          end: {
+            type: "object",
+            description: "End time. Use dateTime + timeZone for timed events, or date for all-day events.",
+            properties: {
+              dateTime: { type: "string", description: 'ISO 8601 datetime, e.g. "2025-01-15T11:00:00"' },
+              date: { type: "string", description: 'Date for all-day event, e.g. "2025-01-16"' },
+              timeZone: { type: "string", description: 'IANA time zone, e.g. "Asia/Tokyo"' }
+            }
+          },
+          attendees: { type: "array", description: "List of attendee objects with email field", items: { type: "object", properties: { email: { type: "string" } } } },
+          location: { type: "string", description: "Event location" }
         },
         required: ["summary", "start", "end"],
         additionalProperties: false
@@ -4997,14 +5041,30 @@ var ACTION_REGISTRY = {
       input_schema: {
         type: "object",
         properties: {
-          calendarId: { type: "string" },
-          eventId: { type: "string", minLength: 1 },
-          summary: { type: "string" },
-          description: { type: "string" },
-          start: { type: "object" },
-          end: { type: "object" },
-          attendees: { type: "array" },
-          location: { type: "string" }
+          calendarId: { type: "string", description: "Calendar ID (email address). Defaults to primary calendar." },
+          eventId: { type: "string", minLength: 1, description: "Event ID to update" },
+          summary: { type: "string", description: "Event title" },
+          description: { type: "string", description: "Event description" },
+          start: {
+            type: "object",
+            description: "Start time. Use dateTime + timeZone for timed events, or date for all-day events.",
+            properties: {
+              dateTime: { type: "string", description: 'ISO 8601 datetime, e.g. "2025-01-15T10:00:00"' },
+              date: { type: "string", description: 'Date for all-day event, e.g. "2025-01-15"' },
+              timeZone: { type: "string", description: 'IANA time zone, e.g. "Asia/Tokyo"' }
+            }
+          },
+          end: {
+            type: "object",
+            description: "End time. Use dateTime + timeZone for timed events, or date for all-day events.",
+            properties: {
+              dateTime: { type: "string", description: 'ISO 8601 datetime, e.g. "2025-01-15T11:00:00"' },
+              date: { type: "string", description: 'Date for all-day event, e.g. "2025-01-16"' },
+              timeZone: { type: "string", description: 'IANA time zone, e.g. "Asia/Tokyo"' }
+            }
+          },
+          attendees: { type: "array", description: "List of attendee objects with email field", items: { type: "object", properties: { email: { type: "string" } } } },
+          location: { type: "string", description: "Event location" }
         },
         required: ["eventId"],
         additionalProperties: false
@@ -5013,7 +5073,7 @@ var ACTION_REGISTRY = {
       effects: ["Update:Event"],
       risk: "medium",
       target_bindings: {
-        resource_id: { source: "param", param: "eventId" },
+        resource_id: { source: "param", param: "calendarId", default: "primary" },
         secondary: [
           { name: "attendees", source: { source: "param", param: "attendees" }, type: "participant" }
         ]
@@ -5039,7 +5099,7 @@ var ACTION_REGISTRY = {
       effects: ["Delete:Event"],
       risk: "high",
       target_bindings: {
-        resource_id: { source: "param", param: "eventId" }
+        resource_id: { source: "param", param: "calendarId", default: "primary" }
       },
       version: "1.0.0"
     },
@@ -5175,7 +5235,7 @@ var ACTION_REGISTRY = {
       effects: ["Read:Worklog"],
       risk: "low",
       target_bindings: {
-        resource_id: { source: "param", param: "issueIdOrKey" }
+        resource_id: { source: "param", param: "issueIdOrKey", fallback_param: "issueKey" }
       },
       version: "1.0.0"
     },
@@ -5197,13 +5257,13 @@ var ACTION_REGISTRY = {
       effects: ["Read:Issue"],
       risk: "low",
       target_bindings: {
-        resource_id: { source: "param", param: "issueIdOrKey" }
+        resource_id: { source: "param", param: "issueIdOrKey", fallback_param: "issueKey" }
       },
       version: "1.0.0"
     },
     {
       action: "jira.issue.create",
-      resource_type: "jira:issue",
+      resource_type: "jira:project",
       required_relations: ["editor", "act_as"],
       required_scopes: ["write:jira-work"],
       capability: "jira.write.basic",
@@ -5213,11 +5273,12 @@ var ACTION_REGISTRY = {
           projectKey: { type: "string", minLength: 1 },
           summary: { type: "string", minLength: 1 },
           description: { type: "string" },
-          issueType: { type: "string", minLength: 1 },
+          issueTypeName: { type: "string", minLength: 1, description: "Issue type name (default: Task)" },
           priority: { type: "string" },
-          assignee: { type: "string" }
+          assigneeAccountId: { type: "string" },
+          labels: { type: "array", items: { type: "string" } }
         },
-        required: ["projectKey", "summary", "issueType"],
+        required: ["projectKey", "summary"],
         additionalProperties: false
       },
       constraints: { rate_bucket: "jira.write" },
@@ -5230,7 +5291,7 @@ var ACTION_REGISTRY = {
     },
     {
       action: "jira.issue.update",
-      resource_type: "jira:issue",
+      resource_type: "jira:project",
       required_relations: ["editor", "act_as"],
       required_scopes: ["write:jira-work"],
       capability: "jira.write.basic",
@@ -5240,9 +5301,9 @@ var ACTION_REGISTRY = {
           issueIdOrKey: { type: "string", minLength: 1 },
           summary: { type: "string" },
           description: { type: "string" },
-          status: { type: "string" },
           priority: { type: "string" },
-          assignee: { type: "string" }
+          assigneeAccountId: { type: "string" },
+          labels: { type: "array", items: { type: "string" } }
         },
         required: ["issueIdOrKey"],
         additionalProperties: false
@@ -5251,13 +5312,13 @@ var ACTION_REGISTRY = {
       effects: ["Update:Issue"],
       risk: "high",
       target_bindings: {
-        resource_id: { source: "param", param: "issueIdOrKey" }
+        resource_id: { source: "param", param: "issueIdOrKey", fallback_param: "issueKey", derive: "project_key" }
       },
       version: "1.0.0"
     },
     {
       action: "jira.issue.delete",
-      resource_type: "jira:issue",
+      resource_type: "jira:project",
       required_relations: ["admin", "owner", "act_as"],
       required_scopes: ["write:jira-work"],
       capability: "jira.write.basic",
@@ -5273,7 +5334,98 @@ var ACTION_REGISTRY = {
       effects: ["Delete:Issue"],
       risk: "high",
       target_bindings: {
-        resource_id: { source: "param", param: "issueIdOrKey" }
+        resource_id: { source: "param", param: "issueIdOrKey", fallback_param: "issueKey", derive: "project_key" }
+      },
+      version: "1.0.0"
+    },
+    {
+      action: "jira.comment.create",
+      resource_type: "jira:project",
+      required_relations: ["editor", "act_as"],
+      required_scopes: ["write:jira-work"],
+      capability: "jira.write.basic",
+      input_schema: {
+        type: "object",
+        properties: {
+          issueIdOrKey: { type: "string", minLength: 1 },
+          body: { type: "string", minLength: 1 }
+        },
+        required: ["issueIdOrKey", "body"],
+        additionalProperties: false
+      },
+      constraints: { rate_bucket: "jira.write" },
+      effects: ["Create:Comment"],
+      // high: comments are publicly visible to all project members, consistent with jira.issue.update
+      risk: "high",
+      target_bindings: {
+        resource_id: { source: "param", param: "issueIdOrKey", fallback_param: "issueKey", derive: "project_key" }
+      },
+      version: "1.0.0"
+    },
+    {
+      action: "jira.comment.read",
+      resource_type: "jira:project",
+      required_relations: ["viewer", "editor", "act_as"],
+      required_scopes: ["read:jira-work"],
+      capability: "jira.read.basic",
+      input_schema: {
+        type: "object",
+        properties: {
+          issueIdOrKey: { type: "string", minLength: 1 }
+        },
+        required: ["issueIdOrKey"],
+        additionalProperties: false
+      },
+      constraints: { rate_bucket: "jira.read" },
+      effects: ["Read:Comment"],
+      risk: "low",
+      target_bindings: {
+        resource_id: { source: "param", param: "issueIdOrKey", fallback_param: "issueKey", derive: "project_key" }
+      },
+      version: "1.0.0"
+    },
+    {
+      action: "jira.issue.transition",
+      resource_type: "jira:project",
+      required_relations: ["editor", "act_as"],
+      required_scopes: ["write:jira-work"],
+      capability: "jira.write.basic",
+      input_schema: {
+        type: "object",
+        properties: {
+          issueIdOrKey: { type: "string", minLength: 1 },
+          transitionId: { type: "string", minLength: 1 }
+        },
+        required: ["issueIdOrKey", "transitionId"],
+        additionalProperties: false
+      },
+      constraints: { rate_bucket: "jira.write" },
+      effects: ["Update:IssueStatus"],
+      risk: "high",
+      target_bindings: {
+        resource_id: { source: "param", param: "issueIdOrKey", fallback_param: "issueKey", derive: "project_key" }
+      },
+      version: "1.0.0"
+    },
+    {
+      action: "jira.transition.list",
+      resource_type: "jira:project",
+      required_relations: ["viewer", "editor", "act_as"],
+      required_scopes: ["read:jira-work"],
+      capability: "jira.read.basic",
+      input_schema: {
+        type: "object",
+        properties: {
+          issueIdOrKey: { type: "string", minLength: 1 }
+        },
+        required: ["issueIdOrKey"],
+        additionalProperties: false
+      },
+      constraints: { rate_bucket: "jira.read" },
+      effects: ["Read:Transition"],
+      risk: "low",
+      target_bindings: {
+        resource_id: { source: "param", param: "issueIdOrKey", fallback_param: "issueKey", derive: "project_key" }
       },
       version: "1.0.0"
     },
@@ -5390,7 +5542,7 @@ var ACTION_REGISTRY = {
     {
       capability: "slack.read.basic",
       description: "Read channels, messages, and user info",
-      includes: ["slack.channel.read", "slack.user.read", "slack.message.read", "slack.batch.read"],
+      includes: ["slack.channel.read", "slack.user.read", "slack.message.read", "slack.message.read_paginated", "slack.batch.read"],
       version: "1.0.0"
     },
     {
@@ -5438,13 +5590,13 @@ var ACTION_REGISTRY = {
     {
       capability: "jira.read.basic",
       description: "Read Jira issues, projects, boards, and sprints",
-      includes: ["jira.project.read", "jira.board.read", "jira.sprint.read", "jira.issue.list", "jira.issue.search", "jira.worklog.read", "jira.issue.read", "jira.batch.read"],
+      includes: ["jira.project.read", "jira.board.read", "jira.sprint.read", "jira.issue.list", "jira.issue.search", "jira.worklog.read", "jira.issue.read", "jira.batch.read", "jira.comment.read", "jira.transition.list"],
       version: "1.0.0"
     },
     {
       capability: "jira.write.basic",
       description: "Create, update, and delete Jira issues",
-      includes: ["jira.issue.create", "jira.issue.update", "jira.issue.delete"],
+      includes: ["jira.issue.create", "jira.issue.update", "jira.issue.delete", "jira.comment.create", "jira.issue.transition"],
       version: "1.0.0"
     }
   ]
@@ -5609,7 +5761,164 @@ function normalizeMcpActionName(toolName, actionName) {
   return actionName;
 }
 
+// src/registry/action-summary.ts
+var ACTION_DISPLAY_CONFIGS = {
+  "slack.message.post": {
+    summaryTemplate: (p) => {
+      const parts = [];
+      if (p.channel) parts.push(p.channel + ":");
+      if (p.text) parts.push(String(p.text));
+      return parts.join(" ");
+    },
+    displayFields: [
+      { key: "channel", label: "Channel" },
+      { key: "text", label: "Message" }
+    ]
+  },
+  "gmail.message.send": {
+    summaryTemplate: (p) => {
+      const parts = [];
+      if (p.to) parts.push(`To: ${p.to}`);
+      if (p.subject) parts.push(`Subject: ${p.subject}`);
+      return parts.join(", ");
+    },
+    displayFields: [
+      { key: "to", label: "To" },
+      { key: "subject", label: "Subject" },
+      { key: "body", label: "Body" }
+    ]
+  },
+  "gmail.draft.create": {
+    summaryTemplate: (p) => {
+      const parts = [];
+      if (p.to) parts.push(`To: ${p.to}`);
+      if (p.subject) parts.push(`Subject: ${p.subject}`);
+      return parts.join(", ");
+    },
+    displayFields: [
+      { key: "to", label: "To" },
+      { key: "subject", label: "Subject" },
+      { key: "body", label: "Body" }
+    ]
+  },
+  "calendar.event.create": {
+    summaryTemplate: (p) => {
+      const parts = [];
+      if (p.summary) parts.push(p.summary);
+      if (p.start) parts.push(`(${formatValue(p.start)})`);
+      return parts.join(" ");
+    },
+    displayFields: [
+      { key: "summary", label: "Event" },
+      { key: "start", label: "Start" },
+      { key: "end", label: "End" },
+      { key: "attendees", label: "Attendees" }
+    ]
+  },
+  "calendar.event.update": {
+    summaryTemplate: (p) => {
+      const parts = [];
+      if (p.summary) parts.push(p.summary);
+      if (p.start) parts.push(`(${formatValue(p.start)})`);
+      return parts.join(" ");
+    },
+    displayFields: [
+      { key: "summary", label: "Event" },
+      { key: "start", label: "Start" },
+      { key: "end", label: "End" },
+      { key: "attendees", label: "Attendees" }
+    ]
+  },
+  "jira.issue.create": {
+    summaryTemplate: (p) => {
+      const parts = [];
+      if (p.project) parts.push(`${p.project}:`);
+      if (p.summary) parts.push(p.summary);
+      return parts.join(" ");
+    },
+    displayFields: [
+      { key: "project", label: "Project" },
+      { key: "issuetype", label: "Type" },
+      { key: "summary", label: "Summary" },
+      { key: "description", label: "Description" }
+    ]
+  },
+  "jira.issue.update": {
+    summaryTemplate: (p) => {
+      const parts = [];
+      if (p.issueKey) parts.push(`${p.issueKey}:`);
+      if (p.summary) parts.push(p.summary);
+      return parts.join(" ");
+    },
+    displayFields: [
+      { key: "issueKey", label: "Issue" },
+      { key: "summary", label: "Summary" },
+      { key: "description", label: "Description" }
+    ]
+  }
+};
+function truncate(text, maxLength) {
+  if (text.length <= maxLength) return text;
+  return text.slice(0, maxLength - 3) + "...";
+}
+function formatValue(value) {
+  if (value === null || value === void 0) return "";
+  if (Array.isArray(value)) {
+    return value.map((item) => {
+      if (item && typeof item === "object") {
+        const email = item.email;
+        if (email) return String(email);
+        return JSON.stringify(item);
+      }
+      return String(item);
+    }).join(", ");
+  }
+  if (typeof value === "object") {
+    const obj = value;
+    if (obj.dateTime) {
+      return obj.timeZone ? `${obj.dateTime} (${obj.timeZone})` : String(obj.dateTime);
+    }
+    if (obj.date) return String(obj.date);
+    return JSON.stringify(value);
+  }
+  return String(value);
+}
+var ACTION_PARAMS_MAX_SIZE = 1e4;
+function generateActionSummary(action, params, maxLength = 50) {
+  if (!params || Object.keys(params).length === 0) return "";
+  const config = ACTION_DISPLAY_CONFIGS[action];
+  if (config) {
+    const raw = config.summaryTemplate(params);
+    return raw ? truncate(raw, maxLength) : "";
+  }
+  for (const [key, val] of Object.entries(params)) {
+    if (val !== null && val !== void 0 && typeof val !== "object") {
+      return truncate(`${key}: ${String(val)}`, maxLength);
+    }
+  }
+  return "";
+}
+function generateActionParamsDisplay(action, params) {
+  if (!params || Object.keys(params).length === 0) return [];
+  const config = ACTION_DISPLAY_CONFIGS[action];
+  if (config) {
+    return config.displayFields.filter((f) => params[f.key] !== void 0 && params[f.key] !== null).map((f) => ({
+      label: f.label,
+      value: formatValue(params[f.key])
+    }));
+  }
+  return Object.entries(params).filter(([, v]) => v !== void 0 && v !== null).slice(0, 3).map(([key, val]) => ({
+    label: key,
+    value: formatValue(val)
+  }));
+}
+
 // src/resolver/target-resolver.ts
+var PROJECT_KEY_PATTERN = /^([A-Z][A-Z0-9_]+)-\d+$/;
+function extractProjectKey(value) {
+  const match = value.match(PROJECT_KEY_PATTERN);
+  return match ? match[1] : null;
+}
 var TargetResolver = class {
   /**
    * Resolve target bindings against tool invocation parameters.
@@ -5637,20 +5946,27 @@ var TargetResolver = class {
     }
     const paramBinding = binding;
     let rawValue = params[paramBinding.param];
+    if (rawValue == null && paramBinding.fallback_param) {
+      rawValue = params[paramBinding.fallback_param];
+    }
     if (rawValue == null && paramBinding.default != null) {
       rawValue = paramBinding.default;
     }
     if (rawValue == null) return { value: null };
     if (typeof rawValue !== "string") return { value: null };
+    let strValue = rawValue;
+    if (paramBinding.derive === "project_key") {
+      strValue = extractProjectKey(strValue) ?? strValue;
+    }
     if (paramBinding.multi) {
       const separator = paramBinding.separator ?? ",";
-      const values = rawValue.split(separator).map((v) => v.trim()).filter((v) => v.length > 0);
+      const values = strValue.split(separator).map((v) => v.trim()).filter((v) => v.length > 0);
       return {
         value: values[0] ?? null,
         values
       };
     }
-    return { value: rawValue };
+    return { value: strValue };
   }
   resolveSecondary(secondary, params, context) {
     if (!secondary || secondary.length === 0) return [];
@@ -5702,6 +6018,7 @@ function getTierLimits(tier) {
 // src/index.ts
 var version = "0.0.1";
 export {
+  ACTION_PARAMS_MAX_SIZE,
   ACTION_PREFIXES,
   ACTION_REGISTRY,
   AIdentityClient,
@@ -5767,8 +6084,11 @@ export {
   credentialStatusToVCStatus,
   defaultConstraintEvaluator,
   evaluateConstraints,
+  extractProjectKey,
   extractPublicKey,
   extractPublicKeyFromDid,
+  generateActionParamsDisplay,
+  generateActionSummary,
   generateKeyPair,
   generateNonce,
   getActionAliases,