@cuylabs/channel-slack 0.1.0 → 0.2.0

package/README.md

@@ -1,14 +1,14 @@
 # @cuylabs/channel-slack
 
-SDK-neutral Slack channel primitives for AI agents.
+Slack channel primitives for AI agents.
 
 This package contains reusable Slack mechanics: activity parsing, message
 formatting, message admission policy, supplemental history, visibility filters,
 Socket Mode runtime guards, OAuth installation storage, setup inspection, and
 Slack API helpers. It intentionally does not create or run an agent.
 
-It is not an agent runtime adapter. For the `@cuylabs/agent-core` binding, use
-`@cuylabs/channel-slack-agent-core`. See
+It is not an agent runtime adapter. Use `@cuylabs/channel-slack-agent-core` for
+the runtime-specific adapter. See
 [Channel Slack Boundary](docs/reference/channel-slack-boundary.md) for the
 package boundary.
 
@@ -32,7 +32,7 @@ surface they need.
 
 | Import | Use for |
 | --- | --- |
-| `@cuylabs/channel-slack/core` | SDK-neutral activity parsing, formatting, sessions, turn context, shared types |
+| `@cuylabs/channel-slack/core` | Activity parsing, formatting, sessions, turn context, shared types |
 | `@cuylabs/channel-slack/policy` | Message admission, duplicate suppression, mentioned-thread state |
 | `@cuylabs/channel-slack/history` | Slack history reading, prompt shaping, supplemental-history visibility |
 | `@cuylabs/channel-slack/bolt` | Bolt app factories, auth options, Socket Mode runtime helpers, installation stores |
@@ -132,7 +132,7 @@ See [Setup Requirements](docs/concepts/setup-requirements.md).
 ```text
 src/
   core.ts                 public core entrypoint
-  shared/                 SDK-neutral types, parsing, formatting, turn helpers
+  shared/                 types, parsing, formatting, turn helpers
   assistant/              Slack Assistant API helpers
   bolt/                   Bolt app/auth/runtime helpers
   diagnostics/            token and scope inspection

package/dist/bolt.d.ts

@@ -1,5 +1,6 @@
 import { Application } from 'express';
-import { AppOptions, ExpressReceiverOptions, App, ExpressReceiver, SocketModeReceiverOptions } from '@slack/bolt';
+import { AppOptions, ExpressReceiverOptions, App, ExpressReceiver, SocketModeReceiverOptions, Logger as Logger$1 } from '@slack/bolt';
+export { LogLevel as SlackSdkLogLevel, Logger as SlackSdkLogger } from '@slack/bolt';
 import { IncomingMessage, ServerResponse } from 'node:http';
 import { L as Logger } from './logging-Bl3HfcC8.js';
 
@@ -261,16 +262,6 @@ interface SlackSocketModeProcessLock {
 }
 declare function acquireSlackSocketModeProcessLock({ appSlug, appToken, enabled, lockDir, logger, }: SlackSocketModeProcessLockOptions): SlackSocketModeProcessLock | undefined;
 
-type SlackSdkLogLevel = "debug" | "info" | "warn" | "error";
-interface SlackSdkLogger {
-    debug(...msg: unknown[]): void;
-    error(...msg: unknown[]): void;
-    getLevel(): SlackSdkLogLevel;
-    info(...msg: unknown[]): void;
-    setLevel(nextLevel: SlackSdkLogLevel): void;
-    setName(nextName: string): void;
-    warn(...msg: unknown[]): void;
-}
 type SlackSocketModeRuntimePolicy = "single-instance" | "external-coordination";
 interface SlackSocketModeReceiverRuntimeOptions {
     autoReconnectEnabled?: boolean;
@@ -297,7 +288,7 @@ interface SlackSocketModeRuntimeOptions {
 }
 interface SlackSocketModeRuntime {
     boltAppOptions: {
-        logger: SlackSdkLogger;
+        logger: Logger$1;
     };
     close(): void;
     socketModeReceiverOptions: SlackSocketModeReceiverRuntimeOptions;
@@ -317,7 +308,7 @@ declare function createSlackSdkLogger({ level, logger, restartGuard, }: {
     level: "debug" | "info" | "warn" | "error";
     logger?: Logger;
     restartGuard?: SlackSocketModeRestartGuard;
-}): SlackSdkLogger;
+}): Logger$1;
 declare function redactSlackSocketModeLogValue(value: unknown, depth?: number): unknown;
 
 declare class InMemorySlackInstallationStore implements SlackInstallationStore {
@@ -341,4 +332,4 @@ declare class JsonFileSlackInstallationStore implements SlackInstallationStore {
 declare function createJsonFileSlackInstallationStore(filePath: string): SlackInstallationStore;
 declare function getSlackInstallationKey(input: SlackInstallation | SlackInstallationQuery): string;
 
-export { type CreateSlackBoltAppOptions, type CreateSlackBoltAppResult, type CreateSlackSocketBoltAppOptions, type CreateSlackSocketBoltAppResult, InMemorySlackInstallationStore, JsonFileSlackInstallationStore, type SlackAuthorizeFn, type SlackAuthorizeResult, type SlackAuthorizeSource, type SlackCustomAuthorizeAuthOptions, type SlackDirectAuthMode, type SlackDirectAuthOptions, type SlackInstallation, type SlackInstallationQuery, type SlackInstallationStore, type SlackOAuthAuthOptions, type SlackOAuthCallbackOptions, type SlackOAuthError, type SlackOAuthInstallPathOptions, type SlackSdkLogLevel, type SlackSdkLogger, type SlackSingleWorkspaceAuthOptions, type SlackSocketModeProcessLock, type SlackSocketModeProcessLockOptions, type SlackSocketModeReceiverRuntimeOptions, type SlackSocketModeRestartGuard, type SlackSocketModeRuntime, type SlackSocketModeRuntimeOptions, type SlackSocketModeRuntimePolicy, type SlackStateStore, acquireSlackSocketModeProcessLock, createInMemorySlackInstallationStore, createJsonFileSlackInstallationStore, createSlackBoltApp, createSlackSdkLogger, createSlackSocketBoltApp, createSlackSocketModeRestartGuard, createSlackSocketModeRuntime, getSlackInstallationKey, redactSlackSocketModeLogValue };
+export { type CreateSlackBoltAppOptions, type CreateSlackBoltAppResult, type CreateSlackSocketBoltAppOptions, type CreateSlackSocketBoltAppResult, InMemorySlackInstallationStore, JsonFileSlackInstallationStore, type SlackAuthorizeFn, type SlackAuthorizeResult, type SlackAuthorizeSource, type SlackCustomAuthorizeAuthOptions, type SlackDirectAuthMode, type SlackDirectAuthOptions, type SlackInstallation, type SlackInstallationQuery, type SlackInstallationStore, type SlackOAuthAuthOptions, type SlackOAuthCallbackOptions, type SlackOAuthError, type SlackOAuthInstallPathOptions, type SlackSingleWorkspaceAuthOptions, type SlackSocketModeProcessLock, type SlackSocketModeProcessLockOptions, type SlackSocketModeReceiverRuntimeOptions, type SlackSocketModeRestartGuard, type SlackSocketModeRuntime, type SlackSocketModeRuntimeOptions, type SlackSocketModeRuntimePolicy, type SlackStateStore, acquireSlackSocketModeProcessLock, createInMemorySlackInstallationStore, createJsonFileSlackInstallationStore, createSlackBoltApp, createSlackSdkLogger, createSlackSocketBoltApp, createSlackSocketModeRestartGuard, createSlackSocketModeRuntime, getSlackInstallationKey, redactSlackSocketModeLogValue };

package/dist/bolt.js

@@ -516,16 +516,7 @@ function createSlackSdkLogger({
   };
 }
 function toSlackLogLevel(level) {
-  switch (level) {
-    case "debug":
-      return "debug";
-    case "warn":
-      return "warn";
-    case "error":
-      return "error";
-    case "info":
-      return "info";
-  }
+  return level;
 }
 function formatSlackLogArgs(args) {
   return args.map(formatSlackLogArg).join(" ");

package/dist/history.d.ts

@@ -2,16 +2,21 @@ import { S as SlackActivityInfo } from './activity-ByrD9Ftr.js';
 import { ConversationsHistoryResponse, ConversationsRepliesResponse, WebClient } from '@slack/web-api';
 import { L as Logger } from './logging-Bl3HfcC8.js';
 
+type SlackContextFragmentRole = "system" | "user";
+type SlackContextFragmentPlacement = "before-history" | "after-latest-user" | "after-history";
+type SlackContextFragmentLifetime = "turn" | "session";
+type SlackContextFragmentBudgetBehavior = "required" | "droppable";
+type SlackContextFragmentKind = "environment" | "runtime" | "session" | "memory" | "instruction" | "hook" | (string & {});
 interface SlackContextFragmentPayload {
     content: string;
-    budgetBehavior?: string;
+    budgetBehavior?: SlackContextFragmentBudgetBehavior;
     dedupeKey?: string;
-    kind?: string;
-    lifetime?: string;
+    kind?: SlackContextFragmentKind;
+    lifetime?: SlackContextFragmentLifetime;
     maxChars?: number;
     metadata?: Record<string, unknown>;
-    placement?: string;
-    role?: string;
+    placement?: SlackContextFragmentPlacement;
+    role?: SlackContextFragmentRole;
     source?: string;
     title?: string;
 }
@@ -263,4 +268,4 @@ declare function createSlackSupplementalHistoryPolicy({ logger, sessionTranscrip
     sessionTranscript?: SlackSessionTranscriptInspector;
 }): SlackSupplementalHistoryPolicy;
 
-export { type CreateSlackSupplementalHistoryVisibilityPolicyOptions, type FormatSlackHistoryForPromptOptions, type LoadSlackTurnHistoryContextOptions, type ReadSlackChannelHistoryOptions, type ReadSlackThreadHistoryOptions, type SlackAssistantSurfaceThreadRootNormalization, type SlackAssistantSurfaceThreadRootNormalizationContext, type SlackHistoryAuthorFormatter, type SlackHistoryAuthorResolutionErrorContext, type SlackHistoryAuthorResolver, type SlackHistoryAuthorResolverContext, type SlackHistoryContextSource, type SlackHistoryMessage, type SlackHistoryMessageRole, type SlackHistoryPage, type SlackHistoryReaderClient, type SlackHistoryUnavailable, type SlackSessionTranscriptInspector, type SlackSupplementalHistoryInclusionDecision, type SlackSupplementalHistoryInclusionReason, type SlackSupplementalHistoryInclusionSource, type SlackSupplementalHistoryPolicy, type SlackSupplementalHistoryPolicyRequest, type SlackSupplementalHistoryVisibilityContext, type SlackSupplementalHistoryVisibilityDecision, type SlackSupplementalHistoryVisibilityErrorContext, type SlackSupplementalHistoryVisibilityMode, type SlackSupplementalHistoryVisibilityPolicy, type SlackTurnHistoryContextResult, createSlackSupplementalHistoryPolicy, createSlackSupplementalHistoryVisibilityPolicy, formatSlackHistoryForPrompt, loadSlackTurnHistoryContext, readSlackChannelHistory, readSlackThreadHistory };
+export { type CreateSlackSupplementalHistoryVisibilityPolicyOptions, type FormatSlackHistoryForPromptOptions, type LoadSlackTurnHistoryContextOptions, type ReadSlackChannelHistoryOptions, type ReadSlackThreadHistoryOptions, type SlackAssistantSurfaceThreadRootNormalization, type SlackAssistantSurfaceThreadRootNormalizationContext, type SlackContextFragmentBudgetBehavior, type SlackContextFragmentKind, type SlackContextFragmentLifetime, type SlackContextFragmentPayload, type SlackContextFragmentPlacement, type SlackContextFragmentRole, type SlackHistoryAuthorFormatter, type SlackHistoryAuthorResolutionErrorContext, type SlackHistoryAuthorResolver, type SlackHistoryAuthorResolverContext, type SlackHistoryContextSource, type SlackHistoryMessage, type SlackHistoryMessageRole, type SlackHistoryPage, type SlackHistoryReaderClient, type SlackHistoryUnavailable, type SlackSessionTranscriptInspector, type SlackSupplementalHistoryInclusionDecision, type SlackSupplementalHistoryInclusionReason, type SlackSupplementalHistoryInclusionSource, type SlackSupplementalHistoryPolicy, type SlackSupplementalHistoryPolicyRequest, type SlackSupplementalHistoryVisibilityContext, type SlackSupplementalHistoryVisibilityDecision, type SlackSupplementalHistoryVisibilityErrorContext, type SlackSupplementalHistoryVisibilityMode, type SlackSupplementalHistoryVisibilityPolicy, type SlackTurnHistoryContextResult, createSlackSupplementalHistoryPolicy, createSlackSupplementalHistoryVisibilityPolicy, formatSlackHistoryForPrompt, loadSlackTurnHistoryContext, readSlackChannelHistory, readSlackThreadHistory };

package/docs/reference/channel-slack-boundary.md

@@ -1,13 +1,13 @@
 # Channel Slack Boundary
 
-`@cuylabs/channel-slack` is the SDK-neutral Slack mechanics package. It parses
+`@cuylabs/channel-slack` is the reusable Slack mechanics package. It parses
 Slack events, formats Slack output, applies reusable admission and history
 policies, and provides Slack setup/runtime helpers. It does not create or run an
 agent.
 
-`@cuylabs/channel-slack-agent-core` is the `@cuylabs/agent-core` binding. It
-composes this package with agent-core scopes, event streams, context fragments,
-and approval or human-input contracts.
+`@cuylabs/channel-slack-agent-core` is the agent-core runtime binding. It
+composes this package with runtime scopes, event streams, context fragments, and
+approval or human-input contracts.
 
 ## In This Package
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cuylabs/channel-slack",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "SDK-neutral Slack channel primitives for AI agents",
   "type": "module",
   "main": "./dist/index.js",